Some headers should be inserted into a mail message only if a certain delivery agent is used. For example, one traditionally should include the
Full-Name:
header when mail is being delivered with UUCP but should not include it for most other delivery agents.
The mechanism that governs inclusion is a list of flags that prefix the header definition in the configuration file. Those flags are composed of a series of one or more letters, all of which are surrounded with a pair of
?
characters.
H?
flags
?
name: value
When
sendmail
decides whether a header is to be added to the mail message, it compares the
flags
listed with the flags of the delivery agent's
F=
equate:
Mhub, P=[IPC], S=Hubset, R=0, F=mDFMuXa, T=DNS/RFC822/SMTP, A=IPC $h flags
If a given flag (letter) appears in both, the header is added to the mail message. Otherwise, it is not.
Traditionally, for example, the
x
flag is used to indicate the need for a
Full-Name:
header. But our hub delivery agent does not have an
x
in its
F=
flags. Since that is the only delivery agent we use, we need to add that flag to the
client.cf
file.
The
Full-Name:
header is used to display the full name of the sender, as taken from the
gecos
field of the
passwd
(5) file. You saw above how the hub machine tries to add the sender's full name to the
From:
header. But since you don't necessarily have control over the hub, you should add a
Full-Name:
header locally, so that the full name is displayed even if the hub fails to add it.
The way to declare the
Full-Name:
header is like this:
H?x?Full-Name: $?x$x$. # Add full name if available
First prefix it with the
?x?
flag. This means that the
Full-Name:
header is added only if the delivery agent also contains that flag.
The value given to the
Full-Name:
header is just like the conditional that you saw earlier. If (
$?
) the macro
x
contains a value, use that value (
$x
), and endif (
$.
). We use this conditional test so that the full name is added only if it is known.
Next, to make the
Full-Name:
effective, you need to add an
x
flag to the
hub
delivery agent declaration:
Mhub, P=[IPC], S=Hubset, R=0, F=x
mDFMuXa, T=DNS/RFC822/SMTP, A=IPC $h add
Now any mail that uses the
hub
delivery agent for a recipient (in other words, all mail) will add a
Full-Name:
header to the message if there is not already one there. If the full name is known (
$x
has a value), that name follows the
Full-Name:
header on the same line; otherwise, the header contains only the header name and is omitted entirely.
The
Date:
header is required in all messages to show the time and day that the message originated. It is a good idea to include
?
flags
?
in its definition so that custom delivery agents that do not need the
Date:
can be designed later.
H?D?Date: $a # Add if F=D
The
$a
is the
origin date
of the mail message in RFC822 format. That date is set internally by
sendmail
to be correct for inclusion in the
Date:
header.
An
F=D
flag already exists in the
hub
delivery agent:
Mhub, P=[IPC], S=Hubset, R=0, F=xmD
FMuXa, T=DNS/RFC822/SMTP, A=IPC $h add the date if missing
That
D
was originally put in this delivery agent definition with the
Date:
header in mind.
The
Message-ID:
header is used to uniquely identify each mail message. It must be inserted into the message when it is first created (first handled by
sendmail
). The form of the
Message-ID:
header is very specific:
H?M?Message-Id: <$t.$i@$j> # Add if F=M
Here, a
?M?
prefix is included. The
hub
delivery agent definition already has the
F=M
flag listed:
Mhub, P=[IPC], S=Hubset, R=0, F=xmDFM
uXa, T=DNS/RFC822/SMTP, A=IPC $h add the message identifier if missing
The field following the
Message-ID:
must follow particular rules. First, it must be surrounded by angle brackets. Then, what appears between the angle brackets must look like a legal address:
< address>
The address must be composed of pieces of information that uniquely identify the mail message worldwide. We create that address in a way that is commonly used in most configuration files:
<$t.$i@$j>
$t
is the current date and time represented by an integer.
$i
is the local unique identifier for the queue file for this message (even if the message isn't queued), and
$j
is your host's fully qualified domain name. Other information may be used, provided that the result looks like a legal address and provided that no two identical identifiers ever go out.