Description of the '-l syslog-local-user' option in the slapd manpage;

also description of .pid and .args files.

diff --git a/build/man.mk b/build/man.mk
index 159bf0eee58b453224a5cb7d356758b4179d3d94..259112c2918e895156f962c7168d83efdf08a3ac 100644 (file)
--- a/build/man.mk
+++ b/build/man.mk
@@ -15,6 +15,7 @@ install-common: FORCE
        for page in *.$(MANSECT); do \
                $(SED) -e "s%LDVERSION%$$VERSION%" \
                        -e 's%ETCDIR%$(sysconfdir)%' \
+                       -e 's%LOCALSTATEDIR%$(localstatedir)%' \
                        -e 's%SYSCONFDIR%$(sysconfdir)%' \
                        -e 's%DATADIR%$(datadir)%' \
                        -e 's%SBINDIR%$(sbindir)%' \

diff --git a/doc/man/man8/slapd.8 b/doc/man/man8/slapd.8
index e63ca7450e63be3c6b715d93914bbddd2821bc3a..57e1683ff804910a0e92b385955821eafc1e4a00 100644 (file)
--- a/doc/man/man8/slapd.8
+++ b/doc/man/man8/slapd.8
@@ -4,7 +4,7 @@ slapd \- Stand-alone LDAP Daemon
 .SH SYNOPSIS
 .B LIBEXECDIR/slapd [\-d debug\-level]
 .B [\-f slapd\-config\-file] [\-p port\-number]
-.B [\-s syslog\-level] [\-i]
+.B [\-s syslog\-level] [\-l syslog\-local\-user] [\-i]
 .B 
 .SH DESCRIPTION
 .LP
@@ -18,6 +18,26 @@ is typically invoked at boot time, usually out of
 Upon startup,
 .B slapd
 normally forks and disassociates itself from the invoking tty.
+In this case, the
+.B slapd
+process will print its process ID to a 
+.B .pid
+file ( see
+.BR getpid (2)
+), as well as the command line options during invocation to an
+.B .args
+file. By default, these files are located in the directory 
+.B LOCALSTATEDIR.
+The files' base names are derived from the 
+.B slapd
+binary name, making it possible to run several 
+.B slapd
+servers with differet names on the same machine, with each having
+its own 
+.B .pid/.args 
+files. (Those 
+.B slapd
+names might be obtained via symbolic links to one binary file.)
 If the
 .B \-d
 flag is given and debugging is set to some non-zero
@@ -55,6 +75,21 @@ at what level debugging statements should be logged to the
 .BR syslog (8)
 facility.
 .TP
+.BI \-l " syslog\-local\-facility"
+Selects the local user of the
+.BR syslog (8)
+facility. Values can be 
+.BR LOCAL0 , 
+.BR LOCAL1 , 
+and so on, up to 
+.BR LOCAL7 . 
+The default is
+.BR LOCAL4 .
+However, this option is only permitted on systems that support
+local users with the 
+.BR syslog (8)
+facility.
+.TP
 .BI \-f " slapd\-config\-file"
 Specifies the slapd configuration file. The default is
 .BR ETCDIR/slapd.conf .