home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume4 / unaxcess / part1 / README < prev    next >
Encoding:
Text File  |  1986-11-30  |  7.1 KB  |  165 lines
  1. UNaXcess Version 0.04.03            Wednesday, March 5, 1986 - 9:00 PM
  2.  
  3.           Supplemental notes for installing UNaXcess
  4.  
  5.  
  6. This directory contains the UNaXcess Distribution.  There is no User's Guide
  7. at present, and it is only known to work on V7 and AT&T System III.  Berkeley
  8. Unix should work, but System V users will have to change uwho.c to reflect
  9. the format of /etc/inittab under System V.
  10.  
  11. The shar file should have created a number of files in this directory, and
  12. a subdirectory called ``Utilities'' containing even more files.  Inspect the
  13. Makefile (it SHOULD work as it is on any system, but you never know), then
  14. type ``make SYSTEM=system all'', where system is BSD, SYS3, or V7.  Xenix
  15. people should compile with SYSTEM=V7, as should people running BSD2.9 or
  16. BSD4.1.  System V people should compile with -DSYS3 (after making the changes
  17. to uwho.c described above).  (Xenixers will have to define Index and RIndex
  18. to be strchr and strrchr also, if they are running 3.0 or later.)  Note that
  19. this program uses _doprnt() in the up/download module; a -DUSE_PRINT is
  20. defined in the Makefile, since Plexus sys3 systems (at least) use a different
  21. function for formatted output, and Plexus _print takes different arguments.
  22. Remove -DUSE_PRINT from the CFLAGS in the Makefile if your system uses
  23. _doprnt().
  24.  
  25. To install UNaXcess, type ``sh Utilities/install.sh'' while in the source
  26. directory. You will be asked various questions and be placed in the editor to
  27. compose a bulletin.
  28.  
  29. After installation, you should edit the NewMessage file as specified by the
  30. installation script.  It should say anything you want new users to know before
  31. registering as UNaXcess users.
  32.  
  33. You should also run UnaXcess as sysop and type ``user new'' to edit the new-
  34. user setup.  The parameter to be set is the access level granted.  As
  35. distribu- ted, this is USER access level.  For business applications, this
  36. should be SYSTEM (allowing shell access).  For certain applications, it should
  37. be set to GUEST (users can only post to the GUEST conference).  Note that
  38. there are 6 access levels:
  39.  
  40.     NONE        - de-activated logins or un-validated logins
  41.     MAKEUSER    - runs the user maker before entering
  42.     GUEST        - can read anything, only add to GUEST
  43.     FILES        - can access the File Section
  44.     SYSTEM        - can use the C command (shell access), also
  45.               can use a system editor to edit messages
  46.     FAIRWITNESS    - all but a sysop.  The only limitation is that
  47.               only the Sysop (who is a fairwitness) can make
  48.               or break other fairwitnesses.
  49.  
  50. -----------------------
  51. Some notes:
  52.  
  53. The configuration file is stored in the home directory of the UNaXcess system
  54. and is named ``ua-config''.  It contains lines of the format:
  55.  
  56.                 variable    value
  57.  
  58. The defaults are contained in param.c, not that you should change them (that's
  59. what the config file is for).  UNKNOWN VARIABLES WILL CAUSE UNAXCESS NOT TO
  60. RUN.  The variables are:
  61.  
  62.     readonly    boolean    Indicates whether Read-Only conferences are
  63.                 valid.  Read-Only conferences begin with
  64.                 the characters ``r-''.
  65.  
  66.     x-rated        boolean    Indicates whether X-Rated (restricted)
  67.                 conferences are valid.  X-Rated conferences
  68.                 begin with the characters ``x-''.
  69.  
  70.     editor        string    The path of the editor to use in creating
  71.                 messages.  The editor ``ua-edit'' is the
  72.                 built-in editor.  This editor is used only
  73.                 if the user has SYSTEM access or greater;
  74.                 otherwise, the built-in editor is used.
  75.  
  76.     shell        string    The path of the shell to use when the C
  77.                 command is invoked.  The C command is not
  78.                 valid for users whose access is less than
  79.                 SYSTEM level.  (Note:  there is no reason
  80.                 that this must be a shell.  The original
  81.                 version of the File Section was a separate
  82.                 program accessed by the C command.)
  83.  
  84.     read-env    boolean    Indicates whether the user's environment
  85.                 should be read to indicate the shell and
  86.                 editor.
  87.  
  88.     bbs-user    string    UNaXcess will permit a user whose Unix login
  89.                 name is the same as his UA login name to log
  90.                 in from the shell without specifying his name
  91.                 or password.  The ``bbs-user'' is exempt from
  92.                 this; it is intended to prevent breaches in
  93.                 security by invoking a shell (C command) and
  94.                 running ua from the shell.
  95.  
  96.     time-limit    number    This is the time limit for UNaXcess in minutes.
  97.                 If this is zero, no time-out occurs.  A warning
  98.                 is given five minutes before a logout; if the
  99.                 user is in the shell or editor when his time
  100.                 runs out, exiting the shell or editor will
  101.                 log him out.
  102.  
  103.     sysop        string    The name of the UNaXcess sysop is configurable.
  104.                 Special-purpose systems may indicate a more
  105.                 descriptive name (i.e. DUNGEON MASTER for a
  106.                 fantasy gaming BBS).
  107.  
  108.     private-msgs    boolean    Indicates whether private messages may be
  109.                 created.
  110.  
  111.     logging        boolean    Indicates whether a session log should be kept
  112.                 in Logfile.  This allows you to track security
  113.                 problems, people who misuse the system, or
  114.                 (heaven forbid) bugs.  However, the log gets
  115.                 big rather quickly, so you may wish to leave
  116.                 this off.
  117.  
  118.     banner        string    This string contains the name of a file whose
  119.                 contents are printed when a user runs UNaXcess,
  120.                 before the login message.  If the string is
  121.                 empty, a default banner is used.
  122.  
  123.     login-msg    string    This string is printed as the login prompt.
  124.                 If it is empty, a default string is used.
  125.                 You might want to change this if you disallow
  126.                 GUEST or NEW logins, or change their names.
  127.  
  128.     pauses        number    This is 2 for no pauses, 1 for user-specified
  129.                 pausing, and 0 for forced pausing.  A cheap
  130.                 built-in pager is used.
  131.  
  132.     login-tries    number    If this is not 0, it specifies the number of
  133.                 login attempts permitted before UNaXcess exits.
  134.  
  135.     ascii-upload    string    These are the command strings to be passed to
  136.     ascii-download        /bin/sh via system() to perform the specified
  137.     xmodem-upload        action.  The defualts are:  a cat string for
  138.     xmodem-download        ascii, umodem -[sr]b for XModem, and C-Kermit
  139.     kermit-upload        command strings for Kermit.  The string ``%s''
  140.     kermit-download        will be replaced with the file's path; if no
  141.                 ``%s'' is specified, the pathname will be
  142.                 appended to the command, preceded by a space.
  143.                 If the string is empty, UNaXcess will assume
  144.                 that no capacity exists for the action.
  145.  
  146.  
  147. A string is specified in double quotes:  "/bin/sh".  Actually, the quotes can
  148. be left off, but in this case the string cannot contain spaces or tabs.  A
  149. boolean is indicated as YES or NO (Y or N will do, and case doesn't matter).
  150. A number is simply a number, but is limited to 0-255.  Strings may contain
  151. escapes (\n \r \t \b \f \e \nnn \a) (\a is bell).  Comments are indicated by
  152. #; they do NOT have to be at the beginning of a line.
  153.  
  154. UNaXcess depends on being setuid to its owner, not only for permissions in
  155. the BBS, but also to insure that the home directory (containing the message
  156. database and config file) can be located.
  157.  
  158. UNaXcess is Copyright (C) 1986 by Brandon S. Allbery.  Permission is hereby
  159. granted to copy and freely distribute this code, Version 0.4.3 and derivatives
  160. ONLY.  Versions 1.0.0 and later are NOT permitted to be copied or distributed.
  161. You may charge only a reasonable handling/copying fee for distribution of this
  162. code, you may NOT sell it.
  163.  
  164. --Brandon Allbery
  165.