NAME

       twoftpd-xfer - TwoFTPD file transfer back-end.

SYNOPSIS

       twoftpd-xfer

DESCRIPTION

       twoftpd-xfer  reads  FTP  request  from  the network and executes file transfers based on those requests.
       Before doing anything, twoftpd-xfer changes directory to the authenticated user's home directory, changes
       the root directory to that directory, and drops all root priviledges.

ENVIRONMENT

       AUTHENTICATED
              If  set  (typically  by  twoftpd-auth  after  successfully completing authentication), the startup
              banner will use code 230, indicating that authentication was successful.  Otherwise,  the  startup
              banner will use code 220, which is the normal initial connection banner.

       BANNER If set, the contents of this variable will be sent as extra responses when the server starts.

       CHROOT If set, change the root directory to the user's home directory through the OS chroot syscall.

       CONNECT_TIMEOUT
              The  maximum  number of seconds to wait for a data channel connection to complete.  If not set, it
              defaults to the value of $TIMEOUT.

       GID    Numerical group ID number to change to at program startup.

       GIDS   Optional comma-seperated list of numerical group IDs to set up as the supplementary group IDs.

       GROUP  Group name to use in long listings for files owned by $GID.  If not set, defaults to mygroup.

       HOME   Directory to switch to on program startup.

       LOCKHOME
              If set (and neither CHROOT nor SOFTCHROOT are set), all accesses to files  and  paths  outside  of
              HOME will be forbidden.

       LOGREQUESTS
              If set, all requests from the client will be logged.

       LOGRESPONSES
              If set, all responses to the client (after login) will be logged.

       MESSAGEFILE
              If  set,  the  contents  this  file  will  be  automatically sent as extra responses to the client
              whenever the server enters a directory (including at startup).

       NODOTFILES
              If set, all listings will exclude all files starting with a period, and it will not be possible to
              do any file access (including storing or retrieving) to any file starting with a period.  This may
              be useful for anonymous FTP servers.

       SESSION_TIMEOUT
              The maximum number of seconds to allow a single session to last.

       SOFTCHROOT
              If set, and CHROOT is not set, the server  emulates  the  effect  of  a  chroot  without  actually
              effecting  a  chroot.   This  eliminates  the  system-enforced barrier provided by the chroot, but
              allows for things like symlinks outside of the home directory.

       TCPLOCALIP
              The IP to use when creating PASV connections.  Normally, this is set by tcpserver.

       TCPREMOTEIP
              The source IP to use when creating PORT connections.  Normally, this is set by tcpserver.

       TIMEOUT
              The maximum number of seconds to wait for command input or connections.

       UID    Numerical user ID number to change to at program startup.

       USER   Owner name to use in long listings for files owned by $UID.

NOTES

       You will need to set the umask to an appropriate value before running this program.

       The twoftpd-anon program functions identically to this program, with the  exception  of  having  no  file
       modification  capabilities.   The  twoftpd-drop  program is a similarly restricted program, that can only
       create new files (no overwriting, modifying, or listing existing files).

                                                                                                 twoftpd-xfer(1)