|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| build-aux/ | H | 08-Jan-2021 | - | 25,298 | 21,072 |
| conf/ | H | 08-Jan-2021 | - | 286 | 202 |
| doc/ | H | 08-Jan-2021 | - | 32,791 | 27,084 |
| lang/ | H | 08-Jan-2021 | - | 78,493 | 56,336 |
| m4/ | H | 08-Jan-2021 | - | 10,971 | 9,839 |
| src/ | H | 08-Jan-2021 | - | 62,981 | 47,352 |
| tests/ | H | 03-May-2022 | - | 21,248 | 16,961 |
| AUTHORS | H A D | 08-Jan-2021 | 2.5 KiB | 82 | 59 |
| COPYING | H A D | 15-Mar-2013 | 17.6 KiB | 341 | 281 |
| COPYING.LESSER | H A D | 15-Mar-2013 | 25.9 KiB | 511 | 430 |
| ChangeLog | H A D | 08-Jan-2021 | 447.8 KiB | 12,002 | 9,683 |
| ChangeLog-2011 | H A D | 15-Mar-2013 | 28.3 KiB | 1,039 | 629 |
| INSTALL | H A D | 15-Mar-2013 | 9.3 KiB | 238 | 179 |
| Makefile.am | H A D | 08-Jan-2021 | 4.8 KiB | 142 | 95 |
| Makefile.in | H A D | 08-Jan-2021 | 33.3 KiB | 1,044 | 909 |
| NEWS | H A D | 08-Jan-2021 | 83.4 KiB | 2,207 | 1,667 |
| README | H A D | 08-Jan-2021 | 4 KiB | 117 | 79 |
| THANKS | H A D | 18-Oct-2016 | 1.5 KiB | 36 | 31 |
| TODO | H A D | 03-Dec-2018 | 18.8 KiB | 707 | 573 |
| VERSION | H A D | 08-Jan-2021 | 7 | 2 | 1 |
| acinclude.m4 | H A D | 12-Dec-2017 | 2.2 KiB | 77 | 72 |
| aclocal.m4 | H A D | 08-Jan-2021 | 44 KiB | 1,226 | 1,114 |
| autogen.rc | H A D | 07-Dec-2018 | 230 | 15 | 10 |
| autogen.sh | H A D | 12-Oct-2018 | 14 KiB | 514 | 403 |
| configure | H A D | 03-May-2022 | 880.6 KiB | 29,369 | 24,822 |
| configure.ac | H A D | 08-Jan-2021 | 29 KiB | 954 | 835 |
| gpgme.spec | H A D | 08-Jan-2021 | 1.9 KiB | 71 | 57 |
| gpgme.spec.in | H A D | 03-Dec-2018 | 1.9 KiB | 71 | 59 |
| missing | H A D | 15-Mar-2013 | 10.9 KiB | 368 | 275 |
README
1 GPGME - GnuPG Made Easy
2 ---------------------------
3
4Copyright 2001-2021 g10 Code GmbH
5
6This file is free software; as a special exception the author gives
7unlimited permission to copy and/or distribute it, with or without
8modifications, as long as this notice is preserved.
9
10This file is distributed in the hope that it will be useful, but
11WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
12implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
13PURPOSE.
14
15
16Introduction
17--------------
18
19GnuPG Made Easy (GPGME) is a C language library that allows to add
20support for cryptography to a program. It is designed to make access
21to public key crypto engines like GnuPG or GpgSM easier for
22applications. GPGME provides a high-level crypto API for encryption,
23decryption, signing, signature verification and key management.
24
25GPGME comes with language bindings for Common Lisp, C++, QT, Python2,
26and Python 3.
27
28GPGME uses GnuPG as its backend to support OpenPGP and the
29Cryptographic Message Syntax (CMS).
30
31See the files COPYING, COPYING.LESSER, and each file for copyright and
32warranty information. The file AUTHORS has a list of authors and
33useful web and mail addresses.
34
35
36Installation
37--------------
38
39See the file INSTALL for generic installation instructions.
40
41Check that you have unmodified sources. See below on how to do this.
42Don't skip it - this is an important step!
43
44To build GPGME, you need to install libgpg-error (>= 1.24) and
45Libassuan (>= 2.4.2).
46
47For support of the OpenPGP and the CMS protocols, you should use the
48latest version of GnuPG (>= 2.1.18) , available at:
49https://gnupg.org/ftp/gcrypt/gnupg/.
50
51For building the Git version of GPGME please see the file README.GIT
52for more information.
53
54
55How to Verify the Source
56--------------------------
57
58In order to check that the version of GPGME which you are going to
59install is an original and unmodified one, you can do it in one of the
60following ways:
61
62a) If you have a trusted Version of GnuPG installed, you can simply check
63 the supplied signature:
64
65 $ gpg --verify gpgme-x.y.z.tar.gz.sig gpgme-x.y.z.tar.gz
66
67 This checks that the detached signature gpgme-x.y.z.tar.gz.sig is
68 indeed a a signature of gpgme-x.y.z.tar.gz. The key used to create
69 this signature is at least one of:
70
71 rsa2048 2011-01-12 [expires: 2019-12-31]
72 Key fingerprint = D869 2123 C406 5DEA 5E0F 3AB5 249B 39D2 4F25 E3B6
73 Werner Koch (dist sig)
74
75 rsa2048 2014-10-29 [expires: 2019-12-31]
76 Key fingerprint = 46CC 7308 65BB 5C78 EBAB ADCF 0437 6F3E E085 6959
77 David Shaw (GnuPG Release Signing Key) <dshaw 'at' jabberwocky.com>
78
79 rsa2048 2014-10-29 [expires: 2020-10-30]
80 Key fingerprint = 031E C253 6E58 0D8E A286 A9F2 2071 B08A 33BD 3F06
81 NIIBE Yutaka (GnuPG Release Key) <gniibe 'at' fsij.org>
82
83 rsa3072 2017-03-17 [expires: 2027-03-15]
84 Key fingerprint = 5B80 C575 4298 F0CB 55D8 ED6A BCEF 7E29 4B09 2E28
85 Andre Heinecke (Release Signing Key)
86
87 The keys are available at <https://gnupg.org/signature_key.html>
88 and in released GnuPG tarballs in the file g10/distsigkey.gpg .
89 You have to make sure that these are really the desired keys and
90 not faked one. You should do this by comparing the fingerprints
91 with the fingerprints published elsewhere.
92
93b) If you don't have any of the above programs, you have to verify
94 the SHA1 checksum:
95
96 $ sha1sum gpgme-x.y.z.tar.gz
97
98 This should yield an output _similar_ to this:
99
100 fd9351b26b3189c1d577f0970f9dcadc3412def1 gpgme-x.y.z.tar.gz
101
102 Now check that this checksum is _exactly_ the same as the one
103 published via the announcement list and probably via Usenet.
104
105
106Documentation
107---------------
108
109For information how to use the library you can read the info manual,
110which is also a reference book, in the doc/ directory. The programs
111in the tests/ directory may also prove useful.
112
113Please subscribe to the gnupg-devel@gnupg.org mailing list if you want
114to do serious work.
115
116For hacking on GPGME, please have a look at doc/HACKING.
117