ica_open_adapter

Purpose

Opens an adapter.

Format

unsigned int ica_open_adapter(ica_adapter_handle_t *adapter_handle);

Parameters

ica_adapter_handle_t *adapter_handle
Pointer to the file descriptor for the adapter or to DRIVER_NOT_LOADED if opening the crypto adapter failed.

Opening an adapter succeeds if a cryptographic device is accessible for reading and writing. By default, cryptographic access must be available with the /dev/z90crypt path name for the adapter open request to succeed. If the environment variable LIBICA_CRYPT_DEVICE is set to a valid path name of an accessible cryptographic device, accessing the device with that path name takes precedence over the default path names.

Return codes

0
Success

For return codes indicating exceptions, see Return codes.