home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / FTPSER03 / DOC / USERS.DOC < prev    next >
Text File  |  1997-09-16  |  3KB  |  84 lines
  1. HOW TO SET UP USER PERMISSION FILES
  2. ===================================
  3.  
  4. Remark: I'm aware that the setup described here is a little awkward,
  5. and I'm planning to change it in a future version.
  6.  
  7. Each username requires a separate "username.PRM" file, in the
  8. same directory as ftpd.exe.  The file name has to match the
  9. user name.  (I'm planning to switch to a different system in
  10. some future release, but that's the way it works for now.)
  11. For a reasonably complicated example, see the supplied file
  12. called "example.PRM".
  13.  
  14. The file is free-format, i.e. the exact formatting is not
  15. important; but, for the sake of readability, I suggest that
  16. you use indentation etc. to make its structure clearer.
  17.  
  18. All file names have to be delimited by double quote marks (").
  19. This is to allow for things like file names that contain spaces.
  20.  
  21. The first three things in a permission file are:
  22.  
  23.  1. The user category code.  The possible values are
  24.         G      guest user, who has to provide an e-mail address
  25.                as a password.
  26.         U      normal user, who has to supply a password
  27.         N      user who does not need a password.
  28.  
  29.  2. The password.  For a guest user, put "@" as the password.
  30.     For an 'N' user, just supply a dummy entry here.
  31.  
  32.  3. The user's home directory.  This must be a full path name ending
  33.     with the '/' character, and must be surrounded by quote marks.
  34.  
  35. After that, you have the <directory descriptor>.  This has the form
  36.  
  37.        <code> <subdirectory info>
  38.  
  39. Both of these are optional.  The <code> can be any combination of
  40.        R+   allow read
  41.        R-   deny read
  42.        W+   allow write
  43.        W-   deny write
  44.        D+   allow delete
  45.        D-   deny delete
  46.  
  47. The <subdirectory info> is defined recursively.  It has the form
  48.  
  49.        (  <item> ,  <item> ,  ...  , <item> )
  50.  
  51. i.e. it is a comma-separated list of items, surrounded by
  52. parentheses.  Each <item> has the form
  53.  
  54.        "<directory name>"  <directory descriptor>
  55.  
  56. where the <directory descriptor> follows exactly the same rules
  57. as the <directory descriptor> for the home directory.  That is,
  58. it can also contain things like comma-separated lists of
  59. subdirectory information.
  60.  
  61. If this sounds complicated, take a look at the supplied *.PRM
  62. files, and you'll soon pick up the pattern.
  63.  
  64. The permission codes are always to be interpreted relative to
  65. the parent directory's permission code.  That is, a directory has
  66. the same permissions as its parent, unless explicitly changed
  67. by adding and/or deleting permissions.
  68.  
  69. (For the home directory, the default permissions are: read,
  70. no write, no delete.)
  71.  
  72. Note that a R- permission code makes a directory invisible.
  73. Such a directory won't show up on directory listings, and the
  74. user can't do a "change directory" to that directory.
  75.  
  76. If you want a user to have access to more than one disk, just
  77. repeat the list with a new home directory.  But there can't
  78. be more than one home directory per drive letter.
  79.  
  80. Warning: a user with access to multiple disks gets told which
  81. drive he's on.  I suggest that you give this facility only to
  82. people in the "system manager" category.
  83.  
  84.