From 77c35c2bcc3b4f69eb07487407ee60e5a1816266 Mon Sep 17 00:00:00 2001
From: Kurt Spanier <ksp@openldap.org>
Date: Fri, 8 Jan 1999 09:59:09 +0000
Subject: [PATCH] Description of the '-l syslog-local-user' option in the slapd
 manpage; also description of .pid and .args files.

---
 build/man.mk         |  1 +
 doc/man/man8/slapd.8 | 37 ++++++++++++++++++++++++++++++++++++-
 2 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/build/man.mk b/build/man.mk
index 159bf0eee5..259112c291 100644
--- 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 e63ca7450e..57e1683ff8 100644
--- 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 .
-- 
2.39.5