X-Git-Url: http://www.dolda2000.com/gitweb/?p=ashd.git;a=blobdiff_plain;f=doc%2Faccesslog.doc;h=c33c6d629ad8069590a24eafe9f6bb96727afca6;hp=0ae76532f9c5fb81fbc177358b8563f9d6324381;hb=fda48525a7bab9e487e69264619ebdbabcd83ff2;hpb=0bb6f3d452b281a8b9992199932bbd95ed1ae306 diff --git a/doc/accesslog.doc b/doc/accesslog.doc index 0ae7653..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'] '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 ------- @@ -46,6 +53,12 @@ OPTIONS record format. See the FORMAT section, below, for a description of the 'FORMAT' string. +*-p* 'PIDFILE':: + + 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*:: Try to emulate the Apache "combined" log format as closely as @@ -58,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 ------