NAME

HTTP::Server::Directory::UserDirs - describe user directories

INHERITANCE

 HTTP::Server::Directory::UserDirs
   is a HTTP::Server::Directory

SYNOPSIS

 # implicit creation of ::Directory object
 my $vh = HTTP::Server::VirtualHost
   ->new(user_dirs => {location => ...})

 # explicit use
 my $ud = HTTP::Server::Directory::UserDirs
   ->new(location => sub {...});
 my $vh = HTTP::Server::VirtualHost->new(user_dirs => $ud);

DESCRIPTION

Each HTTP::Server::VirtualHost may define user directories.

METHODS

Constructors

HTTP::Server::Directory::UserDirs->new(OPTIONS|HASH-of-OPTIONS)

The user-dir rewrite routine has by default Apache-like behavior.

 Option      --Defined in     --Default
 allow         HTTP::Server::Directory  <undef>
 allow_users                    undef
 deny          HTTP::Server::Directory  <undef>
 deny_users                     []
 location      HTTP::Server::Directory  CODE
 path          HTTP::Server::Directory  <ignored>
 user_subdirs                   'public_html'

. allow => CIDR|HOSTNAME|DOMAIN|CODE|ARRAY

. allow_users => ARRAY

Lists the user homes which are available. Cannot be used together with deny_users. By default, all user homes are permitted, even those of system usernames like ftp and cups. Only used with the default user-dir rewrite rule.

. deny => CIDR|HOSTNAME|DOMAIN|CODE|ARRAY

. deny_users => ARRAY

Only used with the default user-dir rewrite rule.

. location => DIRECTORY|CODE

. path => STRING

. user_subdirs => PATH

Only used with the default user-dir rewrite rule.

Attributes

$obj->location

See "Attributes" in HTTP::Server::Directory

$obj->path

See "Attributes" in HTTP::Server::Directory

Permissions

$obj->allow(CLIENT, SESSION, REQUEST, URI)

See "Permissions" in HTTP::Server::Directory

$obj->filename(PATH)

See "Permissions" in HTTP::Server::Directory

DETAILS

SEE ALSO

This module is part of HTTP-Server-Multiplex distribution version 0.11, built on October 01, 2008. Website: http://perl.overmeer.net/httpd-multiplex/

LICENSE

Copyrights 2008 by Mark Overmeer. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html