SU
Section: User Commands (1)
Index
Return to Main Contents
BSD mandoc
NAME
su
- substitute user identity
SYNOPSIS
[-Kflm
]
[login [shell arguments
]
]
DESCRIPTION
requests the Kerberos password for
login
(or for
``login .root
''
if no login is provided), and switches to
that user and group ID after obtaining a Kerberos ticket granting ticket.
A shell is then executed, and any additional
shell arguments
after the login name
are passed to the shell.
will resort to the local password file to find the password for
login
if there is a Kerberos error.
If
is executed by root, no password is requested and a shell
with the appropriate user ID is executed; no additional Kerberos tickets
are obtained.
Alternatively, if the user enters the password "s/key", authentication
will use the S/Key one-time password system as described in
skey(1).
S/Key is a Trademark of Bellcore.
By default, the environment is unmodified with the exception of
USER
HOME
and
SHELL
HOME
and
SHELL
are set to the target login's default values.
USER
is set to the target login, unless the target login has a user ID of 0,
in which case it is unmodified.
The invoked shell is the target login's.
This is the traditional behavior of
su
The options are as follows:
- -K
-
Do not attempt to use Kerberos to authenticate the user.
- -f
-
If the invoked shell is
csh(1),
this option prevents it from reading the
``.cshrc
''
file.
- -l
-
Simulate a full login.
The environment is discarded except for
HOME
SHELL
PATH
TERM
and
USER
HOME
and
SHELL
are modified as above.
USER
is set to the target login.
PATH
is set to
``/bin:/usr/bin
''
TERM
is imported from your current environment.
The invoked shell is the target login's, and
will change directory to the target login's home directory.
- -m
-
Leave the environment unmodified.
The invoked shell is your login shell, and no directory changes are made.
As a security precaution, if the target user's shell is a non-standard
shell (as defined by
getusershell(3))
and the caller's real uid is
non-zero,
will fail.
The
-l
and
-m
options are mutually exclusive; the last one specified
overrides any previous ones.
Only users in group
``wheel''
(normally gid 0),
as listed in
/etc/group
can
to
``root''
By default (unless the prompt is reset by a startup file) the super-user
prompt is set to
``#
''
to remind one of its awesome power.
SEE ALSO
csh(1),
login(1),
sh(1),
skey(1),
kinit(1),
kerberos(1),
passwd(5),
group(5),
environ(7)
ENVIRONMENT
Environment variables used by
:
- HOME
-
Default home directory of real user ID unless modified as
specified above.
- PATH
-
Default search path of real user ID unless modified as specified above.
- TERM
-
Provides terminal type which may be retained for the substituted
user ID.
- USER
-
The user ID is always the effective ID (the target user ID) after an
unless the user ID is 0 (root).
HISTORY
A
command appeared in
AT&T System
v7 .
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- SEE ALSO
-
- ENVIRONMENT
-
- HISTORY
-
This document was created by
man2html,
using the manual pages.
Time: 04:30:07 GMT, April 24, 2025