xref: /spdk/module/bdev/nvme/bdev_nvme_rpc.c (revision 33f97fa33ad89651d75bafb5fb87dc4cd28dde6a)
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 *priority;
177 	char *subnqn;
178 	char *hostnqn;
179 	char *hostaddr;
180 	char *hostsvcid;
181 	bool prchk_reftag;
182 	bool prchk_guard;
183 };
184 
185 static void
186 free_rpc_bdev_nvme_attach_controller(struct rpc_bdev_nvme_attach_controller *req)
187 {
188 	free(req->name);
189 	free(req->trtype);
190 	free(req->adrfam);
191 	free(req->traddr);
192 	free(req->trsvcid);
193 	free(req->priority);
194 	free(req->subnqn);
195 	free(req->hostnqn);
196 	free(req->hostaddr);
197 	free(req->hostsvcid);
198 }
199 
200 static const struct spdk_json_object_decoder rpc_bdev_nvme_attach_controller_decoders[] = {
201 	{"name", offsetof(struct rpc_bdev_nvme_attach_controller, name), spdk_json_decode_string},
202 	{"trtype", offsetof(struct rpc_bdev_nvme_attach_controller, trtype), spdk_json_decode_string},
203 	{"traddr", offsetof(struct rpc_bdev_nvme_attach_controller, traddr), spdk_json_decode_string},
204 
205 	{"adrfam", offsetof(struct rpc_bdev_nvme_attach_controller, adrfam), spdk_json_decode_string, true},
206 	{"trsvcid", offsetof(struct rpc_bdev_nvme_attach_controller, trsvcid), spdk_json_decode_string, true},
207 	{"priority", offsetof(struct rpc_bdev_nvme_attach_controller, priority), spdk_json_decode_string, true},
208 	{"subnqn", offsetof(struct rpc_bdev_nvme_attach_controller, subnqn), spdk_json_decode_string, true},
209 	{"hostnqn", offsetof(struct rpc_bdev_nvme_attach_controller, hostnqn), spdk_json_decode_string, true},
210 	{"hostaddr", offsetof(struct rpc_bdev_nvme_attach_controller, hostaddr), spdk_json_decode_string, true},
211 	{"hostsvcid", offsetof(struct rpc_bdev_nvme_attach_controller, hostsvcid), spdk_json_decode_string, true},
212 
213 	{"prchk_reftag", offsetof(struct rpc_bdev_nvme_attach_controller, prchk_reftag), spdk_json_decode_bool, true},
214 	{"prchk_guard", offsetof(struct rpc_bdev_nvme_attach_controller, prchk_guard), spdk_json_decode_bool, true}
215 };
216 
217 #define NVME_MAX_BDEVS_PER_RPC 128
218 
219 struct rpc_bdev_nvme_attach_controller_ctx {
220 	struct rpc_bdev_nvme_attach_controller req;
221 	uint32_t count;
222 	const char *names[NVME_MAX_BDEVS_PER_RPC];
223 	struct spdk_jsonrpc_request *request;
224 };
225 
226 static void
227 spdk_rpc_bdev_nvme_attach_controller_done(void *cb_ctx, size_t bdev_count, int rc)
228 {
229 	struct rpc_bdev_nvme_attach_controller_ctx *ctx = cb_ctx;
230 	struct spdk_jsonrpc_request *request = ctx->request;
231 	struct spdk_json_write_ctx *w;
232 	size_t i;
233 
234 	if (rc < 0) {
235 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters");
236 		goto exit;
237 	}
238 
239 	w = spdk_jsonrpc_begin_result(request);
240 	spdk_json_write_array_begin(w);
241 	for (i = 0; i < bdev_count; i++) {
242 		spdk_json_write_string(w, ctx->names[i]);
243 	}
244 	spdk_json_write_array_end(w);
245 	spdk_jsonrpc_end_result(request, w);
246 
247 exit:
248 	free_rpc_bdev_nvme_attach_controller(&ctx->req);
249 	free(ctx);
250 }
251 
252 static void
253 spdk_rpc_bdev_nvme_attach_controller(struct spdk_jsonrpc_request *request,
254 				     const struct spdk_json_val *params)
255 {
256 	struct rpc_bdev_nvme_attach_controller_ctx *ctx;
257 	struct spdk_nvme_transport_id trid = {};
258 	struct spdk_nvme_host_id hostid = {};
259 	uint32_t prchk_flags = 0;
260 	int rc;
261 
262 	ctx = calloc(1, sizeof(*ctx));
263 	if (!ctx) {
264 		spdk_jsonrpc_send_error_response(request, -ENOMEM, spdk_strerror(ENOMEM));
265 		return;
266 	}
267 
268 	if (spdk_json_decode_object(params, rpc_bdev_nvme_attach_controller_decoders,
269 				    SPDK_COUNTOF(rpc_bdev_nvme_attach_controller_decoders),
270 				    &ctx->req)) {
271 		SPDK_ERRLOG("spdk_json_decode_object failed\n");
272 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
273 						 "spdk_json_decode_object failed");
274 		goto cleanup;
275 	}
276 
277 	/* Parse trstring */
278 	rc = spdk_nvme_transport_id_populate_trstring(&trid, ctx->req.trtype);
279 	if (rc < 0) {
280 		SPDK_ERRLOG("Failed to parse trtype: %s\n", ctx->req.trtype);
281 		spdk_jsonrpc_send_error_response_fmt(request, -EINVAL, "Failed to parse trtype: %s",
282 						     ctx->req.trtype);
283 		goto cleanup;
284 	}
285 
286 	/* Parse trtype */
287 	rc = spdk_nvme_transport_id_parse_trtype(&trid.trtype, ctx->req.trtype);
288 	assert(rc == 0);
289 
290 	/* Parse traddr */
291 	snprintf(trid.traddr, sizeof(trid.traddr), "%s", ctx->req.traddr);
292 
293 	/* Parse adrfam */
294 	if (ctx->req.adrfam) {
295 		rc = spdk_nvme_transport_id_parse_adrfam(&trid.adrfam, ctx->req.adrfam);
296 		if (rc < 0) {
297 			SPDK_ERRLOG("Failed to parse adrfam: %s\n", ctx->req.adrfam);
298 			spdk_jsonrpc_send_error_response_fmt(request, -EINVAL, "Failed to parse adrfam: %s",
299 							     ctx->req.adrfam);
300 			goto cleanup;
301 		}
302 	}
303 
304 	/* Parse trsvcid */
305 	if (ctx->req.trsvcid) {
306 		snprintf(trid.trsvcid, sizeof(trid.trsvcid), "%s", ctx->req.trsvcid);
307 	}
308 
309 	/* Parse priority for the NVMe-oF transport connection */
310 	if (ctx->req.priority) {
311 		trid.priority = spdk_strtol(ctx->req.priority, 10);
312 	}
313 
314 	/* Parse subnqn */
315 	if (ctx->req.subnqn) {
316 		snprintf(trid.subnqn, sizeof(trid.subnqn), "%s", ctx->req.subnqn);
317 	}
318 
319 	if (ctx->req.hostaddr) {
320 		snprintf(hostid.hostaddr, sizeof(hostid.hostaddr), "%s", ctx->req.hostaddr);
321 	}
322 
323 	if (ctx->req.hostsvcid) {
324 		snprintf(hostid.hostsvcid, sizeof(hostid.hostsvcid), "%s", ctx->req.hostsvcid);
325 	}
326 
327 	if (ctx->req.prchk_reftag) {
328 		prchk_flags |= SPDK_NVME_IO_FLAGS_PRCHK_REFTAG;
329 	}
330 
331 	if (ctx->req.prchk_guard) {
332 		prchk_flags |= SPDK_NVME_IO_FLAGS_PRCHK_GUARD;
333 	}
334 
335 	ctx->request = request;
336 	ctx->count = NVME_MAX_BDEVS_PER_RPC;
337 	rc = spdk_bdev_nvme_create(&trid, &hostid, ctx->req.name, ctx->names, ctx->count, ctx->req.hostnqn,
338 				   prchk_flags, spdk_rpc_bdev_nvme_attach_controller_done, ctx);
339 	if (rc) {
340 		spdk_jsonrpc_send_error_response(request, rc, spdk_strerror(-rc));
341 		goto cleanup;
342 	}
343 
344 	return;
345 
346 cleanup:
347 	free_rpc_bdev_nvme_attach_controller(&ctx->req);
348 	free(ctx);
349 }
350 SPDK_RPC_REGISTER("bdev_nvme_attach_controller", spdk_rpc_bdev_nvme_attach_controller,
351 		  SPDK_RPC_RUNTIME)
352 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_attach_controller, construct_nvme_bdev)
353 
354 static void
355 spdk_rpc_dump_nvme_controller_info(struct spdk_json_write_ctx *w,
356 				   struct nvme_bdev_ctrlr *nvme_bdev_ctrlr)
357 {
358 	struct spdk_nvme_transport_id	*trid;
359 
360 	trid = &nvme_bdev_ctrlr->trid;
361 
362 	spdk_json_write_object_begin(w);
363 	spdk_json_write_named_string(w, "name", nvme_bdev_ctrlr->name);
364 
365 #ifdef SPDK_CONFIG_NVME_CUSE
366 	size_t cuse_name_size = 128;
367 	char cuse_name[cuse_name_size];
368 
369 	int rc = spdk_nvme_cuse_get_ctrlr_name(nvme_bdev_ctrlr->ctrlr, cuse_name, &cuse_name_size);
370 	if (rc == 0) {
371 		spdk_json_write_named_string(w, "cuse_device", cuse_name);
372 	}
373 #endif
374 
375 	spdk_json_write_named_object_begin(w, "trid");
376 	nvme_bdev_dump_trid_json(trid, w);
377 	spdk_json_write_object_end(w);
378 
379 	spdk_json_write_object_end(w);
380 }
381 
382 struct rpc_bdev_nvme_get_controllers {
383 	char *name;
384 };
385 
386 static void
387 free_rpc_bdev_nvme_get_controllers(struct rpc_bdev_nvme_get_controllers *r)
388 {
389 	free(r->name);
390 }
391 
392 static const struct spdk_json_object_decoder rpc_bdev_nvme_get_controllers_decoders[] = {
393 	{"name", offsetof(struct rpc_bdev_nvme_get_controllers, name), spdk_json_decode_string, true},
394 };
395 
396 static void
397 spdk_rpc_bdev_nvme_get_controllers(struct spdk_jsonrpc_request *request,
398 				   const struct spdk_json_val *params)
399 {
400 	struct rpc_bdev_nvme_get_controllers req = {};
401 	struct spdk_json_write_ctx *w;
402 	struct nvme_bdev_ctrlr *ctrlr = NULL;
403 
404 	if (params && spdk_json_decode_object(params, rpc_bdev_nvme_get_controllers_decoders,
405 					      SPDK_COUNTOF(rpc_bdev_nvme_get_controllers_decoders),
406 					      &req)) {
407 		SPDK_ERRLOG("spdk_json_decode_object failed\n");
408 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
409 						 "spdk_json_decode_object failed");
410 		goto cleanup;
411 	}
412 
413 	if (req.name) {
414 		ctrlr = nvme_bdev_ctrlr_get_by_name(req.name);
415 		if (ctrlr == NULL) {
416 			SPDK_ERRLOG("ctrlr '%s' does not exist\n", req.name);
417 			spdk_jsonrpc_send_error_response_fmt(request, EINVAL, "Controller %s does not exist", req.name);
418 			goto cleanup;
419 		}
420 	}
421 
422 	w = spdk_jsonrpc_begin_result(request);
423 	spdk_json_write_array_begin(w);
424 
425 	if (ctrlr != NULL) {
426 		spdk_rpc_dump_nvme_controller_info(w, ctrlr);
427 	} else {
428 		for (ctrlr = nvme_bdev_first_ctrlr(); ctrlr; ctrlr = nvme_bdev_next_ctrlr(ctrlr))  {
429 			spdk_rpc_dump_nvme_controller_info(w, ctrlr);
430 		}
431 	}
432 
433 	spdk_json_write_array_end(w);
434 
435 	spdk_jsonrpc_end_result(request, w);
436 
437 cleanup:
438 	free_rpc_bdev_nvme_get_controllers(&req);
439 }
440 SPDK_RPC_REGISTER("bdev_nvme_get_controllers", spdk_rpc_bdev_nvme_get_controllers, SPDK_RPC_RUNTIME)
441 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_get_controllers, get_nvme_controllers)
442 
443 struct rpc_bdev_nvme_detach_controller {
444 	char *name;
445 };
446 
447 static void
448 free_rpc_bdev_nvme_detach_controller(struct rpc_bdev_nvme_detach_controller *req)
449 {
450 	free(req->name);
451 }
452 
453 static const struct spdk_json_object_decoder rpc_bdev_nvme_detach_controller_decoders[] = {
454 	{"name", offsetof(struct rpc_bdev_nvme_detach_controller, name), spdk_json_decode_string},
455 };
456 
457 static void
458 spdk_rpc_bdev_nvme_detach_controller(struct spdk_jsonrpc_request *request,
459 				     const struct spdk_json_val *params)
460 {
461 	struct rpc_bdev_nvme_detach_controller req = {NULL};
462 	struct spdk_json_write_ctx *w;
463 	int rc = 0;
464 
465 	if (spdk_json_decode_object(params, rpc_bdev_nvme_detach_controller_decoders,
466 				    SPDK_COUNTOF(rpc_bdev_nvme_detach_controller_decoders),
467 				    &req)) {
468 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
469 						 "spdk_json_decode_object failed");
470 		goto cleanup;
471 	}
472 
473 	rc = spdk_bdev_nvme_delete(req.name);
474 	if (rc != 0) {
475 		spdk_jsonrpc_send_error_response(request, rc, spdk_strerror(-rc));
476 		goto cleanup;
477 	}
478 
479 	w = spdk_jsonrpc_begin_result(request);
480 	spdk_json_write_bool(w, true);
481 	spdk_jsonrpc_end_result(request, w);
482 
483 cleanup:
484 	free_rpc_bdev_nvme_detach_controller(&req);
485 }
486 SPDK_RPC_REGISTER("bdev_nvme_detach_controller", spdk_rpc_bdev_nvme_detach_controller,
487 		  SPDK_RPC_RUNTIME)
488 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_detach_controller, delete_nvme_controller)
489 
490 struct rpc_apply_firmware {
491 	char *filename;
492 	char *bdev_name;
493 };
494 
495 static void
496 free_rpc_apply_firmware(struct rpc_apply_firmware *req)
497 {
498 	free(req->filename);
499 	free(req->bdev_name);
500 }
501 
502 static const struct spdk_json_object_decoder rpc_apply_firmware_decoders[] = {
503 	{"filename", offsetof(struct rpc_apply_firmware, filename), spdk_json_decode_string},
504 	{"bdev_name", offsetof(struct rpc_apply_firmware, bdev_name), spdk_json_decode_string},
505 };
506 
507 struct firmware_update_info {
508 	void				*fw_image;
509 	void				*p;
510 	unsigned int			size;
511 	unsigned int			size_remaining;
512 	unsigned int			offset;
513 	unsigned int			transfer;
514 
515 	void				*desc;
516 	struct spdk_io_channel		*ch;
517 	struct spdk_jsonrpc_request	*request;
518 	struct spdk_nvme_ctrlr		*ctrlr;
519 	open_descriptors_t		desc_head;
520 	struct rpc_apply_firmware	*req;
521 };
522 
523 static void
524 _apply_firmware_cleanup(void *ctx)
525 {
526 	struct spdk_bdev_desc *desc = ctx;
527 
528 	spdk_bdev_close(desc);
529 }
530 
531 static void
532 apply_firmware_cleanup(void *cb_arg)
533 {
534 	struct open_descriptors			*opt, *tmp;
535 	struct firmware_update_info *firm_ctx = cb_arg;
536 
537 	if (!firm_ctx) {
538 		return;
539 	}
540 
541 	if (firm_ctx->fw_image) {
542 		spdk_free(firm_ctx->fw_image);
543 	}
544 
545 	if (firm_ctx->req) {
546 		free_rpc_apply_firmware(firm_ctx->req);
547 		free(firm_ctx->req);
548 	}
549 
550 	if (firm_ctx->ch) {
551 		spdk_put_io_channel(firm_ctx->ch);
552 	}
553 
554 	TAILQ_FOREACH_SAFE(opt, &firm_ctx->desc_head, tqlst, tmp) {
555 		TAILQ_REMOVE(&firm_ctx->desc_head, opt, tqlst);
556 		/* Close the underlying bdev on its same opened thread. */
557 		if (opt->thread && opt->thread != spdk_get_thread()) {
558 			spdk_thread_send_msg(opt->thread, _apply_firmware_cleanup, opt->desc);
559 		} else {
560 			spdk_bdev_close(opt->desc);
561 		}
562 		free(opt);
563 	}
564 	free(firm_ctx);
565 }
566 
567 static void
568 apply_firmware_complete_reset(struct spdk_bdev_io *bdev_io, bool success, void *cb_arg)
569 {
570 	int					rc;
571 	struct spdk_json_write_ctx		*w;
572 	struct firmware_update_info *firm_ctx = cb_arg;
573 
574 	spdk_bdev_free_io(bdev_io);
575 
576 	if (!success) {
577 		spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
578 						 "firmware commit failed.");
579 		apply_firmware_cleanup(firm_ctx);
580 		return;
581 	}
582 
583 	if ((rc = spdk_nvme_ctrlr_reset(firm_ctx->ctrlr)) != 0) {
584 		spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
585 						 "Controller reset failed.");
586 		apply_firmware_cleanup(firm_ctx);
587 		return;
588 	}
589 
590 	w = spdk_jsonrpc_begin_result(firm_ctx->request);
591 	spdk_json_write_string(w, "firmware commit succeeded. Controller reset in progress.");
592 	spdk_jsonrpc_end_result(firm_ctx->request, w);
593 	apply_firmware_cleanup(firm_ctx);
594 }
595 
596 static void
597 apply_firmware_complete(struct spdk_bdev_io *bdev_io, bool success, void *cb_arg)
598 {
599 	struct spdk_nvme_cmd			cmd = {};
600 	struct spdk_nvme_fw_commit		fw_commit;
601 	int					slot = 0;
602 	int					rc;
603 	struct firmware_update_info *firm_ctx = cb_arg;
604 	enum spdk_nvme_fw_commit_action commit_action = SPDK_NVME_FW_COMMIT_REPLACE_AND_ENABLE_IMG;
605 
606 	if (!success) {
607 		spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
608 						 "firmware download failed .");
609 		spdk_bdev_free_io(bdev_io);
610 		apply_firmware_cleanup(firm_ctx);
611 		return;
612 	}
613 
614 	firm_ctx->p += firm_ctx->transfer;
615 	firm_ctx->offset += firm_ctx->transfer;
616 	firm_ctx->size_remaining -= firm_ctx->transfer;
617 
618 	switch (firm_ctx->size_remaining) {
619 	case 0:
620 		/* firmware download completed. Commit firmware */
621 		memset(&fw_commit, 0, sizeof(struct spdk_nvme_fw_commit));
622 		fw_commit.fs = slot;
623 		fw_commit.ca = commit_action;
624 
625 		cmd.opc = SPDK_NVME_OPC_FIRMWARE_COMMIT;
626 		memcpy(&cmd.cdw10, &fw_commit, sizeof(uint32_t));
627 		rc = spdk_bdev_nvme_admin_passthru(firm_ctx->desc, firm_ctx->ch, &cmd, NULL, 0,
628 						   apply_firmware_complete_reset, firm_ctx);
629 		if (rc) {
630 			spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
631 							 "firmware commit failed.");
632 			spdk_bdev_free_io(bdev_io);
633 			apply_firmware_cleanup(firm_ctx);
634 			return;
635 		}
636 		break;
637 	default:
638 		firm_ctx->transfer = spdk_min(firm_ctx->size_remaining, 4096);
639 		cmd.opc = SPDK_NVME_OPC_FIRMWARE_IMAGE_DOWNLOAD;
640 
641 		cmd.cdw10 = (firm_ctx->transfer >> 2) - 1;
642 		cmd.cdw11 = firm_ctx->offset >> 2;
643 		rc = spdk_bdev_nvme_admin_passthru(firm_ctx->desc, firm_ctx->ch, &cmd, firm_ctx->p,
644 						   firm_ctx->transfer, apply_firmware_complete, firm_ctx);
645 		if (rc) {
646 			spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
647 							 "firmware download failed.");
648 			spdk_bdev_free_io(bdev_io);
649 			apply_firmware_cleanup(firm_ctx);
650 			return;
651 		}
652 		break;
653 	}
654 }
655 
656 static void
657 spdk_rpc_bdev_nvme_apply_firmware(struct spdk_jsonrpc_request *request,
658 				  const struct spdk_json_val *params)
659 {
660 	int					rc;
661 	int					fd = -1;
662 	struct stat				fw_stat;
663 	struct spdk_nvme_ctrlr			*ctrlr;
664 	char					msg[1024];
665 	struct spdk_bdev			*bdev;
666 	struct spdk_bdev			*bdev2;
667 	struct open_descriptors			*opt;
668 	struct spdk_bdev_desc			*desc;
669 	struct spdk_nvme_cmd			*cmd;
670 	struct firmware_update_info		*firm_ctx;
671 
672 	firm_ctx = calloc(1, sizeof(struct firmware_update_info));
673 	if (!firm_ctx) {
674 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
675 						 "Memory allocation error.");
676 		return;
677 	}
678 	firm_ctx->fw_image = NULL;
679 	TAILQ_INIT(&firm_ctx->desc_head);
680 	firm_ctx->request = request;
681 
682 	firm_ctx->req = calloc(1, sizeof(struct rpc_apply_firmware));
683 	if (!firm_ctx->req) {
684 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
685 						 "Memory allocation error.");
686 		free(firm_ctx);
687 		return;
688 	}
689 
690 	if (spdk_json_decode_object(params, rpc_apply_firmware_decoders,
691 				    SPDK_COUNTOF(rpc_apply_firmware_decoders), firm_ctx->req)) {
692 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
693 						 "spdk_json_decode_object failed.");
694 		free(firm_ctx->req);
695 		free(firm_ctx);
696 		return;
697 	}
698 
699 	if ((bdev = spdk_bdev_get_by_name(firm_ctx->req->bdev_name)) == NULL) {
700 		snprintf(msg, sizeof(msg), "bdev %s were not found", firm_ctx->req->bdev_name);
701 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, msg);
702 		apply_firmware_cleanup(firm_ctx);
703 		return;
704 	}
705 
706 	if ((ctrlr = spdk_bdev_nvme_get_ctrlr(bdev)) == NULL) {
707 		snprintf(msg, sizeof(msg), "Controller information for %s were not found.",
708 			 firm_ctx->req->bdev_name);
709 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, msg);
710 		apply_firmware_cleanup(firm_ctx);
711 		return;
712 	}
713 	firm_ctx->ctrlr = ctrlr;
714 
715 	for (bdev2 = spdk_bdev_first(); bdev2; bdev2 = spdk_bdev_next(bdev2)) {
716 
717 		if (spdk_bdev_nvme_get_ctrlr(bdev2) != ctrlr) {
718 			continue;
719 		}
720 
721 		if (!(opt = malloc(sizeof(struct open_descriptors)))) {
722 			snprintf(msg, sizeof(msg), "Memory allocation error.");
723 			spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, msg);
724 			apply_firmware_cleanup(firm_ctx);
725 			return;
726 		}
727 
728 		if ((rc = spdk_bdev_open(bdev2, true, NULL, NULL, &desc)) != 0) {
729 			snprintf(msg, sizeof(msg), "Device %s is in use.", firm_ctx->req->bdev_name);
730 			spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, msg);
731 			free(opt);
732 			apply_firmware_cleanup(firm_ctx);
733 			return;
734 		}
735 
736 		/* Save the thread where the base device is opened */
737 		opt->thread = spdk_get_thread();
738 
739 		opt->desc = desc;
740 		opt->bdev = bdev;
741 		TAILQ_INSERT_TAIL(&firm_ctx->desc_head, opt, tqlst);
742 	}
743 
744 	/*
745 	 * find a descriptor associated with our bdev
746 	 */
747 	firm_ctx->desc = NULL;
748 	TAILQ_FOREACH(opt, &firm_ctx->desc_head, tqlst) {
749 		if (opt->bdev == bdev) {
750 			firm_ctx->desc = opt->desc;
751 			break;
752 		}
753 	}
754 
755 	if (!firm_ctx->desc) {
756 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
757 						 "No descriptor were found.");
758 		apply_firmware_cleanup(firm_ctx);
759 		return;
760 	}
761 
762 	firm_ctx->ch = spdk_bdev_get_io_channel(firm_ctx->desc);
763 	if (!firm_ctx->ch) {
764 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
765 						 "No channels were found.");
766 		apply_firmware_cleanup(firm_ctx);
767 		return;
768 	}
769 
770 	fd = open(firm_ctx->req->filename, O_RDONLY);
771 	if (fd < 0) {
772 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "open file failed.");
773 		apply_firmware_cleanup(firm_ctx);
774 		return;
775 	}
776 
777 	rc = fstat(fd, &fw_stat);
778 	if (rc < 0) {
779 		close(fd);
780 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "fstat failed.");
781 		apply_firmware_cleanup(firm_ctx);
782 		return;
783 	}
784 
785 	firm_ctx->size = fw_stat.st_size;
786 	if (fw_stat.st_size % 4) {
787 		close(fd);
788 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
789 						 "Firmware image size is not multiple of 4.");
790 		apply_firmware_cleanup(firm_ctx);
791 		return;
792 	}
793 
794 	firm_ctx->fw_image = spdk_zmalloc(firm_ctx->size, 4096, NULL,
795 					  SPDK_ENV_LCORE_ID_ANY, SPDK_MALLOC_DMA);
796 	if (!firm_ctx->fw_image) {
797 		close(fd);
798 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
799 						 "Memory allocation error.");
800 		apply_firmware_cleanup(firm_ctx);
801 		return;
802 	}
803 	firm_ctx->p = firm_ctx->fw_image;
804 
805 	if (read(fd, firm_ctx->p, firm_ctx->size) != ((ssize_t)(firm_ctx->size))) {
806 		close(fd);
807 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
808 						 "Read firmware image failed!");
809 		apply_firmware_cleanup(firm_ctx);
810 		return;
811 	}
812 	close(fd);
813 
814 	firm_ctx->offset = 0;
815 	firm_ctx->size_remaining = firm_ctx->size;
816 	firm_ctx->transfer = spdk_min(firm_ctx->size_remaining, 4096);
817 
818 	cmd = malloc(sizeof(struct spdk_nvme_cmd));
819 	if (!cmd) {
820 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
821 						 "Memory allocation error.");
822 		apply_firmware_cleanup(firm_ctx);
823 		return;
824 	}
825 	memset(cmd, 0, sizeof(struct spdk_nvme_cmd));
826 	cmd->opc = SPDK_NVME_OPC_FIRMWARE_IMAGE_DOWNLOAD;
827 
828 	cmd->cdw10 = (firm_ctx->transfer >> 2) - 1;
829 	cmd->cdw11 = firm_ctx->offset >> 2;
830 
831 	rc = spdk_bdev_nvme_admin_passthru(firm_ctx->desc, firm_ctx->ch, cmd, firm_ctx->p,
832 					   firm_ctx->transfer, apply_firmware_complete, firm_ctx);
833 	if (rc) {
834 		free(cmd);
835 		spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR,
836 						 "Read firmware image failed!");
837 		apply_firmware_cleanup(firm_ctx);
838 		return;
839 	}
840 }
841 SPDK_RPC_REGISTER("bdev_nvme_apply_firmware", spdk_rpc_bdev_nvme_apply_firmware, SPDK_RPC_RUNTIME)
842 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_apply_firmware, apply_nvme_firmware)
843