components/desktop/libproxy/files/libproxy.3lib
changeset 7862 875bb3f441a5
equal deleted inserted replaced
7861:8b7335f2b6cf 7862:875bb3f441a5
       
     1 .TH libproxy 3lib "7 Apr 2017" "SunOS 5.11" "Interface Libraries"
       
     2 .SH "NAME"
       
     3 libproxy \- automatic proxy configuration management library
       
     4 .SH "DESCRIPTION"
       
     5 .PP
       
     6 \fBlibproxy\fR provides interfaces to get the proxy that will be used
       
     7 to access network resources\&. It uses various plugins to get proxy configuration
       
     8 via different mechanisms (e\&.g\&. environment variables or desktop settings)\&.
       
     9 .PP
       
    10 The envvar plugin gets the proxy configuration from the http_proxy and no_proxy
       
    11 environment variables\&. The file plugin gets proxy configuration from
       
    12 \fB/etc/proxy\&.conf\fR and
       
    13 \fB$HOME/\&.proxy\&.conf\fR\&. The Gnome plugin gets the proxy
       
    14 configuration via Gsettings.
       
    15 .PP
       
    16 The order in which each proxy mechanism will be checked is specified by the
       
    17 environment PX_CONFIG_ORDER\&.  The default order is
       
    18 "USER,SESSION,SYSTEM,envvar"\&. USER, SESSION and SYSTEM are all
       
    19 categories of proxy configuration\&.  envvar means the plugin which gets proxy
       
    20 setting from the environment variable "http_proxy"\&.
       
    21 .PP
       
    22 The Gnome plugin belongs to the SESSION category, so the Gnome settings will be
       
    23 checked before the environment variable\&.
       
    24 .SH "ENVIRONMENT VARIABLES"
       
    25 .PP
       
    26 See \fBenviron\fR(7) for descriptions of environment variables\&.
       
    27 .TP 16
       
    28 .B http_proxy
       
    29 URL of HTTP proxy to use\&.
       
    30 .TP 16
       
    31 .B no_proxy
       
    32 A comma delimited list of hosts (or domains) for which proxying is not to be
       
    33 used\&.
       
    34 .SH "FILES"
       
    35 .PP
       
    36 The following files are provided by this library:
       
    37 .TP 32
       
    38 .B /usr/lib/libproxy\&.so
       
    39 libproxy 32-bit shared library
       
    40 .TP 32
       
    41 .B /usr/lib/64/libproxy\&.so
       
    42 libproxy 64-bit shared library
       
    43 .TP 32
       
    44 .B /usr/lib/pkgconfig/libproxy-1.0.pc
       
    45 .BR pkg-config (1)
       
    46 file for libproxy 32-bit shared library
       
    47 .TP 32
       
    48 .B /usr/lib/64/pkgconfig/libproxy-1.0.pc
       
    49 .BR pkg-config (1)
       
    50 file for libproxy 64-bit shared library
       
    51 .PP
       
    52 The following files are used by this library:
       
    53 .TP 32
       
    54 .B /usr/lib/libproxy/*
       
    55 libproxy plugins
       
    56 .TP 32
       
    57 \fB/etc/proxy\&.conf\fR, \fI$HOME\fR\fB/\&.proxy\&.conf\fR
       
    58 configuration files used by file plugin to look for proxy configuration
       
    59 .SH "SEE ALSO"
       
    60 .BR attributes (7),
       
    61 .BR gnome-interfaces (7),
       
    62 .BR environ (7)
       
    63 .SH "NOTES"
       
    64 .PP
       
    65 Written by Ke Wang, Sun Microsystems Inc\&., 2004, 2009\&.