usr.bin/talk/talk.1

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