HTTPD(8)                                                 HTTPD(8)

     NAME
          httpd, echo, stats - HTTP server

     SYNOPSIS
          svc/httpd/httpd [ -ccachesize ] [ -D ] [ -pport ]

          svc/httpd/echo meth vers uri search

          svc/httpd/stats meth vers uri search

     DESCRIPTION
          Httpd is a simple HTTP daemon, serving version 1.0 of the
          HTTP protocol.  It listens for incoming calls on a given
          TCP/IP port (default: 80).  It serves content rooted at
          `/services/httpd/root' in its name space.

          The httpd program supports only the `GET' and `HEAD' methods
          of the HTTP protocol. The `Content-type' (default
          `application/octet-stream') and `Content-encoding' (default
          `binary') of a file are determined by looking for suffixes
          of the file name in /services/http/http.suff.

          If the requested URI begins with /magic/, httpd loads the
          module associated with the remaining part of the URI.  Take
          care to configure the name space sensibly.  Simple servers
          echo and stats are provided (see below).

          Httpd has the following options:

          -ccachesize
               Set the size of the daemon's cache to cachesize kilo-
               bytes. The default is a five megabyte cache.

          -D   Debugging information is written to the file
               /services/httpd/httpd.debug.

          -pport
               Listen for requests on the given port.

          Echo is a trivial server that just returns the method, URI,
          any search, and the headers sent by the client.

          Stats is an equally simple server that queries the cache and
          returns information to the user about pages stored in the
          cache.

          More complex services can be written to httpd's private
          interface.  The file httpd.m (in /appl/svc/httpd) defines
          constants and adts used by httpd. The file cgi.m defines the
          module `Cgi' which is the interface for programs called

     Page 1                       Plan 9            (printed 12/22/24)

     HTTPD(8)                                                 HTTPD(8)

          using the URI /magic/.

     FILES
          /services/httpd/root             Root of the served web con-
                                           tent.
          /services/httpd/httpd.debug      Logfile for debugging
                                           information.
          /services/httpd/httpd.log        httpd logfile.
          /services/httpd/httpd.rewrite    File to redirect specific
                                           URI requests.
          /services/httpd/httpd.suff       File of recognizable suf-
                                           fixes and their content
                                           type.

     SOURCE
          /appl/svc/httpd

     Page 2                       Plan 9            (printed 12/22/24)