.\"Generated by db2man.xsl. Don't modify this, modify the source. .de Sh \" Subsection .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Ip \" List item .br .ie \\n(.$>=3 .ne \\$3 .el .ne 3 .IP "\\$1" \\$2 .. .TH "SU" 1 "" "" "" .SH NAME su \- change user ID or become super-user .SH "SYNOPSIS" .ad l .hy 0 .HP 3 \fBsu\fR [\-] [\fIusername\fR\ [\fIargs\fR]] .ad .hy .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īs 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 presense of a "*" as the first character of the login shell\&. The given home directory will be used as the root of a new filesystem 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