diff options
Diffstat (limited to 'html/socketmap_table.5.html')
| -rw-r--r-- | html/socketmap_table.5.html | 101 |
1 files changed, 101 insertions, 0 deletions
diff --git a/html/socketmap_table.5.html b/html/socketmap_table.5.html new file mode 100644 index 0000000..1387fb3 --- /dev/null +++ b/html/socketmap_table.5.html @@ -0,0 +1,101 @@ +<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html> <head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title> Postfix manual - socketmap_table(5) </title> +</head> <body> <pre> +SOCKETMAP_TABLE(5) SOCKETMAP_TABLE(5) + +<b>NAME</b> + socketmap_table - Postfix socketmap table lookup client + +<b>SYNOPSIS</b> + <b>postmap -q "</b><i>string</i><b>" <a href="socketmap_table.html">socketmap</a>:inet:</b><i>host</i><b>:</b><i>port</i><b>:</b><i>name</i> + <b>postmap -q "</b><i>string</i><b>" <a href="socketmap_table.html">socketmap</a>:unix:</b><i>pathname</i><b>:</b><i>name</i> + + <b>postmap -q - <a href="socketmap_table.html">socketmap</a>:inet:</b><i>host</i><b>:</b><i>port</i><b>:</b><i>name</i> <<i>inputfile</i> + <b>postmap -q - <a href="socketmap_table.html">socketmap</a>:unix:</b><i>pathname</i><b>:</b><i>name</i> <<i>inputfile</i> + +<b>DESCRIPTION</b> + The Postfix mail system uses optional tables for address rewriting. + mail routing or policy lookup. + + The Postfix socketmap client expects TCP endpoint names of the form + <b>inet:</b><i>host</i><b>:</b><i>port</i><b>:</b><i>name</i>, or UNIX-domain endpoints of the form <b>unix:</b><i>path-</i> + <i>name</i><b>:</b><i>name</i>. In both cases, <i>name</i> specifies the name field in a socketmap + client request (see "REQUEST FORMAT" below). + +<b>PROTOCOL</b> + Socketmaps use a simple protocol: the client sends one request, and the + server sends one reply. Each request and each reply are sent as one + netstring object. + +<b>REQUEST FORMAT</b> + The socketmap protocol supports only the lookup request. The request + has the following form: + + <i>name</i> <<b>space</b>> <i>key</i> + Search the named socketmap for the specified key. + + Postfix will not generate partial search keys such as domain names + without one or more subdomains, network addresses without one or more + least-significant octets, or email addresses without the localpart, + address extension or domain portion. This behavior is also found with + <a href="cidr_table.5.html">cidr</a>:, <a href="pcre_table.5.html">pcre</a>:, and <a href="regexp_table.5.html">regexp</a>: tables. + +<b>REPLY FORMAT</b> + The Postfix socketmap client requires that replies are not longer than + 100000 characters (not including the netstring encapsulation). Replies + must have the following form: + + <b>OK</b> <<b>space</b>> <i>data</i> + The requested data was found. + + <b>NOTFOUND</b> <<b>space</b>> + The requested data was not found. + + <b>TEMP</b> <<b>space</b>> <i>reason</i> + + <b>TIMEOUT</b> <<b>space</b>> <i>reason</i> + + <b>PERM</b> <<b>space</b>> <i>reason</i> + The request failed. The reason, if non-empty, is descriptive + text. + +<b>SECURITY</b> + This map cannot be used for security-sensitive information, + because neither the connection nor the server are authenticated. + +<b>SEE ALSO</b> + <a href="http://cr.yp.to/proto/netstrings.txt">http://cr.yp.to/proto/netstrings.txt</a>, netstring definition + <a href="postconf.1.html">postconf(1)</a>, Postfix supported lookup tables + <a href="postmap.1.html">postmap(1)</a>, Postfix lookup table manager + <a href="regexp_table.5.html">regexp_table(5)</a>, format of regular expression tables + <a href="pcre_table.5.html">pcre_table(5)</a>, format of PCRE tables + <a href="cidr_table.5.html">cidr_table(5)</a>, format of CIDR tables + +<b>README FILES</b> + <a href="DATABASE_README.html">DATABASE_README</a>, Postfix lookup table overview + +<b>BUGS</b> + The protocol limits are not yet configurable. + +<b>LICENSE</b> + The Secure Mailer license must be distributed with this software. + +<b>HISTORY</b> + Socketmap support was introduced with Postfix version 2.10. + +<b>AUTHOR(S)</b> + 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 + + SOCKETMAP_TABLE(5) +</pre> </body> </html> |