doc/yaz-ztest-man.xml

   1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
   2      <!ENTITY ztest-options SYSTEM "ztest-options.xml">
   3 ]>
   4 <!-- $Id: yaz-ztest-man.xml,v 1.5 2004-05-10 10:46:26 adam Exp $ -->
   5 <refentry id="yaz-ztest">
   6
   7  <refmeta>
   8   <refentrytitle>yaz-ztest</refentrytitle>
   9   <manvolnum>8</manvolnum>
  10  </refmeta>
  11
  12  <refnamediv>
  13   <refname>yaz-ztest</refname>
  14   <refpurpose>Z39.50 Test Server</refpurpose>
  15  </refnamediv>
  16
  17  <refsynopsisdiv>
  18   <cmdsynopsis>
  19    <command>yaz-ztest</command>
  20    <arg choice="opt"><option>-install</option></arg>
  21    <arg choice="opt"><option>-installa</option></arg>
  22    <arg choice="opt"><option>-remove</option></arg>
  23    <arg choice="opt"><option>-a <replaceable>file</replaceable></option></arg>
  24    <arg choice="opt"><option>-v <replaceable>level</replaceable></option></arg>
  25    <arg choice="opt"><option>-l <replaceable>file</replaceable></option></arg>
  26    <arg choice="opt"><option>-u <replaceable>uid</replaceable></option></arg>
  27    <arg choice="opt"><option>-c <replaceable>config</replaceable></option></arg>
  28    <arg choice="opt"><option>-C <replaceable>fname</replaceable></option></arg>
  29    <arg choice="opt"><option>-t <replaceable>minutes</replaceable></option></arg>
  30    <arg choice="opt"><option>-k <replaceable>kilobytes</replaceable></option></arg>
  31    <arg choice="opt"><option>-d <replaceable>daemon</replaceable></option></arg>
  32    <arg choice="opt"><option>-w <replaceable>dir</replaceable></option></arg>
  33    <arg choice="opt"><option>-p <replaceable>pidfile</replaceable></option></arg>
  34    <arg choice="opt"><option>-ziDST1</option></arg>
  35    <arg choice="opt" rep="repeat">listener-spec</arg>
  36   </cmdsynopsis>
  37
  38  </refsynopsisdiv>
  39  <refsect1><title>DESCRIPTION</title>
  40   <para>
  41    <command>yaz-ztest</command> is a Z39.50 test server that uses
  42    the YAZ frontend server API.
  43    The server acts as a real Z39.50 server but does not use a database.
  44    It returns a random hit count and returns a subset of a few built-in
  45    records.
  46    </para>
  47    <para>
  48     The <replaceable>listener-spec</replaceable> consists of a transport
  49     mode followed by a colon, followed by a listener address. The
  50     transport mode is either <literal>tcp</literal>, <literal>unix</literal>,
  51     or <literal>ssl</literal>.
  52    </para>
  53    <para>
  54     For TCP and SSL, an address has the form:
  55     <screen>
  56      hostname | IP-number [ : portnumber ]
  57     </screen>
  58    </para>
  59    <para>
  60     For UNIX local socket the address is the filename of the local socket.
  61    </para>
  62   </refsect1>
  63   <refsect1>
  64    <title>OPTIONS</title>
  65    &ztest-options;
  66   </refsect1>
  67   <refsect1><title>FILES</title>
  68    <para>
  69     <filename>yaz-&lt;version&gt;/ztest/yaz-ztest.c</filename>
  70    </para>
  71    <para>
  72     <filename>yaz-&lt;version&gt;/include/yaz/backend.h</filename>
  73    </para>
  74   </refsect1>
  75   <refsect1><title>SEE ALSO</title>
  76    <para>
  77     <citerefentry>
  78      <refentrytitle>yaz</refentrytitle>
  79      <manvolnum>7</manvolnum></citerefentry>
  80    </para>
  81    <para>
  82     Section "Generic server" in the YAZ manual.
  83    </para>
  84   </refsect1>
  85 </refentry>
  86
  87 <!-- Keep this comment at the end of the file
  88 Local variables:
  89 mode: sgml
  90 sgml-omittag:t
  91 sgml-shorttag:t
  92 sgml-minimize-attributes:nil
  93 sgml-always-quote-attributes:t
  94 sgml-indent-step:1
  95 sgml-indent-data:t
  96 sgml-parent-document:nil
  97 sgml-local-catalogs: nil
  98 sgml-namecase-general:t
  99 End:
 100 -->