<cmdsynopsis>
<command>yaz-proxy</command>
<arg choice="opt">-a <replaceable>filename</replaceable></arg>
- <arg choice="opt">-c <replaceable>num</replaceable></arg>
+ <arg choice="opt">-m <replaceable>num</replaceable></arg>
<arg choice="opt">-v <replaceable>level</replaceable></arg>
<arg choice="opt">-t <replaceable>target</replaceable></arg>
<arg choice="opt">-u <replaceable>auth</replaceable></arg>
<arg choice="opt">-o <replaceable>level</replaceable></arg>
<arg choice="opt">-i <replaceable>seconds</replaceable></arg>
+ <arg choice="opt">-T <replaceable>seconds</replaceable></arg>
+ <arg choice="opt">-c <replaceable>config</replaceable></arg>
<arg choice="req"><replaceable>host</replaceable>:<replaceable>port</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1><title>DESCRIPTION</title>
<para>
- The proxy runs stand-alone (not from
- <literal>inetd</literal>). The
- <replaceable>host</replaceable>:<replaceable>port</replaceable>
+ <command>yaz-proxy</command> is a Z39.50 optimizing proxy daemon.
+ The listening port must be specified on the command-line.
+ <command>inetd</command> operation is not supported.
+ The <replaceable>host</replaceable>:<replaceable>port</replaceable>
argument specifies host address to listen to, and the port to
listen on. Use the host <literal>@</literal>
to listen for connections coming from any address.
</para>
+ <para>
+ <command>yaz-proxy</command> can be configured using command-line
+ options or a configuration file.
+ Configuration file options override values specified
+ on the command-line.
+ </para>
+ <para>
+ <command>yaz-proxy</command> rereads its configuration file and
+ reopens log files when it receivies the hangup signal, SIGHUP.
+ </para>
</refsect1>
<refsect1><title>OPTIONS</title>
<variablelist>
standard output.
</para></listitem>
</varlistentry>
- <varlistentry><term>-c <replaceable>num</replaceable></term>
+ <varlistentry><term>-m <replaceable>num</replaceable></term>
<listitem><para>
Specifies the maximum number of connections to be cached
[default 50].
</varlistentry>
<varlistentry><term>-i <replaceable>seconds</replaceable></term>
<listitem><para>
- Specifies in seconds the idle time for communication
- for proxy. If a connection is inactive for this long
+ Specifies in seconds the idle time for communication between
+ client and proxy. If a connection is inactive for this long
+ it will be closed. Default: 600 seconds (10 minutes).
+ </para></listitem>
+ </varlistentry>
+ <varlistentry><term>-T <replaceable>seconds</replaceable></term>
+ <listitem><para>
+ Specifies in seconds the idle time for communication between
+ proxy and backend target.
+ If a connection is inactive for this long
it willl be closed. Default: 600 seconds (10 minutes).
</para></listitem>
</varlistentry>
+ <varlistentry><term>-c <replaceable>config</replaceable></term>
+ <listitem><para>
+ Specifies config filename. Configuration is in XML
+ and is only supported if the YAZ proxy is compiled with
+ libxml2.
+ </para></listitem>
+ </varlistentry>
</variablelist>
</refsect1>
- <refsect1>
+<refsect1>
<title>EXAMPLES</title>
<para>
The following command starts the proxy, listening on port
</para>
<para>
The YAZ command-line client,
- <literal>yaz-client</literal>,
- allows you to set the proxy target as part of the Initialize
- Request using option <literal>-p</literal>.
- For example, to connect to Index Data's target you could use:
+ <command>yaz-client</command>,
+ allows you to set the proxy address by specifying option -p. In
+ that case, the actual backend target is specified as part of the
+ Initialize Request.
+ </para>
+ <para>Suppose you have a proxy running on localhost,
+ port 9000 and wish to connect to Index Data's test target at
+ <literal>indexdata.dk:210/gils</literal> you could use:
+ <screen>
+ yaz-client -p localhost:9000 indexdata.dk:210/gils
+ </screen>
+ Since port 210 is the default, the port can be omitted:
+ <screen>
+ yaz-client -p localhost:9000 indexdata.dk/gils
+ </screen>
</para>
- <screen>
- yaz-client -p indexdata.dk localhost:9000/gils
- </screen>
</refsect1>
<!-- Keep this comment at the end of the file
Local variables: