.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.012.
.TH SU "1" "August 1999" "GNU sh-utils 2.0" FSF
.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
.PP
.\" 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\-\-commmand\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 "REPORTING BUGS"
Report bugs to <bug-sh-utils@gnu.org>.
.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.
.SH COPYRIGHT
Copyright \(co 1999 Free Software Foundation, Inc.
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.