2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (C) 2012-2013 Intel Corporation
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 #include <sys/cdefs.h>
30 __FBSDID("$FreeBSD$");
32 #include <sys/param.h>
37 #include <sys/fcntl.h>
38 #include <sys/ioccom.h>
39 #include <sys/malloc.h>
40 #include <sys/module.h>
42 #include <sys/systm.h>
44 #include <dev/pci/pcivar.h>
46 #include <geom/geom.h>
48 #include "nvme_private.h"
50 static void nvme_bio_child_inbed(struct bio *parent, int bio_error);
51 static void nvme_bio_child_done(void *arg,
52 const struct nvme_completion *cpl);
53 static uint32_t nvme_get_num_segments(uint64_t addr, uint64_t size,
55 static void nvme_free_child_bios(int num_bios,
56 struct bio **child_bios);
57 static struct bio ** nvme_allocate_child_bios(int num_bios);
58 static struct bio ** nvme_construct_child_bios(struct bio *bp,
61 static int nvme_ns_split_bio(struct nvme_namespace *ns,
66 nvme_ns_ioctl(struct cdev *cdev, u_long cmd, caddr_t arg, int flag,
69 struct nvme_namespace *ns;
70 struct nvme_controller *ctrlr;
71 struct nvme_pt_command *pt;
79 nvme_ns_test(ns, cmd, arg);
81 case NVME_PASSTHROUGH_CMD:
82 pt = (struct nvme_pt_command *)arg;
83 return (nvme_ctrlr_passthrough_cmd(ctrlr, pt, ns->id,
84 1 /* is_user_buffer */, 0 /* is_admin_cmd */));
87 struct nvme_get_nsid *gnsid = (struct nvme_get_nsid *)arg;
88 strncpy(gnsid->cdev, device_get_nameunit(ctrlr->dev),
94 *(off_t *)arg = (off_t)nvme_ns_get_size(ns);
97 *(u_int *)arg = nvme_ns_get_sector_size(ns);
107 nvme_ns_open(struct cdev *dev __unused, int flags, int fmt __unused,
113 error = securelevel_gt(td->td_ucred, 0);
119 nvme_ns_close(struct cdev *dev __unused, int flags, int fmt __unused,
127 nvme_ns_strategy_done(void *arg, const struct nvme_completion *cpl)
129 struct bio *bp = arg;
132 * TODO: add more extensive translation of NVMe status codes
133 * to different bio error codes (i.e. EIO, EINVAL, etc.)
135 if (nvme_completion_is_error(cpl)) {
137 bp->bio_flags |= BIO_ERROR;
138 bp->bio_resid = bp->bio_bcount;
146 nvme_ns_strategy(struct bio *bp)
148 struct nvme_namespace *ns;
151 ns = bp->bio_dev->si_drv1;
152 err = nvme_ns_bio_process(ns, bp, nvme_ns_strategy_done);
156 bp->bio_flags |= BIO_ERROR;
157 bp->bio_resid = bp->bio_bcount;
163 static struct cdevsw nvme_ns_cdevsw = {
164 .d_version = D_VERSION,
167 .d_write = physwrite,
168 .d_open = nvme_ns_open,
169 .d_close = nvme_ns_close,
170 .d_strategy = nvme_ns_strategy,
171 .d_ioctl = nvme_ns_ioctl
175 nvme_ns_get_max_io_xfer_size(struct nvme_namespace *ns)
177 return ns->ctrlr->max_xfer_size;
181 nvme_ns_get_sector_size(struct nvme_namespace *ns)
183 uint8_t flbas_fmt, lbads;
185 flbas_fmt = (ns->data.flbas >> NVME_NS_DATA_FLBAS_FORMAT_SHIFT) &
186 NVME_NS_DATA_FLBAS_FORMAT_MASK;
187 lbads = (ns->data.lbaf[flbas_fmt] >> NVME_NS_DATA_LBAF_LBADS_SHIFT) &
188 NVME_NS_DATA_LBAF_LBADS_MASK;
194 nvme_ns_get_num_sectors(struct nvme_namespace *ns)
196 return (ns->data.nsze);
200 nvme_ns_get_size(struct nvme_namespace *ns)
202 return (nvme_ns_get_num_sectors(ns) * nvme_ns_get_sector_size(ns));
206 nvme_ns_get_flags(struct nvme_namespace *ns)
212 nvme_ns_get_serial_number(struct nvme_namespace *ns)
214 return ((const char *)ns->ctrlr->cdata.sn);
218 nvme_ns_get_model_number(struct nvme_namespace *ns)
220 return ((const char *)ns->ctrlr->cdata.mn);
223 const struct nvme_namespace_data *
224 nvme_ns_get_data(struct nvme_namespace *ns)
231 nvme_ns_get_stripesize(struct nvme_namespace *ns)
234 return (ns->stripesize);
238 nvme_ns_bio_done(void *arg, const struct nvme_completion *status)
240 struct bio *bp = arg;
241 nvme_cb_fn_t bp_cb_fn;
243 bp_cb_fn = bp->bio_driver1;
246 free(bp->bio_driver2, M_NVME);
248 if (nvme_completion_is_error(status)) {
249 bp->bio_flags |= BIO_ERROR;
250 if (bp->bio_error == 0)
254 if ((bp->bio_flags & BIO_ERROR) == 0)
257 bp->bio_resid = bp->bio_bcount;
259 bp_cb_fn(bp, status);
263 nvme_bio_child_inbed(struct bio *parent, int bio_error)
265 struct nvme_completion parent_cpl;
268 if (bio_error != 0) {
269 parent->bio_flags |= BIO_ERROR;
270 parent->bio_error = bio_error;
274 * atomic_fetchadd will return value before adding 1, so we still
275 * must add 1 to get the updated inbed number. Save bio_children
276 * before incrementing to guard against race conditions when
277 * two children bios complete on different queues.
279 children = atomic_load_acq_int(&parent->bio_children);
280 inbed = atomic_fetchadd_int(&parent->bio_inbed, 1) + 1;
281 if (inbed == children) {
282 bzero(&parent_cpl, sizeof(parent_cpl));
283 if (parent->bio_flags & BIO_ERROR) {
284 parent_cpl.status &= ~(NVME_STATUS_SC_MASK << NVME_STATUS_SC_SHIFT);
285 parent_cpl.status |= (NVME_SC_DATA_TRANSFER_ERROR) << NVME_STATUS_SC_SHIFT;
287 nvme_ns_bio_done(parent, &parent_cpl);
292 nvme_bio_child_done(void *arg, const struct nvme_completion *cpl)
294 struct bio *child = arg;
298 parent = child->bio_parent;
299 g_destroy_bio(child);
300 bio_error = nvme_completion_is_error(cpl) ? EIO : 0;
301 nvme_bio_child_inbed(parent, bio_error);
305 nvme_get_num_segments(uint64_t addr, uint64_t size, uint32_t align)
307 uint32_t num_segs, offset, remainder;
312 KASSERT((align & (align - 1)) == 0, ("alignment not power of 2\n"));
314 num_segs = size / align;
315 remainder = size & (align - 1);
316 offset = addr & (align - 1);
317 if (remainder > 0 || offset > 0)
318 num_segs += 1 + (remainder + offset - 1) / align;
323 nvme_free_child_bios(int num_bios, struct bio **child_bios)
327 for (i = 0; i < num_bios; i++) {
328 if (child_bios[i] != NULL)
329 g_destroy_bio(child_bios[i]);
332 free(child_bios, M_NVME);
336 nvme_allocate_child_bios(int num_bios)
338 struct bio **child_bios;
341 child_bios = malloc(num_bios * sizeof(struct bio *), M_NVME, M_NOWAIT);
342 if (child_bios == NULL)
345 for (i = 0; i < num_bios; i++) {
346 child_bios[i] = g_new_bio();
347 if (child_bios[i] == NULL)
352 nvme_free_child_bios(num_bios, child_bios);
360 nvme_construct_child_bios(struct bio *bp, uint32_t alignment, int *num_bios)
362 struct bio **child_bios;
371 *num_bios = nvme_get_num_segments(bp->bio_offset, bp->bio_bcount,
373 child_bios = nvme_allocate_child_bios(*num_bios);
374 if (child_bios == NULL)
377 bp->bio_children = *num_bios;
379 cur_offset = bp->bio_offset;
380 rem_bcount = bp->bio_bcount;
382 ma_offset = bp->bio_ma_offset;
385 for (i = 0; i < *num_bios; i++) {
386 child = child_bios[i];
387 child->bio_parent = bp;
388 child->bio_cmd = bp->bio_cmd;
389 child->bio_offset = cur_offset;
390 child->bio_bcount = min(rem_bcount,
391 alignment - (cur_offset & (alignment - 1)));
392 child->bio_flags = bp->bio_flags;
393 if (bp->bio_flags & BIO_UNMAPPED) {
394 child->bio_ma_offset = ma_offset;
397 nvme_get_num_segments(child->bio_ma_offset,
398 child->bio_bcount, PAGE_SIZE);
399 ma_offset = (ma_offset + child->bio_bcount) &
401 ma += child->bio_ma_n;
405 child->bio_data = data;
406 data += child->bio_bcount;
408 cur_offset += child->bio_bcount;
409 rem_bcount -= child->bio_bcount;
416 nvme_ns_split_bio(struct nvme_namespace *ns, struct bio *bp,
420 struct bio **child_bios;
421 int err, i, num_bios;
423 child_bios = nvme_construct_child_bios(bp, alignment, &num_bios);
424 if (child_bios == NULL)
427 for (i = 0; i < num_bios; i++) {
428 child = child_bios[i];
429 err = nvme_ns_bio_process(ns, child, nvme_bio_child_done);
431 nvme_bio_child_inbed(bp, err);
432 g_destroy_bio(child);
436 free(child_bios, M_NVME);
441 nvme_ns_bio_process(struct nvme_namespace *ns, struct bio *bp,
444 struct nvme_dsm_range *dsm_range;
448 bp->bio_driver1 = cb_fn;
450 if (ns->stripesize > 0 &&
451 (bp->bio_cmd == BIO_READ || bp->bio_cmd == BIO_WRITE)) {
452 num_bios = nvme_get_num_segments(bp->bio_offset,
453 bp->bio_bcount, ns->stripesize);
455 return (nvme_ns_split_bio(ns, bp, ns->stripesize));
458 switch (bp->bio_cmd) {
460 err = nvme_ns_cmd_read_bio(ns, bp, nvme_ns_bio_done, bp);
463 err = nvme_ns_cmd_write_bio(ns, bp, nvme_ns_bio_done, bp);
466 err = nvme_ns_cmd_flush(ns, nvme_ns_bio_done, bp);
470 malloc(sizeof(struct nvme_dsm_range), M_NVME,
477 htole32(bp->bio_bcount/nvme_ns_get_sector_size(ns));
478 dsm_range->starting_lba =
479 htole64(bp->bio_offset/nvme_ns_get_sector_size(ns));
480 bp->bio_driver2 = dsm_range;
481 err = nvme_ns_cmd_deallocate(ns, dsm_range, 1,
482 nvme_ns_bio_done, bp);
484 free(dsm_range, M_NVME);
495 nvme_ns_ioctl_process(struct nvme_namespace *ns, u_long cmd, caddr_t arg,
496 int flag, struct thread *td)
498 return (nvme_ns_ioctl(ns->cdev, cmd, arg, flag, td));
502 nvme_ns_construct(struct nvme_namespace *ns, uint32_t id,
503 struct nvme_controller *ctrlr)
505 struct make_dev_args md_args;
506 struct nvme_completion_poll_status status;
517 * Older Intel devices advertise in vendor specific space an alignment
518 * that improves performance. If present use for the stripe size. NVMe
519 * 1.3 standardized this as NOIOB, and newer Intel drives use that.
521 switch (pci_get_devid(ctrlr->dev)) {
522 case 0x09538086: /* Intel DC PC3500 */
523 case 0x0a538086: /* Intel DC PC3520 */
524 case 0x0a548086: /* Intel DC PC4500 */
525 case 0x0a558086: /* Dell Intel P4600 */
526 if (ctrlr->cdata.vs[3] != 0)
528 (1 << ctrlr->cdata.vs[3]) * ctrlr->min_page_size;
535 * Namespaces are reconstructed after a controller reset, so check
536 * to make sure we only call mtx_init once on each mtx.
538 * TODO: Move this somewhere where it gets called at controller
539 * construction time, which is not invoked as part of each
542 if (!mtx_initialized(&ns->lock))
543 mtx_init(&ns->lock, "nvme ns lock", NULL, MTX_DEF);
546 nvme_ctrlr_cmd_identify_namespace(ctrlr, id, &ns->data,
547 nvme_completion_poll_cb, &status);
548 while (!atomic_load_acq_int(&status.done))
550 if (nvme_completion_is_error(&status.cpl)) {
551 nvme_printf(ctrlr, "nvme_identify_namespace failed\n");
555 /* Convert data to host endian */
556 nvme_namespace_data_swapbytes(&ns->data);
559 * If the size of is zero, chances are this isn't a valid
560 * namespace (eg one that's not been configured yet). The
561 * standard says the entire id will be zeros, so this is a
562 * cheap way to test for that.
564 if (ns->data.nsze == 0)
567 flbas_fmt = (ns->data.flbas >> NVME_NS_DATA_FLBAS_FORMAT_SHIFT) &
568 NVME_NS_DATA_FLBAS_FORMAT_MASK;
570 * Note: format is a 0-based value, so > is appropriate here,
573 if (flbas_fmt > ns->data.nlbaf) {
574 printf("lba format %d exceeds number supported (%d)\n",
575 flbas_fmt, ns->data.nlbaf + 1);
579 if (nvme_ctrlr_has_dataset_mgmt(&ctrlr->cdata))
580 ns->flags |= NVME_NS_DEALLOCATE_SUPPORTED;
582 vwc_present = (ctrlr->cdata.vwc >> NVME_CTRLR_DATA_VWC_PRESENT_SHIFT) &
583 NVME_CTRLR_DATA_VWC_PRESENT_MASK;
585 ns->flags |= NVME_NS_FLUSH_SUPPORTED;
588 * cdev may have already been created, if we are reconstructing the
589 * namespace after a controller-level reset.
591 if (ns->cdev != NULL)
595 * Namespace IDs start at 1, so we need to subtract 1 to create a
596 * correct unit number.
598 unit = device_get_unit(ctrlr->dev) * NVME_MAX_NAMESPACES + ns->id - 1;
600 make_dev_args_init(&md_args);
601 md_args.mda_devsw = &nvme_ns_cdevsw;
602 md_args.mda_unit = unit;
603 md_args.mda_mode = 0600;
604 md_args.mda_si_drv1 = ns;
605 res = make_dev_s(&md_args, &ns->cdev, "nvme%dns%d",
606 device_get_unit(ctrlr->dev), ns->id);
610 ns->cdev->si_flags |= SI_UNMAPPED;
615 void nvme_ns_destruct(struct nvme_namespace *ns)
618 if (ns->cdev != NULL)
619 destroy_dev(ns->cdev);