QSHAPE(1)                                                            QSHAPE(1)

名称
       qshape - 显示 Postfix 队列的域名分布和邮件时效分布

概要
       qshape [-s] [-p] [-m min_subdomains]
               [-b bucket_count] [-t bucket_time]
               [-l] [-w terminal_width]
               [-N batch_msg_count] [-n batch_top_domains]
               [-c config_directory] [queue_name ...]

描述
       qshape 工具可帮助管理员分析 Postfix 队列中邮件的时效分布特征，
       以及按发件域或收件域的分布情况。该程序需要读取队列目录和队列文件的权限，
       因此必须以超级用户或 main.cf 中指定的 mail_owner 身份运行
       (通常为 postfix)。

       选项说明：

       -s     显示发件域分布而非收件域分布。默认显示收件域分布。
              由于单封邮件可能包含多个收件人，但只有一个发件人，
              因此发件域分布实际上反映的是邮件数量分布。

       -p     生成父域的聚合统计信息。不会显示顶级域名，
              也不会显示子域数量少于 min_subdomains 的父域。
              父域名显示时以点号开头（例如 .example.com）。

       -m min_subdomains
              与 -p 选项配合使用，设置显示父域所需的最小子域数量。
              默认值为 5。

       -b bucket_count
              将邮件时效分布划分为若干几何增长的区间（称为"桶"）。
              本选项指定区间数量。每个区间的最大时效值是前一个区间的两倍，
              最后一个区间无时效限制。

       -t bucket_time
              第一个时效区间的时间上限（分钟）。默认值为 5，
              表示第一个区间统计 0-5 分钟内的邮件。

       -l     使用线性而非几何增长的时效区间序列，
              即每个区间的时效值为 bucket_time 的整数倍。

              此功能在 Postfix 2.2 及更高版本中可用。

       -w terminal_width
              输出内容采用右对齐格式，最后一个区间的统计数字显示在第 80 列。
              可调整此参数适应更宽的屏幕显示更多区间，
              避免左侧域名被截断。当完整域名及其统计信息超出指定列宽时：
              - 普通域名只显示最后 17 字节，前缀用"+"代替
              - 父域名显示为".+"加最后 16 字节
              若仍无法完整显示，将突破终端宽度限制。

       -N batch_msg_count
              当输出到终端时，每处理 batch_msg_count 封邮件就显示中间结果。
              这样即使处理大型 deferred 队列 也能快速获得可用数据。
              默认每处理 1000 封邮件显示一次。

       -n batch_top_domains
              在终端显示中间或最终结果时，
              仅显示前 batch_top_domains 个域名。
              默认显示前 20 个域名。

       -c config_directory
              指定 main.cf 配置文件所在目录（替代默认配置目录）。

       参数说明：

       queue_name
              默认显示 incoming 和 active 队列 的合并分布。
              要显示其他队列的分布，只需在命令行指定队列目录名。
              绝对路径直接使用，相对路径基于 main.cf 中
              queue_directory 参数的设置。注意：
              - qshape 不支持 queue_directory 中的变量扩展
              - 若必须使用变量，需为每个队列子目录指定绝对路径

参见
       mailq(1)，列出队列中的所有邮件。
       QSHAPE_README，使用示例和技术背景。

文件
       $config_directory/main.cf，Postfix 配置参数。
       $queue_directory/maildrop/，本地邮件提交目录。
       $queue_directory/incoming/，新邮件队列。
       $queue_directory/hold/，待技术支持处理的邮件。
       $queue_directory/active/，待投递的邮件。
       $queue_directory/deferred/，延迟投递的邮件。

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

作者
       Victor Duchovni
       Morgan Stanley

                                                                     QSHAPE(1)