aboutsummaryrefslogtreecommitdiffstats
path: root/INSTALL
diff options
context:
space:
mode:
authorMatthias Andree <matthias.andree@gmx.de>2005-07-03 22:02:06 +0000
committerMatthias Andree <matthias.andree@gmx.de>2005-07-03 22:02:06 +0000
commitc7b714900c6e452ac37c54f7ff2c419fbd1194b2 (patch)
tree16347985ac44fcdf1ba64030366df07fa842854c /INSTALL
parent506cc73eb32fd40ad34e1e2e093b99c87a6ac2e1 (diff)
downloadfetchmail-c7b714900c6e452ac37c54f7ff2c419fbd1194b2.tar.gz
fetchmail-c7b714900c6e452ac37c54f7ff2c419fbd1194b2.tar.bz2
fetchmail-c7b714900c6e452ac37c54f7ff2c419fbd1194b2.zip
Remove inet6-apps hints for IPv6 support.
svn path=/trunk/; revision=4079
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL79
1 files changed, 41 insertions, 38 deletions
diff --git a/INSTALL b/INSTALL
index c332fc11..54b9f46c 100644
--- a/INSTALL
+++ b/INSTALL
@@ -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