1 #ifndef URLMATCH_H_INCLUDED
2 #define URLMATCH_H_INCLUDED
3 #define URLMATCH_H_VERSION "$Id: urlmatch.h,v 1.9 2008/04/08 16:07:39 fabiankeil Exp $"
4 /*********************************************************************
6 * File : $Source: /cvsroot/ijbswa/current/urlmatch.h,v $
8 * Purpose : Declares functions to match URLs against URL
11 * Copyright : Written by and Copyright (C) 2001-2002, 2006 the SourceForge
12 * Privoxy team. http://www.privoxy.org/
14 * Based on the Internet Junkbuster originally written
15 * by and Copyright (C) 1997 Anonymous Coders and
16 * Junkbusters Corporation. http://www.junkbusters.com
18 * This program is free software; you can redistribute it
19 * and/or modify it under the terms of the GNU General
20 * Public License as published by the Free Software
21 * Foundation; either version 2 of the License, or (at
22 * your option) any later version.
24 * This program is distributed in the hope that it will
25 * be useful, but WITHOUT ANY WARRANTY; without even the
26 * implied warranty of MERCHANTABILITY or FITNESS FOR A
27 * PARTICULAR PURPOSE. See the GNU General Public
28 * License for more details.
30 * The GNU General Public License should be included with
31 * this file. If not, you can view it at
32 * http://www.gnu.org/copyleft/gpl.html
33 * or write to the Free Software Foundation, Inc., 59
34 * Temple Place - Suite 330, Boston, MA 02111-1307, USA.
37 * $Log: urlmatch.h,v $
38 * Revision 1.9 2008/04/08 16:07:39 fabiankeil
39 * Make it harder to mistake url_match()'s
40 * second parameter for an url_spec.
42 * Revision 1.8 2007/09/02 15:31:20 fabiankeil
43 * Move match_portlist() from filter.c to urlmatch.c.
44 * It's used for url matching, not for filtering.
46 * Revision 1.7 2007/01/06 14:24:38 fabiankeil
47 * Mark *csp as immutable for parse_http_url()
50 * Revision 1.6 2006/12/06 19:12:43 fabiankeil
51 * Added prototype for init_domain_components().
53 * Revision 1.5 2006/07/18 14:48:47 david__schmidt
54 * Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch)
55 * with what was really the latest development (the v_3_0_branch branch)
57 * Revision 1.3 2002/03/26 22:29:55 swa
58 * we have a new homepage!
60 * Revision 1.2 2002/03/24 13:25:43 swa
61 * name change related issues
63 * Revision 1.1 2002/01/17 20:53:46 jongfoster
64 * Moving all our URL and URL pattern parsing code to the same file - it
65 * was scattered around in filters.c, loaders.c and parsers.c.
67 * Providing a single, simple url_match(pattern,url) function - rather than
68 * the 3-line match routine which was repeated all over the place.
70 * Renaming free_url to free_url_spec, since it frees a struct url_spec.
72 * Providing parse_http_url() so that URLs can be parsed without faking a
73 * HTTP request line for parse_http_request() or repeating the parsing
74 * code (both of which were techniques that were actually in use).
76 * Standardizing that struct http_request is used to represent a URL, and
77 * struct url_spec is used to represent a URL pattern. (Before, URLs were
78 * represented as seperate variables and a partially-filled-in url_spec).
81 *********************************************************************/
90 extern void free_http_request(struct http_request *http);
91 extern jb_err init_domain_components(struct http_request *http);
92 extern jb_err parse_http_request(const char *req,
93 struct http_request *http,
94 const struct client_state *csp);
95 extern jb_err parse_http_url(const char * url,
96 struct http_request *http,
97 const struct client_state *csp);
99 extern int url_match(const struct url_spec *pattern,
100 const struct http_request *http);
102 extern jb_err create_url_spec(struct url_spec *url, char *buf);
103 extern void free_url_spec(struct url_spec *url);
104 extern int match_portlist(const char *portlist, int port);
107 /* Revision control strings from this header and associated .c file */
108 extern const char urlmatch_rcs[];
109 extern const char urlmatch_h_rcs[];
115 #endif /* ndef URLMATCH_H_INCLUDED */