Initial import from FreeBSD RELENG_4:
[games.git] / usr.bin / talk / talk.1
1 .\" Copyright (c) 1983, 1990, 1993
2 .\"     The Regents of the University of California.  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 .\"     @(#)talk.1      8.1 (Berkeley) 6/6/93
33 .\" $FreeBSD: src/usr.bin/talk/talk.1,v 1.6.2.5 2002/07/15 07:57:15 keramida Exp $
34 .\"
35 .Dd June 6, 1993
36 .Dt TALK 1
37 .Os
38 .Sh NAME
39 .Nm talk
40 .Nd talk to another user
41 .Sh SYNOPSIS
42 .Nm
43 .Ar person
44 .Op Ar ttyname
45 .Sh DESCRIPTION
46 The
47 .Nm
48 utility is a visual communication program which copies lines from your
49 terminal to that of another user.
50 .Pp
51 Options available:
52 .Bl -tag -width ttyname
53 .It Ar person
54 If you wish to talk to someone on your own machine, then
55 .Ar person
56 is just the person's login name.
57 If you wish to talk to a user on
58 another host, then
59 .Ar person
60 is of the form
61 .Ql user@host
62 or
63 .Ql host!user
64 or
65 .Ql host:user .
66 .It Ar ttyname
67 If you wish to talk to a user who is logged in more than once, the
68 .Ar ttyname
69 argument may be used to indicate the appropriate terminal
70 name, where
71 .Ar ttyname
72 is of the form
73 .Ql ttyXX .
74 .El
75 .Pp
76 When first called,
77 .Nm
78 sends the message
79 .Bd -literal -offset indent -compact
80 Message from TalkDaemon@his_machine...
81 talk: connection requested by your_name@your_machine.
82 talk: respond with: talk your_name@your_machine
83 .Ed
84 .Pp
85 to the user you wish to talk to.
86 At this point, the recipient
87 of the message should reply by typing
88 .Pp
89 .Dl talk \ your_name@your_machine
90 .Pp
91 It doesn't matter from which machine the recipient replies, as
92 long as his login-name is the same.
93 Once communication is established,
94 the two parties may type simultaneously, with their output appearing
95 in separate windows.
96 Typing control-L
97 .Ql ^L
98 will cause the screen to
99 be reprinted, while your erase, kill, and word kill characters will
100 behave normally.
101 To exit, just type your interrupt character;
102 .Nm
103 then moves the cursor to the bottom of the screen and restores the
104 terminal to its previous state.
105 .Pp
106 Permission to talk may be denied or granted by use of the
107 .Xr mesg 1
108 command.
109 At the outset talking is allowed.
110 Certain commands, in
111 particular
112 .Xr nroff 1
113 and
114 .Xr pr 1 ,
115 disallow messages in order to
116 prevent messy output.
117 .Sh FILES
118 .Bl -tag -width /var/run/utmp -compact
119 .It Pa /etc/hosts
120 to find the recipient's machine
121 .It Pa /var/run/utmp
122 to find the recipient's tty
123 .El
124 .Sh SEE ALSO
125 .Xr mail 1 ,
126 .Xr mesg 1 ,
127 .Xr wall 1 ,
128 .Xr who 1 ,
129 .Xr write 1
130 .Sh BUGS
131 The version of
132 .Xr talk 1
133 released with
134 .Bx 4.3
135 uses a protocol that
136 is incompatible with the protocol used in the version released with
137 .Bx 4.2 .
138 .Sh HISTORY
139 The
140 .Nm
141 command appeared in
142 .Bx 4.2 .