Research V6 development

Work on file usr/doc/man/man8/su.8

Co-Authored-By: Ken Thompson <ken@research.uucp>
Synthesized-from: v6

diff --git a/usr/doc/man/man8/su.8 b/usr/doc/man/man8/su.8
new file mode 100644 (file)
index 0000000..00e3e10
--- /dev/null
+++ b/usr/doc/man/man8/su.8
@@ -0,0 +1,24 @@
+.th SU VIII 10/31/73
+.sh NAME
+su  \*-  become privileged user
+.sh SYNOPSIS
+.bd su
+.sh DESCRIPTION
+.it Su
+allows one to become the super-user, who has
+all sorts of marvelous (and correspondingly dangerous) powers.
+In order for \fIsu\fR to do its magic, the user must
+supply a password.
+If the password is correct, \fIsu\fR
+will execute the Shell with the UID set to
+that of the super-user.
+To restore normal UID privileges,
+type an end-of-file to the super-user Shell.
+.s3
+The password demanded is that of the entry ``root''
+in the system's password file.
+.s3
+To remind the super-user of his responsibilities,
+the Shell substitutes `#' for its usual prompt `%'.
+.sh "SEE ALSO"
+sh (I)