1Purpose of this document
4This document provides a road map of the Postfix mail system source
5code distribution. I suggest that you
7- take a few minutes to read this file,
9- review the RELEASE_NOTES file for incompatible changes,
11- and then proceed with the INSTALL instructions.
16This is the public release of the Postfix mail system. Thank you
17for your interest in this project. Send me a postcard if you like
18it. My postal address is below.
20You must read the LICENSE file, if you didn't do so already. A copy
21of the LICENSE must be distributed with every original, modified,
22complete, source, or binary copy of this software or parts thereof.
23I suggest that you keep a copy of the file in /etc/postfix/LICENSE.
25Purpose of the Postfix mail system
28Postfix aims to be an alternative to the widely-used sendmail
31Although IBM supported the Postfix development, it abstains from
32control over its evolution. The goal is to have Postfix installed
33on as many systems as possible. To this end, the software is given
34away with no strings attached to it, so that it can evolve with
35input from and under control by its users.
37In other words, IBM releases Postfix only once. I will be around
38to guide its development for a limited time.
40On-line resources devoted to the Postfix mail system
45 http://www.postfix.org/ current release information
47Mail addresses (PLEASE send questions to the mailing list)
49 email@example.com Postfix users mailing list
51In order to subscribe to the mailing list, see http://www.postfix.org/.
56This release could not have happened without the input from a team
57of competent alpha testers. Their names appear in numerous places
58in the HISTORY file. I appreciate the input from my colleagues at
59the IBM Global Security Analysis Laboratory: Paul Karger, Dave
60Safford, Douglas Schales, and Leendert van Doorn. I also appreciate
61the support by Charles Palmer under whose leadership I began this
62project, and who had the privilege to name the software, twice.
64If you wish to express your appreciation for the Postfix software,
65you are welcome to send a postcard to:
67 Wietse Venema
68 IBM T.J Watson Research Center
69 P.O. Box 704,
70 Yorktown Heights, NY 10598
73Roadmap of the Postfix source distribution
76The RELEASE_NOTES file describes new features, and lists incompatible
77changes with respect to previous Postfix versions.
79The INSTALL file provides a step-by-step guide for building and
80installing Postfix on many popular UNIX platforms.
82The COMPATIBILITY file lists features that Postfix does or does
83not yet implement, and how well it works with other software.
85The HISTORY file gives a detailed log of changes to the software.
87Point your browser at html/index.html for Postfix documentation
88and for hyperlinked versions of Postfix manual pages. Expect
89to see updated versions on-line at http://www.postfix.org/
91Point your MANPATH environment variable at the `man' directory (use
92an absolute path) for UNIX-style on-line manual pages. These pages
93are also available through the HTML interface, which allows you to
96The PORTING file discusses how to go about porting Postfix to other
101 README_FILES/ Instructions for specific Postfix features
102 html/ HTML format
103 man/ UNIX on-line manual page format
107 conf/ configuration files, run-time scripts
108 examples/ chroot environments, virtual domains
112 src/dns/ DNS client library
113 src/global/ Postfix-specific support routines
114 src/util/ General-purpose support routines
118 src/postalias/ Alias database management
119 src/postcat/ List Postfix queue file
120 src/postconf/ Configuration utility
121 src/postdrop/ Postfix mail submission program
122 src/postfix/ Postfix administrative interface
123 src/postkick/ Postfix IPC for shell scripts
124 src/postlock/ Postfix locking for shell scripts
125 src/postlog/ Postfix logging for shell scripts
126 src/postmap/ Postfix lookup table management
127 src/postqueue/ Postfix queue control program
128 src/postsuper/ Postfix house keeping program
129 src/sendmail/ Sendmail compatibility interface
133 src/anvil/ Connection count/rate limiter
134 src/bounce/ Bounce or defer mail
135 src/cleanup/ Canonicalize and enqueue mail
136 src/discard/ Trivial discard mailer
137 src/error/ Trivial error mailer
138 src/local/ Local delivery
139 src/master/ Postfix resident superserver
140 src/oqmgr/ Old queue manager
141 src/pickup/ Local pickup
142 src/pipe/ Pipe delivery
143 src/qmgr/ Queue manager
144 src/qmqpd/ QMQPD server
145 src/showq/ List Postfix queue status
146 src/smtp/ SMTP and LMTP client
147 src/smtpd/ SMTP server
148 src/spawn/ Run non-Postfix server
149 src/tlsmgr/ TLS session keys and random pool
150 src/trivial-rewrite/ Address rewriting and resolving
151 src/verify/ address verification service
152 src/virtual/ virtual mailbox-only delivery agent
156 src/fsstone/ Measure file system overhead
157 src/smtpstone/ SMTP and QMQP server torture test
161 auxiliary/ Auxiliary software etc.
162 bin/ Postfix command executables
163 conf/ Configuration files, run-time scripts
164 include/ Include files
165 implementation-notes/ Background information
166 lib/ Object libraries
167 libexec/ Postfix daemon executables
168 mantools/ Documentation utilities
169 proto/ Documentation source