Return to su.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

BSD 4.3tahoe

.\" 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) 5/5/86
.\"
.TH SU 1 "May 5, 1986"
.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)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.