67 lines
2.3 KiB
Groff
67 lines
2.3 KiB
Groff
.\" ** You probably do not want to edit this file directly **
|
|
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.0).
|
|
.\" Instead of manually editing it, you probably should edit the DocBook XML
|
|
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
|
|
.TH "SU" "1" "08/03/2005" "User Commands" "User Commands"
|
|
.\" disable hyphenation
|
|
.nh
|
|
.\" disable justification (adjust text to left margin only)
|
|
.ad l
|
|
.SH "NAME"
|
|
su \- change user ID or become super\-user
|
|
.SH "SYNOPSIS"
|
|
.HP 3
|
|
\fBsu\fR [\-] [\fIusername\fR\ [\ \fIargs\fR\ ]]
|
|
.SH "DESCRIPTION"
|
|
.PP
|
|
\fBsu\fR
|
|
is used to become another user during a login session. Invoked without a username,
|
|
\fBsu\fR
|
|
defaults to becoming the super user. The optional argument
|
|
\fB\-\fR
|
|
may be used to provide an environment similar to what the user would expect had the user logged in directly.
|
|
.PP
|
|
Additional arguments may be provided after the username, in which case they are supplied to the user\(aas login shell. In particular, an argument of
|
|
\fB\-c\fR
|
|
will cause the next argument to be treated as a command by most command interpreters. The command will be executed by the shell specified in
|
|
\fI/etc/passwd\fR
|
|
for the target user.
|
|
.PP
|
|
The user will be prompted for a password, if appropriate. Invalid passwords will produce an error message. All attempts, both valid and invalid, are logged to detect abuses of the system.
|
|
.PP
|
|
The current environment is passed to the new shell. The value of
|
|
\fI$PATH\fR
|
|
is reset to
|
|
\fI/bin:/usr/bin\fR
|
|
for normal users, or
|
|
\fI/sbin:/bin:/usr/sbin:/usr/bin\fR
|
|
for the super user. This may be changed with the
|
|
\fIENV_PATH\fR
|
|
and
|
|
\fIENV_SUPATH\fR
|
|
definitions in
|
|
\fI/etc/login.defs\fR.
|
|
.PP
|
|
A subsystem login is indicated by the presence of a "*" as the first character of the login shell. The given home directory will be used as the root of a new file system which the user is actually logged into.
|
|
.SH "CAVEATS"
|
|
.PP
|
|
This version of
|
|
\fBsu\fR
|
|
has many compilation options, only some of which may be in use at any particular site.
|
|
.SH "FILES"
|
|
.TP
|
|
\fI/etc/passwd\fR
|
|
user account information
|
|
.TP
|
|
\fI/etc/shadow\fR
|
|
secure user account information
|
|
.SH "SEE ALSO"
|
|
.PP
|
|
\fBlogin\fR(1),
|
|
\fBsh\fR(1),
|
|
\fBlogin.defs\fR(5),
|
|
\fBsuauth\fR(5)
|
|
.SH "AUTHOR"
|
|
.PP
|
|
Julianne Frances Haugh <jockgrrl@ix.netcom.com>
|