Print this page
12745 man page typos

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1/mail.1
          +++ new/usr/src/man/man1/mail.1
↓ open down ↓ 36 lines elided ↑ open up ↑
  37   37  .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  38   38  .\" If applicable, add the following below this CDDL HEADER, with the
  39   39  .\" fields enclosed by brackets "[]" replaced with your own identifying
  40   40  .\" information: Portions Copyright [yyyy] [name of copyright owner]
  41   41  .\"
  42   42  .\"
  43   43  .\" Copyright 1989 AT&T
  44   44  .\" Portions Copyright (c) 1992, X/Open Company Limited  All Rights Reserved
  45   45  .\" Copyright (c) 2008, Sun Microsystems, Inc.  All Rights Reserved
  46   46  .\"
  47      -.TH MAIL 1 "Jul 24, 2008"
       47 +.TH MAIL 1 "May 17, 2020"
  48   48  .SH NAME
  49   49  mail, rmail \- read mail or send mail to users
  50   50  .SH SYNOPSIS
  51   51  .SS "Sending Mail"
  52      -.LP
  53   52  .nf
  54   53  \fBmail\fR [\fB-tw\fR] [\fB-m\fR \fImessage_type\fR] \fIrecipient\fR...
  55   54  .fi
  56   55  
  57   56  .LP
  58   57  .nf
  59   58  \fBrmail\fR [\fB-tw\fR] [\fB-m\fR \fImessage_type\fR] \fIrecipient\fR...
  60   59  .fi
  61   60  
  62   61  .SS "Reading Mail"
  63      -.LP
  64   62  .nf
  65   63  \fBmail\fR [\fB-ehpPqr\fR] [\fB-f\fR \fIfile\fR]
  66   64  .fi
  67   65  
  68   66  .SS "Debugging"
  69      -.LP
  70   67  .nf
  71   68  \fBmail\fR [\fB-x\fR \fIdebug_level\fR] [\fIother_mail_options\fR] \fIrecipient\fR...
  72   69  .fi
  73   70  
  74   71  .SH DESCRIPTION
  75      -.sp
  76      -.LP
  77   72  A \fIrecipient\fR is usually a domain style address
  78   73  ("\fIuser\fR@\fImachine\fR") or a user name recognized by \fBlogin\fR(1). When
  79   74  \fIrecipient\fRs are named, \fBmail\fR assumes a message is being sent. It
  80   75  reads from the standard input up to an end-of-file (Control-d) or, if reading
  81   76  from a terminal device, until it reads a line consisting of just a period. When
  82   77  either of those indicators is received, \fBmail\fR adds the \fIletter\fR to the
  83   78  \fImailfile\fR for each \fIrecipient\fR.
  84   79  .sp
  85   80  .LP
  86   81  A \fIletter\fR is composed of some \fIheader lines\fR followed by a blank line
↓ open down ↓ 25 lines elided ↑ open up ↑
 112  107  indicates that the message is formatted as described in RFC 2045. A
 113  108  \fBContent-Length:\fR header line, indicating the number of bytes in the
 114  109  \fImessage content\fR, is always present unless the letter consists of only
 115  110  header lines with no message content. A \fBContent-Type:\fR header line that
 116  111  describes the type of the \fImessage content\fR (such as text/plain,
 117  112  application/octet-stream, and so on) is also present, unless the letter
 118  113  consists of only header lines with no message content. Header lines may be
 119  114  continued on the following line if that line starts with white space.
 120  115  .SH OPTIONS
 121  116  .SS "Sending Mail"
 122      -.sp
 123      -.LP
 124  117  The following command-line arguments affect sending mail:
 125  118  .sp
 126  119  .ne 2
 127  120  .na
 128  121  \fB\fB-m\fR \fImessage_type\fR\fR
 129  122  .ad
 130  123  .RS 19n
 131  124  A \fBMessage-Type:\fR line is added to the message header with the value of
 132  125  \fImessage_type\fR.
 133  126  .RE
