Debian Codegraph @

upstream/debian-trixie/man1/maildrop.1

raw
1 '\" t
2 .\"<!-- Copyright 1998 - 2009 Double Precision, Inc. See COPYING for -->
3 .\"<!-- distribution information. -->
4 .\" Title: maildrop
5 .\" Author: Sam Varshavchik
6 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
7 .\" Date: 07/13/2024
8 .\" Manual: Double Precision, Inc.
9 .\" Source: Courier Mail Server
10 .\" Language: English
11 .\"
12 .TH "MAILDROP" "1" "07/13/2024" "Courier Mail Server" "Double Precision, Inc\&."
13 .\" -----------------------------------------------------------------
14 .\" * Define some portability stuff
15 .\" -----------------------------------------------------------------
16 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
17 .\" http://bugs.debian.org/507673
18 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
19 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .ie \n(.g .ds Aq \(aq
21 .el .ds Aq '
22 .\" -----------------------------------------------------------------
23 .\" * set default formatting
24 .\" -----------------------------------------------------------------
25 .\" disable hyphenation
26 .nh
27 .\" disable justification (adjust text to left margin only)
28 .ad l
29 .\" -----------------------------------------------------------------
30 .\" * MAIN CONTENT STARTS HERE *
31 .\" -----------------------------------------------------------------
32 .SH "NAME"
33 maildrop \- mail delivery filter/agent
34 .SH "SYNOPSIS"
35 .HP \w'\fBmaildrop\fR\ 'u
36 \fBmaildrop\fR [option...] [\-d\ \fIuser\fR] [\fIarg\fR...]
37 .HP \w'\fBmaildrop\fR\ 'u
38 \fBmaildrop\fR [option...] [\fIfilename\fR] [\fIarg\fR...]
39 .SH "DESCRIPTION"
40 .PP
41 \fBmaildrop\fR
42 is a replacement local mail delivery agent that includes a mail filtering language\&. The system administrator can either replace the existing mail delivery agent with
43 \fBmaildrop\fR, or users may run
44 \fBmaildrop\fR
45 using the \*(Aqforward to program\*(Aq mechanism of the existing mail delivery agent\&.
46 .PP
47 \fBmaildrop\fR
48 first reads the E\-mail message on standard input\&. Trailing carriage return characters are automatically stripped\&. An E\-mail message consists of header lines, followed by a blank line, followed by the contents of the message\&.
49 .PP
50 \fBmaildrop\fR
51 does not accept an mbox\-style
52 From_
53 line before the first header line\&.
54 \fBmaildrop\fR
55 does not accept leading empty lines before the first non\-blank header line\&. If the message can possibly start with empty lines, and a
56 From_
57 line, use
58 \fBreformail \-f0\fR
59 to remove any initial empty lines, and replace a
60 From_
61 line with a proper
62 \(lqReturn\-Path:\(rq
63 header; then pipe it to
64 \fBmaildrop\fR\&.
65 .PP
66 If the file
67 /etc/maildroprc
68 exists, mail delivery or mail filtering instructions are read from that file\&.
69 \fBmaildrop\fR\*(Aqs delivery/filtering instructions may direct
70 \fBmaildrop\fR
71 to save the message in specific mailbox, discard it, return it to sender, or forward it to a different E\-mail address\&.
72 .PP
73 If
74 /etc/maildroprc
75 does not exist, or its mail delivery instructions do not completely dispose of this message,
76 \fBmaildrop\fR
77 then reads the mail delivery instructions from
78 $HOME/\&.mailfilter\&. If it doesn\*(Aqt exist, or its mail delivery instructions do not completely dispose of the message,
79 \fBmaildrop\fR
80 then saves the E\-mail message in the default mailbox\&.
81 .PP
82 \fBmaildrop\fR
83 knows how to deliver mail to an standard mailbox files; it also knows how to deliver to maildirs\&. A
84 maildir
85 is a directory\-based mail format used by the
86 \m[blue]\fBCourier\fR\m[]\&\s-2\u[1]\d\s+2
87 and
88 Qmail
89 mail servers\&. Many other mail servers also know how to read maildirs\&. When delivering to mailbox files,
90 \fBmaildrop\fR
91 will lock the mailbox for the duration of the delivery\&.
92 .PP
93 This is the general mail delivery behavior\&. There are minor differences in behavior depending on
94 \fBmaildrop\fR
95 delivery mode, which is determined based on how
96 \fBmaildrop\fR
97 was started\&.
98 \fBmaildrop\fR
99 uses three different primary operating modes:
100 .PP
101 Manual mode
102 .RS 4
103 A file containing filtering instructions \-
104 \fIfilename\fR
105 is specified as an argument to the
106 \fBmaildrop\fR
107 command\&.
108 \fBmaildrop\fR
109 reads this
110 \fIfilename\fR
111 and follows the instructions in it\&. Unless the message is explicitly forwarded, bounced, deleted, or delivered to a specific mailbox, it will be delivered to the user\*(Aqs system mailbox\&.
112 .RE
113 .PP
114 Delivery mode
115 .RS 4
116 \fBmaildrop\fR
117 is the mail server\*(Aqs mail delivery agent\&.
118 \fBmaildrop\fR
119 runs in delivery mode when no
120 \fIfilename\fR
121 is specified on the command line\&.
122 \fBmaildrop\fR
123 changes the current directory to the user\*(Aqs home directory, then reads
124 /etc/maildroprc, then
125 $HOME/\&.mailfilter\&.
126 .RE
127 .PP
128 Embedded mode
129 .RS 4
130 \fBmaildrop\fR
131 functions as a part of another application\&. The embedded mode is used by the
132 \m[blue]\fBCourier\fR\m[]\&\s-2\u[1]\d\s+2
133 mail server to integrate mail filtering directly into the process of receiving mail from a remote mail relay, thus rejecting unwanted mail before it is even accepted for local mail delivery\&. Embedded mode is used when either the \-m, or the \-M, option is specified, and is described below\&. See below for a more extensive description of the embedded mode\&.
134 .RE
135 .SH "SECURITY"
136 .PP
137 It is safe to install
138 \fBmaildrop\fR
139 as a root setuid program\&.
140 \m[blue]\fBThe Courier mail server\fR\m[]\&\s-2\u[1]\d\s+2
141 installs
142 \fBmaildrop\fR
143 as a root setuid program by default, in order to be able to use
144 \fBmaildrop\fR
145 in embedded mode\&. If root runs
146 \fBmaildrop\fR
147 (or it is setuided to root) the
148 \fB\-d\fR
149 option may be used to specify the message\*(Aqs recipient\&.
150 \fBmaildrop\fR
151 immediately resets its userid to the one specified by the
152 \fB\-d\fR
153 option\&. The user\*(Aqs
154 $HOME/\&.mailfilter
155 is read (if it exists), and the message is delivered to the indicated user\&.
156 .PP
157 The system administrator can configure
158 \fBmaildrop\fR
159 to restrict the
160 \fB\-d\fR
161 option for everyone except the mail system itself\&.
162 .PP
163 If in delivery mode the user\*(Aqs home directory has the sticky bit set,
164 \fBmaildrop\fR
165 immediately terminates with an exit code of
166 \fBEX_TEMPFAIL\fR, without doing anything\&. Mail servers interpret the
167 \fBEX_TEMPFAIL\fR
168 exit code as a request to reschedule the message for another delivery attempt later\&. Setting the sticky bit allows
169 $HOME/\&.mailfilter
170 to be edited while temporarily holding all incoming mail\&.
171 .PP
172 \fBmaildrop\fR
173 also terminates with
174 \fBEX_TEMPFAIL\fR
175 if the user\*(Aqs home directory has world write permissions\&.
176 .PP
177 \fBmaildrop\fR
178 immediately terminates with
179 \fBEX_TEMPFAIL\fR
180 if the
181 filename
182 is not owned by the user, or if it has any group or world permissions\&. This includes read permissions\&. The permissions on
183 $HOME/\&.mailfilter
184 may only include read and write privileges to the user\&.
185 .PP
186 When using the special embedded mode (see below)
187 \fBmaildrop\fR
188 immediately terminates with the exit code set to
189 \fBEX_TEMPFAIL\fR
190 if
191 $HOME/\&.mailfilters
192 is not owned by the user, or if it has any group or world permissions\&.
193 .SH "TEMPORARY FILES"
194 .PP
195 \fBmaildrop\fR
196 is heavily optimized and tries to use as little resources as possible\&.
197 \fBmaildrop\fR
198 reads small messages into memory, then filters and/or delivers the message directly from memory\&. For larger messages,
199 \fBmaildrop\fR
200 accesses the message directly from the file\&. If the standard input is not a file,
201 \fBmaildrop\fR
202 writes the message to a temporary file, then accesses the message from the temporary file\&. The temporary file is automatically removed when the message is delivered\&.
203 .SH "OPTIONS"
204 .PP
205 \-a
206 .RS 4
207 Makes the
208 Courier
209 Authentication Library usage mandatory, i\&.e\&. maildrop will throw a temporary error code if the call to the authlib mechanism fails for some reason, such as authdaemon being inaccessible\&.
210 .if n \{\
211 .sp
212 .\}
213 .RS 4
214 .it 1 an-trap
215 .nr an-no-space-flag 1
216 .nr an-break-flag 1
217 .br
218 .ps +1
219 \fBNote\fR
220 .ps -1
221 .br
222 This setting may already be the default, depending on maildrop\*(Aqs configuration\&.
223 .sp .5v
224 .RE
225 .RE
226 .PP
227 \-A "\fIHeader: value\fR"
228 .RS 4
229 Adds an additional header to the message\&. Specifying
230 \fI\-A "Foo: Bar"\fR
231 effectively adds this header to the message being delivered\&.
232 .sp
233 The mail transport agent usually adds additional headers when delivering a message to a local mailbox\&. The way it\*(Aqs usually done is by the mail transport agent sending the message using a pipe to the local delivery agent \- such as
234 \fBmaildrop\fR
235 \- and adding some additional headers in the process\&. Because
236 \fBmaildrop\fR
237 receives the message from a pipe,
238 \fBmaildrop\fR
239 must either save the message in memory or write the message into a temporary file\&.
240 .sp
241 The
242 \fB\-A\fR
243 option enables the file containing the message to be provided to
244 \fBmaildrop\fR
245 directly, as standard input, and the additional headers specified on the command line\&. Because the standard input is a file,
246 \fBmaildrop\fR
247 will not need a temporary file\&. Multiple
248 \fB\-A\fR
249 options may be specified\&.
250 .RE
251 .PP
252 \-d \fIuser\fR
253 .RS 4
254 Run
255 \fBmaildrop\fR
256 in delivery mode for this user ID\&.
257 .sp
258 The system administrator may optionally restrict the
259 \fB\-d\fR
260 option to be available to the mail system only, so it may not be available to you\&. In all cases, the
261 \fB\-d\fR
262 option is allowed if
263 \fIuser\fR
264 is the same user who is running
265 \fBmaildrop\fR\&. Also, for the
266 \fB\-d\fR
267 option to work at all,
268 \fBmaildrop\fR
269 must be executed by root, or
270 \fBmaildrop\fR
271 must be a root\-owned program with the setuid bit set\&. Absence of a
272 filename
273 on
274 \fBmaildrop\fR\*(Aqs command line implies the
275 \fB\-d\fR
276 option for the user running
277 \fBmaildrop\fR\&.
278 .sp
279 If
280 \fB\-d\fR
281 is not specified, the first argument following all the options is a name of the file containing filtering instructions\&. The remaining arguments, if any, are assigned to the variables
282 \fI$1\fR,
283 \fI$2\fR, and so on (see
284 \m[blue]\fB"Environment"\fR\m[]\&\s-2\u[2]\d\s+2
285 and
286 \m[blue]\fB"Variable substitution"\fR\m[]\&\s-2\u[3]\d\s+2)\&.
287 .RE
288 .PP
289 \-f \fIaddress\fR
290 .RS 4
291 Sets the FROM variable (message envelope sender) to
292 \fIaddress\fR\&. The system administrator may optionally disable the
293 \fB\-f\fR
294 option for users, so it may not be available to you\&.
295 .RE
296 .PP
297 \-m
298 .RS 4
299 Run
300 \fBmaildrop\fR
301 in embedded mode\&. It\*(Aqs possible to use both the
302 \fB\-m\fR, and the
303 \fB\-d\fR
304 options, but it doesn\*(Aqt make much sense to do so\&. Even if you really wanted to run your message through someone else\*(Aqs
305 \&.mailfilter, that
306 \&.mailfilter
307 probably has at least one instruction which is not allowed in the embedded mode\&.
308 .sp
309 The
310 filename
311 argument to
312 \fBmaildrop\fR
313 should be specified\&.
314 filename
315 is a file that includes filtering instructions to be processed in embedded mode\&. The
316 \-m
317 option is used for debugging filter files which are later placed in
318 $HOME/\&.mailfilters, and used with the
319 \fB\-M\fR
320 option\&.
321 .RE
322 .PP
323 \-M \fIfilterfile\fR
324 .RS 4
325 Run
326 \fBmaildrop\fR
327 in a special embedded mode\&. The
328 \fB\-d\fR
329 option is implied when
330 \fB\-M\fR
331 is used, and if absent it defaults to the userid running
332 \fBmaildrop\fR\&.
333 .sp
334 All the requirements for the
335 \fB\-d\fR
336 option apply\&.
337 \fBmaildrop\fR
338 must either be executed by root, or the
339 \fBmaildrop\fR
340 program must be owned by root with the setuid bit set\&.
341 \fBmaildrop\fR
342 immediately gives up root privileges by changing its user ID to the one specified by
343 \fB\-d\fR, then reads
344 $HOME/\&.mailfilters/\fIfilterfile\fR\&. For security reasons the name of the file may not begin with a slash or include periods\&.
345 \fBmaildrop\fR
346 is very paranoid: both
347 $HOME/\&.mailfilters, and
348 $HOME/\&.mailfilters/\fIfilterfile\fR
349 must be owned by the user, and may not have any group or world permissions\&.
350 .sp
351 The
352 \fB\-M\fR
353 option allows for some friendly cooperation between the user running the application, and the user who provides a filter for the embedded mode\&. The user running the application can use someone else\*(Aqs canned filter and be assured that the filter is not going to run amok and start sending mail or create files all over the place\&. The user who provides the filter can be assured that the environment variables are clean, and that there are no surprises\&.
354 .sp
355 \fBmaildrop\fR
356 supports the concept of "default" filter files\&. If the file specified by the
357 \fB\-M\fR
358 option cannot be found in
359 $HOME/\&.mailfilters,
360 \fBmaildrop\fR
361 will try to open
362 $HOME/\&.mailfilters/\fIfilterfileprefix\fR\-default\&.
363 \fIfilterfileprefix\fR
364 is the initial part of
365 \fIfilterfile\fR
366 up until the last \*(Aq\-\*(Aq character in
367 \fIfilterfile\fR\&.
368 .sp
369 If
370 $HOME/\&.mailfilters/\fIfilterfileprefix\fR\-default
371 does not exist, and there are any other dashes left in
372 \fIfilterfileprefix\fR, maildrop removes the last dash and everything following it, then tries again\&.
373 .sp
374 As a last resort
375 \fBmaildrop\fR
376 tries to open
377 $HOME/\&.mailfilters/default\&.
378 .sp
379 For example, if the parameter to the
380 \fB\-M\fR
381 option is
382 \fImailfilter\-lists\-maildrop\fR,
383 \fBmaildrop\fR
384 will try to open the following files, in order:
385 .sp .if n \{\ .RS 4 .\} .nf $HOME/\&.mailfilters/mailfilter\-lists\-maildrop $HOME/\&.mailfilters/mailfilter\-lists\-maildrop\-default $HOME/\&.mailfilters/mailfilter\-lists\-default $HOME/\&.mailfilters/mailfilter\-default $HOME/\&.mailfilters/default .fi .if n \{\ .RE .\}
386 .sp
387 Note that
388 \fBmaildrop\fR
389 looks for \-default files ONLY if
390 \fB\-M\fR
391 is used\&.
392 .RE
393 .PP
394 \-D \fIuuu/ggg\fR
395 .RS 4
396 This option is reserved for use by the version of
397 \fBmaildrop\fR
398 that comes integrated with the
399 \m[blue]\fBCourier mail server\fR\m[]\&\s-2\u[1]\d\s+2\&.
400 .RE
401 .PP
402 \-V \fIlevel\fR
403 .RS 4
404 Initialize the
405 \fIVERBOSE\fR
406 variable to
407 \fIlevel\fR\&. Because
408 \fBmaildrop\fR
409 parses the entire file before running it, this option is used to produce debugging output in the parsing phase\&. Otherwise, if
410 filename
411 has syntax errors, then no debugging output is possible because the
412 \fIVERBOSE\fR
413 variable is not yet set\&.
414 .sp
415 \fB\-V\fR
416 is ignored when
417 \fBmaildrop\fR
418 runs in delivery mode\&.
419 .RE
420 .PP
421 \-w \fIN\fR
422 .RS 4
423 The
424 \fB\-w N\fR
425 option places a warning message into the maildir if the maildir has a quota setting, and after the message was successfully delivered the maildir was at least
426 \fIN\fR
427 percent full\&.
428 .RE
429 .PP
430 \-W \fIfilename\fR
431 .RS 4
432 Copy the warning message from
433 \fIfilename\fR, or from
434 /etc/quotawarnmsg
435 if this option is not specified, with the addition of the "Date:" and "Message\-Id:" headers\&. The warning is repeated every 24 hours (at least), until the maildir drops below
436 \fIN\fR
437 percent full\&.
438 .RE
439 .PP
440 \-t \fIsocket\fR
441 .RS 4
442 This option is available if maildrop is compiled with optional Dovecot authentication support\&.
443 \fIsocket\fR
444 specifies the location of Dovecot master authentication socket, for example
445 /var/run/dovecot/auth\-master\&.
446 .RE
447 .SH "DELIVERY MODE"
448 .PP
449 If a
450 filename
451 is not specified on the command line, or if the
452 \fB\-d\fR
453 option is used,
454 \fBmaildrop\fR
455 will run in delivery mode\&. In delivery mode,
456 \fBmaildrop\fR
457 changes to the home directory of the user specified by the
458 \fB\-d\fR
459 option (or the user who is running
460 \fBmaildrop\fR
461 if the
462 \fB\-d\fR
463 option was not given) and reads
464 $HOME/\&.mailfilter
465 for filtering instructions\&.
466 $HOME/\&.mailfilter
467 must be owned by the user, and have no group or global permissions (\fBmaildrop\fR
468 terminates if it does)\&.
469 .PP
470 If
471 $HOME/\&.mailfilter
472 does not exist,
473 \fBmaildrop\fR
474 will simply deliver the message to the user\*(Aqs mailbox\&.
475 .PP
476 If the file
477 /etc/maildroprc
478 exists,
479 \fBmaildrop\fR
480 reads filtering instructions from this file first, before reading
481 $HOME/\&.mailfilter\&. This allows the system administrator to provide global filtering instructions for all users\&.
482 .if n \{\
483 .sp
484 .\}
485 .RS 4
486 .it 1 an-trap
487 .nr an-no-space-flag 1
488 .nr an-break-flag 1
489 .br
490 .ps +1
491 \fBNote\fR
492 .ps -1
493 .br
494 .PP
495 /etc/maildroprc
496 is read only in delivery mode\&.
497 .sp .5v
498 .RE
499 .SH "VIRTUAL ACCOUNTS"
500 .PP
501 The
502 \fB\-d\fR
503 option can also specify a name of a virtual account or mailbox\&. See the
504 \fBmakeuserdb\fR(1)
505 manual page in the
506 Courier
507 Authentication library\*(Aqs documentation for more information\&.
508 .SH "EMBEDDED MODE"
509 .PP
510 The embedded mode is used when
511 \fBmaildrop\fR\*(Aqs filtering abilities are desired, but no actual mail delivery is needed\&. In embedded mode
512 \fBmaildrop\fR
513 is executed by another application, and
514 \m[blue]\fBis passed the \(hym or the \(hyM option\&.\fR\m[]\&\s-2\u[4]\d\s+2
515 \fBmaildrop\fR
516 reads the message, then runs the filtering rules specified in
517 filename\&.
518 .PP
519 filename
520 may contain any filtering instructions EXCEPT the following:
521 .PP
522 ` \&.\&.\&. `
523 .RS 4
524 Text strings delimited by back\-tick characters (run shell command) are not allowed\&.
525 .RE
526 .PP
527 \m[blue]\fBcc\fR\m[]\&\s-2\u[5]\d\s+2
528 .RS 4
529 The
530 \fBcc\fR
531 command is not allowed in embedded mode\&.
532 .RE
533 .PP
534 \m[blue]\fBdotlock\fR\m[]\&\s-2\u[6]\d\s+2
535 .RS 4
536 The
537 \fBdotlock\fR
538 command is not allowed in embedded mode\&.
539 .RE
540 .PP
541 \m[blue]\fBflock\fR\m[]\&\s-2\u[7]\d\s+2
542 .RS 4
543 The
544 \fBflock\fR
545 command is not allowed in embedded mode\&.
546 .RE
547 .PP
548 \m[blue]\fBgdbmopen\fR\m[]\&\s-2\u[8]\d\s+2
549 .RS 4
550 In embedded mode, GDBM databases may be opened only for reading\&.
551 .RE
552 .PP
553 \m[blue]\fBlog\fR\m[]\&\s-2\u[9]\d\s+2
554 .RS 4
555 The
556 \fBlog\fR
557 command is not allowed in embedded mode\&.
558 .RE
559 .PP
560 \m[blue]\fBlogfile\fR\m[]\&\s-2\u[9]\d\s+2
561 .RS 4
562 The
563 \fBlogfile\fR
564 command is not allowed in embedded mode\&.
565 .RE
566 .PP
567 \m[blue]\fBsystem\fR\m[]\&\s-2\u[10]\d\s+2
568 .RS 4
569 The
570 \fBsystem\fR
571 command is not allowed in embedded mode\&.
572 .RE
573 .PP
574 \m[blue]\fBto\fR\m[]\&\s-2\u[11]\d\s+2
575 .RS 4
576 The
577 \fBto\fR
578 command is not allowed in embedded mode\&.
579 .RE
580 .PP
581 \m[blue]\fBxfilter\fR\m[]\&\s-2\u[12]\d\s+2
582 .RS 4
583 The
584 \fBxfilter\fR
585 command is not allowed in embedded mode\&.
586 .RE
587 .PP
588 Normally when the
589 filename
590 does not explicitly delivers a message,
591 \fBmaildrop\fR
592 will deliver the message to the user\*(Aqs default mailbox\&. This is also disabled in embedded mode\&.
593 .PP
594 The
595 filename
596 may communicate with the parent application by using the
597 \m[blue]\fBecho\fR\m[]\&\s-2\u[13]\d\s+2
598 statement and the
599 \fIEXITCODE\fR
600 environment variable\&.
601 .SS "/etc/maildroprcs"
602 .PP
603 If
604 \fBmaildrop\fR
605 encounters an
606 \m[blue]\fBinclude\fR\m[]\&\s-2\u[14]\d\s+2
607 statement where the filename starts with
608 /etc/maildroprcs/, the normal restrictions for the embedded mode are suspended while executing the filter file in the
609 /etc/maildroprcs
610 directory\&. The restrictions are also suspended for any additional filter files that are included from
611 /etc/maildroprcs\&. The restrictions resume once
612 \fBmaildrop\fR
613 finishes executing the file from
614 /etc/maildroprcs\&.
615 .PP
616 This allows the system administrator to have a controlled environment for running external commands (via the backticks, the
617 \m[blue]\fBsystem\fR\m[]\&\s-2\u[10]\d\s+2
618 or the
619 \m[blue]\fBxfilter\fR\m[]\&\s-2\u[12]\d\s+2
620 commands)\&.
621 .PP
622 The name of the file may not contain any periods (so that a creative individual can\*(Aqt write
623 \fIinclude "/etc/maildroprcs/\&.\&./\&.\&./home/user/recipe"\fR)\&.
624 .PP
625 Before executing the commands in the
626 /etc/maildroprcs
627 file,
628 \fBmaildrop\fR
629 automatically resets the following variables to their initial values:
630 \fIDEFAULT\fR,
631 \fIHOME\fR,
632 \fILOCKEXT\fR,
633 \fILOCKSLEEP\fR,
634 \fILOCKTIMEOUT\fR,
635 \fILOCKREFRESH\fR,
636 \fILOGNAME\fR,
637 \fIPATH\fR,
638 \fISENDMAIL\fR, and
639 \fISHELL\fR\&. Please note that the previous values of these variables (if they were changed) will NOT be restored once
640 \fBmaildrop\fR
641 finishes executing the commands from
642 /etc/maildroprcs\&.
643 .SH "WATCHDOG TIMER"
644 .PP
645 \fBmaildrop\fR
646 has a watchdog timer that attempts to abort runaway filtering\&. If filtering is not complete within a predefined time interval (defined by the system administrator, usually five minutes),
647 \fBmaildrop\fR
648 terminates\&.
649 .SH "FILES"
650 .PP
651 /etc/passwd
652 .RS 4
653 Sets user\*(Aqs home directory, and related variables\&. If NIS/YP is install, that will be used as well\&.
654 .RE
655 .PP
656 /etc/maildroprc
657 .RS 4
658 Global filtering instructions for delivery mode\&.
659 .RE
660 .PP
661 /var/mail
662 .RS 4
663 System mailbox (actual directory defined by the system administrator)\&.
664 .RE
665 .PP
666 /usr/sbin/sendmail
667 .RS 4
668 Program to forward mail (exact program defined by the system administrator)\&.
669 .RE
670 .PP
671 $HOME/\&.mailfilter
672 .RS 4
673 Filtering instructions in delivery mode\&.
674 .RE
675 .PP
676 $HOME/\&.mailfilters
677 .RS 4
678 Directory containing files used in special embedded mode\&.
679 .RE
680 .SH "SEE ALSO"
681 .PP
682 \m[blue]\fB\fBlockmail\fR(1)\fR\m[]\&\s-2\u[15]\d\s+2,
683 \m[blue]\fB\fBmaildropfilter\fR(7)\fR\m[]\&\s-2\u[16]\d\s+2,
684 \m[blue]\fB\fBmakedat\fR(1)\fR\m[]\&\s-2\u[17]\d\s+2,
685 \m[blue]\fB\fBmaildropgdbm\fR(7)\fR\m[]\&\s-2\u[8]\d\s+2,
686 \m[blue]\fB\fBmaildropex\fR(7)\fR\m[]\&\s-2\u[18]\d\s+2,
687 \m[blue]\fB\fBreformail\fR(1)\fR\m[]\&\s-2\u[19]\d\s+2,
688 \m[blue]\fB\fBmakemime\fR(1)\fR\m[]\&\s-2\u[20]\d\s+2,
689 \m[blue]\fB\fBreformime\fR(1)\fR\m[]\&\s-2\u[21]\d\s+2,
690 \fBegrep\fR(1),
691 \fBgrep\fR(1), ,
692 \m[blue]\fB\fBcourier\fR(8)\fR\m[]\&\s-2\u[22]\d\s+2,
693 \fBsendmail\fR(8)\&.
694 .SH "AUTHOR"
695 .PP
696 \fBSam Varshavchik\fR
697 .RS 4
698 Author
699 .RE
700 .SH "NOTES"
701 .IP " 1." 4
702 Courier
703 .RS 4
704 \%https://www.courier-mta.org
705 .RE
706 .IP " 2." 4
707 "Environment"
708 .RS 4
709 \%http://www.courier-mta.org/maildrop/maildropfilter.html#environment
710 .RE
711 .IP " 3." 4
712 "Variable substitution"
713 .RS 4
714 \%http://www.courier-mta.org/maildrop/maildropfilter.html#varsubst
715 .RE
716 .IP " 4." 4
717 is passed the \(hym or the \(hyM option.
718 .RS 4
719 \%http://www.courier-mta.org/maildrop/#options
720 .RE
721 .IP " 5." 4
722 cc
723 .RS 4
724 \%http://www.courier-mta.org/maildrop/maildropfilter.html#cc
725 .RE
726 .IP " 6." 4
727 dotlock
728 .RS 4
729 \%http://www.courier-mta.org/maildrop/maildropfilter.html#dotlock
730 .RE
731 .IP " 7." 4
732 flock
733 .RS 4
734 \%http://www.courier-mta.org/maildrop/maildropfilter.html#flock
735 .RE
736 .IP " 8." 4
737 gdbmopen
738 .RS 4
739 \%http://www.courier-mta.org/maildrop/maildropgdbm.html
740 .RE
741 .IP " 9." 4
742 log
743 .RS 4
744 \%http://www.courier-mta.org/maildrop/maildropfilter.html#log
745 .RE
746 .IP "10." 4
747 system
748 .RS 4
749 \%http://www.courier-mta.org/maildrop/maildropfilter.html#system
750 .RE
751 .IP "11." 4
752 to
753 .RS 4
754 \%http://www.courier-mta.org/maildrop/maildropfilter.html#to
755 .RE
756 .IP "12." 4
757 xfilter
758 .RS 4
759 \%http://www.courier-mta.org/maildrop/maildropfilter.html#xfilter
760 .RE
761 .IP "13." 4
762 echo
763 .RS 4
764 \%http://www.courier-mta.org/maildrop/maildropfilter.html#echo
765 .RE
766 .IP "14." 4
767 include
768 .RS 4
769 \%http://www.courier-mta.org/maildrop/maildropfilter.html#include
770 .RE
771 .IP "15." 4
772 \fBlockmail\fR(1)
773 .RS 4
774 \%http://www.courier-mta.org/maildrop/lockmail.html
775 .RE
776 .IP "16." 4
777 \fBmaildropfilter\fR(7)
778 .RS 4
779 \%http://www.courier-mta.org/maildrop/maildropfilter.html
780 .RE
781 .IP "17." 4
782 \fBmakedat\fR(1)
783 .RS 4
784 \%http://www.courier-mta.org/maildrop/makedat.html
785 .RE
786 .IP "18." 4
787 \fBmaildropex\fR(7)
788 .RS 4
789 \%http://www.courier-mta.org/maildrop/maildropex.html
790 .RE
791 .IP "19." 4
792 \fBreformail\fR(1)
793 .RS 4
794 \%http://www.courier-mta.org/maildrop/reformail.html
795 .RE
796 .IP "20." 4
797 \fBmakemime\fR(1)
798 .RS 4
799 \%http://www.courier-mta.org/maildrop/makemime.html
800 .RE
801 .IP "21." 4
802 \fBreformime\fR(1)
803 .RS 4
804 \%http://www.courier-mta.org/maildrop/reformime.html
805 .RE
806 .IP "22." 4
807 \fBcourier\fR(8)
808 .RS 4
809 \%http://www.courier-mta.org/maildrop/courier.html
810 .RE