1.\" $OpenBSD: talk.1,v 1.25 2010/10/28 21:32:54 jmc Exp $ 2.\" $NetBSD: talk.1,v 1.3 1994/12/09 02:14:23 jtc Exp $ 3.\" 4.\" Copyright (c) 1983, 1990, 1993 5.\" The Regents of the University of California. All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 3. Neither the name of the University nor the names of its contributors 16.\" may be used to endorse or promote products derived from this software 17.\" without specific prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.\" @(#)talk.1 8.1 (Berkeley) 6/6/93 32.\" 33.Dd $Mdocdate: October 28 2010 $ 34.Dt TALK 1 35.Os 36.Sh NAME 37.Nm talk 38.Nd talk to another user 39.Sh SYNOPSIS 40.Nm talk 41.Op Fl Hs 42.Ar person 43.Op Ar ttyname 44.Sh DESCRIPTION 45.Nm 46is a visual communication program which copies lines from your 47terminal to that of another user. 48.Pp 49The command arguments are as follows: 50.Bl -tag -width ttyname 51.It Fl H 52Don't escape characters with the high bit set. 53This may be useful for certain character sets, but could cause erratic 54behaviour on some terminals. 55.It Fl s 56Use smooth scrolling in the 57.Nm 58window. 59The default is to clear the next two rows and jump from the bottom of 60the window to the top. 61.It Ar person 62If you wish to talk to someone on your own machine, then 63.Ar person 64is just the person's login name. 65If you wish to talk to a user on another host, then 66.Ar person 67is of the form 68.Ql user@host . 69.It Ar ttyname 70If you wish to talk to a user who is logged in more than once, the 71.Ar ttyname 72argument may be used to indicate the appropriate terminal 73name, where 74.Ar ttyname 75is of the form 76.Ql ttyXX . 77.El 78.Pp 79When first called, 80.Nm 81sends the message 82.Bd -literal -offset indent 83Message from Talk_Daemon@localhost... 84talk: connection requested by your_name@your_machine. 85talk: respond with: talk your_name@your_machine 86.Ed 87.Pp 88to the user you wish to talk to. 89At this point, the recipient of the message should reply by typing 90.Pp 91.Dl $ talk \ your_name@your_machine 92.Pp 93It doesn't matter from which machine the recipient replies, as 94long as the login name is the same. 95If the machine is not the one to which 96the talk request was sent, it is noted on the screen. 97Once communication is established, 98the two parties may type simultaneously, with their output appearing 99in separate windows. 100Typing control-L 101.Pq Ql ^L 102will cause the screen to 103be reprinted, while the erase, kill, and word kill characters will 104behave normally. 105To exit, just type the interrupt character; 106.Nm 107then moves the cursor to the bottom of the screen and restores the 108terminal to its previous state. 109.Pp 110Permission to talk may be denied or granted by use of the 111.Xr mesg 1 112command. 113At the outset talking is allowed. 114Certain commands, such as 115.Xr pr 1 , 116disallow messages in order to 117prevent messy output. 118.Sh FILES 119.Bl -tag -width /var/run/utmp -compact 120.It Pa /etc/hosts 121to find the recipient's machine 122.It Pa /var/run/utmp 123to find the recipient's tty 124.El 125.Sh EXIT STATUS 126The 127.Nm 128utility exits 0 on success, and \*(Gt0 if either an error occurred or 129.Nm 130is 131invoked on an unsupported terminal. 132.Sh SEE ALSO 133.Xr mail 1 , 134.Xr mesg 1 , 135.Xr who 1 , 136.Xr write 1 , 137.Xr talkd 8 138.Sh STANDARDS 139The 140.Nm 141utility is compliant with the 142.St -p1003.1-2008 143specification, 144though its presence is optional. 145.Pp 146The flags 147.Op Fl Hs 148are extensions to that specification. 149.Sh HISTORY 150The 151.Nm 152command appeared in 153.Bx 4.2 . 154.Sh BUGS 155The version of 156.Nm talk 157released with 158.Bx 4.3 159uses a protocol that 160is incompatible with the protocol used in the version released with 161.Bx 4.2 . 162