Query a Postfix lookup table without modifying it
Build a paste-ready command, then review its compatibility and effects before running it.
postmap -q <lookup-key> <postfix-map>Complete required fields to copy the generated command.
read-onlyno known side effects Compatibility
LinuxVerified for Linux using posix, bash, zsh syntax.
Operational knowledgereview due 2027-01-19
Requirementspostmappostmap must be installed and available on PATH.
Version supportpostmap Current supported releasesVerified for linux using posix, bash, zsh syntax; consult compatibility notes for platform-specific differences.
Expected signalsaliceRepresentative successful output; values vary with the selected target and system state.
Known errorspostmap: command not foundpostmap is missing or is not available on PATH.
Verifypostmap -q {{key}} {{map}}The output matches the expected target and exits without an error.Rollback noteNot required: this command is read-only and does not change system state.
Command breakdown
01postmapCommandRuns the postmap stage of this one-liner.
02-qOptionConfigures postmap with the -q option.
03<lookup-key>ParameterA value supplied in the Fill parameters section.
04<postfix-map>ParameterA value supplied in the Fill parameters section.
Example input
postmap -q alice@example.com hash:/etc/postfix/virtual
Illustrative output — exact values vary by system and data.
Official sources
Related commands