pazpar2 — Metasearch daemon.
-f ] [
-h ] [
-l ] [
-m ] [
-p ] [
-R ] [
-u ] [
-v ] [
-w ] [
pazpar2 is the Pazpar2 Metasearch daemon
In normal operation it acts as a simple HTTP server which serves
the Pazpar2 protocol.
The HTTP listener address may be given on the command line using
-h or in the main configuration
file. The main configuration must be specified using option
Enables dump of XML records to the current log file. It is useful if stylesheets are being debugged. Using this option twice makes Pazpar2 also dump full HTTP responses.
This option may also be used together with option
in which case the configuration, after include processing, will be
dumped to stdout.
Puts the Pazpar2 server in the background.
Specifies main configuration. This option must be specified in order for Pazpar2 to operate normally.
Specifies the HTTP listener binding address.
may be a hostname, or
@ for "any" address.
port is an integer.
Specifies log file. The log file must be specified when Pazpar2 is running in the background (-D).
Sets the format of time-stamps for logging. Refer to the strftime(3) man page for the format.
Specifies PID file. If Pazpar2 is started and configured properly, the file given holds the process ID of the Pazpar2 process.
If this option is given, HTTP requests are logged to file named
recfile and predictable sessions are enabled.
Using special argument, dash
-), will make Pazpar2 use predictable sessions
only (no recording).
This is necessary when playing HTTP communication against pazpar2
with the pazpar2_play program. Refer to Pazpar2_play(1).
Checks parameters and configuration. No service or daemon is started. Useful for checking a new configuration before a Pazpar2 is restarted.
The configuration, after include processing, may also be dumped
to stdout by supplying option
-d as well.
In Pazpar2 1.2 and earlier releases, option -t specified a local target settings file.
Makes the Pazpar2 server change user ID to the
This, normally, requires root privilege.
Sets log level (YAZ log level system).
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).
Changes working directory to
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.
This is an option which is only recognized on Windows. It installs Pazpar2 as a Windows Service.
Pazpar2 only supports Windows Service options if Pazpar2 is linked against YAZ 3.0.29 or later.
This is an option which is only recognized on Windows. It removes a Pazpar2 - Windows Service.
The Debian package of pazpar2 starts the server with:
pazpar2 -D -f /etc/pazpar2/pazpar2.cfg -l /var/log/pazpar2.log -p /var/run/pazpar2.pid -u nobody
This will put pazpar2 in the background (-D), read config from from
/etc/pazpar2/pazpar2.cfg, log messages to
/var/log/pazpar2.log, create PID file
/var/run/pazpar2.pid. When the daemon is properly
started, the server will change effective user ID to nobody.
The server can be terminated with:
kill `cat /var/run/pazpar2.pid`
If Pazpar2 is to be debugged using GDB, we use option -X:
cd pazpar2/src gdb ./pazpar2 (gdb) run -X -f ../etc/pazpar2.cfg
/usr/sbin/pazpar2: pazpar2 daemon
/usr/share/pazpar2: pazpar2 shared files
/etc/pazpar2: pazpar2 config area