usr.bin/mail/USD.doc/mail6.nr

   1 .\" Copyright (c) 1980, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. Neither the name of the University nor the names of its contributors
  13 .\"    may be used to endorse or promote products derived from this software
  14 .\"    without specific prior written permission.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 .\" SUCH DAMAGE.
  27 .\"
  28 .\"     @(#)mail6.nr    8.1 (Berkeley) 6/8/93
  29 .\"
  30 .bp
  31 .sh 1 "Command line options"
  32 .pp
  33 This section describes command line options for
  34 .i Mail
  35 and what they are used for.
  36 .ip \-N
  37 Suppress the initial printing of headers.
  38 .ip \-d
  39 Turn on debugging information.  Not of general interest.
  40 .ip "\-f file\ \ "
  41 Show the messages in
  42 .i file
  43 instead of your system mailbox.  If
  44 .i file
  45 is omitted,
  46 .i Mail
  47 reads
  48 .i mbox
  49 in your home directory.
  50 .ip \-i
  51 Ignore tty interrupt signals.  Useful on noisy phone lines, which
  52 generate spurious RUBOUT or DELETE characters.  It's usually
  53 more effective to change your interrupt character to control\-c,
  54 for which see the
  55 .i stty
  56 shell command.
  57 .ip \-n
  58 Inhibit reading of /etc/mail.rc.  Not generally useful, since
  59 /etc/mail.rc is usually empty.
  60 .ip "\-s string"
  61 Used for sending mail.
  62 .i String
  63 is used as the subject of the message being composed.  If
  64 .i string
  65 contains blanks, you must surround it with quote marks.
  66 .ip "\-u name"
  67 Read
  68 .i names's
  69 mail instead of your own.  Unwitting others often neglect to protect
  70 their mailboxes, but discretion is advised. Essentially,
  71 .b "\-u user"
  72 is a shorthand way of doing
  73 .b "\-f /var/mail/user".
  74 .ip "\-v"
  75 Use the
  76 .b \-v
  77 flag when invoking sendmail. This feature may also be enabled
  78 by setting the the option "verbose".
  79 .pp
  80 The following command line flags are also recognized, but are
  81 intended for use by programs invoking
  82 .i Mail
  83 and not for people.
  84 .ip "\-T file"
  85 Arrange to print on
  86 .i file
  87 the contents of the
  88 .i article-id
  89 fields of all messages that were either read or deleted.
  90 .b \-T
  91 is for the
  92 .i readnews
  93 program and should NOT be used for reading your mail.
  94 .ip "\-h number"
  95 Pass on hop count information.
  96 .i Mail
  97 will take the number, increment it, and pass it with
  98 .b \-h
  99 to the mail delivery system.
 100 .b \-h
 101 only has effect when sending mail and is used for network mail
 102 forwarding.
 103 .ip "\-r name"
 104 Used for network mail forwarding:  interpret
 105 .i name
 106 as the sender of the message.  The
 107 .i name
 108 and
 109 .b \-r
 110 are simply sent along to the mail delivery system.  Also,
 111 .i Mail
 112 will wait for the message to be sent and return the exit status.
 113 Also restricts formatting of message.
 114 .pp
 115 Note that
 116 .b \-h
 117 and
 118 .b \-r ,
 119 which are for network mail forwarding, are not used in practice
 120 since mail forwarding is now handled separately.  They may
 121 disappear soon.