head	1.1;
access;
symbols;
locks; strict;
comment	@# @;


1.1
date	95.09.07.21.15.58;	author bdowling;	state Exp;
branches;
next	;


desc
@@


1.1
log
@Initial revision
@
text
@
--- This is the README for su2 v1.3 released on Sep-07-1995

DISCLAIMER: This` [quote] release [unquote] ' has been made by the
            College of Computer Science at Northeastern University.
            We have re-released this program because it has seemingly
            disappeared from the net and we feel it is useful to
            others.  While we have made a few modifications to this
            source, the majority of this code is not ours, and we do
            not make any guarantees what-so-ever.  
 
            This software is not 'maintained' per se by anyone at CCS.  While
	    we welcome feedback and we may merge any patches supplied
            back into the source, we do not guarantee to respond to
            queries in regards to this software.

	    YOU ARE USING THIS SOFTWARE ENTIRELY AT YOUR OWN RISK.

--- What is su2?

   su2 is a great program for anyone that has anything to do with
system adiministration.  su2 gives you the ability to masquerade with
the UID of other users.  You use own password to switch.  Probably the
biggest benefit of su2 is that you retain your own customized shell
environment.

   For the most part, this program is used by system administrators to
become root, but su2 has been written to enable much more flexibility
than this.  Regular users can put a .su2rc file in their home
directory to enable other users to become them.  While this may sound
odd, it is sometimes useful to allow a number of users to masquerade
around with the uid of restricted accounts.  One such example of this
is a 'www' account which is a common occurance with the proliferation
of the web.  While the www user's password may be starred out to
disable direct logins, root could put a set of usernames into
~www/.su2rc to enable these users to 'become' www and do Web
adiministration.  [This feature can be disabled if you are worried
about 'account sharing.']


--- To Install su2, you should do the following:

  1) Look at the Makefile and su2.c to determine the proper options for your
     environment.

  2) run 'make' to build su2

  3) Provided you set the DESTintation to be what you want in the
     Makefile, a 'make install' should install the binary and manpage
     for you.  Note that 'make install' must be done when you are
     'root' -- it attempts to make the owner of su2 root with 
     perms 4711 (otherwise it won't work...)


--- This distribution should be available via anonymous ftp from:

	ftp://ftp.ccs.neu.edu/pub/sysadmin/su2-1.3.tar.gz


--- Important Comments from the su2 source:

/*
 * Bart's version of su2
 *
 * 7/91
 * Based on source from HP 1984/1985.
 * Copyright notice and revision history at bottom.
 *
 * Pseudo su program.  This program will check your username
 * in a system file to see if you are authorized to become root.
 * If it is found, your password will be asked for, and a root
 * shell exec'd.

 *  3rd February 1995
 *  Modifications by Matthew Wojcik, woj@@ccs.neu.edu

 *  18 July 1995
 *  Modifications by Brian Dowling, bdowling@@ccs.neu.edu
 */	

/*
 * su2.c
 *
 * Copyright Hewlett-Packard Company, 1985.  Permission is granted for
 * unlimited modification, use, and distribution, except that this software
 * may not be sold for profit directly nor as part of any software package.
 * This software is made available with no warranty of any kind, express
 * or implied.
 *
 * Writen by:
 *	Dave Serisky (hp-pcd!daves)
 *	Handheld Computer and Calculator Operation
 *	Hewlett-Packard
 *	1000 NE Circle BLVD.
 *	Corvallis, OR   97330
 *	(503) 757-2000
 *
 ******	Revision history ***********************************************

	851029	Added the -d option
		Fixed -c bug.  Worked for "-cstring" but not for
		"-c string".
	851016	Added IOCTL and INITGROUPS compile options.
	851007	Included the following mods from hakanson@@orstcs:
		Added CHANGEHOME compile option.
		Added BSD compile option,
		Added NOCHOWNTTY and NOCHMODTTY compile options.
		For BSD option:
 			Includes cuserid() code.
			Alternate default PATH.
			Added definition of TERM in NewEnvironment.
			Does initgroups().
		Now chdir() to home directory for FullLogin;
		Added conditional use of vfork() instead of fork().
		Fixed bug in environment-passing for FullLogin option.
		Fixed bug where tty ownership got reset on exit only
		if ChangeType == ToRoot.
	850828	cleaned up some of the code, and added additional compile
		options.
	850725	added "UPATH" and "SUPATH" environment variables.  Fixed
		.su2rc handler so that a leading "+" in the .su2rc file
		would not be blocked by its absence in the super-users
		file.  Moved the path stripper and change prompt code
		into a function to use registers on the character pointers.
	850326	added the ability for users to install their own .su2rc
		file.  must be suid to that user.
	850322	fixed chmod so that it sets the correct bits
	841226	changes gid before uid.  if new uid == 0: makes tty mode 600;
		removes from path all directories not beginning with /.
	841127	added -r -s options
	841018	added "-" option, cleaned up program somewhat
	840926	full rewrite
	840906  if prompt declared, set last non-blank character to #
	840830  Identifies tty properly now, notes failure as well as success.
	840727	Original issue.

***********************************************************************/
@
