fhttpd configuration file (fhttpd.conf)

AccessRights filemask restrict

AccessRights filemask allow

AccessRights filemask realm :all:

AccessRights filemask realm user

Defines application module, implemented as a process.

pathmask is only used to check for trailing slash matching (if pathmask just contains trailing slash, only URLs with trailing slash or mentioning index files will match, and vice versa) while remapping is done by mappedpathmask. "-" as the pathmask disables distinguishing between requests with and without trailing slash.

If executable is omitted, application is assumed to be remote, connected by TCP socket, and username is used for authentication (with the username and the password of that user). Executable can connect from anywhere, if the authentication succeeds, and different instances of the same program may be connected from different hosts (for example, to distribute the load), but the total number of connected instances can't exceed maxinstances.

If executable is mentioned, it is executed on startup as username, and server uses pipes or AF_UNIX sockets to its stdin and stdout for communication. Additional copies of executable will be started if the requests number will require that, but the maxinstances number limits the possible number of them.

If comma and maxinstances_per_uid is specified, module will run under user's userid, if ~username mapping is used. maxinstances_per_uid will limit the number of instances running under the same userid.

maxqueue is the number of requests in the queue (sent to the application, but not answered). Value 1 implies synchronous-only operations.

-p option specifies communication through pipes, and -s option specifies communication through AF_UNIX sockets. All arguments starting from -s or -p are passed as the command line to the process. The number of arguments can't exceed 12.

If "AuthApplication" version of keyword is used, REMOTE_PW field with user's password is passed to the application along with REMOTE_USER, so application can perform authentication for itself. Only trusted applications should use that mode because HTTP clients send password even if it is entered before for something else at the same host, so applications can see passwords, intended for other files or applications.

fhttpd file I/O and CGI support module is implemented as fhttpd-file application module since version 0.3.0, so all servers should have it mentioned if they support files and/or CGI access (see example).

Defines default footer for directories without .footer.html file. It can contain any valid HTML markup with "_" in the place of spaces and "\_" in the place of "_". "$D" will be replaced by directory name, "$H" - by host name, "$$" - by "$" sign.

See Special files and URLs for directory listings for details.

Defines default header for directories without .header.html file. It can contain any valid HTML markup with "_" in the place of spaces and "\_" in the place of "_". "$D" will be replaced by directory name, "$H" - by host name, "$$" - by "$" sign.

See Special files and URLs for directory listings for details.

[Abs]GetRule UNCONDITIONAL parameter [parameter-value]

[Abs]GetRule field operator value name-operator name-value parameter [parameter-value]

Defines name remapping, unconditional or based on some fields in HTTP requests. field is the request field (case-insensitive), operator can be EQ (equal), NE (not equal), EQCI (equal, case insensitive) or NECI (not equal, case insensitive), value is a wildcard expression. name-operator can be NAMEEQ (name equal), NAMENE (name not equal), NAMEEQCI (name equal, case insensitive) or NAMENECI (name not equal, case insensitive). name-value (wildcard) defines the set of names in request, in which parameter (BASEDIR, CWD or NAME) will be replaced by parameter-value. If parameter-value is omitted, original value of parameter is restored. All statements are processed in their order in configuration file, using original fields and names. Names are taken how they will appear in request, not how they will look on real filesystem, unless "AbsGetRule" version of keyword is used.

In versions since 0.2.2 redirection between files and scripts is supported without restrictions.