annotate conf/doc/post.rf @ 0:bce86c4163a3

Initial revision
author kono
date Mon, 18 Apr 2005 23:46:02 +0900
parents
children 441a2190cfae
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1 .\" @(MHWARNING)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
2 .\" @(#)$Id$
bce86c4163a3 Initial revision
kono
parents:
diff changeset
3 .SC POST 8
bce86c4163a3 Initial revision
kono
parents:
diff changeset
4 .NA
bce86c4163a3 Initial revision
kono
parents:
diff changeset
5 post \- deliver a message
bce86c4163a3 Initial revision
kono
parents:
diff changeset
6 .SY
bce86c4163a3 Initial revision
kono
parents:
diff changeset
7 @(MHETCPATH)/post
bce86c4163a3 Initial revision
kono
parents:
diff changeset
8 \%[\-alias\ aliasfile]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
9 \%[\-filter\ filterfile] \%[\-nofilter]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
10 @BEGIN: TMA
bce86c4163a3 Initial revision
kono
parents:
diff changeset
11 \%[\-encrypt] \%[\-noencrypt]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
12 @END: TMA
bce86c4163a3 Initial revision
kono
parents:
diff changeset
13 \%[\-format] \%[\-noformat]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
14 @BEGIN: MIME
bce86c4163a3 Initial revision
kono
parents:
diff changeset
15 \%[\-mime] \%[\-nomime]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
16 @END: MIME
bce86c4163a3 Initial revision
kono
parents:
diff changeset
17 \%[\-msgid] \%[\-nomsgid]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
18 \%[\-verbose] \%[\-noverbose]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
19 \%[\-watch] \%[\-nowatch]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
20 \%[\-width\ columns]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
21 file
bce86c4163a3 Initial revision
kono
parents:
diff changeset
22 \%[\-help]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
23 .DE
bce86c4163a3 Initial revision
kono
parents:
diff changeset
24 \fIPost\fR is the program called by \fIsend\fR\0(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
25 to deliver the message in \fIfile\fR to local and remote users.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
26 In fact, all of the functions attributed to \fIsend\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
27 on its manual page are performed by \fIpost\fR,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
28 with \fIsend\fR acting as a relatively simple preprocessor.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
29 Thus, it is \fIpost\fR which parses the various header fields,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
30 appends From: and Date: lines,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
31 @BEGIN: MMDFMTS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
32 and interacts with the \fIMMDF\fR transport system.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
33 @END: MMDFMTS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
34 @BEGIN: MHMTS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
35 and delivers and/or queues the messages.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
36 @END: MHMTS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
37 @BEGIN: SENDMTS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
38 and interacts with the \fISendMail\fR transport system.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
39 @END: SENDMTS
bce86c4163a3 Initial revision
kono
parents:
diff changeset
40 \fIPost\fR will not normally be called directly by the user.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
41
bce86c4163a3 Initial revision
kono
parents:
diff changeset
42 \fIPost\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
43 searches the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq, \*(lqFcc:\*(rq, and \*(lqResent\-xxx:\*(rq
bce86c4163a3 Initial revision
kono
parents:
diff changeset
44 header lines of
bce86c4163a3 Initial revision
kono
parents:
diff changeset
45 the specified message for destination addresses, checks these
bce86c4163a3 Initial revision
kono
parents:
diff changeset
46 addresses for validity, and formats them so as to conform to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
47 ARPAnet Internet Message Format protocol,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
48 unless the `\-noformat' flag is set.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
49 This will normally cause \*(lq@\fIlocal\-site\fR\*(rq to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
50 be appended to each local destination address, as well
bce86c4163a3 Initial revision
kono
parents:
diff changeset
51 as any local return addresses.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
52 The `\-width\ columns' switch can be used to indicate the preferred length
bce86c4163a3 Initial revision
kono
parents:
diff changeset
53 of the header components that contain addresses.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
54
bce86c4163a3 Initial revision
kono
parents:
diff changeset
55 If a \*(lqBcc:\*(rq field is encountered,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
56 its addresses will be used for delivery,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
57 and the \*(lqBcc:\*(rq field will be removed from the message sent to sighted
bce86c4163a3 Initial revision
kono
parents:
diff changeset
58 recipients.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
59 The blind recipients will receive an entirely new message with
bce86c4163a3 Initial revision
kono
parents:
diff changeset
60 a minimal set of headers.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
61 Included in the body of the message will be a copy of the message sent to the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
62 sighted recipients.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
63 If `\-filter\ filterfile' is specified,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
64 then this copy is filtered (re\-formatted)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
65 prior to being sent to the blind recipients.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
66 @BEGIN: MIME
bce86c4163a3 Initial revision
kono
parents:
diff changeset
67 Otherwise,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
68 to use the MIME rules for encapsulation,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
69 specify the `\-mime' switch.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
70 @END: MIME
bce86c4163a3 Initial revision
kono
parents:
diff changeset
71
bce86c4163a3 Initial revision
kono
parents:
diff changeset
72 The `\-alias\ aliasfile' switch can be used to specify a file that post should
bce86c4163a3 Initial revision
kono
parents:
diff changeset
73 take aliases from. More than one file can be specified, each being preceded
bce86c4163a3 Initial revision
kono
parents:
diff changeset
74 with `\-alias'.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
75 In any event,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
76 the primary alias file is read first.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
77
bce86c4163a3 Initial revision
kono
parents:
diff changeset
78 The `\-msgid' switch indicates that
bce86c4163a3 Initial revision
kono
parents:
diff changeset
79 a \*(lqMessage\-ID:\*(rq or \*(lqResent\-Message\-ID:\*(rq
bce86c4163a3 Initial revision
kono
parents:
diff changeset
80 field should be added to the header.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
81
bce86c4163a3 Initial revision
kono
parents:
diff changeset
82 The `\-verbose' switch indicates that the user should be informed of each
bce86c4163a3 Initial revision
kono
parents:
diff changeset
83 step of the posting/filing process.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
84
bce86c4163a3 Initial revision
kono
parents:
diff changeset
85 The `\-watch' switch indicates that the user would like to watch the transport
bce86c4163a3 Initial revision
kono
parents:
diff changeset
86 system's handling of the message (e.g., local and \*(lqfast\*(rq delivery).
bce86c4163a3 Initial revision
kono
parents:
diff changeset
87
bce86c4163a3 Initial revision
kono
parents:
diff changeset
88 \fIPost\fR consults the envariable \fB$SIGNATURE\fR to
bce86c4163a3 Initial revision
kono
parents:
diff changeset
89 determine the sender's personal name in constructing the \*(lqFrom:\*(rq line
bce86c4163a3 Initial revision
kono
parents:
diff changeset
90 of the message.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
91 .Fi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
92 ^@(MHETCPATH)/mtstailor~^tailor file
bce86c4163a3 Initial revision
kono
parents:
diff changeset
93 ^@(MHBINPATH)/refile~^Program to process Fcc:s
bce86c4163a3 Initial revision
kono
parents:
diff changeset
94 ^@(MHETCPATH)/mhl~^Program to process Bcc:s
bce86c4163a3 Initial revision
kono
parents:
diff changeset
95 ^@(MHETCPATH)/MailAliases~^Primary alias file
bce86c4163a3 Initial revision
kono
parents:
diff changeset
96 .Pr
bce86c4163a3 Initial revision
kono
parents:
diff changeset
97 \fIpost\fR does \fBNOT\fR consult the user's \&.mh\(ruprofile
bce86c4163a3 Initial revision
kono
parents:
diff changeset
98 .Sa
bce86c4163a3 Initial revision
kono
parents:
diff changeset
99 \fIStandard for the Format of ARPA Internet Text Messages\fR (aka RFC\-822),
bce86c4163a3 Initial revision
kono
parents:
diff changeset
100 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
101 mhmail(1), send(1), mh\-mail(5), mh\-alias(5)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
102 .De
bce86c4163a3 Initial revision
kono
parents:
diff changeset
103 `\-alias @(MHETCPATH)/MailAliases'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
104 @BEGIN: TMA
bce86c4163a3 Initial revision
kono
parents:
diff changeset
105 `\-noencrypt'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
106 @END: TMA
bce86c4163a3 Initial revision
kono
parents:
diff changeset
107 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
108 `\-format'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
109 @BEGIN: MIME
bce86c4163a3 Initial revision
kono
parents:
diff changeset
110 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
111 `\-nomime'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
112 @END: MIME
bce86c4163a3 Initial revision
kono
parents:
diff changeset
113 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
114 `\-nomsgid'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
115 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
116 `\-noverbose'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
117 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
118 `\-nowatch'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
119 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
120 `\-width\ 72'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
121 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
122 `\-nofilter'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
123 .Co
bce86c4163a3 Initial revision
kono
parents:
diff changeset
124 None
bce86c4163a3 Initial revision
kono
parents:
diff changeset
125 .Bu
bce86c4163a3 Initial revision
kono
parents:
diff changeset
126 \*(lqReply\-To:\*(rq fields are allowed to have groups in them according to the
bce86c4163a3 Initial revision
kono
parents:
diff changeset
127 822 specification,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
128 but \fIpost\fR won't let you use them.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
129 .En