NAME
rc–httpd – HTTP server

SYNOPSIS
rc–httpd/rc–httpd

DESCRIPTION
Rc–httpd serves the requested file or an index of files found under a website's root directory, or, in the case of CGI, executes a specified CGI program.

CONFIGURATION

As all pieces of rc–httpd are shell scripts, configuration is achieved by setting variables and adding, removing or modifying commands in various files.

rc–httpd

rc_httpd_dir must be set to the root of the rc–httpd installation, the directory containing the rc–httpd script.

path must include rc_httpd_dir/handlers ahead of the base system's path elements.

cgi_path is substituted for path when cgi scripts are run. (Be sure to set path back in rc–based cgi scripts.)

extra_headers is an optional list of strings to emit when sending http headers.

SERVER_PORT is the port HTTP is to be served on.

select–handler

PATH_INFO is the location relative to the website's root directory of the file to be displayed. Typically, the location from the incoming request is honored.

FS_ROOT sets the root directory of the website.

NOINDEXFILE instructs the dir–index module not to look for index.html files, otherwise if an index.html file is found dir–index will exec serve–static to serve the file. At present there is no module to serve an index file but not a directory.

If you do not want directory indexing at all, replace static–or–index with serve–static, which will report 503 forbidden for directories.

Multiple virtual hosts may be configured by creating conditional statements that act upon the SERVER_NAME variable. Fine–grained control of specific request strings may be configured via a similar method acting upon the location and/or other variables.

EXAMPLES
The following examples demonstrate possible ways to configure select–handler.

Serve static files:
if(~ $SERVER_NAME 9front.org){
PATH_INFO=$location
FS_ROOT=/usr/sl/www/$SERVER_NAME
exec static–or–index
}

CGI:
if(~ $SERVER_NAME *cat–v.org){
PATH_INFO=$location
FS_ROOT=/usr/sl/www/werc/sites/$SERVER_NAME
exec static–or–cgi /usr/sl/www/werc/bin/werc.rc
}

Custom error message for a denied URL:
fn do_error{
do_log $1
echo 'HTTP/1.1 '^$1^$cr
emit_extra_headers
echo 'Content–type: text/html'^$cr
echo $cr
echo '<html>
<
head>
<title>'^$1^'</title>
</head>
<body>
<h1>'^$1^'</h1>'
echo $2
echo '<p><i>rc–httpd at' $SERVER_NAME '</i>'
echo '
</body>
</html>
'
}
if(~ $location /v8.tar.bz2){
do_error '27b/6'
exit
}

STARTUP
Rc–httpd is run from a file in the directory scanned by listen(8), or called as an argument to aux/listen1. The program's standard error may be captured to a log file:
exec /rc/bin/rc–httpd/rc–httpd >>[2]/sys/log/www

FILES
/rc/bin/rc–httpd/rc–httpd
/rc/bin/rc–httpd/select–handler
/rc/bin/rc–httpd/handlers/cgi
/rc/bin/rc–httpd/handlers/dir–index
/rc/bin/rc–httpd/handlers/error
/rc/bin/rc–httpd/handlers/redirect
/rc/bin/rc–httpd/handlers/serve–static
/rc/bin/rc–httpd/handlers/static–or–cgi
/rc/bin/rc–httpd/handlers/static–or–index
/rc/bin/service/tcp80
/sys/log/www

SOURCE
/rc/bin/rc–httpd

SEE ALSO
rc(1), listen(8)

HISTORY
Rc–httpd first appeared in 9front (February, 2013).