1Purpose of this document 2======================== 3 4This document provides a road map of the Postfix mail system source 5code distribution. I suggest that you 6 7- take a few minutes to read this file, 8 9- review the RELEASE_NOTES file for incompatible changes, 10 11- and then proceed with the INSTALL instructions. 12 13Introduction 14============ 15 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. 19 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. 24 25Purpose of the Postfix mail system 26================================== 27 28Postfix aims to be an alternative to the widely-used sendmail 29program. 30 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. 36 37In other words, IBM releases Postfix only once. I will be around 38to guide its development for a limited time. 39 40On-line resources devoted to the Postfix mail system 41==================================================== 42 43Web sites: 44 45 http://www.postfix.org/ current release information 46 47Mail addresses (PLEASE send questions to the mailing list) 48 49 postfix-users@postfix.org Postfix users mailing list 50 51In order to subscribe to the mailing list, see http://www.postfix.org/. 52 53Acknowledgments 54=============== 55 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. 63 64Postcards 65========= 66 67If you wish to express your appreciation for the Postfix software, 68you are welcome to send a postcard to: 69 70 Wietse Venema 71 Google 72 111 8th Avenue, 4th floor 73 New York, NY 10011 74 USA 75 76Roadmap of the Postfix source distribution 77========================================== 78 79The RELEASE_NOTES file describes new features, and lists incompatible 80changes with respect to previous Postfix versions. 81 82The INSTALL file provides a step-by-step guide for building and 83installing Postfix on many popular UNIX platforms. 84 85The COMPATIBILITY file lists features that Postfix does or does 86not yet implement, and how well it works with other software. 87 88The HISTORY file gives a detailed log of changes to the software. 89 90Point your browser at html/index.html for Postfix documentation 91and for hyperlinked versions of Postfix manual pages. Expect 92to see updated versions on-line at http://www.postfix.org/ 93 94Point your MANPATH environment variable at the `man' directory (use 95an absolute path) for UNIX-style on-line manual pages. These pages 96are also available through the HTML interface, which allows you to 97navigate faster. 98 99The PORTING file discusses how to go about porting Postfix to other 100UNIX platforms. 101 102Documentation: 103 104 README_FILES/ Instructions for specific Postfix features 105 html/ HTML format 106 man/ UNIX on-line manual page format 107 108Example files: 109 110 conf/ configuration files, run-time scripts 111 examples/ chroot environments, virtual domains 112 113Library routines: 114 115 src/dns/ DNS client library 116 src/global/ Postfix-specific support routines 117 src/milter/ Postfix Milter (mail filter) client 118 src/tls/ TLS client and server support 119 src/util/ General-purpose support routines 120 src/xsasl/ SASL plug-in API 121 122Command-line utilities: 123 124 src/postalias/ Alias database management 125 src/postcat/ List Postfix queue file 126 src/postconf/ Configuration utility 127 src/postdrop/ Postfix mail submission program 128 src/postfix/ Postfix administrative interface 129 src/postkick/ Postfix IPC for shell scripts 130 src/postlock/ Postfix locking for shell scripts 131 src/postlog/ Postfix logging for shell scripts 132 src/postmap/ Postfix lookup table management 133 src/postmulti/ Postfix multi-instance manager 134 src/postqueue/ Postfix queue control program 135 src/postsuper/ Postfix house keeping program 136 src/sendmail/ Sendmail compatibility interface 137 138Postfix daemons: 139 140 src/anvil/ Connection count/rate limiter 141 src/bounce/ Bounce or defer mail 142 src/cleanup/ Canonicalize and enqueue mail 143 src/discard/ Trivial discard mailer 144 src/dnsblog/ DNS agent for postscreen 145 src/error/ Trivial error mailer 146 src/flush/ Support for ETRN, sendmail -qI, sendmail -qR 147 src/local/ Local delivery 148 src/master/ Postfix resident superserver 149 src/oqmgr/ Old queue manager 150 src/pickup/ Local pickup 151 src/pipe/ Pipe delivery 152 src/postlogd/ Syslog alternative, logs to file or stdout 153 src/postscreen/ Zombie blocker 154 src/proxymap/ Table lookup proxy agent 155 src/qmgr/ Queue manager 156 src/qmqpd/ QMQPD server 157 src/scache/ Postfix SMTP session cache 158 src/showq/ List Postfix queue status 159 src/smtp/ SMTP and LMTP client 160 src/smtpd/ SMTP server 161 src/spawn/ Run non-Postfix server 162 src/tlsmgr/ TLS session keys and random pool 163 src/tlsproxy/ TLS proxy for postscreen and outbound connection reuse 164 src/trivial-rewrite/ Address rewriting and resolving 165 src/verify/ address verification service 166 src/virtual/ virtual mailbox-only delivery agent 167 168Test programs: 169 170 src/fsstone/ Measure file system overhead 171 src/posttls-finger/ Postfix SMTP/LMTP TLS probe utility 172 src/smtpstone/ SMTP and QMQP server torture test 173 174Miscellaneous: 175 176 auxiliary/ Auxiliary software etc. 177 bin/ Postfix command executables 178 conf/ Configuration files, run-time scripts 179 include/ Include files 180 implementation-notes/ Background information 181 lib/ Object libraries 182 libexec/ Postfix daemon executables 183 mantools/ Documentation utilities 184 proto/ Documentation source 185