Fixed bug #615: Document retrievalInfo facilities for Frontend Server.
[yaz-moved-to-github.git] / doc / yaz-ztest-man.xml
1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
2  "http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd"
3 [
4      <!ENTITY % local SYSTEM "local.ent">
5      %local;
6      <!ENTITY % entities SYSTEM "entities.ent">
7      %entities;
8      <!ENTITY % common SYSTEM "common/common.ent">
9      %common;
10      <!ENTITY gfs-synopsis-app "yaz-ztest">
11      <!ENTITY reference-tools-cql-map 'section "Specifiction of CQL to RPN mappings"'>
12 ]>
13 <!-- $Id: yaz-ztest-man.xml,v 1.15 2007-02-08 11:36:59 adam Exp $ -->
14 <refentry id="yaz-ztest">
15  <refentryinfo>
16   <productname>YAZ</productname>
17   <productnumber>&version;</productnumber>
18  </refentryinfo>
19  
20  <refmeta>
21   <refentrytitle>yaz-ztest</refentrytitle>
22   <manvolnum>8</manvolnum>
23  </refmeta>
24  
25  <refnamediv>
26   <refname>yaz-ztest</refname>
27   <refpurpose>Z39.50 Test Server</refpurpose>
28  </refnamediv>
29  
30  <refsynopsisdiv>
31   &gfs-synopsis;
32  </refsynopsisdiv>
33  <refsect1><title>DESCRIPTION</title>
34   <para>
35    <command>yaz-ztest</command> is a Z39.50 test server that uses
36    the YAZ generic frontend server API.
37    The server acts as a real Z39.50 server but does not use a database.
38    It returns a random hit count and returns a subset of a few built-in
39    records.
40   </para>
41   <para>
42    The <replaceable>listener-spec</replaceable> consists of a transport
43    mode followed by a colon, followed by a listener address. The
44    transport mode is either <literal>tcp</literal>, <literal>unix</literal>,
45    or <literal>ssl</literal>.
46   </para>
47   <para>
48    For TCP and SSL, an address has the form:
49    <screen>
50     hostname | IP-number [ : portnumber ]
51    </screen>
52   </para>
53   <para>
54    For UNIX local socket the address is the filename of the local socket.
55   </para>
56  </refsect1>
57  <refsect1>
58   <title>OPTIONS</title>
59   &gfs-options;
60  </refsect1>
61  <refsect1><title>VIRTUAL HOSTS</title>
62   &gfs-virtual;
63  </refsect1>
64  <refsect1><title>FILES</title>
65   <para>
66    <filename>yaz-&lt;version&gt;/ztest/yaz-ztest.c</filename>
67   </para>
68   <para>
69    <filename>yaz-&lt;version&gt;/include/yaz/backend.h</filename>
70   </para>
71  </refsect1>
72  <refsect1 id="tools.retrieval"><title>Retrieval Facility</title>
73   <para>
74    Refer to the "Retrieval Facility" in the YAZ manual
75  </para>
76  </refsect1>
77  <refsect1 id="cql.to.rpn"><title>CQL to RPN conversions</title>
78   <para>
79    Refer to the "Specification of CQL to RPN mappings" in YAZ manual.
80   </para>
81  </refsect1>
82  <refsect1><title>SEE ALSO</title>
83   <para>
84    <citerefentry>
85     <refentrytitle>yaz</refentrytitle>
86     <manvolnum>7</manvolnum>
87    </citerefentry>
88    <citerefentry>
89     <refentrytitle>yaz-log</refentrytitle>
90     <manvolnum>7</manvolnum>
91    </citerefentry>
92   </para>
93  </refsect1>
94 </refentry>
95
96 <!-- Keep this comment at the end of the file
97 Local variables:
98 mode: sgml
99 sgml-omittag:t
100 sgml-shorttag:t
101 sgml-minimize-attributes:nil
102 sgml-always-quote-attributes:t
103 sgml-indent-step:1
104 sgml-indent-data:t
105 sgml-parent-document:nil
106 sgml-local-catalogs: nil
107 sgml-namecase-general:t
108 End:
109 -->