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)