xref: /netbsd-src/external/ibm-public/postfix/dist/html/postcat.1.html (revision d909946ca08dceb44d7d0f22ec9488679695d976)
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 human-
17       readable form. The files are expected to be in Postfix queue file  for-
18       mat.  If  no <i>files</i> are specified on the command line, the program reads
19       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#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
78              The location of the Postfix top-level queue directory.
79
80<b>FILES</b>
81       /var/spool/postfix, Postfix queue directory
82
83<b>SEE ALSO</b>
84       <a href="postconf.5.html">postconf(5)</a>, Postfix configuration
85
86<b>LICENSE</b>
87       The Secure Mailer license must be distributed with this software.
88
89<b>AUTHOR(S)</b>
90       Wietse Venema
91       IBM T.J. Watson Research
92       P.O. Box 704
93       Yorktown Heights, NY 10598, USA
94
95                                                                    POSTCAT(1)
96</pre> </body> </html>
97