.TH "libnvmf_get_owner_from_tid" 9 "libnvmf_get_owner_from_tid" "September 2026" "libnvme API manual" LINUX
.SH NAME
libnvmf_get_owner_from_tid \- Get the registry owner of a transport ID
.SH SYNOPSIS
.B "int" libnvmf_get_owner_from_tid
.BI "(struct libnvme_global_ctx *ctx "  ","
.BI "const struct libnvmf_tid *tid "  ","
.BI "char **owner "  ");"
.SH ARGUMENTS
.IP "ctx" 12
Global context
.IP "tid" 12
Transport ID identifying the connection to check
.IP "owner" 12
Returned owner, NULL if no matching controller exists or it is
unowned
.SH "DESCRIPTION"
Resolves the controller, if any, matching \fItid\fP and reports its registry
owner. Does not connect, disconnect, or otherwise modify controller
state.

When a matching owned controller exists, \fIowner\fP is set to a newly
allocated string that the caller must \fBfree\fP. Otherwise, \fIowner\fP is set
to NULL. A negative errno return indicates the lookup failed; it is
never used to report that no owner exists.

See also: \fBlibnvme_set_owner\fP (lib.h) to declare an orchestrator's own
identity, and \fBlibnvmf_registry_retrieve\fP (registry.h) to read a live
controller's registry entry by device name rather than by TID.
.SH "RETURN"
0 on success (check \fIowner\fP), negative errno on failure.