5.3 Error Codes
libgpg-error defines many error values. Most of
them are not used by
GPGME directly, but might be returned by
GPGME because it received them from the crypto engine. The
below list only includes such error codes that have a specific meaning
GPGME, or which are so common that you should know about
- This value indicates the end of a list, buffer or file.
- This value indicates success. The value of this error code is
0. Also, it is guaranteed that an error value made from the
0 will be
0 itself (as a whole). This means
that the error source information is lost for this error code,
however, as this error code indicates that no error occured, this is
generally not a problem.
- This value means that something went wrong, but either there is not
enough information about the problem to return a more useful error
value, or there is no separate error value for this type of problem.
- This value means that an out-of-memory condition occurred.
- System errors are mapped to GPG_ERR_FOO where FOO is the symbol for
the system error.
- This value means that some user provided data was out of range. This
can also refer to objects. For example, if an empty
gpgme_data_t object was expected, but one containing data was
provided, this error value is returned.
- This value means that some recipients for a message were invalid.
- This value means that some signers were invalid.
- This value means that a
gpgme_data_t object which was expected
to have content was found empty.
- This value means that a conflict of some sort occurred.
- This value indicates that the specific function (or operation) is not
implemented. This error should never happen. It can only occur if
you use certain values or configuration options which do not work,
but for which we think that they should work at some later time.
- This value indicates that a decryption operation was unsuccessful.
- This value means that the user did not provide a correct passphrase
- This value means that the operation was canceled.
- This value means that the engine that implements the desired protocol
is currently not available. This can either be because the sources
were configured to exclude support for this engine, or because the
engine is not installed properly.
- This value indicates that a user ID or other specifier did not specify
a unique key.
- This value indicates that a key is not used appropriately.
- This value indicates that a key signature was revoced.
- This value indicates that a key signature expired.
- This value indicates that no certificate revocation list is known for
- This value indicates that a policy issue occured.
- This value indicates that no secret key for the user ID is available.
- This value indicates that a key could not be imported because the
issuer certificate is missing.
- This value indicates that a key could not be imported because its
certificate chain is not good, for example it could be too long.
- This value means a verification failed because the cryptographic
algorithm is not supported by the crypto backend.
- This value means a verification failed because the signature is bad.
- This value means a verification failed because the public key is not
- These error codes are not used by any GnuPG component and can be
freely used by other software. Applications using GPGME
might use them to mark specific errors returned by callback handlers
if no suitable error codes (including the system errors) for
these errors exist already.