man/man8/httpd.8

   1 .TH HTTPD 8
   2 .SH NAME
   3 httpd, in.httpd, dir2html \- a web server for Minix 2 and Minix 3
   4 .SH SYNOPSIS
   5 .B httpd
   6 .RB [\-t|\-v]
   7 .RI [ config_file ]
   8 .P
   9 .B "tcpd http /usr/local/bin/in.httpd &"
  10 .P
  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 (8),
  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 enable
  32 .B in.httpd
  33 to start you use (in a startup script):
  34 .P
  35 .B  "tcpd http /usr/local/bin/in.httpd &"
  36 .P
  37 or
  38 .P
  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 To enable or reenable
  46 .B in.httpd
  47 from the command line a user a system administrator should use
  48 .B intr (8),
  49 like this:
  50 .P
  51 .B "intr -d tcpd http /usr/local/bin/in.httpd &"
  52 .P
  53 to start
  54 .B tcpd
  55 as a daemon (getting input from /dev/null, writing output to /dev/log,
  56 and not part of a process group).
  57 .P
  58 .B Dir2html
  59 is an accessory program that produces a directory listing formatted as
  60 web page for the current directory or for a directory specified as an
  61 argument. It is called by
  62 .B httpd
  63 when a web client references a directory that includes no index.html
  64 file (or whatever alternative to index.html that may be defined in
  65 /etc/httpd.conf). Since it writes to standard output it may also be called
  66 as a standalone program.
  67 .P
  68 Options for
  69 .B httpd
  70 are:
  71 .SH OPTIONS
  72 .TP
  73 .B \-t
  74 This tells the server to parse the configuration file so that you can
  75 see if it is the way you want it.  You may also pass the name of your
  76 configuration file if it is not the default /etc/httpd.conf.
  77 .TP
  78 .B \-v
  79 Shows the server version, then exits.
  80 .TP
  81 .B config_file
  82 normally /etc/httpd.conf
  83 .SH FILES
  84 .TP 25n
  85 .B /etc/httpd.conf
  86 The configuration file.
  87 .P
  88 .B /etc/httpd.mtype
  89 Extension to configuration file defining MIME types.
  90 .P
  91 .B /usr/adm/httpd.log
  92 Log file. The file must exist for logging to begin.
  93 .SH "SEE ALSO"
  94 .BR httpd.conf (5),
  95 .BR http_status (5),
  96 .BR serv.access (5),
  97 .BR intr (8),
  98 .BR tcpd (8).
  99 .SH NOTES
 100 This server has been tested on both Minix 2 and Minix 3.
 101 .P
 102 Running a server exposed to the Internet is risky to the host system and
 103 to the local network. Consult with the owner of your net before you go
 104 public. Read the
 105 .B SECURITY
 106 document in the source directory.
 107 .P
 108 The
 109 .B tcpd (8)
 110 man page needs to be written. The important thing to know is that if
 111 the access control file
 112 .B /etc/serv.access
 113 exists tcpd will exec its paranoid twin, tcpdp, which will deny access from
 114 any IP for which a name cannot be found.
 115 .SH BUGS
 116 None are known, but there are surely some unknown ones. Be careful!
 117 .SH AUTHOR
 118 The Minix httpd server was created by and is maintained by Michael Temari
 119 <Michael@TemWare.Com>
 120 .P
 121 This man page was compiled by Al Woodhull <asw@woodhull.com>
 122 .P
 123 .\" updated 2006-06-17
 124