sendfile: Added support for partial content a la HTTP 206.
[ashd.git] / doc / sendfile.doc
CommitLineData
3d0adcf9
FT
1sendfile(1)
2===========
3
4NAME
5----
6sendfile - Static file handler for ashd(7)
7
8SYNOPSIS
9--------
10*sendfile* [*-c* 'CONTENT-TYPE'] 'METHOD' 'URL' 'REST'
11
12DESCRIPTION
13-----------
14
15*sendfile* serves static files by sending them exactly as they are to
16clients. It needs to be called with the `X-Ash-File` header added to
17the request, as *dirplex*(1) does.
18
19*sendfile* is a transient handler, as defined in *ashd*(7), and the
20'METHOD', 'URL' and 'REST' arguments will normally be added by the
21parent handler.
22
23If a MIME-type is not explicitly specified, *sendfile* uses
24*libmagic*(3) to determine the MIME-type automatically. If *sendfile*
25is compiled with support for filesystem attributes (see *attr*(5) if
26your system has support for such attributes), the attributes
27`user.ash-mime-type`, `user.mime-type`, `user.mime_type` or
28`user.Content-Type` will be checked, in that order, and if one is
29present on the file in question, its value will be used instead of
30using *libmagic*.
31
cbc5f085
FT
32*sendfile* supports the following HTTP features:
33
34 * Caching, using the `Last-Modified` and related headers.
35
36 * Partial content, using the `Range` and related headers.
3d0adcf9
FT
37
38OPTIONS
39-------
40
41*-c* 'CONTENT-TYPE'::
42
43 Sends 'CONTENT-TYPE' as the file's MIME-type instead of trying
44 to auto-detect the file type.
45
46AUTHOR
47------
48Fredrik Tolf <fredrik@dolda2000.com>
49
50SEE ALSO
51--------
52*dirplex*(1), *ashd*(7)