.\" SCCSID: @(#)su.1	6.5	1/16/90.TH su 1.SH Namesu \- substitute a user ID .SH Syntax.B su[\|\fIusername\fR\|].PP.B su \-[\|\fIusername\fR\|].PP.B su \-f[\|\fIusername\fR\|].SH Description.NXR "su command".NXR "user ID" "changing temporarily"The .PN sucommand requests the password of the specified.IR username .If the correct password is given,.PN suchanges to that .I usernamewithout changing the current directory.The user environmentis unchanged except for HOME and SHELLwhich are taken from the password file entryfor .I username.The shell that is run is also taken from the password file entryfor .I username.The new user ID stays in force until the shell exits..PPIf no .I usernameis specified, `root' is assumed.To remind the superuser of his responsibilities,the shell substitutes `#' for its usual prompt..SH Options.IP \fB\-f\fR 5Prevents.MS csh 1from executing the .cshrc file, making.PN sustart up faster..IP \fB\-\fRSimulates a full login..SH Diagnostics.IP "Sorry" 5n.brAn invalid password was supplied for the specified.IR username ..IP "Unknown login: username" 5n.brThe specified.I usernamewas not found in the passwd database..IP "No directory" 5n.brThe home directory for the.I usernameis not accessible at this time (onlywith ``\-'' argument)..IP "No shell" 5n.brThe shell specified in the passwd database entry for.I usernamecould not be executed..IP "Kerberos initialization failure" 5n.brConsult your system administrator..PPIf enhanced security features are enabled the following errormessages are also possible:.PP.IP "Requires secure terminal" 5n.brAttempt to su to UID 0 on a line that is not marked \fIsecure\fP in.PN /etc/ttys ..IP "User's password has expired" 5n.brAccess is denied because the password for.I usernameis expired..IP "This account is disabled" 5n.brAccess is denied because the auth entry corresponding to.I usernameis marked disabled..SH Files.TP 17.PN /usr/adm/sulogLog file of anyone who became.BR root ,with a date mark..SH See Alsocsh(1), sh(1), passwd(5yp), environ(7), edauth(8).br\fISecurity Guide for Administrators\fP.br\fISecurity Guide for Users\fP