+ <refsect1>
+ <title>OPTIONS</title>
+
+ <variablelist>
+ <varlistentry>
+ <term><option>-d</option></term>
+ <listitem>
+ <para>
+ Enables dump of XML records to the current log file.
+ It is useful if stylesheets are being debugged.
+ </para>
+ <para>
+ This option may also be used together with option <option>-t</option>
+ in which case the configuration, after include processing, will be
+ dumped to stdout.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-D</option></term>
+ <listitem>
+ <para>
+ Puts the Pazpar2 server in the background.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-f <replaceable>config</replaceable></option></term>
+ <listitem>
+ <para>
+ Specifies main configuration. This option must be specified
+ in order for Pazpar2 to operate normally.
+ </para>
+ </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>
+ Specifies log file. The log file must be specified when Pazpar2
+ is running in the background (-D).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>-m <replaceable>timeformat</replaceable></term>
+ <listitem><para>
+ Sets the format of time-stamps for logging.
+ Refer to the
+ <ulink
+ url="http://pubs.opengroup.org/onlinepubs/009695399/functions/strftime.html">
+ strftime(3)</ulink>
+ man page for the format.
+ </para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-p <replaceable>pidfile</replaceable></option></term>
+ <listitem>
+ <para>
+ Specifies PID file. If Pazpar2 is started and configured properly
+ the file given holds the process ID of the Pazpar2 process.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-R <replaceable>recfile</replaceable></option></term>
+ <listitem>
+ <para>
+ If this option is given, HTTP requests are logged to file named
+ <replaceable>recfile</replaceable>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-t</option></term>
+ <listitem>
+ <para>
+ Checks parameters and configuration. No service or daemon is
+ started. Useful for checking a new configuration before a
+ Pazpar2 is restarted.
+ </para>
+ <para>
+ The configuration, after include processing, may also be dumped
+ to stdout by supplying option <option>-d</option> as well.
+ </para>
+ <note>
+ <para>
+ In Pazpar2 1.2 and earlier releases, option -t specified a
+ local target settings file.
+ </para>
+ </note>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-u <replaceable>uid</replaceable></option></term>
+ <listitem>
+ <para>
+ Makes the Pazpar2 server change user ID to the
+ <replaceable>uid</replaceable> given.
+ This, normally, requires root privilege.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-v <replaceable>level</replaceable></option></term>
+ <listitem>
+ <para>
+ Sets log level (YAZ log level system).
+ </para>
+ </listitem>
+ </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 exit immediately after
+ displaying the version information (no daemon started).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-w <replaceable>dir</replaceable></option></term>
+ <listitem>
+ <para>
+ Changes working directory to <replaceable>dir</replaceable>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-X</option></term>
+ <listitem>
+ <para>
+ Makes the Pazpar2 server operate in debugging mode.
+ This prevents Pazpar2 from making separate threads and processes.
+ This option should not be used in production.
+ </para>
+ </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>