1libnvme(9)                        API Manual                        libnvme(9)
2
3
4

NAME

6       struct nvmf_disc_log_entry - Discovery Log Page entry
7

SYNOPSIS

9       struct nvmf_disc_log_entry {
10           __u8 trtype;
11           __u8 adrfam;
12           __u8 subtype;
13           __u8 treq;
14           __le16 portid;
15           __le16 cntlid;
16           __le16 asqsz;
17           __le16 eflags;
18           __u8 rsvd12[20];
19           char trsvcid[NVMF_TRSVCID_SIZE];
20           __u8 rsvd64[192];
21           char subnqn[NVME_NQN_LENGTH];
22           char traddr[NVMF_TRADDR_SIZE];
23           union nvmf_tsas tsas;
24        };
25
26

Members

28       trtype      Transport Type (TRTYPE): Specifies the NVMe Transport type.
29                   See enum nvmf_trtype.
30
31       adrfam      Address Family (ADRFAM): Specifies the address family.  See
32                   enum nvmf_addr_family.
33
34       subtype     Subsystem  Type  (SUBTYPE):  Specifies  the type of the NVM
35                   subsystem  that  is  indicated  in  this  entry.  See  enum
36                   nvme_subsys_type.
37
38       treq        Transport  Requirements  (TREQ): Indicates requirements for
39                   the NVMe Transport. See enum nvmf_treq.
40
41       portid      Port ID (PORTID):  Specifies  a  particular  NVM  subsystem
42                   port.   Different  NVMe  Transports or address families may
43                   utilize the same Port ID value (e.g. a Port ID may  support
44                   both iWARP and RoCE).
45
46       cntlid      Controller ID (CNTLID): Specifies the controller ID. If the
47                   NVM subsystem uses a dynamic controller  model,  then  this
48                   field  shall  be  set to FFFFh. If the NVM subsystem uses a
49                   static controller model, then this field may be  set  to  a
50                   specific  controller  ID (values 0h to FFEFh are valid). If
51                   the NVM subsystem uses a static controller  model  and  the
52                   value indicated is FFFEh, then the host should remember the
53                   Controller ID returned as part of the Fabrics Connect  com‐
54                   mand  in order to re-establish an association in the future
55                   with the same controller.
56
57       asqsz       Admin Max SQ Size (ASQSZ): Specifies the maximum size of an
58                   Admin  Submission Queue. This applies to all controllers in
59                   the NVM subsystem. The value shall be a minimum of  32  en‐
60                   tries.
61
62       eflags      Entry  Flags (EFLAGS): Indicates additional information re‐
63                   lated to the current entry. See enum nvmf_disc_eflags.
64
65       rsvd12      Reserved
66
67       trsvcid     Transport Service Identifier (TRSVCID): Specifies the  NVMe
68                   Transport  service  identifier as an ASCII string. The NVMe
69                   Transport service identifier is specified by the associated
70                   NVMe Transport binding specification.
71
72       rsvd64      Reserved
73
74       subnqn      NVM  Subsystem Qualified Name (SUBNQN): NVMe Qualified Name
75                   (NQN) that uniquely identifies the  NVM  subsystem.  For  a
76                   subsystem,  if  that  Discovery  subsystem has a unique NQN
77                   (i.e., the NVM Subsystem NVMe Qualified Name (SUBNQN) field
78                   in  that  Discovery  subsystem's  Identify  Controller data
79                   structure contains a unique NQN value), then the value  re‐
80                   turned shall be that unique NQN. If the Discovery subsystem
81                   does not have a unique NQN, then the value  returned  shall
82                   be     the     well-known     Discovery     Service     NQN
83                   (nqn.2014-08.org.nvmexpress.discovery).
84
85       traddr      Transport Address (TRADDR): Specifies the  address  of  the
86                   NVM  subsystem that may be used for a Connect command as an
87                   ASCII string. The Address Family field describes the refer‐
88                   ence for parsing this field.
89
90       tsas        Transport specific attribute settings
91
92
93
94April 2022                struct nvmf_disc_log_entry                libnvme(9)
Impressum