manual/netkit/original/man1/write.1

   1 .\" Copyright (c) 1989 The Regents of the University of California.
   2 .\" All rights reserved.
   3 .\"
   4 .\" This code is derived from software contributed to Berkeley by
   5 .\" Jef Poskanzer and Craig Leres of the Lawrence Berkeley Laboratory.
   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.
  15 .\" 3. All advertising materials mentioning features or use of this software
  16 .\"    must display the following acknowledgement:
  17 .\"     This product includes software developed by the University of
  18 .\"     California, Berkeley and its contributors.
  19 .\" 4. Neither the name of the University nor the names of its contributors
  20 .\"    may be used to endorse or promote products derived from this software
  21 .\"    without specific prior written permission.
  22 .\"
  23 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  24 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  25 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  26 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  27 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  28 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  29 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  30 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  31 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  32 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  33 .\" SUCH DAMAGE.
  34 .\"
  35 .\" Portions of the code documented by this man page are
  36 .\" Copyright (C) 1991 by the Massachusetts Institute of Technology.
  37 .\" Please see the file COPYING for details.
  38 .\"
  39 .\"
  40 .\"     @(#)write.1     6.5 (Berkeley) 4/24/91
  41 .\"
  42 .\" Modified for Linux, Mon Mar  8 18:22:44 1993, faith@cs.unc.edu
  43 .\" Modified to describe network write, Apr 29 1996, dholland@hcs.harvard.edu
  44 .\"
  45 .Dd August 15, 1999
  46 .Dt WRITE 1
  47 .Os "Linux NetKit (0.17)"
  48 .Sh NAME
  49 .Nm write
  50 .Nd send a message to another user
  51 .Sh SYNOPSIS
  52 .Nm write
  53 .Ar user[@host]
  54 .Op Ar ttyname
  55 .Sh DESCRIPTION
  56 .Nm Write
  57 allows you to communicate with other users, by copying lines from your
  58 terminal to theirs, possibly across the netwoerk.
  59 .Pp
  60 When you run the
  61 .Nm write
  62 command, the user you are writing to gets a message of the form:
  63 .Pp
  64 .Dl Message from yourname@yourhost on yourtty at hh:mm ...
  65 .Pp
  66 Any further lines you enter will be copied to the specified user's
  67 terminal as you finish typing them.
  68 If the other user wants to reply, they must run
  69 .Nm write
  70 as well.
  71 .Pp
  72 When you are done, type an end-of-file or interrupt character.
  73 The other user will see the message
  74 .Ql EOF
  75 indicating that the
  76 conversation is over.
  77 .Pp
  78 You can prevent people (other than the super-user) from writing to you
  79 with the
  80 .Xr mesg 1
  81 command.
  82 Some commands, for example
  83 .Xr nroff 1
  84 and
  85 .Xr pr 1 ,
  86 disallow writing automatically, so that your output isn't overwritten.
  87 .Pp
  88 If the user you want to write to is logged in on more than one terminal,
  89 you can specify which terminal to write to by specifying the terminal
  90 name as the second operand to the
  91 .Nm write
  92 command.
  93 Alternatively, you can let
  94 .Nm write
  95 select one of the terminals \- it will pick the one with the shortest
  96 idle time.
  97 This is so that if the user is logged in at work and also dialed up from
  98 home, the message will go to the right place.
  99 .Pp
 100 The traditional protocol for writing to someone is that the string
 101 .Ql \-o ,
 102 either at the end of a line or on a line by itself, means that it's the
 103 other person's turn to talk.
 104 The string
 105 .Ql oo
 106 means that the person believes the conversation to be over. When this
 107 protocol fails or is not used, you may find the "reprint" character,
 108 normally ^R, useful.
 109 .Pp
 110 An additional protocol that has developed locally: when conversing
 111 with more than one person, place an identifier in parentheses, such
 112 as (d), at the beginning of each line. This serves to distinguish
 113 messages coming from different people, and also serves to indicate to
 114 the person at the other end that they should do the same.
 115 .Sh SEE ALSO
 116 .Xr mesg 1 ,
 117 .Xr talk 1 ,
 118 .Xr finger 1 ,
 119 .Xr rwho 1 ,
 120 .Xr who 1
 121 .Sh HISTORY
 122 A
 123 .Nm
 124 command appeared in
 125 .At v6 .
 126 The network aware
 127 .Nm
 128 was developed by MIT in conjunction with Project Athena.