↓ open down ↓ 61 lines elided ↑ open up ↑
 195  188  .RS 27n
 196  189  Remote recipients are specified by prefixing the recipient name with the remote
 197  190  system name and an exclamation point, such as \fBsysa!user.\fR If \fBcsh\fR(1)
 198  191  is the default shell, \fBsysa\e!user\fR should be used. A series of system
 199  192  names separated by exclamation points can be used to direct a letter through an
 200  193  extended network (such as \fBsysa!sysb!sysc!user\fR or
 201  194  \fBsysa\e!sysb\e!sysc\e!user\fR).
 202  195  .RE
 203  196  
 204  197  .SS "Reading Mail"
 205      -.sp
 206      -.LP
 207  198  The following command-line arguments affect reading mail:
 208  199  .sp
 209  200  .ne 2
 210  201  .na
 211  202  \fB\fB-e\fR\fR
 212  203  .ad
 213  204  .RS 11n
 214  205  Test for the presence of mail. \fBmail\fR prints nothing.
 215  206  .sp
 216  207  An exit status of \fB0\fR is returned if the user has mail. Otherwise, an exit
↓ open down ↓ 321 lines elided ↑ open up ↑
 538  529  can be read-write (\fB0666\fR), read-only (\fB0664\fR), or neither read nor
 539  530  write (\fB0660\fR) to allow different levels of privacy. If changed to other
 540  531  than the default (mode \fB0660\fR), the file is preserved even when empty to
 541  532  perpetuate the desired permissions. (The administrator can override this file
 542  533  preservation using the \fBDEL_EMPTY_MAILFILE\fR option of \fBmailcnfg\fR.)
 543  534  .sp
 544  535  .LP
 545  536  The group \fBID\fR of the mailfile must be \fBmail\fR to allow new messages to
 546  537  be delivered, and the mailfile must be writable by group \fBmail\fR.
 547  538  .SS "Debugging"
 548      -.sp
 549      -.LP
 550  539  The following command-line arguments cause \fBmail\fR to provide debugging
 551  540  information:
 552  541  .sp
 553  542  .ne 2
 554  543  .na
 555  544  \fB\fB-x\fR \fIdebug_level\fR\fR
 556  545  .ad
 557  546  .RS 18n
 558  547  \fBmail\fR creates a trace file containing debugging information.
 559  548  .RE
↓ open down ↓ 5 lines elided ↑ open up ↑
 565  554  to how \fBmail\fR processed the current message. The absolute value of
 566  555  \fIdebug_level\fR controls the verboseness of the debug information. \fB0\fR
 567  556  implies no debugging. If \fIdebug_level\fR is greater than \fB0\fR, the debug
 568  557  file is retained \fIonly\fR if \fBmail\fR encountered some problem while
 569  558  processing the message. If \fIdebug_level\fR is less than \fB0\fR, the debug
 570  559  file is always be retained. The \fIdebug_level\fR specified via \fB-x\fR
 571  560  overrides any specification of \fBDEBUG\fR in \fB/etc/mail/mailcnfg\fR. The
 572  561  information provided by the \fB-x\fR option is esoteric and is probably only
 573  562  useful to system administrators.
 574  563  .SS "Delivery Notification"
 575      -.sp
 576      -.LP
 577  564  Several forms of notification are available for mail by including one of the
 578  565  following lines in the message header.
 579  566  .sp
 580  567  .LP
 581  568  \fBTransport-Options:\fR [ \fB/\fR\fIoptions\fR ]
 582  569  .sp
 583  570  .LP
 584  571  \fBDefault-Options:\fR [ \fB/\fR\fIoptions\fR ]
 585  572  .sp
 586  573  .LP
