<!--
   Options for generic frontend server and yaz-ztest.
   Included in both manual and man page for yaz-ztest
-->

<variablelist>
 <varlistentry>
  <term><literal>-a </literal>
  <replaceable>file</replaceable></term>
  <listitem><para>
   Specify a file for dumping PDUs (for diagnostic purposes).
    The special name <literal>-</literal> (dash) sends output to
    <literal>stderr</literal>.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-S</literal></term>
  <listitem><para>
   Don't fork or make threads on connection requests. This is good for
   debugging, but not recommended for real operation: Although the
   server is asynchronous and non-blocking, it can be nice to keep
   a software malfunction (okay then, a crash) from affecting all
   current users.
   </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-1</literal></term>
  <listitem><para>
   Like <literal>-S</literal> but after one session the server
   exits. This mode is for debugging <emphasis>only</emphasis>.
 </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-T</literal></term>
  <listitem><para>
   Operate the server in threaded mode. The server creates a thread
   for each connection rather than fork a process. Only available
   on UNIX systems that offer POSIX threads.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-s</literal></term>
  <listitem><para>
   Use the SR protocol (obsolete).
 </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-z</literal></term>
  <listitem><para>
   Use the Z39.50 protocol (default). This option and <literal>-s</literal>
   complement each other.
   You can use both multiple times on the same command
   line, between listener-specifications (see below). This way, you
   can set up the server to listen for connections in both protocols
   concurrently, on different local ports.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-l </literal><replaceable>file</replaceable></term>
  <listitem><para>The logfile.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-c </literal><replaceable>config</replaceable></term>
  <listitem><para>A user option that serves as a specifier for some
  sort of configuration, usually a filename.
  The argument to this option is transferred to member
  <literal>configname</literal> of the
  <literal>statserv_options_block</literal>.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-f </literal><replaceable>vconfig</replaceable></term>
  <listitem><para>This specifies an XML file that describes
  one or more YAZ frontend virtual servers.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-C </literal><replaceable>fname</replaceable></term>
  <listitem><para>Sets SSL certificate file name for server (PEM).
 </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-v </literal><replaceable>level</replaceable></term>
  <listitem><para>
   The log level. Use a comma-separated list of members of the set
   {fatal,debug,warn,log,malloc,all,none}.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-u </literal><replaceable>uid</replaceable></term>
  <listitem><para>
   Set user ID. Sets the real UID of the server process to that of the
   given user. It's useful if you aren't comfortable with having the
   server run as root, but you need to start it as such to bind a
   privileged port.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-w </literal><replaceable>dir</replaceable></term>
  <listitem><para>
   The server changes to this directory before listening
   to incoming connections. This option is useful
   when the server is operating from the <application>inetd</application>
   daemon (see <literal>-i</literal>).
  </para></listitem>
 </varlistentry>
 <varlistentry><term>
  <literal>-p </literal><replaceable>pidfile</replaceable>
 </term>
 <listitem><para>
  Specifies that the server should write its Process ID to the
  file given by <replaceable>pidfile</replaceable>.
  A typical location would be <filename>/var/run/yaz-ztest.pid</filename>.
 </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-i</literal></term>
  <listitem><para>
   Use this to make the the server run from the
   <application>inetd</application> server (UNIX only).
 </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-D</literal></term>
  <listitem><para>
   Use this to make the server put itself in the background and
   run as a daemon. If neither <literal>-i</literal> nor
   <literal>-D</literal> is given, the server starts in the foreground.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-install</literal></term>
  <listitem><para>
   Use this to install the server as an NT service
   (Windows NT/2000/XP only).
   Control the server by going to the Services in the Control Panel.
 </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-installa</literal></term>
  <listitem><para>
   Use this to install the server as an NT service and mark it as "auto-start.
   Control the server by going to the Services in the Control Panel.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-remove</literal></term>
  <listitem><para>
   Use this to remove the server from the NT services
   (Windows NT/2000/XP only).
 </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-t </literal><replaceable>minutes</replaceable></term>
  <listitem><para>
   Idle session timeout, in minutes.
 </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-k </literal><replaceable>size</replaceable></term>
  <listitem><para>
   Maximum record size/message size, in kilobytes.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-K</literal></term>
  <listitem><para>
   Forces no-keepalive for HTTP sessions. By default GFS will keep
   sessions alive for HTTP 1.1 sessions (as defined by the standard).
   Using this option will force GFS to close the connection for each
   operation.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-r </literal><replaceable>size</replaceable></term>
  <listitem><para>
   Maximum size of log file before rotation occurs, in kilobytes.
   Default size is 1048576 k (=1 GB).
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term>
   <literal>-d </literal><replaceable>daemon</replaceable>
  </term>
  <listitem><para>
   Set name of daemon to be used in hosts access file.
   See
   <citerefentry>
    <refentrytitle>hosts_access</refentrytitle>
    <manvolnum>5</manvolnum>
   </citerefentry>
   and
   <citerefentry>
    <refentrytitle>tcpd</refentrytitle>
    <manvolnum>8</manvolnum>
    </citerefentry>.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-m </literal><replaceable>time-format</replaceable></term>
  <listitem><para>
   Sets the format of time-stamps in the log-file. Specify a string in
   the input format to <literal>strftime()</literal>.
  </para></listitem>
 </varlistentry>
 <varlistentry>
  <term><literal>-V </literal></term>
  <listitem><para>
   Display YAZ version and exit.
  </para></listitem>
 </varlistentry>
</variablelist>

<!-- Keep this comment at the end of the file
Local variables:
mode: nxml
nxml-child-indent: 1
End:
-->
