386BSD 0.1 development

[unix-history] / usr / src / usr.bin / mesg / mesg.1

diff --git a/usr/src/usr.bin/mesg/mesg.1 b/usr/src/usr.bin/mesg/mesg.1
index 4c810fa..bba5136 100644 (file)
--- a/usr/src/usr.bin/mesg/mesg.1
+++ b/usr/src/usr.bin/mesg/mesg.1
@@ -1,37 +1,94 @@
-.\"    @(#)mesg.1      5.1 (Berkeley) %G%
+.\" Copyright (c) 1987, 1990 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.TH MESG 1 "18 July 1983"
-.AT 3
-.SH NAME
-mesg \- permit or deny messages
-.SH SYNOPSIS
-.B mesg
-[
-.B n
-] [
-.B y
-]
-.SH DESCRIPTION
-.I Mesg
-with argument
-.B n
-forbids messages via
-.I  write
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)mesg.1      6.7 (Berkeley) 7/26/91
+.\"
+.Dd July 26, 1991
+.Dt MESG 1
+.Os
+.Sh NAME
+.Nm mesg
+.Nd Display (do not display) messages from other users
+.Sh SYNOPSIS
+.Nm mesg
+.Op Cm n | Cm y
+.Sh DESCRIPTION
+The
+.Nm mesg
+utility is invoked by a user to control write access others have to
+her or his terminal.  By default, write access is allowed, and
+programs such as
+.Xr talk 1 ,
+.Xr write 1

 and
 and

-.IR talk (1)
-by revoking non-user
-write permission on the user's terminal.
-.I Mesg
-with argument
-.B y
-reinstates permission.
-All by itself,
-.I mesg
-reports the current state without changing it.
-.SH FILES
-/dev/tty*
-.SH "SEE ALSO"
-write(1), talk(1)
-.SH DIAGNOSTICS
-Exit status is 0 if messages are receivable,
-1 if not, 2 on error.
+.Xr echo 1
+may display messages on the target user's terminal.
+.Pp
+Options available:
+.Bl -tag -width flag
+.It Cm n
+Disallows messages and informs the
+sender
+that `Your party is refusing messages'.
+.It Cm y
+Allows messages to be displayed.
+.El
+.Pp
+If no arguments are given,
+.Nm mesg
+displays the present message status.
+.Pp
+The
+.Nm mesg
+utility exits with one of the following values:
+.Bl -tag -width flag -compact -offset indent
+.Pp
+.It Li "\ 0"
+Messages are allowed.
+.It Li "\ 1"
+Messages are not allowed.
+.It Li "\-1"
+An error has occurred.
+.El
+.Sh FILES
+.Bl -tag -width /dev/[pt]ty[pq]? -compact
+.It Pa /dev/[pt]ty[pq]?
+.El
+.Sh SEE ALSO
+.Xr write 1 ,
+.Xr talk 1 ,
+.Xr echo 1 ,
+.Xr biff 1
+.Sh HISTORY
+A
+.Nm mesg
+command appeared in
+.At v6 .