BSD 3 development
[unix-history] / usr / man / man1 / su.1
CommitLineData
16773074
BJ
1.TH SU 1 11/16/79
2.UC
3.SH NAME
4su \- substitute user id temporarily
5.SH SYNOPSIS
6.B su
7[ userid ]
8.SH DESCRIPTION
9.I Su
10demands the password of the specified
11.I userid,
12and if it is given,
13changes to that
14.I userid
15and invokes the Shell
16.IR sh (1)
17without changing the current directory.
18The user environment
19is unchanged except for HOME and SHELL,
20which are taken from the password file
21for the user being substituted
22(see
23.IR environ (5)).
24The new user ID stays in force until the Shell exits.
25.PP
26If no
27.I userid
28is specified, `root' is assumed.
29To remind the super-user of his responsibilities,
30the Shell substitutes `#' for its usual prompt.
31.SH "SEE ALSO"
32sh(1)
33.SH BUGS
34Local administrative rules cause restrictions to
35be placed on who can
36.I su
37to `root', even with the root password.
38These rules vary from site to site.