↓ open down ↓ 46 lines elided ↑ open up ↑
 633  620  .ad
 634  621  .RS 15n
 635  622  Same as \fB/return\fR except that the original message is not returned.
 636  623  .RE
 637  624  
 638  625  .sp
 639  626  .LP
 640  627  The default is \fB/nodelivery/return\fR. If contradictory options are used, the
 641  628  first is recognized and later, conflicting, terms are ignored.
 642  629  .SH OPERANDS
 643      -.sp
 644      -.LP
 645  630  The following operand is supported for sending mail:
 646  631  .sp
 647  632  .ne 2
 648  633  .na
 649  634  \fB\fIrecipient\fR\fR
 650  635  .ad
 651  636  .RS 13n
 652  637  A domain style address ("\fIuser\fR@\fImachine\fR") or user login name
 653  638  recognized by \fBlogin\fR(1).
 654  639  .RE
 655  640  
 656  641  .SH USAGE
 657      -.sp
 658      -.LP
 659  642  See \fBlargefile\fR(5) for the description of the behavior of \fBmail\fR and
 660  643  \fBrmail\fR when encountering files greater than or equal to 2 Gbyte ( 2^31
 661  644  bytes).
 662  645  .SH ENVIRONMENT VARIABLES
 663      -.sp
 664      -.LP
 665  646  See \fBenviron\fR(5) for descriptions of the following environment variables
 666  647  that affect the execution of \fBmail\fR: \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and
 667  648  \fBNLSPATH\fR.
 668  649  .sp
 669  650  .ne 2
 670  651  .na
 671  652  \fB\fBTZ\fR\fR
 672  653  .ad
 673  654  .RS 6n
 674  655  Determine the timezone used with date and time strings.
 675  656  .RE
 676  657  
 677  658  .SH EXIT STATUS
 678      -.sp
 679      -.LP
 680  659  The following exit values are returned:
 681  660  .sp
 682  661  .ne 2
 683  662  .na
 684  663  \fB\fB0\fR\fR
 685  664  .ad
 686  665  .RS 6n
 687  666  Successful completion when the user had mail.
 688  667  .RE
 689  668  
↓ open down ↓ 9 lines elided ↑ open up ↑
 699  678  .sp
 700  679  .ne 2
 701  680  .na
 702  681  \fB\fB>1\fR\fR
 703  682  .ad
 704  683  .RS 6n
 705  684  An error occurred after initialization.
 706  685  .RE
 707  686  
 708  687  .SH FILES
 709      -.sp
 710  688  .ne 2
 711  689  .na
 712  690  \fB\fBdead.letter\fR\fR
 713  691  .ad
 714  692  .RS 20n
 715  693  unmailable text
 716  694  .RE
 717  695  
 718  696  .sp
 719  697  .ne 2
↓ open down ↓ 55 lines elided ↑ open up ↑
 775  753  .na
 776  754  \fB\fB/var/mail/\fIuser\fR\fR\fR
 777  755  .ad
 778  756  .RS 20n
 779  757  incoming mail for \fIuser\fR; that is, the \fImailfile\fR
 780  758  .RE
 781  759  
 782  760  .sp
 783  761  .ne 2
 784  762  .na
 785      -\fB\fBvar/tmp/ma\fR*\fR
      763 +\fB\fB/var/tmp/ma\fR*\fR
 786  764  .ad
 787  765  .RS 20n
 788  766  temporary file
 789  767  .RE
 790  768  
 791  769  .SH SEE ALSO
 792      -.sp
 793      -.LP
 794  770  \fBchmod\fR(1), \fBcsh\fR(1), \fBlogin\fR(1), \fBmailx\fR(1), \fBuucp\fR(1C),
 795  771  \fBuuencode\fR(1C), \fBvacation\fR(1), \fBwrite\fR(1), \fBattributes\fR(5),
 796  772  \fBenviron\fR(5), \fBlargefile\fR(5)
 797  773  .sp
 798  774  .LP
 799  775  \fISolaris Advanced User\&'s Guide\fR
 800  776  .SH NOTES
 801      -.sp
 802      -.LP
 803  777  The interpretation and resulting action taken because of the header lines
 804  778  described in the Delivery Notifications section only occur if this version of
 805  779  \fBmail\fR is installed on the system where the delivery (or failure) happens.
 806  780  Earlier versions of \fBmail\fR might not support any types of delivery
 807  781  notification.
 808  782  .sp
 809  783  .LP
 810  784  Conditions sometimes result in a failure to remove a lock file.
 811  785  .sp
 812  786  .LP
 813  787  After an interrupt, the next message might not be printed. Printing can be
 814  788  forced by typing a \fBp\fR.
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX