httpd(8)
NAME
httpd, in.httpd, dir2html - a web server for Minix 2 and Minix 3
SYNOPSIS
httpd [-t|-v] [config_file]
tcpd http /usr/local/bin/in.httpd &
dir2html [directory]
DESCRIPTION
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.
In.httpd is linked to httpd. This alternate name is used to indicate the
program is a server that is started by tcpd (8), a program which listens
for incoming TCP connections on the passed port (defined in
/etc/services). When a connection comes in tcpd forks and starts the
given daemon program, after possibly checking for access restrictions and
logging the connection. Therefore, to enable in.httpd to start you use
(in a startup script):
tcpd http /usr/local/bin/in.httpd &
or
daemonize tcpd http /usr/local/bin/in.httpd
(daemonize is a shell function defined in /usr/etc/rc in Minix 2.0.3 and
later releases which starts programs as daemons). To enable or reenable
in.httpd from the command line a user a system administrator should use
intr (8), like this:
intr -d tcpd http /usr/local/bin/in.httpd &
to start tcpd as a daemon (getting input from /dev/null, writing output
to /dev/log, and not part of a process group).
Dir2html is an accessory program that produces a directory listing
formatted as a web page for the current directory or for a directory
specified as an argument. It is called by httpd when a web client
references a directory that includes no index.html file (or an
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.
Options for httpd are:
OPTIONS
-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.
-v Shows the server version, then exits.
config_file
normally /etc/httpd.conf
FILES
/etc/httpd.conf The configuration file.
/etc/httpd.mtype Extension to configuration file defining MIME types.
/usr/adm/httpd.log Log file. The file must exist for logging to begin.
SEE ALSO
httpd.conf(5), http_status(5), serv.access(5), intr(8), tcpd(8).
NOTES
This server has been tested on both Minix 2 and Minix 3.
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 SECURITY document in the source directory (probably
/usr/local/src/httpdxxxx).
The tcpd (8) man page needs to be written. The important thing to know is
that if the access control file /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.
BUGS
None are known, but there are surely some unknown ones. Be careful!
AUTHOR
The Minix httpd server was created by and is maintained by Michael Temari
<Michael@TemWare.Com>
This man page was compiled by Al Woodhull <asw@woodhull.com>
VERSION NOTE
This man page is applicable to Minix 2 and Minix 3 releases through Minix
3.1.2a. This page was not part of the standard set of man pages for Minix
releases through Minix 3.1.2a.