diff options
| -rw-r--r-- | INSTALL | 79 | ||||
| -rw-r--r-- | NEWS | 8 |
2 files changed, 47 insertions, 40 deletions
@@ -1,13 +1,11 @@ - INSTALL Instructions for fetchmail +INSTALL Instructions for fetchmail +================================== -If you have installed binaries (e.g. from an RPM) you can skip to step 5. - -If you are a Linux system packager, be aware that the build process generates -an RPM spec file at fetchmail.spec, and you can "make rpm" to generate an -RPM and SRPM. +If you have installed binaries (e.g. from a Linux RPM or DPKG, Solaris +package or FreeBSD port), you can skip to step 5. The Frequently Asked Questions list, included as the file FAQ in this -distributions, answers the most common questions about configuring and +distributions, answers the most common questions about configuring and running fetchmail. 1. USEFUL THINGS TO INSTALL FIRST @@ -26,17 +24,18 @@ you should install OPIE. You need version 2.32 or better. The OPIE library sources are available at http://www.inner.net/pub/opie/ You can also find OPIE and IPV6-capable servers there. -Building in IPv6 support *requires* glibc 2.1.1 (or newer) or -that Craig Metz's inet6-apps kit be installed. -The IPsec patches *requires* inet6-apps kit.; -the IPsec patches require that the kit be built with network -security API support enabled. The kit can be gotten from -ftp.ipv6.inner.net:/pub/ipv6 (via IPv6) or ftp.inner.net -/pub/ipv6 (via IPv4). +Building in IPv6 support *requires* an up-to-date operating system. +Recent Linux versions with glibc 2.1.1 or newer, FreeBSD, Solaris should +be fine. + +The IPsec code *requires* the inet6-apps kit, which used to be available +from ftp.ipv6.inner.net:/pub/ipv6 (via IPv6) or ftp.inner.net /pub/ipv6 +(via IPv4), but the software has been withdrawn, so we're sorry, no +advanced IPsec support at this time. + +If you have trouble with intl or gettext functions, try using the +configure option `--with-included-gettext'. -Fetchmail has had serious grief from buggy versions of the gettext suite. -If your version is older than 1.10.40, you should use the configure -option `--with-included-gettext'. 2. CONFIGURE @@ -44,13 +43,13 @@ Installing fetchmail is easy. From within this directory, type: ./configure -(If your getext is old, you need to include the --with-included-gettext -option, which I recommend anyway). +(If your gettext is old, you may need to include the +--with-included-gettext option). The autoconfiguration script will spend a bit of time figuring out the specifics of your system. If you want to specify a particular compiler -(e.g. you have gcc but want to compile with cc), set the environment -variable CC before you run configure. +(e.g. you have gcc but want to compile with cc), set the environment +variable CC before you run configure. The configure script accepts certain standard configuration options. These include --prefix, --exec-prefix, --bindir, --infodir, --mandir, @@ -79,13 +78,15 @@ Hooks for the OpenSSL library (see http://www.openssl.org/) are included in the distribution. To enable these, configure with --with-ssl; they are not included in the standard build. -If you want to build for debugging, +If you want to build for debugging, CFLAGS=-g LDFLAGS=" " ./configure will do that. -To specify a fallback MUA in case local port 25 doesn't respond, do one of: +To specify a fallback MUA in case local port 25 doesn't respond, this is +not recommended, because you'll usually see differences between MTA and +MDA use. If you wish to proceed nonetheless, do one of: configure --enable-fallback=procmail configure --enable-fallback=sendmail @@ -94,7 +95,7 @@ A disadvantage of using procmail is that local alias expansion according to /etc/aliases won't get done if we fall back to it. Advanced configuration: - +----------------------- Specifying --with-kerberos=DIR or --with-kerberos5=DIR will tell the fetchmail build process to look in DIR for Kerberos support. Configure normally looks in /usr/kerberos and /usr/athena; if you @@ -111,27 +112,18 @@ want to add -lresolv or whatever to the definition of LOADLIBS. It is also possible to explicitly condition out the support for POP3, IMAP, and ETRN (with configure arguments of --disable-POP3, ---disable-IMAP, and --disable-ETRN respectively). However, none -of these wins back more that 3 to 4K on an Intel box. +--disable-IMAP, and --disable-ETRN respectively). -If you're running QNX, edit the distributed Makefile directly. The -QNX values for various macros are there but commented out; all you -have to do is uncomment them. -3. MAKE - -You may find you need flex at version 2.5.3 or greater to build -fetchmail. The stock lex distributed with some versions of Linux does -not work -- it yields a parser which core-dumps on syntax errors. You -can get flex at the GNU ftp site, ftp://prep.ai.mit.edu/pub/gnu. +3. MAKE Run make This should compile fetchmail for your system. If fetchmail fails to build -properly, see the FAQ section B on build-time problems. Note: parallelized -make (e.g. make -j 4) fails due to some weirdness in the yacc productions. +properly, see the FAQ section B on build-time problems. + 4. INSTALL @@ -143,10 +135,15 @@ This will install fetchmail. By default, fetchmail will be installed in /usr/local/bin, with the man page in /usr/local/man/man1. You can use the configure options --bindir and --mandir to change these. +If you are tight on disk space, you can run instead + + make install-strip + NOTE: If you are using an MTA other than sendmail (such as qmail, exim, or smail), see the FAQ (section T) for discussion of any special configuration steps that may be necessary. + 5. SET UP A RUN CONTROL FILE See the man page for a description of how to configure your individual @@ -154,6 +151,7 @@ preferences. If you're upgrading from popclient, see question F4 in the FAQ file. + 6. TEST I strongly recommend that your first fetchmail run use the -v, -a and -k @@ -168,16 +166,21 @@ Cyrus IMAP server from CMU. This covers all the servers commonly hosted on Linux and *BSD systems. It also works with the IMAP service of Microsoft Exchange, despite the fact that Microsoft Exchange is extremely broken (returns incorrect message lengths in LIST -responses). +responses). See the FAQ, section S, for detailed advice on running with various servers. + 7. REPORTING BUGS You should read the FAQ file question G3 before reporting a bug. + 8. USE IT Once you've verified your configuration, you can start fetchmail to run in background and forget about it. Enjoy! + + +END of text file INSTALL @@ -93,8 +93,12 @@ fetchmail 6.3.0 (not yet released officially): (Matthias Andree). * Internationalization (i18n) updates by Miloslav Trmac. (Matthias Andree) -* Matthias Andree's fix for "couldn't find canonical DNS name of NN - (MM)" for hosts that have only IPv6 addresses. +* Fix "couldn't find canonical DNS name of NN (MM)" for hosts that have + only IPv6 addresses. Matthias Andree. +* Revised INSTALL after question from Brian Candler, inet6-apps is no + longer available: remove inet6-apps hints for IPv6, and add some + apologetic message for IPsec. Note the code may be removed in a future + version. Matthias Andree. fetchmail-6.2.5 (Wed Oct 15 18:39:22 EDT 2003), 23079 lines: |