summaryrefslogtreecommitdiffstats
path: root/man/man1/postcat.1
blob: eb3025ba15f3a952ceaa70129e46392fdba958a1 (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
117
118
119
120
121
.TH POSTCAT 1 
.ad
.fi
.SH NAME
postcat
\-
show Postfix queue file contents
.SH "SYNOPSIS"
.na
.nf
\fBpostcat\fR [\fB\-bdehnoqv\fR] [\fB\-c \fIconfig_dir\fR] [\fIfiles\fR...]
.SH DESCRIPTION
.ad
.fi
The \fBpostcat\fR(1) command prints the contents of the
named \fIfiles\fR in human\-readable form. The files are
expected to be in Postfix queue file format. If no \fIfiles\fR
are specified on the command line, the program reads from
standard input.

By default, \fBpostcat\fR(1) shows the envelope and message
content, as if the options \fB\-beh\fR were specified. To
view message content only, specify \fB\-bh\fR (Postfix 2.7
and later).

Options:
.IP \fB\-b\fR
Show body content.  The \fB\-b\fR option starts producing
output at the first non\-header line, and stops when the end
of the message is reached.
.sp
This feature is available in Postfix 2.7 and later.
.IP "\fB\-c \fIconfig_dir\fR"
The \fBmain.cf\fR configuration file is in the named directory
instead of the default configuration directory.
.IP \fB\-d\fR
Print the decimal type of each record.
.IP \fB\-e\fR
Show message envelope content.
.sp
This feature is available in Postfix 2.7 and later.
.IP \fB\-h\fR
Show message header content.  The \fB\-h\fR option produces
output from the beginning of the message up to, but not
including, the first non\-header line.
.sp
This feature is available in Postfix 2.7 and later.
.IP \fB\-o\fR
Print the queue file offset of each record.
.IP \fB\-q\fR
Search the Postfix queue for the named \fIfiles\fR instead
of taking the names literally.

This feature is available in Postfix 2.0 and later.
.IP \fB\-r\fR
Print records in file order, don't follow pointer records.

This feature is available in Postfix 3.7 and later.
.IP "\fB\-s \fIoffset\fR"
Skip to the specified queue file offset.

This feature is available in Postfix 3.7 and later.
.IP \fB\-v\fR
Enable verbose logging for debugging purposes. Multiple \fB\-v\fR
options make the software increasingly verbose.
.SH DIAGNOSTICS
.ad
.fi
Problems are reported to the standard error stream.
.SH "ENVIRONMENT"
.na
.nf
.ad
.fi
.IP \fBMAIL_CONFIG\fR
Directory with Postfix configuration files.
.SH "CONFIGURATION PARAMETERS"
.na
.nf
.ad
.fi
The following \fBmain.cf\fR parameters are especially relevant to
this program.

The text below provides only a parameter summary. See
\fBpostconf\fR(5) for more details including examples.
.IP "\fBconfig_directory (see 'postconf -d' output)\fR"
The default location of the Postfix main.cf and master.cf
configuration files.
.IP "\fBimport_environment (see 'postconf -d' output)\fR"
The list of environment parameters that a privileged Postfix
process will import from a non\-Postfix parent process, or name=value
environment overrides.
.IP "\fBqueue_directory (see 'postconf -d' output)\fR"
The location of the Postfix top\-level queue directory.
.SH "FILES"
.na
.nf
/var/spool/postfix, Postfix queue directory
.SH "SEE ALSO"
.na
.nf
postconf(5), Postfix configuration
.SH "LICENSE"
.na
.nf
.ad
.fi
The Secure Mailer license must be distributed with this software.
.SH "AUTHOR(S)"
.na
.nf
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