Commit | Line | Data |
---|---|---|
7d4168b6 KM |
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 | .\" | |
d9fd65e7 | 5 | .\" @(#)su.1 6.1 (Berkeley) %G% |
7d4168b6 | 6 | .\" |
d9fd65e7 | 7 | .TH SU 1 "" |
7d4168b6 KM |
8 | .UC |
9 | .SH NAME | |
10 | su \- substitute user id temporarily | |
11 | .SH SYNOPSIS | |
12 | .B su | |
d9fd65e7 | 13 | [ \-f ] [ \- ] [ userid ] |
7d4168b6 KM |
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) | |
d9fd65e7 KM |
23 | or |
24 | .IR csh (1) | |
7d4168b6 KM |
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 | |
f0fa4329 | 31 | .IR environ (7)). |
7d4168b6 KM |
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 | To remind the super-user of his responsibilities, | |
38 | the Shell substitutes `#' for its usual prompt. | |
d9fd65e7 KM |
39 | .PP |
40 | The | |
41 | .B \-f | |
42 | option prevents | |
43 | .IR csh (1) | |
44 | from executing the .cshrc file; thus making | |
45 | .I su | |
46 | start up faster. | |
47 | .PP | |
48 | The | |
49 | .B \- | |
50 | option simulates a full login. | |
7d4168b6 | 51 | .SH "SEE ALSO" |
d9fd65e7 | 52 | sh(1), csh(1) |
7d4168b6 KM |
53 | .SH BUGS |
54 | Local administrative rules cause restrictions to | |
55 | be placed on who can | |
56 | .I su | |
57 | to `root', even with the root password. | |
58 | These rules vary from site to site. |