.TH "libnvme_set_owner" 9 "libnvme_set_owner" "September 2026" "libnvme API manual" LINUX
.SH NAME
libnvme_set_owner \- Set the orchestrator identity for the registry
.SH SYNOPSIS
.B "int" libnvme_set_owner
.BI "(struct libnvme_global_ctx *ctx "  ","
.BI "const char *owner "  ");"
.SH ARGUMENTS
.IP "ctx" 12
\fIstruct libnvme_global_ctx\fP object
.IP "owner" 12
Orchestrator identity string (e.g. "stas", "nbft").
.SH "DESCRIPTION"
Records the orchestrator identity used when claiming registry ownership of
connections made through \fIctx\fP.  A later call overwrites the previous value;
treating the identity as immutable is a policy decision left to the caller.
A process that does not participate in the registry simply never calls this.

This is the supported way to record the registry owner;
\fBlibnvme_create_global_ctx\fP deliberately takes no owner parameter.

See also: \fBlibnvmf_get_owner_from_tid\fP and \fBlibnvmf_get_owner_from_fctx\fP
(fabrics.h) to look up who owns a candidate connection before connecting
it, and \fBlibnvmf_registry_retrieve\fP (registry.h) to read a live
controller's registry entry directly.
.SH "RETURN"
0 on success, -EINVAL or -ENOMEM on error.