libproxy.3 revision 15963
15814N/A<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
15814N/A<!--ArborText, Inc., 1988-1999, v.4002-->
15952N/A<!--ARC : LSARC 2009/088 Libproxy for Opensolaris-->
15814N/A<!ENTITY cmd "libproxy">
15814N/A<!ENTITY % commonents SYSTEM "smancommon.ent">
15814N/A%commonents;
15814N/A<!ENTITY % booktitles SYSTEM "booktitles.ent">
15814N/A%booktitles;
15814N/A<!ENTITY suncopy "Copyright (c) 2004,2009 Sun Microsystems, Inc. All Rights Reserved.">
15814N/A]>
15814N/A<?Pub UDT _bookmark _target>
15814N/A<?Pub Inc>
15814N/A<refentry id="libproxy-3">
15814N/A<!-- %Z%%M% %I% %E% SMI; -->
15814N/A<refmeta><refentrytitle>&cmd;</refentrytitle><manvolnum>3</manvolnum>
15814N/A<refmiscinfo class="date">9 Feb 2009</refmiscinfo>
15814N/A<refmiscinfo class="sectdesc">&man3;</refmiscinfo>
15814N/A<refmiscinfo class="software">&release;</refmiscinfo>
15814N/A<refmiscinfo class="arch">generic</refmiscinfo>
15814N/A<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
15814N/A</refmeta>
15814N/A<indexterm><primary>&cmd;</primary></indexterm><indexterm><primary>A library that provides
15814N/Aautomatic proxy configuration management</primary></indexterm>
15814N/A<refnamediv id="libproxy-3-name"><refname>&cmd;</refname>
15814N/A<refpurpose>a library that provides automatic proxy configuration management</refpurpose></refnamediv>
15814N/A<refsect1 id="libproxy-3-desc"><title>&desc-tt;</title>
15814N/A<para>
15963N/A&cmd; provides interfaces to get the proxy that will be used to access network
15963N/Aresources. It uses various plugins to get proxy configuration via different
15963N/Amechanisms (e.g. environment variables, GConf, PAC).
15952N/A
15952N/AThe order in which each proxy configuration should be checked is determined
15963N/Aby a environment PX_CONFIG_ORDER, the default order is
15963N/A&quot;USER,SESSION,SYSTEM,envvar&quot;. USER, SESSION and SYSTEM are all
15963N/Acategories of proxy configuration. envvar means the plugin who get proxy
15963N/Asetting from the environment variable &quot;http_proxy&quot;.
15952N/A
15952N/AGConf plugin belongs to the SESSION category, so GConf setting will be checked
15952N/Abefore environment variable.
15952N/A
15963N/A&cmd; also supports the feature of WPAD. But for the consideration of security
15952N/Arisk imported by WPAD, wpad-fallback plugin is disabled by default. Users who
15963N/Awant to enable this feature can export PX_CONFIG_ORDER to
15963N/A&quot;USER,SESSION,SYSTEM,envvar,wpad-fallback&quot;, so the WPAD will be tried
15963N/Aif all the other plugins fail to find a proxy.
15814N/A</para>
15814N/A</refsect1>
15814N/A<refsect1 id="libproxy-3-file"><title>&file-tt;</title>
15814N/A<para>The following files are used by this application:</para>
15814N/A<variablelist termlength="wholeline">
15814N/A<varlistentry>
15814N/A<term><filename>/usr/lib/&cmd;.so</filename></term>
15814N/A<listitem><para>
15814N/Alibproxy shared library
15814N/A</para></varlistentry>
15814N/A<varlistentry>
15814N/A<term><filename>/usr/lib/libproxy/*</filename></term>
15814N/A<listitem><para>
15814N/Alibproxy plugins
15814N/A</para></varlistentry>
15814N/A</variablelist></refsect1>
15814N/A<refsect1 id="libproxy-3-attr"><title>&attr-tt;</title>
15814N/A<para>See <olink targetdocent="REFMAN5" localinfo="attributes-3"><citerefentry>
15814N/A<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
15814N/Afor descriptions of the following attributes:</para>
15814N/A<informaltable frame="all">
15814N/A<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
15814N/A<colspec colname="COLSPEC1" colwidth="1*">
15814N/A<thead>
15814N/A<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
15814N/Avalign="middle">ATTRIBUTE VALUE</entry></row>
15814N/A</thead>
15814N/A<tbody>
15814N/A<row><entry><para>Availability</para></entry><entry><para>SUNWlibproxy</para></entry></row>
15814N/A<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry colname="COLSPEC1"><para>Volatile</para></entry></row>
15814N/A</tbody>
15814N/A</tgroup>
15814N/A</informaltable>
15814N/A</refsect1>
15814N/A<refsect1 id="libproxy-3-also"><title>&also-tt;</title>
15814N/A<!--Reference to another man page-->
15814N/A<!--Reference to a Help manual-->
15814N/A<!--Reference to a book.-->
15814N/A<para>
15814N/A<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
15814N/A<citerefentry><refentrytitle>gnome-interfaces</refentrytitle><manvolnum>5</manvolnum></citerefentry>
15814N/A</para>
15814N/A<variablelist termlength="wholeline"><varlistentry>
15814N/A<term><filename>&cmd home page:</filename></term>
15814N/A<listitem><para><programlisting>
15814N/A<literal>http://code.google.com/p/libproxy/</literal>
15814N/A</programlisting>
15814N/A</para></listitem>
15814N/A</varlistentry></variablelist>
15814N/A</refsect1>
15814N/A<refsect1 id="libproxy-3-note"><title>&note-tt;</title>
15814N/A<para>Written by Ke Wang, Sun Microsystems Inc., 2004, 2009.</para>
15814N/A</refsect1>
15814N/A</refentry>