Home | History | Annotate | Line # | Download | only in html 
      1 <!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
      2         "https://www.w3.org/TR/html4/loose.dtd">
      3 <html> <head>
      4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
      5 <link rel='stylesheet' type='text/css' href='postfix-doc.css'>
      6 <title> Postfix manual - postcat(1) </title>
      7 </head> <body> <pre>
      8 POSTCAT(1)                                                          POSTCAT(1)
      9 
     10 <b><a name="name">NAME</a></b>
     11        postcat - show Postfix queue file contents
     12 
     13 <b><a name="synopsis">SYNOPSIS</a></b>
     14        <b>postcat</b> [<b>-bdefhnoqv</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<i>files</i>...]
     15 
     16 <b><a name="description">DESCRIPTION</a></b>
     17        The  <a href="postcat.1.html"><b>postcat</b>(1)</a>  command  prints  the  contents  of  the named <i>files</i> in
     18        human-readable form. The files are expected to be in Postfix queue file
     19        format.  If  no  <i>files</i>  are  specified on the command line, the program
     20        reads from standard input.
     21 
     22        By default, <a href="postcat.1.html"><b>postcat</b>(1)</a> shows the envelope and message  content,  as  if
     23        the  options <b>-beh</b> were specified. To view message content only, specify
     24        <b>-bh</b> (Postfix 2.7 and later).
     25 
     26        Options:
     27 
     28        <b>-b</b>     Show body content.  The <b>-b</b> option starts producing output at the
     29               first  non-header line, and stops when the end of the message is
     30               reached.
     31 
     32               This feature is available in Postfix 2.7 and later.
     33 
     34        <b>-c</b> <i>config</i><b>_</b><i>dir</i>
     35               The <a href="postconf.5.html"><b>main.cf</b></a> configuration file is in the named directory instead
     36               of the default configuration directory.
     37 
     38        <b>-d</b>     Print the decimal type of each record.
     39 
     40        <b>-e</b>     Show message envelope content.
     41 
     42               This feature is available in Postfix 2.7 and later.
     43 
     44        <b>-f</b>     Prepend the file name to each output line.
     45 
     46               This feature is available in Postfix 3.10 and later.
     47 
     48        <b>-h</b>     Show message header content.  The <b>-h</b> option produces output from
     49               the beginning of the message up to, but not including, the first
     50               non-header line.
     51 
     52               This feature is available in Postfix 2.7 and later.
     53 
     54        <b>-o</b>     Print the queue file offset of each record.
     55 
     56        <b>-q</b>     Search  the  Postfix queue for the named <i>files</i> instead of taking
     57               the names literally.
     58 
     59               This feature is available in Postfix 2.0 and later.
     60 
     61        <b>-r</b>     Print records in file order, don't follow pointer records.
     62 
     63               This feature is available in Postfix 3.7 and later.
     64 
     65        <b>-s</b> <i>offset</i>
     66               Skip to the specified queue file offset.
     67 
     68               This feature is available in Postfix 3.7 and later.
     69 
     70        <b>-v</b>     Enable verbose  logging  for  debugging  purposes.  Multiple  <b>-v</b>
     71               options make the software increasingly verbose.
     72 
     73 <b><a name="diagnostics">DIAGNOSTICS</a></b>
     74        Problems are reported to the standard error stream.
     75 
     76 <b><a name="environment">ENVIRONMENT</a></b>
     77        <b>MAIL_CONFIG</b>
     78               Directory with Postfix configuration files.
     79 
     80 <b><a name="configuration_parameters">CONFIGURATION PARAMETERS</a></b>
     81        The  following  <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to this pro-
     82        gram.
     83 
     84        The text below provides only a parameter summary. See  <a href="postconf.5.html"><b>postconf</b>(5)</a>  for
     85        more details including examples.
     86 
     87        <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
     88               The  default  location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
     89               figuration files.
     90 
     91        <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
     92               The list of environment  variables  that  a  privileged  Postfix
     93               process  will  import  from  a  non-Postfix  parent  process, or
     94               name=value environment overrides.
     95 
     96        <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
     97               The location of the Postfix top-level queue directory.
     98 
     99 <b><a name="files">FILES</a></b>
    100        /var/spool/postfix, Postfix queue directory
    101 
    102 <b><a name="see_also">SEE ALSO</a></b>
    103        <a href="postconf.5.html">postconf(5)</a>, Postfix configuration
    104 
    105 <b><a name="license">LICENSE</a></b>
    106        The Secure Mailer license must be distributed with this software.
    107 
    108 <b>AUTHOR(S)</b>
    109        Wietse Venema
    110        IBM T.J. Watson Research
    111        P.O. Box 704
    112        Yorktown Heights, NY 10598, USA
    113 
    114        Wietse Venema
    115        Google, Inc.
    116        111 8th Avenue
    117        New York, NY 10011, USA
    118 
    119                                                                     POSTCAT(1)
    120 </pre> </body> </html>
    121