xref: /dragonfly/usr.bin/talk/talk.1 (revision 279dd846)
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. Neither the name of the University nor the names of its contributors
13.\"    may be used to endorse or promote products derived from this software
14.\"    without specific prior written permission.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.\"     @(#)talk.1	8.1 (Berkeley) 6/6/93
29.\" $FreeBSD: src/usr.bin/talk/talk.1,v 1.6.2.5 2002/07/15 07:57:15 keramida Exp $
30.\" $DragonFly: src/usr.bin/talk/talk.1,v 1.4 2006/02/17 19:39:11 swildner Exp $
31.\"
32.Dd June 6, 1993
33.Dt TALK 1
34.Os
35.Sh NAME
36.Nm talk
37.Nd talk to another user
38.Sh SYNOPSIS
39.Nm
40.Ar person
41.Op Ar ttyname
42.Sh DESCRIPTION
43The
44.Nm
45utility is a visual communication program which copies lines from your
46terminal to that of another user.
47.Pp
48Options available:
49.Bl -tag -width ttyname
50.It Ar person
51If you wish to talk to someone on your own machine, then
52.Ar person
53is just the person's login name.
54If you wish to talk to a user on
55another host, then
56.Ar person
57is of the form
58.Ql user@host
59or
60.Ql host!user
61or
62.Ql host:user .
63.It Ar ttyname
64If you wish to talk to a user who is logged in more than once, the
65.Ar ttyname
66argument may be used to indicate the appropriate terminal
67name, where
68.Ar ttyname
69is of the form
70.Ql ttyXX .
71.El
72.Pp
73When first called,
74.Nm
75sends the message
76.Bd -literal -offset indent -compact
77Message from TalkDaemon@his_machine...
78talk: connection requested by your_name@your_machine.
79talk: respond with: talk your_name@your_machine
80.Ed
81.Pp
82to the user you wish to talk to.
83At this point, the recipient
84of the message should reply by typing
85.Pp
86.Dl talk \ your_name@your_machine
87.Pp
88It doesn't matter from which machine the recipient replies, as
89long as his login-name is the same.
90Once communication is established,
91the two parties may type simultaneously, with their output appearing
92in separate windows.
93Typing control-L
94.Ql ^L
95will cause the screen to
96be reprinted.
97Typing control-D
98.Ql ^D
99will clear both parts of your screen to be cleared, while
100the control-D character will be sent to the remote side
101(and just displayed by this
102.Nm
103client).
104Your erase, kill, and word kill characters will
105behave normally.
106To exit, just type your interrupt character;
107.Nm
108then moves the cursor to the bottom of the screen and restores the
109terminal to its previous state.
110.Pp
111Permission to talk may be denied or granted by use of the
112.Xr mesg 1
113command.
114At the outset talking is allowed.
115.Sh FILES
116.Bl -tag -width /var/run/utmp -compact
117.It Pa /etc/hosts
118to find the recipient's machine
119.It Pa /var/run/utmp
120to find the recipient's tty
121.El
122.Sh SEE ALSO
123.Xr mail 1 ,
124.Xr mesg 1 ,
125.Xr wall 1 ,
126.Xr who 1 ,
127.Xr write 1 ,
128.Xr talkd 8
129.Sh HISTORY
130The
131.Nm
132command appeared in
133.Bx 4.2 .
134.Sh BUGS
135The version of
136.Nm
137released with
138.Bx 4.3
139uses a protocol that
140is incompatible with the protocol used in the version released with
141.Bx 4.2 .
142