~ubuntu-branches/ubuntu/maverick/postfix/maverick-security

« back to all changes in this revision

Viewing changes to man/man1/postmap.1

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones, Wietse Venema, LaMont Jones
  • Date: 2009-06-03 14:17:08 UTC
  • mfrom: (1.1.22 upstream)
  • Revision ID: james.westby@ubuntu.com-20090603141708-o9u59xlor7nmd2x1
[Wietse Venema]

* New upstream release: 2.6.2~rc1

[LaMont Jones]

* move postfix-add-{filter,policy} manpages to section 8, and deliver
* provide: default-mta on ubuntu

Show diffs side-by-side

added added

removed removed

Lines of Context:
9
9
.na
10
10
.nf
11
11
.fi
12
 
\fBpostmap\fR [\fB-Nfinoprsvw\fR] [\fB-c \fIconfig_dir\fR]
 
12
\fBpostmap\fR [\fB-Nbfhimnoprsvw\fR] [\fB-c \fIconfig_dir\fR]
13
13
[\fB-d \fIkey\fR] [\fB-q \fIkey\fR]
14
14
        [\fIfile_type\fR:]\fIfile_name\fR ...
15
15
.SH DESCRIPTION
67
67
.nf
68
68
.ad
69
69
.fi
 
70
.IP \fB-b\fR
 
71
Enable message body query mode. When reading lookup keys
 
72
from standard input with "\fB-q -\fR", process the input
 
73
as if it is an email message in RFC 2822 format.  Each line
 
74
of body content becomes one lookup key.
 
75
.sp
 
76
By default, the \fB-b\fR option starts generating lookup
 
77
keys at the first non-header line, and stops when the end
 
78
of the message is reached.
 
79
To simulate \fBbody_checks\fR(5) processing, enable MIME
 
80
parsing with \fB-m\fR. With this, the \fB-b\fR option
 
81
generates no body-style lookup keys for attachment MIME
 
82
headers and for attached message/* headers.
 
83
.sp
 
84
This feature is available in Postfix version 2.6 and later.
70
85
.IP "\fB-c \fIconfig_dir\fR"
71
86
Read the \fBmain.cf\fR configuration file in the named directory
72
87
instead of the default configuration directory.
84
99
With Postfix version 2.3 and later, this option has no
85
100
effect for regular expression tables. There, case folding
86
101
is controlled by appending a flag to a pattern.
 
102
.IP \fB-h\fR
 
103
Enable message header query mode. When reading lookup keys
 
104
from standard input with "\fB-q -\fR", process the input
 
105
as if it is an email message in RFC 2822 format.  Each
 
106
logical header line becomes one lookup key. A multi-line
 
107
header becomes one lookup key with one or more embedded
 
108
newline characters.
 
109
.sp
 
110
By default, the \fB-h\fR option generates lookup keys until
 
111
the first non-header line is reached.
 
112
To simulate \fBheader_checks\fR(5) processing, enable MIME
 
113
parsing with \fB-m\fR. With this, the \fB-h\fR option also
 
114
generates header-style lookup keys for attachment MIME
 
115
headers and for attached message/* headers.
 
116
.sp
 
117
This feature is available in Postfix version 2.6 and later.
87
118
.IP \fB-i\fR
88
119
Incremental mode. Read entries from standard input and do not
89
120
truncate an existing database. By default, \fBpostmap\fR(1) creates
90
121
a new database from the entries in \fBfile_name\fR.
 
122
.IP \fB-m\fR
 
123
Enable MIME parsing with "\fB-b\fR" and "\fB-h\fR".
 
124
.sp
 
125
This feature is available in Postfix version 2.6 and later.
91
126
.IP \fB-N\fR
92
127
Include the terminating null character that terminates lookup keys
93
128
and values. By default, \fBpostmap\fR(1) does whatever is
123
158
\fIkey value\fR output for each element. The elements are
124
159
printed in database order, which is not necessarily the same
125
160
as the original input order.
 
161
.sp
126
162
This feature is available in Postfix version 2.2 and later,
127
163
and is not available for all database types.
128
164
.IP \fB-v\fR
207
243
and \fBpostmap\fR(1) commands.
208
244
.IP "\fBsyslog_facility (mail)\fR"
209
245
The syslog facility of Postfix logging.
210
 
.IP "\fBsyslog_name (postfix)\fR"
 
246
.IP "\fBsyslog_name (see 'postconf -d' output)\fR"
211
247
The mail system name that is prepended to the process name in syslog
212
248
records, so that "smtpd" becomes, for example, "postfix/smtpd".
213
249
.SH "SEE ALSO"