User manual

Chapter 6 Working With Open-Source Applications 53
RegisterUserSite directive
• Syntax: RegisterUserSite username | all-users | customized users [
registrationNameFormat [port | main]
• Default: No registration if directive is absent; registration name defaults to
longname. Port defaults to 80, host defaults to local.
• Context: server config
• Compatibility: Apache 1.3.x; Mac OS X and Mac OS X Server only
• Module: mod_rendezvous_apple
This RegisterUserSite directive causes the registration of the specified users’ default
website.
The required first argument is either an individual user's name or the keyword “all-
users” or “customized-users.” The “all-users” keyword causes all users in the hosts’
directory to be considered for registration. Registration takes place if the user is a non-
system user (user ID > 100), with an enabled website directory as specified in the
UserDir directive, and only if that directory is accessible by the local host. Note that this
may require a mount if the user's home directory is remote; if the home directory is not
available, the user site is not registered. The “customized-users” keyword limits
registration to those users who have an index.html file in their website directory that
differs from the index.html file in the standard user template. In other words, it makes a
reasonable attempt to limit registration to users who have customized their websites.
The optional second argument determines the form of the name under which the user
site is registered. This takes the form of a format string, similar to the LogFormat
directive. Certain directives in the format string are replaced with values:
%l - user’s longname, such as Joe User
%n - user’s short name, such as juser
%u - user’s userid, such as 1234
%t - HTML title of user’s index file (as determined by DirectoryIndex directive; by
default it is index.html) from the user’s default site folder (as determined by the
UserDir directive; by default it is Sites). For Mac OS X Personal Web Sharing, the
default title in a non-customized webpage is “Mac OS X Personal Web Sharing.”
%c - computer name, as set in Sharing Preference panel
The default is %l, the longname. The second argument must be specified if the optional
third argument is desired.
LL2350.book Page 53 Friday, August 22, 2003 2:32 PM