Research V4 development

Work on file man/man1/write.1
Work on file man/man1/who.1

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

diff --git a/man/man1/who.1 b/man/man1/who.1
new file mode 100644 (file)
index 0000000..d2a9fb6
--- /dev/null
+++ b/man/man1/who.1
@@ -0,0 +1,38 @@
+.th WHO I 3/15/72
+.sh NAME
+who  \*-  who is on the system
+.sh SYNOPSIS
+.bd who
+[ who-file ]
+.sh DESCRIPTION
+.it Who,
+without an argument,
+lists the name, typewriter channel, and login time
+for each current UNIX user.
+.s3
+Without an argument,
+.it who
+examines the /tmp/utmp
+file to obtain its information.
+If a file is given, that file is examined.
+Typically the given file will be /tmp/wtmp,
+which contains a record of all the logins since it
+was created.
+Then
+.it who
+will list
+logins, logouts, and crashes since the creation of
+the wtmp file.
+.s3
+Each login is listed with user name,
+typewriter name (with `/dev/'
+suppressed),
+and date and time.
+When an argument is given, logouts produce a similar line without a user name.
+Reboots produce a line with `x' in the place of the device name,
+and a fossil time indicative of when the system went down.
+.sh FILES
+/tmp/utmp
+.sh "SEE ALSO"
+login(I), init(VII)
+.sh BUGS

diff --git a/man/man1/write.1 b/man/man1/write.1
new file mode 100644 (file)
index 0000000..ca04cf8
--- /dev/null
+++ b/man/man1/write.1
@@ -0,0 +1,65 @@
+.th WRITE I 8/5/73
+.sh NAME
+write  \*-  write to another user
+.sh SYNOPSIS
+.bd write
+user [ ttyno ]
+.sh DESCRIPTION
+.it Write
+copies lines from your typewriter to that of
+another user.
+When first called,
+it sends the message
+.s3
+     message from yourname...
+.s3
+The recipient of the message should write back at this point.
+Communication continues until an end of file is
+read from the typewriter or an interrupt is sent.
+At that point
+.it write
+writes `EOT' on the other terminal and exits.
+.s3
+If you want to write to a user who is logged in more than once,
+the
+.it ttyno
+argument may be used to indicate the last character
+of the appropriate typewriter name.
+.s3
+Permission to write may be denied or granted by use of the
+.it mesg
+command.
+At the outset writing is allowed.
+Certain commands, in particular
+.it roff
+and
+.it pr,
+disallow
+messages in order to prevent messy output.
+.s3
+If the character `!' is found at the beginning of a line,
+.it write
+calls the mini-shell
+.it msh
+to execute the rest of the
+line as a command.
+.s3
+The following protocol is suggested for using
+.it write:
+when you first write to another user, wait for him to
+write back before starting to send.
+Each party should end each message with a distinctive
+signal
+(
+.bd (o)
+for `over' is conventional) that the other may reply.
+.bd (oo)
+(for `over and out') is suggested when conversation
+is about to be terminated.
+.sh FILES
+/tmp/utmp      to find user
+.br
+/etc/msh       to execute `!'
+.sh "SEE ALSO"
+mesg(I), who(I)
+.sh BUGS