share/man/man1/talk.1

   1 .\"
   2 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for
   3 .\" permission to reproduce portions of its copyrighted documentation.
   4 .\" Original documentation from The Open Group can be obtained online at
   5 .\" http://www.opengroup.org/bookstore/.
   6 .\"
   7 .\" The Institute of Electrical and Electronics Engineers and The Open
   8 .\" Group, have given us permission to reprint portions of their
   9 .\" documentation.
  10 .\"
  11 .\" In the following statement, the phrase ``this text'' refers to portions
  12 .\" of the system documentation.
  13 .\"
  14 .\" Portions of this text are reprinted and reproduced in electronic form
  15 .\" in the SunOS Reference Manual, from IEEE Std 1003.1, 2004 Edition,
  16 .\" Standard for Information Technology -- Portable Operating System
  17 .\" Interface (POSIX), The Open Group Base Specifications Issue 6,
  18 .\" Copyright (C) 2001-2004 by the Institute of Electrical and Electronics
  19 .\" Engineers, Inc and The Open Group.  In the event of any discrepancy
  20 .\" between these versions and the original IEEE and The Open Group
  21 .\" Standard, the original IEEE and The Open Group Standard is the referee
  22 .\" document.  The original Standard can be obtained online at
  23 .\" http://www.opengroup.org/unix/online.html.
  24 .\"
  25 .\" This notice shall appear on any product containing this material.
  26 .\"
  27 .\" The contents of this file are subject to the terms of the
  28 .\" Common Development and Distribution License (the "License").
  29 .\" You may not use this file except in compliance with the License.
  30 .\"
  31 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  32 .\" or http://www.opensolaris.org/os/licensing.
  33 .\" See the License for the specific language governing permissions
  34 .\" and limitations under the License.
  35 .\"
  36 .\" When distributing Covered Code, include this CDDL HEADER in each
  37 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  38 .\" If applicable, add the following below this CDDL HEADER, with the
  39 .\" fields enclosed by brackets "[]" replaced with your own identifying
  40 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  41 .\"
  42 .\"
  43 .\" Copyright 1989 AT&T
  44 .\" Portions Copyright (c) 1992, X/Open Company Limited  All Rights Reserved
  45 .\" Copyright (c) 2000, Sun Microsystems, Inc.  All Rights Reserved
  46 .\"
  47 .TH TALK 1 "Nov 6, 2000"
  48 .SH NAME
  49 talk \- talk to another user
  50 .SH SYNOPSIS
  51 .LP
  52 .nf
  53 \fBtalk\fR \fIaddress\fR [\fIterminal\fR]
  54 .fi
  55
  56 .SH DESCRIPTION
  57 .sp
  58 .LP
  59 The \fBtalk\fR utility is a two-way, screen-oriented communication program.
  60 .sp
  61 .LP
  62 When first invoked, \fBtalk\fR sends a message similar to:
  63 .sp
  64 .in +2
  65 .nf
  66 Message from TalkDaemon@ \fIher_machine\fR at \fItime .\|.\|.\fR
  67 talk: connection requested by \fIyour_address\fR
  68 talk: respond with: talk \fIyour_address\fR
  69 .fi
  70 .in -2
  71 .sp
  72
  73 .sp
  74 .LP
  75 to the specified \fIaddress\fR. At this point, the recipient of the message can
  76 reply by typing:
  77 .sp
  78 .in +2
  79 .nf
  80 talk \fIyour_address\fR
  81 .fi
  82 .in -2
  83 .sp
  84
  85 .sp
  86 .LP
  87 Once communication is established, the two parties can type simultaneously,
  88 with their output displayed in separate regions of the screen. Characters are
  89 processed as follows:
  90 .RS +4
  91 .TP
  92 .ie t \(bu
  93 .el o
  94 Typing the alert character will alert the recipient's terminal.
  95 .RE
  96 .RS +4
  97 .TP
  98 .ie t \(bu
  99 .el o
 100 Typing Control-L will cause the sender's screen regions to be refreshed.
 101 .RE
 102 .RS +4
 103 .TP
 104 .ie t \(bu
 105 .el o
 106 Typing the erase and kill characters will affect the sender's terminal in the
 107 manner described by the \fBtermios\fR(3C) interface.
 108 .RE
 109 .RS +4
 110 .TP
 111 .ie t \(bu
 112 .el o
 113 Typing the interrupt or end-of-file (\fBEOF\fR) characters will terminate the
 114 local \fBtalk\fR utility. Once the \fBtalk\fR session has been terminated on
 115 one side, the other side of the \fBtalk\fR session will be notified that the
 116 \fBtalk\fR session has been terminated and will be able to do nothing except
 117 exit.
 118 .RE
 119 .RS +4
 120 .TP
 121 .ie t \(bu
 122 .el o
 123 Typing characters from \fBLC_CTYPE\fR classifications \fBprint\fR or
 124 \fBspace\fR will cause those characters to be sent to the recipient's terminal.
 125 .RE
 126 .RS +4
 127 .TP
 128 .ie t \(bu
 129 .el o
 130 When and only when the \fBstty\fR \fBiexten\fR local mode is enabled,
 131 additional special control characters and multi-byte or single-byte characters
 132 are processed as printable characters if their wide character equivalents are
 133 printable.
 134 .RE
 135 .RS +4
 136 .TP
 137 .ie t \(bu
 138 .el o
 139 Typing other non-printable characters will cause them to be written to the
 140 recipient's terminal as follows: control characters will appear as a caret
 141 (\|\fB^\fR\|) followed by the appropriate \fBASCII\fR character, and characters
 142 with the high-order bit set will appear in "meta" notation. For example,
 143 `\fB\e003\fR\&' is displayed as `\fB^C\fR' and `\fB\e372\fR\&' as
 144 `\fBM\(miz\fR'.
 145 .RE
 146 .sp
 147 .LP
 148 Permission to be a recipient of a \fBtalk\fR message can be denied or granted
 149 by use of the \fBmesg\fR(1) utility. However, a user's privilege may further
 150 constrain the domain of accessibility of other users' terminals. Certain
 151 commands, such as \fBpr\fR(1), disallow messages in order to prevent
 152 interference with their output. \fBtalk\fR will fail when the user lacks the
 153 appropriate privileges to perform the requested action.
 154 .sp
 155 .LP
 156 Certain block-mode terminals do not have all the capabilities necessary to
 157 support the simultaneous exchange of messages required for \fBtalk\fR. When
 158 this type of exchange cannot be supported on such terminals, the implementation
 159 may support an exchange with reduced levels of simultaneous interaction or it
 160 may report an error describing the terminal-related deficiency.
 161 .SH OPERANDS
 162 .sp
 163 .LP
 164 The following operands are supported:
 165 .sp
 166 .ne 2
 167 .na
 168 \fB\fIaddress\fR\fR
 169 .ad
 170 .RS 12n
 171 The recipient of the \fBtalk\fR session. One form of \fIaddress\fR is the
 172 \fIusername\fR, as returned by the \fBwho\fR(1) utility. If you wish to talk to
 173 someone on your own machine, then \fIusername\fR is just the person's login
 174 name. If you wish to talk to a user on another host, then \fIusername\fR is one
 175 of the following forms:
 176 .sp
 177 .in +2
 178 .nf
 179 \fIhost\fR\fB!\fR\fIuser\fR
 180 \fIhost\fR\fB\&.\fR\fIuser\fR
 181 \fIhost\fR\fB:\fR\fIuser\fR
 182 \fIuser\fR\fB@\fR\fIhost\fR
 183 .fi
 184 .in -2
 185 .sp
 186
 187 although \fIuser\fR\fB@\fR\fIhost\fR is perhaps preferred.
 188 .RE
 189
 190 .sp
 191 .ne 2
 192 .na
 193 \fB\fIterminal\fR\fR
 194 .ad
 195 .RS 12n
 196 If the recipient is logged in more than once, \fIterminal\fR can be used to
 197 indicate the appropriate terminal name. If \fIterminal\fR is not specified, the
 198 \fBtalk\fR message will be displayed on one or more accessible terminals in use
 199 by the recipient. The format of \fIterminal\fR will be the same as that
 200 returned by  \fBwho\fR.
 201 .RE
 202
 203 .SH ENVIRONMENT VARIABLES
 204 .sp
 205 .LP
 206 See \fBenviron\fR(5) for descriptions of the following environment variables
 207 that affect the execution of \fBtalk\fR: \fBLANG\fR, \fBLC_ALL\fR,
 208 \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
 209 .sp
 210 .ne 2
 211 .na
 212 \fB\fBTERM\fR\fR
 213 .ad
 214 .RS 8n
 215 Determine the name of the invoker's terminal type.  If this variable is unset
 216 or null, an unspecified terminal type will be used.
 217 .RE
 218
 219 .SH EXIT STATUS
 220 .sp
 221 .LP
 222 The following exit values are returned:
 223 .sp
 224 .ne 2
 225 .na
 226 \fB\fB0\fR\fR
 227 .ad
 228 .RS 6n
 229 Successful completion.
 230 .RE
 231
 232 .sp
 233 .ne 2
 234 .na
 235 \fB\fB>0\fR\fR
 236 .ad
 237 .RS 6n
 238 An error occurred, or \fBtalk\fR was invoked on a terminal incapable of
 239 supporting it.
 240 .RE
 241
 242 .SH FILES
 243 .sp
 244 .ne 2
 245 .na
 246 \fB\fB/etc/hosts\fR\fR
 247 .ad
 248 .RS 18n
 249 host name database
 250 .RE
 251
 252 .sp
 253 .ne 2
 254 .na
 255 \fB\fB/var/log/utmpx\fR\fR
 256 .ad
 257 .RS 18n
 258 user and accounting information for \fBtalk\fR
 259 .RE
 260
 261 .SH ATTRIBUTES
 262 .sp
 263 .LP
 264 See \fBattributes\fR(5) for descriptions of the following attributes:
 265 .sp
 266
 267 .sp
 268 .TS
 269 box;
 270 c | c
 271 l | l .
 272 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 273 _
 274 Interface Stability     Standard
 275 .TE
 276
 277 .SH SEE ALSO
 278 .sp
 279 .LP
 280 \fBmail\fR(1), \fBmesg\fR(1), \fBpr\fR(1), \fBstty\fR(1), \fBwho\fR(1),
 281 \fBwrite\fR(1), \fBtermios\fR(3C), \fBattributes\fR(5), \fBenviron\fR(5),
 282 \fBstandards\fR(5)
 283 .SH NOTES
 284 .sp
 285 .LP
 286 Typing Control-L redraws the screen, while the erase, kill, and word kill
 287 characters will work in \fBtalk\fR as normal. To exit, type an interrupt
 288 character. \fBtalk\fR then moves the cursor to the bottom of the screen and
 289 restores the terminal to its previous state.