Note on Windows service only available for YAZ 3.0.29.

[pazpar2-moved-to-github.git] / doc / pazpar2.xml

diff --git a/doc/pazpar2.xml b/doc/pazpar2.xml
index b739405..491a2cb 100644 (file)
--- a/doc/pazpar2.xml
+++ b/doc/pazpar2.xml
@@ -8,7 +8,6 @@
      <!ENTITY % idcommon SYSTEM "common/common.ent">
      %idcommon;
 ]>
-<!-- $Id: pazpar2.xml,v 1.7 2007-06-22 13:18:23 adam Exp $ -->
 <refentry id="pazpar2">
  <refentryinfo>
   <productname>Pazpar2</productname>
@@ -30,11 +29,15 @@
    <arg choice="opt"><option>-d</option></arg>
    <arg choice="opt"><option>-D</option></arg>
    <arg choice="opt"><option>-f <replaceable>config</replaceable></option></arg>
+   <arg choice="opt"><option>-h <replaceable>ip:port</replaceable></option></arg>
    <arg choice="opt"><option>-l <replaceable>logfile</replaceable></option></arg>
    <arg choice="opt"><option>-p <replaceable>pidfile</replaceable></option></arg>
    <arg choice="opt"><option>-t <replaceable>path</replaceable></option></arg>
    <arg choice="opt"><option>-u <replaceable>uid</replaceable></option></arg>
+   <arg choice="opt"><option>-V</option></arg>
    <arg choice="opt"><option>-X</option></arg>
+   <arg choice="opt"><option>-install</option></arg>
+   <arg choice="opt"><option>-remove</option></arg>
   </cmdsynopsis>
  </refsynopsisdiv>
  
@@ -58,8 +61,8 @@
     <term><option>-d</option></term>
     <listitem>
      <para>
-      Enables dump of XML records. It is useful if stylesheets are
-      being debugged.
+      Enables dump of XML records to the current log file.
+      It is useful if stylesheets are being debugged.
      </para>
     </listitem>
    </varlistentry>
@@ -79,6 +82,17 @@
     </listitem>
    </varlistentry>
    <varlistentry>
+    <term><option>-h <replaceable>ip:port</replaceable></option></term>
+    <listitem>
+     <para>
+      Specifies the HTTP listener binding address.
+      The <replaceable>ip</replaceable>
+      may be a hostname or <literal>@</literal> for "any" address.
+      The <replaceable>port</replaceable> is an integer.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
     <term><option>-l <replaceable>logfile</replaceable></option></term>
     <listitem>
      <para>
@@ -119,6 +133,17 @@
    </varlistentry>
 
    <varlistentry>
+    <term><option>-V</option></term>
+    <listitem>
+     <para>
+      Shows Pazpar2 version and versions of some of the components that it
+      is using (ICU and YAZ). Pazpar2 will not exit immediately after
+      displaying the version information (no daemon started).
+     </para>
+    </listitem>
+   </varlistentry>
+
+   <varlistentry>
     <term><option>-X</option></term>
     <listitem>
      <para>
@@ -129,16 +154,72 @@
     </listitem>
    </varlistentry>
 
+   <varlistentry>
+    <term><option>-install</option></term>
+    <listitem>
+     <para>
+       This is an option which is only recognized on Windows. It installs
+       Pazpar2 as a Windows Service.
+     </para>
+     <note>
+       <para>
+        Pazpar2 only supports Windows Service options if Pazpar2 is
+        linked against YAZ 3.0.29 or later.
+       </para>
+     </note>
+    </listitem>
+   </varlistentry>
+
+   <varlistentry>
+    <term><option>-remove</option></term>
+    <listitem>
+     <para>
+       This is an option which is only recognized on Windows. It removes
+       a Pazpar2 - Windows Service.
+     </para>
+    </listitem>
+   </varlistentry>
+
   </variablelist>
   
  </refsect1>
  
  <refsect1><title>EXAMPLES</title>
-  <para>None yet</para>
+  <para>The Debian package of pazpar2 starts the server with:
+   <screen>
+    pazpar2 -D -f /etc/pazpar2/pazpar2.cfg -l /var/log/pazpar2.log -p /var/run/pazpar2.pid -u nobody
+   </screen>
+   (one line). 
+  </para>
+  <para>
+   This will put pazpar2 in the background (-D), read config from from
+   <filename>/etc/pazpar2/pazpar2.cfg</filename>, log messages to
+   <filename>/var/log/pazpar2.log</filename>, create PID file
+   <filename>/var/run/pazpar2.pid</filename>. When the daemon is properly
+   started, the server will change effective user ID to nobody.
+  </para>
+  <para>
+   The server can be terminated with:
+   <screen>
+    kill `cat /var/run/pazpar2.pid`
+   </screen>
+  </para>
+  <para>
+   If Pazpar2 is to be debugged using GDB, we use option -X:
+   <screen>
+    cd pazpar2/src
+    gdb ./pazpar2
+    (gdb) run -X -f ../etc/pazpar2.cfg
+   </screen>
+  </para>
  </refsect1> 
  
  <refsect1><title>FILES</title>
-  <para></para>
+  <para><filename>/usr/sbin/pazpar2</filename>: pazpar2 daemon</para>
+
+  <para><filename>/usr/share/pazpar2</filename>: pazpar2 shared files</para>
+
+  <para><filename>/etc/pazpar2</filename>: pazpar2 config area</para>
  </refsect1>
  
  <refsect1><title>SEE ALSO</title>
@@ -150,7 +231,7 @@
    </citerefentry>
   </para>
   <para>
-   Pazpar2 protocol:.
+   Pazpar2 protocol:
    <citerefentry>
     <refentrytitle>pazpar2_protocol</refentrytitle>
     <manvolnum>7</manvolnum>