libnvmf_get_owner_from_tid-libnvme32
Get the registry owner of a transport id
Usage
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 |
Overview
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.