libproxy(3) C Library Functions libproxy(3)NAMElibproxy - a library that provides automatic proxy configuration man‐
agement
DESCRIPTIONlibproxy provides interfaces to get the proxy that will be used to
access network resources. It uses various plugins to get proxy configu‐
ration via different mechanisms (e.g. environment variables, GConf,
PAC).
The envvar plugin gets the proxy configuration from the http_proxy and
no_proxy environment variables. The file plugin gets proxy configura‐
tion from /etc/proxy.conf and $HOME/.proxy.conf. The gnome plugin gets
the proxy configuration via GConf, and if the configuration uses PAC,
then the mozjs plugin is used.
The order in which each proxy mechanism will be checked is specified by
the environment PX_CONFIG_ORDER. The default order is "USER,SES‐
SION,SYSTEM,envvar". USER, SESSION and SYSTEM are all categories of
proxy configuration. envvar means the plugin who get proxy setting
from the environment variable "http_proxy".
The GConf plugin belongs to the SESSION category, so the GConf setting
will be checked before the environment variable.
libproxy also supports the feature of WPAD. But for the consideration
of WPAD security risks, the wpad-fallback plugin is disabled by
default. Users who want to enable this feature can set the PX_CON‐
FIG_ORDER environment variable to "USER,SESSION,SYSTEM,envvar,wpad-
fallback", so the WPAD will be used if all the other plugins fail to
find a proxy.
ENVIRONMENT VARIABLES
See environ(5) for descriptions of environment variables.
http_proxy URL of HTTP proxy to use.
no_proxy A comma delimited list of hosts (or domains) for which
proxying is not to be used.
FILES
The following files are used by this application:
/usr/lib/libproxy.so
libproxy shared library
/usr/lib/libproxy/*
libproxy plugins
/etc/proxy.conf
$HOME/.proxy.conf
configuration file used by file plugin to look for proxy configura‐
tion
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │library/libproxy │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Volatile │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOattributes(5), gnome-interfaces(5), environ(5)libproxy home page:
http://code.google.com/p/libproxy/
NOTES
Written by Ke Wang, Sun Microsystems Inc., 2004, 2009.
SunOS 5.11 9 Feb 2009 libproxy(3)