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.
  84 At this point, the recipient
  85 of the message should reply by typing
  86 .Pp
  87 .Dl talk \ your_name@your_machine
  88 .Pp
  89 It doesn't matter from which machine the recipient replies, as
  90 long as his login-name is the same.  Once communication is established,
  91 the two parties may type simultaneously, with their output appearing
  92 in separate windows.  Typing control-L
  93 .Ql ^L
  94 will cause the screen to
  95 be reprinted, while your erase, kill, and word kill characters will
  96 behave normally.  To exit, just type your interrupt character;
  97 .Nm
  98 then moves the cursor to the bottom of the screen and restores the
  99 terminal to its previous state.
 100 .Pp
 101 Permission to talk may be denied or granted by use of the
 102 .Xr mesg 1
 103 command.  At the outset talking is allowed.  Certain commands, in
 104 particular
 105 .Xr nroff 1
 106 and
 107 .Xr pr 1 ,
 108 disallow messages in order to
 109 prevent messy output.
 110 .Pp
 111 .Sh FILES
 112 .Bl -tag -width /var/run/utmp -compact
 113 .It Pa /etc/hosts
 114 to find the recipient's machine
 115 .It Pa /var/run/utmp
 116 to find the recipient's tty
 117 .El
 118 .Sh SEE ALSO
 119 .Xr mail 1 ,
 120 .Xr mesg 1 ,
 121 .Xr who 1 ,
 122 .Xr write 1
 123 .Sh BUGS
 124 The version of
 125 .Xr talk 1
 126 released with
 127 .Bx 4.3
 128 uses a protocol that
 129 is incompatible with the protocol used in the version released with
 130 .Bx 4.2 .
 131 .Sh HISTORY
 132 The
 133 .Nm
 134 command appeared in
 135 .Bx 4.2 .