X-Git-Url: http://www.dolda2000.com/gitweb/?p=ashd.git;a=blobdiff_plain;f=doc%2Faccesslog.doc;h=1ba3d131bc6c44bb5489397672d35d256ba644f7;hp=0ae76532f9c5fb81fbc177358b8563f9d6324381;hb=ca170d77b595e63bbbaba28ace23cc88e855c41a;hpb=0bb6f3d452b281a8b9992199932bbd95ed1ae306

diff --git a/doc/accesslog.doc b/doc/accesslog.doc
index 0ae7653..1ba3d13 100644
--- a/doc/accesslog.doc
+++ b/doc/accesslog.doc
@@ -7,7 +7,8 @@ accesslog - Access logger for ashd(7)
 
 SYNOPSIS
 --------
-*accesslog* [*-hFa*] [*-f* 'FORMAT'] 'OUTFILE' 'CHILD' ['ARGS'...]
+*accesslog* [*-hFaL*] [*-f* 'FORMAT'] [*-p* 'PIDFILE'] 'OUTFILE' 'CHILD' ['ARGS'...]
+*accesslog* *-P* 'LOGFILE'
 
 DESCRIPTION
 -----------
@@ -28,6 +29,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
 -------
 
@@ -46,6 +52,12 @@ OPTIONS
 	record format. See the FORMAT section, below, for a
 	description of the 'FORMAT' string.
 
+*-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.
+
 *-a*::
 
 	Try to emulate the Apache "combined" log format as closely as
@@ -58,6 +70,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
 ------