262 lines
9.2 KiB
Groff
262 lines
9.2 KiB
Groff
.TH POSTALIAS 1
|
|
.ad
|
|
.fi
|
|
.SH NAME
|
|
postalias
|
|
\-
|
|
Postfix alias database maintenance
|
|
.SH "SYNOPSIS"
|
|
.na
|
|
.nf
|
|
.fi
|
|
\fBpostalias\fR [\fB\-Nfinoprsuvw\fR] [\fB\-c \fIconfig_dir\fR]
|
|
[\fB\-d \fIkey\fR] [\fB\-q \fIkey\fR]
|
|
[\fIfile_type\fR:]\fIfile_name\fR ...
|
|
.SH DESCRIPTION
|
|
.ad
|
|
.fi
|
|
The \fBpostalias\fR(1) command creates or queries one or more Postfix
|
|
alias databases, or updates an existing one. The input and output
|
|
file formats are expected to be compatible with Sendmail version 8,
|
|
and are expected to be suitable for use as NIS alias maps.
|
|
|
|
If the result files do not exist they will be created with the
|
|
same group and other read permissions as their source file.
|
|
|
|
While a database update is in progress, signal delivery is
|
|
postponed, and an exclusive, advisory, lock is placed on the
|
|
entire database, in order to avoid surprises in spectator
|
|
processes.
|
|
|
|
The format of Postfix alias input files is described in
|
|
\fBaliases\fR(5).
|
|
|
|
By default the lookup key is mapped to lowercase to make
|
|
the lookups case insensitive; as of Postfix 2.3 this case
|
|
folding happens only with tables whose lookup keys are
|
|
fixed\-case strings such as btree:, dbm: or hash:. With
|
|
earlier versions, the lookup key is folded even with tables
|
|
where a lookup field can match both upper and lower case
|
|
text, such as regexp: and pcre:. This resulted in loss of
|
|
information with $\fInumber\fR substitutions.
|
|
|
|
Options:
|
|
.IP "\fB\-c \fIconfig_dir\fR"
|
|
Read the \fBmain.cf\fR configuration file in the named directory
|
|
instead of the default configuration directory.
|
|
.IP "\fB\-d \fIkey\fR"
|
|
Search the specified maps for \fIkey\fR and remove one entry per map.
|
|
The exit status is zero when the requested information was found.
|
|
|
|
If a key value of \fB\-\fR is specified, the program reads key
|
|
values from the standard input stream. The exit status is zero
|
|
when at least one of the requested keys was found.
|
|
.IP \fB\-f\fR
|
|
Do not fold the lookup key to lower case while creating or querying
|
|
a table.
|
|
|
|
With Postfix version 2.3 and later, this option has no
|
|
effect for regular expression tables. There, case folding
|
|
is controlled by appending a flag to a pattern.
|
|
.IP \fB\-i\fR
|
|
Incremental mode. Read entries from standard input and do not
|
|
truncate an existing database. By default, \fBpostalias\fR(1) creates
|
|
a new database from the entries in \fIfile_name\fR.
|
|
.IP \fB\-N\fR
|
|
Include the terminating null character that terminates lookup keys
|
|
and values. By default, \fBpostalias\fR(1) does whatever
|
|
is the default for
|
|
the host operating system.
|
|
.IP \fB\-n\fR
|
|
Don't include the terminating null character that terminates lookup
|
|
keys and values. By default, \fBpostalias\fR(1) does whatever
|
|
is the default for
|
|
the host operating system.
|
|
.IP \fB\-o\fR
|
|
Do not release root privileges when processing a non\-root
|
|
input file. By default, \fBpostalias\fR(1) drops root privileges
|
|
and runs as the source file owner instead.
|
|
.IP \fB\-p\fR
|
|
Do not inherit the file access permissions from the input file
|
|
when creating a new file. Instead, create a new file with default
|
|
access permissions (mode 0644).
|
|
.IP "\fB\-q \fIkey\fR"
|
|
Search the specified maps for \fIkey\fR and write the first value
|
|
found to the standard output stream. The exit status is zero
|
|
when the requested information was found.
|
|
|
|
Note: this performs a single query with the key as specified,
|
|
and does not make iterative queries with substrings of the
|
|
key as described in the aliases(5) manual page.
|
|
|
|
If a key value of \fB\-\fR is specified, the program reads key
|
|
values from the standard input stream and writes one line of
|
|
\fIkey: value\fR output for each key that was found. The exit
|
|
status is zero when at least one of the requested keys was found.
|
|
.IP \fB\-r\fR
|
|
When updating a table, do not complain about attempts to update
|
|
existing entries, and make those updates anyway.
|
|
.IP \fB\-s\fR
|
|
Retrieve all database elements, and write one line of
|
|
\fIkey: value\fR output for each element. The elements are
|
|
printed in database order, which is not necessarily the same
|
|
as the original input order.
|
|
This feature is available in Postfix version 2.2 and later,
|
|
and is not available for all database types.
|
|
.IP \fB\-u\fR
|
|
Disable UTF\-8 support. UTF\-8 support is enabled by default
|
|
when "smtputf8_enable = yes". It requires that keys and
|
|
values are valid UTF\-8 strings.
|
|
.IP \fB\-v\fR
|
|
Enable verbose logging for debugging purposes. Multiple \fB\-v\fR
|
|
options make the software increasingly verbose.
|
|
.IP \fB\-w\fR
|
|
When updating a table, do not complain about attempts to update
|
|
existing entries, and ignore those attempts.
|
|
.PP
|
|
Arguments:
|
|
.IP \fIfile_type\fR
|
|
The database type. To find out what types are supported, use
|
|
the "\fBpostconf \-m\fR" command.
|
|
|
|
The \fBpostalias\fR(1) command can query any supported file type,
|
|
but it can create only the following file types:
|
|
.RS
|
|
.IP \fBbtree\fR
|
|
The output is a btree file, named \fIfile_name\fB.db\fR.
|
|
This is available on systems with support for \fBdb\fR databases.
|
|
.IP \fBcdb\fR
|
|
The output is one file named \fIfile_name\fB.cdb\fR.
|
|
This is available on systems with support for \fBcdb\fR databases.
|
|
.IP \fBdbm\fR
|
|
The output consists of two files, named \fIfile_name\fB.pag\fR and
|
|
\fIfile_name\fB.dir\fR.
|
|
This is available on systems with support for \fBdbm\fR databases.
|
|
.IP \fBfail\fR
|
|
A table that reliably fails all requests. The lookup table
|
|
name is used for logging only. This table exists to simplify
|
|
Postfix error tests.
|
|
.IP \fBhash\fR
|
|
The output is a hashed file, named \fIfile_name\fB.db\fR.
|
|
This is available on systems with support for \fBdb\fR databases.
|
|
.IP \fBlmdb\fR
|
|
The output is a btree\-based file, named \fIfile_name\fB.lmdb\fR.
|
|
\fBlmdb\fR supports concurrent writes and reads from different
|
|
processes, unlike other supported file\-based tables.
|
|
This is available on systems with support for \fBlmdb\fR databases.
|
|
.IP \fBsdbm\fR
|
|
The output consists of two files, named \fIfile_name\fB.pag\fR and
|
|
\fIfile_name\fB.dir\fR.
|
|
This is available on systems with support for \fBsdbm\fR databases.
|
|
.PP
|
|
When no \fIfile_type\fR is specified, the software uses the database
|
|
type specified via the \fBdefault_database_type\fR configuration
|
|
parameter.
|
|
The default value for this parameter depends on the host environment.
|
|
.RE
|
|
.IP \fIfile_name\fR
|
|
The name of the alias database source file when creating a database.
|
|
.SH DIAGNOSTICS
|
|
.ad
|
|
.fi
|
|
Problems are logged to the standard error stream and to
|
|
\fBsyslogd\fR(8) or \fBpostlogd\fR(8). No output means that
|
|
no problems were detected. Duplicate entries are skipped and are
|
|
flagged with a warning.
|
|
|
|
\fBpostalias\fR(1) terminates with zero exit status in case of success
|
|
(including successful "\fBpostalias \-q\fR" lookup) and terminates
|
|
with non\-zero exit status in case of failure.
|
|
.SH "ENVIRONMENT"
|
|
.na
|
|
.nf
|
|
.ad
|
|
.fi
|
|
.IP \fBMAIL_CONFIG\fR
|
|
Directory with Postfix configuration files.
|
|
.IP \fBMAIL_VERBOSE\fR
|
|
Enable verbose logging for debugging purposes.
|
|
.SH "CONFIGURATION PARAMETERS"
|
|
.na
|
|
.nf
|
|
.ad
|
|
.fi
|
|
The following \fBmain.cf\fR parameters are especially relevant to
|
|
this program.
|
|
|
|
The text below provides only a parameter summary. See
|
|
\fBpostconf\fR(5) for more details including examples.
|
|
.IP "\fBalias_database (see 'postconf -d' output)\fR"
|
|
The alias databases for \fBlocal\fR(8) delivery that are updated with
|
|
"\fBnewaliases\fR" or with "\fBsendmail \-bi\fR".
|
|
.IP "\fBconfig_directory (see 'postconf -d' output)\fR"
|
|
The default location of the Postfix main.cf and master.cf
|
|
configuration files.
|
|
.IP "\fBberkeley_db_create_buffer_size (16777216)\fR"
|
|
The per\-table I/O buffer size for programs that create Berkeley DB
|
|
hash or btree tables.
|
|
.IP "\fBberkeley_db_read_buffer_size (131072)\fR"
|
|
The per\-table I/O buffer size for programs that read Berkeley DB
|
|
hash or btree tables.
|
|
.IP "\fBdefault_database_type (see 'postconf -d' output)\fR"
|
|
The default database type for use in \fBnewaliases\fR(1), \fBpostalias\fR(1)
|
|
and \fBpostmap\fR(1) commands.
|
|
.IP "\fBimport_environment (see 'postconf -d' output)\fR"
|
|
The list of environment variables that a privileged Postfix
|
|
process will import from a non\-Postfix parent process, or name=value
|
|
environment overrides.
|
|
.IP "\fBsmtputf8_enable (yes)\fR"
|
|
Enable preliminary SMTPUTF8 support for the protocols described
|
|
in RFC 6531, RFC 6532, and RFC 6533.
|
|
.IP "\fBsyslog_facility (mail)\fR"
|
|
The syslog facility of Postfix logging.
|
|
.IP "\fBsyslog_name (see 'postconf -d' output)\fR"
|
|
A prefix that is prepended to the process name in syslog
|
|
records, so that, for example, "smtpd" becomes "prefix/smtpd".
|
|
.PP
|
|
Available in Postfix 2.11 and later:
|
|
.IP "\fBlmdb_map_size (16777216)\fR"
|
|
The initial OpenLDAP LMDB database size limit in bytes.
|
|
.SH "STANDARDS"
|
|
.na
|
|
.nf
|
|
RFC 822 (ARPA Internet Text Messages)
|
|
.SH "SEE ALSO"
|
|
.na
|
|
.nf
|
|
aliases(5), format of alias database input file.
|
|
local(8), Postfix local delivery agent.
|
|
postconf(1), supported database types
|
|
postconf(5), configuration parameters
|
|
postmap(1), create/update/query lookup tables
|
|
newaliases(1), Sendmail compatibility interface.
|
|
postlogd(8), Postfix logging
|
|
syslogd(8), system logging
|
|
.SH "README FILES"
|
|
.na
|
|
.nf
|
|
.ad
|
|
.fi
|
|
Use "\fBpostconf readme_directory\fR" or
|
|
"\fBpostconf html_directory\fR" to locate this information.
|
|
.na
|
|
.nf
|
|
DATABASE_README, Postfix lookup table overview
|
|
.SH "LICENSE"
|
|
.na
|
|
.nf
|
|
.ad
|
|
.fi
|
|
The Secure Mailer license must be distributed with this software.
|
|
.SH "AUTHOR(S)"
|
|
.na
|
|
.nf
|
|
Wietse Venema
|
|
IBM T.J. Watson Research
|
|
P.O. Box 704
|
|
Yorktown Heights, NY 10598, USA
|
|
|
|
Wietse Venema
|
|
Google, Inc.
|
|
111 8th Avenue
|
|
New York, NY 10011, USA
|