125 lines
3.2 KiB
Groff
125 lines
3.2 KiB
Groff
.TH HTTPD 8
|
|
.SH NAME
|
|
httpd, in.httpd, dir2html \- a web server for Minix 2 and Minix 3
|
|
.SH SYNOPSIS
|
|
.B httpd
|
|
.RB [\-t|\-v]
|
|
.RI [ config_file ]
|
|
.P
|
|
.B "tcpd http /usr/local/bin/in.httpd &"
|
|
.P
|
|
.B dir2html
|
|
.RB [directory]
|
|
.SH DESCRIPTION
|
|
.B Httpd
|
|
is a World Wide Web (WWW) server written by Michael Temari. It was
|
|
written from scratch so the setup and configuration will not be like
|
|
other web servers.
|
|
.P
|
|
.B In.httpd
|
|
is linked to
|
|
.B httpd.
|
|
This alternate name is used to indicate the program is a server that is
|
|
started by
|
|
.B tcpd (8),
|
|
a program which listens for incoming TCP connections on the passed
|
|
port (defined in
|
|
.BI /etc/services ).
|
|
When a connection comes in
|
|
.B tcpd
|
|
forks and starts the given daemon program, after possibly checking for access
|
|
restrictions and logging the connection. Therefore, to enable
|
|
.B in.httpd
|
|
to start you use (in a startup script):
|
|
.P
|
|
.B "tcpd http /usr/local/bin/in.httpd &"
|
|
.P
|
|
or
|
|
.P
|
|
.B "daemonize tcpd http /usr/local/bin/in.httpd"
|
|
.P
|
|
.B (daemonize
|
|
is a shell function defined in
|
|
.BI /usr/etc/rc
|
|
in Minix 2.0.3 and later releases which starts programs as daemons).
|
|
To enable or reenable
|
|
.B in.httpd
|
|
from the command line a user a system administrator should use
|
|
.B intr (8),
|
|
like this:
|
|
.P
|
|
.B "intr -d tcpd http /usr/local/bin/in.httpd &"
|
|
.P
|
|
to start
|
|
.B tcpd
|
|
as a daemon (getting input from /dev/null, writing output to /dev/log,
|
|
and not part of a process group).
|
|
.P
|
|
.B Dir2html
|
|
is an accessory program that produces a directory listing formatted as
|
|
web page for the current directory or for a directory specified as an
|
|
argument. It is called by
|
|
.B httpd
|
|
when a web client references a directory that includes no index.html
|
|
file (or whatever alternative to index.html that may be defined in
|
|
/etc/httpd.conf). Since it writes to standard output it may also be called
|
|
as a standalone program.
|
|
.P
|
|
Options for
|
|
.B httpd
|
|
are:
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-t
|
|
This tells the server to parse the configuration file so that you can
|
|
see if it is the way you want it. You may also pass the name of your
|
|
configuration file if it is not the default /etc/httpd.conf.
|
|
.TP
|
|
.B \-v
|
|
Shows the server version, then exits.
|
|
.TP
|
|
.B config_file
|
|
normally /etc/httpd.conf
|
|
.SH FILES
|
|
.TP 25n
|
|
.B /etc/httpd.conf
|
|
The configuration file.
|
|
.P
|
|
.B /etc/httpd.mtype
|
|
Extension to configuration file defining MIME types.
|
|
.P
|
|
.B /usr/adm/httpd.log
|
|
Log file. The file must exist for logging to begin.
|
|
.SH "SEE ALSO"
|
|
.BR httpd.conf (5),
|
|
.BR http_status (5),
|
|
.BR serv.access (5),
|
|
.BR intr (8),
|
|
.BR tcpd (8).
|
|
.SH NOTES
|
|
This server has been tested on both Minix 2 and Minix 3.
|
|
.P
|
|
Running a server exposed to the Internet is risky to the host system and
|
|
to the local network. Consult with the owner of your net before you go
|
|
public. Read the
|
|
.B SECURITY
|
|
document in the source directory.
|
|
.P
|
|
The
|
|
.B tcpd (8)
|
|
man page needs to be written. The important thing to know is that if
|
|
the access control file
|
|
.B /etc/serv.access
|
|
exists tcpd will exec its paranoid twin, tcpdp, which will deny access from
|
|
any IP for which a name cannot be found.
|
|
.SH BUGS
|
|
None are known, but there are surely some unknown ones. Be careful!
|
|
.SH AUTHOR
|
|
The Minix httpd server was created by and is maintained by Michael Temari
|
|
<Michael@TemWare.Com>
|
|
.P
|
|
This man page was compiled by Al Woodhull <asw@woodhull.com>
|
|
.P
|
|
.\" updated 2006-06-17
|
|
|