Patrick Welche <prlw1@cam.ac.uk>
[netbsd-mini2440.git] / external / ibm-public / postfix / dist / man / man1 / postcat.1
blob7fd6b76f1bd6fd81f99e6cc1388bea301aed3ad2
1 .\"     $NetBSD$
2 .\"
3 .TH POSTCAT 1 
4 .ad
5 .fi
6 .SH NAME
7 postcat
8 \-
9 show Postfix queue file contents
10 .SH "SYNOPSIS"
11 .na
12 .nf
13 \fBpostcat\fR [\fB-oqv\fR] [\fB-c \fIconfig_dir\fR] [\fIfiles\fR...]
14 .SH DESCRIPTION
15 .ad
16 .fi
17 The \fBpostcat\fR(1) command prints the contents of the named
18 \fIfiles\fR in human-readable form. The files are expected
19 to be in Postfix queue file format. If no
20 \fIfiles\fR are specified on the command line, the program
21 reads from standard input.
23 Options:
24 .IP "\fB-c \fIconfig_dir\fR"
25 The \fBmain.cf\fR configuration file is in the named directory
26 instead of the default configuration directory.
27 .IP \fB-o\fR
28 Print the queue file offset of each record.
29 .IP \fB-q\fR
30 Search the Postfix queue for the named \fIfiles\fR instead
31 of taking the names literally.
33 Available in Postfix version 2.0 and later.
34 .IP \fB-v\fR
35 Enable verbose logging for debugging purposes. Multiple \fB-v\fR
36 options make the software increasingly verbose.
37 .SH DIAGNOSTICS
38 .ad
39 .fi
40 Problems are reported to the standard error stream.
41 .SH "ENVIRONMENT"
42 .na
43 .nf
44 .ad
45 .fi
46 .IP \fBMAIL_CONFIG\fR
47 Directory with Postfix configuration files.
48 .SH "CONFIGURATION PARAMETERS"
49 .na
50 .nf
51 .ad
52 .fi
53 The following \fBmain.cf\fR parameters are especially relevant to
54 this program.
56 The text below provides only a parameter summary. See
57 \fBpostconf\fR(5) for more details including examples.
58 .IP "\fBconfig_directory (see 'postconf -d' output)\fR"
59 The default location of the Postfix main.cf and master.cf
60 configuration files.
61 .IP "\fBqueue_directory (see 'postconf -d' output)\fR"
62 The location of the Postfix top-level queue directory.
63 .SH "FILES"
64 .na
65 .nf
66 /var/spool/postfix, Postfix queue directory
67 .SH "SEE ALSO"
68 .na
69 .nf
70 postconf(5), Postfix configuration
71 .SH "LICENSE"
72 .na
73 .nf
74 .ad
75 .fi
76 The Secure Mailer license must be distributed with this software.
77 .SH "AUTHOR(S)"
78 .na
79 .nf
80 Wietse Venema
81 IBM T.J. Watson Research
82 P.O. Box 704
83 Yorktown Heights, NY 10598, USA