 @@ -1,14 +1,14 @@
-.\"	$NetBSD: bozohttpd.8,v 1.27 2011/04/02 07:44:15 mbalmer Exp $
+.\"	$NetBSD: bozohttpd.8,v 1.28 2011/04/24 07:17:02 jmmv Exp $
 .\"
 .\"	$eterna: bozohttpd.8,v 1.99 2010/09/20 22:26:28 mrg Exp $
 .\"
 .\" Copyright (c) 1997-2010 Matthew R. Green
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 @@ -16,27 +16,27 @@
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
 .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd April 2, 2011
+.Dd April 23, 2011
 .Dt HTTPD 8
 .Os
 .Sh NAME
 .Nm httpd
 .Nd hyper text transfer protocol version 1.1 daemon
 .Sh SYNOPSIS
 .Nm
 .Op Fl befHnrsuVX
 .Op Fl C Ar suffix cgihandler
 .Op Fl c Ar cgibin
 .Op Fl I Ar port
 .Op Fl i Ar address
 .Op Fl M Ar suffix type encoding encoding11
 @@ -69,226 +69,226 @@ option for virtual hosting.)
 .Nm
 writes logs to
 .Xr syslog 3
 using the ftp facility (but see the
 .Fl s
 option for testing.)
 .Nm
 is designed to be small, simple and relatively featureless,
 hopefully increasing its security.
 .Ss OPTIONS
 The following options are available:
 .Bl -tag -width xxxcgibin
 .It Fl b
-This option enables daemon mode, where
+Enables daemon mode, where
 .Nm
 detaches from the current terminal, running in the background and
 servicing HTTP requests.
 .It Fl C Ar suffix cgihandler
-This option adds a new CGI handler program for a particular file type.
+Adds a new CGI handler program for a particular file type.
 The
 .Ar suffix
 should be any normal file suffix, and the
 .Ar cgihandler
 should be a full path to an interpreter.
 This option is the only way to enable CGI programs that exist
 outside of the cgibin directory to be executed.
 Multiple
 .Fl C
 options may be passed.
 .It Fl c Ar cgibin
-This option enables the CGI/1.1 interface.
+Enables the CGI/1.1 interface.
 The
 .Ar cgibin
 directory is expected to contain the CGI programs to be used.
 .Nm
 looks for URL's in the form of
 .Em /cgi-bin/\*[Lt]scriptname\*[Gt]
 where
 .Aq scriptname
 is a valid CGI program in the
 .Ar cgibin
 directory.
 In other words, all CGI URL's must begin with
 .Em \%/cgi-bin/ .
 Note that the CGI/1.1 interface is not available with
 .Em ~user
 translation.
 .It Fl e
-This option causes
+Causes
 .Nm
 to not clear the environment when used with either the
 .Fl t
 or
 .Fl U
 options.
 .It Fl f
-This option stops the
+Stops the
 .Fl b
 flag from
 .Nm
 detaching from the tty and going into the background.
 .It Fl H
-This option causes directory index mode to hide files and directories
+Causes directory index mode to hide files and directories
 that start with a period, except for
 .Pa .. .
 Also see
 .Fl X .
 .It Fl I Ar port
-This option is only valid with the
+Causes
 .Fl b
 option.
 It causes
 .Ar port
 to use used as the port to bind daemon mode.
 The default is the
 .Dq http
 port.
 .It Fl i Ar address
 This option is only valid with the
 .Fl b
 option.
-It causes
+.It Fl i Ar address
 Causes
 .Ar address
 to use used as the address to bind daemon mode.
 If otherwise unspecified, the address used to bind is derived from the
 .Ar myname ,
 which defaults to the name returned by
 .Xr gethostname 3 .
 Only the last
 .Fl i
 option is used.
 This option is only valid with the
 .Fl b
 option.
 .It Fl M Ar suffix type encoding encoding11
