X-Git-Url: https://git.subgeniuskitty.com/unix-history/.git/blobdiff_plain/7846d13a9e9ed45b7594b7d67442d2c8a0a9d985..1b68e56d0638180ce8453eb433cab71fad133665:/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 4c810fa95b..bba513661e 100644 --- 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 -.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 .