83bb35f1d3c4a4c51b780d7cd91197fd0e1ddc24
[gnupg-doc.git] / web / software / libgcrypt / index.org
1 #+STARTUP: showall
2 #+SETUPFILE: "../../share/setup.inc"
3 #+GPGWEB-NEED-SWDB
4
5 * Libgcrypt
6
7   /Libgcrypt/ is a general purpose cryptographic library originally
8   based on code from GnuPG.  It provides functions for all
9   cryptograhic building blocks: symmetric cipher algorithms
10   (AES,
11   Arcfour,
12   Blowfish,
13   [[http://info.isl.ntt.co.jp/crypt/eng/camellia/][Camellia]],
14   CAST5,
15   ChaCha20
16   DES,
17   GOST28147,
18   Salsa20,
19   [[http://tools.ietf.org/html/rfc4269][SEED]],
20   Serpent,
21   Twofish)
22   and modes (ECB,CFB,CBC,OFB,CTR,CCM,GCM,OCB,POLY1305,AESWRAP),
23   hash algorithms
24   (MD2, MD4, MD5, GOST R 34.11, RIPE-MD160, SHA-1, SHA2-224,
25    SHA2-256, SHA2-384, SHA2-512, SHA3-224, SHA3-256, SHA3-384,
26    SHA3-512, SHAKE-128, SHAKE-256, TIGER-192, Whirlpool),
27   MACs (HMAC for
28    all hash algorithms, CMAC for all cipher algorithms, GMAC-AES,
29    GMAC-CAMELLIA, GMAC-TWOFISH, GMAC-SERPENT, GMAC-SEED, Poly1305,
30    Poly1305-AES, Poly1305-CAMELLIA, Poly1305-TWOFISH,
31    Poly1305-SERPENT, Poly1305-SEED),
32    public key algorithms (RSA, Elgamal, DSA, ECDSA, EdDSA, ECDH),
33    large integer functions, random numbers and a lot of
34    supporting functions.
35
36   Libgcrypt works on most POSIX systems and many pre-POSIX systems.
37   It can also be built using a cross-compiler system for Microsoft
38   Windows.
39
40   See also its [[https://en.wikipedia.org/wiki/Libgcrypt][Wikipedia]] entry.
41
42
43 ** Availibility
44
45    Due to former U.S. export restrictions on cryptographic software,
46    the software is not distributed via the standard GNU archives but
47    from the European based GnuPG server.
48
49    The current stable version is {{{libgcrypt_ver}}} which was
50    released on {{{libgcrypt_date}}}.  See the [[../../download/index.org::libgcrypt][download]] section for the
51    latest tarball.
52
53    All versions of Libgcrypt since 1.2 are API and ABI compatible.
54    The 1.6 series reached end-of-life on 2017-06-30.  The 1.7 series
55    will receive updates for severe bugs and security problems until
56    2019-06-30.
57
58 ** Copying
59
60    Libgcrypt is distributed under the terms of the GNU Lesser General
61    Public License (LGPLv2.1+).  The helper programs as well as the
62    documentation are distributed under the terms of the GNU General
63    Public License (GPLv2+).  The file LICENSES has notices about
64    contributions that require that these additional notices are
65    distributed.