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
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
|
/*
* Copyright (C) 2011 Collabora Ltd.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* * Redistributions of source code must retain the above
* copyright notice, this list of conditions and the
* following disclaimer.
* * Redistributions in binary form must reproduce the
* above copyright notice, this list of conditions and
* the following disclaimer in the documentation and/or
* other materials provided with the distribution.
* * The names of contributors to this software may not be
* used to endorse or promote products derived from this
* software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
* THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*
* Author: Stef Walter <stefw@collabora.co.uk>
*/
#include "config.h"
#include "pkcs11.h"
#include "p11-kit.h"
/**
* SECTION:p11-kit-util
* @title: Utilities
* @short_description: PKCS\#11 utilities
*
* Utility functions for working with PKCS\#11.
*/
#ifdef ENABLE_NLS
#include <libintl.h>
#define _(x) dgettext(PACKAGE_NAME, x)
#else
#define _(x) x
#endif
/**
* p11_kit_strerror:
* @rv: The code to get a message for.
*
* Get a message for a PKCS\#11 return value or error code. Do not
* pass CKR_OK or other such non errors to this function.
*
* Returns: The user readable and localized message.
**/
const char*
p11_kit_strerror (CK_RV rv)
{
switch (rv) {
/* These are not really errors, or not current */
case CKR_OK:
case CKR_NO_EVENT:
case CKR_FUNCTION_NOT_PARALLEL:
case CKR_SESSION_PARALLEL_NOT_SUPPORTED:
return "";
case CKR_CANCEL:
case CKR_FUNCTION_CANCELED:
return _("The operation was cancelled");
case CKR_HOST_MEMORY:
return _("Insufficient memory available");
case CKR_SLOT_ID_INVALID:
return _("The specified slot ID is not valid");
case CKR_GENERAL_ERROR:
return _("Internal error");
case CKR_FUNCTION_FAILED:
return _("The operation failed");
case CKR_ARGUMENTS_BAD:
return _("Invalid arguments");
case CKR_NEED_TO_CREATE_THREADS:
return _("The module cannot create needed threads");
case CKR_CANT_LOCK:
return _("The module cannot lock data properly");
case CKR_ATTRIBUTE_READ_ONLY:
return _("The field is read-only");
case CKR_ATTRIBUTE_SENSITIVE:
return _("The field is sensitive and cannot be revealed");
case CKR_ATTRIBUTE_TYPE_INVALID:
return _("The field is invalid or does not exist");
case CKR_ATTRIBUTE_VALUE_INVALID:
return _("Invalid value for field");
case CKR_DATA_INVALID:
return _("The data is not valid or unrecognized");
case CKR_DATA_LEN_RANGE:
return _("The data is too long");
case CKR_DEVICE_ERROR:
return _("An error occurred on the device");
case CKR_DEVICE_MEMORY:
return _("Insufficient memory available on the device");
case CKR_DEVICE_REMOVED:
return _("The device was removed or unplugged");
case CKR_ENCRYPTED_DATA_INVALID:
return _("The encrypted data is not valid or unrecognized");
case CKR_ENCRYPTED_DATA_LEN_RANGE:
return _("The encrypted data is too long");
case CKR_FUNCTION_NOT_SUPPORTED:
return _("This operation is not supported");
case CKR_KEY_HANDLE_INVALID:
return _("The key is missing or invalid");
case CKR_KEY_SIZE_RANGE:
return _("The key is the wrong size");
case CKR_KEY_TYPE_INCONSISTENT:
return _("The key is of the wrong type");
case CKR_KEY_NOT_NEEDED:
return _("No key is needed");
case CKR_KEY_CHANGED:
return _("The key is different than before");
case CKR_KEY_NEEDED:
return _("A key is needed");
case CKR_KEY_INDIGESTIBLE:
return _("Cannot include the key in the digest");
case CKR_KEY_FUNCTION_NOT_PERMITTED:
return _("This operation cannot be done with this key");
case CKR_KEY_NOT_WRAPPABLE:
return _("The key cannot be wrapped");
case CKR_KEY_UNEXTRACTABLE:
return _("Cannot export this key");
case CKR_MECHANISM_INVALID:
return _("The crypto mechanism is invalid or unrecognized");
case CKR_MECHANISM_PARAM_INVALID:
return _("The crypto mechanism has an invalid argument");
case CKR_OBJECT_HANDLE_INVALID:
return _("The object is missing or invalid");
case CKR_OPERATION_ACTIVE:
return _("Another operation is already taking place");
case CKR_OPERATION_NOT_INITIALIZED:
return _("No operation is taking place");
case CKR_PIN_INCORRECT:
return _("The password or PIN is incorrect");
case CKR_PIN_INVALID:
return _("The password or PIN is invalid");
case CKR_PIN_LEN_RANGE:
return _("The password or PIN is of an invalid length");
case CKR_PIN_EXPIRED:
return _("The password or PIN has expired");
case CKR_PIN_LOCKED:
return _("The password or PIN is locked");
case CKR_SESSION_CLOSED:
return _("The session is closed");
case CKR_SESSION_COUNT:
return _("Too many sessions are active");
case CKR_SESSION_HANDLE_INVALID:
return _("The session is invalid");
case CKR_SESSION_READ_ONLY:
return _("The session is read-only");
case CKR_SESSION_EXISTS:
return _("An open session exists");
case CKR_SESSION_READ_ONLY_EXISTS:
return _("A read-only session exists");
case CKR_SESSION_READ_WRITE_SO_EXISTS:
return _("An administrator session exists");
case CKR_SIGNATURE_INVALID:
return _("The signature is bad or corrupted");
case CKR_SIGNATURE_LEN_RANGE:
return _("The signature is unrecognized or corrupted");
case CKR_TEMPLATE_INCOMPLETE:
return _("Certain required fields are missing");
case CKR_TEMPLATE_INCONSISTENT:
return _("Certain fields have invalid values");
case CKR_TOKEN_NOT_PRESENT:
return _("The device is not present or unplugged");
case CKR_TOKEN_NOT_RECOGNIZED:
return _("The device is invalid or unrecognizable");
case CKR_TOKEN_WRITE_PROTECTED:
return _("The device is write protected");
case CKR_UNWRAPPING_KEY_HANDLE_INVALID:
return _("Cannot import because the key is invalid");
case CKR_UNWRAPPING_KEY_SIZE_RANGE:
return _("Cannot import because the key is of the wrong size");
case CKR_UNWRAPPING_KEY_TYPE_INCONSISTENT:
return _("Cannot import because the key is of the wrong type");
case CKR_USER_ALREADY_LOGGED_IN:
return _("You are already logged in");
case CKR_USER_NOT_LOGGED_IN:
return _("No user has logged in");
case CKR_USER_PIN_NOT_INITIALIZED:
return _("The user's password or PIN is not set");
case CKR_USER_TYPE_INVALID:
return _("The user is of an invalid type");
case CKR_USER_ANOTHER_ALREADY_LOGGED_IN:
return _("Another user is already logged in");
case CKR_USER_TOO_MANY_TYPES:
return _("Too many users of different types are logged in");
case CKR_WRAPPED_KEY_INVALID:
return _("Cannot import an invalid key");
case CKR_WRAPPED_KEY_LEN_RANGE:
return _("Cannot import a key of the wrong size");
case CKR_WRAPPING_KEY_HANDLE_INVALID:
return _("Cannot export because the key is invalid");
case CKR_WRAPPING_KEY_SIZE_RANGE:
return _("Cannot export because the key is of the wrong size");
case CKR_WRAPPING_KEY_TYPE_INCONSISTENT:
return _("Cannot export because the key is of the wrong type");
case CKR_RANDOM_SEED_NOT_SUPPORTED:
return _("Unable to initialize the random number generator");
case CKR_RANDOM_NO_RNG:
return _("No random number generator available");
case CKR_DOMAIN_PARAMS_INVALID:
return _("The crypto mechanism has an invalid parameter");
case CKR_BUFFER_TOO_SMALL:
return _("Not enough space to store the result");
case CKR_SAVED_STATE_INVALID:
return _("The saved state is invalid");
case CKR_INFORMATION_SENSITIVE:
return _("The information is sensitive and cannot be revealed");
case CKR_STATE_UNSAVEABLE:
return _("The state cannot be saved");
case CKR_CRYPTOKI_NOT_INITIALIZED:
return _("The module has not been initialized");
case CKR_CRYPTOKI_ALREADY_INITIALIZED:
return _("The module has already been initialized");
case CKR_MUTEX_BAD:
return _("Cannot lock data");
case CKR_MUTEX_NOT_LOCKED:
return _("The data cannot be locked");
case CKR_FUNCTION_REJECTED:
return _("The request was rejected by the user");
default:
return _("Unknown error");
}
}
|