X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fyaz-proxy-ref.xml;h=252ed1ddc822f8cdfdc5f592102eaa4c651e7e39;hb=4ffb5c5f0c0c64799a89f7961fd553ae8ae4854b;hp=776f28aee69b884ea8549d246158374aa154a224;hpb=21a225e7679ccbdd471508cacebb30592e7f5ad9;p=yazpp-moved-to-github.git

diff --git a/doc/yaz-proxy-ref.xml b/doc/yaz-proxy-ref.xml
index 776f28a..252ed1d 100644
--- a/doc/yaz-proxy-ref.xml
+++ b/doc/yaz-proxy-ref.xml
@@ -10,13 +10,16 @@
  <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>
@@ -40,7 +43,7 @@
  </para>
  <para>
   <command>yaz-proxy</command> rereads its configuration file and
-  reopens log files when it receivies the hangup signal, SIGHUP.
+  reopens log files when it receives the hangup signal, SIGHUP.
  </para>
 </refsect1>
 <refsect1><title>OPTIONS</title>
@@ -53,6 +56,14 @@
      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
@@ -61,7 +72,7 @@
   </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>
@@ -73,7 +84,7 @@
      <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
@@ -101,7 +112,22 @@
      Specifies in seconds the idle time for communication between
      proxy and backend target.
      If a connection is inactive for this long
-     it willl be closed. Default: 600 seconds (10 minutes).
+     it will 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 privileged 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>