<cmdsynopsis>
<command>yaz-proxy</command>
<arg choice="opt">-a <replaceable>filename</replaceable></arg>
+ <arg choice="opt">-l <replaceable>filename</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">-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">-p <replaceable>pidfile</replaceable></arg>
+ <arg choice="opt">-u <replaceable>userid</replaceable></arg>
<arg choice="opt">-c <replaceable>config</replaceable></arg>
<arg choice="req"><replaceable>host</replaceable>:<replaceable>port</replaceable></arg>
</cmdsynopsis>
standard output.
</para></listitem>
</varlistentry>
+ <varlistentry><term>-l <replaceable>filename</replaceable></term>
+ <listitem><para>
+ Specifies the name of a file to which to write a log of the
+ YAZ proxy activity. This uses the logging facility as provided
+ by the YAZ toolkit. If this options is omitted, the output
+ directed to stderr.
+ </para></listitem>
+ </varlistentry>
<varlistentry><term>-m <replaceable>num</replaceable></term>
<listitem><para>
Specifies the maximum number of connections to be cached
</varlistentry>
<varlistentry><term>-v <replaceable>level</replaceable></term>
<listitem><para>
- Sets the logging level. <replaceable>level</replaceable> is
+ Sets the logging level. <replaceable>level</replaceable> is
a comma-separated list of members of the set
{<literal>fatal</literal>,<literal>debug</literal>,<literal>warn</literal>,<literal>log</literal>,<literal>malloc</literal>,<literal>all</literal>,<literal>none</literal>}.
</para></listitem>
<literal>initRequest</literal>.
</para></listitem>
</varlistentry>
- <varlistentry><term>-u <replaceable>auth</replaceable></term>
+ <varlistentry><term>-U <replaceable>auth</replaceable></term>
<listitem><para>
Specifies authentication info to be sent to the backend target.
This is useful if you happen to have an internal target that
it willl be closed. Default: 600 seconds (10 minutes).
</para></listitem>
</varlistentry>
+ <varlistentry><term>-p <replaceable>pidfile</replaceable></term>
+ <listitem><para>
+ When specified, yaz-proxy will create <replaceable>pidfile</replaceable>
+ with the process ID of the proxy. The pidfile will be generated
+ before the process changes identity (see option <literal>-u</literal>).
+ </para></listitem>
+ </varlistentry>
+ <varlistentry><term>-u <replaceable>userid</replaceable></term>
+ <listitem><para>
+ When specified, yaz-proxy will change identity to the user ID
+ specified, just after the proxy has started listening to a
+ possibly priviledged port and after the PID file has been created
+ if specified by option <literal>-u</literal>.
+ </para></listitem>
+ </varlistentry>
<varlistentry><term>-c <replaceable>config</replaceable></term>
<listitem><para>
Specifies config filename. Configuration is in XML