xref: /netbsd-src/usr.bin/talk/talk.1 (revision 001c68bd94f75ce9270b69227c4199fbf34ee396)
1.\"	$NetBSD: talk.1,v 1.7 2002/09/30 11:09:12 grant Exp $
2.\"
3.\" Copyright (c) 1983, 1990, 1993
4.\"	The Regents of the University of California.  All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"	This product includes software developed by the University of
17.\"	California, Berkeley and its contributors.
18.\" 4. Neither the name of the University nor the names of its contributors
19.\"    may be used to endorse or promote products derived from this software
20.\"    without specific prior written permission.
21.\"
22.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32.\" SUCH DAMAGE.
33.\"
34.\"     @(#)talk.1	8.1 (Berkeley) 6/6/93
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
47.Nm
48is 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.
57If you wish to talk to a user on another host, then
58.Ar person
59is of the form
60.Ql user@host .
61.It Ar ttyname
62If you wish to talk to a user who is logged in more than once, the
63.Ar ttyname
64argument may be used to indicate the appropriate terminal
65name, where
66.Ar ttyname
67is of the form
68.Ql ttyXX .
69.El
70.Pp
71When first called,
72.Nm
73sends the message
74.Bd -literal -offset indent -compact
75Message from TalkDaemon@his_machine...
76talk: connection requested by your_name@your_machine.
77talk: respond with: talk your_name@your_machine
78.Ed
79.Pp
80to the user you wish to talk to.
81At this point, the recipient
82of the message should reply by typing
83.Pp
84.Dl talk \ your_name@your_machine
85.Pp
86It doesn't matter from which machine the recipient replies, as
87long as his login-name is the same.
88Once communication is established,
89the two parties may type simultaneously, with their output appearing
90in separate windows.
91Typing control-L
92.Ql ^L
93will cause the screen to
94be reprinted, while your erase, kill, and word kill characters will
95behave normally.
96To exit, just type your interrupt character;
97.Nm
98then moves the cursor to the bottom of the screen and restores the
99terminal to its previous state.
100.Pp
101Permission to talk may be denied or granted by use of the
102.Xr mesg 1
103command.
104At the outset talking is allowed.
105Certain commands, in
106particular
107.Xr nroff 1
108and
109.Xr pr 1 ,
110disallow messages in order to
111prevent messy output.
112.Sh FILES
113.Bl -tag -width /var/run/utmp -compact
114.It Pa /etc/hosts
115to find the recipient's machine
116.It Pa /var/run/utmp
117to find the recipient's tty
118.El
119.Sh SEE ALSO
120.Xr mail 1 ,
121.Xr mesg 1 ,
122.Xr who 1 ,
123.Xr write 1
124.Sh HISTORY
125The
126.Nm
127command appeared in
128.Bx 4.2 .
129.Sh BUGS
130The version of
131.Xr talk 1
132released with
133.Bx 4.3
134uses a protocol that
135is incompatible with the protocol used in the version released with
136.Bx 4.2 .
137