share/man/man8/wall.8

   1 '\" te
   2 .\" Copyright (c) 2012 Joyent, Inc.  All Rights Reserved.
   3 .\" Copyright (c) 2000 Sun Microsystems, Inc.  All Rights Reserved.
   4 .\" Copyright 1989 AT&T
   5 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   6 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   7 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   8 .TH WALL 8 "Jul 13, 1994"
   9 .SH NAME
  10 wall \- write to all users
  11 .SH SYNOPSIS
  12 .LP
  13 .nf
  14 \fB/usr/sbin/wall\fR [\fB-a\fR] [\fB-g\fR \fIgrpname\fR] [\fB-z\fR \fIzonename\fR] [\fB-Z\fR] [\fIfilename\fR]
  15 .fi
  16
  17 .SH DESCRIPTION
  18 .sp
  19 .LP
  20 \fBwall\fR reads its standard input until an end-of-file. It then sends this
  21 message to all currently logged-in users preceded by:
  22 .sp
  23 .in +2
  24 .nf
  25 Broadcast Message from .\|.\|.
  26 .fi
  27 .in -2
  28
  29 .sp
  30 .LP
  31 If \fIfilename\fR is given, then the message is read in from that file.
  32 Normally, pseudo-terminals that do not correspond to rlogin sessions are
  33 ignored. Thus, when using a window system, the message appears only on the
  34 console window. However, \fB-a\fR will send the message even to such
  35 pseudo-terminals. Normally, \fBwall\fR sends messages to the current zone
  36 only, from the global zone \fB-Z\fR will send messages to all nonglobal zones,
  37 and \fB-z\fR will send messages to a specified nonglobal zone
  38 .sp
  39 .LP
  40 It is used to warn all users, typically prior to shutting down the system.
  41 .sp
  42 .LP
  43 The sender must be superuser to override any protections the users may have
  44 invoked See \fBmesg\fR(1).
  45 .sp
  46 .LP
  47 \fBwall\fR runs \fBsetgid()\fR to the group  \fBID\fR \fBtty\fR, in order to
  48 have write permissions on other user's terminals. See \fBsetuid\fR(2).
  49 .sp
  50 .LP
  51 \fBwall\fR will detect non-printable characters before sending them to the
  52 user's terminal. Control characters will appear as a  "\fB ^ \fR" followed by
  53 the appropriate \fBASCII\fR character; characters with the high-order bit set
  54 will appear in "meta" notation.  For example, `\fB\e003\fR\&' is displayed as
  55 `\fB^C\fR' and  `\fB\e372\fR\&' as  `\fBM\(miz\fR'.
  56 .SH OPTIONS
  57 .sp
  58 .LP
  59 The following options are supported:
  60 .sp
  61 .ne 2
  62 .na
  63 \fB\fB-a\fR\fR
  64 .ad
  65 .RS 14n
  66 Broadcast message to the console and pseudo-terminals.
  67 .RE
  68
  69 .sp
  70 .ne 2
  71 .na
  72 \fB\fB-\fR\fBg\fR \fIgrpname\fR\fR
  73 .ad
  74 .RS 14n
  75 Broadcast to the users in a specified group only, per the group database (see
  76 \fBgroup\fR(4)).
  77 .RE
  78
  79 .sp
  80 .ne 2
  81 .na
  82 \fB\fB-\fR\fBz\fR \fIzonename\fR\fR
  83 .ad
  84 .RS 14n
  85 Broadcast to the users in a specified zone only
  86 .RE
  87
  88
  89 .sp
  90 .ne 2
  91 .na
  92 \fB\fB-Z\fR\fR
  93 .ad
  94 .RS 14n
  95 Broadcast message to the console and pseudo-terminals of all zones.
  96 .RE
  97
  98 .SH ENVIRONMENT VARIABLES
  99 .sp
 100 .LP
 101 If the  \fBLC_*\fR variables (\fBLC_CTYPE\fR, \fBLC_TIME\fR, \fBLC_COLLATE\fR,
 102 \fBLC_NUMERIC\fR, and \fBLC_MONETARY\fR) are not set in the environment, the
 103 operational behavior of \fBwall\fR for each corresponding locale category is
 104 determined by  the value of the \fBLANG\fR environment variable. See
 105 \fBenviron\fR(5). If \fBLC_ALL\fR is set, its contents are used to override
 106 both the  \fBLANG\fR and the other \fBLC_*\fR variables. If none of the above
 107 variables are set in the environment, the "C" (U.S. style) locale determines
 108 how \fBwall\fR behaves.
 109 .SH FILES
 110 .sp
 111 .LP
 112 \fB/dev/tty*\fR
 113 .SH SEE ALSO
 114 .sp
 115 .LP
 116 \fBmesg\fR(1), \fBwrite\fR(1), \fBsetuid\fR(2), \fBattributes\fR(5),
 117 \fBenviron\fR(5)
 118 .SH NOTES
 119 .sp
 120 .LP
 121 \fBwall\fR displays ``Cannot send to \|.\|.\|.'' when the open on a user's
 122 \fBtty\fR file fails.