============                                        DISview [518]
!FTPUSER.TXT
============


To edit ~/ftpusers from the DIS Session Manager:
*****************************************************************
MAIN MENU:D > CONFIGURE NET:C -- "Edit the FTPUSERS file"
*****************************************************************


>> Example of ~/ftpusers:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# ~/ftpusers
#
# Anonymous accounts
anonymous @ \DEMON\PUB 1
ftp @ \DEMON\PUB 1

# Special accounts
Ian ianspasswd \DEMON 71
Giles gilespasswd \DEMON\PUB 7

# SMTP Mail users without ftp/telnet access
# (entries only necessary if no "default deliver" in ~/alias)
bill ~ \TEMP 0
fred ~ \TEMP 0

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


Record Format:
-----------------------------------------------------------------
<username> <password> <root_dir> <permissions>
-----------------------------------------------------------------
N.B.  EXACTLY ONE SPACE between fields -- no multiple spaces, no 
      tabs.

      The file may contain comment lines (starting with #) and/or
      blank (empty) lines to improve readability.


<username> is any string of characters, without spaces/tabs. When
   accessing this system with ftp or telnet or SMTP mail, case 
   does not matter; e.g. "Giles" and "giles" are the same.


<password> is any string of characters, without spaces/tabs. When
   accessing this system with FTP, case does not matter, but when
   accessing with Telnet, case _does_ matter; e.g. in the example
   above, "gilespasswd" will match but "Gilespasswd" will not,
   when accessing with Telnet.
  
   An asterisk (*) in this field indicates that any password will
   be accepted; by convention, users give their email address as 
   the password.

   An at-character (@) in this field indicates that when 
   accessing this system with FTP or Telnet, the user will be
   specifically asked to enter their email address as the 
   password. No check is made on the actual password entered, 
   except that it must contain an @ character.

   A tilde (~) in this field is a dummy password indicating that 
   this user is a named SMTP mail user who has no permission to 
   login with FTP or Telnet; i.e. the password is always invalid. 
   The remaining fields in the record (<root_dir> and 
   <permissions>) are meaningless. SMTP mail user records 
   containing a tilde password are only necessary if "default 
   deliver" is absent from ~/alias (see below).


<root_dir> is the highest DOS directory level which the user is
   permitted to access.  This must be expressed as an absolute
   _full_ pathname from the _DOS_ root, but without drive letter.
   The pathname may include backslashes or forward slashes, and 
   case does not matter.

   >> Example: if the highest permitted level is the DOS directory
               C:\DEMON, then the <root_dir> field will be \DEMON.


<permissions> specify access rights to the system.  Note that in 
   addition to giving these rights to individual users, the
   corresponding NET server must also be started:

       For FTP access:    'start ftp'
       For Telnet access: 'start telnet'
                        (i.e. for login to the built-in KA9Q BBS)

   FTP and Telnet access permissions
   ---------------------------------
      1     allow read access to files
      2     allow creation of new files
      4     allow write access to existing files and 
            allow file deletion

   more Telnet access permissions
   ------------------------------
      8     allow AX.25 Gateway access
     16     allow Telnet Gateway access
     32     allow NET/ROM access
     64     allow remote control
    128     disallow all access

   ppp access permissions
   ----------------------
    256     PPP connection
    512     peer ID/password lookup

   miscellaneous access permissions
   --------------------------------
   1024     disallow send commands (except for sysop)
   2048     disallow read commands
   4096     disallow third-party mail
   8192     known BBS


"default deliver" in ~/alias
----------------------------
If the incoming mail alias file (~/alias) does not contain the
entry "default deliver", ~/ftpusers must contain an entry for each
user which can accept SMTP mail (with the exception of 
"postmaster", which can always receive mail and therefore does not
need an entry). Such entries should contain the dummy password
field (~) for users who are not allowed to access the system with
FTP or Telnet.

Mail addressed to a user not having an entry in ~/ftpusers will 
bounce if ~/alias does not contain the entry "default deliver".

On the other hand, if ~/alias does contain the entry "default 
deliver", it is not necessary for users to be listed in ~/ftpusers 
to receive mail.
