The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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

$obj->path

Permissions

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

$obj->filename(PATH)

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