documenting new patched GnuTLS offerings.
[monkeysphere.git] / website / news / modified-gnutls-2.4.x-available.mdwn
1 [[meta title="Modified GnuTLS 2.4.x available"]]
2
3 The MonkeySphere project is now making available a patched version of
4 [GnuTLS](http://gnutls.org/) version 2.4.x, which enhances the utility
5 of the `monkeysphere` package by enabling it to read authentication
6 subkeys emitted by [GnuPG](http://gnupg.org/) under certain
7 circumstances.
8
9 You can track this package in debian lenny by adding the following
10 lines to `/etc/apt/sources.list`:
11
12         deb http://monkeysphere.info/debian experimental gnutls
13         deb-src http://monkeysphere.info/debian experimental gnutls
14
15 Or you can patch and build the packages yourself with the patches and
16 scripts provided in [the MonkeySphere git repo](/download).
17
18 The only modification needed simply enables the library to parse a GNU
19 extension to the String-to-key (S2K) mechanism as laid out in [RFC
20 4880](http://tools.ietf.org/html/rfc4880#section-3.7).
21
22 The specific S2K extension supported is known as gnu-dummy, and it
23 simply allows a "secret" key block to be written *without* storing any
24 of the secret key material.  This is used by GnuPG on the primary key
25 when the `--export-secret-subkeys` argument is given.
26
27 You can read notes about the GNU S2K extensions in DETAILS from GnuPG,
28 which you can fetch this way:
29
30         svn co svn://cvs.gnupg.org/gnupg/trunk/doc
31         less doc/DETAILS
32
33 A version of this patch was first proposed [on
34 `gnutls-dev`](http://lists.gnu.org/archive/html/gnutls-devel/2008-08/msg00005.html),
35 and looks like it will be adopted upstream in the GnuTLS 2.6.x series,
36 at which point these packages will be unnecessary.
37
38 Until that time, these packages are provided to tide over users of
39 `monkeysphere` on debian lenny (or compatible systems) who want to be
40 able to hand off the authentication-capable OpenPGP subkeys in their
41 GnuPG keyring to their SSH agent.