-This option adds a new entry to the table that converts file suffixes to
+Adds a new entry to the table that converts file suffixes to
 content type and encoding.
 This option takes four additional arguments containing
 the file prefix, its
 .Dq Content-Type ,
 .Dq Content-Encoding ,
 and
 .Dq Content-Encoding
 for HTTP/1.1 connections, respectively.
 If any of these are a single dash
 .Pq Dq - ,
 the empty string is used instead.
 Multiple
 .Fl M
 options may be passed.
 .It Fl n
-This option stops
+Stops
 .Nm
 from doing IP address to name resolution of hosts for setting the
 .Ev REMOTE_HOST
 variable before running a CGI program.
 This option has no effect without the
 .Fl c
 option.
 .It Fl P Ar pidfile
-This option causes
+Causes
 .Nm
 to create a pid file in
 .Ar pidfile
 when run in daemon mode with the
 .Fl b
 option.
 .It Fl p Ar pubdir
-This option changes the default user directory for
+Changes the default user directory for
 .Em /~user/
 translations from
 .Dq public_html
 to
 .Ar pubdir .
 .It Fl r
-This option forces pages besides the
+Forces pages besides the
 .Dq index.html
 (see the
 .Fl X
 option) page to require that the Referrer: header be present and
 refer to this web server, otherwise a redirect to the
 .Dq index.html
 page will be returned instead.
 .It Fl S Ar server_software
-This option sets the internal server version to
+Sets the internal server version to
 .Ar server_software .
 .It Fl s
-This option forces logging to be set to stderr always.
+Forces logging to be set to stderr always.
 .It Fl t Ar chrootdir
-When this option is used,
+Makes
 .Nm
-will chroot to the specified directory
+chroot to the specified directory
 before answering requests.
 Every other path should be specified relative
 to the new root, if this option is used.
 Note that the current environment
 is normally replaced with an empty environment with this option, unless the
 .Fl e
 option is also used.
 .It Fl U Ar username
-This option causes
+Causes
 .Nm
 to switch to the user and the groups of
 .Ar username
 after initialization.
 This option, like
 .Fl t
 above, causes
 .Nm
 to clear the environment unless the
 .Fl e
 option is given.
 .It Fl u
-This option enables the transformation of Uniform Resource Locators of
+Enables the transformation of Uniform Resource Locators of
 the form
 .Em /~user/
 into the directory
 .Pa ~user/public_html
 (but see the
 .Fl p
 option above).
 .It Fl V
-This option sets the default virtual host directory to
+Sets the default virtual host directory to
 .Ar slashdir .
 If no directory exists in
 .Ar virtualroot
 for the request, then
 .Ar slashdir
 will be used.
 The default behaviour is to return 404 (Not Found.)
 .It Fl v Ar virtualroot
-This option enables virtual hosting support.
+Enables virtual hosting support.
 Directories in
 .Ar virtualroot
 will be searched for a matching virtual host name, when parsing
 the HTML request.
 If a matching name is found, it will be used
 as both the server's real name,
 .Op Ar myname ,
 and as the
 .Ar slashdir .
 See the
 .Sx EXAMPLES
 section for an example of using this option.
 .It Fl X
-This option enables directory indexing.
+Enables directory indexing.
 A directory index will be generated only when the default file (i.e.
 .Pa index.html
 normally) is not present.
 .It Fl x Ar index
-This option changes the default file read for directories from
+Changes the default file read for directories from
 .Dq index.html
 to
 .Ar index .
 .It Fl Z Ar certificate_path privatekey_path
-This option sets the path to the server certificate file and the private key file
+Sets the path to the server certificate file and the private key file
 in pem format.
 It also causes
 .Nm
 to start SSL mode.
 .El
 .Pp
 Note that in
 .Nm
 versions 20031005 and prior that supported the
 .Fl C
 and
 .Fl M
 options, they took a single space-separated argument that was parsed.