libnvmf_import_tls_key_versioned-libnvme3(2)

NAME

libnvmf_import_tls_key_versioned - Decode a PSK from the PSK interchange format

SYNOPSIS

int libnvmf_import_tls_key_versioned (struct libnvme_global_ctx *ctx , const char *encoded_key , unsigned char *version , enum libnvmf_hmac_alg *hmac , size_t *key_len , unsigned char **key );

ARGUMENTS

ctx

struct libnvme_global_ctx object

encoded_key

PSK in PSK interchange format

version

Version of the PSK interchange format read from encoded_key to return. Always 1; any other value is rejected with -EINVAL.

hmac

Hash function recorded in encoded_key to return; it derives a retained PSK from a configured PSK

key_len

Length of the decoded PSK to return

key

Decoded PSK to return

DESCRIPTION

Decodes encoded_key from the PSK Interchange format as defined in section 3.6.1.5 of the NVMe TCP Transport Specification 1.3.

It is the responsibility of the caller to free the returned buffer.

RETURN

0 on success, negative error code otherwise.