When you need a web server in a hurry. http://unix4lyfe.org/darkhttpd/
Go to file
Emil Mikulic 97b7be4f79 Fix include path. 2013-04-28 20:55:57 +10:00
devel Fix include path. 2013-04-28 20:55:57 +10:00
AUTHORS Move trunk/ into base dir, move tests into devel/. 2013-04-28 20:44:06 +10:00
Makefile Tidy up Makefile. 2011-01-15 14:37:56 +11:00
README Move trunk/ into base dir, move tests into devel/. 2013-04-28 20:44:06 +10:00
REL-ENG Need some release engineering reminders after I failed to update the pkgname 2013-04-28 19:56:50 +10:00
TODO Stuff to do when I find the time. 2013-04-28 19:56:51 +10:00
darkhttpd.c Print more quotes. 2013-04-28 20:55:57 +10:00
debug-build.sh Rename warnflags to debug-build and add debugging and torture defines. 2013-04-28 19:56:50 +10:00
run-tests.sh Turn up the debugging and warnflags. 2013-04-28 19:56:50 +10:00
torture.py Request a bigger file -> more testing. 2013-04-28 19:56:50 +10:00

README

How to build darkhttpd
----------------------

Simply run make:
	$ make



How to run darkhttpd
--------------------

Serve /var/www/htdocs on the default port (port 80):
	$ ./darkhttpd /var/www/htdocs

Serve ~/public_html on port 8081:
	$ ./darkhttpd ~/public_html --port 8081

Only bind to one IP address (useful on multi-homed systems):
	$ ./darkhttpd ~/public_html --addr 192.168.0.1

Serve at most 4 simultaneous connections:
	$ ./darkhttpd ~/public_html --maxconn 4

Log accesses to a file:
	$ ./darkhttpd ~/public_html --log access.log

Chroot for extra security (you need root privs for chroot):
	$ ./darkhttpd /var/www/htdocs --chroot

Use default.htm instead of index.html:
	$ ./darkhttpd /var/www/htdocs --index default.htm

Add mimetypes - in this case, serve .dat files as text/plain:
	$ cat extramime
	text/plain	dat
	$ ./darkhttpd /var/www/htdocs --mimetypes extramime

Drop privileges:
	$ ./darkhttpd /var/www/htdocs --uid www --gid www

Use acceptfilter (FreeBSD only):
	$ kldload accf_http
	$ ./darkhttpd /var/www/htdocs --accf

Run in the background and create a pidfile:
	$ ./darkhttpd /var/www/htdocs --pidfile /var/run/httpd.pid --daemon

Commandline options can be combined:
	$ ./darkhttpd ~/public_html --port 8080 --addr 127.0.0.1

To see a full list of commandline options,
run darkhttpd without any arguments:
	$ ./darkhttpd