.TH "libnvmf_generate_tls_key_identity" 9 "libnvmf_generate_tls_key_identity" "October 2026" "libnvme API manual" LINUX
.SH NAME
libnvmf_generate_tls_key_identity \- Generate the TLS PSK identity
.SH SYNOPSIS
.B "int" libnvmf_generate_tls_key_identity
.BI "(struct libnvme_global_ctx *ctx "  ","
.BI "const char *hostnqn "  ","
.BI "const char *subsysnqn "  ","
.BI "int version "  ","
.BI "enum libnvmf_hmac_alg hmac "  ","
.BI "unsigned char *configured_key "  ","
.BI "int key_len "  ","
.BI "char **identity "  ");"
.SH ARGUMENTS
.IP "ctx" 12
struct libnvme_global_ctx object
.IP "hostnqn" 12
Host NVMe Qualified Name
.IP "subsysnqn" 12
Subsystem NVMe Qualified Name
.IP "version" 12
TLS PSK identity version to use
.IP "hmac" 12
HMAC algorithm
.IP "configured_key" 12
Configured PSK to derive the retained PSK from
.IP "key_len" 12
Length of \fIconfigured_key\fP
.IP "identity" 12
TLS PSK identity to return
.SH "DESCRIPTION"
Derives a retained PSK as specified in the NVMe TCP Transport
Specification 1.3, section 3.6.1.3, and generates the corresponding
TLS PSK identity.

It is the responsibility of the caller to free the returned string.
.SH "RETURN"
0 on success, negative error code otherwise.