1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
libgpg-error
============
This is a library that defines common error values for all GnuPG
components. Among these are GPG, GPGSM, GPGME, GPG-Agent, libgcrypt,
Libksba, DirMngr, Pinentry, SmartCard Daemon and more.
libgpg-error is free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 2.1 of the
License, or (at your option) any later version. See the file
COPYING.LIB for copyright and warranty information. See the file
AUTHORS for a list of authors and important mail addresses.
However, some files (for example src/mkerrnos.awk) used in the build
process of the library are covered by a different license. Please see
the header of these files and the file COPYING for copyright and
warranty information on these files. A special exception in the
copyright license of these files makes sure that the output in the
build process, which is used in libgpg-error, is not affected by the
GPL.
Installation
------------
Please read the file INSTALL!
Here is a quick summary:
1) Check that you have unmodified sources. You can find instructions
how to verify the sources below. Don't skip this - it is an
important step!
2) Unpack the archive. With GNU tar you can do it this way:
"tar xjvf libgpg-error-x.y.tar.bz2"
3) "cd libgpg-error-x.y"
4) "./configure"
5) "make"
6) "make install"
How to Verify the Source
------------------------
In order to check that the version of libgpg-error which you are going
to install is an original and unmodified copy of the original, you can
do it in one of the following ways:
a) If you already have a trusted version of GnuPG installed, you can
simply check the supplied signature:
$ gpg --verify libgpg-error-x.y.tar.bz2.sig
This checks that the detached signature libgpg-error-x.y.tar.bz2.sig
is indeed a a signature of libgpg-error-x.y.tar.bz2.
Please note that you have to use an old version of GnuPG to do all
this stuff. *Never* use the version which was built using the
library you are trying to verify!
b) If you don't have any a trusted version of GnuPG, you can attempt
to verify the SHA1 checksum, using a trusted version of the sha1sum
program:
$ sha1sum libgpg-error-x.y.tar.bz2
This should yield an output _similar_ to this:
610064e5b77700f5771c8fde2691c4365e1ca100 libgpg-error-x.y.tar.bz2
Now check that this checksum is _exactly_ the same as the one
published via the announcement list and probably via Usenet.
Hints
-----
To build for Windows you you may use the convenience command:
./autogen.sh --build-w32
which runs configure with suitable options. For WindowsCE the command
is:
./autogen.sh --build-w32ce
There is also _experimental_ support for building a 64 bit Windows
version:
./autogen.sh --build-w64
Cross-Compiling
---------------
Libgpg-error needs to figure out some platform specific properties.
These are used to build the platform specific gpg-error.h file. The
detection is done during build time but can't be done when
cross-compiling. Thus if you run into an error during building you
need to figure out these values. You may use these commands:
build="$(build-aux/config.guess)"
./configure --prefix=TARGETDIR --host=TARGET --build=$build
cd src
make gen-posix-lock-obj
scp gen-posix-lock-obj TARGET:
ssh TARGET ./gen-posix-lock-obj >tmp.h
mv tmp.h "syscfg/$(awk 'NR==1 {print $2}' tmp.h)"
If you are using a VPATH build adjust accordingly. If this all works
for you (make sure to run the test programs on the target platform),
please send the generated file to the gnupg-devel mailing list so that
we can include it in the next release.
Known Problems
--------------
On Windows, WSA Error Codes can be provided as system error codes and
will be transparently converted to the corresponding gpg error codes.
There are two problems with this support:
* Not all error codes corresponding to WSA Error codes have a detailed
description when printed with gpg_strerror. Some will default to
"Unknown error" for pretty printing. For example, WSAEHOSTDOWN will
be translated to GPG_ERR_EHOSTDOWN, but there is no corresponding
EHOSTDOWN in Windows and thus gpg_strerror will default to "Unknown
error" as printed by the system's strerror function for the argument
WSAEHOSTDOWN. (This could be fixed by adding our own error strings
replacing or extending the system error strings, including their
translations).
* The translation to a gpg error code and back to a system error code
in some cases does not preserve information. For example, the error code
WSAEACCES translates to GPG_ERR_EACCES, which translates back to
EACCES.
Any WSA Error code has either the first problem or the second (but not
both), depending on if there is a corresponding Windows error code.
|
