[BACK]Return to talk.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / talk

Annotation of src/usr.bin/talk/talk.1, Revision 1.23

1.23    ! jmc         1: .\"    $OpenBSD: talk.1,v 1.22 2009/02/08 17:15:10 jmc Exp $
1.1       deraadt     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.
1.17      millert    15: .\" 3. Neither the name of the University nor the names of its contributors
1.1       deraadt    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: .\"
1.23    ! jmc        33: .Dd $Mdocdate: February 8 2009 $
1.1       deraadt    34: .Dt TALK 1
1.6       aaron      35: .Os
1.1       deraadt    36: .Sh NAME
                     37: .Nm talk
                     38: .Nd talk to another user
                     39: .Sh SYNOPSIS
                     40: .Nm talk
1.14      millert    41: .Op Fl Hs
1.1       deraadt    42: .Ar person
                     43: .Op Ar ttyname
                     44: .Sh DESCRIPTION
1.10      aaron      45: .Nm
1.1       deraadt    46: is a visual communication program which copies lines from your
                     47: terminal to that of another user.
                     48: .Pp
1.8       aaron      49: The command arguments are as follows:
1.1       deraadt    50: .Bl -tag -width ttyname
1.14      millert    51: .It Fl H
1.16      fgsch      52: Don't escape characters with the high bit set.
1.18      jmc        53: This may be useful for certain character sets, but could cause erratic
1.14      millert    54: behaviour on some terminals.
                     55: .It Fl s
                     56: Use smooth scrolling in the
                     57: .Nm
                     58: window.
                     59: The default is to clear the next two rows and jump from the bottom of
                     60: the window to the top.
1.1       deraadt    61: .It Ar person
                     62: If you wish to talk to someone on your own machine, then
                     63: .Ar person
1.10      aaron      64: is just the person's login name.
                     65: If you wish to talk to a user on another host, then
1.1       deraadt    66: .Ar person
                     67: is of the form
                     68: .Ql user@host .
                     69: .It Ar ttyname
                     70: If you wish to talk to a user who is logged in more than once, the
                     71: .Ar ttyname
                     72: argument may be used to indicate the appropriate terminal
                     73: name, where
                     74: .Ar ttyname
                     75: is of the form
                     76: .Ql ttyXX .
                     77: .El
                     78: .Pp
                     79: When first called,
1.10      aaron      80: .Nm
1.1       deraadt    81: sends the message
1.19      jmc        82: .Bd -literal -offset indent
1.5       pjanzen    83: Message from Talk_Daemon@localhost...
1.1       deraadt    84: talk: connection requested by your_name@your_machine.
                     85: talk: respond with: talk your_name@your_machine
                     86: .Ed
                     87: .Pp
1.11      aaron      88: to the user you wish to talk to.
                     89: At this point, the recipient of the message should reply by typing
1.1       deraadt    90: .Pp
1.15      deraadt    91: .Dl $ talk \ your_name@your_machine
1.1       deraadt    92: .Pp
                     93: It doesn't matter from which machine the recipient replies, as
1.10      aaron      94: long as the login name is the same.
                     95: If the machine is not the one to which
1.3       pjanzen    96: the talk request was sent, it is noted on the screen.
                     97: Once communication is established,
1.1       deraadt    98: the two parties may type simultaneously, with their output appearing
1.10      aaron      99: in separate windows.
                    100: Typing control-L
                    101: .Pq Ql ^L
1.1       deraadt   102: will cause the screen to
1.12      aaron     103: be reprinted, while the erase, kill, and word kill characters will
1.10      aaron     104: behave normally.
1.12      aaron     105: To exit, just type the interrupt character;
1.10      aaron     106: .Nm
1.1       deraadt   107: then moves the cursor to the bottom of the screen and restores the
                    108: terminal to its previous state.
                    109: .Pp
                    110: Permission to talk may be denied or granted by use of the
                    111: .Xr mesg 1
1.10      aaron     112: command.
                    113: At the outset talking is allowed.
                    114: Certain commands, in particular
1.1       deraadt   115: .Xr nroff 1
                    116: and
                    117: .Xr pr 1 ,
                    118: disallow messages in order to
                    119: prevent messy output.
                    120: .Sh FILES
                    121: .Bl -tag -width /var/run/utmp -compact
                    122: .It Pa /etc/hosts
                    123: to find the recipient's machine
                    124: .It Pa /var/run/utmp
                    125: to find the recipient's tty
                    126: .El
                    127: .Sh SEE ALSO
                    128: .Xr mail 1 ,
                    129: .Xr mesg 1 ,
                    130: .Xr who 1 ,
1.19      jmc       131: .Xr write 1 ,
                    132: .Xr talkd 8
1.20      jmc       133: .Sh STANDARDS
                    134: The
                    135: .Nm
                    136: utility is compliant with the
1.22      jmc       137: .St -p1003.1-2008
1.20      jmc       138: specification,
1.23    ! jmc       139: though its presence is optional.
1.20      jmc       140: .Pp
                    141: The flags
                    142: .Op Fl Hs
                    143: are extensions to that specification.
1.9       aaron     144: .Sh HISTORY
                    145: The
                    146: .Nm
                    147: command appeared in
                    148: .Bx 4.2 .
1.1       deraadt   149: .Sh BUGS
                    150: The version of
1.18      jmc       151: .Nm talk
1.1       deraadt   152: released with
                    153: .Bx 4.3
                    154: uses a protocol that
                    155: is incompatible with the protocol used in the version released with
                    156: .Bx 4.2 .