SOCKETMAP_TABLE(5)                                          SOCKETMAP_TABLE(5)

名称
       socketmap_table - Postfix 套接字映射表查询客户端

概要
       postmap -q "字符串" socketmap:inet:主机:端口:名称
       postmap -q "字符串" socketmap:unix:路径:名称

       postmap -q - socketmap:inet:主机:端口:名称 <输入文件
       postmap -q - socketmap:unix:路径:名称 <输入文件

描述
       Postfix 邮件系统使用可选表进行地址重写、邮件路由或策略查询。

       Postfix socketmap 客户端支持的 TCP 端点格式为 inet:主机:端口:名称，
       或 UNIX 域端点格式为 unix:路径:名称。两种情况下，名称 参数都用于指定
       socketmap 客户端请求中的名称字段（参见下文"请求格式"）。

协议
       Socketmap 使用简单协议：客户端发送一个请求，服务器返回一个响应。
       每个请求和响应都以单个 netstring 对象形式传输。

请求格式
       套接字映射协议仅支持查询请求，格式如下：

       名称 <空格> 键值
              在指定的 socketmap 中搜索对应键值。

       Postfix 不会生成部分搜索键，例如：
       - 缺少子域的域名
       - 缺少低位字节的网络地址
       - 缺少本地部分、地址扩展或域部分的电子邮件地址
       此行为与 cidr:、pcre: 和 regexp: 表一致。

响应格式
       响应必须符合以下格式：

       OK <空格> 数据
              成功找到请求的数据。

       NOTFOUND <空格>
              未找到请求的数据。

       TEMP <空格> 原因
       TIMEOUT <空格> 原因
       PERM <空格> 原因
              请求失败。原因字段为可选的描述性文本。

协议限制
       Postfix socketmap 客户端要求响应长度不超过 100,000 字节（不包括 netstring 封装）。
       此限制可通过 socketmap_max_reply_size 配置参数调整（Postfix 3.10 及更高版本）。

       连接 socketmap 服务器、发送请求和接收响应的总时间限制为 100 秒。
       空闲连接会在 10 秒后关闭，活动连接会在 100 秒后关闭。
       目前这些时间限制尚不可配置。

安全性
       由于连接和服务器都未经认证，此映射不能用于存储敏感信息。

配置参数
       socketmap_max_reply_size (100000)
              socketmap 服务器返回的最大响应大小（不包括 netstring 封装）。

参见
       https://cr.yp.to/proto/netstrings.txt, netstring 定义
       postconf(1), Postfix 支持的查询表
       postmap(1), Postfix 查询表管理器
       regexp_table(5), 正则表达式表格式
       pcre_table(5), PCRE 表格式
       cidr_table(5), CIDR 表格式

自述文件
       DATABASE_README, Postfix 查询表概述

已知问题
       协议时间限制目前不可配置。

许可
       必须随本软件分发 Secure Mailer 许可证。

历史
       Socketmap 支持随 Postfix 2.10 版本引入。
       该协议最初随 Sendmail v8.13 发布。

作者
       Wietse Venema
       IBM T.J. Watson 研究中心
       邮政信箱 704
       美国纽约州约克镇高地 10598

       Wietse Venema
       Google 公司
       纽约第八大道 111 号
       美国纽约州纽约市 10011

       Wietse Venema
       porcupine.org

                                                            SOCKETMAP_TABLE(5)