xref: /spdk/module/bdev/nvme/bdev_nvme_rpc.c (revision e316ec90b21eb3fea2dfa930261266dceb1f05aa)
1 /*-
2  *   BSD LICENSE
3  *
4  *   Copyright (c) Intel Corporation. All rights reserved.
5  *   Copyright (c) 2019 Mellanox Technologies LTD. All rights reserved.
6  *
7  *   Redistribution and use in source and binary forms, with or without
8  *   modification, are permitted provided that the following conditions
9  *   are met:
10  *
11  *     * Redistributions of source code must retain the above copyright
12  *       notice, this list of conditions and the following disclaimer.
13  *     * Redistributions in binary form must reproduce the above copyright
14  *       notice, this list of conditions and the following disclaimer in
15  *       the documentation and/or other materials provided with the
16  *       distribution.
17  *     * Neither the name of Intel Corporation nor the names of its
18  *       contributors may be used to endorse or promote products derived
19  *       from this software without specific prior written permission.
20  *
21  *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22  *   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23  *   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24  *   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25  *   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26  *   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27  *   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28  *   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29  *   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30  *   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31  *   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32  */
33 
34 #include "spdk/stdinc.h"
35 
36 #include "bdev_nvme.h"
37 #include "common.h"
38 
39 #include "spdk/config.h"
40 
41 #include "spdk/string.h"
42 #include "spdk/rpc.h"
43 #include "spdk/util.h"
44 
45 #include "spdk_internal/log.h"
46 #include "spdk/bdev_module.h"
47 
48 struct open_descriptors {
49 	void *desc;
50 	struct  spdk_bdev *bdev;
51 	TAILQ_ENTRY(open_descriptors) tqlst;
52 	struct spdk_thread *thread;
53 };
54 typedef TAILQ_HEAD(, open_descriptors) open_descriptors_t;
55 
56 static int
57 rpc_decode_action_on_timeout(const struct spdk_json_val *val, void *out)
58 {
59 	enum spdk_bdev_timeout_action *action = out;
60 
61 	if (spdk_json_strequal(val, "none") == true) {
62 		*action = SPDK_BDEV_NVME_TIMEOUT_ACTION_NONE;
63 	} else if (spdk_json_strequal(val, "abort") == true) {
64 		*action = SPDK_BDEV_NVME_TIMEOUT_ACTION_ABORT;
65 	} else if (spdk_json_strequal(val, "reset") == true) {
66 		*action = SPDK_BDEV_NVME_TIMEOUT_ACTION_RESET;
67 	} else {
68 		SPDK_NOTICELOG("Invalid parameter value: action_on_timeout\n");
69 		return -EINVAL;
70 	}
71 
72 	return 0;
73 }
74 
75 static const struct spdk_json_object_decoder rpc_bdev_nvme_options_decoders[] = {
76 	{"action_on_timeout", offsetof(struct spdk_bdev_nvme_opts, action_on_timeout), rpc_decode_action_on_timeout, true},
77 	{"timeout_us", offsetof(struct spdk_bdev_nvme_opts, timeout_us), spdk_json_decode_uint64, true},
78 	{"retry_count", offsetof(struct spdk_bdev_nvme_opts, retry_count), spdk_json_decode_uint32, true},
79 	{"arbitration_burst", offsetof(struct spdk_bdev_nvme_opts, arbitration_burst), spdk_json_decode_uint32, true},
80 	{"low_priority_weight", offsetof(struct spdk_bdev_nvme_opts, low_priority_weight), spdk_json_decode_uint32, true},
81 	{"medium_priority_weight", offsetof(struct spdk_bdev_nvme_opts, medium_priority_weight), spdk_json_decode_uint32, true},
82 	{"high_priority_weight", offsetof(struct spdk_bdev_nvme_opts, high_priority_weight), spdk_json_decode_uint32, true},
83 	{"nvme_adminq_poll_period_us", offsetof(struct spdk_bdev_nvme_opts, nvme_adminq_poll_period_us), spdk_json_decode_uint64, true},
84 	{"nvme_ioq_poll_period_us", offsetof(struct spdk_bdev_nvme_opts, nvme_ioq_poll_period_us), spdk_json_decode_uint64, true},
85 	{"io_queue_requests", offsetof(struct spdk_bdev_nvme_opts, io_queue_requests), spdk_json_decode_uint32, true},
86 	{"delay_cmd_submit", offsetof(struct spdk_bdev_nvme_opts, delay_cmd_submit), spdk_json_decode_bool, true},
87 };
88 
89 static void
90 spdk_rpc_bdev_nvme_set_options(struct spdk_jsonrpc_request *request,
91 			       const struct spdk_json_val *params)
92 {
93 	struct spdk_bdev_nvme_opts opts;
94 	struct spdk_json_write_ctx *w;
95 	int rc;
96 
97 	spdk_bdev_nvme_get_opts(&opts);
98 	if (params && spdk_json_decode_object(params, rpc_bdev_nvme_options_decoders,
99 					      SPDK_COUNTOF(rpc_bdev_nvme_options_decoders),
100 					      &opts)) {
101 		SPDK_ERRLOG("spdk_json_decode_object failed\n");
102 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
103 						 "spdk_json_decode_object failed");
104 		return;
105 	}
106 
107 	rc = spdk_bdev_nvme_set_opts(&opts);
108 	if (rc) {
109 		spdk_jsonrpc_send_error_response(request, rc, spdk_strerror(-rc));
110 		return;
111 	}
112 
113 	w = spdk_jsonrpc_begin_result(request);
114 	spdk_json_write_bool(w, true);
115 	spdk_jsonrpc_end_result(request, w);
116 
117 	return;
118 }
119 SPDK_RPC_REGISTER("bdev_nvme_set_options", spdk_rpc_bdev_nvme_set_options,
120 		  SPDK_RPC_STARTUP | SPDK_RPC_RUNTIME)
121 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_set_options, set_bdev_nvme_options)
122 
123 struct rpc_bdev_nvme_hotplug {
124 	bool enabled;
125 	uint64_t period_us;
126 };
127 
128 static const struct spdk_json_object_decoder rpc_bdev_nvme_hotplug_decoders[] = {
129 	{"enable", offsetof(struct rpc_bdev_nvme_hotplug, enabled), spdk_json_decode_bool, false},
130 	{"period_us", offsetof(struct rpc_bdev_nvme_hotplug, period_us), spdk_json_decode_uint64, true},
131 };
132 
133 static void
134 rpc_bdev_nvme_set_hotplug_done(void *ctx)
135 {
136 	struct spdk_jsonrpc_request *request = ctx;
137 	struct spdk_json_write_ctx *w = spdk_jsonrpc_begin_result(request);
138 
139 	spdk_json_write_bool(w, true);
140 	spdk_jsonrpc_end_result(request, w);
141 }
142 
143 static void
144 spdk_rpc_bdev_nvme_set_hotplug(struct spdk_jsonrpc_request *request,
145 			       const struct spdk_json_val *params)
146 {
147 	struct rpc_bdev_nvme_hotplug req = {false, 0};
148 	int rc;
149 
150 	if (spdk_json_decode_object(params, rpc_bdev_nvme_hotplug_decoders,
151 				    SPDK_COUNTOF(rpc_bdev_nvme_hotplug_decoders), &req)) {
152 		SPDK_ERRLOG("spdk_json_decode_object failed\n");
153 		rc = -EINVAL;
154 		goto invalid;
155 	}
156 
157 	rc = spdk_bdev_nvme_set_hotplug(req.enabled, req.period_us, rpc_bdev_nvme_set_hotplug_done,
158 					request);
159 	if (rc) {
160 		goto invalid;
161 	}
162 
163 	return;
164 invalid:
165 	spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, spdk_strerror(-rc));
166 }
167 SPDK_RPC_REGISTER("bdev_nvme_set_hotplug", spdk_rpc_bdev_nvme_set_hotplug, SPDK_RPC_RUNTIME)
168 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_set_hotplug, set_bdev_nvme_hotplug)
169 
170 struct rpc_bdev_nvme_attach_controller {
171 	char *name;
172 	char *trtype;
173 	char *adrfam;
174 	char *traddr;
175 	char *trsvcid;
176 	char *subnqn;
177 	char *hostnqn;
178 	char *hostaddr;
179 	char *hostsvcid;
180 	bool prchk_reftag;
181 	bool prchk_guard;
182 };
183 
184 static void
185 free_rpc_bdev_nvme_attach_controller(struct rpc_bdev_nvme_attach_controller *req)
186 {
187 	free(req->name);
188 	free(req->trtype);
189 	free(req->adrfam);
190 	free(req->traddr);
191 	free(req->trsvcid);
192 	free(req->subnqn);
193 	free(req->hostnqn);
194 	free(req->hostaddr);
195 	free(req->hostsvcid);
196 }
197 
198 static const struct spdk_json_object_decoder rpc_bdev_nvme_attach_controller_decoders[] = {
199 	{"name", offsetof(struct rpc_bdev_nvme_attach_controller, name), spdk_json_decode_string},
200 	{"trtype", offsetof(struct rpc_bdev_nvme_attach_controller, trtype), spdk_json_decode_string},
201 	{"traddr", offsetof(struct rpc_bdev_nvme_attach_controller, traddr), spdk_json_decode_string},
202 
203 	{"adrfam", offsetof(struct rpc_bdev_nvme_attach_controller, adrfam), spdk_json_decode_string, true},
204 	{"trsvcid", offsetof(struct rpc_bdev_nvme_attach_controller, trsvcid), spdk_json_decode_string, true},
205 	{"subnqn", offsetof(struct rpc_bdev_nvme_attach_controller, subnqn), spdk_json_decode_string, true},
206 	{"hostnqn", offsetof(struct rpc_bdev_nvme_attach_controller, hostnqn), spdk_json_decode_string, true},
207 	{"hostaddr", offsetof(struct rpc_bdev_nvme_attach_controller, hostaddr), spdk_json_decode_string, true},
208 	{"hostsvcid", offsetof(struct rpc_bdev_nvme_attach_controller, hostsvcid), spdk_json_decode_string, true},
209 
210 	{"prchk_reftag", offsetof(struct rpc_bdev_nvme_attach_controller, prchk_reftag), spdk_json_decode_bool, true},
211 	{"prchk_guard", offsetof(struct rpc_bdev_nvme_attach_controller, prchk_guard), spdk_json_decode_bool, true}
212 };
213 
214 #define NVME_MAX_BDEVS_PER_RPC 128
215 
216 struct rpc_bdev_nvme_attach_controller_ctx {
217 	struct rpc_bdev_nvme_attach_controller req;
218 	uint32_t count;
219 	const char *names[NVME_MAX_BDEVS_PER_RPC];
220 	struct spdk_jsonrpc_request *request;
221 };
222 
223 static void
224 spdk_rpc_bdev_nvme_attach_controller_done(void *cb_ctx, size_t bdev_count, int rc)
225 {
226 	struct rpc_bdev_nvme_attach_controller_ctx *ctx = cb_ctx;
227 	struct spdk_jsonrpc_request *request = ctx->request;
228 	struct spdk_json_write_ctx *w;
229 	size_t i;
230 
231 	if (rc < 0) {
232 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters");
233 		goto exit;
234 	}
235 
236 	w = spdk_jsonrpc_begin_result(request);
237 	spdk_json_write_array_begin(w);
238 	for (i = 0; i < bdev_count; i++) {
239 		spdk_json_write_string(w, ctx->names[i]);
240 	}
241 	spdk_json_write_array_end(w);
242 	spdk_jsonrpc_end_result(request, w);
243 
244 exit:
245 	free_rpc_bdev_nvme_attach_controller(&ctx->req);
246 	free(ctx);
247 }
248 
249 static void
250 spdk_rpc_bdev_nvme_attach_controller(struct spdk_jsonrpc_request *request,
251 				     const struct spdk_json_val *params)
252 {
253 	struct rpc_bdev_nvme_attach_controller_ctx *ctx;
254 	struct spdk_nvme_transport_id trid = {};
255 	struct spdk_nvme_host_id hostid = {};
256 	uint32_t prchk_flags = 0;
257 	int rc;
258 
259 	ctx = calloc(1, sizeof(*ctx));
260 	if (!ctx) {
261 		spdk_jsonrpc_send_error_response(request, -ENOMEM, spdk_strerror(ENOMEM));
262 		return;
263 	}
264 
265 	if (spdk_json_decode_object(params, rpc_bdev_nvme_attach_controller_decoders,
266 				    SPDK_COUNTOF(rpc_bdev_nvme_attach_controller_decoders),
267 				    &ctx->req)) {
268 		SPDK_ERRLOG("spdk_json_decode_object failed\n");
269 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
270 						 "spdk_json_decode_object failed");
271 		goto cleanup;
272 	}
273 
274 	/* Parse trstring */
275 	rc = spdk_nvme_transport_id_populate_trstring(&trid, ctx->req.trtype);
276 	if (rc < 0) {
277 		SPDK_ERRLOG("Failed to parse trtype: %s\n", ctx->req.trtype);
278 		spdk_jsonrpc_send_error_response_fmt(request, -EINVAL, "Failed to parse trtype: %s",
279 						     ctx->req.trtype);
280 		goto cleanup;
281 	}
282 
283 	/* Parse trtype */
284 	rc = spdk_nvme_transport_id_parse_trtype(&trid.trtype, ctx->req.trtype);
285 	if (rc < 0) {
286 		SPDK_ERRLOG("Failed to parse trtype: %s\n", ctx->req.trtype);
287 		spdk_jsonrpc_send_error_response_fmt(request, -EINVAL, "Failed to parse trtype: %s",
288 						     ctx->req.trtype);
289 		goto cleanup;
290 	}
291 
292 	/* Parse traddr */
293 	snprintf(trid.traddr, sizeof(trid.traddr), "%s", ctx->req.traddr);
294 
295 	/* Parse adrfam */
296 	if (ctx->req.adrfam) {
297 		rc = spdk_nvme_transport_id_parse_adrfam(&trid.adrfam, ctx->req.adrfam);
298 		if (rc < 0) {
299 			SPDK_ERRLOG("Failed to parse adrfam: %s\n", ctx->req.adrfam);
300 			spdk_jsonrpc_send_error_response_fmt(request, -EINVAL, "Failed to parse adrfam: %s",
301 							     ctx->req.adrfam);
302 			goto cleanup;
303 		}
304 	}
305 
306 	/* Parse trsvcid */
307 	if (ctx->req.trsvcid) {
308 		snprintf(trid.trsvcid, sizeof(trid.trsvcid), "%s", ctx->req.trsvcid);
309 	}
310 
311 	/* Parse subnqn */
312 	if (ctx->req.subnqn) {
313 		snprintf(trid.subnqn, sizeof(trid.subnqn), "%s", ctx->req.subnqn);
314 	}
315 
316 	if (ctx->req.hostaddr) {
317 		snprintf(hostid.hostaddr, sizeof(hostid.hostaddr), "%s", ctx->req.hostaddr);
318 	}
319 
320 	if (ctx->req.hostsvcid) {
321 		snprintf(hostid.hostsvcid, sizeof(hostid.hostsvcid), "%s", ctx->req.hostsvcid);
322 	}
323 
324 	if (ctx->req.prchk_reftag) {
325 		prchk_flags |= SPDK_NVME_IO_FLAGS_PRCHK_REFTAG;
326 	}
327 
328 	if (ctx->req.prchk_guard) {
329 		prchk_flags |= SPDK_NVME_IO_FLAGS_PRCHK_GUARD;
330 	}
331 
332 	ctx->request = request;
333 	ctx->count = NVME_MAX_BDEVS_PER_RPC;
334 	rc = spdk_bdev_nvme_create(&trid, &hostid, ctx->req.name, ctx->names, ctx->count, ctx->req.hostnqn,
335 				   prchk_flags, spdk_rpc_bdev_nvme_attach_controller_done, ctx);
336 	if (rc) {
337 		spdk_jsonrpc_send_error_response(request, rc, spdk_strerror(-rc));
338 		goto cleanup;
339 	}
340 
341 	return;
342 
343 cleanup:
344 	free_rpc_bdev_nvme_attach_controller(&ctx->req);
345 	free(ctx);
346 }
347 SPDK_RPC_REGISTER("bdev_nvme_attach_controller", spdk_rpc_bdev_nvme_attach_controller,
348 		  SPDK_RPC_RUNTIME)
349 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_attach_controller, construct_nvme_bdev)
350 
351 static void
352 spdk_rpc_dump_nvme_controller_info(struct spdk_json_write_ctx *w,
353 				   struct nvme_bdev_ctrlr *nvme_bdev_ctrlr)
354 {
355 	struct spdk_nvme_transport_id	*trid;
356 
357 	trid = &nvme_bdev_ctrlr->trid;
358 
359 	spdk_json_write_object_begin(w);
360 	spdk_json_write_named_string(w, "name", nvme_bdev_ctrlr->name);
361 
362 #ifdef SPDK_CONFIG_NVME_CUSE
363 	char *cuse_device;
364 
365 	cuse_device = spdk_nvme_cuse_get_ctrlr_name(nvme_bdev_ctrlr->ctrlr);
366 	if (cuse_device) {
367 		spdk_json_write_named_string(w, "cuse_device", cuse_device);
368 	}
369 #endif
370 
371 	spdk_json_write_named_object_begin(w, "trid");
372 	nvme_bdev_dump_trid_json(trid, w);
373 	spdk_json_write_object_end(w);
374 
375 	spdk_json_write_object_end(w);
376 }
377 
378 struct rpc_bdev_nvme_get_controllers {
379 	char *name;
380 };
381 
382 static void
383 free_rpc_bdev_nvme_get_controllers(struct rpc_bdev_nvme_get_controllers *r)
384 {
385 	free(r->name);
386 }
387 
388 static const struct spdk_json_object_decoder rpc_bdev_nvme_get_controllers_decoders[] = {
389 	{"name", offsetof(struct rpc_bdev_nvme_get_controllers, name), spdk_json_decode_string, true},
390 };
391 
392 static void
393 spdk_rpc_bdev_nvme_get_controllers(struct spdk_jsonrpc_request *request,
394 				   const struct spdk_json_val *params)
395 {
396 	struct rpc_bdev_nvme_get_controllers req = {};
397 	struct spdk_json_write_ctx *w;
398 	struct nvme_bdev_ctrlr *ctrlr = NULL;
399 
400 	if (params && spdk_json_decode_object(params, rpc_bdev_nvme_get_controllers_decoders,
401 					      SPDK_COUNTOF(rpc_bdev_nvme_get_controllers_decoders),
402 					      &req)) {
403 		SPDK_ERRLOG("spdk_json_decode_object failed\n");
404 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
405 						 "spdk_json_decode_object failed");
406 		goto cleanup;
407 	}
408 
409 	if (req.name) {
410 		ctrlr = nvme_bdev_ctrlr_get_by_name(req.name);
411 		if (ctrlr == NULL) {
412 			SPDK_ERRLOG("ctrlr '%s' does not exist\n", req.name);
413 			spdk_jsonrpc_send_error_response_fmt(request, EINVAL, "Controller %s does not exist", req.name);
414 			goto cleanup;
415 		}
416 	}
417 
418 	w = spdk_jsonrpc_begin_result(request);
419 	spdk_json_write_array_begin(w);
420 
421 	if (ctrlr != NULL) {
422 		spdk_rpc_dump_nvme_controller_info(w, ctrlr);
423 	} else {
424 		for (ctrlr = nvme_bdev_first_ctrlr(); ctrlr; ctrlr = nvme_bdev_next_ctrlr(ctrlr))  {
425 			spdk_rpc_dump_nvme_controller_info(w, ctrlr);
426 		}
427 	}
428 
429 	spdk_json_write_array_end(w);
430 
431 	spdk_jsonrpc_end_result(request, w);
432 
433 cleanup:
434 	free_rpc_bdev_nvme_get_controllers(&req);
435 }
436 SPDK_RPC_REGISTER("bdev_nvme_get_controllers", spdk_rpc_bdev_nvme_get_controllers, SPDK_RPC_RUNTIME)
437 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_get_controllers, get_nvme_controllers)
438 
439 struct rpc_bdev_nvme_detach_controller {
440 	char *name;
441 };
442 
443 static void
444 free_rpc_bdev_nvme_detach_controller(struct rpc_bdev_nvme_detach_controller *req)
445 {
446 	free(req->name);
447 }
448 
449 static const struct spdk_json_object_decoder rpc_bdev_nvme_detach_controller_decoders[] = {
450 	{"name", offsetof(struct rpc_bdev_nvme_detach_controller, name), spdk_json_decode_string},
451 };
452 
453 static void
454 spdk_rpc_bdev_nvme_detach_controller(struct spdk_jsonrpc_request *request,
455 				     const struct spdk_json_val *params)
456 {
457 	struct rpc_bdev_nvme_detach_controller req = {NULL};
458 	struct spdk_json_write_ctx *w;
459 	int rc = 0;
460 
461 	if (spdk_json_decode_object(params, rpc_bdev_nvme_detach_controller_decoders,
462 				    SPDK_COUNTOF(rpc_bdev_nvme_detach_controller_decoders),
463 				    &req)) {
464 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
465 						 "spdk_json_decode_object failed");
466 		goto cleanup;
467 	}
468 
469 	rc = spdk_bdev_nvme_delete(req.name);
470 	if (rc != 0) {
471 		spdk_jsonrpc_send_error_response(request, rc, spdk_strerror(-rc));
472 		goto cleanup;
473 	}
474 
475 	w = spdk_jsonrpc_begin_result(request);
476 	spdk_json_write_bool(w, true);
477 	spdk_jsonrpc_end_result(request, w);
478 
479 cleanup:
480 	free_rpc_bdev_nvme_detach_controller(&req);
481 }
482 SPDK_RPC_REGISTER("bdev_nvme_detach_controller", spdk_rpc_bdev_nvme_detach_controller,
483 		  SPDK_RPC_RUNTIME)
484 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_detach_controller, delete_nvme_controller)
485 
486 struct rpc_apply_firmware {
487 	char *filename;
488 	char *bdev_name;
489 };
490 
491 static void
492 free_rpc_apply_firmware(struct rpc_apply_firmware *req)
493 {
494 	free(req->filename);
495 	free(req->bdev_name);
496 }
497 
498 static const struct spdk_json_object_decoder rpc_apply_firmware_decoders[] = {
499 	{"filename", offsetof(struct rpc_apply_firmware, filename), spdk_json_decode_string},
500 	{"bdev_name", offsetof(struct rpc_apply_firmware, bdev_name), spdk_json_decode_string},
501 };
502 
503 struct firmware_update_info {
504 	void				*fw_image;
505 	void				*p;
506 	unsigned int			size;
507 	unsigned int			size_remaining;
508 	unsigned int			offset;
509 	unsigned int			transfer;
510 
511 	void				*desc;
512 	struct spdk_io_channel		*ch;
513 	struct spdk_jsonrpc_request	*request;
514 	struct spdk_nvme_ctrlr		*ctrlr;
515 	open_descriptors_t		desc_head;
516 	struct rpc_apply_firmware	*req;
517 };
518 
519 static void
520 _apply_firmware_cleanup(void *ctx)
521 {
522 	struct spdk_bdev_desc *desc = ctx;
523 
524 	spdk_bdev_close(desc);
525 }
526 
527 static void
528 apply_firmware_cleanup(void *cb_arg)
529 {
530 	struct open_descriptors			*opt, *tmp;
531 	struct firmware_update_info *firm_ctx = cb_arg;
532 
533 	if (!firm_ctx) {
534 		return;
535 	}
536 
537 	if (firm_ctx->fw_image) {
538 		spdk_free(firm_ctx->fw_image);
539 	}
540 
541 	if (firm_ctx->req) {
542 		free_rpc_apply_firmware(firm_ctx->req);
543 		free(firm_ctx->req);
544 	}
545 
546 	if (firm_ctx->ch) {
547 		spdk_put_io_channel(firm_ctx->ch);
548 	}
549 
550 	TAILQ_FOREACH_SAFE(opt, &firm_ctx->desc_head, tqlst, tmp) {
551 		TAILQ_REMOVE(&firm_ctx->desc_head, opt, tqlst);
552 		/* Close the underlying bdev on its same opened thread. */
553 		if (opt->thread && opt->thread != spdk_get_thread()) {
554 			spdk_thread_send_msg(opt->thread, _apply_firmware_cleanup, opt->desc);
555 		} else {
556 			spdk_bdev_close(opt->desc);
557 		}
558 		free(opt);
559 	}
560 	free(firm_ctx);
561 }
562 
563 static void
564 apply_firmware_complete_reset(struct spdk_bdev_io *bdev_io, bool success, void *cb_arg)
565 {
566 	int					rc;
567 	struct spdk_json_write_ctx		*w;
568 	struct firmware_update_info *firm_ctx = cb_arg;
569 
570 	spdk_bdev_free_io(bdev_io);
571 
572 	if (!success) {
573 		spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
574 						 "firmware commit failed.");
575 		apply_firmware_cleanup(firm_ctx);
576 		return;
577 	}
578 
579 	if ((rc = spdk_nvme_ctrlr_reset(firm_ctx->ctrlr)) != 0) {
580 		spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
581 						 "Controller reset failed.");
582 		apply_firmware_cleanup(firm_ctx);
583 		return;
584 	}
585 
586 	w = spdk_jsonrpc_begin_result(firm_ctx->request);
587 	spdk_json_write_string(w, "firmware commit succeeded. Controller reset in progress.");
588 	spdk_jsonrpc_end_result(firm_ctx->request, w);
589 	apply_firmware_cleanup(firm_ctx);
590 }
591 
592 static void
593 apply_firmware_complete(struct spdk_bdev_io *bdev_io, bool success, void *cb_arg)
594 {
595 	struct spdk_nvme_cmd			cmd = {};
596 	struct spdk_nvme_fw_commit		fw_commit;
597 	int					slot = 0;
598 	int					rc;
599 	struct firmware_update_info *firm_ctx = cb_arg;
600 	enum spdk_nvme_fw_commit_action commit_action = SPDK_NVME_FW_COMMIT_REPLACE_AND_ENABLE_IMG;
601 
602 	if (!success) {
603 		spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
604 						 "firmware download failed .");
605 		spdk_bdev_free_io(bdev_io);
606 		apply_firmware_cleanup(firm_ctx);
607 		return;
608 	}
609 
610 	firm_ctx->p += firm_ctx->transfer;
611 	firm_ctx->offset += firm_ctx->transfer;
612 	firm_ctx->size_remaining -= firm_ctx->transfer;
613 
614 	switch (firm_ctx->size_remaining) {
615 	case 0:
616 		/* firmware download completed. Commit firmware */
617 		memset(&fw_commit, 0, sizeof(struct spdk_nvme_fw_commit));
618 		fw_commit.fs = slot;
619 		fw_commit.ca = commit_action;
620 
621 		cmd.opc = SPDK_NVME_OPC_FIRMWARE_COMMIT;
622 		memcpy(&cmd.cdw10, &fw_commit, sizeof(uint32_t));
623 		rc = spdk_bdev_nvme_admin_passthru(firm_ctx->desc, firm_ctx->ch, &cmd, NULL, 0,
624 						   apply_firmware_complete_reset, firm_ctx);
625 		if (rc) {
626 			spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
627 							 "firmware commit failed.");
628 			spdk_bdev_free_io(bdev_io);
629 			apply_firmware_cleanup(firm_ctx);
630 			return;
631 		}
632 		break;
633 	default:
634 		firm_ctx->transfer = spdk_min(firm_ctx->size_remaining, 4096);
635 		cmd.opc = SPDK_NVME_OPC_FIRMWARE_IMAGE_DOWNLOAD;
636 
637 		cmd.cdw10 = (firm_ctx->transfer >> 2) - 1;
638 		cmd.cdw11 = firm_ctx->offset >> 2;
639 		rc = spdk_bdev_nvme_admin_passthru(firm_ctx->desc, firm_ctx->ch, &cmd, firm_ctx->p,
640 						   firm_ctx->transfer, apply_firmware_complete, firm_ctx);
641 		if (rc) {
642 			spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
643 							 "firmware download failed.");
644 			spdk_bdev_free_io(bdev_io);
645 			apply_firmware_cleanup(firm_ctx);
646 			return;
647 		}
648 		break;
649 	}
650 }
651 
652 static void
653 spdk_rpc_bdev_nvme_apply_firmware(struct spdk_jsonrpc_request *request,
654 				  const struct spdk_json_val *params)
655 {
656 	int					rc;
657 	int					fd = -1;
658 	struct stat				fw_stat;
659 	struct spdk_nvme_ctrlr			*ctrlr;
660 	char					msg[1024];
661 	struct spdk_bdev			*bdev;
662 	struct spdk_bdev			*bdev2;
663 	struct open_descriptors			*opt;
664 	struct spdk_bdev_desc			*desc;
665 	struct spdk_nvme_cmd			*cmd;
666 	struct firmware_update_info		*firm_ctx;
667 
668 	firm_ctx = calloc(1, sizeof(struct firmware_update_info));
669 	if (!firm_ctx) {
670 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
671 						 "Memory allocation error.");
672 		return;
673 	}
674 	firm_ctx->fw_image = NULL;
675 	TAILQ_INIT(&firm_ctx->desc_head);
676 	firm_ctx->request = request;
677 
678 	firm_ctx->req = calloc(1, sizeof(struct rpc_apply_firmware));
679 	if (!firm_ctx->req) {
680 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
681 						 "Memory allocation error.");
682 		free(firm_ctx);
683 		return;
684 	}
685 
686 	if (spdk_json_decode_object(params, rpc_apply_firmware_decoders,
687 				    SPDK_COUNTOF(rpc_apply_firmware_decoders), firm_ctx->req)) {
688 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
689 						 "spdk_json_decode_object failed.");
690 		free(firm_ctx->req);
691 		free(firm_ctx);
692 		return;
693 	}
694 
695 	if ((bdev = spdk_bdev_get_by_name(firm_ctx->req->bdev_name)) == NULL) {
696 		snprintf(msg, sizeof(msg), "bdev %s were not found", firm_ctx->req->bdev_name);
697 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, msg);
698 		apply_firmware_cleanup(firm_ctx);
699 		return;
700 	}
701 
702 	if ((ctrlr = spdk_bdev_nvme_get_ctrlr(bdev)) == NULL) {
703 		snprintf(msg, sizeof(msg), "Controller information for %s were not found.",
704 			 firm_ctx->req->bdev_name);
705 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, msg);
706 		apply_firmware_cleanup(firm_ctx);
707 		return;
708 	}
709 	firm_ctx->ctrlr = ctrlr;
710 
711 	for (bdev2 = spdk_bdev_first(); bdev2; bdev2 = spdk_bdev_next(bdev2)) {
712 
713 		if (spdk_bdev_nvme_get_ctrlr(bdev2) != ctrlr) {
714 			continue;
715 		}
716 
717 		if (!(opt = malloc(sizeof(struct open_descriptors)))) {
718 			snprintf(msg, sizeof(msg), "Memory allocation error.");
719 			spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, msg);
720 			apply_firmware_cleanup(firm_ctx);
721 			return;
722 		}
723 
724 		if ((rc = spdk_bdev_open(bdev2, true, NULL, NULL, &desc)) != 0) {
725 			snprintf(msg, sizeof(msg), "Device %s is in use.", firm_ctx->req->bdev_name);
726 			spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, msg);
727 			free(opt);
728 			apply_firmware_cleanup(firm_ctx);
729 			return;
730 		}
731 
732 		/* Save the thread where the base device is opened */
733 		opt->thread = spdk_get_thread();
734 
735 		opt->desc = desc;
736 		opt->bdev = bdev;
737 		TAILQ_INSERT_TAIL(&firm_ctx->desc_head, opt, tqlst);
738 	}
739 
740 	/*
741 	 * find a descriptor associated with our bdev
742 	 */
743 	firm_ctx->desc = NULL;
744 	TAILQ_FOREACH(opt, &firm_ctx->desc_head, tqlst) {
745 		if (opt->bdev == bdev) {
746 			firm_ctx->desc = opt->desc;
747 			break;
748 		}
749 	}
750 
751 	if (!firm_ctx->desc) {
752 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
753 						 "No descriptor were found.");
754 		apply_firmware_cleanup(firm_ctx);
755 		return;
756 	}
757 
758 	firm_ctx->ch = spdk_bdev_get_io_channel(firm_ctx->desc);
759 	if (!firm_ctx->ch) {
760 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
761 						 "No channels were found.");
762 		apply_firmware_cleanup(firm_ctx);
763 		return;
764 	}
765 
766 	fd = open(firm_ctx->req->filename, O_RDONLY);
767 	if (fd < 0) {
768 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "open file failed.");
769 		apply_firmware_cleanup(firm_ctx);
770 		return;
771 	}
772 
773 	rc = fstat(fd, &fw_stat);
774 	if (rc < 0) {
775 		close(fd);
776 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "fstat failed.");
777 		apply_firmware_cleanup(firm_ctx);
778 		return;
779 	}
780 
781 	firm_ctx->size = fw_stat.st_size;
782 	if (fw_stat.st_size % 4) {
783 		close(fd);
784 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
785 						 "Firmware image size is not multiple of 4.");
786 		apply_firmware_cleanup(firm_ctx);
787 		return;
788 	}
789 
790 	firm_ctx->fw_image = spdk_zmalloc(firm_ctx->size, 4096, NULL,
791 					  SPDK_ENV_LCORE_ID_ANY, SPDK_MALLOC_DMA);
792 	if (!firm_ctx->fw_image) {
793 		close(fd);
794 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
795 						 "Memory allocation error.");
796 		apply_firmware_cleanup(firm_ctx);
797 		return;
798 	}
799 	firm_ctx->p = firm_ctx->fw_image;
800 
801 	if (read(fd, firm_ctx->p, firm_ctx->size) != ((ssize_t)(firm_ctx->size))) {
802 		close(fd);
803 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
804 						 "Read firmware image failed!");
805 		apply_firmware_cleanup(firm_ctx);
806 		return;
807 	}
808 	close(fd);
809 
810 	firm_ctx->offset = 0;
811 	firm_ctx->size_remaining = firm_ctx->size;
812 	firm_ctx->transfer = spdk_min(firm_ctx->size_remaining, 4096);
813 
814 	cmd = malloc(sizeof(struct spdk_nvme_cmd));
815 	if (!cmd) {
816 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
817 						 "Memory allocation error.");
818 		apply_firmware_cleanup(firm_ctx);
819 		return;
820 	}
821 	memset(cmd, 0, sizeof(struct spdk_nvme_cmd));
822 	cmd->opc = SPDK_NVME_OPC_FIRMWARE_IMAGE_DOWNLOAD;
823 
824 	cmd->cdw10 = (firm_ctx->transfer >> 2) - 1;
825 	cmd->cdw11 = firm_ctx->offset >> 2;
826 
827 	rc = spdk_bdev_nvme_admin_passthru(firm_ctx->desc, firm_ctx->ch, cmd, firm_ctx->p,
828 					   firm_ctx->transfer, apply_firmware_complete, firm_ctx);
829 	if (rc) {
830 		free(cmd);
831 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
832 						 "Read firmware image failed!");
833 		apply_firmware_cleanup(firm_ctx);
834 		return;
835 	}
836 }
837 SPDK_RPC_REGISTER("bdev_nvme_apply_firmware", spdk_rpc_bdev_nvme_apply_firmware, SPDK_RPC_RUNTIME)
838 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_apply_firmware, apply_nvme_firmware)
839