Definitions in sbengine.h

Preprocessor macro definitions for the sbengine.h header file in the libloadsbengine (For the qcc command, use the -l loadsbengine option to link against this library) library.

Definitions:

#define SBENGINE_VER_MAJOR 1
Major version number.

Since: BlackBerry 10.0.0

#define SBENGINE_VER_MINOR 0
Minor version number.

Since: BlackBerry 10.0.0

#define SBENGINE_ID "sbengine"
ID of the engine.

This must be identical to the shared library filename (without .dll or .so)

Since: BlackBerry 10.0.0

#define ENGINE_CTRL_SBENGINE_SET_LOGLEVEL ENGINE_CMD_BASE
A custom ENGINE CTRL command to set log level.

To enable logging, an application must first call ENGINE_ctrl() with the cmd parameter equal to ENGINE_CTRL_SET_LOGSTREAM to set a BIO object for log output.

Once logging is enabled, the SB OpenSSL Engine will log various kinds of information.

The log level controls what information is output to the logging BIO.

  1. SBENGINE_LOG_LEVEL_NONE - absolutely no information is output.
  2. SBENGINE_LOG_LEVEL_ERROR - only SB OpenSSL Engine errors are output.
  3. SBENGINE_LOG_LEVEL_WARNING - SB OpenSSL Engine errors and warnings are output.
  4. SBENGINE_LOG_LEVEL_DEBUG - SB OpenSSL Engine errors and warnings are output, but also DEBUGGING information which may include:
    • text messages indicating entry and exit to SB OpenSSL Engine functions, useful for following the execution path of an SB OpenSSL Engine operation.
    • text messages indicating return codes from all SBAPI crypto functions, useful for understanding SBAPI success/failures.
    • text dumps of key data, ciphertext, etc.
    This debugging information may contain sensitive information and may be disabled during compilation of the SB OpenSSL Engine.

Since: BlackBerry 10.0.0

#define SBENGINE_LOG_LEVEL_NONE 0x00
Log level = nothing.

Since: BlackBerry 10.0.0

#define SBENGINE_LOG_LEVEL_ERROR 0x01
Log level = errors.

Since: BlackBerry 10.0.0

#define SBENGINE_LOG_LEVEL_WARNING 0x02
Log level = warnings.

Since: BlackBerry 10.0.0

#define SBENGINE_LOG_LEVEL_DEBUG 0x03
Log level = debug.

Since: BlackBerry 10.0.0

Library:

libloadsbengine (For the qcc command, use the -l loadsbengine option to link against this library)
Parent topic: Constants in sbengine.h