diff --git a/README b/README index 6b9df13..b9b121b 100644 --- a/README +++ b/README @@ -2,7 +2,7 @@ How to build darkhttpd ---------------------- 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): - $ ./darkhttpd /var/www/htdocs + $ ./darkhttpd /var/www/htdocs 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): - $ ./darkhttpd ~/public_html --addr 192.168.0.1 + $ ./darkhttpd ~/public_html --addr 192.168.0.1 Serve at most 4 simultaneous connections: - $ ./darkhttpd ~/public_html --maxconn 4 + $ ./darkhttpd ~/public_html --maxconn 4 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): - $ ./darkhttpd /var/www/htdocs --chroot + $ ./darkhttpd /var/www/htdocs --chroot 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: - $ cat extramime - text/plain dat - $ ./darkhttpd /var/www/htdocs --mimetypes extramime + $ cat extramime + text/plain dat + $ ./darkhttpd /var/www/htdocs --mimetypes extramime Drop privileges: - $ ./darkhttpd /var/www/htdocs --uid www --gid www + $ ./darkhttpd /var/www/htdocs --uid www --gid www Use acceptfilter (FreeBSD only): - $ kldload accf_http - $ ./darkhttpd /var/www/htdocs --accf + $ 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 + $ ./darkhttpd /var/www/htdocs --pidfile /var/run/httpd.pid --daemon Web forward (301) requests for some hosts: - $ ./darkhttpd /var/www/htdocs --forward example.com http://www.example.com \ - --forward secure.example.com https://www.example.com/secure + $ ./darkhttpd /var/www/htdocs --forward example.com http://www.example.com \ + --forward secure.example.com https://www.example.com/secure Web forward (301) requests for all hosts: $ ./darkhttpd /var/www/htdocs --forward example.com http://www.example.com \ --forward-all http://catchall.example.com 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, run darkhttpd without any arguments: - $ ./darkhttpd + $ ./darkhttpd vim:set ts=2 sw=2 et tw=80: