<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!ENTITY cmd "libproxy">

<!ENTITY % commonents SYSTEM "smancommon.ent">

%commonents;

<!ENTITY % booktitles SYSTEM "booktitles.ent">

%booktitles;

<!ENTITY suncopy "Copyright (c) 2004,2009 Sun Microsystems, Inc. All Rights Reserved.">

]>

<?Pub UDT _bookmark _target>

<?Pub Inc>

<refentry id="libproxy-3">

<refmeta><refentrytitle>&cmd;</refentrytitle><manvolnum>3</manvolnum>

<refmiscinfo class="date">9 Feb 2009</refmiscinfo>

<refmiscinfo class="sectdesc">&man3;</refmiscinfo>

<refmiscinfo class="software">&release;</refmiscinfo>

<refmiscinfo class="arch">generic</refmiscinfo>

<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

</refmeta>

<indexterm><primary>&cmd;</primary></indexterm><indexterm><primary>A library that provides

automatic proxy configuration management</primary></indexterm>

<refnamediv id="libproxy-3-name"><refname>&cmd;</refname>

<refpurpose>a library that provides automatic proxy configuration management</refpurpose></refnamediv>

<refsect1 id="libproxy-3-desc"><title>&desc-tt;</title>

<para>

Libproxy provides interfaces to get proxy that should be used to access

a network resource. It use various plugins to get proxy configuration from

different places e.g. environment variables, GConf, PAC.

The order in which each proxy configuration should be checked is determined

by a environment PX_CONFIG_ORDER, the default order is "USER,SESSION,SYSTEM,

envvar". USER, SESSION and SYSTEM are all categories of proxy configuration.

envvar means the plugin who get proxy setting from environment variable.

GConf plugin belongs to the SESSION category, so GConf setting will be checked

before environment variable.

Libproxy also supports the feature of WPAD. But for the consideration of security

risk imported by WPAD, wpad-fallback plugin is disabled by default. Users who

want to enable this feature can export PX_CONFIG_ORDER to "USER,SESSION,SYSTEM,

envvar,wpad-fallback", so the WPAD will be tried if all the other plugins are failed

to get a proxy.

</para>

</refsect1>

<refsect1 id="libproxy-3-file"><title>&file-tt;</title>

<para>The following files are used by this application:</para>

<variablelist termlength="wholeline">

<varlistentry>

<term><filename>/usr/lib/&cmd;.so</filename></term>

<listitem><para>

libproxy shared library

</para></varlistentry>

<varlistentry>

<term><filename>/usr/lib/libproxy/*</filename></term>

<listitem><para>

libproxy plugins

</para></varlistentry>

</variablelist></refsect1>

<refsect1 id="libproxy-3-attr"><title>&attr-tt;</title>

<para>See <olink targetdocent="REFMAN5" localinfo="attributes-3"><citerefentry>

<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>

for descriptions of the following attributes:</para>

<informaltable frame="all">

<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">

<colspec colname="COLSPEC1" colwidth="1*">

<thead>

<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"

valign="middle">ATTRIBUTE VALUE</entry></row>

</thead>

<tbody>

<row><entry><para>Availability</para></entry><entry><para>SUNWlibproxy</para></entry></row>

<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry colname="COLSPEC1"><para>Volatile</para></entry></row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 id="libproxy-3-also"><title>&also-tt;</title>

<para>

<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,

<citerefentry><refentrytitle>gnome-interfaces</refentrytitle><manvolnum>5</manvolnum></citerefentry>

</para>

<variablelist termlength="wholeline"><varlistentry>

<term><filename>&cmd home page:</filename></term>

<listitem><para><programlisting>

<literal>http://code.google.com/p/libproxy/</literal>

</programlisting>

</para></listitem>

</varlistentry></variablelist>

</refsect1>

<refsect1 id="libproxy-3-note"><title>&note-tt;</title>

<para>Written by Ke Wang, Sun Microsystems Inc., 2004, 2009.</para>

</refsect1>

</refentry>