Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 

QSHAPE(1)                                                            QSHAPE(1)

NAME
       qshape - Print Postfix queue domain and age distribution

SYNOPSIS
       qshape [-s] [-p] [-m min_subdomains]
               [-b bucket_count] [-t bucket_time]
               [-l] [-w terminal_width]
               [-c config_directory] [queue_name ...]

DESCRIPTION
       The  qshape 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 mail_owner specified in main.cf
       (typically postfix).

       Options:

       -s     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.

       -p     Generate  aggregate  statistics for parent domains.
              Top level domains are not shown,  nor  are  domains
              with  fewer  than  min_subdomains  subdomains.  The
              names of parent domains are shown  with  a  leading
              dot, (e.g. .example.com).

       -m min_subdomains
              When used with the -p option, sets the minimum sub-
              domain count needed to show a separate line  for  a
              parent domain. The default is 5.

       -b bucket_count
              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.

       -t bucket_time
              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.

       -l     Instead  of  using  a geometric age sequence, use a
              linear age sequence, in other words  simple  multi-
              ples of bucket_time.

              This feature is available in Postfix 2.2 and later.

       -w terminal_width
              The output is right justified, with the counts  for
              the  last bucket shown on the 80th column, the ter-
              minal_width  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.

       -c config_directory
              The main.cf configuration  file  is  in  the  named
              directory  instead  of  the  default  configuration
              directory.

       Arguments:

       queue_name
              By default qshape displays the  combined  distribu-
              tion  of the incoming and active queues. 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
              main.cf  queue_directory  parameter setting.  While
              main.cf supports the use of $variable expansion  in
              the  definition  of  the queue_directory parameter,
              the qshape program does not. If you must use  vari-
              able expansions in the queue_directory setting, you
              must specify an explicit  absolute  path  for  each
              queue  subdirectory  even  if  you want the default
              incoming and active queue distribution.

SEE ALSO
       mailq(1), List all messages in the queue.
       QSHAPE_README Examples and background material.

FILES
       $config_directory/main.cf, Postfix installation parameters.
       $queue_directory/maildrop/, local submission directory.
       $queue_directory/incoming/, new message queue.
       $queue_directory/hold/, messages waiting for tech support.
       $queue_directory/active/, messages scheduled for delivery.
       $queue_directory/deferred/, messages postponed for later delivery.

LICENSE
       The Secure Mailer license must be  distributed  with  this
       software.

AUTHOR(S)
       Victor Duchovni
       Morgan Stanley

                                                                     QSHAPE(1)