.TH "libnvmf_scan_tls_keys" 9 "libnvmf_scan_tls_keys" "October 2026" "libnvme API manual" LINUX
.SH NAME
libnvmf_scan_tls_keys \- Iterate over TLS PSKs in a keyring
.SH SYNOPSIS
.B "int" libnvmf_scan_tls_keys
.BI "(struct libnvme_global_ctx *ctx "  ","
.BI "const char *keyring "  ","
.BI "libnvmf_scan_tls_keys_cb_t cb "  ","
.BI "void *data "  ");"
.SH ARGUMENTS
.IP "ctx" 12
struct libnvme_global_ctx object
.IP "keyring" 12
Keyring holding TLS PSKs
.IP "cb" 12
Callback function
.IP "data" 12
Pointer for data to be passed to \fIcb\fP
.SH "DESCRIPTION"
Iterates \fIkeyring\fP and call \fIcb\fP for each TLS PSK. When \fIkeyring\fP is NULL
the default '.nvme' keyring is used.
A key holding a TLS PSK must be of type 'psk' and its description must
be of the form 'NVMe<0|1><R|G><01|02> <identity>', otherwise it will be
skipped during iteration.
.SH "RETURN"
Number of keys for which \fIcb\fP was called, or negative error code