summaryrefslogtreecommitdiffstats
path: root/html/postcat.1.html
blob: 71b763e4fe2f809c6f0505d62bba7b681434d0b8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
        "http://www.w3.org/TR/html4/loose.dtd">
<html> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link rel='stylesheet' type='text/css' href='postfix-doc.css'>
<title> Postfix manual - postcat(1) </title>
</head> <body> <pre>
POSTCAT(1)                                                          POSTCAT(1)

<b>NAME</b>
       postcat - show Postfix queue file contents

<b>SYNOPSIS</b>
       <b>postcat</b> [<b>-bdehnoqv</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<i>files</i>...]

<b>DESCRIPTION</b>
       The  <a href="postcat.1.html"><b>postcat</b>(1)</a>  command  prints  the  contents  of  the named <i>files</i> in
       human-readable form. The files are expected to be in Postfix queue file
       format.  If  no  <i>files</i>  are  specified on the command line, the program
       reads from standard input.

       By default, <a href="postcat.1.html"><b>postcat</b>(1)</a> shows the envelope and message  content,  as  if
       the  options <b>-beh</b> were specified. To view message content only, specify
       <b>-bh</b> (Postfix 2.7 and later).

       Options:

       <b>-b</b>     Show body content.  The <b>-b</b> option starts producing output at the
              first  non-header line, and stops when the end of the message is
              reached.

              This feature is available in Postfix 2.7 and later.

       <b>-c</b> <i>config</i><b>_</b><i>dir</i>
              The <a href="postconf.5.html"><b>main.cf</b></a> configuration file is in the named directory instead
              of the default configuration directory.

       <b>-d</b>     Print the decimal type of each record.

       <b>-e</b>     Show message envelope content.

              This feature is available in Postfix 2.7 and later.

       <b>-h</b>     Show message header content.  The <b>-h</b> option produces output from
              the beginning of the message up to, but not including, the first
              non-header line.

              This feature is available in Postfix 2.7 and later.

       <b>-o</b>     Print the queue file offset of each record.

       <b>-q</b>     Search  the  Postfix queue for the named <i>files</i> instead of taking
              the names literally.

              This feature is available in Postfix 2.0 and later.

       <b>-r</b>     Print records in file order, don't follow pointer records.

              This feature is available in Postfix 3.7 and later.

       <b>-s</b> <i>offset</i>
              Skip to the specified queue file offset.

              This feature is available in Postfix 3.7 and later.

       <b>-v</b>     Enable verbose  logging  for  debugging  purposes.  Multiple  <b>-v</b>
              options make the software increasingly verbose.

<b>DIAGNOSTICS</b>
       Problems are reported to the standard error stream.

<b>ENVIRONMENT</b>
       <b>MAIL_CONFIG</b>
              Directory with Postfix configuration files.

<b>CONFIGURATION PARAMETERS</b>
       The  following  <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to this pro-
       gram.

       The text below provides only a parameter summary. See  <a href="postconf.5.html"><b>postconf</b>(5)</a>  for
       more details including examples.

       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
              The  default  location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
              figuration files.

       <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
              The list of environment  variables  that  a  privileged  Postfix
              process  will  import  from  a  non-Postfix  parent  process, or
              name=value environment overrides.

       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
              The location of the Postfix top-level queue directory.

<b>FILES</b>
       /var/spool/postfix, Postfix queue directory

<b>SEE ALSO</b>
       <a href="postconf.5.html">postconf(5)</a>, Postfix configuration

<b>LICENSE</b>
       The Secure Mailer license must be distributed with this software.

<b>AUTHOR(S)</b>
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

       Wietse Venema
       Google, Inc.
       111 8th Avenue
       New York, NY 10011, USA

                                                                    POSTCAT(1)
</pre> </body> </html>