xref: /freebsd/usr.bin/write/write.1 (revision bdcbfde3)
19b50d902SRodney W. Grimes.\" Copyright (c) 1989, 1993
29b50d902SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
39b50d902SRodney W. Grimes.\"
49b50d902SRodney W. Grimes.\" This code is derived from software contributed to Berkeley by
59b50d902SRodney W. Grimes.\" Jef Poskanzer and Craig Leres of the Lawrence Berkeley Laboratory.
69b50d902SRodney W. Grimes.\"
79b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
89b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions
99b50d902SRodney W. Grimes.\" are met:
109b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
119b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
129b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
139b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
149b50d902SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
15fbbd9655SWarner Losh.\" 3. Neither the name of the University nor the names of its contributors
169b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
179b50d902SRodney W. Grimes.\"    without specific prior written permission.
189b50d902SRodney W. Grimes.\"
199b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
209b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
219b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
229b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
239b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
249b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
259b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
269b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
279b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
289b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
299b50d902SRodney W. Grimes.\" SUCH DAMAGE.
309b50d902SRodney W. Grimes.\"
310de6400bSGleb Smirnoff.Dd February 13, 2012
329b50d902SRodney W. Grimes.Dt WRITE 1
339b50d902SRodney W. Grimes.Os
349b50d902SRodney W. Grimes.Sh NAME
359b50d902SRodney W. Grimes.Nm write
369b50d902SRodney W. Grimes.Nd send a message to another user
379b50d902SRodney W. Grimes.Sh SYNOPSIS
388fe908efSRuslan Ermilov.Nm
399b50d902SRodney W. Grimes.Ar user
40f682f10cSRuslan Ermilov.Op Ar tty
419b50d902SRodney W. Grimes.Sh DESCRIPTION
42e8937ba0SPhilippe CharnierThe
43e8937ba0SPhilippe Charnier.Nm
44e8937ba0SPhilippe Charnierutility allows you to communicate with other users, by copying lines from
459b50d902SRodney W. Grimesyour terminal to theirs.
469b50d902SRodney W. Grimes.Pp
479b50d902SRodney W. GrimesWhen you run the
4829909ffeSPhilippe Charnier.Nm
499b50d902SRodney W. Grimescommand, the user you are writing to gets a message of the form:
509b50d902SRodney W. Grimes.Pp
519b50d902SRodney W. Grimes.Dl Message from yourname@yourhost on yourtty at hh:mm ...
529b50d902SRodney W. Grimes.Pp
539b50d902SRodney W. GrimesAny further lines you enter will be copied to the specified user's
549b50d902SRodney W. Grimesterminal.
559b50d902SRodney W. GrimesIf the other user wants to reply, they must run
5629909ffeSPhilippe Charnier.Nm
579b50d902SRodney W. Grimesas well.
589b50d902SRodney W. Grimes.Pp
599b50d902SRodney W. GrimesWhen you are done, type an end-of-file or interrupt character.
609b50d902SRodney W. GrimesThe other user will see the message
619b50d902SRodney W. Grimes.Ql EOF
629b50d902SRodney W. Grimesindicating that the
639b50d902SRodney W. Grimesconversation is over.
649b50d902SRodney W. Grimes.Pp
659b50d902SRodney W. GrimesYou can prevent people (other than the super-user) from writing to you
669b50d902SRodney W. Grimeswith the
679b50d902SRodney W. Grimes.Xr mesg 1
689b50d902SRodney W. Grimescommand.
699b50d902SRodney W. Grimes.Pp
709b50d902SRodney W. GrimesIf the user you want to write to is logged in on more than one terminal,
719b50d902SRodney W. Grimesyou can specify which terminal to write to by specifying the terminal
729b50d902SRodney W. Grimesname as the second operand to the
7329909ffeSPhilippe Charnier.Nm
749b50d902SRodney W. Grimescommand.
759b50d902SRodney W. GrimesAlternatively, you can let
7629909ffeSPhilippe Charnier.Nm
779b50d902SRodney W. Grimesselect one of the terminals \- it will pick the one with the shortest
789b50d902SRodney W. Grimesidle time.
799b50d902SRodney W. GrimesThis is so that if the user is logged in at work and also dialed up from
809b50d902SRodney W. Grimeshome, the message will go to the right place.
819b50d902SRodney W. Grimes.Pp
829b50d902SRodney W. GrimesThe traditional protocol for writing to someone is that the string
839b50d902SRodney W. Grimes.Ql \-o ,
8436a142c4SRuslan Ermiloveither at the end of a line or on a line by itself, means that it is the
859b50d902SRodney W. Grimesother person's turn to talk.
869b50d902SRodney W. GrimesThe string
879b50d902SRodney W. Grimes.Ql oo
889b50d902SRodney W. Grimesmeans that the person believes the conversation to be
899b50d902SRodney W. Grimesover.
909b50d902SRodney W. Grimes.Sh SEE ALSO
919b50d902SRodney W. Grimes.Xr mesg 1 ,
929b50d902SRodney W. Grimes.Xr talk 1 ,
93fc414536SRuslan Ermilov.Xr wall 1 ,
949b50d902SRodney W. Grimes.Xr who 1
959b50d902SRodney W. Grimes.Sh HISTORY
969b50d902SRodney W. GrimesA
979b50d902SRodney W. Grimes.Nm
989b50d902SRodney W. Grimescommand appeared in
99b8923d4cSWolfram Schneider.At v1 .
1004f45d811STim J. Robbins.Sh BUGS
10170ad92abSTim J. RobbinsThe sender's
10270ad92abSTim J. Robbins.Ev LC_CTYPE
10370ad92abSTim J. Robbinssetting is used to determine which characters are safe to write to a
10470ad92abSTim J. Robbinsterminal, not the receiver's (which
10570ad92abSTim J. Robbins.Nm
10670ad92abSTim J. Robbinshas no way of knowing).
107