From ad96f3ef1136aa4a201a5dffceb2b005be4b7011 Mon Sep 17 00:00:00 2001 From: Matthias Andree Date: Sun, 5 Dec 2021 09:53:54 +0100 Subject: README*: update --- README | 7 +++++-- README.SSL | 6 +++++- README.maintainer | 43 +++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 53 insertions(+), 3 deletions(-) diff --git a/README b/README index 616327f8..7f5a9cf5 100644 --- a/README +++ b/README @@ -20,13 +20,16 @@ Fetchmail also fully supports authentication via GSSAPI, Kerberos 4 and 5, RFC1938 one-time passwords, Compuserve's POP3 with RPA, Microsoft's NTLM, Demon Internet's SDPS, or CRAM-MD5 authentication a la RFC2195. -Fetchmail supports end-to-end encryption with OpenSSL or wolfSSL (only on C99 -or newer compilers), do read README.SSL for details on fetchmail's +Fetchmail supports end-to-end encryption with OpenSSL or wolfSSL (the latter +only on C99 or newer compilers), do read README.SSL for details on fetchmail's configuration and README.SSL-SERVER for server-side requirements. NOTE! To be compatible with earlier releases, fetchmail 6.4 default behaviour is more relaxed than dictated by recommendations - while it does away with SSLv2, only negotiates SSLv3 if forced to, it will by default still negotiate TLS v1.0. +Also note that if used with wolfSSL, many texts will still read OpenSSL +because fetchmail uses wolfSSL's OpenSSL compatibility API. + Portability ----------- diff --git a/README.SSL b/README.SSL index f5eca24f..c3ce0b02 100644 --- a/README.SSL +++ b/README.SSL @@ -25,7 +25,11 @@ Fetchmail 6.4.25 supports OpenSSL 3.0 and 1.1.1 and WolfSSL 5.0. Note that WolfSSL 5.0 is a bit less flexible about its trust store, see INSTALL chapter 2.1 for details. - -- Matthias Andree, 2021-11-20 +Note that many messages printed by fetchmail will print "OpenSSL" +even if wolfSSL is being used. Reason is that fetchmail uses +wolfSSL's OpenSSL compatibility layer and not the native wolfSSL API. + + -- Matthias Andree, 2021-12-05 Quickstart diff --git a/README.maintainer b/README.maintainer index e9b238f6..33e1b093 100644 --- a/README.maintainer +++ b/README.maintainer @@ -2,3 +2,46 @@ MAINTAINER NOTES ================ Text documents are edited with vim "set tw=79 ai fo=atrq1w2" options. + +Debian testing and Ubuntu 18.04 minimum survival from Git checkout, 2021-12-04: +# apt update && apt upgrade -y +# apt install -y --no-install-recommends build-essential automake \ + gettext gitk autopoint bison flex ca-certificates openssh-client \ + netbase pkg-config bash libssl-dev +Redistributing requires additional packages: +# apt install --no-install-recommends -y \ + man lynx htmldoc asciidoc libcarp-always-perl lzip rsync + +# git clone https://gitlab.com/fetchmail/fetchmail.git fetchmail.git +# cd fetchmail.git +# autoreconf -if +# mkdir -p _build && cd _build +# ../configure +# make check -j8 + +Alpine Linux cannot rebuild the distribution, it lacks HTMLDOC. +To install requisites: +# apk add autoconf automake bison flex gettext gettext-dev gettext-lang git \ + build-base openssl3-dev openssh-client-default +Then continue with Debian's git clone ... above. + +Fedora Linux as of 34 cannot rebuild the distribution, it lacks HTMLDOC. +To install requisites: +# dnf install -y automake bison ca-certificates gettext-devel git pkg-config \ + openssl-devel vim-minimal findutils gcc make flex +then continue with the git clone... above. + +Arch Linux: +# pacman -Syu --noconfirm && pacman -S --noconfirm automake gcc autoconf flex \ + bison gettext ca-certificates pkg-config make git +And for redistributing: +# pacman -S --noconfirm lynx htmldoc asciidoc lzip rsync perl-carp-always \ + perl-encode-locale + +OpenSUSE Linux: +# zypper up -y +# zypper in -y automake autoconf gcc bison flex pkgconf-pkg-config \ + libopenssl-devel openssh git gcc gettext-tools tar make +And for redistributing: +# zypper in -y asciidoc lynx htmldoc perl-Carp-Always rsync lzip \ + perl-Encode-Locale -- cgit v1.2.3