Migrated man page post(8) to spost(8).
[mmh] / man / spost.man8
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH SPOST %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
5 .SH NAME
6 spost \- feed a message to sendmail
7 .SH SYNOPSIS
8 .HP 5
9 .na
10 .HP 5
11 .B spost
12 .RB [ \-alias
13 .IR aliasfile
14 .RB " | " \-noalias ]
15 .RB [ \-dist ]
16 .RB [ \-push " | " \-nopush ]
17 .RB [ \-verbose " | " \-noverbose ]
18 .RB [ \-watch " | " \-nowatch ]
19 .I file
20 .RB [ \-version ]
21 .RB [ \-help ]
22 .ad
23 .SH DESCRIPTION
24 .B Spost
25 is the program called by
26 .B send
27 to feed the message in
28 .I file
29 to
30 .B sendmail
31 for delivery.  In fact, many of
32 the features attributed to
33 .B send
34 in its manual page are performed by
35 .BR spost ,
36 with
37 .B send
38 acting as a preprocessor.
39 Thus, it is
40 .B spost
41 which parses the various header fields, appends
42 \*(lqFrom:\*(rq and \*(lqDate:\*(rq lines,
43 and finally feeds the message to the MTA.
44 .B Spost
45 will not normally be called directly by the user.
46 .PP
47 .B Spost
48 searches the \*(lqTo:\*(rq, \*(lqCc:\*(rq, \*(lqBcc:\*(rq,
49 \*(lqFcc:\*(rq, and \*(lqResent\-xxx:\*(rq header lines of the specified
50 message for destination addresses,
51 .PP
52 If a \*(lqBcc:\*(rq field is encountered, its addresses will be used for
53 delivery, and the \*(lqBcc:\*(rq field will be removed from the message
54 sent to sighted recipients.  The blind recipients will receive a newly
55 constructed message with a copy of the original message attached.
56 MIME rules are used for encapsulation.
57 .RB ( spost
58 invokes
59 .B send
60 to send the Bcc message.)
61 .PP
62 The
63 .B \-alias
64 .I aliasfile
65 switch can be used to specify a file that spost
66 should take aliases from.  More than one file can be specified, each
67 being preceded with
68 .BR \-alias .
69 In any event, the alias file, set with the `Aliasfile' profile entry, is
70 read first.
71 .PP
72 The
73 .B \-verbose
74 enables the output of informational messages.
75 This option sets \-watch, too.
76 .PP
77 The
78 .B \-watch
79 switch adds the `\-v' switch to the
80 .B sendmail
81 invocation.
82 .PP
83 .B Spost
84 constructs the \*(lqFrom:\*(rq line of the
85 message from the user's login name and the full name from the GECOS field
86 of the passwd file.
87 An example is \*(lqFrom: Dan Harkless <dan>\*(rq.
88 .PP
89 If you set the
90 .B $SIGNATURE
91 environment variable.
92 Its value overrides the full name from the GECOS field.
93 .PP
94 If you specify a \*(lqFrom:\*(rq
95 line manually in the message draft.
96 It will be used as provided.
97 However, a \*(lqSender:\*(rq header with the user's
98 .B real
99 address will be added.
100 .PP
101 Note that this applies equally to \*(lqResent\-From:\*(rq lines
102 in messages sent with
103 .BR dist .
104 .PP
105 Your MTA is supposed to care to fully qualitfy the addresses
106 with the correct domain name.
107 .PP
108 The draft is filed to the folders in the Fcc headers by
109 .BR refile .
110
111 .SH FILES
112 .fc ^ ~
113 .nf
114 .ta \w'ExtraBigFileName  'u
115 None
116 .fi
117
118 .SH "PROFILE COMPONENTS"
119 .B spost
120 does
121 .B NOT
122 consult the user's profile.
123
124 .SH "SEE ALSO"
125 mhmail(1), send(1), mh\-mail(5), mh\-alias(5), mh\-tailor(5),
126 refile(1),
127 .I "Standard for the Format of ARPA Internet Text Messages"
128 (RFC\-822)
129
130 .SH DEFAULTS
131 .nf
132 .RB ` \-noverbose '
133 .RB ` \-nowatch '
134 .RB ` \-nopush '
135 .fi
136
137 .SH CONTEXT
138 None
139
140 .SH BUGS
141 Spost does not qualify addresses.
142 .PP
143 Spost does only basic processing and checking, yet.