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