| 1 | .TH HTTPD 8
|
|---|
| 2 | .SH NAME
|
|---|
| 3 | httpd, in.httpd, dir2html \- a web server for Minix
|
|---|
| 4 | .SH SYNOPSIS
|
|---|
| 5 | .B httpd
|
|---|
| 6 | .RB [\-t|\-v]
|
|---|
| 7 | .RI [ config_file ]
|
|---|
| 8 | .br
|
|---|
| 9 | .B "tcpd http /usr/local/bin/in.httpd"
|
|---|
| 10 | .br
|
|---|
| 11 | .B dir2html
|
|---|
| 12 | .RB [directory]
|
|---|
| 13 | .SH DESCRIPTION
|
|---|
| 14 | .B httpd
|
|---|
| 15 | is a World Wide Web (WWW) server written by Michael Temari. It was
|
|---|
| 16 | written from scratch so the setup and configuration will not be like
|
|---|
| 17 | other web servers.
|
|---|
| 18 | .P
|
|---|
| 19 | .B in.httpd
|
|---|
| 20 | is linked to
|
|---|
| 21 | .B httpd.
|
|---|
| 22 | This alternate name is used to indicate the program is a server that is
|
|---|
| 23 | started by
|
|---|
| 24 | .B tcpd,
|
|---|
| 25 | a program which listens for incoming TCP connections on the passed
|
|---|
| 26 | port (defined in
|
|---|
| 27 | .BI /etc/services ).
|
|---|
| 28 | When a connection comes in
|
|---|
| 29 | .B tcpd
|
|---|
| 30 | forks and starts the given daemon program, after possibly checking for access
|
|---|
| 31 | restrictions and logging the connection. Therefore to start
|
|---|
| 32 | .B httpd
|
|---|
| 33 | you use:
|
|---|
| 34 | .br
|
|---|
| 35 | .B "tcpd http /usr/local/bin/in.httpd &"
|
|---|
| 36 | .br
|
|---|
| 37 | or
|
|---|
| 38 | .br
|
|---|
| 39 | .B "daemonize tcpd http /usr/local/bin/in.httpd"
|
|---|
| 40 | .P
|
|---|
| 41 | .B (daemonize
|
|---|
| 42 | is a shell function defined in
|
|---|
| 43 | .BI/usr/etc/rc
|
|---|
| 44 | in Minix 2.0.3 and later releases which starts programs as daemons).
|
|---|
| 45 | .P
|
|---|
| 46 | .B dir2html
|
|---|
| 47 | is an accessory program that produces a directory listing formatted as
|
|---|
| 48 | web page for the current directory or for a directory specified as an
|
|---|
| 49 | argument. It is called by
|
|---|
| 50 | .B httpd
|
|---|
| 51 | when a web client references a directory that includes no index.html
|
|---|
| 52 | file (or whatever alternative to index.html that may be defined in
|
|---|
| 53 | /etc/httpd.conf). Since it writes to standard output it may also be called
|
|---|
| 54 | as a standalone program.
|
|---|
| 55 | .P
|
|---|
| 56 | Options for
|
|---|
| 57 | .B httpd
|
|---|
| 58 | are:
|
|---|
| 59 | .SH OPTIONS
|
|---|
| 60 | .TP
|
|---|
| 61 | .B \-t
|
|---|
| 62 | This tells the server to parse the configuration file so that you can
|
|---|
| 63 | see if it is the way you want it. You may also pass the name of your
|
|---|
| 64 | configuration file if it is not the default /etc/httpd.conf.
|
|---|
| 65 | .TP
|
|---|
| 66 | .B \-v
|
|---|
| 67 | Shows the server version, then exits.
|
|---|
| 68 | .br
|
|---|
| 69 | .IR config_file
|
|---|
| 70 | normally /etc/httpd.conf
|
|---|
| 71 | .SH FILES
|
|---|
| 72 | .TP 25n
|
|---|
| 73 | .B /etc/httpd.conf
|
|---|
| 74 | The configuration file.
|
|---|
| 75 | .P
|
|---|
| 76 | .B /etc/httpd.mtype
|
|---|
| 77 | Extension to configuration file defining MIME types.
|
|---|
| 78 | .P
|
|---|
| 79 | .B /usr/adm/httpd.log
|
|---|
| 80 | Log file. The file must exist for logging to begin.
|
|---|
| 81 | .SH "SEE ALSO"
|
|---|
| 82 | .BR httpd.conf (5)
|
|---|
| 83 | .br
|
|---|
| 84 | .BR http_status (5)
|
|---|
| 85 | .br
|
|---|
| 86 | .BR serv.access (5)
|
|---|
| 87 | .br
|
|---|
| 88 | .BR tcpd (8)
|
|---|
| 89 | .SH NOTES
|
|---|
| 90 | Running a server exposed to the Internet is risky to the host system and
|
|---|
| 91 | to the local network. Consult with the owner of your net before you go
|
|---|
| 92 | public. Read the
|
|---|
| 93 | .B SECURITY
|
|---|
| 94 | document in the source directory.
|
|---|
| 95 | .SH BUGS
|
|---|
| 96 | None are known, but there are surely some unknown ones. Be careful!
|
|---|
| 97 | .SH AUTHOR
|
|---|
| 98 | The Minix httpd server was created by and is maintained by Michael Temari
|
|---|
| 99 | <Michael@TemWare.Com>
|
|---|
| 100 | .br
|
|---|
| 101 | This man page was compiled by Al Woodhull <awoodhull@hampshire.edu>
|
|---|
| 102 | .P
|
|---|
| 103 | updated 2003-07-06
|
|---|
| 104 |
|
|---|
