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$
  34 .\"
  35 .Dd June 6, 1993
  36 .Dt TALK 1
  37 .Os BSD 4.2
  38 .Sh NAME
  39 .Nm talk
  40 .Nd talk to another user
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Ar person
  44 .Op Ar ttyname
  45 .Sh DESCRIPTION
  46 .Nm Talk
  47 is a visual communication program which copies lines from your
  48 terminal to that of another user.
  49 .Pp
  50 Options available:
  51 .Bl -tag -width ttyname
  52 .It Ar person
  53 If you wish to talk to someone on your own machine, then
  54 .Ar person
  55 is just the person's login name.  If you wish to talk to a user on
  56 another host, then
  57 .Ar person
  58 is of the form
  59 .Ql user@host
  60 or
  61 .Ql host!user
  62 or
  63 .Ql host:user .
  64 .It Ar ttyname
  65 If you wish to talk to a user who is logged in more than once, the
  66 .Ar ttyname
  67 argument may be used to indicate the appropriate terminal
  68 name, where
  69 .Ar ttyname
  70 is of the form
  71 .Ql ttyXX .
  72 .El
  73 .Pp
  74 When first called,
  75 .Nm
  76 sends the message
  77 .Bd -literal -offset indent -compact
  78 Message from TalkDaemon@his_machine...
  79 talk: connection requested by your_name@your_machine.
  80 talk: respond with: talk your_name@your_machine
  81 .Ed
  82 .Pp
  83 to the user you wish to talk to. At this point, the recipient
  84 of the message should reply by typing
  85 .Pp
  86 .Dl talk \ your_name@your_machine
  87 .Pp
  88 It doesn't matter from which machine the recipient replies, as
  89 long as his login-name is the same.  Once communication is established,
  90 the two parties may type simultaneously, with their output appearing
  91 in separate windows.  Typing control-L
  92 .Ql ^L
  93 will cause the screen to
  94 be reprinted, while your erase, kill, and word kill characters will
  95 behave normally.  To exit, just type your interrupt character;
  96 .Nm
  97 then moves the cursor to the bottom of the screen and restores the
  98 terminal to its previous state.
  99 .Pp
 100 Permission to talk may be denied or granted by use of the
 101 .Xr mesg 1
 102 command.  At the outset talking is allowed.  Certain commands, in
 103 particular
 104 .Xr nroff 1
 105 and
 106 .Xr pr 1 ,
 107 disallow messages in order to
 108 prevent messy output.
 109 .Pp
 110 .Sh FILES
 111 .Bl -tag -width /var/run/utmp -compact
 112 .It Pa /etc/hosts
 113 to find the recipient's machine
 114 .It Pa /var/run/utmp
 115 to find the recipient's tty
 116 .El
 117 .Sh SEE ALSO
 118 .Xr mail 1 ,
 119 .Xr mesg 1 ,
 120 .Xr who 1 ,
 121 .Xr write 1
 122 .Sh BUGS
 123 The version of
 124 .Xr talk 1
 125 released with
 126 .Bx 4.3
 127 uses a protocol that
 128 is incompatible with the protocol used in the version released with
 129 .Bx 4.2 .
 130 .Sh HISTORY
 131 The
 132 .Nm
 133 command appeared in
 134 .Bx 4.2 .