Post release updates.
[gnupg.git] / announce.txt
1 To: gnupg-announce@gnupg.org, info-gnu@gnu.org
2 Mail-Followup-To: gnupg-users@gnupg.org
3
4
5 Hello!
6
7 We are pleased to announce the availability of a new stable GnuPG-2
8 release: Version 2.0.22.  This is a *security fix* release and all
9 users are advised to updated to this version.  See below for the
10 impact of the problem.
11
12 The GNU Privacy Guard (GnuPG) is GNU's tool for secure communication
13 and data storage.  It can be used to encrypt data, create digital
14 signatures, help authenticating using Secure Shell and to provide a
15 framework for public key cryptography.  It includes an advanced key
16 management facility and is compliant with the OpenPGP and S/MIME
17 standards.
18
19 GnuPG-2 has a different architecture than GnuPG-1 (e.g. 1.4.14) in
20 that it splits up functionality into several modules.  However, both
21 versions may be installed alongside without any conflict.  In fact,
22 the gpg version from GnuPG-1 is able to make use of the gpg-agent as
23 included in GnuPG-2 and allows for seamless passphrase caching.  The
24 advantage of GnuPG-1 is its smaller size and the lack of dependency on
25 other modules at run and build time.  We will keep maintaining GnuPG-1
26 versions because they are very useful for small systems and for server
27 based applications requiring only OpenPGP support.
28
29 GnuPG is distributed under the terms of the GNU General Public License
30 (GPLv3+).  GnuPG-2 works best on GNU/Linux and *BSD systems but is
31 also available for other Unices, Microsoft Windows and Mac OS X.
32
33
34 What's New in 2.0.22
35 ====================
36
37  * Fixed possible infinite recursion in the compressed packet
38    parser. [CVE-2013-4402]
39
40  * Improved support for some card readers.
41
42  * Prepared building with the forthcoming Libgcrypt 1.6.
43
44  * Protect against rogue keyservers sending secret keys.
45
46
47 Impact of the security problem
48 ==============================
49
50 Special crafted input data may be used to cause a denial of service
51 against GPG (GnuPG's OpenPGP part) and some other OpenPGP
52 implementations.  All systems using GPG to process incoming data are
53 affected.
54
55 Taylor R Campbell invented a neat trick to generate OpenPGP packages
56 to force GPG to recursively parse certain parts of OpenPGP messages ad
57 infinitum.  As a workaround a tight "ulimit -v" setting may be used to
58 mitigate the problem.  Sample input data to trigger this problem has
59 not yet been seen in the wild.  Details of the attack will eventually
60 be published by its inventor.
61
62 A fixed release of the GnuPG 1.4 series will be releases soon.
63
64
65
66 Getting the Software
67 ====================
68
69 Please follow the instructions found at http://www.gnupg.org/download/
70 or read on:
71
72 GnuPG 2.0.22 may be downloaded from one of the GnuPG mirror sites or
73 direct from ftp://ftp.gnupg.org/gcrypt/gnupg/ .  The list of mirrors
74 can be found at http://www.gnupg.org/mirrors.html .  Note, that GnuPG
75 is not available at ftp.gnu.org.
76
77 On the FTP server and its mirrors you should find the following files
78 in the gnupg/ directory:
79
80   gnupg-2.0.22.tar.bz2 (4200k)
81   gnupg-2.0.22.tar.bz2.sig
82
83       GnuPG source compressed using BZIP2 and OpenPGP signature.
84
85   gnupg-2.0.20-2.0.22.diff.bz2 (39k)
86
87       A patch file to upgrade a 2.0.20 GnuPG source tree.  This patch
88       does not include updates of the language files.
89
90 Note, that we don't distribute gzip compressed tarballs for GnuPG-2.
91
92
93 Checking the Integrity
94 ======================
95
96 In order to check that the version of GnuPG which you are going to
97 install is an original and unmodified one, you can do it in one of
98 the following ways:
99
100  * If you already have a trusted version of GnuPG installed, you
101    can simply check the supplied signature.  For example to check the
102    signature of the file gnupg-2.0.22.tar.bz2 you would use this command:
103
104      gpg --verify gnupg-2.0.22.tar.bz2.sig
105
106    This checks whether the signature file matches the source file.
107    You should see a message indicating that the signature is good and
108    made by that signing key.  Make sure that you have the right key,
109    either by checking the fingerprint of that key with other sources
110    or by checking that the key has been signed by a trustworthy other
111    key.  Note, that you can retrieve the signing key using the command
112
113      finger wk ,at' g10code.com
114
115    or using a keyserver like
116
117      gpg --keyserver keys.gnupg.net --recv-key 4F25E3B6
118
119    The distribution key 4F25E3B6 is signed by the well known key
120    1E42B367.
121
122    NEVER USE A GNUPG VERSION YOU JUST DOWNLOADED TO CHECK THE
123    INTEGRITY OF THE SOURCE - USE AN EXISTING GNUPG INSTALLATION!
124
125  * If you are not able to use an old version of GnuPG, you have to verify
126    the SHA-1 checksum.  Assuming you downloaded the file
127    gnupg-2.0.22.tar.bz2, you would run the sha1sum command like this:
128
129      sha1sum gnupg-2.0.22.tar.bz2
130
131    and check that the output matches the first line from the
132    following list:
133
134 9ba9ee288e9bf813e0f1e25cbe06b58d3072d8b8  gnupg-2.0.22.tar.bz2
135 6cc51b14ed652fe7eadae25ec7cdaa6f63377525  gnupg-2.0.21-2.0.22.diff.bz2
136
137
138 Documentation
139 =============
140
141 The file gnupg.info has the complete user manual of the system.
142 Separate man pages are included as well; however they have not all the
143 details available in the manual.  It is also possible to read the
144 complete manual online in HTML format at
145
146   http://www.gnupg.org/documentation/manuals/gnupg/
147
148 or in Portable Document Format at
149
150   http://www.gnupg.org/documentation/manuals/gnupg.pdf .
151
152 The chapters on gpg-agent, gpg and gpgsm include information on how
153 to set up the whole thing.  You may also want search the GnuPG mailing
154 list archives or ask on the gnupg-users mailing lists for advise on
155 how to solve problems.  Many of the new features are around for
156 several years and thus enough public knowledge is already available.
157
158 Almost all mail clients support GnuPG-2.  Mutt users may want to use
159 the configure option "--enable-gpgme" during build time and put a "set
160 use_crypt_gpgme" in ~/.muttrc to enable S/MIME support along with the
161 reworked OpenPGP support.
162
163
164 Support
165 =======
166
167 Please consult the archive of the gnupg-users mailing list before
168 reporting a bug <http://gnupg.org/documentation/mailing-lists.html>.
169 We suggest to send bug reports for a new release to this list in favor
170 of filing a bug at <http://bugs.gnupg.org>.  We also have a dedicated
171 service directory at:
172
173   http://www.gnupg.org/service.html
174
175 The driving force behind the development of GnuPG is the company of
176 its principal author, Werner Koch.  Maintenance and improvement of
177 GnuPG and related software takes up most of their resources.  To allow
178 him to continue this work he kindly asks to either purchase a support
179 contract, engage g10 Code for custom enhancements, or to donate money:
180
181   http://g10code.com/gnupg-donation.html
182
183
184 Thanks
185 ======
186
187 We have to thank all the people who helped with this release, be it
188 testing, coding, translating, suggesting, auditing, administering the
189 servers, spreading the word, or answering questions on the mailing
190 lists.
191
192
193 Happy Hacking,
194
195   The GnuPG Team