.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH SU "1" "December 2006" "su 6.7" "User Commands"
.SH NAME
su \- run a shell with substitute user and group IDs
.SH SYNOPSIS
.B su
[\fIOPTION\fR]... [\fI-\fR] [\fIUSER \fR[\fIARG\fR]...]
.SH DESCRIPTION
.\" Add any additional description here
.PP
Change the effective user id and group id to that of USER.
.TP
\-, \fB\-l\fR, \fB\-\-login\fR
make the shell a login shell
.TP
\fB\-c\fR, \fB\-\-command\fR=\fICOMMAND\fR
pass a single COMMAND to the shell with \fB\-c\fR
.TP
\fB\-f\fR, \fB\-\-fast\fR
pass \fB\-f\fR to the shell (for csh or tcsh)
.TP
\fB\-m\fR, \fB\-\-preserve\-environment\fR
do not reset environment variables
.TP
\fB\-p\fR
same as \fB\-m\fR
.TP
\fB\-s\fR, \fB\-\-shell\fR=\fISHELL\fR
run SHELL if /etc/shells allows it
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
A mere \- implies \fB\-l\fR.   If USER not given, assume root.
.SH AUTHOR
Written by David MacKenzie.
.SH "REPORTING BUGS"
Report bugs to <bug\-coreutils@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2006 Free Software Foundation, Inc.
.br
This is free software.  You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B su
is maintained as a Texinfo manual.  If the
.B info
and
.B su
programs are properly installed at your site, the command
.IP
.B info su
.PP
should give you access to the complete manual.