Retab README. No content changes.

This commit is contained in:
Emil Mikulic 2014-03-14 22:43:46 +11:00
parent 01ec165a51
commit 583ff7ce10

38
README
View File

@ -2,7 +2,7 @@ How to build darkhttpd
---------------------- ----------------------
Simply run make: Simply run make:
$ make $ make
@ -10,54 +10,54 @@ How to run darkhttpd
-------------------- --------------------
Serve /var/www/htdocs on the default port (80 if running as root, else 8080): Serve /var/www/htdocs on the default port (80 if running as root, else 8080):
$ ./darkhttpd /var/www/htdocs $ ./darkhttpd /var/www/htdocs
Serve ~/public_html on port 8081: Serve ~/public_html on port 8081:
$ ./darkhttpd ~/public_html --port 8081 $ ./darkhttpd ~/public_html --port 8081
Only bind to one IP address (useful on multi-homed systems): Only bind to one IP address (useful on multi-homed systems):
$ ./darkhttpd ~/public_html --addr 192.168.0.1 $ ./darkhttpd ~/public_html --addr 192.168.0.1
Serve at most 4 simultaneous connections: Serve at most 4 simultaneous connections:
$ ./darkhttpd ~/public_html --maxconn 4 $ ./darkhttpd ~/public_html --maxconn 4
Log accesses to a file: Log accesses to a file:
$ ./darkhttpd ~/public_html --log access.log $ ./darkhttpd ~/public_html --log access.log
Chroot for extra security (you need root privs for chroot): Chroot for extra security (you need root privs for chroot):
$ ./darkhttpd /var/www/htdocs --chroot $ ./darkhttpd /var/www/htdocs --chroot
Use default.htm instead of index.html: Use default.htm instead of index.html:
$ ./darkhttpd /var/www/htdocs --index default.htm $ ./darkhttpd /var/www/htdocs --index default.htm
Add mimetypes - in this case, serve .dat files as text/plain: Add mimetypes - in this case, serve .dat files as text/plain:
$ cat extramime $ cat extramime
text/plain dat text/plain dat
$ ./darkhttpd /var/www/htdocs --mimetypes extramime $ ./darkhttpd /var/www/htdocs --mimetypes extramime
Drop privileges: Drop privileges:
$ ./darkhttpd /var/www/htdocs --uid www --gid www $ ./darkhttpd /var/www/htdocs --uid www --gid www
Use acceptfilter (FreeBSD only): Use acceptfilter (FreeBSD only):
$ kldload accf_http $ kldload accf_http
$ ./darkhttpd /var/www/htdocs --accf $ ./darkhttpd /var/www/htdocs --accf
Run in the background and create a pidfile: Run in the background and create a pidfile:
$ ./darkhttpd /var/www/htdocs --pidfile /var/run/httpd.pid --daemon $ ./darkhttpd /var/www/htdocs --pidfile /var/run/httpd.pid --daemon
Web forward (301) requests for some hosts: Web forward (301) requests for some hosts:
$ ./darkhttpd /var/www/htdocs --forward example.com http://www.example.com \ $ ./darkhttpd /var/www/htdocs --forward example.com http://www.example.com \
--forward secure.example.com https://www.example.com/secure --forward secure.example.com https://www.example.com/secure
Web forward (301) requests for all hosts: Web forward (301) requests for all hosts:
$ ./darkhttpd /var/www/htdocs --forward example.com http://www.example.com \ $ ./darkhttpd /var/www/htdocs --forward example.com http://www.example.com \
--forward-all http://catchall.example.com --forward-all http://catchall.example.com
Commandline options can be combined: Commandline options can be combined:
$ ./darkhttpd ~/public_html --port 8080 --addr 127.0.0.1 $ ./darkhttpd ~/public_html --port 8080 --addr 127.0.0.1
To see a full list of commandline options, To see a full list of commandline options,
run darkhttpd without any arguments: run darkhttpd without any arguments:
$ ./darkhttpd $ ./darkhttpd
vim:set ts=2 sw=2 et tw=80: vim:set ts=2 sw=2 et tw=80: