From 34ffa5b9989d528f10f103e101d858a5aa2f729e Mon Sep 17 00:00:00 2001 From: CSRG Date: Fri, 20 Aug 1993 21:04:27 -0800 Subject: [PATCH] BSD 4_4 development Work on file usr/share/man/cat1/su.0 Synthesized-from: CSRG/cd3/4.4 --- usr/share/man/cat1/su.0 | 76 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 usr/share/man/cat1/su.0 diff --git a/usr/share/man/cat1/su.0 b/usr/share/man/cat1/su.0 new file mode 100644 index 0000000000..bde48b8f3d --- /dev/null +++ b/usr/share/man/cat1/su.0 @@ -0,0 +1,76 @@ +SU(1) BSD Reference Manual SU(1) + +NNAAMMEE + ssuu - substitute user identity + +SSYYNNOOPPSSIISS + ssuu [--KKffllmm] [_l_o_g_i_n] + +DDEESSCCRRIIPPTTIIOONN + SSuu requests the Kerberos password for _l_o_g_i_n (or for ``_l_o_g_i_n.root'', if no + login is provided), and switches to that user and group ID after obtain- + ing a Kerberos ticket granting ticket. A shell is then executed. SSuu + will resort to the local password file to find the password for _l_o_g_i_n if + there is a Kerberos error. If ssuu is executed by root, no password is re- + quested and a shell with the appropriate user ID is executed; no addi- + tional Kerberos tickets are obtained. + + By default, the environment is unmodified with the exception of USER, + HOME, and SHELL. HOME and SHELL are set to the target login's default + values. USER is set to the target login, unless the target login has a + user ID of 0, in which case it is unmodified. The invoked shell is the + target login's. This is the traditional behavior of ssuu. + + The options are as follows: + + --KK Do not attempt to use Kerberos to authenticate the user. + + --ff If the invoked shell is csh(1), this option prevents it from + reading the ``_._c_s_h_r_c'' file. + + --ll Simulate a full login. The environment is discarded except for + HOME, SHELL, PATH, TERM, and USER. HOME and SHELL are modified as + above. USER is set to the target login. PATH is set to + ``_/_b_i_n_:_/_u_s_r_/_b_i_n''. TERM is imported from your current environ- + ment. The invoked shell is the target login's, and ssuu will + change directory to the target login's home directory. + + --mm Leave the environment unmodified. The invoked shell is your lo- + gin shell, and no directory changes are made. As a security pre- + caution, if the target user's shell is a non-standard shell (as + defined by getusershell(3)) and the caller's real uid is non- + zero, ssuu will fail. + + The --ll and --mm options are mutually exclusive; the last one specified + overrides any previous ones. + + Only users in group 0 (normally ``wheel'') can ssuu to ``root''. + + By default (unless the prompt is reset by a startup file) the super-user + prompt is set to ``##'' to remind one of its awesome power. + +SSEEEE AALLSSOO + csh(1), login(1), sh(1), kinit(1), kerberos(1), passwd(5), + group(5), environ(7) + +EENNVVIIRROONNMMEENNTT + Environment variables used by ssuu: + + HOME Default home directory of real user ID unless modified as specified + above. + + PATH Default search path of real user ID unless modified as specified + above. + + TERM Provides terminal type which may be retained for the substituted + + user ID. + + USER The user ID is always the effective ID (the target user ID) after + an ssuu unless the user ID is 0 (root). + +HHIISSTTOORRYY + A ssuu command appeared in Version 7 AT&T UNIX. The version desribed here + is an adaptation of the MIT Athena Kerberos command. + +4.4BSD June 6, 1993 2 -- 2.20.1