commands/httpd/httpd.8

   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