mh-mail(5mh)
Name
mh-mail − message format for MH message system
Description
MH processes messages in a particular format. Although neither Bell nor Berkeley mailers produce message files in the format that MH prefers, MH can read message files in that format.
Each user has a mail drop box that initially receives all messages processed by post(.).
The inc() command reads from the mail drop box and incorporates the new messages found there into the user’s own mail folders (typically +inbox ). The mail drop box consists of one or more messages.
Messages are expected to consist of lines of text. Graphics and binary data are not handled. No data compression is accepted. All text is in ASCII 7-bit data.
The general memo framework of RFC 822 is used. A message consists of a block of information in a rigid format, followed by general text with no specified format. The rigidly formatted first part of a message is called the message header; the free-format portion is called the body. The header must always exist, but the body is optional. These parts are separated by a blank line or by a line of dashes. The following example shows the standard MH mail header:
To:
cc:
Subject:
--------
The header is composed of one or more header items. Each header item can be viewed as a single logical line of ASCII characters. If the text of a header item extends across several real lines, the continuation lines are indicated by leading spaces or tabs.
Each header item is called a component and is composed of a keyword or name, along with associated text. The keyword begins at the left margin, cannot contain spaces or tabs, cannot exceed 63 characters (as specified by RFC 822), and is terminated by a colon (:).
The text for most formatted components (such as “Date:” and “Message-Id:”) is produced automatically. The only ones entered by the user are address fields such as “To:” and “cc:”. Internet addresses are assigned mailbox names and host computer specifications. The rough format is “local@domain”, for example, “MH@UCI” or “MH@UCI-ICSA.ARPA”. Multiple addresses are separated by commas (,). A missing host/domain is assumed to be the local host/domain.
A blank line (or a line of dashes) signals that all following text up to the end of the file is the body of the message. No formatting is expected or enforced within the body.
The following is a list of header components that are considered meaningful to MH programs:
| Date: | Added by post(8), contains the date and time of the message’s entry into the transport system. |
| From: | Added by post(8), contains the address of the author or authors (may be more than one if a “Sender:” field is present). Replies are typically directed to addresses in the “Reply-To:” or “From:” field. (The former has precedence, if present.) |
| Sender: | Added by post(8) in the event that the message already has a “From:” line. This line contains the address of the actual sender. Replies are never sent to addresses in the “Sender:” field. |
| To: | Contains addresses of primary recipients. |
| cc: | Contains addresses of secondary recipients. |
| Bcc: | Still more recipients. However, the “Bcc:” line is not copied onto the message as delivered, so these recipients are not listed. MH uses an encapsulation method for blind copies. (See send(1).) |
| Fcc: | Causes post(8) to copy the message into the specified folder for the sender, if the message was successfully given to the transport system. |
| Message-ID: | A unique message identifier added by post(8), if the -msgid flag is set. |
| Subject: | Sender’s commentary. It is displayed by scan(1). |
| In-Reply-To: | A commentary line added by repl(1) when replying to a message. |
| Resent-Date: | Added when redistributing a message by post(8). |
| Resent-From: | Added when redistributing a message by post(8). |
| Resent-To: | New recipients for a message resent by dist(1). |
| Resent-cc: | Still more recipients. See “cc:” and “Resent-To:”. |
| Resent-Bcc: | Even more recipients. See “Bcc:” and “Resent-To:”. |
| Resent-Fcc: | Copy resent message into a folder. See “Fcc:” and “Resent-To:”. |
| Resent-Message−Id: | A unique identifier appended by post(8) if the −msgid flag is set. See “Message-Id:” and “Resent-To:”. |
| Resent: | Annotation for dist(1) under the −annotate option. |
| Forwarded: | Annotation for forw(1) under the −annotate option. |
| Replied: | Annotation for repl(1) under the −annotate option. |
Files
/usr/spool/mail/$USER
Location of mail drop
See Also
Standard for the Format of ARPA Internet Text Messages (RFC 822)