Engine コントロールコマンド

wolfEngine は、アプリケーションが wolfEngine の動作を変更したり、内部設定を調整したりできるように、いくつかのエンジン制御コマンドを公開しています。現在、次の制御コマンドがサポートされています:

コントロールコマンド	意味	設定値
enable_debug	wolfEngineのデバッグ出力を有効にします	1 = 有効, 0 = 無効。詳細は Chapter 6を参照
log_level	ロギングレベルを設定します	“include/wolfengine/we_logging.h”ファイルに定義されたwolfEngine_LogTypeのビットマスク値. 詳細は Chapter 6を参照
log_components	ログ出力するコンポーネントを指定します	“include/wolfengine/we_logging.h”ファイルに定義されたwolfEngine_LogComponentsのビットマスク値. 詳細は Chapter 6を参照
set_logging_cb	ロギングコールバックをセットします	ログメッセージの出力に使用される関数への関数ポインタ。関数は、we_logging.h の wolfEngine_Logging_cb プロトタイプと一致する必要があります。詳細は Chapter 6を参照

エンジン制御コマンドは、OpenSSL の ENGINE_ctrl_cmd() API を使用して設定できます。たとえば、デバッグロギングを有効にするには、次のように呼び出します:

int ret = 0;
ret = ENGINE_ctrl_cmd(e, “enable_debug”, 1, NULL, NULL, 0);
if (ret != 1) {
    printf(“Failed to enable debug logging\n”);
}

一部の制御コマンドは、OpenSSL 構成ファイルを介して設定することもできます。 OpenSSL エンジン制御コマンドの使用法に関するその他のドキュメントは、OpenSSL の man ページにあります：