home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / shell / guestshell.README < prev    next >
Encoding:
Text File  |  1992-10-31  |  3.4 KB  |  98 lines
  1.  
  2.     /\/\/\/\/\/\/\/\/\
  3.        < GuestLogin  V1.1 >
  4.     \/\/\/\/\/\/\/\/\/
  5.  
  6.     (c) 1991,1992 by Carsten Lutz
  7.     Internet: clu@malihh.hanse.de 
  8.  
  9.  
  10. ** What is 'guestlogin'
  11.  
  12. GuestLogin is a little shell, that I use for guests in my system. I tested
  13. it only on a NeXT-computer, but it should run on all BSD-like systems.
  14.  
  15. The reason for writing this program was that I didn't want to give
  16. csh/sh-access to guests in my system. The guestlogin-shell is easy to 
  17. use and provides all functionality that an average guest needs:
  18.  
  19. - Information about the system he/she is connected to
  20. - Information about who is currently logged in
  21. - Possibility to send a mail to the postmaster or any local user
  22.   ( this is configurable )
  23. - Possibility to have a talk to the postmaster
  24. - Possibility to transfer a file. GuestShell offers the System-administrator
  25.   the possibility to use passwords and configure the access-rights to
  26.   files individually for each guest.
  27.  
  28. ** How to install ?
  29.  
  30. Edit global.h. It contains a configurable-section, which is commented.
  31. You should carefully read this file and make all necessary changes. After
  32. doing this, it should suffer to type 'make'. 
  33.  
  34. If the program compiled well, you should do the following steps:
  35.  
  36. - create a user "guest" ( or whatever you like )
  37. - copy guestlogin to guests home-directory and use it as guest's loginshell
  38. - `touch` the logfile you specified in global.h and `chown` it to the
  39.   guest-user
  40. - Create all necessary textfiles in the text-directory you specified in
  41.   global.h. The files are:
  42.  
  43.   - "info" is shown, when menu-entry one "show system information" is
  44.     selected
  45.  
  46.   - "login" is displayed immediately after login, if it exists.
  47.  
  48.   remark: See global.h for shorter text-fragments you can define.
  49.  
  50. - create the filetransfer-passwd file ( specified in global.h ), if
  51.   you defined RESTRICTEDACCESS in global.h
  52.  
  53. ** Some words about the filetranfer-facility
  54.  
  55. There are different ways to use the filetransfer feature in 
  56. guestlogin:
  57.  
  58. If you don't define RESTRICTEDACCESS in global.h, then any guest is allowed
  59. to read all files in the PUBDIR ( also defined in global.h ). Sending any
  60. file ( but NOT overwriting an existing file ! ) and requesting a directory
  61. of PUBDIR is also allowed to anybody.
  62.  
  63. If you define RESTRICTEDACCESS, then you need to define the file FILEPWD
  64. in global.h. This is a file, which contains a table of passwords and
  65. access-rights. Each line is one entry. Comments start with '#' and may
  66. be at the end or the beginning of a line. Comments and blank lines are
  67. ignored. Each line must at least have 4 fields, but may have as much fiels
  68. as you want. The fields are separated by space or tab.
  69.  
  70. The first field specifies a password. The following fields specifiy the
  71. access-rights for a guest which enters the password. These are:
  72. The second, third and fourth fields represent the rights for download,
  73. upload and directory, respectively. A 0 denies the right and a 1 allows
  74. the access.
  75.  
  76. If download is permitted, then there may be a list of blank-separated 
  77. filenames after the fourth field. If it is missing, reading-access to
  78. all files is given. If a list exists, the guest with the password
  79. specified in the first field can only download the files which
  80. are in the list.
  81.  
  82. examples:
  83.  
  84. # allow download of only one file
  85. blubb    1    0    0    waffle164.zip
  86. # allow download of all files
  87. blobb    1    0    0
  88. # allow anything
  89. special    1    1    1
  90.  
  91. Have fun, the program is not very genial, but may be someone needs it...
  92.  
  93. bug-reports to clu@malihh.hanse.de
  94.  
  95. - Carsten Lutz
  96.  
  97.  
  98.