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.10, built on September 10, 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