xref: /spdk/lib/nvmf/ctrlr.c (revision 0098e636761237b77c12c30c2408263a5d2260cc)
1 /*   SPDX-License-Identifier: BSD-3-Clause
2  *   Copyright (c) Intel Corporation. All rights reserved.
3  *   Copyright (c) 2019, 2020 Mellanox Technologies LTD. All rights reserved.
4  *   Copyright (c) 2021 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
5  */
6 
7 #include "spdk/stdinc.h"
8 
9 #include "nvmf_internal.h"
10 #include "transport.h"
11 
12 #include "spdk/bit_array.h"
13 #include "spdk/endian.h"
14 #include "spdk/thread.h"
15 #include "spdk/nvme_spec.h"
16 #include "spdk/nvmf_cmd.h"
17 #include "spdk/string.h"
18 #include "spdk/util.h"
19 #include "spdk/version.h"
20 #include "spdk/log.h"
21 #include "spdk_internal/usdt.h"
22 
23 #define MIN_KEEP_ALIVE_TIMEOUT_IN_MS 10000
24 #define NVMF_DISC_KATO_IN_MS 120000
25 #define KAS_TIME_UNIT_IN_MS 100
26 #define KAS_DEFAULT_VALUE (MIN_KEEP_ALIVE_TIMEOUT_IN_MS / KAS_TIME_UNIT_IN_MS)
27 
28 #define NVMF_CC_RESET_SHN_TIMEOUT_IN_MS	10000
29 
30 #define NVMF_CTRLR_RESET_SHN_TIMEOUT_IN_MS	(NVMF_CC_RESET_SHN_TIMEOUT_IN_MS + 5000)
31 
32 /*
33  * Report the SPDK version as the firmware revision.
34  * SPDK_VERSION_STRING won't fit into FR (only 8 bytes), so try to fit the most important parts.
35  */
36 #define FW_VERSION SPDK_VERSION_MAJOR_STRING SPDK_VERSION_MINOR_STRING SPDK_VERSION_PATCH_STRING
37 
38 #define ANA_TRANSITION_TIME_IN_SEC 10
39 
40 #define NVMF_ABORT_COMMAND_LIMIT 3
41 
42 /*
43  * Support for custom admin command handlers
44  */
45 struct spdk_nvmf_custom_admin_cmd {
46 	spdk_nvmf_custom_cmd_hdlr hdlr;
47 	uint32_t nsid; /* nsid to forward */
48 };
49 
50 static struct spdk_nvmf_custom_admin_cmd g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_MAX_OPC + 1];
51 
52 static void _nvmf_request_complete(void *ctx);
53 
54 static inline void
55 nvmf_invalid_connect_response(struct spdk_nvmf_fabric_connect_rsp *rsp,
56 			      uint8_t iattr, uint16_t ipo)
57 {
58 	rsp->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
59 	rsp->status.sc = SPDK_NVMF_FABRIC_SC_INVALID_PARAM;
60 	rsp->status_code_specific.invalid.iattr = iattr;
61 	rsp->status_code_specific.invalid.ipo = ipo;
62 }
63 
64 #define SPDK_NVMF_INVALID_CONNECT_CMD(rsp, field)	\
65 	nvmf_invalid_connect_response(rsp, 0, offsetof(struct spdk_nvmf_fabric_connect_cmd, field))
66 #define SPDK_NVMF_INVALID_CONNECT_DATA(rsp, field)	\
67 	nvmf_invalid_connect_response(rsp, 1, offsetof(struct spdk_nvmf_fabric_connect_data, field))
68 
69 
70 static void
71 nvmf_ctrlr_stop_keep_alive_timer(struct spdk_nvmf_ctrlr *ctrlr)
72 {
73 	if (!ctrlr) {
74 		SPDK_ERRLOG("Controller is NULL\n");
75 		return;
76 	}
77 
78 	if (ctrlr->keep_alive_poller == NULL) {
79 		return;
80 	}
81 
82 	SPDK_DEBUGLOG(nvmf, "Stop keep alive poller\n");
83 	spdk_poller_unregister(&ctrlr->keep_alive_poller);
84 }
85 
86 static void
87 nvmf_ctrlr_stop_association_timer(struct spdk_nvmf_ctrlr *ctrlr)
88 {
89 	if (!ctrlr) {
90 		SPDK_ERRLOG("Controller is NULL\n");
91 		assert(false);
92 		return;
93 	}
94 
95 	if (ctrlr->association_timer == NULL) {
96 		return;
97 	}
98 
99 	SPDK_DEBUGLOG(nvmf, "Stop association timer\n");
100 	spdk_poller_unregister(&ctrlr->association_timer);
101 }
102 
103 static void
104 nvmf_ctrlr_disconnect_qpairs_done(struct spdk_io_channel_iter *i, int status)
105 {
106 	if (status == 0) {
107 		SPDK_DEBUGLOG(nvmf, "ctrlr disconnect qpairs complete successfully\n");
108 	} else {
109 		SPDK_ERRLOG("Fail to disconnect ctrlr qpairs\n");
110 	}
111 }
112 
113 static int
114 _nvmf_ctrlr_disconnect_qpairs_on_pg(struct spdk_io_channel_iter *i, bool include_admin)
115 {
116 	int rc = 0;
117 	struct spdk_nvmf_ctrlr *ctrlr;
118 	struct spdk_nvmf_qpair *qpair, *temp_qpair;
119 	struct spdk_io_channel *ch;
120 	struct spdk_nvmf_poll_group *group;
121 
122 	ctrlr = spdk_io_channel_iter_get_ctx(i);
123 	ch = spdk_io_channel_iter_get_channel(i);
124 	group = spdk_io_channel_get_ctx(ch);
125 
126 	TAILQ_FOREACH_SAFE(qpair, &group->qpairs, link, temp_qpair) {
127 		if (qpair->ctrlr == ctrlr && (include_admin || !nvmf_qpair_is_admin_queue(qpair))) {
128 			rc = spdk_nvmf_qpair_disconnect(qpair, NULL, NULL);
129 			if (rc) {
130 				SPDK_ERRLOG("Qpair disconnect failed\n");
131 				return rc;
132 			}
133 		}
134 	}
135 
136 	return rc;
137 }
138 
139 static void
140 nvmf_ctrlr_disconnect_qpairs_on_pg(struct spdk_io_channel_iter *i)
141 {
142 	spdk_for_each_channel_continue(i, _nvmf_ctrlr_disconnect_qpairs_on_pg(i, true));
143 }
144 
145 static void
146 nvmf_ctrlr_disconnect_io_qpairs_on_pg(struct spdk_io_channel_iter *i)
147 {
148 	spdk_for_each_channel_continue(i, _nvmf_ctrlr_disconnect_qpairs_on_pg(i, false));
149 }
150 
151 static int
152 nvmf_ctrlr_keep_alive_poll(void *ctx)
153 {
154 	uint64_t keep_alive_timeout_tick;
155 	uint64_t now = spdk_get_ticks();
156 	struct spdk_nvmf_ctrlr *ctrlr = ctx;
157 
158 	if (ctrlr->in_destruct) {
159 		nvmf_ctrlr_stop_keep_alive_timer(ctrlr);
160 		return SPDK_POLLER_IDLE;
161 	}
162 
163 	SPDK_DEBUGLOG(nvmf, "Polling ctrlr keep alive timeout\n");
164 
165 	/* If the Keep alive feature is in use and the timer expires */
166 	keep_alive_timeout_tick = ctrlr->last_keep_alive_tick +
167 				  ctrlr->feat.keep_alive_timer.bits.kato * spdk_get_ticks_hz() / UINT64_C(1000);
168 	if (now > keep_alive_timeout_tick) {
169 		SPDK_NOTICELOG("Disconnecting host %s from subsystem %s due to keep alive timeout.\n",
170 			       ctrlr->hostnqn, ctrlr->subsys->subnqn);
171 		/* set the Controller Fatal Status bit to '1' */
172 		if (ctrlr->vcprop.csts.bits.cfs == 0) {
173 			nvmf_ctrlr_set_fatal_status(ctrlr);
174 
175 			/*
176 			 * disconnect qpairs, terminate Transport connection
177 			 * destroy ctrlr, break the host to controller association
178 			 * disconnect qpairs with qpair->ctrlr == ctrlr
179 			 */
180 			spdk_for_each_channel(ctrlr->subsys->tgt,
181 					      nvmf_ctrlr_disconnect_qpairs_on_pg,
182 					      ctrlr,
183 					      nvmf_ctrlr_disconnect_qpairs_done);
184 			return SPDK_POLLER_BUSY;
185 		}
186 	}
187 
188 	return SPDK_POLLER_IDLE;
189 }
190 
191 static void
192 nvmf_ctrlr_start_keep_alive_timer(struct spdk_nvmf_ctrlr *ctrlr)
193 {
194 	if (!ctrlr) {
195 		SPDK_ERRLOG("Controller is NULL\n");
196 		return;
197 	}
198 
199 	/* if cleared to 0 then the Keep Alive Timer is disabled */
200 	if (ctrlr->feat.keep_alive_timer.bits.kato != 0) {
201 
202 		ctrlr->last_keep_alive_tick = spdk_get_ticks();
203 
204 		SPDK_DEBUGLOG(nvmf, "Ctrlr add keep alive poller\n");
205 		ctrlr->keep_alive_poller = SPDK_POLLER_REGISTER(nvmf_ctrlr_keep_alive_poll, ctrlr,
206 					   ctrlr->feat.keep_alive_timer.bits.kato * 1000);
207 	}
208 }
209 
210 static void
211 ctrlr_add_qpair_and_update_rsp(struct spdk_nvmf_qpair *qpair,
212 			       struct spdk_nvmf_ctrlr *ctrlr,
213 			       struct spdk_nvmf_fabric_connect_rsp *rsp)
214 {
215 	assert(ctrlr->admin_qpair->group->thread == spdk_get_thread());
216 
217 	/* check if we would exceed ctrlr connection limit */
218 	if (qpair->qid >= spdk_bit_array_capacity(ctrlr->qpair_mask)) {
219 		SPDK_ERRLOG("Requested QID %u but Max QID is %u\n",
220 			    qpair->qid, spdk_bit_array_capacity(ctrlr->qpair_mask) - 1);
221 		rsp->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
222 		rsp->status.sc = SPDK_NVME_SC_INVALID_QUEUE_IDENTIFIER;
223 		return;
224 	}
225 
226 	if (spdk_bit_array_get(ctrlr->qpair_mask, qpair->qid)) {
227 		SPDK_ERRLOG("Got I/O connect with duplicate QID %u\n", qpair->qid);
228 		rsp->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
229 		rsp->status.sc = SPDK_NVME_SC_INVALID_QUEUE_IDENTIFIER;
230 		return;
231 	}
232 
233 	qpair->ctrlr = ctrlr;
234 	spdk_bit_array_set(ctrlr->qpair_mask, qpair->qid);
235 
236 	rsp->status.sc = SPDK_NVME_SC_SUCCESS;
237 	rsp->status_code_specific.success.cntlid = ctrlr->cntlid;
238 	SPDK_DEBUGLOG(nvmf, "connect capsule response: cntlid = 0x%04x\n",
239 		      rsp->status_code_specific.success.cntlid);
240 
241 	SPDK_DTRACE_PROBE4(nvmf_ctrlr_add_qpair, qpair, qpair->qid, ctrlr->subsys->subnqn,
242 			   ctrlr->hostnqn);
243 }
244 
245 static void
246 _nvmf_ctrlr_add_admin_qpair(void *ctx)
247 {
248 	struct spdk_nvmf_request *req = ctx;
249 	struct spdk_nvmf_fabric_connect_rsp *rsp = &req->rsp->connect_rsp;
250 	struct spdk_nvmf_qpair *qpair = req->qpair;
251 	struct spdk_nvmf_ctrlr *ctrlr = qpair->ctrlr;
252 
253 	ctrlr->admin_qpair = qpair;
254 	ctrlr->association_timeout = qpair->transport->opts.association_timeout;
255 	nvmf_ctrlr_start_keep_alive_timer(ctrlr);
256 	ctrlr_add_qpair_and_update_rsp(qpair, ctrlr, rsp);
257 	_nvmf_request_complete(req);
258 }
259 
260 static void
261 _nvmf_subsystem_add_ctrlr(void *ctx)
262 {
263 	struct spdk_nvmf_request *req = ctx;
264 	struct spdk_nvmf_qpair *qpair = req->qpair;
265 	struct spdk_nvmf_fabric_connect_rsp *rsp = &req->rsp->connect_rsp;
266 	struct spdk_nvmf_ctrlr *ctrlr = qpair->ctrlr;
267 
268 	if (nvmf_subsystem_add_ctrlr(ctrlr->subsys, ctrlr)) {
269 		SPDK_ERRLOG("Unable to add controller to subsystem\n");
270 		spdk_bit_array_free(&ctrlr->qpair_mask);
271 		free(ctrlr);
272 		qpair->ctrlr = NULL;
273 		rsp->status.sc = SPDK_NVME_SC_INTERNAL_DEVICE_ERROR;
274 		spdk_nvmf_request_complete(req);
275 		return;
276 	}
277 
278 	spdk_thread_send_msg(ctrlr->thread, _nvmf_ctrlr_add_admin_qpair, req);
279 }
280 
281 static void
282 nvmf_ctrlr_cdata_init(struct spdk_nvmf_transport *transport, struct spdk_nvmf_subsystem *subsystem,
283 		      struct spdk_nvmf_ctrlr_data *cdata)
284 {
285 	cdata->aerl = NVMF_MAX_ASYNC_EVENTS - 1;
286 	cdata->kas = KAS_DEFAULT_VALUE;
287 	cdata->vid = SPDK_PCI_VID_INTEL;
288 	cdata->ssvid = SPDK_PCI_VID_INTEL;
289 	/* INTEL OUI */
290 	cdata->ieee[0] = 0xe4;
291 	cdata->ieee[1] = 0xd2;
292 	cdata->ieee[2] = 0x5c;
293 	cdata->oncs.compare = 1;
294 	cdata->oncs.reservations = 1;
295 	cdata->fuses.compare_and_write = 1;
296 	cdata->sgls.supported = 1;
297 	cdata->sgls.keyed_sgl = 1;
298 	cdata->sgls.sgl_offset = 1;
299 	cdata->nvmf_specific.ioccsz = sizeof(struct spdk_nvme_cmd) / 16;
300 	cdata->nvmf_specific.ioccsz += transport->opts.in_capsule_data_size / 16;
301 	cdata->nvmf_specific.iorcsz = sizeof(struct spdk_nvme_cpl) / 16;
302 	cdata->nvmf_specific.icdoff = 0; /* offset starts directly after SQE */
303 	cdata->nvmf_specific.ctrattr.ctrlr_model = SPDK_NVMF_CTRLR_MODEL_DYNAMIC;
304 	cdata->nvmf_specific.msdbd = 1;
305 
306 	if (transport->ops->cdata_init) {
307 		transport->ops->cdata_init(transport, subsystem, cdata);
308 	}
309 }
310 
311 static struct spdk_nvmf_ctrlr *
312 nvmf_ctrlr_create(struct spdk_nvmf_subsystem *subsystem,
313 		  struct spdk_nvmf_request *req,
314 		  struct spdk_nvmf_fabric_connect_cmd *connect_cmd,
315 		  struct spdk_nvmf_fabric_connect_data *connect_data)
316 {
317 	struct spdk_nvmf_ctrlr *ctrlr;
318 	struct spdk_nvmf_transport *transport = req->qpair->transport;
319 	struct spdk_nvme_transport_id listen_trid = {};
320 
321 	ctrlr = calloc(1, sizeof(*ctrlr));
322 	if (ctrlr == NULL) {
323 		SPDK_ERRLOG("Memory allocation failed\n");
324 		return NULL;
325 	}
326 
327 	if (spdk_nvme_trtype_is_fabrics(transport->ops->type)) {
328 		ctrlr->dynamic_ctrlr = true;
329 	} else {
330 		ctrlr->cntlid = connect_data->cntlid;
331 	}
332 
333 	SPDK_DTRACE_PROBE3(nvmf_ctrlr_create, ctrlr, subsystem->subnqn,
334 			   spdk_thread_get_id(req->qpair->group->thread));
335 
336 	STAILQ_INIT(&ctrlr->async_events);
337 	TAILQ_INIT(&ctrlr->log_head);
338 	ctrlr->subsys = subsystem;
339 	ctrlr->thread = req->qpair->group->thread;
340 	ctrlr->disconnect_in_progress = false;
341 
342 	ctrlr->qpair_mask = spdk_bit_array_create(transport->opts.max_qpairs_per_ctrlr);
343 	if (!ctrlr->qpair_mask) {
344 		SPDK_ERRLOG("Failed to allocate controller qpair mask\n");
345 		goto err_qpair_mask;
346 	}
347 
348 	nvmf_ctrlr_cdata_init(transport, subsystem, &ctrlr->cdata);
349 
350 	/*
351 	 * KAS: This field indicates the granularity of the Keep Alive Timer in 100ms units.
352 	 * If this field is cleared to 0h, then Keep Alive is not supported.
353 	 */
354 	if (ctrlr->cdata.kas) {
355 		ctrlr->feat.keep_alive_timer.bits.kato = spdk_divide_round_up(connect_cmd->kato,
356 				KAS_DEFAULT_VALUE * KAS_TIME_UNIT_IN_MS) *
357 				KAS_DEFAULT_VALUE * KAS_TIME_UNIT_IN_MS;
358 	}
359 
360 	ctrlr->feat.async_event_configuration.bits.ns_attr_notice = 1;
361 	if (ctrlr->subsys->flags.ana_reporting) {
362 		ctrlr->feat.async_event_configuration.bits.ana_change_notice = 1;
363 	}
364 	ctrlr->feat.volatile_write_cache.bits.wce = 1;
365 	/* Coalescing Disable */
366 	ctrlr->feat.interrupt_vector_configuration.bits.cd = 1;
367 
368 	if (ctrlr->subsys->subtype == SPDK_NVMF_SUBTYPE_DISCOVERY) {
369 		/*
370 		 * If keep-alive timeout is not set, discovery controllers use some
371 		 * arbitrary high value in order to cleanup stale discovery sessions
372 		 *
373 		 * From the 1.0a nvme-of spec:
374 		 * "The Keep Alive command is reserved for
375 		 * Discovery controllers. A transport may specify a
376 		 * fixed Discovery controller activity timeout value
377 		 * (e.g., 2 minutes). If no commands are received
378 		 * by a Discovery controller within that time
379 		 * period, the controller may perform the
380 		 * actions for Keep Alive Timer expiration".
381 		 *
382 		 * From the 1.1 nvme-of spec:
383 		 * "A host requests an explicit persistent connection
384 		 * to a Discovery controller and Asynchronous Event Notifications from
385 		 * the Discovery controller on that persistent connection by specifying
386 		 * a non-zero Keep Alive Timer value in the Connect command."
387 		 *
388 		 * In case non-zero KATO is used, we enable discovery_log_change_notice
389 		 * otherwise we disable it and use default discovery controller KATO.
390 		 * KATO is in millisecond.
391 		 */
392 		if (ctrlr->feat.keep_alive_timer.bits.kato == 0) {
393 			ctrlr->feat.keep_alive_timer.bits.kato = NVMF_DISC_KATO_IN_MS;
394 			ctrlr->feat.async_event_configuration.bits.discovery_log_change_notice = 0;
395 		} else {
396 			ctrlr->feat.async_event_configuration.bits.discovery_log_change_notice = 1;
397 		}
398 	}
399 
400 	/* Subtract 1 for admin queue, 1 for 0's based */
401 	ctrlr->feat.number_of_queues.bits.ncqr = transport->opts.max_qpairs_per_ctrlr - 1 -
402 			1;
403 	ctrlr->feat.number_of_queues.bits.nsqr = transport->opts.max_qpairs_per_ctrlr - 1 -
404 			1;
405 
406 	spdk_uuid_copy(&ctrlr->hostid, (struct spdk_uuid *)connect_data->hostid);
407 	memcpy(ctrlr->hostnqn, connect_data->hostnqn, sizeof(ctrlr->hostnqn));
408 
409 	ctrlr->vcprop.cap.raw = 0;
410 	ctrlr->vcprop.cap.bits.cqr = 1; /* NVMe-oF specification required */
411 	ctrlr->vcprop.cap.bits.mqes = transport->opts.max_queue_depth -
412 				      1; /* max queue depth */
413 	ctrlr->vcprop.cap.bits.ams = 0; /* optional arb mechanisms */
414 	/* ready timeout - 500 msec units */
415 	ctrlr->vcprop.cap.bits.to = NVMF_CTRLR_RESET_SHN_TIMEOUT_IN_MS / 500;
416 	ctrlr->vcprop.cap.bits.dstrd = 0; /* fixed to 0 for NVMe-oF */
417 	ctrlr->vcprop.cap.bits.css = SPDK_NVME_CAP_CSS_NVM; /* NVM command set */
418 	ctrlr->vcprop.cap.bits.mpsmin = 0; /* 2 ^ (12 + mpsmin) == 4k */
419 	ctrlr->vcprop.cap.bits.mpsmax = 0; /* 2 ^ (12 + mpsmax) == 4k */
420 
421 	/* Version Supported: 1.3 */
422 	ctrlr->vcprop.vs.bits.mjr = 1;
423 	ctrlr->vcprop.vs.bits.mnr = 3;
424 	ctrlr->vcprop.vs.bits.ter = 0;
425 
426 	ctrlr->vcprop.cc.raw = 0;
427 	ctrlr->vcprop.cc.bits.en = 0; /* Init controller disabled */
428 
429 	ctrlr->vcprop.csts.raw = 0;
430 	ctrlr->vcprop.csts.bits.rdy = 0; /* Init controller as not ready */
431 
432 	SPDK_DEBUGLOG(nvmf, "cap 0x%" PRIx64 "\n", ctrlr->vcprop.cap.raw);
433 	SPDK_DEBUGLOG(nvmf, "vs 0x%x\n", ctrlr->vcprop.vs.raw);
434 	SPDK_DEBUGLOG(nvmf, "cc 0x%x\n", ctrlr->vcprop.cc.raw);
435 	SPDK_DEBUGLOG(nvmf, "csts 0x%x\n", ctrlr->vcprop.csts.raw);
436 
437 	ctrlr->dif_insert_or_strip = transport->opts.dif_insert_or_strip;
438 
439 	if (ctrlr->subsys->subtype == SPDK_NVMF_SUBTYPE_NVME) {
440 		if (spdk_nvmf_qpair_get_listen_trid(req->qpair, &listen_trid) != 0) {
441 			SPDK_ERRLOG("Could not get listener transport ID\n");
442 			goto err_listener;
443 		}
444 
445 		ctrlr->listener = nvmf_subsystem_find_listener(ctrlr->subsys, &listen_trid);
446 		if (!ctrlr->listener) {
447 			SPDK_ERRLOG("Listener was not found\n");
448 			goto err_listener;
449 		}
450 	}
451 
452 	req->qpair->ctrlr = ctrlr;
453 	spdk_thread_send_msg(subsystem->thread, _nvmf_subsystem_add_ctrlr, req);
454 
455 	return ctrlr;
456 err_listener:
457 	spdk_bit_array_free(&ctrlr->qpair_mask);
458 err_qpair_mask:
459 	free(ctrlr);
460 	return NULL;
461 }
462 
463 static void
464 _nvmf_ctrlr_destruct(void *ctx)
465 {
466 	struct spdk_nvmf_ctrlr *ctrlr = ctx;
467 	struct spdk_nvmf_reservation_log *log, *log_tmp;
468 	struct spdk_nvmf_async_event_completion *event, *event_tmp;
469 
470 	SPDK_DTRACE_PROBE3(nvmf_ctrlr_destruct, ctrlr, ctrlr->subsys->subnqn,
471 			   spdk_thread_get_id(ctrlr->thread));
472 
473 	assert(spdk_get_thread() == ctrlr->thread);
474 	assert(ctrlr->in_destruct);
475 
476 	SPDK_DEBUGLOG(nvmf, "Destroy ctrlr 0x%hx\n", ctrlr->cntlid);
477 	if (ctrlr->disconnect_in_progress) {
478 		SPDK_ERRLOG("freeing ctrlr with disconnect in progress\n");
479 		spdk_thread_send_msg(ctrlr->thread, _nvmf_ctrlr_destruct, ctrlr);
480 		return;
481 	}
482 
483 	nvmf_ctrlr_stop_keep_alive_timer(ctrlr);
484 	nvmf_ctrlr_stop_association_timer(ctrlr);
485 	spdk_bit_array_free(&ctrlr->qpair_mask);
486 
487 	TAILQ_FOREACH_SAFE(log, &ctrlr->log_head, link, log_tmp) {
488 		TAILQ_REMOVE(&ctrlr->log_head, log, link);
489 		free(log);
490 	}
491 	STAILQ_FOREACH_SAFE(event, &ctrlr->async_events, link, event_tmp) {
492 		STAILQ_REMOVE(&ctrlr->async_events, event, spdk_nvmf_async_event_completion, link);
493 		free(event);
494 	}
495 	free(ctrlr);
496 }
497 
498 void
499 nvmf_ctrlr_destruct(struct spdk_nvmf_ctrlr *ctrlr)
500 {
501 	nvmf_subsystem_remove_ctrlr(ctrlr->subsys, ctrlr);
502 
503 	spdk_thread_send_msg(ctrlr->thread, _nvmf_ctrlr_destruct, ctrlr);
504 }
505 
506 static void
507 nvmf_ctrlr_add_io_qpair(void *ctx)
508 {
509 	struct spdk_nvmf_request *req = ctx;
510 	struct spdk_nvmf_fabric_connect_rsp *rsp = &req->rsp->connect_rsp;
511 	struct spdk_nvmf_qpair *qpair = req->qpair;
512 	struct spdk_nvmf_ctrlr *ctrlr = qpair->ctrlr;
513 	struct spdk_nvmf_qpair *admin_qpair = ctrlr->admin_qpair;
514 
515 	SPDK_DTRACE_PROBE4(nvmf_ctrlr_add_io_qpair, ctrlr, req->qpair, req->qpair->qid,
516 			   spdk_thread_get_id(ctrlr->thread));
517 
518 	/* Unit test will check qpair->ctrlr after calling spdk_nvmf_ctrlr_connect.
519 	  * For error case, the value should be NULL. So set it to NULL at first.
520 	  */
521 	qpair->ctrlr = NULL;
522 
523 	/* Make sure the controller is not being destroyed. */
524 	if (ctrlr->in_destruct) {
525 		SPDK_ERRLOG("Got I/O connect while ctrlr was being destroyed.\n");
526 		SPDK_NVMF_INVALID_CONNECT_CMD(rsp, qid);
527 		goto end;
528 	}
529 
530 	if (ctrlr->subsys->subtype == SPDK_NVMF_SUBTYPE_DISCOVERY) {
531 		SPDK_ERRLOG("I/O connect not allowed on discovery controller\n");
532 		SPDK_NVMF_INVALID_CONNECT_CMD(rsp, qid);
533 		goto end;
534 	}
535 
536 	if (!ctrlr->vcprop.cc.bits.en) {
537 		SPDK_ERRLOG("Got I/O connect before ctrlr was enabled\n");
538 		SPDK_NVMF_INVALID_CONNECT_CMD(rsp, qid);
539 		goto end;
540 	}
541 
542 	if (1u << ctrlr->vcprop.cc.bits.iosqes != sizeof(struct spdk_nvme_cmd)) {
543 		SPDK_ERRLOG("Got I/O connect with invalid IOSQES %u\n",
544 			    ctrlr->vcprop.cc.bits.iosqes);
545 		SPDK_NVMF_INVALID_CONNECT_CMD(rsp, qid);
546 		goto end;
547 	}
548 
549 	if (1u << ctrlr->vcprop.cc.bits.iocqes != sizeof(struct spdk_nvme_cpl)) {
550 		SPDK_ERRLOG("Got I/O connect with invalid IOCQES %u\n",
551 			    ctrlr->vcprop.cc.bits.iocqes);
552 		SPDK_NVMF_INVALID_CONNECT_CMD(rsp, qid);
553 		goto end;
554 	}
555 
556 	if (admin_qpair->state != SPDK_NVMF_QPAIR_ACTIVE || admin_qpair->group == NULL) {
557 		/* There is a chance that admin qpair is being destroyed at this moment due to e.g.
558 		 * expired keep alive timer. Part of the qpair destruction process is change of qpair's
559 		 * state to DEACTIVATING and removing it from poll group */
560 		SPDK_ERRLOG("Inactive admin qpair (state %d, group %p)\n", admin_qpair->state, admin_qpair->group);
561 		SPDK_NVMF_INVALID_CONNECT_CMD(rsp, qid);
562 		goto end;
563 	}
564 
565 	ctrlr_add_qpair_and_update_rsp(qpair, ctrlr, rsp);
566 end:
567 	spdk_nvmf_request_complete(req);
568 }
569 
570 static void
571 _nvmf_ctrlr_add_io_qpair(void *ctx)
572 {
573 	struct spdk_nvmf_request *req = ctx;
574 	struct spdk_nvmf_fabric_connect_rsp *rsp = &req->rsp->connect_rsp;
575 	struct spdk_nvmf_fabric_connect_data *data = req->data;
576 	struct spdk_nvmf_ctrlr *ctrlr;
577 	struct spdk_nvmf_qpair *qpair = req->qpair;
578 	struct spdk_nvmf_qpair *admin_qpair;
579 	struct spdk_nvmf_tgt *tgt = qpair->transport->tgt;
580 	struct spdk_nvmf_subsystem *subsystem;
581 	struct spdk_nvme_transport_id listen_trid = {};
582 	const struct spdk_nvmf_subsystem_listener *listener;
583 
584 	SPDK_DEBUGLOG(nvmf, "Connect I/O Queue for controller id 0x%x\n", data->cntlid);
585 
586 	subsystem = spdk_nvmf_tgt_find_subsystem(tgt, data->subnqn);
587 	/* We already checked this in spdk_nvmf_ctrlr_connect */
588 	assert(subsystem != NULL);
589 
590 	ctrlr = nvmf_subsystem_get_ctrlr(subsystem, data->cntlid);
591 	if (ctrlr == NULL) {
592 		SPDK_ERRLOG("Unknown controller ID 0x%x\n", data->cntlid);
593 		SPDK_NVMF_INVALID_CONNECT_DATA(rsp, cntlid);
594 		spdk_nvmf_request_complete(req);
595 		return;
596 	}
597 
598 	/* fail before passing a message to the controller thread. */
599 	if (ctrlr->in_destruct) {
600 		SPDK_ERRLOG("Got I/O connect while ctrlr was being destroyed.\n");
601 		SPDK_NVMF_INVALID_CONNECT_CMD(rsp, qid);
602 		spdk_nvmf_request_complete(req);
603 		return;
604 	}
605 
606 	/* If ANA reporting is enabled, check if I/O connect is on the same listener. */
607 	if (subsystem->flags.ana_reporting) {
608 		if (spdk_nvmf_qpair_get_listen_trid(req->qpair, &listen_trid) != 0) {
609 			SPDK_ERRLOG("Could not get listener transport ID\n");
610 			SPDK_NVMF_INVALID_CONNECT_CMD(rsp, qid);
611 			spdk_nvmf_request_complete(req);
612 			return;
613 		}
614 
615 		listener = nvmf_subsystem_find_listener(subsystem, &listen_trid);
616 		if (listener != ctrlr->listener) {
617 			SPDK_ERRLOG("I/O connect is on a listener different from admin connect\n");
618 			SPDK_NVMF_INVALID_CONNECT_CMD(rsp, qid);
619 			spdk_nvmf_request_complete(req);
620 			return;
621 		}
622 	}
623 
624 	admin_qpair = ctrlr->admin_qpair;
625 	if (admin_qpair->state != SPDK_NVMF_QPAIR_ACTIVE || admin_qpair->group == NULL) {
626 		/* There is a chance that admin qpair is being destroyed at this moment due to e.g.
627 		 * expired keep alive timer. Part of the qpair destruction process is change of qpair's
628 		 * state to DEACTIVATING and removing it from poll group */
629 		SPDK_ERRLOG("Inactive admin qpair (state %d, group %p)\n", admin_qpair->state, admin_qpair->group);
630 		SPDK_NVMF_INVALID_CONNECT_CMD(rsp, qid);
631 		spdk_nvmf_request_complete(req);
632 		return;
633 	}
634 	qpair->ctrlr = ctrlr;
635 	spdk_thread_send_msg(admin_qpair->group->thread, nvmf_ctrlr_add_io_qpair, req);
636 }
637 
638 static bool
639 nvmf_qpair_access_allowed(struct spdk_nvmf_qpair *qpair, struct spdk_nvmf_subsystem *subsystem,
640 			  const char *hostnqn)
641 {
642 	struct spdk_nvme_transport_id listen_trid = {};
643 
644 	if (!spdk_nvmf_subsystem_host_allowed(subsystem, hostnqn)) {
645 		SPDK_ERRLOG("Subsystem '%s' does not allow host '%s'\n", subsystem->subnqn, hostnqn);
646 		return false;
647 	}
648 
649 	if (spdk_nvmf_qpair_get_listen_trid(qpair, &listen_trid)) {
650 		SPDK_ERRLOG("Subsystem '%s' is unable to enforce access control due to an internal error.\n",
651 			    subsystem->subnqn);
652 		return false;
653 	}
654 
655 	if (!spdk_nvmf_subsystem_listener_allowed(subsystem, &listen_trid)) {
656 		SPDK_ERRLOG("Subsystem '%s' does not allow host '%s' to connect at this address.\n",
657 			    subsystem->subnqn, hostnqn);
658 		return false;
659 	}
660 
661 	return true;
662 }
663 
664 static int
665 _nvmf_ctrlr_connect(struct spdk_nvmf_request *req)
666 {
667 	struct spdk_nvmf_fabric_connect_data *data = req->data;
668 	struct spdk_nvmf_fabric_connect_cmd *cmd = &req->cmd->connect_cmd;
669 	struct spdk_nvmf_fabric_connect_rsp *rsp = &req->rsp->connect_rsp;
670 	struct spdk_nvmf_qpair *qpair = req->qpair;
671 	struct spdk_nvmf_transport *transport = qpair->transport;
672 	struct spdk_nvmf_ctrlr *ctrlr;
673 	struct spdk_nvmf_subsystem *subsystem;
674 
675 	SPDK_DEBUGLOG(nvmf, "recfmt 0x%x qid %u sqsize %u\n",
676 		      cmd->recfmt, cmd->qid, cmd->sqsize);
677 
678 	SPDK_DEBUGLOG(nvmf, "Connect data:\n");
679 	SPDK_DEBUGLOG(nvmf, "  cntlid:  0x%04x\n", data->cntlid);
680 	SPDK_DEBUGLOG(nvmf, "  hostid: %08x-%04x-%04x-%02x%02x-%04x%08x ***\n",
681 		      ntohl(*(uint32_t *)&data->hostid[0]),
682 		      ntohs(*(uint16_t *)&data->hostid[4]),
683 		      ntohs(*(uint16_t *)&data->hostid[6]),
684 		      data->hostid[8],
685 		      data->hostid[9],
686 		      ntohs(*(uint16_t *)&data->hostid[10]),
687 		      ntohl(*(uint32_t *)&data->hostid[12]));
688 	SPDK_DEBUGLOG(nvmf, "  subnqn: \"%s\"\n", data->subnqn);
689 	SPDK_DEBUGLOG(nvmf, "  hostnqn: \"%s\"\n", data->hostnqn);
690 
691 	subsystem = spdk_nvmf_tgt_find_subsystem(transport->tgt, data->subnqn);
692 	if (!subsystem) {
693 		SPDK_NVMF_INVALID_CONNECT_DATA(rsp, subnqn);
694 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
695 	}
696 
697 	if (cmd->recfmt != 0) {
698 		SPDK_ERRLOG("Connect command unsupported RECFMT %u\n", cmd->recfmt);
699 		rsp->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
700 		rsp->status.sc = SPDK_NVMF_FABRIC_SC_INCOMPATIBLE_FORMAT;
701 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
702 	}
703 
704 	/*
705 	 * SQSIZE is a 0-based value, so it must be at least 1 (minimum queue depth is 2) and
706 	 * strictly less than max_aq_depth (admin queues) or max_queue_depth (io queues).
707 	 */
708 	if (cmd->sqsize == 0) {
709 		SPDK_ERRLOG("Invalid SQSIZE = 0\n");
710 		SPDK_NVMF_INVALID_CONNECT_CMD(rsp, sqsize);
711 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
712 	}
713 
714 	if (cmd->qid == 0) {
715 		if (cmd->sqsize >= transport->opts.max_aq_depth) {
716 			SPDK_ERRLOG("Invalid SQSIZE for admin queue %u (min 1, max %u)\n",
717 				    cmd->sqsize, transport->opts.max_aq_depth - 1);
718 			SPDK_NVMF_INVALID_CONNECT_CMD(rsp, sqsize);
719 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
720 		}
721 	} else if (cmd->sqsize >= transport->opts.max_queue_depth) {
722 		SPDK_ERRLOG("Invalid SQSIZE %u (min 1, max %u)\n",
723 			    cmd->sqsize, transport->opts.max_queue_depth - 1);
724 		SPDK_NVMF_INVALID_CONNECT_CMD(rsp, sqsize);
725 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
726 	}
727 
728 	qpair->sq_head_max = cmd->sqsize;
729 	qpair->qid = cmd->qid;
730 
731 	if (0 == qpair->qid) {
732 		qpair->group->stat.admin_qpairs++;
733 		qpair->group->stat.current_admin_qpairs++;
734 	} else {
735 		qpair->group->stat.io_qpairs++;
736 		qpair->group->stat.current_io_qpairs++;
737 	}
738 
739 	if (cmd->qid == 0) {
740 		SPDK_DEBUGLOG(nvmf, "Connect Admin Queue for controller ID 0x%x\n", data->cntlid);
741 
742 		if (spdk_nvme_trtype_is_fabrics(transport->ops->type) && data->cntlid != 0xFFFF) {
743 			/* This NVMf target only supports dynamic mode. */
744 			SPDK_ERRLOG("The NVMf target only supports dynamic mode (CNTLID = 0x%x).\n", data->cntlid);
745 			SPDK_NVMF_INVALID_CONNECT_DATA(rsp, cntlid);
746 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
747 		}
748 
749 		/* Establish a new ctrlr */
750 		ctrlr = nvmf_ctrlr_create(subsystem, req, cmd, data);
751 		if (!ctrlr) {
752 			SPDK_ERRLOG("nvmf_ctrlr_create() failed\n");
753 			rsp->status.sc = SPDK_NVME_SC_INTERNAL_DEVICE_ERROR;
754 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
755 		} else {
756 			return SPDK_NVMF_REQUEST_EXEC_STATUS_ASYNCHRONOUS;
757 		}
758 	} else {
759 		spdk_thread_send_msg(subsystem->thread, _nvmf_ctrlr_add_io_qpair, req);
760 		return SPDK_NVMF_REQUEST_EXEC_STATUS_ASYNCHRONOUS;
761 	}
762 }
763 
764 static inline bool
765 nvmf_request_is_fabric_connect(struct spdk_nvmf_request *req)
766 {
767 	return req->cmd->nvmf_cmd.opcode == SPDK_NVME_OPC_FABRIC &&
768 	       req->cmd->nvmf_cmd.fctype == SPDK_NVMF_FABRIC_COMMAND_CONNECT;
769 }
770 
771 static struct spdk_nvmf_subsystem_poll_group *
772 nvmf_subsystem_pg_from_connect_cmd(struct spdk_nvmf_request *req)
773 {
774 	struct spdk_nvmf_fabric_connect_data *data;
775 	struct spdk_nvmf_subsystem *subsystem;
776 	struct spdk_nvmf_tgt *tgt;
777 
778 	assert(nvmf_request_is_fabric_connect(req));
779 	assert(req->qpair->ctrlr == NULL);
780 
781 	data = req->data;
782 	tgt = req->qpair->transport->tgt;
783 
784 	subsystem = spdk_nvmf_tgt_find_subsystem(tgt, data->subnqn);
785 	if (subsystem == NULL) {
786 		return NULL;
787 	}
788 
789 	return &req->qpair->group->sgroups[subsystem->id];
790 }
791 
792 int
793 spdk_nvmf_ctrlr_connect(struct spdk_nvmf_request *req)
794 {
795 	struct spdk_nvmf_fabric_connect_rsp *rsp = &req->rsp->connect_rsp;
796 	struct spdk_nvmf_subsystem_poll_group *sgroup;
797 	struct spdk_nvmf_qpair *qpair = req->qpair;
798 	enum spdk_nvmf_request_exec_status status;
799 
800 	sgroup = nvmf_subsystem_pg_from_connect_cmd(req);
801 	if (!sgroup) {
802 		SPDK_NVMF_INVALID_CONNECT_DATA(rsp, subnqn);
803 		status = SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
804 		goto out;
805 	}
806 
807 	sgroup->mgmt_io_outstanding++;
808 	TAILQ_INSERT_TAIL(&qpair->outstanding, req, link);
809 
810 	status = _nvmf_ctrlr_connect(req);
811 
812 out:
813 	if (status == SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE) {
814 		_nvmf_request_complete(req);
815 	}
816 
817 	return status;
818 }
819 
820 static int nvmf_ctrlr_cmd_connect(struct spdk_nvmf_request *req);
821 
822 static int
823 retry_connect(void *arg)
824 {
825 	struct spdk_nvmf_request *req = arg;
826 	struct spdk_nvmf_subsystem_poll_group *sgroup;
827 	int rc;
828 
829 	sgroup = nvmf_subsystem_pg_from_connect_cmd(req);
830 	assert(sgroup != NULL);
831 	sgroup->mgmt_io_outstanding++;
832 	spdk_poller_unregister(&req->poller);
833 	rc = nvmf_ctrlr_cmd_connect(req);
834 	if (rc == SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE) {
835 		_nvmf_request_complete(req);
836 	}
837 	return SPDK_POLLER_BUSY;
838 }
839 
840 static int
841 nvmf_ctrlr_cmd_connect(struct spdk_nvmf_request *req)
842 {
843 	struct spdk_nvmf_fabric_connect_data *data = req->data;
844 	struct spdk_nvmf_fabric_connect_rsp *rsp = &req->rsp->connect_rsp;
845 	struct spdk_nvmf_transport *transport = req->qpair->transport;
846 	struct spdk_nvmf_subsystem *subsystem;
847 
848 	if (req->length < sizeof(struct spdk_nvmf_fabric_connect_data)) {
849 		SPDK_ERRLOG("Connect command data length 0x%x too small\n", req->length);
850 		rsp->status.sc = SPDK_NVME_SC_INVALID_FIELD;
851 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
852 	}
853 
854 	subsystem = spdk_nvmf_tgt_find_subsystem(transport->tgt, data->subnqn);
855 	if (!subsystem) {
856 		SPDK_NVMF_INVALID_CONNECT_DATA(rsp, subnqn);
857 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
858 	}
859 
860 	if ((subsystem->state == SPDK_NVMF_SUBSYSTEM_INACTIVE) ||
861 	    (subsystem->state == SPDK_NVMF_SUBSYSTEM_PAUSING) ||
862 	    (subsystem->state == SPDK_NVMF_SUBSYSTEM_PAUSED) ||
863 	    (subsystem->state == SPDK_NVMF_SUBSYSTEM_DEACTIVATING)) {
864 		struct spdk_nvmf_subsystem_poll_group *sgroup;
865 
866 		if (req->timeout_tsc == 0) {
867 			/* We will only retry the request up to 1 second. */
868 			req->timeout_tsc = spdk_get_ticks() + spdk_get_ticks_hz();
869 		} else if (spdk_get_ticks() > req->timeout_tsc) {
870 			SPDK_ERRLOG("Subsystem '%s' was not ready for 1 second\n", subsystem->subnqn);
871 			rsp->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
872 			rsp->status.sc = SPDK_NVMF_FABRIC_SC_CONTROLLER_BUSY;
873 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
874 		}
875 
876 		/* Subsystem is not ready to handle a connect. Use a poller to retry it
877 		 * again later. Decrement the mgmt_io_outstanding to avoid the
878 		 * subsystem waiting for this command to complete before unpausing.
879 		 */
880 		sgroup = nvmf_subsystem_pg_from_connect_cmd(req);
881 		assert(sgroup != NULL);
882 		sgroup->mgmt_io_outstanding--;
883 		SPDK_DEBUGLOG(nvmf, "Subsystem '%s' is not ready for connect, retrying...\n", subsystem->subnqn);
884 		req->poller = SPDK_POLLER_REGISTER(retry_connect, req, 100);
885 		return SPDK_NVMF_REQUEST_EXEC_STATUS_ASYNCHRONOUS;
886 	}
887 
888 	/* Ensure that hostnqn is null terminated */
889 	if (!memchr(data->hostnqn, '\0', SPDK_NVMF_NQN_MAX_LEN + 1)) {
890 		SPDK_ERRLOG("Connect HOSTNQN is not null terminated\n");
891 		SPDK_NVMF_INVALID_CONNECT_DATA(rsp, hostnqn);
892 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
893 	}
894 
895 	if (!nvmf_qpair_access_allowed(req->qpair, subsystem, data->hostnqn)) {
896 		rsp->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
897 		rsp->status.sc = SPDK_NVMF_FABRIC_SC_INVALID_HOST;
898 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
899 	}
900 
901 	return _nvmf_ctrlr_connect(req);
902 }
903 
904 static int
905 nvmf_ctrlr_association_remove(void *ctx)
906 {
907 	struct spdk_nvmf_ctrlr *ctrlr = ctx;
908 	int rc;
909 
910 	nvmf_ctrlr_stop_association_timer(ctrlr);
911 
912 	if (ctrlr->in_destruct) {
913 		return SPDK_POLLER_IDLE;
914 	}
915 	SPDK_DEBUGLOG(nvmf, "Disconnecting host from subsystem %s due to association timeout.\n",
916 		      ctrlr->subsys->subnqn);
917 
918 	if (ctrlr->admin_qpair) {
919 		rc = spdk_nvmf_qpair_disconnect(ctrlr->admin_qpair, NULL, NULL);
920 		if (rc < 0) {
921 			SPDK_ERRLOG("Fail to disconnect admin ctrlr qpair\n");
922 			assert(false);
923 		}
924 	}
925 
926 	return SPDK_POLLER_BUSY;
927 }
928 
929 static int
930 _nvmf_ctrlr_cc_reset_shn_done(void *ctx)
931 {
932 	struct spdk_nvmf_ctrlr *ctrlr = ctx;
933 	uint64_t now = spdk_get_ticks();
934 	uint32_t count;
935 
936 	if (ctrlr->cc_timer) {
937 		spdk_poller_unregister(&ctrlr->cc_timer);
938 	}
939 
940 	count = spdk_bit_array_count_set(ctrlr->qpair_mask);
941 	SPDK_DEBUGLOG(nvmf, "ctrlr %p active queue count %u\n", ctrlr, count);
942 
943 	if (count > 1) {
944 		if (now < ctrlr->cc_timeout_tsc) {
945 			/* restart cc timer */
946 			ctrlr->cc_timer = SPDK_POLLER_REGISTER(_nvmf_ctrlr_cc_reset_shn_done, ctrlr, 100 * 1000);
947 			return SPDK_POLLER_IDLE;
948 		} else {
949 			/* controller fatal status */
950 			SPDK_WARNLOG("IO timeout, ctrlr %p is in fatal status\n", ctrlr);
951 			nvmf_ctrlr_set_fatal_status(ctrlr);
952 		}
953 	}
954 
955 	spdk_poller_unregister(&ctrlr->cc_timeout_timer);
956 
957 	if (ctrlr->disconnect_is_shn) {
958 		ctrlr->vcprop.csts.bits.shst = SPDK_NVME_SHST_COMPLETE;
959 		ctrlr->disconnect_is_shn = false;
960 	} else {
961 		/* Only a subset of the registers are cleared out on a reset */
962 		ctrlr->vcprop.cc.raw = 0;
963 		ctrlr->vcprop.csts.raw = 0;
964 	}
965 
966 	/* After CC.EN transitions to 0 (due to shutdown or reset), the association
967 	 * between the host and controller shall be preserved for at least 2 minutes */
968 	if (ctrlr->association_timer) {
969 		SPDK_DEBUGLOG(nvmf, "Association timer already set\n");
970 		nvmf_ctrlr_stop_association_timer(ctrlr);
971 	}
972 	if (ctrlr->association_timeout) {
973 		ctrlr->association_timer = SPDK_POLLER_REGISTER(nvmf_ctrlr_association_remove, ctrlr,
974 					   ctrlr->association_timeout * 1000);
975 	}
976 	ctrlr->disconnect_in_progress = false;
977 	return SPDK_POLLER_BUSY;
978 }
979 
980 static void
981 nvmf_ctrlr_cc_reset_shn_done(struct spdk_io_channel_iter *i, int status)
982 {
983 	struct spdk_nvmf_ctrlr *ctrlr = spdk_io_channel_iter_get_ctx(i);
984 
985 	if (status < 0) {
986 		SPDK_ERRLOG("Fail to disconnect io ctrlr qpairs\n");
987 		assert(false);
988 	}
989 
990 	_nvmf_ctrlr_cc_reset_shn_done((void *)ctrlr);
991 }
992 
993 static void
994 nvmf_bdev_complete_reset(struct spdk_bdev_io *bdev_io, bool success, void *cb_arg)
995 {
996 	SPDK_NOTICELOG("Resetting bdev done with %s\n", success ? "success" : "failure");
997 
998 	spdk_bdev_free_io(bdev_io);
999 }
1000 
1001 
1002 static int
1003 nvmf_ctrlr_cc_timeout(void *ctx)
1004 {
1005 	struct spdk_nvmf_ctrlr *ctrlr = ctx;
1006 	struct spdk_nvmf_poll_group *group = ctrlr->admin_qpair->group;
1007 	struct spdk_nvmf_ns *ns;
1008 	struct spdk_nvmf_subsystem_pg_ns_info *ns_info;
1009 
1010 	assert(group != NULL && group->sgroups != NULL);
1011 	spdk_poller_unregister(&ctrlr->cc_timeout_timer);
1012 	SPDK_DEBUGLOG(nvmf, "Ctrlr %p reset or shutdown timeout\n", ctrlr);
1013 
1014 	for (ns = spdk_nvmf_subsystem_get_first_ns(ctrlr->subsys); ns != NULL;
1015 	     ns = spdk_nvmf_subsystem_get_next_ns(ctrlr->subsys, ns)) {
1016 		if (ns->bdev == NULL) {
1017 			continue;
1018 		}
1019 		ns_info = &group->sgroups[ctrlr->subsys->id].ns_info[ns->opts.nsid - 1];
1020 		SPDK_NOTICELOG("Ctrlr %p resetting NSID %u\n", ctrlr, ns->opts.nsid);
1021 		spdk_bdev_reset(ns->desc, ns_info->channel, nvmf_bdev_complete_reset, NULL);
1022 	}
1023 
1024 	return SPDK_POLLER_BUSY;
1025 }
1026 
1027 const struct spdk_nvmf_registers *
1028 spdk_nvmf_ctrlr_get_regs(struct spdk_nvmf_ctrlr *ctrlr)
1029 {
1030 	return &ctrlr->vcprop;
1031 }
1032 
1033 void
1034 nvmf_ctrlr_set_fatal_status(struct spdk_nvmf_ctrlr *ctrlr)
1035 {
1036 	ctrlr->vcprop.csts.bits.cfs = 1;
1037 }
1038 
1039 static uint64_t
1040 nvmf_prop_get_cap(struct spdk_nvmf_ctrlr *ctrlr)
1041 {
1042 	return ctrlr->vcprop.cap.raw;
1043 }
1044 
1045 static uint64_t
1046 nvmf_prop_get_vs(struct spdk_nvmf_ctrlr *ctrlr)
1047 {
1048 	return ctrlr->vcprop.vs.raw;
1049 }
1050 
1051 static uint64_t
1052 nvmf_prop_get_cc(struct spdk_nvmf_ctrlr *ctrlr)
1053 {
1054 	return ctrlr->vcprop.cc.raw;
1055 }
1056 
1057 static bool
1058 nvmf_prop_set_cc(struct spdk_nvmf_ctrlr *ctrlr, uint32_t value)
1059 {
1060 	union spdk_nvme_cc_register cc, diff;
1061 	uint32_t cc_timeout_ms;
1062 
1063 	cc.raw = value;
1064 
1065 	SPDK_DEBUGLOG(nvmf, "cur CC: 0x%08x\n", ctrlr->vcprop.cc.raw);
1066 	SPDK_DEBUGLOG(nvmf, "new CC: 0x%08x\n", cc.raw);
1067 
1068 	/*
1069 	 * Calculate which bits changed between the current and new CC.
1070 	 * Mark each bit as 0 once it is handled to determine if any unhandled bits were changed.
1071 	 */
1072 	diff.raw = cc.raw ^ ctrlr->vcprop.cc.raw;
1073 
1074 	if (diff.bits.en) {
1075 		if (cc.bits.en) {
1076 			SPDK_DEBUGLOG(nvmf, "Property Set CC Enable!\n");
1077 			nvmf_ctrlr_stop_association_timer(ctrlr);
1078 
1079 			ctrlr->vcprop.cc.bits.en = 1;
1080 			ctrlr->vcprop.csts.bits.rdy = 1;
1081 		} else {
1082 			SPDK_DEBUGLOG(nvmf, "Property Set CC Disable!\n");
1083 			if (ctrlr->disconnect_in_progress) {
1084 				SPDK_DEBUGLOG(nvmf, "Disconnect in progress\n");
1085 				return true;
1086 			}
1087 
1088 			ctrlr->cc_timeout_timer = SPDK_POLLER_REGISTER(nvmf_ctrlr_cc_timeout, ctrlr,
1089 						  NVMF_CC_RESET_SHN_TIMEOUT_IN_MS * 1000);
1090 			/* Make sure cc_timeout_ms is between cc_timeout_timer and Host reset/shutdown timeout */
1091 			cc_timeout_ms = (NVMF_CC_RESET_SHN_TIMEOUT_IN_MS + NVMF_CTRLR_RESET_SHN_TIMEOUT_IN_MS) / 2;
1092 			ctrlr->cc_timeout_tsc = spdk_get_ticks() + cc_timeout_ms * spdk_get_ticks_hz() / (uint64_t)1000;
1093 
1094 			ctrlr->vcprop.cc.bits.en = 0;
1095 			ctrlr->disconnect_in_progress = true;
1096 			ctrlr->disconnect_is_shn = false;
1097 			spdk_for_each_channel(ctrlr->subsys->tgt,
1098 					      nvmf_ctrlr_disconnect_io_qpairs_on_pg,
1099 					      ctrlr,
1100 					      nvmf_ctrlr_cc_reset_shn_done);
1101 		}
1102 		diff.bits.en = 0;
1103 	}
1104 
1105 	if (diff.bits.shn) {
1106 		if (cc.bits.shn == SPDK_NVME_SHN_NORMAL ||
1107 		    cc.bits.shn == SPDK_NVME_SHN_ABRUPT) {
1108 			SPDK_DEBUGLOG(nvmf, "Property Set CC Shutdown %u%ub!\n",
1109 				      cc.bits.shn >> 1, cc.bits.shn & 1);
1110 			if (ctrlr->disconnect_in_progress) {
1111 				SPDK_DEBUGLOG(nvmf, "Disconnect in progress\n");
1112 				return true;
1113 			}
1114 
1115 			ctrlr->cc_timeout_timer = SPDK_POLLER_REGISTER(nvmf_ctrlr_cc_timeout, ctrlr,
1116 						  NVMF_CC_RESET_SHN_TIMEOUT_IN_MS * 1000);
1117 			/* Make sure cc_timeout_ms is between cc_timeout_timer and Host reset/shutdown timeout */
1118 			cc_timeout_ms = (NVMF_CC_RESET_SHN_TIMEOUT_IN_MS + NVMF_CTRLR_RESET_SHN_TIMEOUT_IN_MS) / 2;
1119 			ctrlr->cc_timeout_tsc = spdk_get_ticks() + cc_timeout_ms * spdk_get_ticks_hz() / (uint64_t)1000;
1120 
1121 			ctrlr->vcprop.cc.bits.shn = cc.bits.shn;
1122 			ctrlr->disconnect_in_progress = true;
1123 			ctrlr->disconnect_is_shn = true;
1124 			spdk_for_each_channel(ctrlr->subsys->tgt,
1125 					      nvmf_ctrlr_disconnect_io_qpairs_on_pg,
1126 					      ctrlr,
1127 					      nvmf_ctrlr_cc_reset_shn_done);
1128 
1129 			/* From the time a shutdown is initiated the controller shall disable
1130 			 * Keep Alive timer */
1131 			nvmf_ctrlr_stop_keep_alive_timer(ctrlr);
1132 		} else if (cc.bits.shn == 0) {
1133 			ctrlr->vcprop.cc.bits.shn = 0;
1134 		} else {
1135 			SPDK_ERRLOG("Prop Set CC: Invalid SHN value %u%ub\n",
1136 				    cc.bits.shn >> 1, cc.bits.shn & 1);
1137 			return false;
1138 		}
1139 		diff.bits.shn = 0;
1140 	}
1141 
1142 	if (diff.bits.iosqes) {
1143 		SPDK_DEBUGLOG(nvmf, "Prop Set IOSQES = %u (%u bytes)\n",
1144 			      cc.bits.iosqes, 1u << cc.bits.iosqes);
1145 		ctrlr->vcprop.cc.bits.iosqes = cc.bits.iosqes;
1146 		diff.bits.iosqes = 0;
1147 	}
1148 
1149 	if (diff.bits.iocqes) {
1150 		SPDK_DEBUGLOG(nvmf, "Prop Set IOCQES = %u (%u bytes)\n",
1151 			      cc.bits.iocqes, 1u << cc.bits.iocqes);
1152 		ctrlr->vcprop.cc.bits.iocqes = cc.bits.iocqes;
1153 		diff.bits.iocqes = 0;
1154 	}
1155 
1156 	if (diff.bits.ams) {
1157 		SPDK_ERRLOG("Arbitration Mechanism Selected (AMS) 0x%x not supported!\n", cc.bits.ams);
1158 		return false;
1159 	}
1160 
1161 	if (diff.bits.mps) {
1162 		SPDK_ERRLOG("Memory Page Size (MPS) %u KiB not supported!\n", (1 << (2 + cc.bits.mps)));
1163 		return false;
1164 	}
1165 
1166 	if (diff.bits.css) {
1167 		SPDK_ERRLOG("I/O Command Set Selected (CSS) 0x%x not supported!\n", cc.bits.css);
1168 		return false;
1169 	}
1170 
1171 	if (diff.raw != 0) {
1172 		/* Print an error message, but don't fail the command in this case.
1173 		 * If we did want to fail in this case, we'd need to ensure we acted
1174 		 * on no other bits or the initiator gets confused. */
1175 		SPDK_ERRLOG("Prop Set CC toggled reserved bits 0x%x!\n", diff.raw);
1176 	}
1177 
1178 	return true;
1179 }
1180 
1181 static uint64_t
1182 nvmf_prop_get_csts(struct spdk_nvmf_ctrlr *ctrlr)
1183 {
1184 	return ctrlr->vcprop.csts.raw;
1185 }
1186 
1187 static uint64_t
1188 nvmf_prop_get_aqa(struct spdk_nvmf_ctrlr *ctrlr)
1189 {
1190 	return ctrlr->vcprop.aqa.raw;
1191 }
1192 
1193 static bool
1194 nvmf_prop_set_aqa(struct spdk_nvmf_ctrlr *ctrlr, uint32_t value)
1195 {
1196 	union spdk_nvme_aqa_register aqa;
1197 
1198 	aqa.raw = value;
1199 
1200 	/*
1201 	 * We don't need to explicitly check for maximum size, as the fields are
1202 	 * limited to 12 bits (4096).
1203 	 */
1204 	if (aqa.bits.asqs < SPDK_NVME_ADMIN_QUEUE_MIN_ENTRIES - 1 ||
1205 	    aqa.bits.acqs < SPDK_NVME_ADMIN_QUEUE_MIN_ENTRIES - 1 ||
1206 	    aqa.bits.reserved1 != 0 || aqa.bits.reserved2 != 0) {
1207 		return false;
1208 	}
1209 
1210 	ctrlr->vcprop.aqa.raw = value;
1211 
1212 	return true;
1213 }
1214 
1215 static uint64_t
1216 nvmf_prop_get_asq(struct spdk_nvmf_ctrlr *ctrlr)
1217 {
1218 	return ctrlr->vcprop.asq;
1219 }
1220 
1221 static bool
1222 nvmf_prop_set_asq_lower(struct spdk_nvmf_ctrlr *ctrlr, uint32_t value)
1223 {
1224 	ctrlr->vcprop.asq = (ctrlr->vcprop.asq & (0xFFFFFFFFULL << 32ULL)) | value;
1225 
1226 	return true;
1227 }
1228 
1229 static bool
1230 nvmf_prop_set_asq_upper(struct spdk_nvmf_ctrlr *ctrlr, uint32_t value)
1231 {
1232 	ctrlr->vcprop.asq = (ctrlr->vcprop.asq & 0xFFFFFFFFULL) | ((uint64_t)value << 32ULL);
1233 
1234 	return true;
1235 }
1236 
1237 static uint64_t
1238 nvmf_prop_get_acq(struct spdk_nvmf_ctrlr *ctrlr)
1239 {
1240 	return ctrlr->vcprop.acq;
1241 }
1242 
1243 static bool
1244 nvmf_prop_set_acq_lower(struct spdk_nvmf_ctrlr *ctrlr, uint32_t value)
1245 {
1246 	ctrlr->vcprop.acq = (ctrlr->vcprop.acq & (0xFFFFFFFFULL << 32ULL)) | value;
1247 
1248 	return true;
1249 }
1250 
1251 static bool
1252 nvmf_prop_set_acq_upper(struct spdk_nvmf_ctrlr *ctrlr, uint32_t value)
1253 {
1254 	ctrlr->vcprop.acq = (ctrlr->vcprop.acq & 0xFFFFFFFFULL) | ((uint64_t)value << 32ULL);
1255 
1256 	return true;
1257 }
1258 
1259 struct nvmf_prop {
1260 	uint32_t ofst;
1261 	uint8_t size;
1262 	char name[11];
1263 	uint64_t (*get_cb)(struct spdk_nvmf_ctrlr *ctrlr);
1264 	bool (*set_cb)(struct spdk_nvmf_ctrlr *ctrlr, uint32_t value);
1265 	bool (*set_upper_cb)(struct spdk_nvmf_ctrlr *ctrlr, uint32_t value);
1266 };
1267 
1268 #define PROP(field, size, get_cb, set_cb, set_upper_cb) \
1269 	{ \
1270 		offsetof(struct spdk_nvme_registers, field), \
1271 		size, \
1272 		#field, \
1273 		get_cb, set_cb, set_upper_cb \
1274 	}
1275 
1276 static const struct nvmf_prop nvmf_props[] = {
1277 	PROP(cap,  8, nvmf_prop_get_cap,  NULL,                    NULL),
1278 	PROP(vs,   4, nvmf_prop_get_vs,   NULL,                    NULL),
1279 	PROP(cc,   4, nvmf_prop_get_cc,   nvmf_prop_set_cc,        NULL),
1280 	PROP(csts, 4, nvmf_prop_get_csts, NULL,                    NULL),
1281 	PROP(aqa,  4, nvmf_prop_get_aqa,  nvmf_prop_set_aqa,       NULL),
1282 	PROP(asq,  8, nvmf_prop_get_asq,  nvmf_prop_set_asq_lower, nvmf_prop_set_asq_upper),
1283 	PROP(acq,  8, nvmf_prop_get_acq,  nvmf_prop_set_acq_lower, nvmf_prop_set_acq_upper),
1284 };
1285 
1286 static const struct nvmf_prop *
1287 find_prop(uint32_t ofst, uint8_t size)
1288 {
1289 	size_t i;
1290 
1291 	for (i = 0; i < SPDK_COUNTOF(nvmf_props); i++) {
1292 		const struct nvmf_prop *prop = &nvmf_props[i];
1293 
1294 		if ((ofst >= prop->ofst) && (ofst + size <= prop->ofst + prop->size)) {
1295 			return prop;
1296 		}
1297 	}
1298 
1299 	return NULL;
1300 }
1301 
1302 static int
1303 nvmf_property_get(struct spdk_nvmf_request *req)
1304 {
1305 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1306 	struct spdk_nvmf_fabric_prop_get_cmd *cmd = &req->cmd->prop_get_cmd;
1307 	struct spdk_nvmf_fabric_prop_get_rsp *response = &req->rsp->prop_get_rsp;
1308 	const struct nvmf_prop *prop;
1309 	uint8_t size;
1310 
1311 	response->status.sc = 0;
1312 	response->value.u64 = 0;
1313 
1314 	SPDK_DEBUGLOG(nvmf, "size %d, offset 0x%x\n",
1315 		      cmd->attrib.size, cmd->ofst);
1316 
1317 	switch (cmd->attrib.size) {
1318 	case SPDK_NVMF_PROP_SIZE_4:
1319 		size = 4;
1320 		break;
1321 	case SPDK_NVMF_PROP_SIZE_8:
1322 		size = 8;
1323 		break;
1324 	default:
1325 		SPDK_DEBUGLOG(nvmf, "Invalid size value %d\n", cmd->attrib.size);
1326 		response->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
1327 		response->status.sc = SPDK_NVMF_FABRIC_SC_INVALID_PARAM;
1328 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1329 	}
1330 
1331 	prop = find_prop(cmd->ofst, size);
1332 	if (prop == NULL || prop->get_cb == NULL) {
1333 		response->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
1334 		response->status.sc = SPDK_NVMF_FABRIC_SC_INVALID_PARAM;
1335 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1336 	}
1337 
1338 	SPDK_DEBUGLOG(nvmf, "name: %s\n", prop->name);
1339 
1340 	response->value.u64 = prop->get_cb(ctrlr);
1341 
1342 	if (size != prop->size) {
1343 		/* The size must be 4 and the prop->size is 8. Figure out which part of the property to read. */
1344 		assert(size == 4);
1345 		assert(prop->size == 8);
1346 
1347 		if (cmd->ofst == prop->ofst) {
1348 			/* Keep bottom 4 bytes only */
1349 			response->value.u64 &= 0xFFFFFFFF;
1350 		} else {
1351 			/* Keep top 4 bytes only */
1352 			response->value.u64 >>= 32;
1353 		}
1354 	}
1355 
1356 	SPDK_DEBUGLOG(nvmf, "response value: 0x%" PRIx64 "\n", response->value.u64);
1357 
1358 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1359 }
1360 
1361 static int
1362 nvmf_property_set(struct spdk_nvmf_request *req)
1363 {
1364 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1365 	struct spdk_nvmf_fabric_prop_set_cmd *cmd = &req->cmd->prop_set_cmd;
1366 	struct spdk_nvme_cpl *response = &req->rsp->nvme_cpl;
1367 	const struct nvmf_prop *prop;
1368 	uint64_t value;
1369 	uint8_t size;
1370 	bool ret;
1371 
1372 	SPDK_DEBUGLOG(nvmf, "size %d, offset 0x%x, value 0x%" PRIx64 "\n",
1373 		      cmd->attrib.size, cmd->ofst, cmd->value.u64);
1374 
1375 	switch (cmd->attrib.size) {
1376 	case SPDK_NVMF_PROP_SIZE_4:
1377 		size = 4;
1378 		break;
1379 	case SPDK_NVMF_PROP_SIZE_8:
1380 		size = 8;
1381 		break;
1382 	default:
1383 		SPDK_DEBUGLOG(nvmf, "Invalid size value %d\n", cmd->attrib.size);
1384 		response->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
1385 		response->status.sc = SPDK_NVMF_FABRIC_SC_INVALID_PARAM;
1386 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1387 	}
1388 
1389 	prop = find_prop(cmd->ofst, size);
1390 	if (prop == NULL || prop->set_cb == NULL) {
1391 		SPDK_INFOLOG(nvmf, "Invalid offset 0x%x\n", cmd->ofst);
1392 		response->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
1393 		response->status.sc = SPDK_NVMF_FABRIC_SC_INVALID_PARAM;
1394 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1395 	}
1396 
1397 	SPDK_DEBUGLOG(nvmf, "name: %s\n", prop->name);
1398 
1399 	value = cmd->value.u64;
1400 
1401 	if (prop->size == 4) {
1402 		ret = prop->set_cb(ctrlr, (uint32_t)value);
1403 	} else if (size != prop->size) {
1404 		/* The size must be 4 and the prop->size is 8. Figure out which part of the property to write. */
1405 		assert(size == 4);
1406 		assert(prop->size == 8);
1407 
1408 		if (cmd->ofst == prop->ofst) {
1409 			ret = prop->set_cb(ctrlr, (uint32_t)value);
1410 		} else {
1411 			ret = prop->set_upper_cb(ctrlr, (uint32_t)value);
1412 		}
1413 	} else {
1414 		ret = prop->set_cb(ctrlr, (uint32_t)value);
1415 		if (ret) {
1416 			ret = prop->set_upper_cb(ctrlr, (uint32_t)(value >> 32));
1417 		}
1418 	}
1419 
1420 	if (!ret) {
1421 		SPDK_ERRLOG("prop set_cb failed\n");
1422 		response->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
1423 		response->status.sc = SPDK_NVMF_FABRIC_SC_INVALID_PARAM;
1424 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1425 	}
1426 
1427 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1428 }
1429 
1430 static int
1431 nvmf_ctrlr_set_features_arbitration(struct spdk_nvmf_request *req)
1432 {
1433 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1434 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1435 
1436 	SPDK_DEBUGLOG(nvmf, "Set Features - Arbitration (cdw11 = 0x%0x)\n", cmd->cdw11);
1437 
1438 	ctrlr->feat.arbitration.raw = cmd->cdw11;
1439 	ctrlr->feat.arbitration.bits.reserved = 0;
1440 
1441 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1442 }
1443 
1444 static int
1445 nvmf_ctrlr_set_features_power_management(struct spdk_nvmf_request *req)
1446 {
1447 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1448 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1449 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
1450 
1451 	SPDK_DEBUGLOG(nvmf, "Set Features - Power Management (cdw11 = 0x%0x)\n", cmd->cdw11);
1452 
1453 	/* Only PS = 0 is allowed, since we report NPSS = 0 */
1454 	if (cmd->cdw11_bits.feat_power_management.bits.ps != 0) {
1455 		SPDK_ERRLOG("Invalid power state %u\n", cmd->cdw11_bits.feat_power_management.bits.ps);
1456 		rsp->status.sct = SPDK_NVME_SCT_GENERIC;
1457 		rsp->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1458 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1459 	}
1460 
1461 	ctrlr->feat.power_management.raw = cmd->cdw11;
1462 	ctrlr->feat.power_management.bits.reserved = 0;
1463 
1464 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1465 }
1466 
1467 static bool
1468 temp_threshold_opts_valid(const union spdk_nvme_feat_temperature_threshold *opts)
1469 {
1470 	/*
1471 	 * Valid TMPSEL values:
1472 	 *  0000b - 1000b: temperature sensors
1473 	 *  1111b: set all implemented temperature sensors
1474 	 */
1475 	if (opts->bits.tmpsel >= 9 && opts->bits.tmpsel != 15) {
1476 		/* 1001b - 1110b: reserved */
1477 		SPDK_ERRLOG("Invalid TMPSEL %u\n", opts->bits.tmpsel);
1478 		return false;
1479 	}
1480 
1481 	/*
1482 	 * Valid THSEL values:
1483 	 *  00b: over temperature threshold
1484 	 *  01b: under temperature threshold
1485 	 */
1486 	if (opts->bits.thsel > 1) {
1487 		/* 10b - 11b: reserved */
1488 		SPDK_ERRLOG("Invalid THSEL %u\n", opts->bits.thsel);
1489 		return false;
1490 	}
1491 
1492 	return true;
1493 }
1494 
1495 static int
1496 nvmf_ctrlr_set_features_temperature_threshold(struct spdk_nvmf_request *req)
1497 {
1498 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1499 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
1500 
1501 	SPDK_DEBUGLOG(nvmf, "Set Features - Temperature Threshold (cdw11 = 0x%0x)\n", cmd->cdw11);
1502 
1503 	if (!temp_threshold_opts_valid(&cmd->cdw11_bits.feat_temp_threshold)) {
1504 		rsp->status.sct = SPDK_NVME_SCT_GENERIC;
1505 		rsp->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1506 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1507 	}
1508 
1509 	/* TODO: no sensors implemented - ignore new values */
1510 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1511 }
1512 
1513 static int
1514 nvmf_ctrlr_get_features_temperature_threshold(struct spdk_nvmf_request *req)
1515 {
1516 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1517 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
1518 
1519 	SPDK_DEBUGLOG(nvmf, "Get Features - Temperature Threshold (cdw11 = 0x%0x)\n", cmd->cdw11);
1520 
1521 	if (!temp_threshold_opts_valid(&cmd->cdw11_bits.feat_temp_threshold)) {
1522 		rsp->status.sct = SPDK_NVME_SCT_GENERIC;
1523 		rsp->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1524 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1525 	}
1526 
1527 	/* TODO: no sensors implemented - return 0 for all thresholds */
1528 	rsp->cdw0 = 0;
1529 
1530 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1531 }
1532 
1533 static int
1534 nvmf_ctrlr_get_features_interrupt_vector_configuration(struct spdk_nvmf_request *req)
1535 {
1536 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1537 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1538 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
1539 	union spdk_nvme_feat_interrupt_vector_configuration iv_conf = {};
1540 
1541 	SPDK_DEBUGLOG(nvmf, "Get Features - Interrupt Vector Configuration (cdw11 = 0x%0x)\n", cmd->cdw11);
1542 
1543 	iv_conf.bits.iv = cmd->cdw11_bits.feat_interrupt_vector_configuration.bits.iv;
1544 	iv_conf.bits.cd = ctrlr->feat.interrupt_vector_configuration.bits.cd;
1545 	rsp->cdw0 = iv_conf.raw;
1546 
1547 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1548 }
1549 
1550 static int
1551 nvmf_ctrlr_set_features_error_recovery(struct spdk_nvmf_request *req)
1552 {
1553 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1554 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1555 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
1556 
1557 	SPDK_DEBUGLOG(nvmf, "Set Features - Error Recovery (cdw11 = 0x%0x)\n", cmd->cdw11);
1558 
1559 	if (cmd->cdw11_bits.feat_error_recovery.bits.dulbe) {
1560 		/*
1561 		 * Host is not allowed to set this bit, since we don't advertise it in
1562 		 * Identify Namespace.
1563 		 */
1564 		SPDK_ERRLOG("Host set unsupported DULBE bit\n");
1565 		rsp->status.sct = SPDK_NVME_SCT_GENERIC;
1566 		rsp->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1567 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1568 	}
1569 
1570 	ctrlr->feat.error_recovery.raw = cmd->cdw11;
1571 	ctrlr->feat.error_recovery.bits.reserved = 0;
1572 
1573 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1574 }
1575 
1576 static int
1577 nvmf_ctrlr_set_features_volatile_write_cache(struct spdk_nvmf_request *req)
1578 {
1579 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1580 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1581 
1582 	SPDK_DEBUGLOG(nvmf, "Set Features - Volatile Write Cache (cdw11 = 0x%0x)\n", cmd->cdw11);
1583 
1584 	ctrlr->feat.volatile_write_cache.raw = cmd->cdw11;
1585 	ctrlr->feat.volatile_write_cache.bits.reserved = 0;
1586 
1587 	SPDK_DEBUGLOG(nvmf, "Set Features - Volatile Write Cache %s\n",
1588 		      ctrlr->feat.volatile_write_cache.bits.wce ? "Enabled" : "Disabled");
1589 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1590 }
1591 
1592 static int
1593 nvmf_ctrlr_set_features_write_atomicity(struct spdk_nvmf_request *req)
1594 {
1595 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1596 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1597 
1598 	SPDK_DEBUGLOG(nvmf, "Set Features - Write Atomicity (cdw11 = 0x%0x)\n", cmd->cdw11);
1599 
1600 	ctrlr->feat.write_atomicity.raw = cmd->cdw11;
1601 	ctrlr->feat.write_atomicity.bits.reserved = 0;
1602 
1603 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1604 }
1605 
1606 static int
1607 nvmf_ctrlr_set_features_host_identifier(struct spdk_nvmf_request *req)
1608 {
1609 	struct spdk_nvme_cpl *response = &req->rsp->nvme_cpl;
1610 
1611 	SPDK_ERRLOG("Set Features - Host Identifier not allowed\n");
1612 	response->status.sc = SPDK_NVME_SC_COMMAND_SEQUENCE_ERROR;
1613 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1614 }
1615 
1616 static int
1617 nvmf_ctrlr_get_features_host_identifier(struct spdk_nvmf_request *req)
1618 {
1619 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1620 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1621 	struct spdk_nvme_cpl *response = &req->rsp->nvme_cpl;
1622 
1623 	SPDK_DEBUGLOG(nvmf, "Get Features - Host Identifier\n");
1624 
1625 	if (!cmd->cdw11_bits.feat_host_identifier.bits.exhid) {
1626 		/* NVMe over Fabrics requires EXHID=1 (128-bit/16-byte host ID) */
1627 		SPDK_ERRLOG("Get Features - Host Identifier with EXHID=0 not allowed\n");
1628 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1629 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1630 	}
1631 
1632 	if (req->data == NULL || req->length < sizeof(ctrlr->hostid)) {
1633 		SPDK_ERRLOG("Invalid data buffer for Get Features - Host Identifier\n");
1634 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1635 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1636 	}
1637 
1638 	spdk_uuid_copy((struct spdk_uuid *)req->data, &ctrlr->hostid);
1639 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1640 }
1641 
1642 static int
1643 nvmf_ctrlr_get_features_reservation_notification_mask(struct spdk_nvmf_request *req)
1644 {
1645 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1646 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1647 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
1648 	struct spdk_nvmf_ns *ns;
1649 
1650 	SPDK_DEBUGLOG(nvmf, "get Features - Reservation Notification Mask\n");
1651 
1652 	if (cmd->nsid == SPDK_NVME_GLOBAL_NS_TAG) {
1653 		SPDK_ERRLOG("get Features - Invalid Namespace ID\n");
1654 		rsp->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1655 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1656 	}
1657 
1658 	ns = _nvmf_subsystem_get_ns(ctrlr->subsys, cmd->nsid);
1659 	if (ns == NULL) {
1660 		SPDK_ERRLOG("Set Features - Invalid Namespace ID\n");
1661 		rsp->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1662 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1663 	}
1664 	rsp->cdw0 = ns->mask;
1665 
1666 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1667 }
1668 
1669 static int
1670 nvmf_ctrlr_set_features_reservation_notification_mask(struct spdk_nvmf_request *req)
1671 {
1672 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1673 	struct spdk_nvmf_subsystem *subsystem = ctrlr->subsys;
1674 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1675 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
1676 	struct spdk_nvmf_ns *ns;
1677 
1678 	SPDK_DEBUGLOG(nvmf, "Set Features - Reservation Notification Mask\n");
1679 
1680 	if (cmd->nsid == SPDK_NVME_GLOBAL_NS_TAG) {
1681 		for (ns = spdk_nvmf_subsystem_get_first_ns(subsystem); ns != NULL;
1682 		     ns = spdk_nvmf_subsystem_get_next_ns(subsystem, ns)) {
1683 			ns->mask = cmd->cdw11;
1684 		}
1685 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1686 	}
1687 
1688 	ns = _nvmf_subsystem_get_ns(ctrlr->subsys, cmd->nsid);
1689 	if (ns == NULL) {
1690 		SPDK_ERRLOG("Set Features - Invalid Namespace ID\n");
1691 		rsp->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1692 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1693 	}
1694 	ns->mask = cmd->cdw11;
1695 
1696 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1697 }
1698 
1699 static int
1700 nvmf_ctrlr_get_features_reservation_persistence(struct spdk_nvmf_request *req)
1701 {
1702 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1703 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1704 	struct spdk_nvme_cpl *response = &req->rsp->nvme_cpl;
1705 	struct spdk_nvmf_ns *ns;
1706 
1707 	SPDK_DEBUGLOG(nvmf, "Get Features - Reservation Persistence\n");
1708 
1709 	ns = _nvmf_subsystem_get_ns(ctrlr->subsys, cmd->nsid);
1710 	/* NSID with SPDK_NVME_GLOBAL_NS_TAG (=0xffffffff) also included */
1711 	if (ns == NULL) {
1712 		SPDK_ERRLOG("Get Features - Invalid Namespace ID\n");
1713 		response->status.sct = SPDK_NVME_SCT_GENERIC;
1714 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1715 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1716 	}
1717 
1718 	response->cdw0 = ns->ptpl_activated;
1719 
1720 	response->status.sct = SPDK_NVME_SCT_GENERIC;
1721 	response->status.sc = SPDK_NVME_SC_SUCCESS;
1722 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1723 }
1724 
1725 static int
1726 nvmf_ctrlr_set_features_reservation_persistence(struct spdk_nvmf_request *req)
1727 {
1728 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1729 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1730 	struct spdk_nvme_cpl *response = &req->rsp->nvme_cpl;
1731 	struct spdk_nvmf_ns *ns;
1732 	bool ptpl;
1733 
1734 	SPDK_DEBUGLOG(nvmf, "Set Features - Reservation Persistence\n");
1735 
1736 	ns = _nvmf_subsystem_get_ns(ctrlr->subsys, cmd->nsid);
1737 	ptpl = cmd->cdw11_bits.feat_rsv_persistence.bits.ptpl;
1738 
1739 	if (cmd->nsid != SPDK_NVME_GLOBAL_NS_TAG && ns && ns->ptpl_file) {
1740 		ns->ptpl_activated = ptpl;
1741 	} else if (cmd->nsid == SPDK_NVME_GLOBAL_NS_TAG) {
1742 		for (ns = spdk_nvmf_subsystem_get_first_ns(ctrlr->subsys); ns && ns->ptpl_file;
1743 		     ns = spdk_nvmf_subsystem_get_next_ns(ctrlr->subsys, ns)) {
1744 			ns->ptpl_activated = ptpl;
1745 		}
1746 	} else {
1747 		SPDK_ERRLOG("Set Features - Invalid Namespace ID or Reservation Configuration\n");
1748 		response->status.sct = SPDK_NVME_SCT_GENERIC;
1749 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1750 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1751 	}
1752 
1753 	/* TODO: Feature not changeable for now */
1754 	response->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
1755 	response->status.sc = SPDK_NVME_SC_FEATURE_ID_NOT_SAVEABLE;
1756 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1757 }
1758 
1759 static int
1760 nvmf_ctrlr_get_features_host_behavior_support(struct spdk_nvmf_request *req)
1761 {
1762 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1763 	struct spdk_nvme_cpl *response = &req->rsp->nvme_cpl;
1764 	struct spdk_nvme_host_behavior host_behavior = {};
1765 
1766 	SPDK_DEBUGLOG(nvmf, "Get Features - Host Behavior Support\n");
1767 
1768 	if (req->data == NULL || req->length < sizeof(struct spdk_nvme_host_behavior)) {
1769 		SPDK_ERRLOG("invalid data buffer for Host Behavior Support\n");
1770 		response->status.sct = SPDK_NVME_SCT_GENERIC;
1771 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1772 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1773 	}
1774 
1775 	host_behavior.acre = ctrlr->acre_enabled;
1776 	memcpy(req->data, &host_behavior, sizeof(host_behavior));
1777 
1778 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1779 }
1780 
1781 static int
1782 nvmf_ctrlr_set_features_host_behavior_support(struct spdk_nvmf_request *req)
1783 {
1784 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1785 	struct spdk_nvme_cpl *response = &req->rsp->nvme_cpl;
1786 	struct spdk_nvme_host_behavior *host_behavior;
1787 
1788 	SPDK_DEBUGLOG(nvmf, "Set Features - Host Behavior Support\n");
1789 	if (req->iovcnt != 1) {
1790 		SPDK_ERRLOG("Host Behavior Support invalid iovcnt: %d\n", req->iovcnt);
1791 		response->status.sct = SPDK_NVME_SCT_GENERIC;
1792 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1793 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1794 	}
1795 	if (req->iov[0].iov_len != sizeof(struct spdk_nvme_host_behavior)) {
1796 		SPDK_ERRLOG("Host Behavior Support invalid iov_len: %zd\n", req->iov[0].iov_len);
1797 		response->status.sct = SPDK_NVME_SCT_GENERIC;
1798 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1799 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1800 	}
1801 
1802 	host_behavior = (struct spdk_nvme_host_behavior *)req->iov[0].iov_base;
1803 	if (host_behavior->acre == 0) {
1804 		ctrlr->acre_enabled = false;
1805 	} else if (host_behavior->acre == 1) {
1806 		ctrlr->acre_enabled = true;
1807 	} else {
1808 		SPDK_ERRLOG("Host Behavior Support invalid acre: 0x%02x\n", host_behavior->acre);
1809 		response->status.sct = SPDK_NVME_SCT_GENERIC;
1810 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1811 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1812 	}
1813 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1814 }
1815 
1816 static int
1817 nvmf_ctrlr_set_features_keep_alive_timer(struct spdk_nvmf_request *req)
1818 {
1819 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1820 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1821 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
1822 
1823 	SPDK_DEBUGLOG(nvmf, "Set Features - Keep Alive Timer (%u ms)\n", cmd->cdw11);
1824 
1825 	/*
1826 	 * if attempts to disable keep alive by setting kato to 0h
1827 	 * a status value of keep alive invalid shall be returned
1828 	 */
1829 	if (cmd->cdw11_bits.feat_keep_alive_timer.bits.kato == 0) {
1830 		rsp->status.sc = SPDK_NVME_SC_KEEP_ALIVE_INVALID;
1831 	} else if (cmd->cdw11_bits.feat_keep_alive_timer.bits.kato < MIN_KEEP_ALIVE_TIMEOUT_IN_MS) {
1832 		ctrlr->feat.keep_alive_timer.bits.kato = MIN_KEEP_ALIVE_TIMEOUT_IN_MS;
1833 	} else {
1834 		/* round up to milliseconds */
1835 		ctrlr->feat.keep_alive_timer.bits.kato = spdk_divide_round_up(
1836 					cmd->cdw11_bits.feat_keep_alive_timer.bits.kato,
1837 					KAS_DEFAULT_VALUE * KAS_TIME_UNIT_IN_MS) *
1838 				KAS_DEFAULT_VALUE * KAS_TIME_UNIT_IN_MS;
1839 	}
1840 
1841 	/*
1842 	 * if change the keep alive timeout value successfully
1843 	 * update the keep alive poller.
1844 	 */
1845 	if (cmd->cdw11_bits.feat_keep_alive_timer.bits.kato != 0) {
1846 		if (ctrlr->keep_alive_poller != NULL) {
1847 			spdk_poller_unregister(&ctrlr->keep_alive_poller);
1848 		}
1849 		ctrlr->keep_alive_poller = SPDK_POLLER_REGISTER(nvmf_ctrlr_keep_alive_poll, ctrlr,
1850 					   ctrlr->feat.keep_alive_timer.bits.kato * 1000);
1851 	}
1852 
1853 	SPDK_DEBUGLOG(nvmf, "Set Features - Keep Alive Timer set to %u ms\n",
1854 		      ctrlr->feat.keep_alive_timer.bits.kato);
1855 
1856 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1857 }
1858 
1859 static int
1860 nvmf_ctrlr_set_features_number_of_queues(struct spdk_nvmf_request *req)
1861 {
1862 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1863 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1864 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
1865 	uint32_t count;
1866 
1867 	SPDK_DEBUGLOG(nvmf, "Set Features - Number of Queues, cdw11 0x%x\n",
1868 		      req->cmd->nvme_cmd.cdw11);
1869 
1870 	if (cmd->cdw11_bits.feat_num_of_queues.bits.ncqr == UINT16_MAX ||
1871 	    cmd->cdw11_bits.feat_num_of_queues.bits.nsqr == UINT16_MAX) {
1872 		rsp->status.sc = SPDK_NVME_SC_INVALID_FIELD;
1873 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1874 	}
1875 
1876 	count = spdk_bit_array_count_set(ctrlr->qpair_mask);
1877 	/* verify that the controller is ready to process commands */
1878 	if (count > 1) {
1879 		SPDK_DEBUGLOG(nvmf, "Queue pairs already active!\n");
1880 		rsp->status.sc = SPDK_NVME_SC_COMMAND_SEQUENCE_ERROR;
1881 	} else {
1882 		/*
1883 		 * Ignore the value requested by the host -
1884 		 * always return the pre-configured value based on max_qpairs_allowed.
1885 		 */
1886 		rsp->cdw0 = ctrlr->feat.number_of_queues.raw;
1887 	}
1888 
1889 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1890 }
1891 
1892 int
1893 nvmf_ctrlr_save_aers(struct spdk_nvmf_ctrlr *ctrlr, uint16_t *aer_cids,
1894 		     uint16_t max_aers)
1895 {
1896 	struct spdk_nvmf_request *req;
1897 	uint16_t i;
1898 
1899 	if (!aer_cids || max_aers < ctrlr->nr_aer_reqs) {
1900 		return -EINVAL;
1901 	}
1902 
1903 	for (i = 0; i < ctrlr->nr_aer_reqs; i++) {
1904 		req = ctrlr->aer_req[i];
1905 		aer_cids[i] = req->cmd->nvme_cmd.cid;
1906 	}
1907 
1908 	return ctrlr->nr_aer_reqs;
1909 }
1910 
1911 int
1912 nvmf_ctrlr_save_migr_data(struct spdk_nvmf_ctrlr *ctrlr, struct nvmf_ctrlr_migr_data *data)
1913 {
1914 	uint32_t num_async_events = 0;
1915 	struct spdk_nvmf_async_event_completion *event, *event_tmp;
1916 
1917 	memcpy(&data->feat, &ctrlr->feat, sizeof(struct spdk_nvmf_ctrlr_feat));
1918 	data->cntlid = ctrlr->cntlid;
1919 	data->acre_enabled = ctrlr->acre_enabled;
1920 	data->notice_aen_mask = ctrlr->notice_aen_mask;
1921 
1922 	STAILQ_FOREACH_SAFE(event, &ctrlr->async_events, link, event_tmp) {
1923 		data->async_events[num_async_events++].raw = event->event.raw;
1924 		if (num_async_events == NVMF_MIGR_MAX_PENDING_AERS) {
1925 			SPDK_ERRLOG("%p has too many pending AERs\n", ctrlr);
1926 			break;
1927 		}
1928 	}
1929 	data->num_async_events = num_async_events;
1930 
1931 	return 0;
1932 }
1933 
1934 int
1935 nvmf_ctrlr_restore_migr_data(struct spdk_nvmf_ctrlr *ctrlr, struct nvmf_ctrlr_migr_data *data)
1936 {
1937 	struct spdk_nvmf_async_event_completion *event;
1938 	uint32_t i;
1939 
1940 	memcpy(&ctrlr->feat, &data->feat, sizeof(struct spdk_nvmf_ctrlr_feat));
1941 	ctrlr->acre_enabled = data->acre_enabled;
1942 	ctrlr->notice_aen_mask = data->notice_aen_mask;
1943 
1944 	for (i = 0; i < data->num_async_events; i++) {
1945 		event = calloc(1, sizeof(struct spdk_nvmf_async_event_completion));
1946 		if (!event) {
1947 			return -ENOMEM;
1948 		}
1949 		event->event.raw = data->async_events[i].raw;
1950 		STAILQ_INSERT_TAIL(&ctrlr->async_events, event, link);
1951 	}
1952 
1953 	return 0;
1954 }
1955 
1956 static int
1957 nvmf_ctrlr_set_features_async_event_configuration(struct spdk_nvmf_request *req)
1958 {
1959 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1960 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
1961 
1962 	SPDK_DEBUGLOG(nvmf, "Set Features - Async Event Configuration, cdw11 0x%08x\n",
1963 		      cmd->cdw11);
1964 	ctrlr->feat.async_event_configuration.raw = cmd->cdw11;
1965 	ctrlr->feat.async_event_configuration.bits.reserved1 = 0;
1966 	ctrlr->feat.async_event_configuration.bits.reserved2 = 0;
1967 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1968 }
1969 
1970 static int
1971 nvmf_ctrlr_async_event_request(struct spdk_nvmf_request *req)
1972 {
1973 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
1974 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
1975 	struct spdk_nvmf_subsystem_poll_group *sgroup;
1976 	struct spdk_nvmf_async_event_completion *pending_event;
1977 
1978 	SPDK_DEBUGLOG(nvmf, "Async Event Request\n");
1979 
1980 	/* AER cmd is an exception */
1981 	sgroup = &req->qpair->group->sgroups[ctrlr->subsys->id];
1982 	assert(sgroup != NULL);
1983 	sgroup->mgmt_io_outstanding--;
1984 
1985 	/* Four asynchronous events are supported for now */
1986 	if (ctrlr->nr_aer_reqs >= NVMF_MAX_ASYNC_EVENTS) {
1987 		SPDK_DEBUGLOG(nvmf, "AERL exceeded\n");
1988 		rsp->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
1989 		rsp->status.sc = SPDK_NVME_SC_ASYNC_EVENT_REQUEST_LIMIT_EXCEEDED;
1990 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1991 	}
1992 
1993 	if (!STAILQ_EMPTY(&ctrlr->async_events)) {
1994 		pending_event = STAILQ_FIRST(&ctrlr->async_events);
1995 		rsp->cdw0 = pending_event->event.raw;
1996 		STAILQ_REMOVE(&ctrlr->async_events, pending_event, spdk_nvmf_async_event_completion, link);
1997 		free(pending_event);
1998 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
1999 	}
2000 
2001 	ctrlr->aer_req[ctrlr->nr_aer_reqs++] = req;
2002 	return SPDK_NVMF_REQUEST_EXEC_STATUS_ASYNCHRONOUS;
2003 }
2004 
2005 struct copy_iovs_ctx {
2006 	struct iovec *iovs;
2007 	int iovcnt;
2008 	int cur_iov_idx;
2009 	size_t cur_iov_offset;
2010 };
2011 
2012 static void
2013 _clear_iovs(struct iovec *iovs, int iovcnt)
2014 {
2015 	int iov_idx = 0;
2016 	struct iovec *iov;
2017 
2018 	while (iov_idx < iovcnt) {
2019 		iov = &iovs[iov_idx];
2020 		memset(iov->iov_base, 0, iov->iov_len);
2021 		iov_idx++;
2022 	}
2023 }
2024 
2025 static void
2026 _init_copy_iovs_ctx(struct copy_iovs_ctx *copy_ctx, struct iovec *iovs, int iovcnt)
2027 {
2028 	copy_ctx->iovs = iovs;
2029 	copy_ctx->iovcnt = iovcnt;
2030 	copy_ctx->cur_iov_idx = 0;
2031 	copy_ctx->cur_iov_offset = 0;
2032 }
2033 
2034 static size_t
2035 _copy_buf_to_iovs(struct copy_iovs_ctx *copy_ctx, const void *buf, size_t buf_len)
2036 {
2037 	size_t len, iov_remain_len, copied_len = 0;
2038 	struct iovec *iov;
2039 
2040 	if (buf_len == 0) {
2041 		return 0;
2042 	}
2043 
2044 	while (copy_ctx->cur_iov_idx < copy_ctx->iovcnt) {
2045 		iov = &copy_ctx->iovs[copy_ctx->cur_iov_idx];
2046 		iov_remain_len = iov->iov_len - copy_ctx->cur_iov_offset;
2047 		if (iov_remain_len == 0) {
2048 			copy_ctx->cur_iov_idx++;
2049 			copy_ctx->cur_iov_offset = 0;
2050 			continue;
2051 		}
2052 
2053 		len = spdk_min(iov_remain_len, buf_len - copied_len);
2054 		memcpy((char *)iov->iov_base + copy_ctx->cur_iov_offset,
2055 		       (const char *)buf + copied_len,
2056 		       len);
2057 		copied_len += len;
2058 		copy_ctx->cur_iov_offset += len;
2059 
2060 		if (buf_len == copied_len) {
2061 			return copied_len;
2062 		}
2063 	}
2064 
2065 	return copied_len;
2066 }
2067 
2068 static void
2069 nvmf_get_firmware_slot_log_page(struct iovec *iovs, int iovcnt, uint64_t offset, uint32_t length)
2070 {
2071 	struct spdk_nvme_firmware_page fw_page;
2072 	size_t copy_len;
2073 	struct copy_iovs_ctx copy_ctx;
2074 
2075 	_init_copy_iovs_ctx(&copy_ctx, iovs, iovcnt);
2076 
2077 	memset(&fw_page, 0, sizeof(fw_page));
2078 	fw_page.afi.active_slot = 1;
2079 	fw_page.afi.next_reset_slot = 0;
2080 	spdk_strcpy_pad(fw_page.revision[0], FW_VERSION, sizeof(fw_page.revision[0]), ' ');
2081 
2082 	if (offset < sizeof(fw_page)) {
2083 		copy_len = spdk_min(sizeof(fw_page) - offset, length);
2084 		if (copy_len > 0) {
2085 			_copy_buf_to_iovs(&copy_ctx, (const char *)&fw_page + offset, copy_len);
2086 		}
2087 	}
2088 }
2089 
2090 /*
2091  * Asynchronous Event Mask Bit
2092  */
2093 enum spdk_nvme_async_event_mask_bit {
2094 	/* Mask Namespace Change Notification */
2095 	SPDK_NVME_ASYNC_EVENT_NS_ATTR_CHANGE_MASK_BIT		= 0,
2096 	/* Mask Asymmetric Namespace Access Change Notification */
2097 	SPDK_NVME_ASYNC_EVENT_ANA_CHANGE_MASK_BIT		= 1,
2098 	/* Mask Discovery Log Change Notification */
2099 	SPDK_NVME_ASYNC_EVENT_DISCOVERY_LOG_CHANGE_MASK_BIT	= 2,
2100 	/* Mask Reservation Log Page Available Notification */
2101 	SPDK_NVME_ASYNC_EVENT_RESERVATION_LOG_AVAIL_MASK_BIT	= 3,
2102 	/* Mask Error Event */
2103 	SPDK_NVME_ASYNC_EVENT_ERROR_MASK_BIT			= 4,
2104 	/* 4 - 63 Reserved */
2105 };
2106 
2107 static inline void
2108 nvmf_ctrlr_unmask_aen(struct spdk_nvmf_ctrlr *ctrlr,
2109 		      enum spdk_nvme_async_event_mask_bit mask)
2110 {
2111 	ctrlr->notice_aen_mask &= ~(1 << mask);
2112 }
2113 
2114 static inline bool
2115 nvmf_ctrlr_mask_aen(struct spdk_nvmf_ctrlr *ctrlr,
2116 		    enum spdk_nvme_async_event_mask_bit mask)
2117 {
2118 	if (ctrlr->notice_aen_mask & (1 << mask)) {
2119 		return false;
2120 	} else {
2121 		ctrlr->notice_aen_mask |= (1 << mask);
2122 		return true;
2123 	}
2124 }
2125 
2126 /* we have to use the typedef in the function declaration to appease astyle. */
2127 typedef enum spdk_nvme_ana_state spdk_nvme_ana_state_t;
2128 
2129 static inline spdk_nvme_ana_state_t
2130 nvmf_ctrlr_get_ana_state(struct spdk_nvmf_ctrlr *ctrlr, uint32_t anagrpid)
2131 {
2132 	if (!ctrlr->subsys->flags.ana_reporting) {
2133 		return SPDK_NVME_ANA_OPTIMIZED_STATE;
2134 	}
2135 
2136 	if (spdk_unlikely(ctrlr->listener == NULL)) {
2137 		return SPDK_NVME_ANA_INACCESSIBLE_STATE;
2138 	}
2139 
2140 	assert(anagrpid - 1 < ctrlr->subsys->max_nsid);
2141 	return ctrlr->listener->ana_state[anagrpid - 1];
2142 }
2143 
2144 static spdk_nvme_ana_state_t
2145 nvmf_ctrlr_get_ana_state_from_nsid(struct spdk_nvmf_ctrlr *ctrlr, uint32_t nsid)
2146 {
2147 	struct spdk_nvmf_ns *ns;
2148 
2149 	/* We do not have NVM subsystem specific ANA state. Hence if NSID is either
2150 	 * SPDK_NVMF_GLOBAL_NS_TAG, invalid, or for inactive namespace, return
2151 	 * the optimized state.
2152 	 */
2153 	ns = _nvmf_subsystem_get_ns(ctrlr->subsys, nsid);
2154 	if (ns == NULL) {
2155 		return SPDK_NVME_ANA_OPTIMIZED_STATE;
2156 	}
2157 
2158 	return nvmf_ctrlr_get_ana_state(ctrlr, ns->anagrpid);
2159 }
2160 
2161 static void
2162 nvmf_get_error_log_page(struct spdk_nvmf_ctrlr *ctrlr, struct iovec *iovs, int iovcnt,
2163 			uint64_t offset, uint32_t length, uint32_t rae)
2164 {
2165 	if (!rae) {
2166 		nvmf_ctrlr_unmask_aen(ctrlr, SPDK_NVME_ASYNC_EVENT_ERROR_MASK_BIT);
2167 	}
2168 
2169 	/* TODO: actually fill out log page data */
2170 }
2171 
2172 static void
2173 nvmf_get_ana_log_page(struct spdk_nvmf_ctrlr *ctrlr, struct iovec *iovs, int iovcnt,
2174 		      uint64_t offset, uint32_t length, uint32_t rae)
2175 {
2176 	struct spdk_nvme_ana_page ana_hdr;
2177 	struct spdk_nvme_ana_group_descriptor ana_desc;
2178 	size_t copy_len, copied_len;
2179 	uint32_t num_anagrp = 0, anagrpid;
2180 	struct spdk_nvmf_ns *ns;
2181 	struct copy_iovs_ctx copy_ctx;
2182 
2183 	_init_copy_iovs_ctx(&copy_ctx, iovs, iovcnt);
2184 
2185 	if (length == 0) {
2186 		goto done;
2187 	}
2188 
2189 	if (offset >= sizeof(ana_hdr)) {
2190 		offset -= sizeof(ana_hdr);
2191 	} else {
2192 		for (anagrpid = 1; anagrpid <= ctrlr->subsys->max_nsid; anagrpid++) {
2193 			if (ctrlr->subsys->ana_group[anagrpid - 1] > 0) {
2194 				num_anagrp++;
2195 			}
2196 		}
2197 
2198 		memset(&ana_hdr, 0, sizeof(ana_hdr));
2199 
2200 		ana_hdr.num_ana_group_desc = num_anagrp;
2201 		/* TODO: Support Change Count. */
2202 		ana_hdr.change_count = 0;
2203 
2204 		copy_len = spdk_min(sizeof(ana_hdr) - offset, length);
2205 		copied_len = _copy_buf_to_iovs(&copy_ctx, (const char *)&ana_hdr + offset, copy_len);
2206 		assert(copied_len == copy_len);
2207 		length -= copied_len;
2208 		offset = 0;
2209 	}
2210 
2211 	if (length == 0) {
2212 		goto done;
2213 	}
2214 
2215 	for (anagrpid = 1; anagrpid <= ctrlr->subsys->max_nsid; anagrpid++) {
2216 		if (ctrlr->subsys->ana_group[anagrpid - 1] == 0) {
2217 			continue;
2218 		}
2219 
2220 		if (offset >= sizeof(ana_desc)) {
2221 			offset -= sizeof(ana_desc);
2222 		} else {
2223 			memset(&ana_desc, 0, sizeof(ana_desc));
2224 
2225 			ana_desc.ana_group_id = anagrpid;
2226 			ana_desc.num_of_nsid = ctrlr->subsys->ana_group[anagrpid - 1];
2227 			ana_desc.ana_state = nvmf_ctrlr_get_ana_state(ctrlr, anagrpid);
2228 
2229 			copy_len = spdk_min(sizeof(ana_desc) - offset, length);
2230 			copied_len = _copy_buf_to_iovs(&copy_ctx, (const char *)&ana_desc + offset,
2231 						       copy_len);
2232 			assert(copied_len == copy_len);
2233 			length -= copied_len;
2234 			offset = 0;
2235 
2236 			if (length == 0) {
2237 				goto done;
2238 			}
2239 		}
2240 
2241 		/* TODO: Revisit here about O(n^2) cost if we have subsystem with
2242 		 * many namespaces in the future.
2243 		 */
2244 		for (ns = spdk_nvmf_subsystem_get_first_ns(ctrlr->subsys); ns != NULL;
2245 		     ns = spdk_nvmf_subsystem_get_next_ns(ctrlr->subsys, ns)) {
2246 			if (ns->anagrpid != anagrpid) {
2247 				continue;
2248 			}
2249 
2250 			if (offset >= sizeof(uint32_t)) {
2251 				offset -= sizeof(uint32_t);
2252 				continue;
2253 			}
2254 
2255 			copy_len = spdk_min(sizeof(uint32_t) - offset, length);
2256 			copied_len = _copy_buf_to_iovs(&copy_ctx, (const char *)&ns->nsid + offset,
2257 						       copy_len);
2258 			assert(copied_len == copy_len);
2259 			length -= copied_len;
2260 			offset = 0;
2261 
2262 			if (length == 0) {
2263 				goto done;
2264 			}
2265 		}
2266 	}
2267 
2268 done:
2269 	if (!rae) {
2270 		nvmf_ctrlr_unmask_aen(ctrlr, SPDK_NVME_ASYNC_EVENT_ANA_CHANGE_MASK_BIT);
2271 	}
2272 }
2273 
2274 void
2275 nvmf_ctrlr_ns_changed(struct spdk_nvmf_ctrlr *ctrlr, uint32_t nsid)
2276 {
2277 	uint16_t max_changes = SPDK_COUNTOF(ctrlr->changed_ns_list.ns_list);
2278 	uint16_t i;
2279 	bool found = false;
2280 
2281 	for (i = 0; i < ctrlr->changed_ns_list_count; i++) {
2282 		if (ctrlr->changed_ns_list.ns_list[i] == nsid) {
2283 			/* nsid is already in the list */
2284 			found = true;
2285 			break;
2286 		}
2287 	}
2288 
2289 	if (!found) {
2290 		if (ctrlr->changed_ns_list_count == max_changes) {
2291 			/* Out of space - set first entry to FFFFFFFFh and zero-fill the rest. */
2292 			ctrlr->changed_ns_list.ns_list[0] = 0xFFFFFFFFu;
2293 			for (i = 1; i < max_changes; i++) {
2294 				ctrlr->changed_ns_list.ns_list[i] = 0;
2295 			}
2296 		} else {
2297 			ctrlr->changed_ns_list.ns_list[ctrlr->changed_ns_list_count++] = nsid;
2298 		}
2299 	}
2300 }
2301 
2302 static void
2303 nvmf_get_changed_ns_list_log_page(struct spdk_nvmf_ctrlr *ctrlr,
2304 				  struct iovec *iovs, int iovcnt, uint64_t offset, uint32_t length, uint32_t rae)
2305 {
2306 	size_t copy_length;
2307 	struct copy_iovs_ctx copy_ctx;
2308 
2309 	_init_copy_iovs_ctx(&copy_ctx, iovs, iovcnt);
2310 
2311 	if (offset < sizeof(ctrlr->changed_ns_list)) {
2312 		copy_length = spdk_min(length, sizeof(ctrlr->changed_ns_list) - offset);
2313 		if (copy_length) {
2314 			_copy_buf_to_iovs(&copy_ctx, (char *)&ctrlr->changed_ns_list + offset, copy_length);
2315 		}
2316 	}
2317 
2318 	/* Clear log page each time it is read */
2319 	ctrlr->changed_ns_list_count = 0;
2320 	memset(&ctrlr->changed_ns_list, 0, sizeof(ctrlr->changed_ns_list));
2321 
2322 	if (!rae) {
2323 		nvmf_ctrlr_unmask_aen(ctrlr, SPDK_NVME_ASYNC_EVENT_NS_ATTR_CHANGE_MASK_BIT);
2324 	}
2325 }
2326 
2327 /* The structure can be modified if we provide support for other commands in future */
2328 static const struct spdk_nvme_cmds_and_effect_log_page g_cmds_and_effect_log_page = {
2329 	.admin_cmds_supported = {
2330 		/* CSUPP, LBCC, NCC, NIC, CCC, CSE */
2331 		/* Get Log Page */
2332 		[SPDK_NVME_OPC_GET_LOG_PAGE]		= {1, 0, 0, 0, 0, 0, 0, 0},
2333 		/* Identify */
2334 		[SPDK_NVME_OPC_IDENTIFY]		= {1, 0, 0, 0, 0, 0, 0, 0},
2335 		/* Abort */
2336 		[SPDK_NVME_OPC_ABORT]			= {1, 0, 0, 0, 0, 0, 0, 0},
2337 		/* Set Features */
2338 		[SPDK_NVME_OPC_SET_FEATURES]		= {1, 0, 0, 0, 0, 0, 0, 0},
2339 		/* Get Features */
2340 		[SPDK_NVME_OPC_GET_FEATURES]		= {1, 0, 0, 0, 0, 0, 0, 0},
2341 		/* Async Event Request */
2342 		[SPDK_NVME_OPC_ASYNC_EVENT_REQUEST]	= {1, 0, 0, 0, 0, 0, 0, 0},
2343 		/* Keep Alive */
2344 		[SPDK_NVME_OPC_KEEP_ALIVE]		= {1, 0, 0, 0, 0, 0, 0, 0},
2345 	},
2346 	.io_cmds_supported = {
2347 		/* FLUSH */
2348 		[SPDK_NVME_OPC_FLUSH]			= {1, 1, 0, 0, 0, 0, 0, 0},
2349 		/* WRITE */
2350 		[SPDK_NVME_OPC_WRITE]			= {1, 1, 0, 0, 0, 0, 0, 0},
2351 		/* READ */
2352 		[SPDK_NVME_OPC_READ]			= {1, 0, 0, 0, 0, 0, 0, 0},
2353 		/* WRITE ZEROES */
2354 		[SPDK_NVME_OPC_WRITE_ZEROES]		= {1, 1, 0, 0, 0, 0, 0, 0},
2355 		/* DATASET MANAGEMENT */
2356 		[SPDK_NVME_OPC_DATASET_MANAGEMENT]	= {1, 1, 0, 0, 0, 0, 0, 0},
2357 		/* COMPARE */
2358 		[SPDK_NVME_OPC_COMPARE]			= {1, 0, 0, 0, 0, 0, 0, 0},
2359 	},
2360 };
2361 
2362 static void
2363 nvmf_get_cmds_and_effects_log_page(struct iovec *iovs, int iovcnt,
2364 				   uint64_t offset, uint32_t length)
2365 {
2366 	uint32_t page_size = sizeof(struct spdk_nvme_cmds_and_effect_log_page);
2367 	size_t copy_len = 0;
2368 	struct copy_iovs_ctx copy_ctx;
2369 
2370 	_init_copy_iovs_ctx(&copy_ctx, iovs, iovcnt);
2371 
2372 	if (offset < page_size) {
2373 		copy_len = spdk_min(page_size - offset, length);
2374 		_copy_buf_to_iovs(&copy_ctx, (char *)(&g_cmds_and_effect_log_page) + offset, copy_len);
2375 	}
2376 }
2377 
2378 static void
2379 nvmf_get_reservation_notification_log_page(struct spdk_nvmf_ctrlr *ctrlr,
2380 		struct iovec *iovs, int iovcnt, uint64_t offset, uint32_t length, uint32_t rae)
2381 {
2382 	uint32_t unit_log_len, avail_log_len, next_pos, copy_len;
2383 	struct spdk_nvmf_reservation_log *log, *log_tmp;
2384 	struct copy_iovs_ctx copy_ctx;
2385 
2386 	_init_copy_iovs_ctx(&copy_ctx, iovs, iovcnt);
2387 
2388 	unit_log_len = sizeof(struct spdk_nvme_reservation_notification_log);
2389 	/* No available log, return zeroed log pages */
2390 	if (!ctrlr->num_avail_log_pages) {
2391 		return;
2392 	}
2393 
2394 	avail_log_len = ctrlr->num_avail_log_pages * unit_log_len;
2395 	if (offset >= avail_log_len) {
2396 		return;
2397 	}
2398 
2399 	next_pos = 0;
2400 	TAILQ_FOREACH_SAFE(log, &ctrlr->log_head, link, log_tmp) {
2401 		TAILQ_REMOVE(&ctrlr->log_head, log, link);
2402 		ctrlr->num_avail_log_pages--;
2403 
2404 		next_pos += unit_log_len;
2405 		if (next_pos > offset) {
2406 			copy_len = spdk_min(next_pos - offset, length);
2407 			_copy_buf_to_iovs(&copy_ctx, &log->log, copy_len);
2408 			length -= copy_len;
2409 			offset += copy_len;
2410 		}
2411 		free(log);
2412 
2413 		if (length == 0) {
2414 			break;
2415 		}
2416 	}
2417 
2418 	if (!rae) {
2419 		nvmf_ctrlr_unmask_aen(ctrlr, SPDK_NVME_ASYNC_EVENT_RESERVATION_LOG_AVAIL_MASK_BIT);
2420 	}
2421 	return;
2422 }
2423 
2424 static int
2425 nvmf_ctrlr_get_log_page(struct spdk_nvmf_request *req)
2426 {
2427 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
2428 	struct spdk_nvmf_subsystem *subsystem = ctrlr->subsys;
2429 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
2430 	struct spdk_nvme_cpl *response = &req->rsp->nvme_cpl;
2431 	struct spdk_nvme_transport_id cmd_source_trid;
2432 	uint64_t offset, len;
2433 	uint32_t rae, numdl, numdu;
2434 	uint8_t lid;
2435 
2436 	if (req->data == NULL) {
2437 		SPDK_DEBUGLOG(nvmf, "get log command with no buffer\n");
2438 		response->status.sct = SPDK_NVME_SCT_GENERIC;
2439 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
2440 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2441 	}
2442 
2443 	offset = (uint64_t)cmd->cdw12 | ((uint64_t)cmd->cdw13 << 32);
2444 	if (offset & 3) {
2445 		SPDK_ERRLOG("Invalid log page offset 0x%" PRIx64 "\n", offset);
2446 		response->status.sct = SPDK_NVME_SCT_GENERIC;
2447 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
2448 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2449 	}
2450 
2451 	rae = cmd->cdw10_bits.get_log_page.rae;
2452 	numdl = cmd->cdw10_bits.get_log_page.numdl;
2453 	numdu = cmd->cdw11_bits.get_log_page.numdu;
2454 	len = ((numdu << 16) + numdl + (uint64_t)1) * 4;
2455 	if (len > req->length) {
2456 		SPDK_ERRLOG("Get log page: len (%" PRIu64 ") > buf size (%u)\n",
2457 			    len, req->length);
2458 		response->status.sct = SPDK_NVME_SCT_GENERIC;
2459 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
2460 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2461 	}
2462 
2463 	lid = cmd->cdw10_bits.get_log_page.lid;
2464 	SPDK_DEBUGLOG(nvmf, "Get log page: LID=0x%02X offset=0x%" PRIx64 " len=0x%" PRIx64 " rae=%u\n",
2465 		      lid, offset, len, rae);
2466 
2467 	if (subsystem->subtype == SPDK_NVMF_SUBTYPE_DISCOVERY) {
2468 		switch (lid) {
2469 		case SPDK_NVME_LOG_DISCOVERY:
2470 			if (spdk_nvmf_qpair_get_listen_trid(req->qpair, &cmd_source_trid)) {
2471 				SPDK_ERRLOG("Failed to get LOG_DISCOVERY source trid\n");
2472 				response->status.sct = SPDK_NVME_SCT_GENERIC;
2473 				response->status.sc = SPDK_NVME_SC_INTERNAL_DEVICE_ERROR;
2474 				return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2475 			}
2476 			nvmf_get_discovery_log_page(subsystem->tgt, ctrlr->hostnqn, req->iov, req->iovcnt,
2477 						    offset, len, &cmd_source_trid);
2478 			if (!rae) {
2479 				nvmf_ctrlr_unmask_aen(ctrlr, SPDK_NVME_ASYNC_EVENT_DISCOVERY_LOG_CHANGE_MASK_BIT);
2480 			}
2481 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2482 		default:
2483 			goto invalid_log_page;
2484 		}
2485 	} else {
2486 		if (offset > len) {
2487 			SPDK_ERRLOG("Get log page: offset (%" PRIu64 ") > len (%" PRIu64 ")\n",
2488 				    offset, len);
2489 			response->status.sct = SPDK_NVME_SCT_GENERIC;
2490 			response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
2491 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2492 		}
2493 
2494 		switch (lid) {
2495 		case SPDK_NVME_LOG_ERROR:
2496 			nvmf_get_error_log_page(ctrlr, req->iov, req->iovcnt, offset, len, rae);
2497 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2498 		case SPDK_NVME_LOG_HEALTH_INFORMATION:
2499 			/* TODO: actually fill out log page data */
2500 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2501 		case SPDK_NVME_LOG_FIRMWARE_SLOT:
2502 			nvmf_get_firmware_slot_log_page(req->iov, req->iovcnt, offset, len);
2503 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2504 		case SPDK_NVME_LOG_ASYMMETRIC_NAMESPACE_ACCESS:
2505 			if (subsystem->flags.ana_reporting) {
2506 				nvmf_get_ana_log_page(ctrlr, req->iov, req->iovcnt, offset, len, rae);
2507 				return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2508 			} else {
2509 				goto invalid_log_page;
2510 			}
2511 		case SPDK_NVME_LOG_COMMAND_EFFECTS_LOG:
2512 			nvmf_get_cmds_and_effects_log_page(req->iov, req->iovcnt, offset, len);
2513 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2514 		case SPDK_NVME_LOG_CHANGED_NS_LIST:
2515 			nvmf_get_changed_ns_list_log_page(ctrlr, req->iov, req->iovcnt, offset, len, rae);
2516 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2517 		case SPDK_NVME_LOG_RESERVATION_NOTIFICATION:
2518 			nvmf_get_reservation_notification_log_page(ctrlr, req->iov, req->iovcnt, offset, len, rae);
2519 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2520 		default:
2521 			goto invalid_log_page;
2522 		}
2523 	}
2524 
2525 invalid_log_page:
2526 	SPDK_INFOLOG(nvmf, "Unsupported Get Log Page 0x%02X\n", lid);
2527 	response->status.sct = SPDK_NVME_SCT_GENERIC;
2528 	response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
2529 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2530 }
2531 
2532 int
2533 spdk_nvmf_ctrlr_identify_ns(struct spdk_nvmf_ctrlr *ctrlr,
2534 			    struct spdk_nvme_cmd *cmd,
2535 			    struct spdk_nvme_cpl *rsp,
2536 			    struct spdk_nvme_ns_data *nsdata)
2537 {
2538 	struct spdk_nvmf_subsystem *subsystem = ctrlr->subsys;
2539 	struct spdk_nvmf_ns *ns;
2540 	uint32_t max_num_blocks;
2541 	enum spdk_nvme_ana_state ana_state;
2542 
2543 	if (cmd->nsid == 0 || cmd->nsid > subsystem->max_nsid) {
2544 		SPDK_ERRLOG("Identify Namespace for invalid NSID %u\n", cmd->nsid);
2545 		rsp->status.sct = SPDK_NVME_SCT_GENERIC;
2546 		rsp->status.sc = SPDK_NVME_SC_INVALID_NAMESPACE_OR_FORMAT;
2547 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2548 	}
2549 
2550 	ns = _nvmf_subsystem_get_ns(subsystem, cmd->nsid);
2551 	if (ns == NULL || ns->bdev == NULL) {
2552 		/*
2553 		 * Inactive namespaces should return a zero filled data structure.
2554 		 * The data buffer is already zeroed by nvmf_ctrlr_process_admin_cmd(),
2555 		 * so we can just return early here.
2556 		 */
2557 		SPDK_DEBUGLOG(nvmf, "Identify Namespace for inactive NSID %u\n", cmd->nsid);
2558 		rsp->status.sct = SPDK_NVME_SCT_GENERIC;
2559 		rsp->status.sc = SPDK_NVME_SC_SUCCESS;
2560 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2561 	}
2562 
2563 	nvmf_bdev_ctrlr_identify_ns(ns, nsdata, ctrlr->dif_insert_or_strip);
2564 
2565 	assert(ctrlr->admin_qpair);
2566 	/* Due to bug in the Linux kernel NVMe driver we have to set noiob no larger than mdts */
2567 	max_num_blocks = ctrlr->admin_qpair->transport->opts.max_io_size /
2568 			 (1U << nsdata->lbaf[nsdata->flbas.format].lbads);
2569 	if (nsdata->noiob > max_num_blocks) {
2570 		nsdata->noiob = max_num_blocks;
2571 	}
2572 
2573 	/* Set NOWS equal to Controller MDTS */
2574 	if (nsdata->nsfeat.optperf) {
2575 		nsdata->nows = max_num_blocks - 1;
2576 	}
2577 
2578 	if (subsystem->flags.ana_reporting) {
2579 		assert(ns->anagrpid - 1 < subsystem->max_nsid);
2580 		nsdata->anagrpid = ns->anagrpid;
2581 
2582 		ana_state = nvmf_ctrlr_get_ana_state(ctrlr, ns->anagrpid);
2583 		if (ana_state == SPDK_NVME_ANA_INACCESSIBLE_STATE ||
2584 		    ana_state == SPDK_NVME_ANA_PERSISTENT_LOSS_STATE) {
2585 			nsdata->nuse = 0;
2586 		}
2587 	}
2588 
2589 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2590 }
2591 
2592 static void
2593 nvmf_ctrlr_populate_oacs(struct spdk_nvmf_ctrlr *ctrlr,
2594 			 struct spdk_nvme_ctrlr_data *cdata)
2595 {
2596 	cdata->oacs = ctrlr->cdata.oacs;
2597 
2598 	cdata->oacs.virtualization_management =
2599 		g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_VIRTUALIZATION_MANAGEMENT].hdlr != NULL;
2600 	cdata->oacs.nvme_mi = g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_NVME_MI_SEND].hdlr != NULL
2601 			      && g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_NVME_MI_RECEIVE].hdlr != NULL;
2602 	cdata->oacs.directives = g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_DIRECTIVE_SEND].hdlr != NULL
2603 				 && g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_DIRECTIVE_RECEIVE].hdlr != NULL;
2604 	cdata->oacs.device_self_test =
2605 		g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_DEVICE_SELF_TEST].hdlr != NULL;
2606 	cdata->oacs.ns_manage = g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_NS_MANAGEMENT].hdlr != NULL
2607 				&& g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_NS_ATTACHMENT].hdlr != NULL;
2608 	cdata->oacs.firmware = g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_FIRMWARE_IMAGE_DOWNLOAD].hdlr !=
2609 			       NULL
2610 			       && g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_FIRMWARE_COMMIT].hdlr != NULL;
2611 	cdata->oacs.format =
2612 		g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_FORMAT_NVM].hdlr != NULL;
2613 	cdata->oacs.security = g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_SECURITY_SEND].hdlr != NULL
2614 			       && g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_SECURITY_RECEIVE].hdlr != NULL;
2615 	cdata->oacs.get_lba_status = g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_GET_LBA_STATUS].hdlr !=
2616 				     NULL;
2617 }
2618 
2619 int
2620 spdk_nvmf_ctrlr_identify_ctrlr(struct spdk_nvmf_ctrlr *ctrlr, struct spdk_nvme_ctrlr_data *cdata)
2621 {
2622 	struct spdk_nvmf_subsystem *subsystem = ctrlr->subsys;
2623 	struct spdk_nvmf_transport *transport;
2624 
2625 	/*
2626 	 * Common fields for discovery and NVM subsystems
2627 	 */
2628 	assert(ctrlr->admin_qpair);
2629 	transport = ctrlr->admin_qpair->transport;
2630 	spdk_strcpy_pad(cdata->fr, FW_VERSION, sizeof(cdata->fr), ' ');
2631 	assert((transport->opts.max_io_size % 4096) == 0);
2632 	cdata->mdts = spdk_u32log2(transport->opts.max_io_size / 4096);
2633 	cdata->cntlid = ctrlr->cntlid;
2634 	cdata->ver = ctrlr->vcprop.vs;
2635 	cdata->aerl = ctrlr->cdata.aerl;
2636 	cdata->lpa.edlp = 1;
2637 	cdata->elpe = 127;
2638 	cdata->maxcmd = transport->opts.max_queue_depth;
2639 	cdata->sgls = ctrlr->cdata.sgls;
2640 	cdata->fuses = ctrlr->cdata.fuses;
2641 	cdata->acwu = 0; /* ACWU is 0-based. */
2642 	if (subsystem->flags.ana_reporting) {
2643 		cdata->mnan = subsystem->max_nsid;
2644 	}
2645 	spdk_strcpy_pad(cdata->subnqn, subsystem->subnqn, sizeof(cdata->subnqn), '\0');
2646 
2647 	SPDK_DEBUGLOG(nvmf, "ctrlr data: maxcmd 0x%x\n", cdata->maxcmd);
2648 	SPDK_DEBUGLOG(nvmf, "sgls data: 0x%x\n", from_le32(&cdata->sgls));
2649 
2650 
2651 	if (subsystem->subtype == SPDK_NVMF_SUBTYPE_DISCOVERY) {
2652 		/*
2653 		 * NVM Discovery subsystem fields
2654 		 */
2655 		cdata->oaes.discovery_log_change_notices = 1;
2656 	} else {
2657 		cdata->vid = ctrlr->cdata.vid;
2658 		cdata->ssvid = ctrlr->cdata.ssvid;
2659 		cdata->ieee[0] = ctrlr->cdata.ieee[0];
2660 		cdata->ieee[1] = ctrlr->cdata.ieee[1];
2661 		cdata->ieee[2] = ctrlr->cdata.ieee[2];
2662 
2663 		/*
2664 		 * NVM subsystem fields (reserved for discovery subsystems)
2665 		 */
2666 		spdk_strcpy_pad(cdata->mn, spdk_nvmf_subsystem_get_mn(subsystem), sizeof(cdata->mn), ' ');
2667 		spdk_strcpy_pad(cdata->sn, spdk_nvmf_subsystem_get_sn(subsystem), sizeof(cdata->sn), ' ');
2668 		cdata->kas = ctrlr->cdata.kas;
2669 
2670 		cdata->rab = 6;
2671 		cdata->cmic.multi_port = 1;
2672 		cdata->cmic.multi_ctrlr = 1;
2673 		cdata->oaes.ns_attribute_notices = 1;
2674 		cdata->ctratt.host_id_exhid_supported = 1;
2675 		/* We do not have any actual limitation to the number of abort commands.
2676 		 * We follow the recommendation by the NVMe specification.
2677 		 */
2678 		cdata->acl = NVMF_ABORT_COMMAND_LIMIT;
2679 		cdata->frmw.slot1_ro = 1;
2680 		cdata->frmw.num_slots = 1;
2681 
2682 		cdata->lpa.celp = 1; /* Command Effects log page supported */
2683 
2684 		cdata->sqes.min = 6;
2685 		cdata->sqes.max = 6;
2686 		cdata->cqes.min = 4;
2687 		cdata->cqes.max = 4;
2688 		cdata->nn = subsystem->max_nsid;
2689 		cdata->vwc.present = 1;
2690 		cdata->vwc.flush_broadcast = SPDK_NVME_FLUSH_BROADCAST_NOT_SUPPORTED;
2691 
2692 		cdata->nvmf_specific = ctrlr->cdata.nvmf_specific;
2693 
2694 		cdata->oncs.compare = ctrlr->cdata.oncs.compare;
2695 		cdata->oncs.dsm = nvmf_ctrlr_dsm_supported(ctrlr);
2696 		cdata->oncs.write_zeroes = nvmf_ctrlr_write_zeroes_supported(ctrlr);
2697 		cdata->oncs.reservations = ctrlr->cdata.oncs.reservations;
2698 		if (subsystem->flags.ana_reporting) {
2699 			/* Asymmetric Namespace Access Reporting is supported. */
2700 			cdata->cmic.ana_reporting = 1;
2701 			cdata->oaes.ana_change_notices = 1;
2702 
2703 			cdata->anatt = ANA_TRANSITION_TIME_IN_SEC;
2704 			/* ANA Change state is not used, and ANA Persistent Loss state
2705 			 * is not supported for now.
2706 			 */
2707 			cdata->anacap.ana_optimized_state = 1;
2708 			cdata->anacap.ana_non_optimized_state = 1;
2709 			cdata->anacap.ana_inaccessible_state = 1;
2710 			/* ANAGRPID does not change while namespace is attached to controller */
2711 			cdata->anacap.no_change_anagrpid = 1;
2712 			cdata->anagrpmax = subsystem->max_nsid;
2713 			cdata->nanagrpid = subsystem->max_nsid;
2714 		}
2715 
2716 		nvmf_ctrlr_populate_oacs(ctrlr, cdata);
2717 
2718 		assert(subsystem->tgt != NULL);
2719 		cdata->crdt[0] = subsystem->tgt->crdt[0];
2720 		cdata->crdt[1] = subsystem->tgt->crdt[1];
2721 		cdata->crdt[2] = subsystem->tgt->crdt[2];
2722 
2723 		SPDK_DEBUGLOG(nvmf, "ext ctrlr data: ioccsz 0x%x\n",
2724 			      cdata->nvmf_specific.ioccsz);
2725 		SPDK_DEBUGLOG(nvmf, "ext ctrlr data: iorcsz 0x%x\n",
2726 			      cdata->nvmf_specific.iorcsz);
2727 		SPDK_DEBUGLOG(nvmf, "ext ctrlr data: icdoff 0x%x\n",
2728 			      cdata->nvmf_specific.icdoff);
2729 		SPDK_DEBUGLOG(nvmf, "ext ctrlr data: ctrattr 0x%x\n",
2730 			      *(uint8_t *)&cdata->nvmf_specific.ctrattr);
2731 		SPDK_DEBUGLOG(nvmf, "ext ctrlr data: msdbd 0x%x\n",
2732 			      cdata->nvmf_specific.msdbd);
2733 	}
2734 
2735 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2736 }
2737 
2738 static int
2739 nvmf_ctrlr_identify_active_ns_list(struct spdk_nvmf_subsystem *subsystem,
2740 				   struct spdk_nvme_cmd *cmd,
2741 				   struct spdk_nvme_cpl *rsp,
2742 				   struct spdk_nvme_ns_list *ns_list)
2743 {
2744 	struct spdk_nvmf_ns *ns;
2745 	uint32_t count = 0;
2746 
2747 	if (cmd->nsid >= 0xfffffffeUL) {
2748 		SPDK_ERRLOG("Identify Active Namespace List with invalid NSID %u\n", cmd->nsid);
2749 		rsp->status.sc = SPDK_NVME_SC_INVALID_NAMESPACE_OR_FORMAT;
2750 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2751 	}
2752 
2753 	memset(ns_list, 0, sizeof(*ns_list));
2754 
2755 	for (ns = spdk_nvmf_subsystem_get_first_ns(subsystem); ns != NULL;
2756 	     ns = spdk_nvmf_subsystem_get_next_ns(subsystem, ns)) {
2757 		if (ns->opts.nsid <= cmd->nsid) {
2758 			continue;
2759 		}
2760 
2761 		ns_list->ns_list[count++] = ns->opts.nsid;
2762 		if (count == SPDK_COUNTOF(ns_list->ns_list)) {
2763 			break;
2764 		}
2765 	}
2766 
2767 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2768 }
2769 
2770 static void
2771 _add_ns_id_desc(void **buf_ptr, size_t *buf_remain,
2772 		enum spdk_nvme_nidt type,
2773 		const void *data, size_t data_size)
2774 {
2775 	struct spdk_nvme_ns_id_desc *desc;
2776 	size_t desc_size = sizeof(*desc) + data_size;
2777 
2778 	/*
2779 	 * These should never fail in practice, since all valid NS ID descriptors
2780 	 * should be defined so that they fit in the available 4096-byte buffer.
2781 	 */
2782 	assert(data_size > 0);
2783 	assert(data_size <= UINT8_MAX);
2784 	assert(desc_size < *buf_remain);
2785 	if (data_size == 0 || data_size > UINT8_MAX || desc_size > *buf_remain) {
2786 		return;
2787 	}
2788 
2789 	desc = *buf_ptr;
2790 	desc->nidt = type;
2791 	desc->nidl = data_size;
2792 	memcpy(desc->nid, data, data_size);
2793 
2794 	*buf_ptr += desc_size;
2795 	*buf_remain -= desc_size;
2796 }
2797 
2798 static int
2799 nvmf_ctrlr_identify_ns_id_descriptor_list(
2800 	struct spdk_nvmf_subsystem *subsystem,
2801 	struct spdk_nvme_cmd *cmd,
2802 	struct spdk_nvme_cpl *rsp,
2803 	void *id_desc_list, size_t id_desc_list_size)
2804 {
2805 	struct spdk_nvmf_ns *ns;
2806 	size_t buf_remain = id_desc_list_size;
2807 	void *buf_ptr = id_desc_list;
2808 
2809 	ns = _nvmf_subsystem_get_ns(subsystem, cmd->nsid);
2810 	if (ns == NULL || ns->bdev == NULL) {
2811 		rsp->status.sct = SPDK_NVME_SCT_GENERIC;
2812 		rsp->status.sc = SPDK_NVME_SC_INVALID_NAMESPACE_OR_FORMAT;
2813 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2814 	}
2815 
2816 #define ADD_ID_DESC(type, data, size) \
2817 	do { \
2818 		if (!spdk_mem_all_zero(data, size)) { \
2819 			_add_ns_id_desc(&buf_ptr, &buf_remain, type, data, size); \
2820 		} \
2821 	} while (0)
2822 
2823 	ADD_ID_DESC(SPDK_NVME_NIDT_EUI64, ns->opts.eui64, sizeof(ns->opts.eui64));
2824 	ADD_ID_DESC(SPDK_NVME_NIDT_NGUID, ns->opts.nguid, sizeof(ns->opts.nguid));
2825 	ADD_ID_DESC(SPDK_NVME_NIDT_UUID, &ns->opts.uuid, sizeof(ns->opts.uuid));
2826 
2827 	/*
2828 	 * The list is automatically 0-terminated because controller to host buffers in
2829 	 * admin commands always get zeroed in nvmf_ctrlr_process_admin_cmd().
2830 	 */
2831 
2832 #undef ADD_ID_DESC
2833 
2834 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2835 }
2836 
2837 static int
2838 nvmf_ctrlr_identify(struct spdk_nvmf_request *req)
2839 {
2840 	uint8_t cns;
2841 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
2842 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
2843 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
2844 	struct spdk_nvmf_subsystem *subsystem = ctrlr->subsys;
2845 
2846 	if (req->data == NULL || req->length < 4096) {
2847 		SPDK_DEBUGLOG(nvmf, "identify command with invalid buffer\n");
2848 		rsp->status.sct = SPDK_NVME_SCT_GENERIC;
2849 		rsp->status.sc = SPDK_NVME_SC_INVALID_FIELD;
2850 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2851 	}
2852 
2853 	cns = cmd->cdw10_bits.identify.cns;
2854 
2855 	if (subsystem->subtype == SPDK_NVMF_SUBTYPE_DISCOVERY &&
2856 	    cns != SPDK_NVME_IDENTIFY_CTRLR) {
2857 		/* Discovery controllers only support Identify Controller */
2858 		goto invalid_cns;
2859 	}
2860 
2861 	switch (cns) {
2862 	case SPDK_NVME_IDENTIFY_NS:
2863 		return spdk_nvmf_ctrlr_identify_ns(ctrlr, cmd, rsp, req->data);
2864 	case SPDK_NVME_IDENTIFY_CTRLR:
2865 		return spdk_nvmf_ctrlr_identify_ctrlr(ctrlr, req->data);
2866 	case SPDK_NVME_IDENTIFY_ACTIVE_NS_LIST:
2867 		return nvmf_ctrlr_identify_active_ns_list(subsystem, cmd, rsp, req->data);
2868 	case SPDK_NVME_IDENTIFY_NS_ID_DESCRIPTOR_LIST:
2869 		return nvmf_ctrlr_identify_ns_id_descriptor_list(subsystem, cmd, rsp, req->data, req->length);
2870 	default:
2871 		goto invalid_cns;
2872 	}
2873 
2874 invalid_cns:
2875 	SPDK_INFOLOG(nvmf, "Identify command with unsupported CNS 0x%02x\n", cns);
2876 	rsp->status.sct = SPDK_NVME_SCT_GENERIC;
2877 	rsp->status.sc = SPDK_NVME_SC_INVALID_FIELD;
2878 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
2879 }
2880 
2881 static bool
2882 nvmf_qpair_abort_aer(struct spdk_nvmf_qpair *qpair, uint16_t cid)
2883 {
2884 	struct spdk_nvmf_ctrlr *ctrlr = qpair->ctrlr;
2885 	struct spdk_nvmf_request *req;
2886 	int i;
2887 
2888 	if (!nvmf_qpair_is_admin_queue(qpair)) {
2889 		return false;
2890 	}
2891 
2892 	assert(spdk_get_thread() == ctrlr->thread);
2893 
2894 	for (i = 0; i < ctrlr->nr_aer_reqs; i++) {
2895 		if (ctrlr->aer_req[i]->cmd->nvme_cmd.cid == cid) {
2896 			SPDK_DEBUGLOG(nvmf, "Aborting AER request\n");
2897 			req = ctrlr->aer_req[i];
2898 			ctrlr->aer_req[i] = NULL;
2899 			ctrlr->nr_aer_reqs--;
2900 
2901 			/* Move the last req to the aborting position for making aer_reqs
2902 			 * in continuous
2903 			 */
2904 			if (i < ctrlr->nr_aer_reqs) {
2905 				ctrlr->aer_req[i] = ctrlr->aer_req[ctrlr->nr_aer_reqs];
2906 				ctrlr->aer_req[ctrlr->nr_aer_reqs] = NULL;
2907 			}
2908 
2909 			req->rsp->nvme_cpl.status.sct = SPDK_NVME_SCT_GENERIC;
2910 			req->rsp->nvme_cpl.status.sc = SPDK_NVME_SC_ABORTED_BY_REQUEST;
2911 			_nvmf_request_complete(req);
2912 			return true;
2913 		}
2914 	}
2915 
2916 	return false;
2917 }
2918 
2919 void
2920 nvmf_qpair_abort_pending_zcopy_reqs(struct spdk_nvmf_qpair *qpair)
2921 {
2922 	struct spdk_nvmf_request *req, *tmp;
2923 
2924 	TAILQ_FOREACH_SAFE(req, &qpair->outstanding, link, tmp) {
2925 		if (req->zcopy_phase == NVMF_ZCOPY_PHASE_EXECUTE) {
2926 			/* Zero-copy requests are kept on the outstanding queue from the moment
2927 			 * zcopy_start is sent until a zcopy_end callback is received.  Therefore,
2928 			 * we can't remove them from the outstanding queue here, but need to rely on
2929 			 * the transport to do a zcopy_end to release their buffers and, in turn,
2930 			 * remove them from the queue.
2931 			 */
2932 			req->rsp->nvme_cpl.status.sct = SPDK_NVME_SCT_GENERIC;
2933 			req->rsp->nvme_cpl.status.sc = SPDK_NVME_SC_ABORTED_BY_REQUEST;
2934 			nvmf_transport_req_free(req);
2935 		}
2936 	}
2937 }
2938 
2939 static void
2940 nvmf_qpair_abort_request(struct spdk_nvmf_qpair *qpair, struct spdk_nvmf_request *req)
2941 {
2942 	uint16_t cid = req->cmd->nvme_cmd.cdw10_bits.abort.cid;
2943 
2944 	if (nvmf_qpair_abort_aer(qpair, cid)) {
2945 		SPDK_DEBUGLOG(nvmf, "abort ctrlr=%p sqid=%u cid=%u successful\n",
2946 			      qpair->ctrlr, qpair->qid, cid);
2947 		req->rsp->nvme_cpl.cdw0 &= ~1U; /* Command successfully aborted */
2948 
2949 		spdk_nvmf_request_complete(req);
2950 		return;
2951 	}
2952 
2953 	nvmf_transport_qpair_abort_request(qpair, req);
2954 }
2955 
2956 static void
2957 nvmf_ctrlr_abort_done(struct spdk_io_channel_iter *i, int status)
2958 {
2959 	struct spdk_nvmf_request *req = spdk_io_channel_iter_get_ctx(i);
2960 
2961 	if (status == 0) {
2962 		/* There was no qpair whose ID matches SQID of the abort command.
2963 		 * Hence call _nvmf_request_complete() here.
2964 		 */
2965 		_nvmf_request_complete(req);
2966 	}
2967 }
2968 
2969 static void
2970 nvmf_ctrlr_abort_on_pg(struct spdk_io_channel_iter *i)
2971 {
2972 	struct spdk_nvmf_request *req = spdk_io_channel_iter_get_ctx(i);
2973 	struct spdk_io_channel *ch = spdk_io_channel_iter_get_channel(i);
2974 	struct spdk_nvmf_poll_group *group = spdk_io_channel_get_ctx(ch);
2975 	uint16_t sqid = req->cmd->nvme_cmd.cdw10_bits.abort.sqid;
2976 	struct spdk_nvmf_qpair *qpair;
2977 
2978 	TAILQ_FOREACH(qpair, &group->qpairs, link) {
2979 		if (qpair->ctrlr == req->qpair->ctrlr && qpair->qid == sqid) {
2980 			/* Found the qpair */
2981 
2982 			nvmf_qpair_abort_request(qpair, req);
2983 
2984 			/* Return -1 for the status so the iteration across threads stops. */
2985 			spdk_for_each_channel_continue(i, -1);
2986 			return;
2987 		}
2988 	}
2989 
2990 	spdk_for_each_channel_continue(i, 0);
2991 }
2992 
2993 static int
2994 nvmf_ctrlr_abort(struct spdk_nvmf_request *req)
2995 {
2996 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
2997 
2998 	rsp->cdw0 = 1U; /* Command not aborted */
2999 	rsp->status.sct = SPDK_NVME_SCT_GENERIC;
3000 	rsp->status.sc = SPDK_NVME_SC_SUCCESS;
3001 
3002 	/* Send a message to each poll group, searching for this ctrlr, sqid, and command. */
3003 	spdk_for_each_channel(req->qpair->ctrlr->subsys->tgt,
3004 			      nvmf_ctrlr_abort_on_pg,
3005 			      req,
3006 			      nvmf_ctrlr_abort_done
3007 			     );
3008 
3009 	return SPDK_NVMF_REQUEST_EXEC_STATUS_ASYNCHRONOUS;
3010 }
3011 
3012 int
3013 nvmf_ctrlr_abort_request(struct spdk_nvmf_request *req)
3014 {
3015 	struct spdk_nvmf_request *req_to_abort = req->req_to_abort;
3016 	struct spdk_bdev *bdev;
3017 	struct spdk_bdev_desc *desc;
3018 	struct spdk_io_channel *ch;
3019 	int rc;
3020 
3021 	assert(req_to_abort != NULL);
3022 
3023 	if (g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_ABORT].hdlr &&
3024 	    nvmf_qpair_is_admin_queue(req_to_abort->qpair)) {
3025 		return g_nvmf_custom_admin_cmd_hdlrs[SPDK_NVME_OPC_ABORT].hdlr(req);
3026 	}
3027 
3028 	rc = spdk_nvmf_request_get_bdev(req_to_abort->cmd->nvme_cmd.nsid, req_to_abort,
3029 					&bdev, &desc, &ch);
3030 	if (rc != 0) {
3031 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3032 	}
3033 
3034 	return spdk_nvmf_bdev_ctrlr_abort_cmd(bdev, desc, ch, req, req_to_abort);
3035 }
3036 
3037 static int
3038 get_features_generic(struct spdk_nvmf_request *req, uint32_t cdw0)
3039 {
3040 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
3041 
3042 	rsp->cdw0 = cdw0;
3043 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3044 }
3045 
3046 /* we have to use the typedef in the function declaration to appease astyle. */
3047 typedef enum spdk_nvme_path_status_code spdk_nvme_path_status_code_t;
3048 
3049 static spdk_nvme_path_status_code_t
3050 _nvme_ana_state_to_path_status(enum spdk_nvme_ana_state ana_state)
3051 {
3052 	switch (ana_state) {
3053 	case SPDK_NVME_ANA_INACCESSIBLE_STATE:
3054 		return SPDK_NVME_SC_ASYMMETRIC_ACCESS_INACCESSIBLE;
3055 	case SPDK_NVME_ANA_PERSISTENT_LOSS_STATE:
3056 		return SPDK_NVME_SC_ASYMMETRIC_ACCESS_PERSISTENT_LOSS;
3057 	case SPDK_NVME_ANA_CHANGE_STATE:
3058 		return SPDK_NVME_SC_ASYMMETRIC_ACCESS_TRANSITION;
3059 	default:
3060 		return SPDK_NVME_SC_INTERNAL_PATH_ERROR;
3061 	}
3062 }
3063 
3064 static int
3065 nvmf_ctrlr_get_features(struct spdk_nvmf_request *req)
3066 {
3067 	uint8_t feature;
3068 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
3069 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
3070 	struct spdk_nvme_cpl *response = &req->rsp->nvme_cpl;
3071 	enum spdk_nvme_ana_state ana_state;
3072 
3073 	feature = cmd->cdw10_bits.get_features.fid;
3074 
3075 	if (ctrlr->subsys->subtype == SPDK_NVMF_SUBTYPE_DISCOVERY) {
3076 		/*
3077 		 * Features supported by Discovery controller
3078 		 */
3079 		switch (feature) {
3080 		case SPDK_NVME_FEAT_KEEP_ALIVE_TIMER:
3081 			return get_features_generic(req, ctrlr->feat.keep_alive_timer.raw);
3082 		case SPDK_NVME_FEAT_ASYNC_EVENT_CONFIGURATION:
3083 			return get_features_generic(req, ctrlr->feat.async_event_configuration.raw);
3084 		default:
3085 			SPDK_INFOLOG(nvmf, "Get Features command with unsupported feature ID 0x%02x\n", feature);
3086 			response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
3087 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3088 		}
3089 	}
3090 	/*
3091 	 * Process Get Features command for non-discovery controller
3092 	 */
3093 	ana_state = nvmf_ctrlr_get_ana_state_from_nsid(ctrlr, cmd->nsid);
3094 	switch (ana_state) {
3095 	case SPDK_NVME_ANA_INACCESSIBLE_STATE:
3096 	case SPDK_NVME_ANA_PERSISTENT_LOSS_STATE:
3097 	case SPDK_NVME_ANA_CHANGE_STATE:
3098 		switch (feature) {
3099 		case SPDK_NVME_FEAT_ERROR_RECOVERY:
3100 		case SPDK_NVME_FEAT_WRITE_ATOMICITY:
3101 		case SPDK_NVME_FEAT_HOST_RESERVE_MASK:
3102 		case SPDK_NVME_FEAT_HOST_RESERVE_PERSIST:
3103 			response->status.sct = SPDK_NVME_SCT_PATH;
3104 			response->status.sc = _nvme_ana_state_to_path_status(ana_state);
3105 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3106 		default:
3107 			break;
3108 		}
3109 		break;
3110 	default:
3111 		break;
3112 	}
3113 
3114 	switch (feature) {
3115 	case SPDK_NVME_FEAT_ARBITRATION:
3116 		return get_features_generic(req, ctrlr->feat.arbitration.raw);
3117 	case SPDK_NVME_FEAT_POWER_MANAGEMENT:
3118 		return get_features_generic(req, ctrlr->feat.power_management.raw);
3119 	case SPDK_NVME_FEAT_TEMPERATURE_THRESHOLD:
3120 		return nvmf_ctrlr_get_features_temperature_threshold(req);
3121 	case SPDK_NVME_FEAT_ERROR_RECOVERY:
3122 		return get_features_generic(req, ctrlr->feat.error_recovery.raw);
3123 	case SPDK_NVME_FEAT_VOLATILE_WRITE_CACHE:
3124 		return get_features_generic(req, ctrlr->feat.volatile_write_cache.raw);
3125 	case SPDK_NVME_FEAT_NUMBER_OF_QUEUES:
3126 		return get_features_generic(req, ctrlr->feat.number_of_queues.raw);
3127 	case SPDK_NVME_FEAT_INTERRUPT_COALESCING:
3128 		return get_features_generic(req, ctrlr->feat.interrupt_coalescing.raw);
3129 	case SPDK_NVME_FEAT_INTERRUPT_VECTOR_CONFIGURATION:
3130 		return nvmf_ctrlr_get_features_interrupt_vector_configuration(req);
3131 	case SPDK_NVME_FEAT_WRITE_ATOMICITY:
3132 		return get_features_generic(req, ctrlr->feat.write_atomicity.raw);
3133 	case SPDK_NVME_FEAT_ASYNC_EVENT_CONFIGURATION:
3134 		return get_features_generic(req, ctrlr->feat.async_event_configuration.raw);
3135 	case SPDK_NVME_FEAT_KEEP_ALIVE_TIMER:
3136 		return get_features_generic(req, ctrlr->feat.keep_alive_timer.raw);
3137 	case SPDK_NVME_FEAT_HOST_IDENTIFIER:
3138 		return nvmf_ctrlr_get_features_host_identifier(req);
3139 	case SPDK_NVME_FEAT_HOST_RESERVE_MASK:
3140 		return nvmf_ctrlr_get_features_reservation_notification_mask(req);
3141 	case SPDK_NVME_FEAT_HOST_RESERVE_PERSIST:
3142 		return nvmf_ctrlr_get_features_reservation_persistence(req);
3143 	case SPDK_NVME_FEAT_HOST_BEHAVIOR_SUPPORT:
3144 		return nvmf_ctrlr_get_features_host_behavior_support(req);
3145 	default:
3146 		SPDK_INFOLOG(nvmf, "Get Features command with unsupported feature ID 0x%02x\n", feature);
3147 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
3148 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3149 	}
3150 }
3151 
3152 static int
3153 nvmf_ctrlr_set_features(struct spdk_nvmf_request *req)
3154 {
3155 	uint8_t feature, save;
3156 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
3157 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
3158 	struct spdk_nvme_cpl *response = &req->rsp->nvme_cpl;
3159 	enum spdk_nvme_ana_state ana_state;
3160 	/*
3161 	 * Features are not saveable by the controller as indicated by
3162 	 * ONCS field of the Identify Controller data.
3163 	 * */
3164 	save = cmd->cdw10_bits.set_features.sv;
3165 	if (save) {
3166 		response->status.sc = SPDK_NVME_SC_FEATURE_ID_NOT_SAVEABLE;
3167 		response->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
3168 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3169 	}
3170 
3171 	feature = cmd->cdw10_bits.set_features.fid;
3172 
3173 	if (ctrlr->subsys->subtype == SPDK_NVMF_SUBTYPE_DISCOVERY) {
3174 		/*
3175 		 * Features supported by Discovery controller
3176 		 */
3177 		switch (feature) {
3178 		case SPDK_NVME_FEAT_KEEP_ALIVE_TIMER:
3179 			return nvmf_ctrlr_set_features_keep_alive_timer(req);
3180 		case SPDK_NVME_FEAT_ASYNC_EVENT_CONFIGURATION:
3181 			return nvmf_ctrlr_set_features_async_event_configuration(req);
3182 		default:
3183 			SPDK_INFOLOG(nvmf, "Set Features command with unsupported feature ID 0x%02x\n", feature);
3184 			response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
3185 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3186 		}
3187 	}
3188 	/*
3189 	 * Process Set Features command for non-discovery controller
3190 	 */
3191 	ana_state = nvmf_ctrlr_get_ana_state_from_nsid(ctrlr, cmd->nsid);
3192 	switch (ana_state) {
3193 	case SPDK_NVME_ANA_INACCESSIBLE_STATE:
3194 	case SPDK_NVME_ANA_CHANGE_STATE:
3195 		if (cmd->nsid == SPDK_NVME_GLOBAL_NS_TAG) {
3196 			response->status.sct = SPDK_NVME_SCT_PATH;
3197 			response->status.sc = _nvme_ana_state_to_path_status(ana_state);
3198 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3199 		} else {
3200 			switch (feature) {
3201 			case SPDK_NVME_FEAT_ERROR_RECOVERY:
3202 			case SPDK_NVME_FEAT_WRITE_ATOMICITY:
3203 			case SPDK_NVME_FEAT_HOST_RESERVE_MASK:
3204 			case SPDK_NVME_FEAT_HOST_RESERVE_PERSIST:
3205 				response->status.sct = SPDK_NVME_SCT_PATH;
3206 				response->status.sc = _nvme_ana_state_to_path_status(ana_state);
3207 				return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3208 			default:
3209 				break;
3210 			}
3211 		}
3212 		break;
3213 	case SPDK_NVME_ANA_PERSISTENT_LOSS_STATE:
3214 		response->status.sct = SPDK_NVME_SCT_PATH;
3215 		response->status.sc = SPDK_NVME_SC_ASYMMETRIC_ACCESS_PERSISTENT_LOSS;
3216 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3217 	default:
3218 		break;
3219 	}
3220 
3221 	switch (feature) {
3222 	case SPDK_NVME_FEAT_ARBITRATION:
3223 		return nvmf_ctrlr_set_features_arbitration(req);
3224 	case SPDK_NVME_FEAT_POWER_MANAGEMENT:
3225 		return nvmf_ctrlr_set_features_power_management(req);
3226 	case SPDK_NVME_FEAT_TEMPERATURE_THRESHOLD:
3227 		return nvmf_ctrlr_set_features_temperature_threshold(req);
3228 	case SPDK_NVME_FEAT_ERROR_RECOVERY:
3229 		return nvmf_ctrlr_set_features_error_recovery(req);
3230 	case SPDK_NVME_FEAT_VOLATILE_WRITE_CACHE:
3231 		return nvmf_ctrlr_set_features_volatile_write_cache(req);
3232 	case SPDK_NVME_FEAT_NUMBER_OF_QUEUES:
3233 		return nvmf_ctrlr_set_features_number_of_queues(req);
3234 	case SPDK_NVME_FEAT_INTERRUPT_COALESCING:
3235 		response->status.sct = SPDK_NVME_SCT_COMMAND_SPECIFIC;
3236 		response->status.sc = SPDK_NVME_SC_FEATURE_NOT_CHANGEABLE;
3237 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3238 	case SPDK_NVME_FEAT_WRITE_ATOMICITY:
3239 		return nvmf_ctrlr_set_features_write_atomicity(req);
3240 	case SPDK_NVME_FEAT_ASYNC_EVENT_CONFIGURATION:
3241 		return nvmf_ctrlr_set_features_async_event_configuration(req);
3242 	case SPDK_NVME_FEAT_KEEP_ALIVE_TIMER:
3243 		return nvmf_ctrlr_set_features_keep_alive_timer(req);
3244 	case SPDK_NVME_FEAT_HOST_IDENTIFIER:
3245 		return nvmf_ctrlr_set_features_host_identifier(req);
3246 	case SPDK_NVME_FEAT_HOST_RESERVE_MASK:
3247 		return nvmf_ctrlr_set_features_reservation_notification_mask(req);
3248 	case SPDK_NVME_FEAT_HOST_RESERVE_PERSIST:
3249 		return nvmf_ctrlr_set_features_reservation_persistence(req);
3250 	case SPDK_NVME_FEAT_HOST_BEHAVIOR_SUPPORT:
3251 		return nvmf_ctrlr_set_features_host_behavior_support(req);
3252 	default:
3253 		SPDK_INFOLOG(nvmf, "Set Features command with unsupported feature ID 0x%02x\n", feature);
3254 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
3255 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3256 	}
3257 }
3258 
3259 static int
3260 nvmf_ctrlr_keep_alive(struct spdk_nvmf_request *req)
3261 {
3262 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
3263 
3264 	SPDK_DEBUGLOG(nvmf, "Keep Alive\n");
3265 	/*
3266 	 * To handle keep alive just clear or reset the
3267 	 * ctrlr based keep alive duration counter.
3268 	 * When added, a separate timer based process
3269 	 * will monitor if the time since last recorded
3270 	 * keep alive has exceeded the max duration and
3271 	 * take appropriate action.
3272 	 */
3273 	ctrlr->last_keep_alive_tick = spdk_get_ticks();
3274 
3275 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3276 }
3277 
3278 int
3279 nvmf_ctrlr_process_admin_cmd(struct spdk_nvmf_request *req)
3280 {
3281 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
3282 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
3283 	struct spdk_nvme_cpl *response = &req->rsp->nvme_cpl;
3284 	int rc;
3285 
3286 	if (ctrlr == NULL) {
3287 		SPDK_ERRLOG("Admin command sent before CONNECT\n");
3288 		response->status.sct = SPDK_NVME_SCT_GENERIC;
3289 		response->status.sc = SPDK_NVME_SC_COMMAND_SEQUENCE_ERROR;
3290 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3291 	}
3292 
3293 	assert(spdk_get_thread() == ctrlr->thread);
3294 
3295 	if (cmd->fuse != 0) {
3296 		/* Fused admin commands are not supported. */
3297 		response->status.sct = SPDK_NVME_SCT_GENERIC;
3298 		response->status.sc = SPDK_NVME_SC_INVALID_FIELD;
3299 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3300 	}
3301 
3302 	if (ctrlr->vcprop.cc.bits.en != 1) {
3303 		SPDK_ERRLOG("Admin command sent to disabled controller\n");
3304 		response->status.sct = SPDK_NVME_SCT_GENERIC;
3305 		response->status.sc = SPDK_NVME_SC_COMMAND_SEQUENCE_ERROR;
3306 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3307 	}
3308 
3309 	if (req->data && spdk_nvme_opc_get_data_transfer(cmd->opc) == SPDK_NVME_DATA_CONTROLLER_TO_HOST) {
3310 		_clear_iovs(req->iov, req->iovcnt);
3311 	}
3312 
3313 	if (ctrlr->subsys->subtype == SPDK_NVMF_SUBTYPE_DISCOVERY) {
3314 		/* Discovery controllers only support these admin OPS. */
3315 		switch (cmd->opc) {
3316 		case SPDK_NVME_OPC_IDENTIFY:
3317 		case SPDK_NVME_OPC_GET_LOG_PAGE:
3318 		case SPDK_NVME_OPC_KEEP_ALIVE:
3319 		case SPDK_NVME_OPC_SET_FEATURES:
3320 		case SPDK_NVME_OPC_GET_FEATURES:
3321 		case SPDK_NVME_OPC_ASYNC_EVENT_REQUEST:
3322 			break;
3323 		default:
3324 			goto invalid_opcode;
3325 		}
3326 	}
3327 
3328 	/* Call a custom adm cmd handler if set. Aborts are handled in a different path (see nvmf_passthru_admin_cmd) */
3329 	if (g_nvmf_custom_admin_cmd_hdlrs[cmd->opc].hdlr && cmd->opc != SPDK_NVME_OPC_ABORT) {
3330 		rc = g_nvmf_custom_admin_cmd_hdlrs[cmd->opc].hdlr(req);
3331 		if (rc >= SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE) {
3332 			/* The handler took care of this command */
3333 			return rc;
3334 		}
3335 	}
3336 
3337 	switch (cmd->opc) {
3338 	case SPDK_NVME_OPC_GET_LOG_PAGE:
3339 		return nvmf_ctrlr_get_log_page(req);
3340 	case SPDK_NVME_OPC_IDENTIFY:
3341 		return nvmf_ctrlr_identify(req);
3342 	case SPDK_NVME_OPC_ABORT:
3343 		return nvmf_ctrlr_abort(req);
3344 	case SPDK_NVME_OPC_GET_FEATURES:
3345 		return nvmf_ctrlr_get_features(req);
3346 	case SPDK_NVME_OPC_SET_FEATURES:
3347 		return nvmf_ctrlr_set_features(req);
3348 	case SPDK_NVME_OPC_ASYNC_EVENT_REQUEST:
3349 		return nvmf_ctrlr_async_event_request(req);
3350 	case SPDK_NVME_OPC_KEEP_ALIVE:
3351 		return nvmf_ctrlr_keep_alive(req);
3352 
3353 	case SPDK_NVME_OPC_CREATE_IO_SQ:
3354 	case SPDK_NVME_OPC_CREATE_IO_CQ:
3355 	case SPDK_NVME_OPC_DELETE_IO_SQ:
3356 	case SPDK_NVME_OPC_DELETE_IO_CQ:
3357 		/* Create and Delete I/O CQ/SQ not allowed in NVMe-oF */
3358 		goto invalid_opcode;
3359 
3360 	default:
3361 		goto invalid_opcode;
3362 	}
3363 
3364 invalid_opcode:
3365 	SPDK_INFOLOG(nvmf, "Unsupported admin opcode 0x%x\n", cmd->opc);
3366 	response->status.sct = SPDK_NVME_SCT_GENERIC;
3367 	response->status.sc = SPDK_NVME_SC_INVALID_OPCODE;
3368 	return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3369 }
3370 
3371 static int
3372 nvmf_ctrlr_process_fabrics_cmd(struct spdk_nvmf_request *req)
3373 {
3374 	struct spdk_nvmf_qpair *qpair = req->qpair;
3375 	struct spdk_nvmf_capsule_cmd *cap_hdr;
3376 
3377 	cap_hdr = &req->cmd->nvmf_cmd;
3378 
3379 	if (qpair->ctrlr == NULL) {
3380 		/* No ctrlr established yet; the only valid command is Connect */
3381 		if (cap_hdr->fctype == SPDK_NVMF_FABRIC_COMMAND_CONNECT) {
3382 			return nvmf_ctrlr_cmd_connect(req);
3383 		} else {
3384 			SPDK_DEBUGLOG(nvmf, "Got fctype 0x%x, expected Connect\n",
3385 				      cap_hdr->fctype);
3386 			req->rsp->nvme_cpl.status.sct = SPDK_NVME_SCT_GENERIC;
3387 			req->rsp->nvme_cpl.status.sc = SPDK_NVME_SC_COMMAND_SEQUENCE_ERROR;
3388 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3389 		}
3390 	} else if (nvmf_qpair_is_admin_queue(qpair)) {
3391 		/*
3392 		 * Controller session is established, and this is an admin queue.
3393 		 * Disallow Connect and allow other fabrics commands.
3394 		 */
3395 		switch (cap_hdr->fctype) {
3396 		case SPDK_NVMF_FABRIC_COMMAND_PROPERTY_SET:
3397 			return nvmf_property_set(req);
3398 		case SPDK_NVMF_FABRIC_COMMAND_PROPERTY_GET:
3399 			return nvmf_property_get(req);
3400 		default:
3401 			SPDK_DEBUGLOG(nvmf, "unknown fctype 0x%02x\n",
3402 				      cap_hdr->fctype);
3403 			req->rsp->nvme_cpl.status.sct = SPDK_NVME_SCT_GENERIC;
3404 			req->rsp->nvme_cpl.status.sc = SPDK_NVME_SC_INVALID_OPCODE;
3405 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3406 		}
3407 	} else {
3408 		/* Controller session is established, and this is an I/O queue */
3409 		/* For now, no I/O-specific Fabrics commands are implemented (other than Connect) */
3410 		SPDK_DEBUGLOG(nvmf, "Unexpected I/O fctype 0x%x\n", cap_hdr->fctype);
3411 		req->rsp->nvme_cpl.status.sct = SPDK_NVME_SCT_GENERIC;
3412 		req->rsp->nvme_cpl.status.sc = SPDK_NVME_SC_INVALID_OPCODE;
3413 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3414 	}
3415 }
3416 
3417 static inline void
3418 nvmf_ctrlr_queue_pending_async_event(struct spdk_nvmf_ctrlr *ctrlr,
3419 				     union spdk_nvme_async_event_completion *event)
3420 {
3421 	struct spdk_nvmf_async_event_completion *nvmf_event;
3422 
3423 	nvmf_event = calloc(1, sizeof(*nvmf_event));
3424 	if (!nvmf_event) {
3425 		SPDK_ERRLOG("Alloc nvmf event failed, ignore the event\n");
3426 		return;
3427 	}
3428 	nvmf_event->event.raw = event->raw;
3429 	STAILQ_INSERT_TAIL(&ctrlr->async_events, nvmf_event, link);
3430 }
3431 
3432 static inline int
3433 nvmf_ctrlr_async_event_notification(struct spdk_nvmf_ctrlr *ctrlr,
3434 				    union spdk_nvme_async_event_completion *event)
3435 {
3436 	struct spdk_nvmf_request *req;
3437 	struct spdk_nvme_cpl *rsp;
3438 
3439 	assert(spdk_get_thread() == ctrlr->thread);
3440 
3441 	/* If there is no outstanding AER request, queue the event.  Then
3442 	 * if an AER is later submitted, this event can be sent as a
3443 	 * response.
3444 	 */
3445 	if (ctrlr->nr_aer_reqs == 0) {
3446 		nvmf_ctrlr_queue_pending_async_event(ctrlr, event);
3447 		return 0;
3448 	}
3449 
3450 	req = ctrlr->aer_req[--ctrlr->nr_aer_reqs];
3451 	rsp = &req->rsp->nvme_cpl;
3452 
3453 	rsp->cdw0 = event->raw;
3454 
3455 	_nvmf_request_complete(req);
3456 	ctrlr->aer_req[ctrlr->nr_aer_reqs] = NULL;
3457 
3458 	return 0;
3459 }
3460 
3461 int
3462 nvmf_ctrlr_async_event_ns_notice(struct spdk_nvmf_ctrlr *ctrlr)
3463 {
3464 	union spdk_nvme_async_event_completion event = {0};
3465 
3466 	/* Users may disable the event notification */
3467 	if (!ctrlr->feat.async_event_configuration.bits.ns_attr_notice) {
3468 		return 0;
3469 	}
3470 
3471 	if (!nvmf_ctrlr_mask_aen(ctrlr, SPDK_NVME_ASYNC_EVENT_NS_ATTR_CHANGE_MASK_BIT)) {
3472 		return 0;
3473 	}
3474 
3475 	event.bits.async_event_type = SPDK_NVME_ASYNC_EVENT_TYPE_NOTICE;
3476 	event.bits.async_event_info = SPDK_NVME_ASYNC_EVENT_NS_ATTR_CHANGED;
3477 	event.bits.log_page_identifier = SPDK_NVME_LOG_CHANGED_NS_LIST;
3478 
3479 	return nvmf_ctrlr_async_event_notification(ctrlr, &event);
3480 }
3481 
3482 int
3483 nvmf_ctrlr_async_event_ana_change_notice(struct spdk_nvmf_ctrlr *ctrlr)
3484 {
3485 	union spdk_nvme_async_event_completion event = {0};
3486 
3487 	/* Users may disable the event notification */
3488 	if (!ctrlr->feat.async_event_configuration.bits.ana_change_notice) {
3489 		return 0;
3490 	}
3491 
3492 	if (!nvmf_ctrlr_mask_aen(ctrlr, SPDK_NVME_ASYNC_EVENT_ANA_CHANGE_MASK_BIT)) {
3493 		return 0;
3494 	}
3495 
3496 	event.bits.async_event_type = SPDK_NVME_ASYNC_EVENT_TYPE_NOTICE;
3497 	event.bits.async_event_info = SPDK_NVME_ASYNC_EVENT_ANA_CHANGE;
3498 	event.bits.log_page_identifier = SPDK_NVME_LOG_ASYMMETRIC_NAMESPACE_ACCESS;
3499 
3500 	return nvmf_ctrlr_async_event_notification(ctrlr, &event);
3501 }
3502 
3503 void
3504 nvmf_ctrlr_async_event_reservation_notification(struct spdk_nvmf_ctrlr *ctrlr)
3505 {
3506 	union spdk_nvme_async_event_completion event = {0};
3507 
3508 	if (!ctrlr->num_avail_log_pages) {
3509 		return;
3510 	}
3511 
3512 	if (!nvmf_ctrlr_mask_aen(ctrlr, SPDK_NVME_ASYNC_EVENT_RESERVATION_LOG_AVAIL_MASK_BIT)) {
3513 		return;
3514 	}
3515 
3516 	event.bits.async_event_type = SPDK_NVME_ASYNC_EVENT_TYPE_IO;
3517 	event.bits.async_event_info = SPDK_NVME_ASYNC_EVENT_RESERVATION_LOG_AVAIL;
3518 	event.bits.log_page_identifier = SPDK_NVME_LOG_RESERVATION_NOTIFICATION;
3519 
3520 	nvmf_ctrlr_async_event_notification(ctrlr, &event);
3521 }
3522 
3523 void
3524 nvmf_ctrlr_async_event_discovery_log_change_notice(void *ctx)
3525 {
3526 	union spdk_nvme_async_event_completion event = {0};
3527 	struct spdk_nvmf_ctrlr *ctrlr = ctx;
3528 
3529 	/* Users may disable the event notification manually or
3530 	 * it may not be enabled due to keep alive timeout
3531 	 * not being set in connect command to discovery controller.
3532 	 */
3533 	if (!ctrlr->feat.async_event_configuration.bits.discovery_log_change_notice) {
3534 		return;
3535 	}
3536 
3537 	if (!nvmf_ctrlr_mask_aen(ctrlr, SPDK_NVME_ASYNC_EVENT_DISCOVERY_LOG_CHANGE_MASK_BIT)) {
3538 		return;
3539 	}
3540 
3541 	event.bits.async_event_type = SPDK_NVME_ASYNC_EVENT_TYPE_NOTICE;
3542 	event.bits.async_event_info = SPDK_NVME_ASYNC_EVENT_DISCOVERY_LOG_CHANGE;
3543 	event.bits.log_page_identifier = SPDK_NVME_LOG_DISCOVERY;
3544 
3545 	nvmf_ctrlr_async_event_notification(ctrlr, &event);
3546 }
3547 
3548 int
3549 nvmf_ctrlr_async_event_error_event(struct spdk_nvmf_ctrlr *ctrlr,
3550 				   union spdk_nvme_async_event_completion event)
3551 {
3552 	if (!nvmf_ctrlr_mask_aen(ctrlr, SPDK_NVME_ASYNC_EVENT_ERROR_MASK_BIT)) {
3553 		return 0;
3554 	}
3555 
3556 	if (event.bits.async_event_type != SPDK_NVME_ASYNC_EVENT_TYPE_ERROR ||
3557 	    event.bits.async_event_info > SPDK_NVME_ASYNC_EVENT_FW_IMAGE_LOAD) {
3558 		return 0;
3559 	}
3560 
3561 	return nvmf_ctrlr_async_event_notification(ctrlr, &event);
3562 }
3563 
3564 void
3565 nvmf_qpair_free_aer(struct spdk_nvmf_qpair *qpair)
3566 {
3567 	struct spdk_nvmf_ctrlr *ctrlr = qpair->ctrlr;
3568 	int i;
3569 
3570 	if (!nvmf_qpair_is_admin_queue(qpair)) {
3571 		return;
3572 	}
3573 
3574 	assert(spdk_get_thread() == ctrlr->thread);
3575 
3576 	for (i = 0; i < ctrlr->nr_aer_reqs; i++) {
3577 		spdk_nvmf_request_free(ctrlr->aer_req[i]);
3578 		ctrlr->aer_req[i] = NULL;
3579 	}
3580 
3581 	ctrlr->nr_aer_reqs = 0;
3582 }
3583 
3584 void
3585 nvmf_ctrlr_abort_aer(struct spdk_nvmf_ctrlr *ctrlr)
3586 {
3587 	struct spdk_nvmf_request *req;
3588 	int i;
3589 
3590 	assert(spdk_get_thread() == ctrlr->thread);
3591 
3592 	if (!ctrlr->nr_aer_reqs) {
3593 		return;
3594 	}
3595 
3596 	for (i = 0; i < ctrlr->nr_aer_reqs; i++) {
3597 		req = ctrlr->aer_req[i];
3598 
3599 		req->rsp->nvme_cpl.status.sct = SPDK_NVME_SCT_GENERIC;
3600 		req->rsp->nvme_cpl.status.sc = SPDK_NVME_SC_ABORTED_BY_REQUEST;
3601 		_nvmf_request_complete(req);
3602 
3603 		ctrlr->aer_req[i] = NULL;
3604 	}
3605 
3606 	ctrlr->nr_aer_reqs = 0;
3607 }
3608 
3609 static void
3610 _nvmf_ctrlr_add_reservation_log(void *ctx)
3611 {
3612 	struct spdk_nvmf_reservation_log *log = (struct spdk_nvmf_reservation_log *)ctx;
3613 	struct spdk_nvmf_ctrlr *ctrlr = log->ctrlr;
3614 
3615 	ctrlr->log_page_count++;
3616 
3617 	/* Maximum number of queued log pages is 255 */
3618 	if (ctrlr->num_avail_log_pages == 0xff) {
3619 		struct spdk_nvmf_reservation_log *entry;
3620 		entry = TAILQ_LAST(&ctrlr->log_head, log_page_head);
3621 		entry->log.log_page_count = ctrlr->log_page_count;
3622 		free(log);
3623 		return;
3624 	}
3625 
3626 	log->log.log_page_count = ctrlr->log_page_count;
3627 	log->log.num_avail_log_pages = ctrlr->num_avail_log_pages++;
3628 	TAILQ_INSERT_TAIL(&ctrlr->log_head, log, link);
3629 
3630 	nvmf_ctrlr_async_event_reservation_notification(ctrlr);
3631 }
3632 
3633 void
3634 nvmf_ctrlr_reservation_notice_log(struct spdk_nvmf_ctrlr *ctrlr,
3635 				  struct spdk_nvmf_ns *ns,
3636 				  enum spdk_nvme_reservation_notification_log_page_type type)
3637 {
3638 	struct spdk_nvmf_reservation_log *log;
3639 
3640 	switch (type) {
3641 	case SPDK_NVME_RESERVATION_LOG_PAGE_EMPTY:
3642 		return;
3643 	case SPDK_NVME_REGISTRATION_PREEMPTED:
3644 		if (ns->mask & SPDK_NVME_REGISTRATION_PREEMPTED_MASK) {
3645 			return;
3646 		}
3647 		break;
3648 	case SPDK_NVME_RESERVATION_RELEASED:
3649 		if (ns->mask & SPDK_NVME_RESERVATION_RELEASED_MASK) {
3650 			return;
3651 		}
3652 		break;
3653 	case SPDK_NVME_RESERVATION_PREEMPTED:
3654 		if (ns->mask & SPDK_NVME_RESERVATION_PREEMPTED_MASK) {
3655 			return;
3656 		}
3657 		break;
3658 	default:
3659 		return;
3660 	}
3661 
3662 	log = calloc(1, sizeof(*log));
3663 	if (!log) {
3664 		SPDK_ERRLOG("Alloc log page failed, ignore the log\n");
3665 		return;
3666 	}
3667 	log->ctrlr = ctrlr;
3668 	log->log.type = type;
3669 	log->log.nsid = ns->nsid;
3670 
3671 	spdk_thread_send_msg(ctrlr->thread, _nvmf_ctrlr_add_reservation_log, log);
3672 }
3673 
3674 /* Check from subsystem poll group's namespace information data structure */
3675 static bool
3676 nvmf_ns_info_ctrlr_is_registrant(struct spdk_nvmf_subsystem_pg_ns_info *ns_info,
3677 				 struct spdk_nvmf_ctrlr *ctrlr)
3678 {
3679 	uint32_t i;
3680 
3681 	for (i = 0; i < SPDK_NVMF_MAX_NUM_REGISTRANTS; i++) {
3682 		if (!spdk_uuid_compare(&ns_info->reg_hostid[i], &ctrlr->hostid)) {
3683 			return true;
3684 		}
3685 	}
3686 
3687 	return false;
3688 }
3689 
3690 /*
3691  * Check the NVMe command is permitted or not for current controller(Host).
3692  */
3693 static int
3694 nvmf_ns_reservation_request_check(struct spdk_nvmf_subsystem_pg_ns_info *ns_info,
3695 				  struct spdk_nvmf_ctrlr *ctrlr,
3696 				  struct spdk_nvmf_request *req)
3697 {
3698 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
3699 	enum spdk_nvme_reservation_type rtype = ns_info->rtype;
3700 	uint8_t status = SPDK_NVME_SC_SUCCESS;
3701 	uint8_t racqa;
3702 	bool is_registrant;
3703 
3704 	/* No valid reservation */
3705 	if (!rtype) {
3706 		return 0;
3707 	}
3708 
3709 	is_registrant = nvmf_ns_info_ctrlr_is_registrant(ns_info, ctrlr);
3710 	/* All registrants type and current ctrlr is a valid registrant */
3711 	if ((rtype == SPDK_NVME_RESERVE_WRITE_EXCLUSIVE_ALL_REGS ||
3712 	     rtype == SPDK_NVME_RESERVE_EXCLUSIVE_ACCESS_ALL_REGS) && is_registrant) {
3713 		return 0;
3714 	} else if (!spdk_uuid_compare(&ns_info->holder_id, &ctrlr->hostid)) {
3715 		return 0;
3716 	}
3717 
3718 	/* Non-holder for current controller */
3719 	switch (cmd->opc) {
3720 	case SPDK_NVME_OPC_READ:
3721 	case SPDK_NVME_OPC_COMPARE:
3722 		if (rtype == SPDK_NVME_RESERVE_EXCLUSIVE_ACCESS) {
3723 			status = SPDK_NVME_SC_RESERVATION_CONFLICT;
3724 			goto exit;
3725 		}
3726 		if ((rtype == SPDK_NVME_RESERVE_EXCLUSIVE_ACCESS_REG_ONLY ||
3727 		     rtype == SPDK_NVME_RESERVE_EXCLUSIVE_ACCESS_ALL_REGS) && !is_registrant) {
3728 			status = SPDK_NVME_SC_RESERVATION_CONFLICT;
3729 		}
3730 		break;
3731 	case SPDK_NVME_OPC_FLUSH:
3732 	case SPDK_NVME_OPC_WRITE:
3733 	case SPDK_NVME_OPC_WRITE_UNCORRECTABLE:
3734 	case SPDK_NVME_OPC_WRITE_ZEROES:
3735 	case SPDK_NVME_OPC_DATASET_MANAGEMENT:
3736 		if (rtype == SPDK_NVME_RESERVE_WRITE_EXCLUSIVE ||
3737 		    rtype == SPDK_NVME_RESERVE_EXCLUSIVE_ACCESS) {
3738 			status = SPDK_NVME_SC_RESERVATION_CONFLICT;
3739 			goto exit;
3740 		}
3741 		if (!is_registrant) {
3742 			status = SPDK_NVME_SC_RESERVATION_CONFLICT;
3743 		}
3744 		break;
3745 	case SPDK_NVME_OPC_RESERVATION_ACQUIRE:
3746 		racqa = cmd->cdw10_bits.resv_acquire.racqa;
3747 		if (racqa == SPDK_NVME_RESERVE_ACQUIRE) {
3748 			status = SPDK_NVME_SC_RESERVATION_CONFLICT;
3749 			goto exit;
3750 		}
3751 		if (!is_registrant) {
3752 			status = SPDK_NVME_SC_RESERVATION_CONFLICT;
3753 		}
3754 		break;
3755 	case SPDK_NVME_OPC_RESERVATION_RELEASE:
3756 		if (!is_registrant) {
3757 			status = SPDK_NVME_SC_RESERVATION_CONFLICT;
3758 		}
3759 		break;
3760 	default:
3761 		break;
3762 	}
3763 
3764 exit:
3765 	req->rsp->nvme_cpl.status.sct = SPDK_NVME_SCT_GENERIC;
3766 	req->rsp->nvme_cpl.status.sc = status;
3767 	if (status == SPDK_NVME_SC_RESERVATION_CONFLICT) {
3768 		return -EPERM;
3769 	}
3770 
3771 	return 0;
3772 }
3773 
3774 static int
3775 nvmf_ctrlr_process_io_fused_cmd(struct spdk_nvmf_request *req, struct spdk_bdev *bdev,
3776 				struct spdk_bdev_desc *desc, struct spdk_io_channel *ch)
3777 {
3778 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
3779 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
3780 	struct spdk_nvmf_request *first_fused_req = req->qpair->first_fused_req;
3781 	int rc;
3782 
3783 	if (cmd->fuse == SPDK_NVME_CMD_FUSE_FIRST) {
3784 		/* first fused operation (should be compare) */
3785 		if (first_fused_req != NULL) {
3786 			struct spdk_nvme_cpl *fused_response = &first_fused_req->rsp->nvme_cpl;
3787 
3788 			SPDK_ERRLOG("Wrong sequence of fused operations\n");
3789 
3790 			/* abort req->qpair->first_fused_request and continue with new fused command */
3791 			fused_response->status.sc = SPDK_NVME_SC_ABORTED_MISSING_FUSED;
3792 			fused_response->status.sct = SPDK_NVME_SCT_GENERIC;
3793 			_nvmf_request_complete(first_fused_req);
3794 		} else if (cmd->opc != SPDK_NVME_OPC_COMPARE) {
3795 			SPDK_ERRLOG("Wrong op code of fused operations\n");
3796 			rsp->status.sct = SPDK_NVME_SCT_GENERIC;
3797 			rsp->status.sc = SPDK_NVME_SC_INVALID_OPCODE;
3798 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3799 		}
3800 
3801 		req->qpair->first_fused_req = req;
3802 		return SPDK_NVMF_REQUEST_EXEC_STATUS_ASYNCHRONOUS;
3803 	} else if (cmd->fuse == SPDK_NVME_CMD_FUSE_SECOND) {
3804 		/* second fused operation (should be write) */
3805 		if (first_fused_req == NULL) {
3806 			SPDK_ERRLOG("Wrong sequence of fused operations\n");
3807 			rsp->status.sct = SPDK_NVME_SCT_GENERIC;
3808 			rsp->status.sc = SPDK_NVME_SC_ABORTED_MISSING_FUSED;
3809 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3810 		} else if (cmd->opc != SPDK_NVME_OPC_WRITE) {
3811 			struct spdk_nvme_cpl *fused_response = &first_fused_req->rsp->nvme_cpl;
3812 
3813 			SPDK_ERRLOG("Wrong op code of fused operations\n");
3814 
3815 			/* abort req->qpair->first_fused_request and fail current command */
3816 			fused_response->status.sc = SPDK_NVME_SC_ABORTED_MISSING_FUSED;
3817 			fused_response->status.sct = SPDK_NVME_SCT_GENERIC;
3818 			_nvmf_request_complete(first_fused_req);
3819 
3820 			rsp->status.sct = SPDK_NVME_SCT_GENERIC;
3821 			rsp->status.sc = SPDK_NVME_SC_INVALID_OPCODE;
3822 			req->qpair->first_fused_req = NULL;
3823 			return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3824 		}
3825 
3826 		/* save request of first command to generate response later */
3827 		req->first_fused_req = first_fused_req;
3828 		req->qpair->first_fused_req = NULL;
3829 	} else {
3830 		SPDK_ERRLOG("Invalid fused command fuse field.\n");
3831 		rsp->status.sct = SPDK_NVME_SCT_GENERIC;
3832 		rsp->status.sc = SPDK_NVME_SC_INVALID_FIELD;
3833 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3834 	}
3835 
3836 	rc = nvmf_bdev_ctrlr_compare_and_write_cmd(bdev, desc, ch, req->first_fused_req, req);
3837 
3838 	if (rc == SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE) {
3839 		if (spdk_nvme_cpl_is_error(rsp)) {
3840 			struct spdk_nvme_cpl *fused_response = &first_fused_req->rsp->nvme_cpl;
3841 
3842 			fused_response->status = rsp->status;
3843 			rsp->status.sct = SPDK_NVME_SCT_GENERIC;
3844 			rsp->status.sc = SPDK_NVME_SC_ABORTED_FAILED_FUSED;
3845 			/* Complete first of fused commands. Second will be completed by upper layer */
3846 			_nvmf_request_complete(first_fused_req);
3847 			req->first_fused_req = NULL;
3848 		}
3849 	}
3850 
3851 	return rc;
3852 }
3853 
3854 bool
3855 nvmf_ctrlr_use_zcopy(struct spdk_nvmf_request *req)
3856 {
3857 	struct spdk_nvmf_transport *transport = req->qpair->transport;
3858 	struct spdk_nvmf_ns *ns;
3859 
3860 	assert(req->zcopy_phase == NVMF_ZCOPY_PHASE_NONE);
3861 
3862 	if (!transport->opts.zcopy) {
3863 		return false;
3864 	}
3865 
3866 	if (nvmf_qpair_is_admin_queue(req->qpair)) {
3867 		/* Admin queue */
3868 		return false;
3869 	}
3870 
3871 	if ((req->cmd->nvme_cmd.opc != SPDK_NVME_OPC_WRITE) &&
3872 	    (req->cmd->nvme_cmd.opc != SPDK_NVME_OPC_READ)) {
3873 		/* Not a READ or WRITE command */
3874 		return false;
3875 	}
3876 
3877 	if (req->cmd->nvme_cmd.fuse != SPDK_NVME_CMD_FUSE_NONE) {
3878 		/* Fused commands dont use zcopy buffers */
3879 		return false;
3880 	}
3881 
3882 	ns = _nvmf_subsystem_get_ns(req->qpair->ctrlr->subsys, req->cmd->nvme_cmd.nsid);
3883 	if (ns == NULL || ns->bdev == NULL || !ns->zcopy) {
3884 		return false;
3885 	}
3886 
3887 	req->zcopy_phase = NVMF_ZCOPY_PHASE_INIT;
3888 	return true;
3889 }
3890 
3891 void
3892 spdk_nvmf_request_zcopy_start(struct spdk_nvmf_request *req)
3893 {
3894 	assert(req->zcopy_phase == NVMF_ZCOPY_PHASE_INIT);
3895 
3896 	/* Set iovcnt to be the maximum number of iovs that the ZCOPY can use */
3897 	req->iovcnt = NVMF_REQ_MAX_BUFFERS;
3898 
3899 	spdk_nvmf_request_exec(req);
3900 }
3901 
3902 void
3903 spdk_nvmf_request_zcopy_end(struct spdk_nvmf_request *req, bool commit)
3904 {
3905 	assert(req->zcopy_phase == NVMF_ZCOPY_PHASE_EXECUTE);
3906 	req->zcopy_phase = NVMF_ZCOPY_PHASE_END_PENDING;
3907 
3908 	nvmf_bdev_ctrlr_zcopy_end(req, commit);
3909 }
3910 
3911 int
3912 nvmf_ctrlr_process_io_cmd(struct spdk_nvmf_request *req)
3913 {
3914 	uint32_t nsid;
3915 	struct spdk_nvmf_ns *ns;
3916 	struct spdk_bdev *bdev;
3917 	struct spdk_bdev_desc *desc;
3918 	struct spdk_io_channel *ch;
3919 	struct spdk_nvmf_poll_group *group = req->qpair->group;
3920 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
3921 	struct spdk_nvme_cmd *cmd = &req->cmd->nvme_cmd;
3922 	struct spdk_nvme_cpl *response = &req->rsp->nvme_cpl;
3923 	struct spdk_nvmf_subsystem_pg_ns_info *ns_info;
3924 	enum spdk_nvme_ana_state ana_state;
3925 
3926 	/* pre-set response details for this command */
3927 	response->status.sc = SPDK_NVME_SC_SUCCESS;
3928 	nsid = cmd->nsid;
3929 
3930 	if (spdk_unlikely(ctrlr == NULL)) {
3931 		SPDK_ERRLOG("I/O command sent before CONNECT\n");
3932 		response->status.sct = SPDK_NVME_SCT_GENERIC;
3933 		response->status.sc = SPDK_NVME_SC_COMMAND_SEQUENCE_ERROR;
3934 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3935 	}
3936 
3937 	if (spdk_unlikely(ctrlr->vcprop.cc.bits.en != 1)) {
3938 		SPDK_ERRLOG("I/O command sent to disabled controller\n");
3939 		response->status.sct = SPDK_NVME_SCT_GENERIC;
3940 		response->status.sc = SPDK_NVME_SC_COMMAND_SEQUENCE_ERROR;
3941 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3942 	}
3943 
3944 	ns = _nvmf_subsystem_get_ns(ctrlr->subsys, nsid);
3945 	if (ns == NULL || ns->bdev == NULL) {
3946 		SPDK_DEBUGLOG(nvmf, "Unsuccessful query for nsid %u\n", cmd->nsid);
3947 		response->status.sc = SPDK_NVME_SC_INVALID_NAMESPACE_OR_FORMAT;
3948 		response->status.dnr = 1;
3949 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3950 	}
3951 
3952 	ana_state = nvmf_ctrlr_get_ana_state(ctrlr, ns->anagrpid);
3953 	if (spdk_unlikely(ana_state != SPDK_NVME_ANA_OPTIMIZED_STATE &&
3954 			  ana_state != SPDK_NVME_ANA_NON_OPTIMIZED_STATE)) {
3955 		SPDK_DEBUGLOG(nvmf, "Fail I/O command due to ANA state %d\n",
3956 			      ana_state);
3957 		response->status.sct = SPDK_NVME_SCT_PATH;
3958 		response->status.sc = _nvme_ana_state_to_path_status(ana_state);
3959 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3960 	}
3961 
3962 	if (spdk_likely(ctrlr->listener != NULL)) {
3963 		SPDK_DTRACE_PROBE3(nvmf_request_io_exec_path, req,
3964 				   ctrlr->listener->trid->traddr,
3965 				   ctrlr->listener->trid->trsvcid);
3966 	}
3967 
3968 	/* scan-build falsely reporting dereference of null pointer */
3969 	assert(group != NULL && group->sgroups != NULL);
3970 	ns_info = &group->sgroups[ctrlr->subsys->id].ns_info[nsid - 1];
3971 	if (nvmf_ns_reservation_request_check(ns_info, ctrlr, req)) {
3972 		SPDK_DEBUGLOG(nvmf, "Reservation Conflict for nsid %u, opcode %u\n",
3973 			      cmd->nsid, cmd->opc);
3974 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
3975 	}
3976 
3977 	bdev = ns->bdev;
3978 	desc = ns->desc;
3979 	ch = ns_info->channel;
3980 
3981 	if (spdk_unlikely(cmd->fuse & SPDK_NVME_CMD_FUSE_MASK)) {
3982 		return nvmf_ctrlr_process_io_fused_cmd(req, bdev, desc, ch);
3983 	} else if (spdk_unlikely(req->qpair->first_fused_req != NULL)) {
3984 		struct spdk_nvme_cpl *fused_response = &req->qpair->first_fused_req->rsp->nvme_cpl;
3985 
3986 		SPDK_ERRLOG("Expected second of fused commands - failing first of fused commands\n");
3987 
3988 		/* abort req->qpair->first_fused_request and continue with new command */
3989 		fused_response->status.sc = SPDK_NVME_SC_ABORTED_MISSING_FUSED;
3990 		fused_response->status.sct = SPDK_NVME_SCT_GENERIC;
3991 		_nvmf_request_complete(req->qpair->first_fused_req);
3992 		req->qpair->first_fused_req = NULL;
3993 	}
3994 
3995 	if (spdk_nvmf_request_using_zcopy(req)) {
3996 		assert(req->zcopy_phase == NVMF_ZCOPY_PHASE_INIT);
3997 		return nvmf_bdev_ctrlr_zcopy_start(bdev, desc, ch, req);
3998 	} else {
3999 		switch (cmd->opc) {
4000 		case SPDK_NVME_OPC_READ:
4001 			return nvmf_bdev_ctrlr_read_cmd(bdev, desc, ch, req);
4002 		case SPDK_NVME_OPC_WRITE:
4003 			return nvmf_bdev_ctrlr_write_cmd(bdev, desc, ch, req);
4004 		case SPDK_NVME_OPC_COMPARE:
4005 			return nvmf_bdev_ctrlr_compare_cmd(bdev, desc, ch, req);
4006 		case SPDK_NVME_OPC_WRITE_ZEROES:
4007 			return nvmf_bdev_ctrlr_write_zeroes_cmd(bdev, desc, ch, req);
4008 		case SPDK_NVME_OPC_FLUSH:
4009 			return nvmf_bdev_ctrlr_flush_cmd(bdev, desc, ch, req);
4010 		case SPDK_NVME_OPC_DATASET_MANAGEMENT:
4011 			return nvmf_bdev_ctrlr_dsm_cmd(bdev, desc, ch, req);
4012 		case SPDK_NVME_OPC_RESERVATION_REGISTER:
4013 		case SPDK_NVME_OPC_RESERVATION_ACQUIRE:
4014 		case SPDK_NVME_OPC_RESERVATION_RELEASE:
4015 		case SPDK_NVME_OPC_RESERVATION_REPORT:
4016 			spdk_thread_send_msg(ctrlr->subsys->thread, nvmf_ns_reservation_request, req);
4017 			return SPDK_NVMF_REQUEST_EXEC_STATUS_ASYNCHRONOUS;
4018 		default:
4019 			return nvmf_bdev_ctrlr_nvme_passthru_io(bdev, desc, ch, req);
4020 		}
4021 	}
4022 }
4023 
4024 static void
4025 nvmf_qpair_request_cleanup(struct spdk_nvmf_qpair *qpair)
4026 {
4027 	if (qpair->state == SPDK_NVMF_QPAIR_DEACTIVATING) {
4028 		assert(qpair->state_cb != NULL);
4029 
4030 		if (TAILQ_EMPTY(&qpair->outstanding)) {
4031 			qpair->state_cb(qpair->state_cb_arg, 0);
4032 		}
4033 	}
4034 }
4035 
4036 int
4037 spdk_nvmf_request_free(struct spdk_nvmf_request *req)
4038 {
4039 	struct spdk_nvmf_qpair *qpair = req->qpair;
4040 
4041 	TAILQ_REMOVE(&qpair->outstanding, req, link);
4042 	if (nvmf_transport_req_free(req)) {
4043 		SPDK_ERRLOG("Unable to free transport level request resources.\n");
4044 	}
4045 
4046 	nvmf_qpair_request_cleanup(qpair);
4047 
4048 	return 0;
4049 }
4050 
4051 static void
4052 _nvmf_request_complete(void *ctx)
4053 {
4054 	struct spdk_nvmf_request *req = ctx;
4055 	struct spdk_nvme_cpl *rsp = &req->rsp->nvme_cpl;
4056 	struct spdk_nvmf_qpair *qpair;
4057 	struct spdk_nvmf_subsystem_poll_group *sgroup = NULL;
4058 	struct spdk_nvmf_subsystem_pg_ns_info *ns_info;
4059 	bool is_aer = false;
4060 	uint32_t nsid;
4061 	bool paused;
4062 	uint8_t opcode;
4063 
4064 	rsp->sqid = 0;
4065 	rsp->status.p = 0;
4066 	rsp->cid = req->cmd->nvme_cmd.cid;
4067 	nsid = req->cmd->nvme_cmd.nsid;
4068 	opcode = req->cmd->nvmf_cmd.opcode;
4069 
4070 	qpair = req->qpair;
4071 	if (qpair->ctrlr) {
4072 		sgroup = &qpair->group->sgroups[qpair->ctrlr->subsys->id];
4073 		assert(sgroup != NULL);
4074 		is_aer = req->cmd->nvme_cmd.opc == SPDK_NVME_OPC_ASYNC_EVENT_REQUEST;
4075 
4076 		/*
4077 		 * Set the crd value.
4078 		 * If the the IO has any error, and dnr (DoNotRetry) is not 1,
4079 		 * and ACRE is enabled, we will set the crd to 1 to select the first CRDT.
4080 		 */
4081 		if (spdk_nvme_cpl_is_error(rsp) &&
4082 		    rsp->status.dnr == 0 &&
4083 		    qpair->ctrlr->acre_enabled) {
4084 			rsp->status.crd = 1;
4085 		}
4086 	} else if (spdk_unlikely(nvmf_request_is_fabric_connect(req))) {
4087 		sgroup = nvmf_subsystem_pg_from_connect_cmd(req);
4088 	}
4089 
4090 	if (SPDK_DEBUGLOG_FLAG_ENABLED("nvmf")) {
4091 		spdk_nvme_print_completion(qpair->qid, rsp);
4092 	}
4093 
4094 	switch (req->zcopy_phase) {
4095 	case NVMF_ZCOPY_PHASE_NONE:
4096 		TAILQ_REMOVE(&qpair->outstanding, req, link);
4097 		break;
4098 	case NVMF_ZCOPY_PHASE_INIT:
4099 		if (spdk_unlikely(spdk_nvme_cpl_is_error(rsp))) {
4100 			req->zcopy_phase = NVMF_ZCOPY_PHASE_INIT_FAILED;
4101 			TAILQ_REMOVE(&qpair->outstanding, req, link);
4102 		} else {
4103 			req->zcopy_phase = NVMF_ZCOPY_PHASE_EXECUTE;
4104 		}
4105 		break;
4106 	case NVMF_ZCOPY_PHASE_EXECUTE:
4107 		break;
4108 	case NVMF_ZCOPY_PHASE_END_PENDING:
4109 		TAILQ_REMOVE(&qpair->outstanding, req, link);
4110 		req->zcopy_phase = NVMF_ZCOPY_PHASE_COMPLETE;
4111 		break;
4112 	default:
4113 		SPDK_ERRLOG("Invalid ZCOPY phase %u\n", req->zcopy_phase);
4114 		break;
4115 	}
4116 
4117 	if (nvmf_transport_req_complete(req)) {
4118 		SPDK_ERRLOG("Transport request completion error!\n");
4119 	}
4120 
4121 	/* AER cmd is an exception */
4122 	if (sgroup && !is_aer) {
4123 		if (spdk_unlikely(opcode == SPDK_NVME_OPC_FABRIC ||
4124 				  nvmf_qpair_is_admin_queue(qpair))) {
4125 			assert(sgroup->mgmt_io_outstanding > 0);
4126 			sgroup->mgmt_io_outstanding--;
4127 		} else {
4128 			if (req->zcopy_phase == NVMF_ZCOPY_PHASE_NONE ||
4129 			    req->zcopy_phase == NVMF_ZCOPY_PHASE_COMPLETE ||
4130 			    req->zcopy_phase == NVMF_ZCOPY_PHASE_INIT_FAILED) {
4131 				/* End of request */
4132 
4133 				/* NOTE: This implicitly also checks for 0, since 0 - 1 wraps around to UINT32_MAX. */
4134 				if (spdk_likely(nsid - 1 < sgroup->num_ns)) {
4135 					sgroup->ns_info[nsid - 1].io_outstanding--;
4136 				}
4137 			}
4138 		}
4139 
4140 		if (spdk_unlikely(sgroup->state == SPDK_NVMF_SUBSYSTEM_PAUSING &&
4141 				  sgroup->mgmt_io_outstanding == 0)) {
4142 			paused = true;
4143 			for (nsid = 0; nsid < sgroup->num_ns; nsid++) {
4144 				ns_info = &sgroup->ns_info[nsid];
4145 
4146 				if (ns_info->state == SPDK_NVMF_SUBSYSTEM_PAUSING &&
4147 				    ns_info->io_outstanding > 0) {
4148 					paused = false;
4149 					break;
4150 				}
4151 			}
4152 
4153 			if (paused) {
4154 				sgroup->state = SPDK_NVMF_SUBSYSTEM_PAUSED;
4155 				sgroup->cb_fn(sgroup->cb_arg, 0);
4156 				sgroup->cb_fn = NULL;
4157 				sgroup->cb_arg = NULL;
4158 			}
4159 		}
4160 
4161 	}
4162 
4163 	nvmf_qpair_request_cleanup(qpair);
4164 }
4165 
4166 int
4167 spdk_nvmf_request_complete(struct spdk_nvmf_request *req)
4168 {
4169 	struct spdk_nvmf_qpair *qpair = req->qpair;
4170 
4171 	spdk_thread_exec_msg(qpair->group->thread, _nvmf_request_complete, req);
4172 
4173 	return 0;
4174 }
4175 
4176 void
4177 spdk_nvmf_request_exec_fabrics(struct spdk_nvmf_request *req)
4178 {
4179 	struct spdk_nvmf_qpair *qpair = req->qpair;
4180 	struct spdk_nvmf_subsystem_poll_group *sgroup = NULL;
4181 	enum spdk_nvmf_request_exec_status status;
4182 
4183 	if (qpair->ctrlr) {
4184 		sgroup = &qpair->group->sgroups[qpair->ctrlr->subsys->id];
4185 	} else if (spdk_unlikely(nvmf_request_is_fabric_connect(req))) {
4186 		sgroup = nvmf_subsystem_pg_from_connect_cmd(req);
4187 	}
4188 
4189 	assert(sgroup != NULL);
4190 	sgroup->mgmt_io_outstanding++;
4191 
4192 	/* Place the request on the outstanding list so we can keep track of it */
4193 	TAILQ_INSERT_TAIL(&qpair->outstanding, req, link);
4194 
4195 	assert(req->cmd->nvmf_cmd.opcode == SPDK_NVME_OPC_FABRIC);
4196 	status = nvmf_ctrlr_process_fabrics_cmd(req);
4197 
4198 	if (status == SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE) {
4199 		_nvmf_request_complete(req);
4200 	}
4201 }
4202 
4203 static bool
4204 nvmf_check_subsystem_active(struct spdk_nvmf_request *req)
4205 {
4206 	struct spdk_nvmf_qpair *qpair = req->qpair;
4207 	struct spdk_nvmf_subsystem_poll_group *sgroup = NULL;
4208 	struct spdk_nvmf_subsystem_pg_ns_info *ns_info;
4209 	uint32_t nsid;
4210 
4211 	if (qpair->ctrlr) {
4212 		sgroup = &qpair->group->sgroups[qpair->ctrlr->subsys->id];
4213 		assert(sgroup != NULL);
4214 	} else if (spdk_unlikely(nvmf_request_is_fabric_connect(req))) {
4215 		sgroup = nvmf_subsystem_pg_from_connect_cmd(req);
4216 	}
4217 
4218 	/* Check if the subsystem is paused (if there is a subsystem) */
4219 	if (sgroup != NULL) {
4220 		if (spdk_unlikely(req->cmd->nvmf_cmd.opcode == SPDK_NVME_OPC_FABRIC ||
4221 				  nvmf_qpair_is_admin_queue(qpair))) {
4222 			if (sgroup->state != SPDK_NVMF_SUBSYSTEM_ACTIVE) {
4223 				/* The subsystem is not currently active. Queue this request. */
4224 				TAILQ_INSERT_TAIL(&sgroup->queued, req, link);
4225 				return false;
4226 			}
4227 			sgroup->mgmt_io_outstanding++;
4228 		} else {
4229 			nsid = req->cmd->nvme_cmd.nsid;
4230 
4231 			/* NOTE: This implicitly also checks for 0, since 0 - 1 wraps around to UINT32_MAX. */
4232 			if (spdk_unlikely(nsid - 1 >= sgroup->num_ns)) {
4233 				req->rsp->nvme_cpl.status.sct = SPDK_NVME_SCT_GENERIC;
4234 				req->rsp->nvme_cpl.status.sc = SPDK_NVME_SC_INVALID_NAMESPACE_OR_FORMAT;
4235 				req->rsp->nvme_cpl.status.dnr = 1;
4236 				TAILQ_INSERT_TAIL(&qpair->outstanding, req, link);
4237 				_nvmf_request_complete(req);
4238 				return false;
4239 			}
4240 
4241 			ns_info = &sgroup->ns_info[nsid - 1];
4242 			if (ns_info->channel == NULL) {
4243 				/* This can can happen if host sends I/O to a namespace that is
4244 				 * in the process of being added, but before the full addition
4245 				 * process is complete.  Report invalid namespace in that case.
4246 				 */
4247 				req->rsp->nvme_cpl.status.sct = SPDK_NVME_SCT_GENERIC;
4248 				req->rsp->nvme_cpl.status.sc = SPDK_NVME_SC_INVALID_NAMESPACE_OR_FORMAT;
4249 				req->rsp->nvme_cpl.status.dnr = 1;
4250 				TAILQ_INSERT_TAIL(&qpair->outstanding, req, link);
4251 				ns_info->io_outstanding++;
4252 				_nvmf_request_complete(req);
4253 				return false;
4254 			}
4255 
4256 			if (ns_info->state != SPDK_NVMF_SUBSYSTEM_ACTIVE) {
4257 				/* The namespace is not currently active. Queue this request. */
4258 				TAILQ_INSERT_TAIL(&sgroup->queued, req, link);
4259 				return false;
4260 			}
4261 
4262 			ns_info->io_outstanding++;
4263 		}
4264 
4265 		if (qpair->state != SPDK_NVMF_QPAIR_ACTIVE) {
4266 			req->rsp->nvme_cpl.status.sct = SPDK_NVME_SCT_GENERIC;
4267 			req->rsp->nvme_cpl.status.sc = SPDK_NVME_SC_COMMAND_SEQUENCE_ERROR;
4268 			TAILQ_INSERT_TAIL(&qpair->outstanding, req, link);
4269 			_nvmf_request_complete(req);
4270 			return false;
4271 		}
4272 	}
4273 
4274 	return true;
4275 }
4276 
4277 void
4278 spdk_nvmf_request_exec(struct spdk_nvmf_request *req)
4279 {
4280 	struct spdk_nvmf_qpair *qpair = req->qpair;
4281 	struct spdk_nvmf_transport *transport = qpair->transport;
4282 	enum spdk_nvmf_request_exec_status status;
4283 
4284 	if (!nvmf_check_subsystem_active(req)) {
4285 		return;
4286 	}
4287 
4288 	if (SPDK_DEBUGLOG_FLAG_ENABLED("nvmf")) {
4289 		spdk_nvme_print_command(qpair->qid, &req->cmd->nvme_cmd);
4290 	}
4291 
4292 	/* Place the request on the outstanding list so we can keep track of it */
4293 	TAILQ_INSERT_TAIL(&qpair->outstanding, req, link);
4294 
4295 	if (spdk_unlikely((req->cmd->nvmf_cmd.opcode == SPDK_NVME_OPC_FABRIC) &&
4296 			  spdk_nvme_trtype_is_fabrics(transport->ops->type))) {
4297 		status = nvmf_ctrlr_process_fabrics_cmd(req);
4298 	} else if (spdk_unlikely(nvmf_qpair_is_admin_queue(qpair))) {
4299 		status = nvmf_ctrlr_process_admin_cmd(req);
4300 	} else {
4301 		status = nvmf_ctrlr_process_io_cmd(req);
4302 	}
4303 
4304 	if (status == SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE) {
4305 		_nvmf_request_complete(req);
4306 	}
4307 }
4308 
4309 static bool
4310 nvmf_ctrlr_get_dif_ctx(struct spdk_nvmf_ctrlr *ctrlr, struct spdk_nvme_cmd *cmd,
4311 		       struct spdk_dif_ctx *dif_ctx)
4312 {
4313 	struct spdk_nvmf_ns *ns;
4314 	struct spdk_bdev *bdev;
4315 
4316 	if (ctrlr == NULL || cmd == NULL) {
4317 		return false;
4318 	}
4319 
4320 	ns = _nvmf_subsystem_get_ns(ctrlr->subsys, cmd->nsid);
4321 	if (ns == NULL || ns->bdev == NULL) {
4322 		return false;
4323 	}
4324 
4325 	bdev = ns->bdev;
4326 
4327 	switch (cmd->opc) {
4328 	case SPDK_NVME_OPC_READ:
4329 	case SPDK_NVME_OPC_WRITE:
4330 	case SPDK_NVME_OPC_COMPARE:
4331 		return nvmf_bdev_ctrlr_get_dif_ctx(bdev, cmd, dif_ctx);
4332 	default:
4333 		break;
4334 	}
4335 
4336 	return false;
4337 }
4338 
4339 bool
4340 spdk_nvmf_request_get_dif_ctx(struct spdk_nvmf_request *req, struct spdk_dif_ctx *dif_ctx)
4341 {
4342 	struct spdk_nvmf_qpair *qpair = req->qpair;
4343 	struct spdk_nvmf_ctrlr *ctrlr = qpair->ctrlr;
4344 
4345 	if (spdk_likely(ctrlr == NULL || !ctrlr->dif_insert_or_strip)) {
4346 		return false;
4347 	}
4348 
4349 	if (spdk_unlikely(qpair->state != SPDK_NVMF_QPAIR_ACTIVE)) {
4350 		return false;
4351 	}
4352 
4353 	if (spdk_unlikely(req->cmd->nvmf_cmd.opcode == SPDK_NVME_OPC_FABRIC)) {
4354 		return false;
4355 	}
4356 
4357 	if (spdk_unlikely(nvmf_qpair_is_admin_queue(qpair))) {
4358 		return false;
4359 	}
4360 
4361 	return nvmf_ctrlr_get_dif_ctx(ctrlr, &req->cmd->nvme_cmd, dif_ctx);
4362 }
4363 
4364 void
4365 spdk_nvmf_set_custom_admin_cmd_hdlr(uint8_t opc, spdk_nvmf_custom_cmd_hdlr hdlr)
4366 {
4367 	g_nvmf_custom_admin_cmd_hdlrs[opc].hdlr = hdlr;
4368 }
4369 
4370 static int
4371 nvmf_passthru_admin_cmd(struct spdk_nvmf_request *req)
4372 {
4373 	struct spdk_bdev *bdev;
4374 	struct spdk_bdev_desc *desc;
4375 	struct spdk_io_channel *ch;
4376 	struct spdk_nvme_cmd *cmd = spdk_nvmf_request_get_cmd(req);
4377 	struct spdk_nvme_cpl *response = spdk_nvmf_request_get_response(req);
4378 	uint32_t bdev_nsid;
4379 	int rc;
4380 
4381 	if (g_nvmf_custom_admin_cmd_hdlrs[cmd->opc].nsid == 0) {
4382 		bdev_nsid = cmd->nsid;
4383 	} else {
4384 		bdev_nsid = g_nvmf_custom_admin_cmd_hdlrs[cmd->opc].nsid;
4385 	}
4386 
4387 	rc = spdk_nvmf_request_get_bdev(bdev_nsid, req, &bdev, &desc, &ch);
4388 	if (rc) {
4389 		response->status.sct = SPDK_NVME_SCT_GENERIC;
4390 		response->status.sc = SPDK_NVME_SC_INVALID_NAMESPACE_OR_FORMAT;
4391 		return SPDK_NVMF_REQUEST_EXEC_STATUS_COMPLETE;
4392 	}
4393 	return spdk_nvmf_bdev_ctrlr_nvme_passthru_admin(bdev, desc, ch, req, NULL);
4394 }
4395 
4396 void
4397 spdk_nvmf_set_passthru_admin_cmd(uint8_t opc, uint32_t forward_nsid)
4398 {
4399 	g_nvmf_custom_admin_cmd_hdlrs[opc].hdlr = nvmf_passthru_admin_cmd;
4400 	g_nvmf_custom_admin_cmd_hdlrs[opc].nsid = forward_nsid;
4401 }
4402 
4403 int
4404 spdk_nvmf_request_get_bdev(uint32_t nsid, struct spdk_nvmf_request *req,
4405 			   struct spdk_bdev **bdev, struct spdk_bdev_desc **desc, struct spdk_io_channel **ch)
4406 {
4407 	struct spdk_nvmf_ctrlr *ctrlr = req->qpair->ctrlr;
4408 	struct spdk_nvmf_ns *ns;
4409 	struct spdk_nvmf_poll_group *group = req->qpair->group;
4410 	struct spdk_nvmf_subsystem_pg_ns_info *ns_info;
4411 
4412 	*bdev = NULL;
4413 	*desc = NULL;
4414 	*ch = NULL;
4415 
4416 	ns = _nvmf_subsystem_get_ns(ctrlr->subsys, nsid);
4417 	if (ns == NULL || ns->bdev == NULL) {
4418 		return -EINVAL;
4419 	}
4420 
4421 	assert(group != NULL && group->sgroups != NULL);
4422 	ns_info = &group->sgroups[ctrlr->subsys->id].ns_info[nsid - 1];
4423 	*bdev = ns->bdev;
4424 	*desc = ns->desc;
4425 	*ch = ns_info->channel;
4426 
4427 	return 0;
4428 }
4429 
4430 struct spdk_nvmf_ctrlr *spdk_nvmf_request_get_ctrlr(struct spdk_nvmf_request *req)
4431 {
4432 	return req->qpair->ctrlr;
4433 }
4434 
4435 struct spdk_nvme_cmd *spdk_nvmf_request_get_cmd(struct spdk_nvmf_request *req)
4436 {
4437 	return &req->cmd->nvme_cmd;
4438 }
4439 
4440 struct spdk_nvme_cpl *spdk_nvmf_request_get_response(struct spdk_nvmf_request *req)
4441 {
4442 	return &req->rsp->nvme_cpl;
4443 }
4444 
4445 struct spdk_nvmf_subsystem *spdk_nvmf_request_get_subsystem(struct spdk_nvmf_request *req)
4446 {
4447 	return req->qpair->ctrlr->subsys;
4448 }
4449 
4450 void
4451 spdk_nvmf_request_get_data(struct spdk_nvmf_request *req, void **data, uint32_t *length)
4452 {
4453 	*data = req->data;
4454 	*length = req->length;
4455 }
4456 
4457 struct spdk_nvmf_subsystem *spdk_nvmf_ctrlr_get_subsystem(struct spdk_nvmf_ctrlr *ctrlr)
4458 {
4459 	return ctrlr->subsys;
4460 }
4461 
4462 uint16_t
4463 spdk_nvmf_ctrlr_get_id(struct spdk_nvmf_ctrlr *ctrlr)
4464 {
4465 	return ctrlr->cntlid;
4466 }
4467 
4468 struct spdk_nvmf_request *spdk_nvmf_request_get_req_to_abort(struct spdk_nvmf_request *req)
4469 {
4470 	return req->req_to_abort;
4471 }
4472