man/su.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH SU "1" "March 2007" "GNU coreutils 6.9" "User Commands"
   3 .SH NAME
   4 su \- run a shell with substitute user and group IDs
   5 .SH SYNOPSIS
   6 .B su
   7 [\fIOPTION\fR]... [\fI-\fR] [\fIUSER \fR[\fIARG\fR]...]
   8 .SH DESCRIPTION
   9 .\" Add any additional description here
  10 .PP
  11 Change the effective user id and group id to that of USER.
  12 .TP
  13 \-, \fB\-l\fR, \fB\-\-login\fR
  14 make the shell a login shell
  15 .TP
  16 \fB\-c\fR, \fB\-\-command\fR=\fICOMMAND\fR
  17 pass a single COMMAND to the shell with \fB\-c\fR
  18 .TP
  19 \fB\-f\fR, \fB\-\-fast\fR
  20 pass \fB\-f\fR to the shell (for csh or tcsh)
  21 .TP
  22 \fB\-m\fR, \fB\-\-preserve\-environment\fR
  23 do not reset environment variables
  24 .TP
  25 \fB\-p\fR
  26 same as \fB\-m\fR
  27 .TP
  28 \fB\-s\fR, \fB\-\-shell\fR=\fISHELL\fR
  29 run SHELL if /etc/shells allows it
  30 .TP
  31 \fB\-\-help\fR
  32 display this help and exit
  33 .TP
  34 \fB\-\-version\fR
  35 output version information and exit
  36 .PP
  37 A mere \- implies \fB\-l\fR.   If USER not given, assume root.
  38 .SH AUTHOR
  39 Written by David MacKenzie.
  40 .SH "REPORTING BUGS"
  41 Report bugs to <bug\-coreutils@gnu.org>.
  42 .SH COPYRIGHT
  43 Copyright \(co 2007 Free Software Foundation, Inc.
  44 .br
  45 This is free software.  You may redistribute copies of it under the terms of
  46 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
  47 There is NO WARRANTY, to the extent permitted by law.
  48 .SH "SEE ALSO"
  49 The full documentation for
  50 .B su
  51 is maintained as a Texinfo manual.  If the
  52 .B info
  53 and
  54 .B su
  55 programs are properly installed at your site, the command
  56 .IP
  57 .B info su
  58 .PP
  59 should give you access to the complete manual.