debian/rules: Use `git' potty wrapper.
[qmail] / preline.1
1 .TH preline 1
2 .SH NAME
3 preline \- prepend lines to message
4 .SH SYNOPSIS
5 in
6 .BR .qmail\fIext :
7 .B | preline \fIcommand
8 .SH DESCRIPTION
9 .B preline
10 feeds each incoming mail message through
11 .IR command .
12 At the top of each message it inserts
13 a UUCP-style
14 .B From_
15 line, a
16 .B Return-Path
17 line, and a
18 .B Delivered-To
19 line.
20
21 .B preline
22 is useful for
23 .B procmail
24 and
25 ELM's
26 .BR filter ,
27 which
28 do not understand the
29 .B qmail-command
30 environment variables.
31 .SH OPTIONS
32 .TP
33 .B \-d
34 Do not include the
35 .B Delivered-To
36 line. You should use this option when the
37 recipient of the incoming mail message is actually under remote control,
38 but was sent here through
39 .B control/virtualdomains
40 for manual routing.
41 .TP
42 .B \-f
43 Do not include the
44 .B From_
45 line. You should use this option except for
46 .IR command s
47 that create
48 .I mbox
49 files.
50 .TP
51 .B \-r
52 Do not include the
53 .B Return-Path
54 line.
55 .SH "SEE ALSO"
56 mbox(5),
57 qmail-command(8)