ISARA Radiate Security Solution Suite Toolkit Edition Version 1.5

Quantum-safe cryptographic primitives and algorithms.

iqr_retval.h
Go to the documentation of this file.
1 
19 #ifndef IQR_RETVAL_H
20 #define IQR_RETVAL_H
21 
22 #ifdef __cplusplus
23 extern "C" {
24 #endif
25 
26 #include "iqr_api.h"
27 
28 typedef enum {
30  IQR_OK = 0,
31 
32  // -----------------------------------------------------------------------------------------------------------------------------
33  // General error values.
34  // -----------------------------------------------------------------------------------------------------------------------------
35 
37  IQR_ENULLPTR = -1001,
38 
40  IQR_ENOMEM = -1002,
41 
43  IQR_ENOTINIT = -1003,
44 
46  IQR_EINVBUFSIZE = -1004,
47 
49  IQR_EBADVALUE = -1005,
50 
52  IQR_EOUTOFRANGE = -1006,
53 
55  IQR_EVALUENOTSUPP = -1007,
56 
58  IQR_EINVOBJECT = -1008,
59 
61  IQR_EINVCALLBACKS = -1009,
62 
64  IQR_ENOTREGISTERED = -1010,
65 
67  IQR_EINVDATA = -1011,
68 
71  IQR_EINVPTR = -1012,
72 
74  IQR_EPTROVERLAP = -1013,
75 
77  IQR_ELIBRARYMISMATCH = -1014,
78 
80  IQR_EINVSTRATEGY = -1015,
81 
82  // -----------------------------------------------------------------------------------------------------------------------------
83  // Algorithm error values.
84  // -----------------------------------------------------------------------------------------------------------------------------
85 
87  IQR_EINVALGOSTATE = -2001,
88 
90  IQR_EINVHASHALGO = -2002,
91 
92  // -----------------------------------------------------------------------------------------------------------------------------
93  // Key error values.
94  // -----------------------------------------------------------------------------------------------------------------------------
95 
97  IQR_EINVPUBLICKEY = -3001,
98 
100  IQR_EINVPRIVATEKEY = -3002,
103  IQR_EINVSYMKEY = -3003,
106  IQR_EKEYPAIRMISMATCH = -3004,
109  IQR_EINVSIGNATURE = -3006,
112  IQR_ESTATEDEPLETED = -3007,
115  IQR_ESTATECORRUPTED = -3008,
117  // -----------------------------------------------------------------------------------------------------------------------------
118  // Random Number Generator error values.
119  // -----------------------------------------------------------------------------------------------------------------------------
120 
122  IQR_ENOTSEEDED = -4001,
125  IQR_ERESEED = -4002,
127  // -----------------------------------------------------------------------------------------------------------------------------
128  // Crypto error values.
129  // -----------------------------------------------------------------------------------------------------------------------------
130 
132  IQR_EDECRYPTIONFAILED = -5001,
135  IQR_EINVPLAINTEXTSIZE = -5002,
138  IQR_EINVCIPHERTEXTSIZE = -5003,
140  // -----------------------------------------------------------------------------------------------------------------------------
141  // Bignum error values.
142  // -----------------------------------------------------------------------------------------------------------------------------
143 
145  IQR_EINTOVERFLOW = -6001,
148  IQR_EDIVBYZERO = -6002,
151  IQR_EBADRESULT = -6003,
153  // -----------------------------------------------------------------------------------------------------------------------------
154  // FIPS 140-2 error values.
155  //
156  // These will only be returned when using the FIPS 140-2 certified version
157  // of the toolkit.
158  // -----------------------------------------------------------------------------------------------------------------------------
159 
161  IQR_EFIPS140_FAILED = -7001,
164  IQR_EFIPS140_NOTAVAIL = -7002,
181 } iqr_retval;
182 
183 // ---------------------------------------------------------------------------------------------------------------------------------
184 // Helper functions.
185 // ---------------------------------------------------------------------------------------------------------------------------------
186 
196 IQR_API
197 const char *iqr_StrError(iqr_retval ret);
198 
199 #ifdef __cplusplus
200 }
201 #endif
202 
203 #endif /* IQR_RETVAL_H */
The provided plaintext size is invalid.
Definition: iqr_retval.h:136
The parameter value is not valid.
Definition: iqr_retval.h:50
The provided buffer has an invalid size.
Definition: iqr_retval.h:47
The provided data is invalid.
Definition: iqr_retval.h:68
IQR_API const char * iqr_StrError(iqr_retval ret)
Definition: iqr_retval.h:72
This version of the library doesn't support FIPS 140-2 mode.
Definition: iqr_retval.h:165
Library version does not match header version.
Definition: iqr_retval.h:78
The decryption algorithm failed to decrypt the ciphertext.
Definition: iqr_retval.h:133
The signature of the message is invalid.
Definition: iqr_retval.h:110
Self-integrity test failure. Unable to validate tag.
Definition: iqr_retval.h:180
The private key is invalid.
Definition: iqr_retval.h:101
The specified structure is not initialized.
Definition: iqr_retval.h:44
The library's FIPS 140-2 self-tests failed.
Definition: iqr_retval.h:162
The parameter value is out of range.
Definition: iqr_retval.h:53
A NULL pointer was passed in where a valid pointer was expected.
Definition: iqr_retval.h:38
The arithmetic operation resulted in integer overflow.
Definition: iqr_retval.h:146
The object is invalid.
Definition: iqr_retval.h:59
The provided hashing algorithm is not valid for this key type.
Definition: iqr_retval.h:91
Input and output pointers must not be overlapping buffers.
Definition: iqr_retval.h:75
The provided callback pointers are invalid.
Definition: iqr_retval.h:62
An error occurred while updating the state. It is corrupted and cannot be used.
Definition: iqr_retval.h:116
The symmetric key is invalid.
Definition: iqr_retval.h:104
The provided ciphertext size is invalid.
Definition: iqr_retval.h:139
The Random Number Generator must be reseeded.
Definition: iqr_retval.h:126
The parameter value is valid but not supported.
Definition: iqr_retval.h:56
ISARA Radiate Security Solution Suite's API declarations.
Self-integrity test failure. Unable to load toolkit tag.
Definition: iqr_retval.h:174
The public key is not derived from the private key.
Definition: iqr_retval.h:107
Self-integrity test failure. Unable to load toolkit key.
Definition: iqr_retval.h:171
The algorithm state is invalid.
Definition: iqr_retval.h:88
The Random Number Generator failed to wipe internal state.
Definition: iqr_retval.h:168
The state cannot be used to create more signatures.
Definition: iqr_retval.h:113
The public key is invalid.
Definition: iqr_retval.h:98
The arithmetic operation resulted in division by zero.
Definition: iqr_retval.h:149
Success, function completed successfully.
Definition: iqr_retval.h:31
The Random Number Generator has not been seeded.
Definition: iqr_retval.h:123
Memory allocation failed.
Definition: iqr_retval.h:41
The chosen tree strategy cannot be used for this function.
Definition: iqr_retval.h:81
The arithmetic operation produced wrong result.
Definition: iqr_retval.h:152
iqr_retval
Definition: iqr_retval.h:29
Callbacks to an algorithm were not registered prior to use.
Definition: iqr_retval.h:65
Self-integrity test failure. Unable to load toolkit binary.
Definition: iqr_retval.h:177