ica_set_offload_mode

Purpose

Lets you control whether to use CPACF or cryptographic coprocessors to perform cryptographic operations, if the required functionality is available on both. In such cases, libica processes cryptographic operations on CPACF by default. Enabling the offloading to cryptographic coprocessors might be reasonable in an environment where sufficient such coprocessors are available, and the CPU is to be used for other workloads.

You can also enable the offloading to cryptographic coprocessors using the environment variable LIBICA_OFFLOAD_MODE. If this environment variable is set to an integer not equal to zero, libica always uses cryptographic adapters, if applicable.

Format

void ica_set_offload_mode(int offload_mode);

Parameters

int offload_mode

0

Disable offloading cryptographic operations to cryptographic coprocessors. This is the default.

any integer ≠ 0

Enable offloading cryptographic operations to cryptographic coprocessors.

Return codes

None.