/usr/share/doc/postfix/html/qshape.1.html is in postfix-doc 2.9.6-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 | <!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>-l</b>] [<b>-w</b> <i>terminal</i><b>_</b><i>width</i>]
[<b>-N</b> <i>batch</i><b>_</b><i>msg</i><b>_</b><i>count</i>] [<b>-n</b> <i>batch</i><b>_</b><i>top</i><b>_</b><i>domains</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 <a href="postconf.5.html"><b>main.cf</b></a>
(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
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>-t</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>-l</b> Instead of using a geometric age sequence, use a
linear age sequence, in other words simple multi-
ples of <b>bucket_time</b>.
This feature is available in Postfix 2.2 and later.
<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 without trun-
cating 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>-N</b> <i>batch</i><b>_</b><i>msg</i><b>_</b><i>count</i>
When the output device is a terminal, intermediate
results are shown each "batch_msg_count" messages.
This produces usable results in a reasonable time
even when the <a href="QSHAPE_README.html#deferred_queue">deferred queue</a> is large. The default
is to show intermediate results every 1000 mes-
sages.
<b>-n</b> <i>batch</i><b>_</b><i>top</i><b>_</b><i>domains</i>
When reporting intermediate or final results to a
termainal, report only the top "batch_top_domains"
domains. The default limit is 20 domains.
<b>-c</b> <i>config</i><b>_</b><i>directory</i>
The <a href="postconf.5.html"><b>main.cf</b></a> 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
<a href="postconf.5.html"><b>main.cf</a> <a href="postconf.5.html#queue_directory">queue_directory</a></b> parameter setting. While
<a href="postconf.5.html"><b>main.cf</b></a> 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>/<a href="postconf.5.html">main.cf</a>, 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>
|