<!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=us-ascii"> <title> Postfix manual - qshape(1) </title> </head> <body> <pre> QSHAPE(1) QSHAPE(1) <b>NAME</b> qshape - Print Postfix queue domain and age distribution <b>SYNOPSIS</b> <b>qshape</b> [<b>-s</b>] [<b>-p</b>] [<b>-m</b> <i>min</i><b>_</b><i>subdomains</i>] [<b>-b</b> <i>bucket</i><b>_</b><i>count</i>] [<b>-t</b> <i>bucket</i><b>_</b><i>time</i>] [<b>-w</b> <i>terminal</i><b>_</b><i>width</i>] [<b>-c</b> <i>config</i><b>_</b><i>directory</i>] [<i>queue</i><b>_</b><i>name</i> ...] <b>DESCRIPTION</b> The <b>qshape</b> program helps the administrator understand the Postfix queue message distribution in time and by sender domain or recipient domain. The program needs read access to the queue directories and queue files, so it must run as the superuser or the <b><a href="postconf.5.html#mail_owner">mail_owner</a></b> specified in <i>main.cf</i> (typically <b>postfix</b>). Options: <b>-s</b> Display the sender domain distribution instead of the recipient domain distribution. By default the recipient distribution is displayed. There can be more recipients than messages, but as each message has only one sender, the sender distribution is a a message distribution. <b>-p</b> Generate aggregate statistics for parent domains. Top level domains are not shown, nor are domains with fewer than <i>min</i><b>_</b><i>subdomains</i> subdomains. The names of parent domains are shown with a leading dot, (e.g. <i>.example.com</i>). <b>-m</b> <i>min</i><b>_</b><i>subdomains</i> When used with the <b>-p</b> option, sets the minimum sub- domain count needed to show a separate line for a parent domain. The default is 5. <b>-b</b> <i>bucket</i><b>_</b><i>count</i> The age distribution is broken up into a sequence of geometrically increasing intervals. This option sets the number of intervals or "buckets". Each bucket has a maximum queue age that is twice as large as that of the previous bucket. The last bucket has no age limit. <b>-b</b> <i>bucket</i><b>_</b><i>time</i> The age limit in minutes for the first time bucket. The default value is 5, meaning that the first bucket counts messages between 0 and 5 minutes old. <b>-w</b> <i>terminal</i><b>_</b><i>width</i> The output is right justified, with the counts for the last bucket shown on the 80th column, the <i>ter-</i> <i>minal</i><b>_</b><i>width</i> can be adjusted for wider screens allowing more buckets to be displayed with truncat- ing the domain names on the left. When a row for a full domain name and its counters does not fit in the specified number of columns, only the last 17 bytes of the domain name are shown with the prefix replaced by a '+' character. Truncated parent domain rows are shown as '.+' followed by the last 16 bytes of the domain name. If this is still too narrow to show the domain name and all the coun- ters, the terminal_width limit is violated. <b>-c</b> <i>config</i><b>_</b><i>directory</i> The <b>main.cf</b> configuration file is in the named directory instead of the default configuration directory. Arguments: <i>queue</i><b>_</b><i>name</i> By default <b>qshape</b> displays the combined distribu- tion of the <a href="QSHAPE_README.html#incoming_queue">incoming</a> and <a href="QSHAPE_README.html#active_queue">active queues</a>. To display a different set of queues, just list their direc- tory names on the command line. Absolute paths are used as is, other paths are taken relative to the <i>main.cf</i> <b><a href="postconf.5.html#queue_directory">queue_directory</a></b> parameter setting. While <i>main.cf</i> supports the use of <i>$variable</i> expansion in the definition of the <b><a href="postconf.5.html#queue_directory">queue_directory</a></b> parameter, the <b>qshape</b> program does not. If you must use vari- able expansions in the <b><a href="postconf.5.html#queue_directory">queue_directory</a></b> setting, you must specify an explicit absolute path for each queue subdirectory even if you want the default <a href="QSHAPE_README.html#incoming_queue">incoming</a> and <a href="QSHAPE_README.html#active_queue">active queue</a> distribution. <b>SEE ALSO</b> <a href="mailq.1.html">mailq(1)</a> List all messages in the queue. <a href="QSHAPE_README.html">QSHAPE_README</a> Examples and background material. <b>FILES</b> $<a href="postconf.5.html#config_directory">config_directory</a>/main.cf, Postfix installation parameters. $<a href="postconf.5.html#queue_directory">queue_directory</a>/maildrop/, local submission directory. $<a href="postconf.5.html#queue_directory">queue_directory</a>/incoming/, new message queue. $<a href="postconf.5.html#queue_directory">queue_directory</a>/hold/, messages waiting for tech support. $<a href="postconf.5.html#queue_directory">queue_directory</a>/active/, messages scheduled for delivery. $<a href="postconf.5.html#queue_directory">queue_directory</a>/deferred/, messages postponed for later delivery. <b>LICENSE</b> The Secure Mailer license must be distributed with this software. <b>AUTHOR(S)</b> Victor Duchovni Morgan Stanley QSHAPE(1) </pre> </body> </html>