Annotation of src/usr.bin/mesg/mesg.1, Revision 1.15
1.15 ! jmc 1: .\" $OpenBSD: mesg.1,v 1.14 2010/01/03 16:43:46 schwarze Exp $
1.1 deraadt 2: .\" $NetBSD: mesg.1,v 1.3 1994/12/23 07:16:31 jtc Exp $
3: .\"
4: .\" Copyright (c) 1987, 1990, 1993
5: .\" The Regents of the University of California. All rights reserved.
6: .\"
7: .\" Redistribution and use in source and binary forms, with or without
8: .\" modification, are permitted provided that the following conditions
9: .\" are met:
10: .\" 1. Redistributions of source code must retain the above copyright
11: .\" notice, this list of conditions and the following disclaimer.
12: .\" 2. Redistributions in binary form must reproduce the above copyright
13: .\" notice, this list of conditions and the following disclaimer in the
14: .\" documentation and/or other materials provided with the distribution.
1.9 millert 15: .\" 3. Neither the name of the University nor the names of its contributors
1.1 deraadt 16: .\" may be used to endorse or promote products derived from this software
17: .\" without specific prior written permission.
18: .\"
19: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29: .\" SUCH DAMAGE.
30: .\"
31: .\" @(#)mesg.1 8.1 (Berkeley) 6/6/93
32: .\"
1.15 ! jmc 33: .Dd $Mdocdate: January 3 2010 $
1.1 deraadt 34: .Dt MESG 1
35: .Os
36: .Sh NAME
37: .Nm mesg
38: .Nd display (do not display) messages from other users
39: .Sh SYNOPSIS
40: .Nm mesg
1.10 jmc 41: .Op Cm n | Cm y
1.1 deraadt 42: .Sh DESCRIPTION
43: The
44: .Nm mesg
1.4 flipk 45: utility is invoked by a user to control write access others
1.1 deraadt 46: have to the terminal device associated with the standard error
47: output.
48: Write access is allowed by default, and programs such as
49: .Xr talk 1
50: and
51: .Xr write 1
52: may display messages on the terminal.
53: .Pp
1.5 aaron 54: The options are as follows:
1.6 aaron 55: .Bl -tag -width Ds
1.1 deraadt 56: .It Cm n
57: Disallows messages.
58: .It Cm y
59: Permits messages to be displayed.
60: .El
61: .Pp
62: If no arguments are given,
63: .Nm mesg
64: displays the present message status to the standard error output.
65: .Pp
66: The
67: .Nm mesg
68: utility exits with one of the following values:
1.14 schwarze 69: .Pp
1.1 deraadt 70: .Bl -tag -width flag -compact -offset indent
1.15 ! jmc 71: .It 0
1.1 deraadt 72: Messages are allowed.
1.15 ! jmc 73: .It 1
1.1 deraadt 74: Messages are not allowed.
1.15 ! jmc 75: .It \*(Gt1
1.1 deraadt 76: An error has occurred.
77: .El
78: .Sh FILES
79: .Bl -tag -width /dev/[pt]ty[pq]? -compact
80: .It Pa /dev/[pt]ty[pq]?
81: .El
82: .Sh SEE ALSO
83: .Xr biff 1 ,
84: .Xr talk 1 ,
85: .Xr write 1
1.11 jmc 86: .Sh STANDARDS
87: The
88: .Nm
89: utility is compliant with the
1.13 jmc 90: .St -p1003.1-2008
1.11 jmc 91: specification.
1.1 deraadt 92: .Sh HISTORY
93: A
94: .Nm mesg
95: command appeared in
1.8 mickey 96: .At v2 .