xref: /netbsd-src/external/ibm-public/postfix/dist/html/postcat.1.html (revision 46f5119e40af2e51998f686b2fdcc76b5488f7f3)
1<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
2        "http://www.w3.org/TR/html4/loose.dtd">
3<html> <head>
4<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
5<title> Postfix manual - postcat(1) </title>
6</head> <body> <pre>
7POSTCAT(1)                                                          POSTCAT(1)
8
9<b>NAME</b>
10       postcat - show Postfix queue file contents
11
12<b>SYNOPSIS</b>
13       <b>postcat</b> [<b>-bdehnoqv</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<i>files</i>...]
14
15<b>DESCRIPTION</b>
16       The  <a href="postcat.1.html"><b>postcat</b>(1)</a>  command  prints the contents of the named
17       <i>files</i> in human-readable form. The files are expected to be
18       in Postfix queue file format. If no <i>files</i> are specified on
19       the command line, the program reads from standard input.
20
21       By default, <a href="postcat.1.html"><b>postcat</b>(1)</a> shows the envelope and message con-
22       tent,  as if the options <b>-beh</b> were specified. To view mes-
23       sage content only, specify <b>-bh</b> (Postfix 2.7 and later).
24
25       Options:
26
27       <b>-b</b>     Show body content.  The <b>-b</b> option starts  producing
28              output at the first non-header line, and stops when
29              the end of the message is reached.
30
31              This feature is available in Postfix 2.7 and later.
32
33       <b>-c</b> <i>config</i><b>_</b><i>dir</i>
34              The  <a href="postconf.5.html"><b>main.cf</b></a>  configuration  file  is  in the named
35              directory  instead  of  the  default  configuration
36              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>-h</b>     Show message header content.  The  <b>-h</b>  option  pro-
45              duces  output  from the beginning of the message up
46              to, but not including, the first non-header line.
47
48              This feature is available in Postfix 2.7 and later.
49
50       <b>-o</b>     Print the queue file offset of each record.
51
52       <b>-q</b>     Search  the  Postfix  queue  for  the  named  <i>files</i>
53              instead of taking the names literally.
54
55              This feature is available in Postfix 2.0 and later.
56
57       <b>-v</b>     Enable verbose logging for debugging purposes. Mul-
58              tiple <b>-v</b> options  make  the  software  increasingly
59              verbose.
60
61<b>DIAGNOSTICS</b>
62       Problems are reported to the standard error stream.
63
64<b>ENVIRONMENT</b>
65       <b>MAIL_CONFIG</b>
66              Directory with Postfix configuration files.
67
68<b>CONFIGURATION PARAMETERS</b>
69       The  following  <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant
70       to this program.
71
72       The text below provides  only  a  parameter  summary.  See
73       <a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including examples.
74
75       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
76              The  default  location  of  the Postfix <a href="postconf.5.html">main.cf</a> and
77              <a href="master.5.html">master.cf</a> configuration files.
78
79       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
80              The location of the Postfix top-level queue  direc-
81              tory.
82
83<b>FILES</b>
84       /var/spool/postfix, Postfix queue directory
85
86<b>SEE ALSO</b>
87       <a href="postconf.5.html">postconf(5)</a>, Postfix configuration
88
89<b>LICENSE</b>
90       The  Secure  Mailer  license must be distributed with this
91       software.
92
93<b>AUTHOR(S)</b>
94       Wietse Venema
95       IBM T.J. Watson Research
96       P.O. Box 704
97       Yorktown Heights, NY 10598, USA
98
99                                                                    POSTCAT(1)
100</pre> </body> </html>
101