X-Git-Url: http://www.dolda2000.com/gitweb/?p=ashd.git;a=blobdiff_plain;f=doc%2Faccesslog.doc;h=c33c6d629ad8069590a24eafe9f6bb96727afca6;hp=39ec14a731297718302c82050477fc25a93ecf2a;hb=fda48525a7bab9e487e69264619ebdbabcd83ff2;hpb=472abd3cd62e50a4e9d2bfc5368547e6325ed31b

diff --git a/doc/accesslog.doc b/doc/accesslog.doc
index 39ec14a..c33c6d6 100644
--- a/doc/accesslog.doc
+++ b/doc/accesslog.doc
@@ -7,7 +7,9 @@ accesslog - Access logger for ashd(7)
 
 SYNOPSIS
 --------
-*accesslog* [*-hFa*] [*-f* 'FORMAT'] [*-p* 'PIDFILE'] 'OUTFILE' 'CHILD' ['ARGS'...]
+*accesslog* [*-hFaL*] [*-f* 'FORMAT'] [*-p* 'PIDFILE'] 'OUTFILE' 'CHILD' ['ARGS'...]
+
+*accesslog* *-P* 'LOGFILE'
 
 DESCRIPTION
 -----------
@@ -28,6 +30,11 @@ useful e.g. for log rotation.
 
 If the child handler exits, *accesslog* exits as well.
 
+Normally, *accesslog* locks the logfile using *fcntl*(2) to ensure
+that only one process writes to a logfile at any time. The *-L* switch
+can be used to override that behavior to let several processes share a
+logfile, or to use logfiles that cannot be locked for some reason.
+
 OPTIONS
 -------
 
@@ -48,9 +55,9 @@ OPTIONS
 
 *-p* 'PIDFILE'::
 
-	Write the PID of the *accesslog* to 'PIDFILE'. 'PIDFILE' may
-	be `-`, in which case the string "`.pid`" is appended to the
-	log file name and used instead.
+	Write the PID of the *accesslog* process to
+	'PIDFILE'. 'PIDFILE' may be `-`, in which case the string
+	"`.pid`" is appended to the log file name and used instead.
 
 *-a*::
 
@@ -64,6 +71,20 @@ OPTIONS
 %A - - [%{%d/%b/%Y:%H:%M:%S %z}t] "%m %u %v" - - "%R" "%G"
 --------
 
+*-L*::
+
+	Do not attempt to lock the logfile. Note that this switch
+	conflicts with the use of the *-P* option.
+
+*-P* 'LOGFILE'::
+
+	Makes *accesslog* fetch the PID of the process currently
+	holding the lock on 'LOGFILE', write that to standard output,
+	and then exit. No further command-line arguments are
+	processed. This option is useful for sending SIGHUP to
+	accesslog when rotating logfiles without having to use a PID
+	file.
+
 FORMAT
 ------