Imported upstream version 1.5
[manpages-zh.git] / raw / man1 / mail.1
blob3b2ed03386bd29bd3ac203af7361c5f84249825c
1 .\"     $OpenBSD: mail.1,v 1.5 1994/06/29 05:09:32 deraadt Exp $
2 .\" Copyright (c) 1980, 1990, 1993
3 .\"     The Regents of the University of California.  All rights reserved.
4 .\"
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
7 .\" are met:
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\"    notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\"    notice, this list of conditions and the following disclaimer in the
12 .\"    documentation and/or other materials provided with the distribution.
13 .\" 3. All advertising materials mentioning features or use of this software
14 .\"    must display the following acknowledgement:
15 .\"     This product includes software developed by the University of
16 .\"     California, Berkeley and its contributors.
17 .\" 4. Neither the name of the University nor the names of its contributors
18 .\"    may be used to endorse or promote products derived from this software
19 .\"    without specific prior written permission.
20 .\"
21 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31 .\" SUCH DAMAGE.
32 .\"
33 .\"     from: @(#)mail.1        8.2 (Berkeley) 12/30/93
34 .\"
35 .Dd December 30, 1993
36 .Dt MAIL 1
37 .Os BSD 4
38 .Sh NAME
39 .Nm mail
40 .Nd send and receive mail
41 .Sh SYNOPSIS
42 .Nm mail
43 .Op Fl iInv
44 .Op Fl s Ar subject
45 .Op Fl c Ar cc-addr
46 .Op Fl b Ar bcc-addr
47 .Ar to-addr...
48 .Nm mail
49 .Op Fl iInNv
50 .Fl f
51 .Op Ar name
52 .Nm mail
53 .Op Fl iInNv
54 .Op Fl u Ar user
55 .Sh INTRODUCTION
56 .Nm Mail
57 is an intelligent mail processing system, which has
58 a command syntax reminiscent of
59 .Xr \&ed 1
60 with lines replaced by messages.
61 .Pp
62 .Bl -tag -width flag
63 .It Fl v
64 Verbose mode.
65 The details of
66 delivery are displayed on the user's terminal.
67 .It Fl i
68 Ignore tty interrupt signals.
69 This is
70 particularly useful when using
71 .Nm mail
72 on noisy phone lines.
73 .It Fl I
74 Forces mail to run in interactive mode even when
75 input isn't a terminal.
76 In particular, the
77 .Sq Ic \&~
78 special
79 character when sending mail is only active in interactive mode.
80 .It Fl n
81 Inhibits reading
82 .Pa /etc/mail.rc
83 upon startup.
84 .It Fl N
85 Inhibits the initial display of message headers
86 when reading mail or editing a mail folder.
87 .It Fl s
88 Specify subject on command line
89 (only the first argument after the
90 .Fl s
91 flag is used as a subject; be careful to quote subjects
92 containing spaces.)
93 .It Fl c
94 Send carbon copies to
95 .Ar list
96 of users.
97 .It Fl b
98 Send blind carbon copies to
99 .Ar list .
100 List should be a comma-separated list of names.
101 .It Fl f
102 Read in the contents of your
103 .Ar mbox
104 (or the specified file)
105 for processing; when you
106 .Ar quit  ,
107 .Nm mail
108 writes undeleted messages back to this file.
109 .It Fl u
110 Is equivalent to:
112 .Dl mail -f /var/spool/mail/user
114 .Ss Sending mail
115 To send a message to one or more people,
116 .Nm mail
117 can be invoked with arguments which are the names of people to
118 whom the mail will be sent.
119 You are then expected to type in
120 your message, followed
121 by an
122 .Sq Li control\-D
123 at the beginning of a line.
124 The section below
125 .Ar Replying to or originating mail ,
126 describes some features of
127 .Nm mail
128 available to help you compose your letter.
130 .Ss Reading mail
131 In normal usage
132 .Nm mail
133 is given no arguments and checks your mail out of the
134 post office, then
135 prints out a one line header of each message found.
136 The current message is initially the first message (numbered 1)
137 and can be printed using the
138 .Ic print
139 command (which can be abbreviated
140 .Ql Ic p ) .
141 You can move among the messages much as you move between lines in
142 .Xr \&ed 1 ,
143 with the commands
144 .Ql Ic \&+
146 .Ql Ic \&\-
147 moving backwards and forwards, and
148 simple numbers.
150 .Ss Disposing of mail.
151 After examining a message you can
152 .Ic delete
153 .Ql Ic d )
154 the message or
155 .Ic reply
156 .Ql Ic r )
157 to it.
158 Deletion causes the
159 .Nm mail
160 program to forget about the message.
161 This is not irreversible; the message can be
162 .Ic undeleted
163 .Ql Ic u )
164 by giving its number, or the
165 .Nm mail
166 session can be aborted by giving the
167 .Ic exit
168 .Ql Ic x )
169 command.
170 Deleted messages will, however, usually disappear never to be seen again.
172 .Ss Specifying messages
173 Commands such as
174 .Ic print
176 .Ic delete
177 can be given a list of message numbers as arguments to apply
178 to a number of messages at once.
179 Thus
180 .Dq Li delete 1 2
181 deletes messages 1 and 2, while
182 .Dq Li delete 1\-5
183 deletes messages 1 through 5.
184 The special name
185 .Ql Li \&*
186 addresses all messages, and
187 .Ql Li \&$
188 addresses
189 the last message; thus the command
190 .Ic top
191 which prints the first few lines of a message could be used in
192 .Dq Li top \&*
193 to print the first few lines of all messages.
195 .Ss Replying to or originating mail.
196 You can use the
197 .Ic reply
198 command to
199 set up a response to a message, sending it back to the
200 person who it was from.
201 Text you then type in, up to an end-of-file,
202 defines the contents of the message.
203 While you are composing a message,
204 .Nm mail
205 treats lines beginning with the character
206 .Ql Ic \&~
207 specially.
208 For instance, typing
209 .Ql Ic \&~m
210 (alone on a line) will place a copy
211 of the current message into the response right shifting it by a tabstop
212 (see
213 .Em indentprefix
214 variable, below).
215 Other escapes will set up subject fields, add and delete recipients
216 to the message and allow you to escape to an editor to revise the
217 message or to a shell to run some commands.
218 (These options
219 are given in the summary below.)
221 .Ss Ending a mail processing session.
222 You can end a
223 .Nm mail
224 session with the
225 .Ic quit
226 .Ql Ic q )
227 command.
228 Messages which have been examined go to your
229 .Ar mbox
230 file unless they have been deleted in which case they are discarded.
231 Unexamined messages go back to the post office.
232 (See the
233 .Fl f
234 option above).
236 .Ss Personal and systemwide distribution lists.
237 It is also possible to create a personal distribution lists so that,
238 for instance, you can send mail to
239 .Dq Li cohorts
240 and have it go
241 to a group of people.
242 Such lists can be defined by placing a line like
244 .Dl alias cohorts bill ozalp jkf mark kridle@ucbcory
246 in the file
247 .Pa \&.mailrc
248 in your home directory.
249 The current list of such aliases can be displayed with the
250 .Ic alias
251 command in
252 .Nm mail  .
253 System wide distribution lists can be created by editing
254 .Pa /etc/aliases ,
256 .Xr aliases  5
258 .Xr sendmail  8  ;
259 these are kept in a different syntax.
260 In mail you send, personal aliases will be expanded in mail sent
261 to others so that they will be able to
262 .Ic reply
263 to the recipients.
264 System wide
265 .Ic aliases
266 are not expanded when the mail is sent,
267 but any reply returned to the machine will have the system wide
268 alias expanded as all mail goes through
269 .Xr sendmail  .
271 .Ss Network mail (ARPA, UUCP, Berknet)
273 .Xr mailaddr 7
274 for a description of network addresses.
276 .Nm Mail
277 has a number of options which can be set in the
278 .Pa .mailrc
279 file to alter its behavior; thus
280 .Dq Li set askcc
281 enables the
282 .Ar askcc
283 feature.
284 (These options are summarized below.)
285 .Sh SUMMARY
286 (Adapted from the `Mail Reference Manual')
288 Each command is typed on a line by itself, and may take arguments
289 following the command word.
290 The command need not be typed in its
291 entirety \- the first command which matches the typed prefix is used.
292 For commands which take message lists as arguments, if no message
293 list is given, then the next message forward which satisfies the
294 command's requirements is used.
295 If there are no messages forward of
296 the current message, the search proceeds backwards, and if there are no
297 good messages at all,
298 .Nm mail
299 types
300 .Dq Li No applicable messages
302 aborts the command.
303 .Bl -tag -width delete
304 .It Ic \&\-
305 Print out the preceding message.
306 If given a numeric
307 argument
308 .Ar n  ,
309 goes to the
310 .Ar n Ns 'th
311 previous message and prints it.
312 .It Ic \&?
313 Prints a brief summary of commands.
314 .It Ic \&!
315 Executes the shell
316 (see
317 .Xr sh 1
319 .Xr csh 1 )
320 command which follows.
321 .It Ic Print
322 .Pq Ic P
323 Like
324 .Ic print
325 but also prints out ignored header fields.
326 See also
327 .Ic print ,
328 .Ic ignore
330 .Ic retain .
331 .It Ic Reply
332 .Pq Ic R
333 Reply to originator.
334 Does not reply to other
335 recipients of the original message.
336 .It Ic Type
337 .Pq Ic T
338 Identical to the
339 .Ic Print
340 command.
341 .It Ic alias
342 .Pq Ic a
343 With no arguments, prints out all currently-defined aliases.
344 With one
345 argument, prints out that alias.
346 With more than one argument, creates
347 a new alias or changes an old one.
348 .It Ic alternates
349 .Pq Ic alt
351 .Ic alternates
352 command is useful if you have accounts on several machines.
353 It can be used to inform
354 .Nm mail
355 that the listed addresses are really you.
356 When you
357 .Ic reply
358 to messages,
359 .Nm mail
360 will not send a copy of the message to any of the addresses
361 listed on the
362 .Ic alternates
363 list.
364 If the
365 .Ic alternates
366 command is given with no argument, the current set of alternate
367 names is displayed.
368 .It Ic chdir
369 .Pq Ic c
370 Changes the user's working directory to that specified, if given.
372 no directory is given, then changes to the user's login directory.
373 .It Ic copy
374 .Pq Ic co
376 .Ic copy
377 command does the same thing that
378 .Ic save
379 does, except that it does not mark the messages it
380 is used on for deletion when you quit.
381 .It Ic delete
382 .Pq Ic d
383 Takes a list of messages as argument and marks them all as deleted.
384 Deleted messages will not be saved in
385 .Ar mbox  ,
386 nor will they be available for most other commands.
387 .It Ic dp
388 (also
389 .Ic dt )
390 Deletes the current message and prints the next message.
391 If there is no next message,
392 .Nm mail
393 says
394 .Dq Li "at EOF" .
395 .It Ic edit
396 .Pq Ic e
397 Takes a list of messages and points the text editor at each one in
398 turn.
399 On return from the editor, the message is read back in.
400 .It Ic exit
401 .Pf ( Ic ex
403 .Ic x )
404 Effects an immediate return to the Shell without
405 modifying the user's system mailbox, his
406 .Ar mbox
407 file, or his edit file in
408 .Fl f  .
409 .It Ic file
410 .Pq Ic fi
411 The same as
412 .Ic folder  .
413 .It Ic folders
414 List the names of the folders in your folder directory.
415 .It Ic folder
416 .Pq Ic fo
418 .Ic folder
419 command switches to a new mail file or folder.
420 With no
421 arguments, it tells you which file you are currently reading.
422 If you give it an argument, it will write out changes (such
423 as deletions) you have made in the current file and read in
424 the new file.
425 Some special conventions are recognized for
426 the name.
427 # means the previous file, % means your system
428 mailbox, %user means user's system mailbox, & means
429 your
430 .Ar mbox
431 file, and
432 \&+\&folder means a file in your folder
433 directory.
434 .It Ic from
435 .Pq Ic f
436 Takes a list of messages and prints their message headers.
437 .It Ic headers
438 .Pq Ic h
439 Lists the current range of headers, which is an 18\-message group.
442 .Ql \&+
443 argument is given, then the next 18\-message group is printed, and if
445 .Ql \&\-
446 argument is given, the previous 18\-message group is printed.
447 .It Ic help
448 A synonym for
449 .Ic \&?
450 .It Ic hold
451 .Pf ( Ic ho ,
452 also
453 .Ic preserve )
454 Takes a message list and marks each
455 message therein to be saved in the
456 user's system mailbox instead of in
457 .Ar mbox  .
458 Does not override the
459 .Ic delete
460 command.
461 .It Ic ignore
462 Add the list of header fields named to the
463 .Ar ignored list .
464 Header fields in the ignore list are not printed
465 on your terminal when you print a message.
466 This
467 command is very handy for suppression of certain machine-generated
468 header fields.
470 .Ic Type
472 .Ic Print
473 commands can be used to print a message in its entirety, including
474 ignored fields.
476 .Ic ignore
477 is executed with no arguments, it lists the current set of
478 ignored fields.
479 .It Ic mail
480 .Pq Ic m
481 Takes as argument login names and distribution group names and sends
482 mail to those people.
483 .It Ic mbox
484 Indicate that a list of messages be sent to
485 .Ic mbox
486 in your home directory when you quit.
487 This is the default
488 action for messages if you do
489 .Em not
490 have the
491 .Ic hold
492 option set.
493 .It Ic next
494 .Pq Ic n
495 like
496 .Ic \&+
498 .Tn CR )
499 Goes to the next message in sequence and types it.
500 With an argument list, types the next matching message.
501 .It Ic preserve
502 .Pq Ic pre
503 A synonym for
504 .Ic hold  .
505 .It Ic print
506 .Pq Ic p
507 Takes a message list and types out each message on the user's terminal.
508 .It Ic quit
509 .Pq Ic q
510 Terminates the session, saving all undeleted, unsaved messages in
511 the user's
512 .Ar mbox
513 file in his login directory, preserving all messages marked with
514 .Ic hold
516 .Ic preserve
517 or never referenced
518 in his system mailbox, and removing all other messages from his system
519 mailbox.
520 If new mail has arrived during the session, the message
521 .Dq Li "You have new mail"
522 is given.
523 If given while editing a
524 mailbox file with the
525 .Fl f
526 flag, then the edit file is rewritten.
527 A return to the Shell is
528 effected, unless the rewrite of edit file fails, in which case the user
529 can escape with the
530 .Ic exit
531 command.
532 .It Ic reply
533 .Pq Ic r
534 Takes a message list and sends mail to the sender and all
535 recipients of the specified message.
536 The default message must not be deleted.
537 .It Ic respond
538 A synonym for
539 .Ic reply  .
540 .It Ic retain
541 Add the list of header fields named to the
542 .Ar retained list
543 Only the header fields in the retain list
544 are shown on your terminal when you print a message.
545 All other header fields are suppressed.
547 .Ic Type
549 .Ic Print
550 commands can be used to print a message in its entirety.
552 .Ic retain
553 is executed with no arguments, it lists the current set of
554 retained fields.
555 .It Ic save
556 .Pq Ic s
557 Takes a message list and a filename and appends each message in
558 turn to the end of the file.
559 The filename in quotes, followed by the line
560 count and character count is echoed on the user's terminal.
561 .It Ic set
562 .Pq Ic se
563 With no arguments, prints all variable values.
564 Otherwise, sets
565 option.
566 Arguments are of the form
567 .Ar option=value
568 (no space before or after =) or
569 .Ar option .
570 Quotation marks may be placed around any part of the assignment statement to
571 quote blanks or tabs, i.e.
572 .Dq Li "set indentprefix=\*q->\*q"
573 .It Ic saveignore
574 .Ic Saveignore
575 is to
576 .Ic save
577 what
578 .Ic ignore
579 is to
580 .Ic print
582 .Ic type  .
583 Header fields thus marked are filtered out when
584 saving a message by
585 .Ic save
586 or when automatically saving to
587 .Ar mbox  .
588 .It Ic saveretain
589 .Ic Saveretain
590 is to
591 .Ic save
592 what
593 .Ic retain
594 is to
595 .Ic print
597 .Ic type  .
598 Header fields thus marked are the only ones saved
599 with a message when saving by
600 .Ic save
601 or when automatically saving to
602 .Ar mbox  .
603 .Ic Saveretain
604 overrides
605 .Ic saveignore  .
606 .It Ic shell
607 .Pq Ic sh
608 Invokes an interactive version of the shell.
609 .It Ic size
610 Takes a message list and prints out the size in characters of each
611 message.
612 .It Ic source
614 .Ic source
615 command reads
616 commands from a file.
617 .It Ic top
618 Takes a message list and prints the top few lines of each.
619 The number of
620 lines printed is controlled by the variable
621 .Ic toplines
622 and defaults to five.
623 .It Ic type
624 .Pq Ic t
625 A synonym for
626 .Ic print  .
627 .It Ic unalias
628 Takes a list of names defined by
629 .Ic alias
630 commands and discards the remembered groups of users.
631 The group names
632 no longer have any significance.
633 .It Ic undelete
634 .Pq Ic u
635 Takes a message list and marks each message as
636 .Ic not
637 being deleted.
638 .It Ic unread
639 .Pq Ic U
640 Takes a message list and marks each message as
641 .Ic not
642 having been read.
643 .It Ic unset
644 Takes a list of option names and discards their remembered values;
645 the inverse of
646 .Ic set  .
647 .It Ic visual
648 .Pq Ic v
649 Takes a message list and invokes the display editor on each message.
650 .It Ic write
651 .Pq Ic w
652 Similar to
653 .Ic save  ,
654 except that
655 .Ic only
656 the message body
657 .Pq Ar without
658 the header) is saved.
659 Extremely useful for such tasks as sending and receiving source
660 program text over the message system.
661 .It Ic xit
662 .Pq Ic x
663 A synonym for
664 .Ic exit  .
665 .It Ic z
666 .Nm Mail
667 presents message headers in windowfuls as described under the
668 .Ic headers
669 command.
670 You can move
671 .Nm mail Ns 's
672 attention forward to the next window with the
673 .Ic \&z
674 command.
675 Also, you can move to the previous window by using
676 .Ic \&z\&\-  .
678 .Ss Tilde/Escapes
680 Here is a summary of the tilde escapes,
681 which are used when composing messages to perform
682 special functions.
683 Tilde escapes are only recognized at the beginning
684 of lines.
685 The name
686 .Dq Em tilde\ escape
687 is somewhat of a misnomer since the actual escape character can be set
688 by the option
689 .Ic escape .
690 .Bl -tag -width Ds
691 .It Ic \&~! Ns Ar command
692 Execute the indicated shell command, then return to the message.
693 .It Ic \&~b Ns Ar name ...
694 Add the given names to the list of carbon copy recipients but do not make
695 the names visible in the Cc: line ("blind" carbon copy).
696 .It Ic \&~c Ns Ar name ...
697 Add the given names to the list of carbon copy recipients.
698 .It Ic \&~d
699 Read the file
700 .Dq Pa dead.letter
701 from your home directory into the message.
702 .It Ic \&~e
703 Invoke the text editor on the message collected so far.
704 After the
705 editing session is finished, you may continue appending text to the
706 message.
707 .It Ic \&~f Ns Ar messages
708 Read the named messages into the message being sent.
709 If no messages are specified, read in the current message.
710 Message headers currently being ignored (by the
711 .Ic ignore
713 .Ic retain
714 command) are not included.
715 .It Ic \&~F Ns Ar messages
716 Identical to
717 .Ic \&~f ,
718 except all message headers are included.
719 .It Ic \&~h
720 Edit the message header fields by typing each one in turn and allowing
721 the user to append text to the end or modify the field by using the
722 current terminal erase and kill characters.
723 .It Ic \&~m Ns Ar messages
724 Read the named messages into the message being sent, indented by a
725 tab or by the value of
726 .Ar indentprefix  .
727 If no messages are specified,
728 read the current message.
729 Message headers currently being ignored (by the
730 .Ic ignore
732 .Ic retain
733 command) are not included.
734 .It Ic \&~M Ns Ar messages
735 Identical to
736 .Ic \&~m ,
737 except all message headers are included.
738 .It Ic \&~p
739 Print out the message collected so far, prefaced by the message header
740 fields.
741 .It Ic \&~q
742 Abort the message being sent, copying the message to
743 .Dq Pa dead.letter
744 in your home directory if
745 .Ic save
746 is set.
747 .It Ic \&~r Ns Ar filename
748 Read the named file into the message.
749 .It Ic \&~s Ns Ar string
750 Cause the named string to become the current subject field.
751 .It Ic \&~\&t Ns Ar name ...
752 Add the given names to the direct recipient list.
753 .It Ic \&~\&v
754 Invoke an alternate editor (defined by the
755 .Ev VISUAL
756 option) on the
757 message collected so far.
758 Usually, the alternate editor will be a
759 screen editor.
760 After you quit the editor, you may resume appending
761 text to the end of your message.
762 .It Ic \&~w Ns Ar filename
763 Write the message onto the named file.
764 .It Ic \&~\&| Ns Ar command
765 Pipe the message through the command as a filter.
766 If the command gives
767 no output or terminates abnormally, retain the original text of the
768 message.
769 The command
770 .Xr fmt 1
771 is often used as
772 .Ic command
773 to rejustify the message.
774 .It Ic \&~: Ns Ar mail-command
775 Execute the given mail command.
776 Not all commands, however, are allowed.
777 .It Ic \&~~ Ns Ar string
778 Insert the string of text in the message prefaced by a single ~.
780 you have changed the escape character, then you should double
781 that character in order to send it.
783 .Ss Mail Options
784 Options are controlled via
785 .Ic set
787 .Ic unset
788 commands.
789 Options may be either binary, in which case it is only
790 significant to see whether they are set or not; or string, in which
791 case the actual value is of interest.
792 The binary options include the following:
793 .Bl -tag -width append
794 .It Ar append
795 Causes messages saved in
796 .Ar mbox
797 to be appended to the end rather than prepended.
798 This should always be set (perhaps in
799 .Pa /etc/mail.rc ) .
800 .It Ar ask, asksub
801 Causes
802 .Nm mail
803 to prompt you for the subject of each message you send.
805 you respond with simply a newline, no subject field will be sent.
806 .It Ar askcc
807 Causes you to be prompted for additional carbon copy recipients at the
808 end of each message.
809 Responding with a newline indicates your
810 satisfaction with the current list.
811 .It Ar askbcc
812 Causes you to be prompted for additional blind carbon copy recipients at the
813 end of each message.
814 Responding with a newline indicates your
815 satisfaction with the current list.
816 .It Ar autoprint
817 Causes the
818 .Ic delete
819 command to behave like
820 .Ic dp
821 \- thus, after deleting a message, the next one will be typed
822 automatically.
823 .It Ar debug
824 Setting the binary option
825 .Ar debug
826 is the same as specifying
827 .Fl d
828 on the command line and causes
829 .Nm mail
830 to output all sorts of information useful for debugging
831 .Nm mail  .
832 .It Ar dot
833 The binary option
834 .Ar dot
835 causes
836 .Nm mail
837 to interpret a period alone on a line as the terminator
838 of a message you are sending.
839 .It Ar hold
840 This option is used to hold messages in the system mailbox
841 by default.
842 .It Ar ignore
843 Causes interrupt signals from your terminal to be ignored and echoed as
844 @'s.
845 .It Ar ignoreeof
846 An option related to
847 .Ar dot
849 .Ar ignoreeof
850 which makes
851 .Nm mail
852 refuse to accept a control-d as the end of a message.
853 .Ar Ignoreeof
854 also applies to
855 .Nm mail
856 command mode.
857 .It Ar metoo
858 Usually, when a group is expanded that contains the sender, the sender
859 is removed from the expansion.
860 Setting this option causes the sender
861 to be included in the group.
862 .It Ar noheader
863 Setting the option
864 .Ar noheader
865 is the same as giving the
866 .Fl N
867 flag on the command line.
868 .It Ar nosave
869 Normally, when you abort a message with two
870 .Tn RUBOUT
871 (erase or delete)
872 .Nm mail
873 copies the partial letter to the file
874 .Dq Pa dead.letter
875 in your home directory.
876 Setting the binary option
877 .Ar nosave
878 prevents this.
879 .It Ar Replyall
880 Reverses the sense of
881 .Ic reply
883 .Ic Reply
884 commands.
885 .It Ar quiet
886 Suppresses the printing of the version when first invoked.
887 .It Ar searchheaders
888 If this option is set, then a message-list specifier in the form ``/x:y''
889 will expand to all messages containing the substring ``y'' in the header
890 field ``x''.  The string search is case insensitive.
891 .It Ar verbose
892 Setting the option
893 .Ar verbose
894 is the same as using the
895 .Fl v
896 flag on the command line.
897 When mail runs in verbose mode,
898 the actual delivery of messages is displayed on the user's
899 terminal.
901 .Ss Option String Values
902 .Bl -tag -width Va
903 .It Ev EDITOR
904 Pathname of the text editor to use in the
905 .Ic edit
906 command and
907 .Ic \&~e
908 escape.
909 If not defined, then a default editor is used.
910 .It Ev LISTER
911 Pathname of the directory lister to use in the
912 .Ic folders
913 command.
914 Default is
915 .Pa /bin/ls .
916 .It Ev PAGER
917 Pathname of the program to use in the
918 .Ic more
919 command or when
920 .Ic crt
921 variable is set.
922 The default paginator
923 .Xr more 1
924 is used if this option is not defined.
925 .It Ev SHELL
926 Pathname of the shell to use in the
927 .Ic \&!
928 command and the
929 .Ic \&~!
930 escape.
931 A default shell is used if this option is
932 not defined.
933 .It Ev VISUAL
934 Pathname of the text editor to use in the
935 .Ic visual
936 command and
937 .Ic \&~v
938 escape.
939 .It Va crt
940 The valued option
941 .Va crt
942 is used as a threshold to determine how long a message must
943 be before
944 .Ev PAGER
945 is used to read it.
947 .Va crt
948 is set without a value,
949 then the height of the terminal screen stored in the system
950 is used to compute the threshold (see
951 .Xr stty 1 ) .
952 .It Ar escape
953 If defined, the first character of this option gives the character to
954 use in the place of ~ to denote escapes.
955 .It Ar folder
956 The name of the directory to use for storing folders of
957 messages.
958 If this name begins with a `/',
959 .Nm mail
960 considers it to be an absolute pathname; otherwise, the
961 folder directory is found relative to your home directory.
962 .It Ev MBOX
963 The name of the
964 .Ar mbox
965 file.
966 It can be the name of a folder.
967 The default is
968 .Dq Li mbox
969 in the user's home directory.
970 .It Ar record
971 If defined, gives the pathname of the file used to record all outgoing
972 mail.
973 If not defined, then outgoing mail is not so saved.
974 .It Ar indentprefix
975 String used by the ``~m'' tilde escape for indenting messages, in place of
976 the normal tab character (^I).
977 Be sure to quote the value if it contains
978 spaces or tabs.
979 .It Ar toplines
980 If defined, gives the number of lines of a message to be printed out
981 with the
982 .Ic top
983 command; normally, the first five lines are printed.
985 .Sh ENVIRONMENT
986 .Nm Mail
987 utilizes the
988 .Ev HOME,
989 .Ev USER,
990 .Ev SHELL,
991 .Ev DEAD,
992 .Ev PAGER,
993 .Ev LISTER,
994 .Ev EDITOR,
995 .Ev VISUAL
997 .Ev MBOX
998 environment variables.
999 .Sh FILES
1000 .Bl -tag -width /usr/lib/mail.*help -compact
1001 .It Pa /var/spool/mail/*
1002 Post office.
1003 .It ~/mbox
1004 User's old mail.
1005 .It ~/.mailrc
1006 File giving initial mail commands.  Only used if the owner of the file is the
1007 user running this copy of mail.
1008 .It Pa /tmp/R*
1009 Temporary files.
1010 .It Pa /usr/lib/mail.*help
1011 Help files.
1012 .It Pa /etc/mail.rc
1013 System initialization file.
1015 .Sh SEE ALSO
1016 .Xr fmt 1 ,
1017 .Xr newaliases 1 ,
1018 .Xr vacation 1 ,
1019 .Xr aliases 5 ,
1020 .Xr mailaddr 7 ,
1021 .Xr sendmail 8
1024 .%T "The Mail Reference Manual" .
1026 .Sh HISTORY
1028 .Nm mail
1029 command
1030 appeared in
1031 .At v6 .
1032 This man page is derived from
1033 .%T "The Mail Reference Manual"
1034 originally written by Kurt Shoens.
1035 .Sh BUGS
1036 There are some flags that are not documented here.
1037 Most are
1038 not useful to the general user.
1040 .\" This bug is not the case in this particular distribution.
1041 .\" Usually, .Nm mail is just a link to .Nm Mail, which can be confusing.