tipidee
Software
skarnet.org
The tipideed program
tipideed is the binary that actually does what you want from
a web server package: it serves files over HTTP.
Interface
tipideed [ -v verbosity ] [ -f cdbfile ] [ -d basedir ] [ -R ] [ -U ]
- tipideed reads a stream of HTTP (1.0 or 1.1) requests on its stdin, and tries
to fulfill them, sending answers to stdout, and logs to stderr.
- tipideed only speaks plaintext HTTP. It supports HTTPS, but the TLS layer
must be handled upstream by a program such as
s6-tlsd.
- tipideed stays alive until the client closes the connection or (in
HTTP 1.1) sends a request with a Connection: close header, or an error
occurs that makes it nonsensical to keep the connection open.
- By default, the documents it serves must be in subdirectories of its
current working directory, one subdirectory for every domain it hosts.
TODO: write this page.
Exit codes
- 0
- clean exit. The client closed the connection after a stream of
HTTP exchanges.
- 100
- bad usage. tipideed has been run in an incorrect way: bad command
line options, or missing environment variables, etc.
- 101
- cannot happen. This signals a bug in tipideed, and comes with an
error message asking you to report the bug. Please do so.
- 111
- system call failed. If this happens while serving a request,
tipideed likely has sent a 500 (Internal Server Error) response to the
client before exiting.
Environment variables
Options
Detailed operation
Notes
- tipideed is pronounced tipi-deed. You can also say
tipi-dee-dee, but only if you're the type of person who says
PC computer, NIC card or ATM machine.