Typedefs

typedef int(* pacparser_error_printer )(const char *fmt, va_list argp)
Type definition for pacparser_error_printer.

Functions

int pacparser_init (void)
Initializes pac parser. int pacparser_parse_pac_file (const char *pacfile)
Parses the given PAC file. int pacparser_parse_pac_string (const char *pacstring)
Parses the given PAC script string. int pacparser_parse_pac (const char *pacfile)
Parses the gievn pac file. char * pacparser_find_proxy (const char *url, const char *host)
Finds proxy for the given URL and Host. char * pacparser_just_find_proxy (const char *pacfile, const char *url, const char *host)
Finds proxy for the given PAC file, URL and Host. void pacparser_cleanup (void)
Destroys JavaSctipt context. void pacparser_setmyip (const char *ip)
Sets my IP address. void pacparser_set_error_printer (pacparser_error_printer func)
Sets error printing function. void pacparser_enable_microsoft_extensions (void)
(Deprecated) Enable Microsoft IPv6 PAC extensions. char * pacparser_version (void)
Returns pacparser version.

int pacparser_init (void)

Initializes pac parser.

Returns:

Initializes JavaScript engine and does few basic initializations specific to pacparser.

int pacparser_parse_pac_file (const char *pacfile)

Parses the given PAC file.

Parameters:

Returns:

Reads the given PAC file and evaluates it in the JavaScript context created by pacparser_init.

int pacparser_parse_pac_string (const char *pacstring)

Parses the given PAC script string.

Parameters:

Returns:

Evaulates the given PAC script string in the JavaScript context created by pacparser_init.

int pacparser_parse_pac (const char *pacfile)

Parses the gievn pac file.

Deprecated

Same as pacparser_parse_pac_file. Included only for backward compatibility.

char* pacparser_find_proxy (const char *url, const char *host)

Finds proxy for the given URL and Host.

Parameters:

Returns:

Finds proxy for the given URL and Host. This function should be called only after pacparser engine has been initialized (using pacparser_init) and pac script has been parsed (using pacparser_parse_pac_file or pacparser_parse_pac_string).

char* pacparser_just_find_proxy (const char *pacfile, const char *url, const char *host)

Finds proxy for the given PAC file, URL and Host.

Parameters:

Returns:

This function is a wrapper around functions pacparser_init, pacparser_parse_pac_file, pacparser_find_proxy and pacparser_cleanup. If you just want to find out proxy for a given set of pac file, url and host, this is the function to call. This function takes care of all the initialization and cleanup.

void pacparser_cleanup (void)

Destroys JavaSctipt context. This function should be called once you're done with using pacparser engine.

void pacparser_setmyip (const char *ip)

Sets my IP address.

Parameters:

Sets my IP address to a custom value. This is the IP address returned by myIpAddress() javascript function.

void pacparser_set_error_printer (pacparser_error_printerfunc)

Sets error printing function.

Parameters:

Sets error variadic-argument printing function. If not set the messages are printed to stderr. If messages begin with DEBUG: or WARNING:, they are not fatal error messages, otherwise they are. May be called before pacparser_init().

void pacparser_enable_microsoft_extensions (void)

(Deprecated) Enable Microsoft IPv6 PAC extensions. Deprecated. IPv6 extension (*Ex functions) are enabled by default now.

char* pacparser_version (void)

Returns pacparser version.

Returns:

Version string is determined at the time of build. If built from a released package, version corresponds to the latest release (git) tag. If built from the repository, it corresponds to the head revision of the repo.