59 lines
		
	
	
		
			1.4 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
			
		
		
	
	
			59 lines
		
	
	
		
			1.4 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
| .TH SU 1
 | |
| .SH NAME
 | |
| su \- temporary become superuser or another user
 | |
| .SH SYNOPSIS
 | |
| .B su
 | |
| .RB [ \- [ e ]]
 | |
| .RI [ user
 | |
| .RI [ shell-arguments " ...]]"
 | |
| .SH DESCRIPTION
 | |
| .de SP
 | |
| .if t .sp 0.4
 | |
| .if n .sp
 | |
| ..
 | |
| .B Su
 | |
| can be used to temporarily run a shell under the identity of the superuser
 | |
| or another user.  Unless the caller is a member of the operator group, one
 | |
| is prompted for the password of the user-to-be.  Calls that need a password
 | |
| are logged, whether they succeed or not.  The default user is
 | |
| .BR root .
 | |
| Further arguments are handed to the shell.  By default the shell started is
 | |
| the shell of the invoker, and the environment is passed on as is.
 | |
| .PP
 | |
| The activities of
 | |
| .B su
 | |
| are logged through
 | |
| .BR syslog (3)
 | |
| under Minix-vmd.
 | |
| .SH OPTIONS
 | |
| .TP
 | |
| .B \-
 | |
| Constructs a new environment consisting of the
 | |
| .BR PATH ,
 | |
| .BR USER ,
 | |
| .BR LOGNAME ,
 | |
| .BR HOME ,
 | |
| .BR SHELL ,
 | |
| .BR TERM ,
 | |
| .BR TERMCAP ,
 | |
| and
 | |
| .BR TZ
 | |
| variables.  The environment is the same as on a normal login, except that
 | |
| .BR TERM ,
 | |
| .B TERMCAP
 | |
| and
 | |
| .B TZ
 | |
| are copied from the current environment if set.  The current working
 | |
| directory is changed to the user home directory, the shell of the user-to-be
 | |
| is run, and it is started as a login shell, with the first character a minus
 | |
| sign.
 | |
| .TP
 | |
| .B \-e
 | |
| Like above, but the shell is started normally, not as a login shell.
 | |
| .SH "SEE ALSO"
 | |
| .BR sh (1),
 | |
| .BR login (1),
 | |
| .BR syslog (3).
 | |
| .SH AUTHOR
 | |
| Kees J. Bot <kjb@cs.vu.nl>
 | 
