NetBSD/gnu/dist/postfix/man/man5/access.5

87 lines
2.2 KiB
Groff

.TH ACCESS 5
.ad
.fi
.SH NAME
access
\-
format of Postfix access table
.SH SYNOPSIS
.na
.nf
\fBpostmap /etc/postfix/access\fR
.SH DESCRIPTION
.ad
.fi
The optional \fBaccess\fR table directs the Postfix SMTP server
to selectively reject or accept mail from or to specific hosts,
domains, networks, host addresses or mail addresses.
The table serves as input to the \fBpostmap\fR(1) command. The
result, an indexed file in \fBdbm\fR or \fBdb\fR format,
is used for fast searching by the mail system. After an update
it may take a minute or so before the change becomes visible.
Issue a \fBpostfix reload\fR command to eliminate the delay.
The format of the access table is as follows:
.IP "blanks and comments"
Blank lines are ignored, as are lines beginning with `#'.
.IP "\fIpattern action\fR"
When \fIpattern\fR matches a mail address, domain or host address,
perform the corresponding \fIaction\fR.
.SH PATTERNS
.na
.nf
Patterns are tried in the order as listed below:
.ad
.fi
.IP \fIuser\fR@\fIdomain\fR
Matches the specified mail address.
.IP \fIdomain.name\fR
Matches the \fIdomain.name\fR itself and any subdomain thereof,
either in hostnames or in mail addresses. Top-level domains will
never be matched.
.IP \fIuser\fR@
Matches all mail addresses with the specified user part.
.IP \fInet.work.addr.ess\fR
.IP \fInet.work.addr\fR
.IP \fInet.work\fR
.IP \fInet\fR
Matches any host address in the specified network. A network
address is a sequence of one or more octets separated by ".".
.SH ACTIONS
.na
.nf
.ad
.fi
.IP "[\fB45\fR]\fIXX text\fR"
Reject the address etc. that matches the pattern, and respond with
the numerical code and text.
.IP \fBREJECT\fR
Reject the address etc. that matches the pattern. A generic
error response message is generated.
.IP \fBOK\fR
.IP "\fIAny other text\fR"
Accept the address etc. that matches the pattern.
.SH BUGS
.ad
.fi
The table format does not understand quoting conventions.
.SH SEE ALSO
.na
.nf
postmap(1) create mapping table
smtpd(8) smtp server
.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