Main Page Alphabetical List Data Structures File List Data Fields Globals

filters.h File Reference

Declares functions to parse/crunch headers and pages. More...

Go to the source code of this file.

Defines

#define FILTERS_H_VERSION "$Id: filters.h,v 2.0 2002/06/04 14:34:21 jongfoster Exp $"

#define INADDR_NONE -1

Functions

int match_portlist (const char *portlist, int port)

http_response * block_url (struct client_state *csp)

http_response * redirect_url (struct client_state *csp)

void url_actions (struct http_request *http, struct client_state *csp)

void apply_url_actions (struct current_action_spec *action, struct http_request *http, struct url_actions *b)

const struct forward_spec * forward_url (struct http_request *http, struct client_state *csp)

char * pcrs_filter_response (struct client_state *csp)

char * gif_deanimate_response (struct client_state *csp)

int remove_chunked_transfer_coding (char *buffer, const size_t size)

Variables

const char filters_rcs []

const char filters_h_rcs []

Detailed Description

Declares functions to parse/crunch headers and pages.

Functions declared include: `acl_addr', `add_stats', `block_acl', `block_imageurl', `block_url', `url_actions', `filter_popups', `forward_url' `ij_untrusted_url', `intercept_url', `re_process_buffer', `show_proxy_args', and `trust_url'

Log:: filters.h,v

Revision 2.0 2002/06/04 14:34:21 jongfoster Moving source files to src/

Revision 1.20 2002/04/02 14:56:16 oes Bugfix: is_untrusted_url() and trust_url() now depend on FEATURE_TRUST, not FEATURE_COOKIE_JAR

Revision 1.19 2002/03/26 22:29:54 swa we have a new homepage!

Revision 1.18 2002/03/25 22:12:45 oes Added fix for undefined INADDR_NONE on Solaris by Bart Schelstraete

Revision 1.17 2002/03/24 13:25:43 swa name change related issues

Revision 1.16 2002/01/17 21:01:02 jongfoster Moving all our URL and URL pattern parsing code to urlmatch.c.

Revision 1.15 2001/10/10 16:44:16 oes Added match_portlist function

Revision 1.14 2001/10/07 15:41:40 oes Added prototype for remove_chunked_transfer_coding

Revision 1.13 2001/07/30 22:08:36 jongfoster Tidying up defines:

All feature defines are now of the form FEATURE_xxx
Permanently turned off WIN_GUI_EDIT
Permanently turned on WEBDAV and SPLIT_PROXY_ARGS

Revision 1.12 2001/07/29 19:01:11 jongfoster Changed _FILENAME_H to FILENAME_H_INCLUDED. Added forward declarations for needed structures.

Revision 1.11 2001/07/13 14:00:18 oes

Introduced gif_deanimate_response
Renamed re_process_buffer to pcrs_filter_response
Removed all ifdef PCRS

Revision 1.10 2001/06/29 13:29:01 oes Cleaned up and updated to reflect the changesin filters.c

Revision 1.9 2001/06/07 23:10:53 jongfoster Replacing struct gateway with struct forward_spec

Revision 1.8 2001/06/03 19:12:00 oes extracted-CGI relevant stuff

Revision 1.7 2001/05/31 21:21:30 jongfoster Permissionsfile / actions file changes:

Changed "permission" to "action" throughout
changes to file format to allow string parameters
Moved helper functions to actions.c

Revision 1.6 2001/05/29 09:50:24 jongfoster Unified blocklist/imagelist/permissionslist. File format is still under discussion, but the internal changes are (mostly) done.

Also modified interceptor behaviour:

We now intercept all URLs beginning with one of the following prefixes (and *only* these prefixes): * http://i.j.b/ * http://ijbswa.sf.net/config/ * http://ijbswa.sourceforge.net/config/
New interceptors "home page" - go to http://i.j.b/ to see it.
Internal changes so that intercepted and fast redirect pages are not replaced with an image.
Interceptors now have the option to send a binary page direct to the client. (i.e. ijb-send-banner uses this)
Implemented show-url-info interceptor. (Which is why I needed the above interceptors changes - a typical URL is "http://i.j.b/show-url-info?url=www.somesite.com/banner.gif". The previous mechanism would not have intercepted that, and if it had been intercepted then it then it would have replaced it with an image.)

Revision 1.5 2001/05/27 22:17:04 oes

re_process_buffer no longer writes the modified buffer to the client, which was very ugly. It now returns the buffer, which it is then written by chat.

content_length now adjusts the Content-Length: header for modified documents rather than crunch()ing it. (Length info in csp->content_length, which is 0 for unmodified documents)

For this to work, sed() is called twice when filtering.

Revision 1.4 2001/05/26 15:26:15 jongfoster ACL feature now provides more security by immediately dropping connections from untrusted hosts.

Revision 1.3 2001/05/22 18:46:04 oes

Enabled filtering banners by size rather than URL by adding patterns that replace all standard banner sizes with the "Junkbuster" gif to the re_filterfile

Enabled filtering WebBugs by providing a pattern which kills all 1x1 images

Added support for PCRE_UNGREEDY behaviour to pcrs, which is selected by the (nonstandard and therefore capital) letter 'U' in the option string. It causes the quantifiers to be ungreedy by default. Appending a ? turns back to greedy (!).

Added a new interceptor ijb-send-banner, which sends back the "Junkbuster" gif. Without imagelist or MSIE detection support, or if tinygif = 1, or the URL isn't recognized as an imageurl, a lame HTML explanation is sent instead.

Added new feature, which permits blocking remote script redirects and firing back a local redirect to the browser. The feature is conditionally compiled, i.e. it can be disabled with --disable-fast-redirects, plus it must be activated by a "fast-redirects" line in the config file, has its own log level and of course wants to be displayed by show-proxy-args Note: Boy, all the ifdefs in 1001 locations and all the fumbling with configure.in and acconfig.h were *way* more work than the feature itself :-(

Because a generic redirect template was needed for this, tinygif = 3 now uses the same.

Moved GIFs, and other static HTTP response templates to project.h

Some minor fixes

Removed some >400 CRs again (Jon, you really worked a lot! ;-)

Revision 1.2 2001/05/20 01:21:20 jongfoster Version 2.9.4 checkin.

Merged popupfile and cookiefile, and added control over PCRS filtering, in new "permissionsfile".
Implemented LOG_LEVEL_FATAL, so that if there is a configuration file error you now get a message box (in the Win32 GUI) rather than the program exiting with no explanation.
Made killpopup use the PCRS MIME-type checking and HTTP-header skipping.
Removed tabs from "config"
Moved duplicated url parsing code in "loaders.c" to a new funcition.
Bumped up version number.

Revision 1.1.1.1 2001/05/15 13:58:52 oes Initial import of version 2.9.3 source tree

Function Documentation

void apply_url_actions ( struct current_action_spec * action,

struct http_request * http,

struct url_actions * b

)

Applies a list of URL actions.

Parameters:

action Destination.

http Current URL

b list of URL actions to apply

Returns:
N/A

struct http_response* block_url ( struct client_state * csp )

Called from `chat'.
Check to see if we need to block this.
Parameters:

