man/man1/su.1

   1 .TH SU 1
   2 .SH NAME
   3 su \- temporary become superuser or another user
   4 .SH SYNOPSIS
   5 .B su
   6 .RB [ \- [ e ]]
   7 .RI [ user
   8 .RI [ shell-arguments " ...]]"
   9 .SH DESCRIPTION
  10 .de SP
  11 .if t .sp 0.4
  12 .if n .sp
  13 ..
  14 .B Su
  15 can be used to temporarily run a shell under the identity of the superuser
  16 or another user.  Unless the caller is a member of the operator group, one
  17 is prompted for the password of the user-to-be.  Calls that need a password
  18 are logged, whether they succeed or not.  The default user is
  19 .BR root .
  20 Further arguments are handed to the shell.  By default the shell started is
  21 the shell of the invoker, and the environment is passed on as is.
  22 .PP
  23 The activities of
  24 .B su
  25 are logged through
  26 .BR syslog (3)
  27 under Minix-vmd.
  28 .SH OPTIONS
  29 .TP
  30 .B \-
  31 Constructs a new environment consisting of the
  32 .BR PATH ,
  33 .BR USER ,
  34 .BR LOGNAME ,
  35 .BR HOME ,
  36 .BR SHELL ,
  37 .BR TERM ,
  38 .BR TERMCAP ,
  39 and
  40 .BR TZ
  41 variables.  The environment is the same as on a normal login, except that
  42 .BR TERM ,
  43 .B TERMCAP
  44 and
  45 .B TZ
  46 are copied from the current environment if set.  The current working
  47 directory is changed to the user home directory, the shell of the user-to-be
  48 is run, and it is started as a login shell, with the first character a minus
  49 sign.
  50 .TP
  51 .B \-e
  52 Like above, but the shell is started normally, not as a login shell.
  53 .SH "SEE ALSO"
  54 .BR sh (1),
  55 .BR login (1),
  56 .BR syslog (3).
  57 .SH AUTHOR
  58 Kees J. Bot <kjb@cs.vu.nl>