README
======

Biblio@Tech Net::FTPServer - A full-featured, secure, extensible
and configurable Perl FTP server.

The server was written as part of the Biblio@Tech Schoolmaster.net
project and was kindly released under the GNU General Public License
(GPL).

Major features of Net::FTPServer include:

* Feature parity with wu-ftpd.
* IP-based and IP-less virtual hosting.
* Virtual filesystem allows the FTP server to serve files from a
 SQL database.
* Configurable and extensible in Perl.
* <Perl> sections in ftpd.conf file.
* Supports all the latest RFCs and Internet Drafts, including MLST,
 MLSD, FEAT, OPTS, LANG.
* Secure by design and implementation.
* PAM authentication.
* Resource limits.
* Run standalone or from inetd.
* Configurable server greetings and welcome messages.
* Anonymous mode.
* Run in chroot jail.
* Sophisticated access control rules.
* wu-ftpd style aliases and cdpath.
* SITE EXEC (disabled by default).
* Syslog logging.
* Set TCP parameters.

Missing features:

* Upload/download quotas.


PREREQUISITES
-------------
required:  perl >= 5.00503  Getopt::Long     This is usually supplied as part of the                   basic Perl package.  IO               This is also normally included in the                   basic Perl package, but make sure you                   have a pretty recent version.  IO-stringy       This is now required by the main server.                   Make sure you have at least version 1.220                   from CPAN which includes some important                   bug fixes. optional:  Archive::Zip     If you want to allow users to create ZIP                   files from directories on the fly (so-called                   "archive mode"), you need this module.  Authen::PAM      If you want to do PAM authentication (eg.                   you have Red Hat Linux or Solaris).  BSD::Resource    If you want resource limits to avoid certain                   types of denial of service (DoS) attack.  Compress::Zlib   If you want to allow users to create ZIP                   files from directories on the fly (so-called                   "archive mode"), you need this module.  Digest::MD5      If you want the SITE CHECKSUM command                   to work correctly.  File::Sync       Needed for SITE SYNC command.  bzip2            If an external "bzip2" program is available,                   it can be used to create archives                   automatically.  gzip             If an external "gzip" program is available,                   it can be used to create archives                   automatically.  uuencode         If an external "uuencode" program is                   available, it can be used to create                   uuencoded archives automatically. INSTALLATION
------------
To compile:  perl Makefile.PL       make   make test To install (usually as root):      make install You can override where the configuration file will go by specifying the SYSCONFDIR setting.  /etc is the default. Or to avoid installing a configuration altogether use "make NOCONF=1 install" instead. The documentation should be automatically installed. Do:      man Net::FTPServer or if you don't have a working man pages system, do:      pod2man lib/Net/FTPServer.pm | nroff -man | more Read the section "INSTALLING AND RUNNING THE SERVER" to find out how to change the configuration file to suit your local situation, and how to start and stop the server. CONFIGURATION AND DOCUMENTATION
-------------------------------

All other documentation is in the Net::FTPServer(3) man page. After
installation, type:

       man Net::FTPServer

and read the section "INSTALLING AND RUNNING THE SERVER".


SUPPORT AND MAILING LIST
------------------------

NOTE: the information below is still avtive, but please consider to
contact discussion forum on CPAN and/or github repositry first.

There is a mailing list for general discussion and announcements.  See
the Savannah mailing list page for details:

https://savannah.nongnu.org/mail/?group=netftpserver

Bug reports, feature requests, and so on should be sent to the mailing
list.


CREDITS
-------

Copyright (C) 2000 Biblio@Tech Ltd., Unit 2-3, 50 Carnwath Road, London, SW6 3EG, UK.
Copyright (C) 2000-2003 Richard Jones <[email protected]> and other contributors.

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.