8 date 92.02.04.21.41.21; author jromine; state Exp;
13 date 92.02.04.00.04.30; author jromine; state Exp;
18 date 90.04.09.20.22.39; author sources; state Exp;
23 date 90.04.05.15.10.43; author sources; state Exp;
28 date 90.03.22.11.31.08; author sources; state Exp;
33 date 90.03.20.19.41.46; author sources; state Exp;
38 date 90.03.20.17.36.03; author sources; state Exp;
43 date 90.03.20.13.44.01; author sources; state Exp;
58 .\" @@(#)$Id: inc.rf,v 1.7 1992/02/04 00:04:30 jromine Exp jromine $
61 inc \- incorporate new mail
65 \%[\-audit\ audit\-file] \%[\-noaudit]
66 \%[\-changecur] \%[\-nochangecur]
68 \%[\-decrypt] \%[\-nodecrypt]
70 \%[\-form\ formatfile]
73 \%[\-silent] \%[\-nosilent]
74 \%[\-truncate] \%[\-notruncate]
77 \%[\-uucp] \%[\-nouucp]
80 \%[\-host\ host] \%[\-user\ user]
81 \%[\-apop] \%[\-noapop]
82 \%[\-rpop] \%[\-norpop]
83 \%[\-pack\ file] \%[\-nopack]
87 \fIInc\fR incorporates mail from the user's incoming mail drop
88 into an \fIMH\fR folder.
89 If `+folder' isn't specified,
90 a folder in the user's \fIMH\fR directory will be used, either that
91 specified by the \*(lqInbox:\*(rq entry in the user's profile, or
92 the folder named \*(lqinbox\*(rq.
94 new messages being incorporated are assigned numbers starting
95 with the next highest number in the folder.
96 If the specified (or default) folder doesn't exist,
97 the user will be queried prior to its creation.
98 As the messages are processed,
99 a \fIscan\fR listing of the new mail is produced.
101 If the user's profile contains a \*(lqMsg\-Protect: nnn\*(rq entry, it
102 will be used as the protection on the newly created messages,
103 otherwise the \fIMH\fR default of 0644 will be used.
104 During all operations on messages,
105 this initially assigned protection will
106 be preserved for each message, so \fIchmod\fR(1) may be used to set a
107 protection on an individual message, and its protection will be
108 preserved thereafter.
110 If the switch `\-audit\ audit\-file' is specified (usually as a
111 default switch in the profile), then \fIinc\fR will append a header
112 line and a line per message to the end of the specified
113 audit\-file with the format:
119 <scan line for first message>
121 <scan line for second message>
126 This is useful for keeping track of volume and source of incoming
128 Eventually, \fIrepl\fR, \fIforw\fR, \fIcomp\fR, and \fIdist\fR may also
129 produce audits to this (or another) file, perhaps with
130 \*(lqMessage\-Id:\*(rq information to keep an exact correspondence history.
131 \*(lqAudit\-file\*(rq will be in the user's MH directory unless a full
134 \fIInc\fR will incorporate even improperly formatted messages into the
135 user's MH folder, inserting a blank line prior to the offending
136 component and printing a comment identifying the bad message.
138 In all cases, the user's mail drop will be zeroed,
139 unless the `\-notruncate' switch is given.
141 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty,
142 then \fIinc\fR will add each of the newly incorporated messages to each
143 sequence named by the profile entry.
144 This is similar to the \*(lqPrevious\-Sequence\*(rq profile entry supported
145 by all \fIMH\fR commands which take `msgs' or `msg' arguments.
146 Note that \fIinc\fR will not zero each sequence prior to adding messages.
148 The interpretation of the `\-form\ formatfile', `\-format\ string',
149 and `\-width\ columns' switches is the same as in \fIscan\fR\0(1).
152 If the `\-uucp' switch is given, \fIUUCP\fR mail will be \fRinc\fRorporated
153 as well. This option will work only on those sites that optionally
154 use \*(lqmail filtering\*(rq software.
157 By using the `\-file\ name' switch, one can direct \fIinc\fR to incorporate
158 messages from a file other than the user's maildrop.
159 Note that the name file will NOT be zeroed,
160 unless the `\-truncate' switch is given.
162 If the envariable \fB$MAILDROP\fR is set,
163 then \fIinc\fR uses it as the location of the user's maildrop instead of the
164 default (the `-file\ name' switch still overrides this, however).
165 If this envariable is not set,
166 then \fIinc\fR will consult the profile entry \*(lqMailDrop\*(rq for this
168 If the value found is not absolute,
169 then it is interpreted relative to the user's \fIMH\fR directory.
170 If the value is not found,
171 then \fIinc\fR will look in the standard system location for the user's
174 The `\-silent' switch directs \fIinc\fR to be quiet and not ask any questions
176 This is useful for putting \fIinc\fR in the background and going on to other
180 If the local host is configured as a POP client,
181 or if the `\-host\ host' switch is given,
182 then \fIinc\fR will query the POP service host as to the status of mail
184 If the `\-user\ user' switch is not given,
185 then the current username is used.
187 \fIinc\fR will prompt for a password to use.
189 if the `\-apop' switch is given,
190 \fIinc\fR will generate authentication credentials to provide
191 for origin authentication and replay protection,
192 but which do not involve sending a password in the clear over the network.
194 if the `\-rpop' switch is given,
195 then \fIinc\fR will try to use a \*(lqtrusted\*(rq connection
196 (ala the BSD r-commands).
198 If \fIinc\fR uses POP,
199 then the `\-pack\ file' switch is considered.
201 then \fIinc\fR simply uses the POP to \fIpackf\fR\0(1) the user's maildrop
202 from the POP service host to the named file.
203 This switch is provided for those users who prefer to use \fImsh\fR to
204 read their maildrops.
207 ^$HOME/\&.mh\(ruprofile~^The user profile
208 ^@@(MHETCPATH)/mtstailor~^tailor file
209 ^@@(MHDROPLOC)~^Location of mail drop
211 ^Path:~^To determine the user's MH directory
213 ^Alternate\-Mailboxes:~^To determine the user's mailboxes
215 ^Inbox:~^To determine the inbox, default \*(lqinbox\*(rq
217 ^Folder\-Protect:~^To set mode when creating a new folder
219 ^Msg\-Protect:~^To set mode when creating a new message and audit\-file
221 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
224 \fIPost Office Protocol - version 3\fR (aka RFC\-1081),
227 mhmail(1), scan(1), mh\-mail(5), post(8)
229 `+folder' defaulted by \*(lqInbox\*(rq above
238 `\-format' defaulted as described above
242 `\-truncate' if `\-file\ name' not given, `\-notruncate' otherwise
244 `\-width' defaulted to the width of the terminal
256 The folder into which messages are being incorporated will become the
258 The first message incorporated will become the current message,
259 unless the `\-nochangecur' option is specified.
260 This leaves the context ready for a \fIshow\fR
261 of the first new message.
263 The argument to the `\-format' switch must be interpreted as a single token
264 by the shell that invokes \fIinc\fR.
266 one must usually place the argument to this switch inside double\-quotes.
278 .\" @@(#)$Id: inc.rf,v 1.6 1990/04/09 20:22:39 sources Exp jromine $
281 \%[\-rpop] \%[\-norpop]
284 The `\-user\ user' switch may be given to specify the name of the POP
285 subscriber you wish to check mail for on the POP service host.
286 The `\-rpop' switch uses the UNIX \fIrPOP\fR
287 (authentication done via trusted connections).
288 In contrast, the `\-norpop' switch uses the ARPA \fIPOP\fR
289 (in which case \fIinc\fR will prompt for a password).
295 @fixup RFC references
300 .\" @@(#)$Id: inc.rf,v 1.5 90/04/05 15:10:43 sources Exp Locker: sources $
303 the folder named \*(lqinbox\*(rq in the user's \fIMH\fR directory will be used.
307 `+folder' defaults to \*(lqinbox\*(rq
321 \fIPost Office Protocol (revised)\fR (aka RFC\-819 with revisions),
327 @put things back, do .NA stuff another way
341 .TH INC 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
351 @fixup for makewhatis