xref: /freebsd/usr.bin/write/write.1 (revision fbbd9655)
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.\"
319b50d902SRodney W. Grimes.\"     @(#)write.1	8.1 (Berkeley) 6/6/93
32c3aac50fSPeter Wemm.\" $FreeBSD$
339b50d902SRodney W. Grimes.\"
340de6400bSGleb Smirnoff.Dd February 13, 2012
359b50d902SRodney W. Grimes.Dt WRITE 1
369b50d902SRodney W. Grimes.Os
379b50d902SRodney W. Grimes.Sh NAME
389b50d902SRodney W. Grimes.Nm write
399b50d902SRodney W. Grimes.Nd send a message to another user
409b50d902SRodney W. Grimes.Sh SYNOPSIS
418fe908efSRuslan Ermilov.Nm
429b50d902SRodney W. Grimes.Ar user
43f682f10cSRuslan Ermilov.Op Ar tty
449b50d902SRodney W. Grimes.Sh DESCRIPTION
45e8937ba0SPhilippe CharnierThe
46e8937ba0SPhilippe Charnier.Nm
47e8937ba0SPhilippe Charnierutility allows you to communicate with other users, by copying lines from
489b50d902SRodney W. Grimesyour terminal to theirs.
499b50d902SRodney W. Grimes.Pp
509b50d902SRodney W. GrimesWhen you run the
5129909ffeSPhilippe Charnier.Nm
529b50d902SRodney W. Grimescommand, the user you are writing to gets a message of the form:
539b50d902SRodney W. Grimes.Pp
549b50d902SRodney W. Grimes.Dl Message from yourname@yourhost on yourtty at hh:mm ...
559b50d902SRodney W. Grimes.Pp
569b50d902SRodney W. GrimesAny further lines you enter will be copied to the specified user's
579b50d902SRodney W. Grimesterminal.
589b50d902SRodney W. GrimesIf the other user wants to reply, they must run
5929909ffeSPhilippe Charnier.Nm
609b50d902SRodney W. Grimesas well.
619b50d902SRodney W. Grimes.Pp
629b50d902SRodney W. GrimesWhen you are done, type an end-of-file or interrupt character.
639b50d902SRodney W. GrimesThe other user will see the message
649b50d902SRodney W. Grimes.Ql EOF
659b50d902SRodney W. Grimesindicating that the
669b50d902SRodney W. Grimesconversation is over.
679b50d902SRodney W. Grimes.Pp
689b50d902SRodney W. GrimesYou can prevent people (other than the super-user) from writing to you
699b50d902SRodney W. Grimeswith the
709b50d902SRodney W. Grimes.Xr mesg 1
719b50d902SRodney W. Grimescommand.
729b50d902SRodney W. Grimes.Pp
739b50d902SRodney W. GrimesIf the user you want to write to is logged in on more than one terminal,
749b50d902SRodney W. Grimesyou can specify which terminal to write to by specifying the terminal
759b50d902SRodney W. Grimesname as the second operand to the
7629909ffeSPhilippe Charnier.Nm
779b50d902SRodney W. Grimescommand.
789b50d902SRodney W. GrimesAlternatively, you can let
7929909ffeSPhilippe Charnier.Nm
809b50d902SRodney W. Grimesselect one of the terminals \- it will pick the one with the shortest
819b50d902SRodney W. Grimesidle time.
829b50d902SRodney W. GrimesThis is so that if the user is logged in at work and also dialed up from
839b50d902SRodney W. Grimeshome, the message will go to the right place.
849b50d902SRodney W. Grimes.Pp
859b50d902SRodney W. GrimesThe traditional protocol for writing to someone is that the string
869b50d902SRodney W. Grimes.Ql \-o ,
8736a142c4SRuslan Ermiloveither at the end of a line or on a line by itself, means that it is the
889b50d902SRodney W. Grimesother person's turn to talk.
899b50d902SRodney W. GrimesThe string
909b50d902SRodney W. Grimes.Ql oo
919b50d902SRodney W. Grimesmeans that the person believes the conversation to be
929b50d902SRodney W. Grimesover.
939b50d902SRodney W. Grimes.Sh SEE ALSO
949b50d902SRodney W. Grimes.Xr mesg 1 ,
959b50d902SRodney W. Grimes.Xr talk 1 ,
96fc414536SRuslan Ermilov.Xr wall 1 ,
979b50d902SRodney W. Grimes.Xr who 1
989b50d902SRodney W. Grimes.Sh HISTORY
999b50d902SRodney W. GrimesA
1009b50d902SRodney W. Grimes.Nm
1019b50d902SRodney W. Grimescommand appeared in
102b8923d4cSWolfram Schneider.At v1 .
1034f45d811STim J. Robbins.Sh BUGS
10470ad92abSTim J. RobbinsThe sender's
10570ad92abSTim J. Robbins.Ev LC_CTYPE
10670ad92abSTim J. Robbinssetting is used to determine which characters are safe to write to a
10770ad92abSTim J. Robbinsterminal, not the receiver's (which
10870ad92abSTim J. Robbins.Nm
10970ad92abSTim J. Robbinshas no way of knowing).
110