sighttpd.conf
The sighttpd.conf file is the runtime configuration file for sighttpd. By default, the configuration file is looked for in /etc/sighttpd/sighttpd.conf You can override this with the -f commandline option to sighttpd:
$ sighttpd -f /path/to/configfile
Various example config files are distributed in the examples/ directory of the sighttpd source distribution.
Comments are marked with a '#' character, and continue to the end of line.
Configuration directives are single keywords followed by whitespace and a value (to the end of the line, or comment character). The directive name (ie. keyword) is case insensitive.
Configuration is grouped in blocks; the names of directives are scoped within a configuration block. Any configuration directives outside of a block are global to the entire configuration. Block names are case insensitive.
For example, the configuration file:
Listen 3000
<StaticText>
Path "/welcome.txt"
Text "Hello, world!"
</StaticText>
specifies one global directive ("Listen 3000"), and one block ("StaticText"). Within that block, the directives "Path" and "Text" appear.
Parameters outside of a <block> are global.
The StaticText module allows you to specify that a text string should appear at a given URL. This is useful for identifying server instances at your installation.
The Stdin module allows streaming of data from stdin.
Path /my/video.m4v
in a <stdin> block will make the content appear at http://example.com/my/video.ogv
Type video/mpeg4
will instruct sighttpd to serve this stream with Content-Type: video/mpeg4.
Raw Ogg data cannot be streamed from standard input using <Stdin>, as an Ogg stream needs to have setup headers prepended for each codec stream. For this purpose a special module called <OggStdin> is provided, which buffers these headers and serves them first to each client that connects before continuing with live Ogg pages.
Path /my/stream.ogg
in a <oggstdin> block will make the content appear at http://example.com/my/stream.ogg
Type audio/ogg
will instruct sighttpd to serve this stream with Content-Type: audio/ogg.
sighttpd includes direct support for integrated capture, video encoding and streaming on Renesas SH-Mobile processors. This module supports the following configuration directives:
Path /my/video.264
in an <SHRecord> block will make the content appear at http://example.com/my/video.264
Listen 3000
<Stdin>
Path "/date.txt"
Type "text/plain"
</Stdin>
Then, run:
$ while `true`; do date; sleep 1; done | sighttpd
Then connect from another terminal:
$ curl -i http://localhost:3000/date.txt
HTTP/1.1 200 OK
Date: Wed, 07 Apr 2010 04:23:09 GMT
Server: Sighttpd/0.9.0
Content-Type: text/plain
Wed Apr 7 13:23:09 JST 2010
Wed Apr 7 13:23:10 JST 2010
Wed Apr 7 13:23:11 JST 2010
...
Listen 3000
<Stdin>
Path "/stream.264"
Type "video/mp4"
</Stdin>
Then run your streaming video input, eg:
$ shcodecs-record k264-v4l2-stream.ctl | sighttpd
and connect with a video player:
$ mplayer http://localhost:3000/stream.264 -fps 30
Listen 3000
<Stdin>
Path "/mjpeg/"
Type "multipart/x-mixed-replace; boundary=++++++++"
</Stdin>
This configuration expects that a series of jpeg comes in from stdin. At each boundary the following headers must be inserted:
--++++++++
Content-Type: image/jpeg
Content-length: <size of jpeg file>
examples/mjpeg_test.sh is provided for testing purpose. Execute the following:
$ examples/mjpeg_test.sh file1 file2 file3 ...
Then open 'http://localhost:3000/mjpeg/' with a web browser that supports Motion JPEG, such as firefox(1).
Listen 3000
# Streaming Ogg Vorbis from stdin, using the special
# OggStdin module that caches Ogg Vorbis headers
<OggStdin>
Path "/stream.ogg"
Type "audio/ogg"
</OggStdin>
You can run this with a shell pipeline like:
$ arecord -c 2 -r 44100 -f S16_LE -t wav | oggenc -o - - | sighttpd -f examples/sighttpd-oggstdin.conf
And you can connect to it as an Ogg stream, eg:
$ ogg123 http://localhost:3000/stream.ogg
Listen 3000
<SHRecord>
Path "/video0/vga.264"
CtlFile "/usr/share/shcodecs-record/k264-v4l2-vga-stream.ctl"
</SHRecord>
<SHRecord>
Path "/video0/cif.264"
CtlFile "/usr/share/shcodecs-record/k264-v4l2-cif-stream.ctl"
</SHRecord>
will make two H.264 streams appear at:
http://ecovec:3000/video0/vga.264
http://ecovec:3000/video0/cif.264
/etc/sighttpd/sighttpd.conf or sighttpd.conf
sighttpd(1)
Please report bugs to the author, conrad@metadecks.org
This man page is current for version 1.0.0 of sighttpd.
sighttpd is distributed under the GNU General Public License. See the file COPYING for details.
A web site is available at http://www.kfish.org/software/sighttpd/
We would be delighted to hear from you if you like this program.
sighttpd was written by Conrad Parker.