summaryrefslogtreecommitdiff
path: root/usr.sbin
diff options
context:
space:
mode:
Diffstat (limited to 'usr.sbin')
-rw-r--r--usr.sbin/httpd/src/support/logresolve.872
-rw-r--r--usr.sbin/httpd/src/support/rotatelogs.885
-rw-r--r--usr.sbin/httpd/src/support/suexec.865
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