home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 4 / CDPD_IV.bin / networking / tcpip / amitcp-support / wustl-ftpdaemon / doc / ftpd.man < prev    next >
Encoding:
Text File  |  1994-06-29  |  10.6 KB  |  330 lines
  1.  
  2.  
  3.  
  4.    Jan 28, 1993                                                       FTPD(8)
  5.  
  6.  
  7.  
  8.    NAME
  9.      ftpd - DARPA Internet File Transfer Protocol server
  10.  
  11.    SYNOPSIS
  12.      ftpd [ -d ] [ -l ] [ -ttimeout ] [ -Tmaxtimeout ] [ -a ] [ -A ] [ -L ] [
  13.      -i ] [ -I ] [ -o ] [ -O ]
  14.  
  15.    DESCRIPTION
  16.      Ftpd is the DARPA Internet File Transfer Protocol server process.  The
  17.      server uses the TCP protocol and listens at the port specified in the
  18.      ``ftp'' service specification; see services(5).
  19.  
  20.      If the -d option is specified, debugging information is written to the
  21.      syslog.
  22.  
  23.      If the -l option is specified, each ftp session is logged in the syslog.
  24.  
  25.      The ftp server will timeout an inactive session after 15 minutes.  If
  26.      the -t option is specified, the inactivity timeout period will be set to
  27.      timeout seconds.  A client may also request a different timeout period;
  28.      the maximum period allowed may be set to timeout seconds with the -T
  29.      option.  The default limit is 2 hours.
  30.  
  31.      If the -a option is specified, the use of the ftpaccess(5) configuration
  32.      file is enabled.
  33.  
  34.      If the -A option is specified, use of the ftpaccess(5) configuration
  35.      file is disabled.
  36.  
  37.      If the -L option is specified, commands sent to the ftpd(8) server will
  38.      be logged to the syslog.  The -L option is overridden by the ftpac-
  39.      cess(5) file.  If the -L flag is used, command logging will be on by
  40.      default as soon as the ftp server is invoked.  This will cause the
  41.      server to log all USER commands, which if a user accidentally enters a
  42.      password for that command instead of the username, will cause passwords
  43.      to be logged via syslog.
  44.  
  45.      If the -i option is specified, files received by the ftpd(8) server will
  46.      be logged to the xferlog(5).  The -i option is overridden by the ftpac-
  47.      cess(5) file.
  48.  
  49.      If the -o option is specified, files transmitted by the ftpd(8) server
  50.      will be logged to the syslog.  The -o option is overridden by the ftpac-
  51.      cess(5) file.
  52.  
  53.      The ftp server currently supports the following ftp requests; case is
  54.      not distinguished.
  55.  
  56.      Request        Description
  57.      ABOR           abort previous command
  58.      ACCT           specify account (ignored)
  59.      ALLO           allocate storage (vacuously)
  60.      APPE           append to a file
  61.  
  62.  
  63.                                                                             1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.    FTPD(8)                                                       Jan 28, 1993
  71.  
  72.  
  73.      CDUP           change to parent of current working directory
  74.      CWD            change working directory
  75.      DELE           delete a file
  76.      HELP           give help information
  77.      LIST           give list files in a directory (``ls -lgA'')
  78.      MKD            make a directory
  79.      MDTM           show last modification time of file
  80.      MODE           specify data transfer mode
  81.      NLST           give name list of files in directory
  82.      NOOP           do nothing
  83.      PASS           specify password
  84.      PASV           prepare for server-to-server transfer
  85.      PORT           specify data connection port
  86.      PWD            print the current working directory
  87.      QUIT           terminate session
  88.      REST           restart incomplete transfer
  89.      RETR           retrieve a file
  90.      RMD            remove a directory
  91.      RNFR           specify rename-from file name
  92.      RNTO           specify rename-to file name
  93.      SITE           non-standard commands (see next section)
  94.      SIZE           return size of file
  95.      STAT           return status of server
  96.      STOR           store a file
  97.      STOU           store a file with a unique name
  98.      STRU           specify data transfer structure
  99.      SYST           show operating system type of server system
  100.      TYPE           specify data transfer type
  101.      USER           specify user name
  102.      XCUP           change to parent of current working directory (deprecated)
  103.      XCWD           change working directory (deprecated)
  104.      XMKD           make a directory (deprecated)
  105.      XPWD           print the current working directory (deprecated)
  106.      XRMD           remove a directory (deprecated)
  107.  
  108.      The following non-standard or UNIX specific commands are supported by
  109.      the SITE request.
  110.  
  111.      Request        Description
  112.      UMASK          change umask. E.g. SITE UMASK 002
  113.      IDLE           set idle-timer. E.g. SITE IDLE 60
  114.      CHMOD          change mode of a file. E.g. SITE CHMOD 755 filename
  115.      HELP           give help information. E.g. SITE HELP
  116.      NEWER          list files newer than a particular date
  117.      MINFO          like SITE NEWER, but gives extra information
  118.      GROUP          request special group access. E.g. SITE GROUP foo
  119.      GPASS          give special group access password. E.g. SITE GPASS bar
  120.      EXEC           execute a program.  E.g. SITE EXEC program params
  121.  
  122.      The remaining ftp requests specified in Internet RFC 959 are recognized,
  123.      but not implemented.  MDTM and SIZE are not specified in RFC 959, but
  124.      will appear in the next updated FTP RFC.
  125.  
  126.  
  127.  
  128.  
  129.    2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.    Jan 28, 1993                                                       FTPD(8)
  137.  
  138.  
  139.      The ftp server will abort an active file transfer only when the ABOR
  140.      command is preceded by a Telnet "Interrupt Process" (IP) signal and a
  141.      Telnet "Synch" signal in the command Telnet stream, as described in
  142.      Internet RFC 959.  If a STAT command is received during a data transfer,
  143.      preceded by a Telnet IP and Synch, transfer status will be returned.
  144.  
  145.      Ftpd interprets file names according to the ``globbing'' conventions
  146.      used by csh(1).  This allows users to utilize the metacharacters
  147.      ``*?[]{}~''.
  148.  
  149.      Ftpd authenticates users according to four rules.
  150.  
  151.      1)   The user name must be in the password data base, AmiTCP:db/passwd,
  152.           and not have a null password.  In this case a password must be
  153.           provided by the client before any file operations may be performed.
  154.  
  155.      2)   The user name must not appear in the file AmiTCP:db/ftpusers.
  156.  
  157.      3)   The user must have a standard shell returned by getusershell(3).
  158.  
  159.      4)   If the user name is ``anonymous'' or ``ftp'', an anonymous ftp
  160.           account must be present in the password file (user ``ftp'').  In
  161.           this case the user is allowed to log in by specifying any password
  162.           (by convention this is given as the client host's name).
  163.  
  164.      In the last case, ftpd takes special measures to restrict the client's
  165.      access privileges.  The server performs a chroot(2) command to the home
  166.      directory of the ``ftp'' user.  In order that system security is not
  167.      breached, it is recommended that the ``ftp'' subtree be constructed with
  168.      care;  the following rules are recommended.
  169.  
  170.      ~ftp
  171.           Make the home directory owned by ``ftp'' and unwritable by anyone.
  172.  
  173.      ~ftp/bin
  174.           Make this directory owned by the super-user and unwritable by any-
  175.           one.  The program ls(1) must be present to support the list com-
  176.           mand.  This program should have mode 111.
  177.  
  178.      ~ftp/etc
  179.           Make this directory owned by the super-user and unwritable by any-
  180.           one.  The files passwd(5) and group(5) must be present for the ls
  181.           command to be able to produce owner names rather than numbers.  The
  182.           password field in passwd is not used, and should not contain real
  183.           encrypted passwords.  These files should be mode 444.
  184.  
  185.      ~ftp/pub
  186.           Make this directory mode 777 and owned by ``ftp''.  Users should
  187.           then place files which are to be accessible via the anonymous
  188.           account in this directory.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                             3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.    FTPD(8)                                                       Jan 28, 1993
  203.  
  204.  
  205.    GENERAL FTP EXTENSIONS
  206.  
  207.      There are some extensions to the FTP server such that if the user speci-
  208.      fies a filename (when using a RETRIEVE command) such that:
  209.  
  210.       True Filename  Specified Filename  Action
  211.       -------------  ------------------  -----------------------------------
  212.       <filename>.Z   <filename>          Decompress file before transmitting
  213.       <filename>     <filename>.Z        Compress <filename> before
  214.                                                  transmitting
  215.       <filename>     <filename>.tar      Tar <filename> before transmitting
  216.       <filename>     <filename>.tar.Z    Tar and compress <filename> before
  217.                                                  transmitting
  218.  
  219.      Also, the FTP server will attempt to check for valid e-mail addresses
  220.      and chide the user if he doesn't pass the test.  For users whose FTP
  221.      client will hang on "long replies" (i.e. multiline responses), using a
  222.      dash as the first character of the password will disable the server's
  223.      lreply() function.
  224.  
  225.      The FTP server can also log all file transmission and reception, keeping
  226.      the following information for each file transmission that takes place.
  227.  
  228.      Mon Dec  3 18:52:41 1990 1 wuarchive.wustl.edu 568881 /files.lst.Z a _ o
  229.      a chris@wugate.wustl.edu ftp 0 *
  230.  
  231.        %.24s %d %s %d %s %c %s %c %c %s %s %d %s
  232.          1   2  3  4  5  6  7  8  9  10 11 12 13
  233.  
  234.        1 current time in the form DDD MMM dd hh:mm:ss YYYY
  235.        2 transfer time in seconds
  236.        3 remote host name
  237.        4 file size in bytes
  238.        5 name of file
  239.        6 transfer type (a>scii, b>inary)
  240.        7 special action flags (concatenated as needed):
  241.              C   file was compressed
  242.              U   file was uncompressed
  243.              T   file was tar'ed
  244.              _   no action taken
  245.        8 file was sent to user (o>utgoing) or received from
  246.          user (i>ncoming)
  247.        9 accessed anonymously (r>eal, a>nonymous) -- mostly for FTP
  248.       10 local username or, if guest, ID string given
  249.          (anonymous FTP password)
  250.       11 service name ('ftp', other)
  251.       12 authentication method (bitmask)
  252.              0   none
  253.              1   RFC931 Authentication
  254.       13 authenticated user id (if available, '*' otherwise)
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.    4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.    Jan 28, 1993                                                       FTPD(8)
  269.  
  270.  
  271.    SEE ALSO
  272.      ftp(1), getusershell(3), syslogd(8), ftpaccess(5), xferlog(5)
  273.  
  274.    BUGS
  275.      The anonymous account is inherently dangerous and should avoided when
  276.      possible.
  277.  
  278.      The server must run as the super-user to create sockets with privileged
  279.      port numbers.  It maintains an effective user id of the logged in user,
  280.      reverting to the super-user only when binding addresses to sockets.  The
  281.      possible security holes have been extensively scrutinized, but are pos-
  282.      sibly incomplete.
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                             5
  328.  
  329.  
  330.