postcat - show Postfix queue file contents
| Use Case | Command | Description |
|---|---|---|
| 📄 View full queue file (envelope + headers + body) | postcat file | Default behavior (equivalent to -beh) |
| 🔍 View only envelope | postcat -e file | Show message envelope content |
| 📋 View only headers | postcat -h file | Show headers up to first non-header line |
| 📝 View only body | postcat -b file | Show body from first non-header line onward |
| 🔢 Print record types | postcat -d file | Print decimal type of each record |
| 📍 Print record offsets | postcat -o file | Print queue file offset of each record |
| 🔎 Search queue by name | postcat -q filename | Search Postfix queue for named files |
| 🐞 Debug with verbose logging | postcat -v file | Enable verbose logging (multiple -v for more) |
| 📂 Read from stdin | cat file | postcat | Read queue file from standard input |
postcat [-bdehnoqv] [-c config_dir] [files...]
The postcat(1) command prints the contents of the named files in human-readable form. The files are expected to be in Postfix queue file format. If no files are specified on the command line, the program reads from standard input.
By default, postcat(1) shows the envelope and message content, as if the options -beh were specified. To view message content only, specify -bh (Postfix 2.7 and later).
-b — Show body content. Starts producing output at the first non-header line, and stops when the end of the message is reached. (Postfix 2.7+)-c config_dir — Use specified directory for main.cf instead of default.-d — Print the decimal type of each record.-e — Show message envelope content. (Postfix 2.7+)-h — Show message header content. Produces output from beginning of message up to, but not including, the first non-header line. (Postfix 2.7+)-o — Print the queue file offset of each record.-q — Search the Postfix queue for the named files instead of taking the names literally. (Postfix 2.0+)-v — Enable verbose logging for debugging. Multiple -v options increase verbosity.Problems are reported to the standard error stream.
MAIL_CONFIG — Directory with Postfix configuration files.The following main.cf parameters are especially relevant to this program. The text below provides only a parameter summary. See postconf(5) for more details including examples.
config_directory (see postconf -d output) — Default location of Postfix main.cf and master.cf configuration files.import_environment (see postconf -d output) — List of environment parameters a privileged Postfix process will import from a non-Postfix parent process, or name=value environment overrides.queue_directory (see postconf -d output) — Location of the Postfix top-level queue directory./var/spool/postfix — Postfix queue directoryThe Secure Mailer license must be distributed with this software.
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
Generated by phpman v4.9.26-1-g511901d Author: Che Dong Under GNU General Public License
2026-08-08 14:19 @216.73.216.150
CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
Enhanced by LLM: deepseek-v4-flash / taotoken.net / www.chedong.com - original format