1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * NVMe Over Fabrics Target Passthrough command implementation.
4 *
5 * Copyright (c) 2017-2018 Western Digital Corporation or its
6 * affiliates.
7 * Copyright (c) 2019-2020, Eideticom Inc.
8 *
9 */
10 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
11 #include <linux/module.h>
12
13 #include "../host/nvme.h"
14 #include "nvmet.h"
15
16 MODULE_IMPORT_NS(NVME_TARGET_PASSTHRU);
17
18 /*
19 * xarray to maintain one passthru subsystem per nvme controller.
20 */
21 static DEFINE_XARRAY(passthru_subsystems);
22
nvmet_passthrough_override_cap(struct nvmet_ctrl * ctrl)23 void nvmet_passthrough_override_cap(struct nvmet_ctrl *ctrl)
24 {
25 /*
26 * Multiple command set support can only be declared if the underlying
27 * controller actually supports it.
28 */
29 if (!nvme_multi_css(ctrl->subsys->passthru_ctrl))
30 ctrl->cap &= ~(1ULL << 43);
31 }
32
nvmet_passthru_override_id_ctrl(struct nvmet_req * req)33 static u16 nvmet_passthru_override_id_ctrl(struct nvmet_req *req)
34 {
35 struct nvmet_ctrl *ctrl = req->sq->ctrl;
36 struct nvme_ctrl *pctrl = ctrl->subsys->passthru_ctrl;
37 u16 status = NVME_SC_SUCCESS;
38 struct nvme_id_ctrl *id;
39 unsigned int max_hw_sectors;
40 int page_shift;
41
42 id = kzalloc(sizeof(*id), GFP_KERNEL);
43 if (!id)
44 return NVME_SC_INTERNAL;
45
46 status = nvmet_copy_from_sgl(req, 0, id, sizeof(*id));
47 if (status)
48 goto out_free;
49
50 id->cntlid = cpu_to_le16(ctrl->cntlid);
51 id->ver = cpu_to_le32(ctrl->subsys->ver);
52
53 /*
54 * The passthru NVMe driver may have a limit on the number of segments
55 * which depends on the host's memory fragementation. To solve this,
56 * ensure mdts is limited to the pages equal to the number of segments.
57 */
58 max_hw_sectors = min_not_zero(pctrl->max_segments << (PAGE_SHIFT - 9),
59 pctrl->max_hw_sectors);
60
61 /*
62 * nvmet_passthru_map_sg is limitted to using a single bio so limit
63 * the mdts based on BIO_MAX_VECS as well
64 */
65 max_hw_sectors = min_not_zero(BIO_MAX_VECS << (PAGE_SHIFT - 9),
66 max_hw_sectors);
67
68 page_shift = NVME_CAP_MPSMIN(ctrl->cap) + 12;
69
70 id->mdts = ilog2(max_hw_sectors) + 9 - page_shift;
71
72 id->acl = 3;
73 /*
74 * We export aerl limit for the fabrics controller, update this when
75 * passthru based aerl support is added.
76 */
77 id->aerl = NVMET_ASYNC_EVENTS - 1;
78
79 /* emulate kas as most of the PCIe ctrl don't have a support for kas */
80 id->kas = cpu_to_le16(NVMET_KAS);
81
82 /* don't support host memory buffer */
83 id->hmpre = 0;
84 id->hmmin = 0;
85
86 id->sqes = min_t(__u8, ((0x6 << 4) | 0x6), id->sqes);
87 id->cqes = min_t(__u8, ((0x4 << 4) | 0x4), id->cqes);
88 id->maxcmd = cpu_to_le16(NVMET_MAX_CMD);
89
90 /* don't support fuse commands */
91 id->fuses = 0;
92
93 id->sgls = cpu_to_le32(1 << 0); /* we always support SGLs */
94 if (ctrl->ops->flags & NVMF_KEYED_SGLS)
95 id->sgls |= cpu_to_le32(1 << 2);
96 if (req->port->inline_data_size)
97 id->sgls |= cpu_to_le32(1 << 20);
98
99 /*
100 * When passsthru controller is setup using nvme-loop transport it will
101 * export the passthru ctrl subsysnqn (PCIe NVMe ctrl) and will fail in
102 * the nvme/host/core.c in the nvme_init_subsystem()->nvme_active_ctrl()
103 * code path with duplicate ctr subsynqn. In order to prevent that we
104 * mask the passthru-ctrl subsysnqn with the target ctrl subsysnqn.
105 */
106 memcpy(id->subnqn, ctrl->subsysnqn, sizeof(id->subnqn));
107
108 /* use fabric id-ctrl values */
109 id->ioccsz = cpu_to_le32((sizeof(struct nvme_command) +
110 req->port->inline_data_size) / 16);
111 id->iorcsz = cpu_to_le32(sizeof(struct nvme_completion) / 16);
112
113 id->msdbd = ctrl->ops->msdbd;
114
115 /* Support multipath connections with fabrics */
116 id->cmic |= 1 << 1;
117
118 /* Disable reservations, see nvmet_parse_passthru_io_cmd() */
119 id->oncs &= cpu_to_le16(~NVME_CTRL_ONCS_RESERVATIONS);
120
121 status = nvmet_copy_to_sgl(req, 0, id, sizeof(struct nvme_id_ctrl));
122
123 out_free:
124 kfree(id);
125 return status;
126 }
127
nvmet_passthru_override_id_ns(struct nvmet_req * req)128 static u16 nvmet_passthru_override_id_ns(struct nvmet_req *req)
129 {
130 u16 status = NVME_SC_SUCCESS;
131 struct nvme_id_ns *id;
132 int i;
133
134 id = kzalloc(sizeof(*id), GFP_KERNEL);
135 if (!id)
136 return NVME_SC_INTERNAL;
137
138 status = nvmet_copy_from_sgl(req, 0, id, sizeof(struct nvme_id_ns));
139 if (status)
140 goto out_free;
141
142 for (i = 0; i < (id->nlbaf + 1); i++)
143 if (id->lbaf[i].ms)
144 memset(&id->lbaf[i], 0, sizeof(id->lbaf[i]));
145
146 id->flbas = id->flbas & ~(1 << 4);
147
148 /*
149 * Presently the NVMEof target code does not support sending
150 * metadata, so we must disable it here. This should be updated
151 * once target starts supporting metadata.
152 */
153 id->mc = 0;
154
155 status = nvmet_copy_to_sgl(req, 0, id, sizeof(*id));
156
157 out_free:
158 kfree(id);
159 return status;
160 }
161
nvmet_passthru_execute_cmd_work(struct work_struct * w)162 static void nvmet_passthru_execute_cmd_work(struct work_struct *w)
163 {
164 struct nvmet_req *req = container_of(w, struct nvmet_req, p.work);
165 struct request *rq = req->p.rq;
166 int status;
167
168 status = nvme_execute_passthru_rq(rq);
169
170 if (status == NVME_SC_SUCCESS &&
171 req->cmd->common.opcode == nvme_admin_identify) {
172 switch (req->cmd->identify.cns) {
173 case NVME_ID_CNS_CTRL:
174 nvmet_passthru_override_id_ctrl(req);
175 break;
176 case NVME_ID_CNS_NS:
177 nvmet_passthru_override_id_ns(req);
178 break;
179 }
180 } else if (status < 0)
181 status = NVME_SC_INTERNAL;
182
183 req->cqe->result = nvme_req(rq)->result;
184 nvmet_req_complete(req, status);
185 blk_mq_free_request(rq);
186 }
187
nvmet_passthru_req_done(struct request * rq,blk_status_t blk_status)188 static void nvmet_passthru_req_done(struct request *rq,
189 blk_status_t blk_status)
190 {
191 struct nvmet_req *req = rq->end_io_data;
192
193 req->cqe->result = nvme_req(rq)->result;
194 nvmet_req_complete(req, nvme_req(rq)->status);
195 blk_mq_free_request(rq);
196 }
197
nvmet_passthru_map_sg(struct nvmet_req * req,struct request * rq)198 static int nvmet_passthru_map_sg(struct nvmet_req *req, struct request *rq)
199 {
200 struct scatterlist *sg;
201 struct bio *bio;
202 int i;
203
204 if (req->sg_cnt > BIO_MAX_VECS)
205 return -EINVAL;
206
207 if (nvmet_use_inline_bvec(req)) {
208 bio = &req->p.inline_bio;
209 bio_init(bio, req->inline_bvec, ARRAY_SIZE(req->inline_bvec));
210 } else {
211 bio = bio_alloc(GFP_KERNEL, bio_max_segs(req->sg_cnt));
212 bio->bi_end_io = bio_put;
213 }
214 bio->bi_opf = req_op(rq);
215
216 for_each_sg(req->sg, sg, req->sg_cnt, i) {
217 if (bio_add_pc_page(rq->q, bio, sg_page(sg), sg->length,
218 sg->offset) < sg->length) {
219 nvmet_req_bio_put(req, bio);
220 return -EINVAL;
221 }
222 }
223
224 blk_rq_bio_prep(rq, bio, req->sg_cnt);
225
226 return 0;
227 }
228
nvmet_passthru_execute_cmd(struct nvmet_req * req)229 static void nvmet_passthru_execute_cmd(struct nvmet_req *req)
230 {
231 struct nvme_ctrl *ctrl = nvmet_req_subsys(req)->passthru_ctrl;
232 struct request_queue *q = ctrl->admin_q;
233 struct nvme_ns *ns = NULL;
234 struct request *rq = NULL;
235 unsigned int timeout;
236 u32 effects;
237 u16 status;
238 int ret;
239
240 if (likely(req->sq->qid != 0)) {
241 u32 nsid = le32_to_cpu(req->cmd->common.nsid);
242
243 ns = nvme_find_get_ns(ctrl, nsid);
244 if (unlikely(!ns)) {
245 pr_err("failed to get passthru ns nsid:%u\n", nsid);
246 status = NVME_SC_INVALID_NS | NVME_SC_DNR;
247 goto out;
248 }
249
250 q = ns->queue;
251 timeout = nvmet_req_subsys(req)->io_timeout;
252 } else {
253 timeout = nvmet_req_subsys(req)->admin_timeout;
254 }
255
256 rq = nvme_alloc_request(q, req->cmd, 0);
257 if (IS_ERR(rq)) {
258 status = NVME_SC_INTERNAL;
259 goto out_put_ns;
260 }
261
262 if (timeout)
263 rq->timeout = timeout;
264
265 if (req->sg_cnt) {
266 ret = nvmet_passthru_map_sg(req, rq);
267 if (unlikely(ret)) {
268 status = NVME_SC_INTERNAL;
269 goto out_put_req;
270 }
271 }
272
273 /*
274 * If a command needs post-execution fixups, or there are any
275 * non-trivial effects, make sure to execute the command synchronously
276 * in a workqueue so that nvme_passthru_end gets called.
277 */
278 effects = nvme_command_effects(ctrl, ns, req->cmd->common.opcode);
279 if (req->p.use_workqueue ||
280 (effects & ~(NVME_CMD_EFFECTS_CSUPP | NVME_CMD_EFFECTS_LBCC))) {
281 INIT_WORK(&req->p.work, nvmet_passthru_execute_cmd_work);
282 req->p.rq = rq;
283 queue_work(nvmet_wq, &req->p.work);
284 } else {
285 rq->end_io_data = req;
286 blk_execute_rq_nowait(ns ? ns->disk : NULL, rq, 0,
287 nvmet_passthru_req_done);
288 }
289
290 if (ns)
291 nvme_put_ns(ns);
292
293 return;
294
295 out_put_req:
296 blk_mq_free_request(rq);
297 out_put_ns:
298 if (ns)
299 nvme_put_ns(ns);
300 out:
301 nvmet_req_complete(req, status);
302 }
303
304 /*
305 * We need to emulate set host behaviour to ensure that any requested
306 * behaviour of the target's host matches the requested behaviour
307 * of the device's host and fail otherwise.
308 */
nvmet_passthru_set_host_behaviour(struct nvmet_req * req)309 static void nvmet_passthru_set_host_behaviour(struct nvmet_req *req)
310 {
311 struct nvme_ctrl *ctrl = nvmet_req_subsys(req)->passthru_ctrl;
312 struct nvme_feat_host_behavior *host;
313 u16 status = NVME_SC_INTERNAL;
314 int ret;
315
316 host = kzalloc(sizeof(*host) * 2, GFP_KERNEL);
317 if (!host)
318 goto out_complete_req;
319
320 ret = nvme_get_features(ctrl, NVME_FEAT_HOST_BEHAVIOR, 0,
321 host, sizeof(*host), NULL);
322 if (ret)
323 goto out_free_host;
324
325 status = nvmet_copy_from_sgl(req, 0, &host[1], sizeof(*host));
326 if (status)
327 goto out_free_host;
328
329 if (memcmp(&host[0], &host[1], sizeof(host[0]))) {
330 pr_warn("target host has requested different behaviour from the local host\n");
331 status = NVME_SC_INTERNAL;
332 }
333
334 out_free_host:
335 kfree(host);
336 out_complete_req:
337 nvmet_req_complete(req, status);
338 }
339
nvmet_setup_passthru_command(struct nvmet_req * req)340 static u16 nvmet_setup_passthru_command(struct nvmet_req *req)
341 {
342 req->p.use_workqueue = false;
343 req->execute = nvmet_passthru_execute_cmd;
344 return NVME_SC_SUCCESS;
345 }
346
nvmet_parse_passthru_io_cmd(struct nvmet_req * req)347 u16 nvmet_parse_passthru_io_cmd(struct nvmet_req *req)
348 {
349 /* Reject any commands with non-sgl flags set (ie. fused commands) */
350 if (req->cmd->common.flags & ~NVME_CMD_SGL_ALL)
351 return NVME_SC_INVALID_FIELD;
352
353 switch (req->cmd->common.opcode) {
354 case nvme_cmd_resv_register:
355 case nvme_cmd_resv_report:
356 case nvme_cmd_resv_acquire:
357 case nvme_cmd_resv_release:
358 /*
359 * Reservations cannot be supported properly because the
360 * underlying device has no way of differentiating different
361 * hosts that connect via fabrics. This could potentially be
362 * emulated in the future if regular targets grow support for
363 * this feature.
364 */
365 return NVME_SC_INVALID_OPCODE | NVME_SC_DNR;
366 }
367
368 return nvmet_setup_passthru_command(req);
369 }
370
371 /*
372 * Only features that are emulated or specifically allowed in the list are
373 * passed down to the controller. This function implements the allow list for
374 * both get and set features.
375 */
nvmet_passthru_get_set_features(struct nvmet_req * req)376 static u16 nvmet_passthru_get_set_features(struct nvmet_req *req)
377 {
378 switch (le32_to_cpu(req->cmd->features.fid)) {
379 case NVME_FEAT_ARBITRATION:
380 case NVME_FEAT_POWER_MGMT:
381 case NVME_FEAT_LBA_RANGE:
382 case NVME_FEAT_TEMP_THRESH:
383 case NVME_FEAT_ERR_RECOVERY:
384 case NVME_FEAT_VOLATILE_WC:
385 case NVME_FEAT_WRITE_ATOMIC:
386 case NVME_FEAT_AUTO_PST:
387 case NVME_FEAT_TIMESTAMP:
388 case NVME_FEAT_HCTM:
389 case NVME_FEAT_NOPSC:
390 case NVME_FEAT_RRL:
391 case NVME_FEAT_PLM_CONFIG:
392 case NVME_FEAT_PLM_WINDOW:
393 case NVME_FEAT_HOST_BEHAVIOR:
394 case NVME_FEAT_SANITIZE:
395 case NVME_FEAT_VENDOR_START ... NVME_FEAT_VENDOR_END:
396 return nvmet_setup_passthru_command(req);
397
398 case NVME_FEAT_ASYNC_EVENT:
399 /* There is no support for forwarding ASYNC events */
400 case NVME_FEAT_IRQ_COALESCE:
401 case NVME_FEAT_IRQ_CONFIG:
402 /* The IRQ settings will not apply to the target controller */
403 case NVME_FEAT_HOST_MEM_BUF:
404 /*
405 * Any HMB that's set will not be passed through and will
406 * not work as expected
407 */
408 case NVME_FEAT_SW_PROGRESS:
409 /*
410 * The Pre-Boot Software Load Count doesn't make much
411 * sense for a target to export
412 */
413 case NVME_FEAT_RESV_MASK:
414 case NVME_FEAT_RESV_PERSIST:
415 /* No reservations, see nvmet_parse_passthru_io_cmd() */
416 default:
417 return NVME_SC_INVALID_OPCODE | NVME_SC_DNR;
418 }
419 }
420
nvmet_parse_passthru_admin_cmd(struct nvmet_req * req)421 u16 nvmet_parse_passthru_admin_cmd(struct nvmet_req *req)
422 {
423 /* Reject any commands with non-sgl flags set (ie. fused commands) */
424 if (req->cmd->common.flags & ~NVME_CMD_SGL_ALL)
425 return NVME_SC_INVALID_FIELD;
426
427 /*
428 * Passthru all vendor specific commands
429 */
430 if (req->cmd->common.opcode >= nvme_admin_vendor_start)
431 return nvmet_setup_passthru_command(req);
432
433 switch (req->cmd->common.opcode) {
434 case nvme_admin_async_event:
435 req->execute = nvmet_execute_async_event;
436 return NVME_SC_SUCCESS;
437 case nvme_admin_keep_alive:
438 /*
439 * Most PCIe ctrls don't support keep alive cmd, we route keep
440 * alive to the non-passthru mode. In future please change this
441 * code when PCIe ctrls with keep alive support available.
442 */
443 req->execute = nvmet_execute_keep_alive;
444 return NVME_SC_SUCCESS;
445 case nvme_admin_set_features:
446 switch (le32_to_cpu(req->cmd->features.fid)) {
447 case NVME_FEAT_ASYNC_EVENT:
448 case NVME_FEAT_KATO:
449 case NVME_FEAT_NUM_QUEUES:
450 case NVME_FEAT_HOST_ID:
451 req->execute = nvmet_execute_set_features;
452 return NVME_SC_SUCCESS;
453 case NVME_FEAT_HOST_BEHAVIOR:
454 req->execute = nvmet_passthru_set_host_behaviour;
455 return NVME_SC_SUCCESS;
456 default:
457 return nvmet_passthru_get_set_features(req);
458 }
459 break;
460 case nvme_admin_get_features:
461 switch (le32_to_cpu(req->cmd->features.fid)) {
462 case NVME_FEAT_ASYNC_EVENT:
463 case NVME_FEAT_KATO:
464 case NVME_FEAT_NUM_QUEUES:
465 case NVME_FEAT_HOST_ID:
466 req->execute = nvmet_execute_get_features;
467 return NVME_SC_SUCCESS;
468 default:
469 return nvmet_passthru_get_set_features(req);
470 }
471 break;
472 case nvme_admin_identify:
473 switch (req->cmd->identify.cns) {
474 case NVME_ID_CNS_CTRL:
475 req->execute = nvmet_passthru_execute_cmd;
476 req->p.use_workqueue = true;
477 return NVME_SC_SUCCESS;
478 case NVME_ID_CNS_CS_CTRL:
479 switch (req->cmd->identify.csi) {
480 case NVME_CSI_ZNS:
481 req->execute = nvmet_passthru_execute_cmd;
482 req->p.use_workqueue = true;
483 return NVME_SC_SUCCESS;
484 }
485 return NVME_SC_INVALID_OPCODE | NVME_SC_DNR;
486 case NVME_ID_CNS_NS:
487 req->execute = nvmet_passthru_execute_cmd;
488 req->p.use_workqueue = true;
489 return NVME_SC_SUCCESS;
490 case NVME_ID_CNS_CS_NS:
491 switch (req->cmd->identify.csi) {
492 case NVME_CSI_ZNS:
493 req->execute = nvmet_passthru_execute_cmd;
494 req->p.use_workqueue = true;
495 return NVME_SC_SUCCESS;
496 }
497 return NVME_SC_INVALID_OPCODE | NVME_SC_DNR;
498 default:
499 return nvmet_setup_passthru_command(req);
500 }
501 case nvme_admin_get_log_page:
502 return nvmet_setup_passthru_command(req);
503 default:
504 /* Reject commands not in the allowlist above */
505 return nvmet_report_invalid_opcode(req);
506 }
507 }
508
nvmet_passthru_ctrl_enable(struct nvmet_subsys * subsys)509 int nvmet_passthru_ctrl_enable(struct nvmet_subsys *subsys)
510 {
511 struct nvme_ctrl *ctrl;
512 struct file *file;
513 int ret = -EINVAL;
514 void *old;
515
516 mutex_lock(&subsys->lock);
517 if (!subsys->passthru_ctrl_path)
518 goto out_unlock;
519 if (subsys->passthru_ctrl)
520 goto out_unlock;
521
522 if (subsys->nr_namespaces) {
523 pr_info("cannot enable both passthru and regular namespaces for a single subsystem");
524 goto out_unlock;
525 }
526
527 file = filp_open(subsys->passthru_ctrl_path, O_RDWR, 0);
528 if (IS_ERR(file)) {
529 ret = PTR_ERR(file);
530 goto out_unlock;
531 }
532
533 ctrl = nvme_ctrl_from_file(file);
534 if (!ctrl) {
535 pr_err("failed to open nvme controller %s\n",
536 subsys->passthru_ctrl_path);
537
538 goto out_put_file;
539 }
540
541 old = xa_cmpxchg(&passthru_subsystems, ctrl->cntlid, NULL,
542 subsys, GFP_KERNEL);
543 if (xa_is_err(old)) {
544 ret = xa_err(old);
545 goto out_put_file;
546 }
547
548 if (old)
549 goto out_put_file;
550
551 subsys->passthru_ctrl = ctrl;
552 subsys->ver = ctrl->vs;
553
554 if (subsys->ver < NVME_VS(1, 2, 1)) {
555 pr_warn("nvme controller version is too old: %llu.%llu.%llu, advertising 1.2.1\n",
556 NVME_MAJOR(subsys->ver), NVME_MINOR(subsys->ver),
557 NVME_TERTIARY(subsys->ver));
558 subsys->ver = NVME_VS(1, 2, 1);
559 }
560 nvme_get_ctrl(ctrl);
561 __module_get(subsys->passthru_ctrl->ops->module);
562 ret = 0;
563
564 out_put_file:
565 filp_close(file, NULL);
566 out_unlock:
567 mutex_unlock(&subsys->lock);
568 return ret;
569 }
570
__nvmet_passthru_ctrl_disable(struct nvmet_subsys * subsys)571 static void __nvmet_passthru_ctrl_disable(struct nvmet_subsys *subsys)
572 {
573 if (subsys->passthru_ctrl) {
574 xa_erase(&passthru_subsystems, subsys->passthru_ctrl->cntlid);
575 module_put(subsys->passthru_ctrl->ops->module);
576 nvme_put_ctrl(subsys->passthru_ctrl);
577 }
578 subsys->passthru_ctrl = NULL;
579 subsys->ver = NVMET_DEFAULT_VS;
580 }
581
nvmet_passthru_ctrl_disable(struct nvmet_subsys * subsys)582 void nvmet_passthru_ctrl_disable(struct nvmet_subsys *subsys)
583 {
584 mutex_lock(&subsys->lock);
585 __nvmet_passthru_ctrl_disable(subsys);
586 mutex_unlock(&subsys->lock);
587 }
588
nvmet_passthru_subsys_free(struct nvmet_subsys * subsys)589 void nvmet_passthru_subsys_free(struct nvmet_subsys *subsys)
590 {
591 mutex_lock(&subsys->lock);
592 __nvmet_passthru_ctrl_disable(subsys);
593 mutex_unlock(&subsys->lock);
594 kfree(subsys->passthru_ctrl_path);
595 }
596