7.4.15 Additional Logs

Additional logs can be associated with a context. These logs are engine specific and can be be obtained with gpgme_op_getauditlog.

Function: gpgme_error_t gpgme_op_getauditlog (gpgme_ctx_t ctx, gpgme_data_t output, unsigned int flags)

SINCE: 1.1.1

The function gpgme_op_getauditlog is used to obtain additional logs as specified by flags into the output data. If

The function returns the error code GPG_ERR_NO_ERROR if a log could be queried from the engine, and GPG_ERR_NOT_IMPLEMENTED if the log specified in flags is not available for this engine. If no log is available GPG_ERR_NO_DATA is returned.

The value in flags is a bitwise-or combination of one or multiple of the following bit values:

GPGME_AUDITLOG_DIAG

SINCE: 1.11.2

Obtain diagnostic output which would be written to stderr in interactive use of the engine. This can be used to provide additional diagnostic information in case of errors in other operations.

Note: If log-file has been set in the configuration the log will be empty and GPG_ERR_NO_DATA will be returned.

Implemented for: GPGME_PROTOCOL_OpenPGP

GPGME_AUDITLOG_DEFAULT

SINCE: 1.11.2

This flag has the value 0 for compatibility reasons. Obtains additional information from the engine by issuing the GETAUDITLOG command. For GPGME_PROTOCOL_CMS this provides additional information about the X509 certificate chain.

Implemented for: GPGME_PROTOCOL_CMS

GPGME_AUDITLOG_HTML

SINCE: 1.1.1

Same as GPGME_AUDITLOG_DEFAULT but in HTML.

Implemented for: GPGME_PROTOCOL_CMS

Function: gpgme_error_t gpgme_op_getauditlog_start (gpgme_ctx_t ctx, gpgme_data_t output, unsigned int flags)

SINCE: 1.1.1

This is the asynchronous variant of gpgme_op_getauditlog.