usr.bin/talk/talk.1

   1 .\"     $NetBSD: talk.1,v 1.8 2003/08/07 11:16:05 agc 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. Neither the name of the University nor the names of its contributors
  15 .\"    may be used to endorse or promote products derived from this software
  16 .\"    without specific prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28 .\" SUCH DAMAGE.
  29 .\"
  30 .\"     @(#)talk.1      8.1 (Berkeley) 6/6/93
  31 .\"
  32 .Dd January 7, 2007
  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
  43 .Nm
  44 is a visual communication program which copies lines from your
  45 terminal to that of another user.
  46 .Pp
  47 Options available:
  48 .Bl -tag -width ttyname
  49 .It Ar person
  50 If you wish to talk to someone on your own machine, then
  51 .Ar person
  52 is just the person's login name.
  53 If you wish to talk to a user on another host, then
  54 .Ar person
  55 is of the form
  56 .Ql user@host .
  57 .It Ar ttyname
  58 If you wish to talk to a user who is logged in more than once, the
  59 .Ar ttyname
  60 argument may be used to indicate the appropriate terminal
  61 name, where
  62 .Ar ttyname
  63 is of the form
  64 .Ql ttyXX .
  65 .El
  66 .Pp
  67 When first called,
  68 .Nm
  69 sends the message
  70 .Bd -literal -offset indent -compact
  71 Message from TalkDaemon@his_machine...
  72 talk: connection requested by your_name@your_machine.
  73 talk: respond with: talk your_name@your_machine
  74 .Ed
  75 .Pp
  76 to the user you wish to talk to.
  77 At this point, the recipient
  78 of the message should reply by typing
  79 .Pp
  80 .Dl talk \ your_name@your_machine
  81 .Pp
  82 It doesn't matter from which machine the recipient replies, as
  83 long as his login-name is the same.
  84 Once communication is established,
  85 the two parties may type simultaneously, with their output appearing
  86 in separate windows.
  87 Typing control-L
  88 .Ql ^L
  89 will cause the screen to
  90 be reprinted, while your erase, kill, and word kill characters will
  91 behave normally.
  92 To exit, just type your interrupt character;
  93 .Nm
  94 then moves the cursor to the bottom of the screen and restores the
  95 terminal to its previous state.
  96 .Pp
  97 Permission to talk may be denied or granted by use of the
  98 .Xr mesg 1
  99 command.
 100 At the outset talking is allowed.
 101 Certain commands, in
 102 particular
 103 .Xr nroff 1
 104 and
 105 .Xr pr 1 ,
 106 disallow messages in order to
 107 prevent messy output.
 108 .Sh ENVIRONMENT
 109 If the
 110 .Ev TALKHOST
 111 environment variable is set, its value is used as the
 112 .Ar hostname
 113 the
 114 .Nm
 115 packets appear to be originating from.
 116 This is useful if you wish to talk to someone on another machine and
 117 your internal hostname does not resolve to the address of your
 118 external interface as seen from the other machine.
 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 who 1 ,
 130 .Xr write 1
 131 .Sh HISTORY
 132 The
 133 .Nm
 134 command appeared in
 135 .Bx 4.2 .
 136 .Sh BUGS
 137 The version of
 138 .Nm
 139 released with
 140 .Bx 4.3
 141 uses a protocol that
 142 is incompatible with the protocol used in the version released with
 143 .Bx 4.2 .