home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 2 / 2619 / README < prev   
Encoding:
Text File  |  1991-01-29  |  1.7 KB  |  56 lines
  1.  
  2.     @(#) README    1.1 91/01/26 
  3.  
  4.     Copyright (C) 1991 by Christian Schlichtherle
  5.                   (chris@attron.ruhr.sub.org)
  6.     
  7.     Permission is hereby granted to use, copy, modify or distribute
  8.     this file at will unless this copyright notice is removed.
  9.     The author disclaims any kind of warranty.
  10.  
  11.     README - Documentation file for binst(C).
  12.  
  13.  
  14. SYNTAX
  15.  
  16.     binst <program> ...
  17.  
  18.  
  19. DESCRIPTION
  20.  
  21.     "binst" is a small program used to make user written programs
  22.     public available without having super user permissions in
  23.     order to install it. To avoid system security gaps "binst"
  24.     performs a number of (configurable) checks when installing
  25.     the program.
  26.     To install a program you normally need write permission to the
  27.     directory where the program should go, but giving write
  28.     permission to the user means a lack of system security because
  29.     the user could remove any file in the directory and for example
  30.     substitute it with a trojanic horse.
  31.     With "binst" the user does not need write permission to the
  32.     directory. Instead "binst" is a setugid-root program which
  33.     performs a number of (configurable) checks in order to maintain
  34.     system security.
  35.  
  36.     All installed programs have at least 0755 permission (read
  37.     permission is needed for shell scripts).
  38.     All programs are installed in the directory PUBBIN (configurable
  39.     parameter in "config.h").
  40.     For a detailed description of the permission checkings performed
  41.     by "binst" see the file "config.h". The behaviour of "binst"
  42.     deeply depends on this file.
  43.  
  44.  
  45. NOTES
  46.  
  47.     To install "binst" you should edit "config.h" in order to adapt
  48.     it to your system's needs and edit "Makefile" to satisfact your
  49.     compiler. Installation is quite simple.
  50.  
  51.  
  52. RETURN VALUE
  53.  
  54.     "binst" always returns the status of the last installation,
  55.     which is 0 for success and 1 otherwise.
  56.