NAME

Net::FTPServer::PWP::Server - The FTP server for PWP (personal web pages) service.

SYNOPSIS

  ftpd [-d] [-v] [-p port] [-s] [-S] [-V] [-C conf_file]

DESCRIPTION

Net::FTPServer::PWP::Server is a FTP server personality. This personality implements a complete FTP server with special functionalities in order to provide a PWP service implementation.

The features provided include:

• Directory quotas

• Authentication using the RADIUS protocol

• Configurable root directory

CONFIGURATION

A few config file entries have been added, as described below:

pwp root subdir

If specified, tacks its contents to the root directory obtained through RADIUS. This allows the contraining of the user to a part of her home directory.

default pwp quota

Defaults to -1 or unlimited. Is the number of octets allocated by default to users.

pwp quota cache secs

Controls how often the FTP server will invalidate its notion of the current space consumption. This allows performance tuning. Use a larger value where a small number of concurrent (same user) sessions are expected. Use a smaller value in the oposite case. Finding out what 'larger' and 'smaller' means is left as an excercise for the reader.

A smaller value causes each FTP server to scan the whole user directory more often (actually, every time the number of seconds specified passes).

pwp quota exceeded message

The message to return to the user when her quota is exceeded. Defaults to This operation would exceed your quota.

pwp quota file

The name of the quota file to use. Defaults to .pwpquota.

pwp max quota file age

Maximum age in seconds that the quota file can have, before requiring it to be rebuilt.

pwp max quota file lines

Maximum amount of entries in the quota file before forcing it to be rebuilt.

radius realm

The realm used for authenticating users. Defaults to 'pwp'.

radius server

RADIUS server (or comma separated list of servers) to send requests to. It is an error to not specify at least, a RADIUS server.

radius port

The port to direct the RADIUS request. Defaults to 1645.

radius secret

The secret used to authenticate against the RADIUS server. Not specifying it is an error.

radius dictionary

The RADIUS dictionary file used to encode and decode the RADIUS request. It defaults to /usr/local/lib/pwp-dictionary.

radius timeout

The amount of time we will wait for an answer from a RADIUS server. After this many seconds, the server is skipped and the next one is tried.

pwp radius vendor id

The vendor-id used in the Vendor-Specific Attributes sent and received from the RADIUS server. The dafault is 582. The value specified here must match the one used in your dictionary files.

hide mount point

When true, instructs the FTP server to attempt to hide the actual mount point from the client.

METHODS

$rv = $self->authentication_hook ($user, $pass, $user_is_anon)

Perform login authentication against a RADIUS server. We also take this opportunity to insert our very own handler for the DELE command. This is required to properly keep track of the disk usage of the user. Our handler is called _DELE_command and is documented below.

We also hardcode the SITE QUOTA command to allow the user to check her quota. This is done with _SITE_QUOTA_command, documented below. Note that this will conflict with locally defined handlers for the SITE QUOTA command.

$self->user_login_hook ($user, $anon)

Hook: Called just after user $user has successfully logged in.

$dirh = $self->root_directory_hook;

Hook: Return an instance of Net::FTPServer::PWPDirHandle corresponding to the root directory.

$dirh = $self->pre_command_hook;

Hook: Insures that our quotas look sane enough. Otherwise, have them recalculated.

$dirh = $self->transfer_hook;

Hook: Enforce the quota mechanism by seeing that no transfer exceed the allocated quota.

_SITE_QUOTA_command();

This method handles the SITE QUOTA command, that allows the user to check at a glance, what the server thinks of its space usage.

_DELE_command();

This is supposed to intercept Net::FTPServer::_DELE_command before it is called. What we do here, is to note the size of the soon-to-be-deleted file and apply the change in the quota file if the operation was succesful.

Note that this might be somewhat dangerous or un-portable as traditionally, method names starting with _ mean internal things that should not be messed from the outside. Yet it seems we do not have a better solution to this issue.

The code contains a race condition: If two different sessions try to delete the same file at the same time, probably both will think they did and will attempt to reflect this in the quota file. There's a chance for both of the updates to make it to the quota file, thus over-reducing the user's space allocation. This will correct automatically afterr either a few more operations or some time.

_PWD_command();

Handle the PWD command, hidding the actual root directory from the client if the configuration file specifies a true value for "hide mount point".

->_CDUP_command

Wrapper around _CDUP_command which insures that the mount point is hidden properly.

->_RETR_command

Wrapper around _RETR_command which insures that the mount point is hidden properly.

->_STOR_command

Wrapper around _STOR_command which insures that the mount point is hidden properly.

->_STOU_command

Wrapper around _STOU_command which insures that the mount point is hidden properly.

->_APPE_command

Wrapper around _APPE_command which insures that the mount point is hidden properly.

->_ALLO_command

Wrapper around _ALLO_command which insures that the mount point is hidden properly. As this code was written, the command was not implemented, but you never know...

->_RNFR_command

Wrapper around _RNFR_command which insures that the mount point is hidden properly.

->_RNTO_command

Wrapper around _RNTO_command which insures that the mount point is hidden properly.

->_RMD_command

Wrapper around _RMD_command which insures that the mount point is hidden properly.

->_MKD_command

Wrapper around _MKD_command which insures that the mount point is hidden properly.

->_LIST_command

Wrapper around _LIST_command which insures that the mount point is hidden properly.

->_NLST_command

Wrapper around _NLST_command which insures that the mount point is hidden properly.

->_SITE_CHECKSUM_command

Wrapper around _SITE_CHECKSUM_command which insures that the mount point is hidden properly.

->_SIZE_command

Wrapper around _SIZE_command which insures that the mount point is hidden properly.

->_STAT_command

Wrapper around _STAT_command which insures that the mount point is hidden properly.

->_XMKD_command

Wrapper around _XMKD_command which insures that the mount point is hidden properly.

->_XRMD_command

Wrapper around _XRMD_command which insures that the mount point is hidden properly.

->_XCUP_command

Wrapper around _XCUP_command which insures that the mount point is hidden properly.

->_XCWD_command

Wrapper around _XCWD_command which insures that the mount point is hidden properly.

->_MDTM_command

Wrapper around _MDTM_command which insures that the mount point is hidden properly.

->_MLST_command

Wrapper around _MLST_command which insures that the mount point is hidden properly.

->_MLSD_command

Wrapper around _MLSD_command which insures that the mount point is hidden properly.

FILES

  /etc/ftpd.conf

HISTORY

$Id: Server.pm,v 1.26.2.2 2002/11/13 19:35:05 lem Exp $

1.00

Original version; created by h2xs 1.21 with options

  -ACOXcfkn
        Net::FTPServer::PWP
        -v1.00
        -b
        5.5.0

1.10

PWD will return the path minus the current root. This allows for the hidding of the home directory.

AUTHORS

Luis Munoz <luismunoz@cpan.org>, Manuel Picone <mpicone@cantv.net>

COPYRIGHT

Copyright (c) 2002, Luis Munoz and Manuel Picone

SEE ALSO

Net::FTPServer(3), Net::FTPServer::PWP(3), perl(1)