Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ (8) — Plan9 3rd Edition (Vita Nuova)

Media Vault

Software Library

Restoration Projects

Artifacts Sought

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). 

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 kilobytes. 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 using the URI /magic/. 

FILES

­/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 suffixes and their content type.

SOURCE

­/appl/svc/httpd

Plan 9  —  June 29, 2000

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026