csp Current client state (buffers, headers, etc...)

Returns:
NULL => unblocked, else HTTP block response

const struct forward_spec* forward_url ( struct http_request * http,

struct client_state * csp

)

Should we forward this to another proxy?

Parameters:

http http_request request for current URL

csp Current client state (buffers, headers, etc...)

Returns:
Pointer to forwarding information.

char* gif_deanimate_response ( struct client_state * csp )

Deanimate the GIF image that has been accumulated in csp->iob->buf, set csp->content_length to the modified size and raise the CSP_FLAG_MODIFIED flag.

Parameters:

csp Current client state (buffers, headers, etc...)

Returns:
a pointer to the (newly allocated) modified buffer. or NULL in case something went wrong.

int match_portlist ( const char * portlist,

int port

)

Check if a given number is covered by a comma separated list of numbers and ranges (a,b-c,d,..).

Parameters:

portlist String with list

port port to check

Returns:
0 => no match 1 => match

char* pcrs_filter_response ( struct client_state * csp )

Ecexute all text substitutions from all applying +filter actions on the text buffer that's been accumulated in csp->iob->buf.
If this changes the contents, set csp->content_length to the modified size and raise the CSP_FLAG_MODIFIED flag.
Parameters:

csp Current client state (buffers, headers, etc...)

Returns:
a pointer to the (newly allocated) modified buffer. or NULL if there were no hits or something went wrong

int remove_chunked_transfer_coding ( char * buffer,

const size_t size

)

In-situ remove the "chunked" transfer coding as defined in rfc2616 from a buffer.

Parameters:

buffer Pointer to the text buffer

size Number of bytes to be processed

Returns:
The new size, i.e. the number of bytes from buffer which are occupied by the stripped body, or 0 in case something went wrong

void url_actions ( struct http_request * http,

struct client_state * csp

)

Gets the actions for this URL.

Parameters:

http http_request request for blocked URLs

csp Current client state (buffers, headers, etc...)

Returns:
N/A

Variable Documentation

const char filters_h_rcs[]

Version information about filters.h.

const char filters_rcs[]

Version information about filters.c.

Generated on Tue Jun 4 18:54:49 2002 for Privoxy 3.1.1 by

1.2.15

Defines
#define	FILTERS_H_VERSION "$Id: filters.h,v 2.0 2002/06/04 14:34:21 jongfoster Exp $"
#define	INADDR_NONE -1
Functions
int	match_portlist (const char *portlist, int port)
http_response *	block_url (struct client_state *csp)
http_response *	redirect_url (struct client_state *csp)
void	url_actions (struct http_request http, struct client_state csp)
void	apply_url_actions (struct current_action_spec action, struct http_request http, struct url_actions *b)
const struct forward_spec *	forward_url (struct http_request http, struct client_state csp)
char *	pcrs_filter_response (struct client_state *csp)
char *	gif_deanimate_response (struct client_state *csp)
int	remove_chunked_transfer_coding (char *buffer, const size_t size)
Variables
const char	filters_rcs []
const char	filters_h_rcs []