X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Ffrontend.xml;h=297c5f3b06ed17a528fd4f25dee4fad36380e329;hb=6ba14eb5dc7229aa17977882024a475b6d258368;hp=70329d01f2e65a1f7e75b39aacc5a89b5d3b2dab;hpb=590c128319e6987f82f3e798b12173c5ecf197b4;p=yaz-moved-to-github.git

diff --git a/doc/frontend.xml b/doc/frontend.xml
index 70329d0..297c5f3 100644
--- a/doc/frontend.xml
+++ b/doc/frontend.xml
@@ -1,4 +1,4 @@
-<!-- $Id: frontend.xml,v 1.10 2001-11-27 22:12:24 adam Exp $ -->
+<!-- $Id: frontend.xml,v 1.13 2002-08-17 07:55:51 adam Exp $ -->
  <chapter id="server"><title>Generic server</title>
   <sect1><title>Introduction</title>
 
@@ -224,7 +224,7 @@ statserv_options_block *statserv_getcontrol(void);
      
      <varlistentry><term>
        <literal>int idle_timeout;</literal></term>
-      <listitem><para>Maximum session idletime, in minutes. Zero indicates
+      <listitem><para>Maximum session idle-time, in minutes. Zero indicates
 	no (infinite) timeout. Default is 120 minutes.
        </para></listitem></varlistentry>
      
@@ -342,6 +342,7 @@ typedef struct bend_initrequest
     Z_ReferenceId *referenceId;/* reference ID */
     char *peer_name;           /* dns host of peer (client) */
 
+    char *implementation_id;
     char *implementation_name;
     char *implementation_version;
     int (*bend_sort) (void *handle, bend_sort_rr *rr);
@@ -394,8 +395,9 @@ typedef struct bend_initresult
 
     <para>
      The members <literal>peer_name</literal>,
+     <literal>implementation_id</literal>,
      <literal>implementation_name</literal> and
-     <literal>implementation_version</literal> holds DNS of client, name
+     <literal>implementation_version</literal> holds DNS of client, ID of implementor, name
      of client (Z39.50) implementation - and version.
     </para>
 
@@ -649,7 +651,7 @@ typedef enum {
 } bend_scan_status;
 
 typedef struct bend_scan_rr {
-    int num_bases;      /* number of elements in databaselist */
+    int num_bases;      /* number of elements in database list */
     char **basenames;   /* databases to search */
     oid_value attributeset;
     Z_ReferenceId *referenceId; /* reference ID */
@@ -678,7 +680,7 @@ typedef struct bend_scan_rr {
    </para>
 
    <synopsis>
-    <replaceable>appname</replaceable> &lsqb;-szSiTu -a <replaceable>apdufile</replaceable> -l <replaceable>logfile</replaceable> -v <replaceable>loglevel</replaceable> -c <replaceable>config</replaceable>&rsqb;
+    <replaceable>appname</replaceable> &lsqb;-szSiT1 -u <replaceable>uid</replaceable> -a <replaceable>apdufile</replaceable> -l <replaceable>logfile</replaceable> -v <replaceable>loglevel</replaceable> -c <replaceable>config</replaceable>&rsqb;
     &lsqb;listener ...&rsqb;
    </synopsis>
 
@@ -688,7 +690,7 @@ typedef struct bend_scan_rr {
     <variablelist>
 
      <varlistentry><term><literal>-a </literal>
-       <replaceable>file</replaceable></term>
+       <replaceable>apdufile</replaceable></term>
       <listitem><para>
 	Specify a file for dumping PDUs (for diagnostic purposes).
 	The special name &quot;-&quot; sends output to
@@ -704,6 +706,12 @@ typedef struct bend_scan_rr {
 	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
@@ -743,11 +751,11 @@ typedef struct bend_scan_rr {
        <replaceable>level</replaceable></term>
       <listitem><para>
 	The log level. Use a comma-separated list of members of the set
-	{fatal,debug,warn,log,all,none}.
+	{fatal,debug,warn,log,malloc,all,none}.
        </para></listitem></varlistentry>
 
      <varlistentry><term><literal>-u </literal>
-       <replaceable>userid</replaceable></term>
+       <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
@@ -758,7 +766,10 @@ typedef struct bend_scan_rr {
      <varlistentry><term><literal>-w </literal>
        <replaceable>dir</replaceable></term>
       <listitem><para>
-	Working directory.
+	The server changes to this directory during before listening 
+        on 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>-i</literal></term>
@@ -769,36 +780,39 @@ typedef struct bend_scan_rr {
      
      <varlistentry><term><literal>-install</literal></term>
       <listitem><para>
-	Use this to install the server as an NT service (Windows 2000/NT only). 
+	Use this to install the server as an NT service
+        (Windows 2000/NT only). 
         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 2000/NT only). 
+	Use this to remove the server from the NT services
+        (Windows 2000/NT 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>
+       <replaceable>size</replaceable></term>
       <listitem><para>
 	Maximum record size/message size, in kilobytes.
        </para></listitem></varlistentry>
-
+     
     </variablelist>
    </para>
-
+   
    <para>
     A listener specification consists of a transport mode followed by a
     colon (:) followed by a listener address. The transport mode is
-    either <literal>tcp</literal> or <literal>ssl</literal>.
+    either <literal>tcp</literal>, <literal>unix:</literal> or
+    <literal>ssl</literal>.
    </para>
-
+   
    <para>
     For TCP and SSL, an address has the form
    </para>
@@ -812,6 +826,10 @@ typedef struct bend_scan_rr {
    </para>
 
    <para>
+    For UNIX local socket the address is the name local file.
+   </para>
+   
+   <para>
     Examples
    </para>
 
@@ -819,10 +837,12 @@ typedef struct bend_scan_rr {
     tcp:dranet.dra.com
 
     ssl:ssl.enterprise.com:3000
+
+    unix:/tmp/yaz
    </screen>
 
    <para>
-    In both cases, the special hostname &quot;@&quot; is mapped to
+    For TCP/IP and SSL, the special hostname &quot;@&quot; is mapped to
     the address <literal>INADDR_ANY</literal>, which causes the
     server to listen on any local interface. 
    </para>