xref: /freebsd/usr.bin/talk/talk.1 (revision 3ff369fed2a08f32dda232c10470b949bef9489f)
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$
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
46The
47.Nm
48utility is a visual communication program which copies lines from your
49terminal to that of another user.
50.Pp
51Options available:
52.Bl -tag -width ttyname
53.It Ar person
54If you wish to talk to someone on your own machine, then
55.Ar person
56is just the person's login name.  If you wish to talk to a user on
57another host, then
58.Ar person
59is of the form
60.Ql user@host
61or
62.Ql host!user
63or
64.Ql host:user .
65.It Ar ttyname
66If you wish to talk to a user who is logged in more than once, the
67.Ar ttyname
68argument may be used to indicate the appropriate terminal
69name, where
70.Ar ttyname
71is of the form
72.Ql ttyXX .
73.El
74.Pp
75When first called,
76.Nm
77sends the message
78.Bd -literal -offset indent -compact
79Message from TalkDaemon@his_machine...
80talk: connection requested by your_name@your_machine.
81talk: respond with: talk your_name@your_machine
82.Ed
83.Pp
84to the user you wish to talk to.
85At this point, the recipient
86of the message should reply by typing
87.Pp
88.Dl talk \ your_name@your_machine
89.Pp
90It doesn't matter from which machine the recipient replies, as
91long as his login-name is the same.  Once communication is established,
92the two parties may type simultaneously, with their output appearing
93in separate windows.  Typing control-L
94.Ql ^L
95will cause the screen to
96be reprinted, while your erase, kill, and word kill characters will
97behave normally.  To exit, just type your interrupt character;
98.Nm
99then moves the cursor to the bottom of the screen and restores the
100terminal to its previous state.
101.Pp
102Permission to talk may be denied or granted by use of the
103.Xr mesg 1
104command.  At the outset talking is allowed.
105.Sh FILES
106.Bl -tag -width /var/run/utmp -compact
107.It Pa /etc/hosts
108to find the recipient's machine
109.It Pa /var/run/utmp
110to find the recipient's tty
111.El
112.Sh SEE ALSO
113.Xr mail 1 ,
114.Xr mesg 1 ,
115.Xr wall 1 ,
116.Xr who 1 ,
117.Xr write 1
118.Sh BUGS
119The version of
120.Xr talk 1
121released with
122.Bx 4.3
123uses a protocol that
124is incompatible with the protocol used in the version released with
125.Bx 4.2 .
126.Sh HISTORY
127The
128.Nm
129command appeared in
130.Bx 4.2 .
131