libnvmf_get_owner_from_tid(9)

NAME
libnvmf_get_owner_from_tid - Get the registry owner of a transport ID

SYNOPSIS
int libnvmf_get_owner_from_tid (struct libnvme_global_ctx *ctx , const struct libnvmf_tid *tid , char **owner );

ARGUMENTS

ctx Global context

tid Transport ID identifying the connection to check

owner
    Returned owner, NULL if no matching controller exists or it is unowned

DESCRIPTION
Resolves the controller, if any, matching tid and reports its registry owner. Does not connect, disconnect, or otherwise modify controller state. When a matching owned controller exists, owner is set to a newly allocated string that the caller must free. Otherwise, owner is set to NULL. A negative errno return indicates the lookup failed; it is never used to report that no owner exists. See also: libnvme_set_owner (lib.h) to declare an orchestrator's own identity, and libnvmf_registry_retrieve (registry.h) to read a live controller's registry entry by device name rather than by TID.

RETURN
0 on success (check owner), negative errno on failure.