diff options
Diffstat (limited to 'usr.sbin')
-rw-r--r-- | usr.sbin/httpd/src/support/logresolve.8 | 72 | ||||
-rw-r--r-- | usr.sbin/httpd/src/support/rotatelogs.8 | 85 | ||||
-rw-r--r-- | usr.sbin/httpd/src/support/suexec.8 | 65 |
3 files changed, 131 insertions, 91 deletions
diff --git a/usr.sbin/httpd/src/support/logresolve.8 b/usr.sbin/httpd/src/support/logresolve.8 index b442c4e70e8..d8d1757e4e7 100644 --- a/usr.sbin/httpd/src/support/logresolve.8 +++ b/usr.sbin/httpd/src/support/logresolve.8 @@ -1,4 +1,4 @@ -.TH logresolve 8 "March 1998" +.\" $OpenBSD: logresolve.8,v 1.7 2004/12/20 15:23:46 jaredy Exp $ .\" ==================================================================== .\" The Apache Software License, Version 1.1 .\" @@ -56,37 +56,43 @@ .\" originally written at the National Center for Supercomputing Applications, .\" University of Illinois, Urbana-Champaign. .\" -.SH NAME -logresolve \- resolve hostnames for IP-adresses in Apache logfiles -.SH SYNOPSIS -.B logresolve -[ -.BI \-s " filename" -] [ -.B \-c -] < -.I access_log +.Dd December 18, 2004 +.Dt LOGRESOLVE 8 +.Os +.Sh NAME +.Nm logresolve +.Nd resolve hostnames for IP adresses in Apache logfiles +.Sh SYNOPSIS +.Nm logresolve +.Op Fl c +.Op Fl s Ar filename +< +.Ar access_log > -.I access_log.new -.PP -.SH DESCRIPTION -.B logresolve -is a post-processing program to resolve IP-adresses in Apache's access -logfiles. To minimize impact on your nameserver, logresolve has its very own -internal hash-table cache. This means that each IP number will only be looked -up the first time it is found in the log file. -.SH OPTIONS -.TP 12 -.BI \-s " filename" -Specifies a filename to record statistics. -.TP 12 -.B \-c +.Ar access_log.new +.Sh DESCRIPTION +.Nm +is a post-processing program to resolve IP adresses in Apache's access +logfiles. +To minimize impact on the nameserver, +.Nm +has its very own internal hash-table cache. +This means that each IP number will only be looked up the first time it +is found in the log file. +.Pp +The following options are supported: +.Bl -tag -width "-s filename" +.It Fl s Ar filename +Specifies the +.Ar filename +to record statistics. +.It Fl c This causes -.B logresolve -to apply some DNS checks: after finding the hostname from the IP address, it -looks up the IP addresses for the hostname and checks that one of these -matches the original address. -.PD -.SH SEE ALSO -.BR httpd(8) -. +.Nm +to apply some DNS checks: +after finding the hostname from the IP address, it looks up the IP +addresses for the hostname and checks that one of them matches the +original address. +.El +.Sh SEE ALSO +.Xr httpd 8 diff --git a/usr.sbin/httpd/src/support/rotatelogs.8 b/usr.sbin/httpd/src/support/rotatelogs.8 index b523d7a7307..1db26248a23 100644 --- a/usr.sbin/httpd/src/support/rotatelogs.8 +++ b/usr.sbin/httpd/src/support/rotatelogs.8 @@ -1,4 +1,4 @@ -.TH rotatelogs 8 "March 2001" +.\" $OpenBSD: rotatelogs.8,v 1.7 2004/12/20 15:23:46 jaredy Exp $ .\" ==================================================================== .\" The Apache Software License, Version 1.1 .\" @@ -56,39 +56,56 @@ .\" originally written at the National Center for Supercomputing Applications, .\" University of Illinois, Urbana-Champaign. .\" -.SH NAME -rotatelogs \- rotate Apache logs without having to kill the server -.SH SYNOPSIS -.B rotatelogs -.I logfile -.I rotationtime -.I [offset] -.PP -.SH DESCRIPTION -.B rotatelogs +.Dd December 18, 2004 +.Dt ROTATELOGS 8 +.Os +.Sh NAME +.Nm rotatelogs +.Nd rotate Apache logs without having to kill the server +.Sh SYNOPSIS +.Nm rotatelogs +.Ar logfile rotationtime Op Ar offset +.Sh DESCRIPTION +.Nm is a simple program for use in conjunction with Apache's piped logfile feature which can be used like this: - -.fi - TransferLog "| rotatelogs /path/to/logs/access_log 86400" -.mf - -This creates the files /path/to/logs/access_log.nnnn where nnnn is the system -time at which the log nominally starts (this time will always be a multiple of -the rotation time, so you can synchronize cron scripts with it). At the end -of each rotation time (here after 24 hours) a new log is started. -.SH OPTIONS -.IP \fB\fIlogfile\fP -The path plus basename of the logfile. If \fBlogfile\fP includes any -\fB%\fP characters, it is treated as a format string for \fIstrftime(3)\fP. -Otherwise, the suffix .nnnn is automatically added and is the time at which -the logfile was created. -.IP \fB\fIrotationtime\fP +.Bd -literal -offset indent +TransferLog "| rotatelogs /path/to/logs/access_log 86400" +.Ed +.Pp +This creates the files +.Pa /path/to/logs/access_log.nnnn +where +.Em nnnn +is the system time at which the log nominally starts (this time will +always be a multiple of the rotation time, so you can synchronize +.Xr cron 1 +scripts with it). +At the end of each rotation time (here, after 24 hours), a new log is +started. +.Pp +The arguments are as follows: +.Bl -tag -width rotationtime +.It Ar logfile +The path plus basename of the logfile. +If +.Ar logfile +includes any percent characters +.Pq Sq % , +it is treated as a format string for +.Xr strftime 3 . +Otherwise, the suffix +.Em .nnnn +is automatically added and is the time at which the logfile was created. +.It Ar rotationtime The rotation time in seconds. -.IP \fB\fIoffset\fP -The number of minutes offset from UTC. If omitted, zero is assumed and -UTC is used. For example, to use local time in the zone UTC -5 hours, -specify a value of \fI-300\fP for this argument. -.PD -.SH SEE ALSO -.BR httpd(8) +.It Ar offset +The number of minutes offset from UTC. +If omitted, zero is assumed and UTC is used. +For example, to use local time in the zone UTC \-5 hours, specify a +value of \-300 for this argument. +.El +.Sh SEE ALSO +.Xr cron 1 , +.Xr strftime 3 , +.Xr httpd 8 diff --git a/usr.sbin/httpd/src/support/suexec.8 b/usr.sbin/httpd/src/support/suexec.8 index 931a909b3bc..76384a5a78e 100644 --- a/usr.sbin/httpd/src/support/suexec.8 +++ b/usr.sbin/httpd/src/support/suexec.8 @@ -1,4 +1,4 @@ -.TH suexec 8 "March 2001" +.\" $OpenBSD: suexec.8,v 1.9 2004/12/20 15:23:46 jaredy Exp $ .\" ==================================================================== .\" The Apache Software License, Version 1.1 .\" @@ -56,26 +56,43 @@ .\" originally written at the National Center for Supercomputing Applications, .\" University of Illinois, Urbana-Champaign. .\" -.SH NAME -suexec \- Switch User For Exec -.SH SYNOPSIS -.B suexec -V -.PP -No other synopsis for usage, because this program -is otherwise only used internally by the Apache HTTP server. -.PP -.SH DESCRIPTION -.B suexec -is the "wrapper" support program for the suexec behaviour for the -Apache HTTP server. It is run from within the server automatically -to switch the user when an external program has to be run under a -different user. For more information about suexec, see the online -document `Apache suexec Support' on the HTTP server project's -Web site at http://httpd.apache.org/docs/suexec.html . -.SH OPTIONS -.IP -V -Display the list of compile-time settings used when \fBsuexec\fP -was built. No other action is taken. -.PD -.SH SEE ALSO -.BR httpd(8) +.Dd December 18, 2004 +.Dt SUEXEC 8 +.Os +.Sh NAME +.Nm suexec +.Nd switch user for Apache CGI execution +.Sh SYNOPSIS +.Nm suexec +.Fl V +.Sh DESCRIPTION +.Nm +is the +.Dq wrapper +support program for the +.Em suexec +behaviour for the Apache HTTP server. +It is run from within the server automatically to switch the user when +an external program has to be run under a different user. +For more information about +.Nm , +see the online document +.Dq Apache suexec Support +on the Apache project's Web site at +.Pa http://httpd.apache.org/docs/suexec.html . +.Pp +The options are as follows: +.Bl -tag -width indent +.It Fl V +Display the list of compile-time settings used when +.Nm +was built. +No other action is taken. +.El +.Pp +Because this program is only used internally by +.Xr httpd 8 , +there are no other ways to directly invoke +.Nm . +.Sh SEE ALSO +.Xr httpd 8 |