home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / gnu / shellutils-1.9.4-bin.lha / man / cat1 / su.0 < prev    next >
Text File  |  1993-12-07  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. SU(1L)                                                     SU(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        su - run a shell with substitute user and group IDs
  9.  
  10. SSYYNNOOPPSSIISS
  11.        ssuu  [-flmp]  [-c  command]  [-s  shell] [--login] [--fast]
  12.        [--preserve-environment]               [--command=command]
  13.        [--shell=shell] [-] [user [arg...]]
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.        This  manual  page  documents  the  GNU version of ssuu.  ssuu
  17.        allows one user to temporarily become  another  user.   It
  18.        runs  a  shell  with the real and effective user ID, group
  19.        ID, and supplemental groups of USER.  If no USER is given,
  20.        the  default  is  root,  the super-user.  The shell run is
  21.        taken from USER's password entry, or /bin/sh  if  none  is
  22.        specified  there.   If USER has a password, ssuu prompts for
  23.        the password unless run by a user with real user ID 0 (the
  24.        super-user).
  25.  
  26.        By  default, ssuu does not change the current directory.  It
  27.        sets the environment variables `HOME' and `SHELL' from the
  28.        password  entry  for  USER,  and if USER is not the super-
  29.        user, sets `USER' and `LOGNAME' to USER.  By default,  the
  30.        shell is not a login shell.
  31.  
  32.        If  one  or  more ARGs are given, they are passed as addi-
  33.        tional arguments to the shell.
  34.  
  35.        ssuu does not handle /bin/sh or other shells specially (set-
  36.        ting  argv[0] to "-su", passing -c only to certain shells,
  37.        etc.).
  38.  
  39.        On systems that have syslog, ssuu can be compiled to  report
  40.        failed,  and optionally successful, ssuu attempts using sys-
  41.        log.
  42.  
  43.        This  program  does  not  support  a  "wheel  group"  that
  44.        restricts  who can ssuu to super-user accounts, because that
  45.        can help fascist system  administrators  hold  unwarranted
  46.        power over other users.
  47.  
  48.    OOPPTTIIOONNSS
  49.        _-_, _-_l_, _-_-_l_o_g_i_n
  50.               Make  the shell a login shell.  This means the fol-
  51.               lowing.  Unset  all  environment  variables  except
  52.               `TERM',  `HOME',  and  `SHELL'  (which  are  set as
  53.               described above), and `USER' and  `LOGNAME'  (which
  54.               are  set,  even  for  the  super-user, as described
  55.               above), and set `PATH'  to  a  compiled-in  default
  56.               value.   Change  to USER's home directory.  Prepend
  57.               "-" to the shell's name, to make it read its  login
  58.               startup file(s).
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SU(1L)                                                     SU(1L)
  71.  
  72.  
  73.        _-_c _C_O_M_M_A_N_D_, _-_-_c_o_m_m_m_a_n_d_=_C_O_M_M_A_N_D
  74.               Pass  COMMAND, a single command line to run, to the
  75.               shell with a  _-_c  option  instead  of  starting  an
  76.               interactive shell.
  77.  
  78.        _-_f_, _-_-_f_a_s_t
  79.               Pass  the  _-_f  option  to the shell.  This probably
  80.               only makes sense with ccsshh and ttccsshh, for  which  the
  81.               _-_f   option   prevents  reading  the  startup  file
  82.               (.cshrc).  With Bourne-like shells, the  _-_f  option
  83.               disables filename pattern expansion, which is not a
  84.               generally desirable thing to do.
  85.  
  86.        _-_m_, _-_p_, _-_-_p_r_e_s_e_r_v_e_-_e_n_v_i_r_o_n_m_e_n_t
  87.               Do not change  the  environment  variables  `HOME',
  88.               `USER', `LOGNAME', or `SHELL'.  Run the shell given
  89.               in the  environment  variable  `SHELL'  instead  of
  90.               USER's shell from /etc/passwd, unless the user run-
  91.               ning ssuu is not the superuser and  USER's  shell  is
  92.               restricted.   A restricted shell is one that is not
  93.               listed in the file /etc/shells, or in a compiled-in
  94.               list  if  that  file does not exist.  Parts of what
  95.               this option does can be overridden by  _-_-_l_o_g_i_n  and
  96.               _-_-_s_h_e_l_l.
  97.  
  98.        _-_s_, _-_-_s_h_e_l_l _s_h_e_l_l
  99.               Run SHELL instead of USER's shell from /etc/passwd,
  100.               unless the user running ssuu is not the superuser and
  101.               USER's shell is restricted.
  102.  
  103.        The  long-named options can be introduced with `+' as well
  104.        as `--', for compatibility with previous releases.   Even-
  105.        tually  support  for  `+'  will  be removed, because it is
  106.        incompatible with the POSIX.2 standard.
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.