Debian Codegraph @

doc/man/nvme_ctrl_find.2

raw
1 .TH "nvme_ctrl_find" 9 "nvme_ctrl_find" "November 2025" "libnvme API manual" LINUX
2 .SH NAME
3 nvme_ctrl_find \- Locate an existing controller
4 .SH SYNOPSIS
5 .B "nvme_ctrl_t" nvme_ctrl_find
6 .BI "(nvme_subsystem_t s " ","
7 .BI "const char *transport " ","
8 .BI "const char *traddr " ","
9 .BI "const char *trsvcid " ","
10 .BI "const char *subsysnqn " ","
11 .BI "const char *host_traddr " ","
12 .BI "const char *host_iface " ");"
13 .SH ARGUMENTS
14 .IP "s" 12
15 \fInvme_subsystem_t\fP object
16 .IP "transport" 12
17 Transport name
18 .IP "traddr" 12
19 Transport address
20 .IP "trsvcid" 12
21 Transport service identifier
22 .IP "subsysnqn" 12
23 Subsystem NQN
24 .IP "host_traddr" 12
25 Host transport address
26 .IP "host_iface" 12
27 Host interface name
28 .SH "DESCRIPTION"
29 Lookup a controller in \fIs\fP based on \fItransport\fP, \fItraddr\fP, \fItrsvcid\fP,
30 \fIsubsysnqn\fP, \fIhost_traddr\fP, and \fIhost_iface\fP. \fItransport\fP must be specified,
31 other fields may be required depending on the transport. Parameters set
32 to NULL will be ignored.
33
34 Unlike \fBnvme_lookup_ctrl\fP, this function does not create a new object if
35 an existing controller cannot be found.
36 .SH "RETURN"
37 Controller instance on success, NULL otherwise.