xref: /netbsd-src/external/ibm-public/postfix/dist/html/postcat.1.html (revision 9fd8799cb5ceb66c69f2eb1a6d26a1d587ba1f1e)
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 <i>files</i> in
17       human-readable form. The files are expected to be in Postfix queue file
18       format.  If  no  <i>files</i>  are  specified on the command line, the program
19       reads from standard input.
20
21       By default, <a href="postcat.1.html"><b>postcat</b>(1)</a> shows the envelope and message  content,  as  if
22       the  options <b>-beh</b> were specified. To view message content only, specify
23       <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 output at the
28              first  non-header line, and stops when the end of the message is
29              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 directory instead
35              of the default configuration directory.
36
37       <b>-d</b>     Print the decimal type of each record.
38
39       <b>-e</b>     Show message envelope content.
40
41              This feature is available in Postfix 2.7 and later.
42
43       <b>-h</b>     Show message header content.  The <b>-h</b> option produces output from
44              the beginning of the message up to, but not including, the first
45              non-header line.
46
47              This feature is available in Postfix 2.7 and later.
48
49       <b>-o</b>     Print the queue file offset of each record.
50
51       <b>-q</b>     Search  the  Postfix queue for the named <i>files</i> instead of taking
52              the names literally.
53
54              This feature is available in Postfix 2.0 and later.
55
56       <b>-v</b>     Enable verbose  logging  for  debugging  purposes.  Multiple  <b>-v</b>
57              options make the software increasingly verbose.
58
59<b>DIAGNOSTICS</b>
60       Problems are reported to the standard error stream.
61
62<b>ENVIRONMENT</b>
63       <b>MAIL_CONFIG</b>
64              Directory with Postfix configuration files.
65
66<b>CONFIGURATION PARAMETERS</b>
67       The  following  <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to this pro-
68       gram.
69
70       The text below provides only a parameter summary. See  <a href="postconf.5.html"><b>postconf</b>(5)</a>  for
71       more details including examples.
72
73       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
74              The  default  location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
75              figuration files.
76
77       <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
78              The list of environment parameters  that  a  privileged  Postfix
79              process  will  import  from  a  non-Postfix  parent  process, or
80              name=value environment overrides.
81
82       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
83              The location of the Postfix top-level queue directory.
84
85<b>FILES</b>
86       /var/spool/postfix, Postfix queue directory
87
88<b>SEE ALSO</b>
89       <a href="postconf.5.html">postconf(5)</a>, Postfix configuration
90
91<b>LICENSE</b>
92       The Secure Mailer license must be distributed with this software.
93
94<b>AUTHOR(S)</b>
95       Wietse Venema
96       IBM T.J. Watson Research
97       P.O. Box 704
98       Yorktown Heights, NY 10598, USA
99
100       Wietse Venema
101       Google, Inc.
102       111 8th Avenue
103       New York, NY 10011, USA
104
105                                                                    POSTCAT(1)
106</pre> </body> </html>
107