~ubuntu-branches/ubuntu/trusty/util-linux/trusty-proposed

« back to all changes in this revision

Viewing changes to term-utils/wall.1

  • Committer: Package Import Robot
  • Author(s): LaMont Jones
  • Date: 2011-11-03 15:38:23 UTC
  • mto: (4.5.5 sid) (1.6.4)
  • mto: This revision was merged to the branch mainline in revision 85.
  • Revision ID: package-import@ubuntu.com-20111103153823-10sx16jprzxlhkqf
ImportĀ upstreamĀ versionĀ 2.20.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" Copyright (c) 1989, 1990 The Regents of the University of California.
 
2
.\" All rights reserved.
 
3
.\"
 
4
.\" Redistribution and use in source and binary forms, with or without
 
5
.\" modification, are permitted provided that the following conditions
 
6
.\" are met:
 
7
.\" 1. Redistributions of source code must retain the above copyright
 
8
.\"    notice, this list of conditions and the following disclaimer.
 
9
.\" 2. Redistributions in binary form must reproduce the above copyright
 
10
.\"    notice, this list of conditions and the following disclaimer in the
 
11
.\"    documentation and/or other materials provided with the distribution.
 
12
.\" 3. All advertising materials mentioning features or use of this software
 
13
.\"    must display the following acknowledgement:
 
14
.\"     This product includes software developed by the University of
 
15
.\"     California, Berkeley and its contributors.
 
16
.\" 4. Neither the name of the University nor the names of its contributors
 
17
.\"    may be used to endorse or promote products derived from this software
 
18
.\"    without specific prior written permission.
 
19
.\"
 
20
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 
21
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 
22
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 
23
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 
24
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 
25
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 
26
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 
27
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 
28
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 
29
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 
30
.\" SUCH DAMAGE.
 
31
.\"
 
32
.\"     @(#)wall.1      6.5 (Berkeley) 4/23/91
 
33
.\"
 
34
.\" Modified for Linux, Mon Mar  8 18:07:38 1993, faith@cs.unc.edu
 
35
.\"
 
36
.Dd April 2011 "  "
 
37
.Dt WALL(1) "" "User Commands"
 
38
.Os util-linux
 
39
.Sh NAME
 
40
.Nm wall
 
41
.Nd write a message to users
 
42
.Sh SYNOPSIS
 
43
.Nm wall
 
44
.Op Ar -n
 
45
.Op Ar -t TIMEOUT
 
46
.Op Ar file
 
47
.Sh DESCRIPTION
 
48
.Nm Wall
 
49
displays the contents of
 
50
.Ar file
 
51
or, by default, its standard input, on the terminals of all
 
52
currently logged in users. The command will cut over 79 character
 
53
long lines to new lines. Short lines are white space padded to
 
54
have 79 characters. The command will always put carriage return
 
55
and new line at the end of each line.
 
56
.Pp
 
57
Only the super-user can write on the
 
58
terminals of users who have chosen
 
59
to deny messages or are using a program which
 
60
automatically denies messages.
 
61
.Pp
 
62
Reading from a file is refused when the invoker is not superuser
 
63
and the program is suid or sgid.
 
64
.Sh OPTIONS
 
65
.Bl -tag -width Fl
 
66
.It Fl n, Fl Fl nobanner
 
67
Supress banner
 
68
.It Fl t, Fl Fl timeout Ar TIMEOUT
 
69
Write timeout to terminals in seconds. Argument must be positive
 
70
integer. Default value is 300 seconds, which is a legacy from
 
71
time when people ran terminals over modem lines.
 
72
.It Fl V, Fl Fl version
 
73
Output version and exit.
 
74
.It Fl h, Fl Fl help
 
75
Output help and exit.
 
76
.Sh SEE ALSO
 
77
.Xr mesg 1 ,
 
78
.Xr talk 1 ,
 
79
.Xr write 1 ,
 
80
.Xr shutdown 8
 
81
.Sh HISTORY
 
82
A
 
83
.Nm
 
84
command appeared in
 
85
.At v7 .
 
86
.Sh AVAILABILITY
 
87
The wall command is part of the util-linux package and is available from
 
88
ftp://ftp.kernel.org/pub/linux/utils/util-linux/.