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