usr/src/usr.bin/su/su.1

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)su.1	6.2 (Berkeley) %G%
.\"
.TH SU 1 ""
.UC
.SH NAME
su \- substitute user id temporarily
.SH SYNOPSIS
.B su
[ \-f ] [ \- ] [ userid ]
.SH DESCRIPTION
.I Su
demands the password of the specified
.I userid,
and if it is given,
changes to that
.I userid
and invokes the Shell
.IR sh (1)
or
.IR csh (1)
without changing the current directory.
The user environment
is unchanged except for HOME and SHELL,
which are taken from the password file
for the user being substituted
(see
.IR environ (7)).
The new user ID stays in force until the Shell exits.
.PP
If no
.I userid
is specified, ``root'' is assumed.
Only users in the ``wheel'' group (group 0) can
.I su
to ``root'', even with the root password.
To remind the super-user of his responsibilities,
the Shell substitutes `#' for its usual prompt.
.PP
The
.B \-f
option prevents
.IR csh (1)
from executing the .cshrc file; thus making
.I su
start up faster.
.PP
The
.B \-
option simulates a full login.
.SH "SEE ALSO"
sh(1), csh(1)
Commit	Line	Data
	1	.\" Copyright (c) 1980 Regents of the University of California.
	2	.\" All rights reserved. The Berkeley software License Agreement
	3	.\" specifies the terms and conditions for redistribution.
	4	.\"
	5	.\" @(#)su.1 6.2 (Berkeley) %G%
	6	.\"
	7	.TH SU 1 ""
	8	.UC
	9	.SH NAME
	10	su \- substitute user id temporarily
	11	.SH SYNOPSIS
	12	.B su
	13	[ \-f ] [ \- ] [ userid ]
	14	.SH DESCRIPTION
	15	.I Su
	16	demands the password of the specified
	17	.I userid,
	18	and if it is given,
	19	changes to that
	20	.I userid
	21	and invokes the Shell
	22	.IR sh (1)
	23	or
	24	.IR csh (1)
	25	without changing the current directory.
	26	The user environment
	27	is unchanged except for HOME and SHELL,
	28	which are taken from the password file
	29	for the user being substituted
	30	(see
	31	.IR environ (7)).
	32	The new user ID stays in force until the Shell exits.
	33	.PP
	34	If no
	35	.I userid
	36	is specified, ``root'' is assumed.
	37	Only users in the ``wheel'' group (group 0) can
	38	.I su
	39	to ``root'', even with the root password.
	40	To remind the super-user of his responsibilities,
	41	the Shell substitutes `#' for its usual prompt.
	42	.PP
	43	The
	44	.B \-f
	45	option prevents
	46	.IR csh (1)
	47	from executing the .cshrc file; thus making
	48	.I su
	49	start up faster.
	50	.PP
	51	The
	52	.B \-
	53	option simulates a full login.
	54	.SH "SEE ALSO"
	55	sh(1), csh(1)