1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd"
4 <!ENTITY % local SYSTEM "local.ent">
6 <!ENTITY % entities SYSTEM "entities.ent">
8 <!ENTITY % idcommon SYSTEM "common/common.ent">
11 <!-- $Id: pazpar2.xml,v 1.6 2007-06-18 12:55:43 adam Exp $ -->
12 <refentry id="pazpar2">
14 <productname>Pazpar2</productname>
15 <productnumber>&version;</productnumber>
18 <refentrytitle>Pazpar2</refentrytitle>
19 <manvolnum>8</manvolnum>
23 <refname>pazpar2</refname>
24 <refpurpose>Metasearch daemon.</refpurpose>
29 <command>pazpar2</command>
30 <arg choice="opt"><option>-d</option></arg>
31 <arg choice="opt"><option>-D</option></arg>
32 <arg choice="opt"><option>-f <replaceable>config</replaceable></option></arg>
33 <arg choice="opt"><option>-l <replaceable>logfile</replaceable></option></arg>
34 <arg choice="opt"><option>-p <replaceable>pidfile</replaceable></option></arg>
35 <arg choice="opt"><option>-t <replaceable>path</replaceable></option></arg>
36 <arg choice="opt"><option>-u <replaceable>uid</replaceable></option></arg>
37 <arg choice="opt"><option>-X</option></arg>
41 <refsect1><title>DESCRIPTION</title>
42 <para><command>pazpar2</command> is the pazpar2 Metasearch daemon
44 In normal operation it acts as a simple HTTP server which serves
46 The HTTP listener address may be given on the command line using
47 option <option>-h</option> or in the main configuration
48 file. The main configuration must be specified using option
53 <refsect1><title>OPTIONS</title>
58 <term><option>-d</option></term>
61 Enables dump of XML records. It is useful if stylesheets are
67 <term><option>-D</option></term>
69 <para>Puts the pazpar2 server in the background.</para>
73 <term><option>-f <replaceable>config</replaceable></option></term>
76 Specifies main configuration. This option must be specified
77 in order for pazpar2 to operate normally.
82 <term><option>-l <replaceable>logfile</replaceable></option></term>
85 Specifies log file. The log file must be specified when pazpar2
86 is running in the background (-D).
91 <term><option>-p <replaceable>pidfile</replaceable></option></term>
94 Specifies PID file. If pazpar2 is started and configured properly
95 the file given holds the process ID of the pazpar2 process.
100 <term><option>-t <replaceable>path</replaceable></option></term>
103 Specifies a file or directory with alternative settings. This
104 overrides the <literal>settings</literal> element in the main
111 <term><option>-u <replaceable>uid</replaceable></option></term>
114 Specifies that pazpar2 change user to the
115 <replaceable>uid</replaceable> given.
116 This, normally, require root privilege.
122 <term><option>-X</option></term>
125 Makes the pazpar2 server operate in debugging mode. This prevents pazpar2
126 from making separate threads and processes. This option
127 should not be used in production.
136 <refsect1><title>EXAMPLES</title>
137 <para>None yet</para>
140 <refsect1><title>FILES</title>
144 <refsect1><title>SEE ALSO</title>
146 Pazpar2 configuration:
148 <refentrytitle>pazpar2_conf</refentrytitle>
149 <manvolnum>5</manvolnum>
155 <refentrytitle>pazpar2_protocol</refentrytitle>
156 <manvolnum>7</manvolnum>
164 <!-- Keep this comment at the end of the file
169 sgml-minimize-attributes:nil
170 sgml-always-quote-attributes:t
173 sgml-parent-document:nil
174 sgml-local-catalogs: nil
175 sgml-namecase-general:t