Package: thttpd Version: 2.23beta1-6 Severity: minor Tags: patch X-Debbugs-Cc: [EMAIL PROTECTED]
The attached patch adds a section to the manual page which explains the various options for tilde expansion. /* era */ -- If this were a real .signature, it would suck less. Well, maybe not.
Wed Nov 1 15:07:28 EET 2006 era eriksson <[EMAIL PROTECTED]> * era's documentation patch to explain tilde expansion Adds a section to thttpd.8 explaining the compile-time options TILDE_MAP_x, for the benefit of users who don't have ready access to the helpful comments in config.h (i.e. running a packaged or prebuilt binary) diff -rN -u old-thttpd-apt-get-source/thttpd.8 new-thttpd-apt-get-source/thttpd.8 --- old-thttpd-apt-get-source/thttpd.8 2007-05-01 13:09:13.000000000 +0300 +++ new-thttpd-apt-get-source/thttpd.8 2007-05-01 13:09:13.000000000 +0300 @@ -431,6 +431,35 @@ A wildcard pattern that specifies the local host or hosts. This is used to determine if the host in the referer is local or not. If not specified it defaults to the actual local hostname. +.SH "TILDE EXPANSION" +.PP +thttpd can be configured to expand base paths of the form +.I /~user/ +into proper references to the user's web directory. +.PP +If thttpd is compiled with the option +.B TILDE_MAP_1 +(this is the out-of-the-box default when you build from source), +.B ~user +is mapped to +.IB prefix /user +where the +.I prefix +might be something like +.BR /users . +.PP +If thttpd is compiled with the option +.BR TILDE_MAP_2 , +.B ~user +is mapped to a subdirectory in the user's home directory; +the subdirectory's name is also configurable, but the default is +.BR public_html . +This arrangement is incompatible with the +.B chroot +option, and generally considered a security risk. +.PP +See also the next section about symbolic links for +additional discussion. .SH SYMLINKS .PP thttpd is very picky about symbolic links.
