Apache Reference: mod_userdir, UserDir

UserDir

Configure
Syntax: UserDir pattern [...]
Example: UserDir /home/*/public_html/
Since: Apache 1.0

This directive configures URL-to-file system mappings for the home directory of users. Apache use this directive it receives a request for a document for a user (URLs starting with ``Cusername''); UserDir can then find the documents inside the home directory of username. The pattern argument is usually either the name of a directory path or a directory pattern.

If pattern does not start with a slash (``C''), then mod_userdir assumes that it is the subdirectory inside the user's home directory containing where desired the documents. If pattern starts with a slash, two other situations are possible. First, pattern contains a wildcard (an asterisk ``*''), then the asterisk is replaced by username and the result is treated as the prefix for the user's documents root. Second, userdir may be appended to the pattern and the result treated as the prefix for the user's documents root.

Several special variants of pattern exist as well. If pattern is ``disabled username1 username2 ...,'' then no URL translations of the specified user names are made. If pattern is just ``disabled,'' off all URL translations are turned off except those explicitly named with the ``enabled'' keyword. If pattern is ``enabled username1 username2 ...,'' then URL translations for the specified user names are allowed.