sys/dev/nvd/nvd.c

   1 /*-
   2  * Copyright (C) 2012-2016 Intel Corporation
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24  * SUCH DAMAGE.
  25  */
  26
  27 #include <sys/cdefs.h>
  28 __FBSDID("$FreeBSD$");
  29
  30 #include <sys/param.h>
  31 #include <sys/bio.h>
  32 #include <sys/kernel.h>
  33 #include <sys/malloc.h>
  34 #include <sys/module.h>
  35 #include <sys/sysctl.h>
  36 #include <sys/systm.h>
  37 #include <sys/taskqueue.h>
  38
  39 #include <geom/geom.h>
  40 #include <geom/geom_disk.h>
  41
  42 #include <dev/nvme/nvme.h>
  43
  44 #define NVD_STR         "nvd"
  45
  46 struct nvd_disk;
  47
  48 static disk_ioctl_t nvd_ioctl;
  49 static disk_strategy_t nvd_strategy;
  50 static dumper_t nvd_dump;
  51
  52 static void nvd_done(void *arg, const struct nvme_completion *cpl);
  53
  54 static void *nvd_new_disk(struct nvme_namespace *ns, void *ctrlr);
  55 static void destroy_geom_disk(struct nvd_disk *ndisk);
  56
  57 static void *nvd_new_controller(struct nvme_controller *ctrlr);
  58 static void nvd_controller_fail(void *ctrlr);
  59
  60 static int nvd_load(void);
  61 static void nvd_unload(void);
  62
  63 MALLOC_DEFINE(M_NVD, "nvd", "nvd(4) allocations");
  64
  65 struct nvme_consumer *consumer_handle;
  66
  67 struct nvd_disk {
  68
  69         struct bio_queue_head   bioq;
  70         struct task             bioqtask;
  71         struct mtx              bioqlock;
  72
  73         struct disk             *disk;
  74         struct taskqueue        *tq;
  75         struct nvme_namespace   *ns;
  76
  77         uint32_t                cur_depth;
  78         uint32_t                ordered_in_flight;
  79
  80         TAILQ_ENTRY(nvd_disk)   global_tailq;
  81         TAILQ_ENTRY(nvd_disk)   ctrlr_tailq;
  82 };
  83
  84 struct nvd_controller {
  85
  86         TAILQ_ENTRY(nvd_controller)     tailq;
  87         TAILQ_HEAD(, nvd_disk)          disk_head;
  88 };
  89
  90 static TAILQ_HEAD(, nvd_controller)     ctrlr_head;
  91 static TAILQ_HEAD(disk_list, nvd_disk)  disk_head;
  92
  93 static SYSCTL_NODE(_hw, OID_AUTO, nvd, CTLFLAG_RD, 0, "nvd driver parameters");
  94 /*
  95  * The NVMe specification does not define a maximum or optimal delete size, so
  96  *  technically max delete size is min(full size of the namespace, 2^32 - 1
  97  *  LBAs).  A single delete for a multi-TB NVMe namespace though may take much
  98  *  longer to complete than the nvme(4) I/O timeout period.  So choose a sensible
  99  *  default here that is still suitably large to minimize the number of overall
 100  *  delete operations.
 101  */
 102 static uint64_t nvd_delete_max = (1024 * 1024 * 1024);  /* 1GB */
 103 SYSCTL_UQUAD(_hw_nvd, OID_AUTO, delete_max, CTLFLAG_RDTUN, &nvd_delete_max, 0,
 104              "nvd maximum BIO_DELETE size in bytes");
 105
 106 static int nvd_modevent(module_t mod, int type, void *arg)
 107 {
 108         int error = 0;
 109
 110         switch (type) {
 111         case MOD_LOAD:
 112                 error = nvd_load();
 113                 break;
 114         case MOD_UNLOAD:
 115                 nvd_unload();
 116                 break;
 117         default:
 118                 break;
 119         }
 120
 121         return (error);
 122 }
 123
 124 moduledata_t nvd_mod = {
 125         NVD_STR,
 126         (modeventhand_t)nvd_modevent,
 127         0
 128 };
 129
 130 DECLARE_MODULE(nvd, nvd_mod, SI_SUB_DRIVERS, SI_ORDER_ANY);
 131 MODULE_VERSION(nvd, 1);
 132 MODULE_DEPEND(nvd, nvme, 1, 1, 1);
 133
 134 static int
 135 nvd_load()
 136 {
 137
 138         TAILQ_INIT(&ctrlr_head);
 139         TAILQ_INIT(&disk_head);
 140
 141         consumer_handle = nvme_register_consumer(nvd_new_disk,
 142             nvd_new_controller, NULL, nvd_controller_fail);
 143
 144         return (consumer_handle != NULL ? 0 : -1);
 145 }
 146
 147 static void
 148 nvd_unload()
 149 {
 150         struct nvd_controller   *ctrlr;
 151         struct nvd_disk         *disk;
 152
 153         while (!TAILQ_EMPTY(&ctrlr_head)) {
 154                 ctrlr = TAILQ_FIRST(&ctrlr_head);
 155                 TAILQ_REMOVE(&ctrlr_head, ctrlr, tailq);
 156                 free(ctrlr, M_NVD);
 157         }
 158
 159         while (!TAILQ_EMPTY(&disk_head)) {
 160                 disk = TAILQ_FIRST(&disk_head);
 161                 TAILQ_REMOVE(&disk_head, disk, global_tailq);
 162                 destroy_geom_disk(disk);
 163                 free(disk, M_NVD);
 164         }
 165
 166         nvme_unregister_consumer(consumer_handle);
 167 }
 168
 169 static int
 170 nvd_bio_submit(struct nvd_disk *ndisk, struct bio *bp)
 171 {
 172         int err;
 173
 174         bp->bio_driver1 = NULL;
 175         atomic_add_int(&ndisk->cur_depth, 1);
 176         err = nvme_ns_bio_process(ndisk->ns, bp, nvd_done);
 177         if (err) {
 178                 atomic_add_int(&ndisk->cur_depth, -1);
 179                 if (__predict_false(bp->bio_flags & BIO_ORDERED))
 180                         atomic_add_int(&ndisk->ordered_in_flight, -1);
 181                 bp->bio_error = err;
 182                 bp->bio_flags |= BIO_ERROR;
 183                 bp->bio_resid = bp->bio_bcount;
 184                 biodone(bp);
 185                 return (-1);
 186         }
 187
 188         return (0);
 189 }
 190
 191 static void
 192 nvd_strategy(struct bio *bp)
 193 {
 194         struct nvd_disk *ndisk;
 195
 196         ndisk = (struct nvd_disk *)bp->bio_disk->d_drv1;
 197
 198         if (__predict_false(bp->bio_flags & BIO_ORDERED))
 199                 atomic_add_int(&ndisk->ordered_in_flight, 1);
 200
 201         if (__predict_true(ndisk->ordered_in_flight == 0)) {
 202                 nvd_bio_submit(ndisk, bp);
 203                 return;
 204         }
 205
 206         /*
 207          * There are ordered bios in flight, so we need to submit
 208          *  bios through the task queue to enforce ordering.
 209          */
 210         mtx_lock(&ndisk->bioqlock);
 211         bioq_insert_tail(&ndisk->bioq, bp);
 212         mtx_unlock(&ndisk->bioqlock);
 213         taskqueue_enqueue(ndisk->tq, &ndisk->bioqtask);
 214 }
 215
 216 static int
 217 nvd_ioctl(struct disk *ndisk, u_long cmd, void *data, int fflag,
 218     struct thread *td)
 219 {
 220         int ret = 0;
 221
 222         switch (cmd) {
 223         default:
 224                 ret = EIO;
 225         }
 226
 227         return (ret);
 228 }
 229
 230 static int
 231 nvd_dump(void *arg, void *virt, vm_offset_t phys, off_t offset, size_t len)
 232 {
 233         struct nvd_disk *ndisk;
 234         struct disk *dp;
 235
 236         dp = arg;
 237         ndisk = dp->d_drv1;
 238
 239         return (nvme_ns_dump(ndisk->ns, virt, offset, len));
 240 }
 241
 242 static void
 243 nvd_done(void *arg, const struct nvme_completion *cpl)
 244 {
 245         struct bio *bp;
 246         struct nvd_disk *ndisk;
 247
 248         bp = (struct bio *)arg;
 249
 250         ndisk = bp->bio_disk->d_drv1;
 251
 252         atomic_add_int(&ndisk->cur_depth, -1);
 253         if (__predict_false(bp->bio_flags & BIO_ORDERED))
 254                 atomic_add_int(&ndisk->ordered_in_flight, -1);
 255
 256         biodone(bp);
 257 }
 258
 259 static void
 260 nvd_bioq_process(void *arg, int pending)
 261 {
 262         struct nvd_disk *ndisk = arg;
 263         struct bio *bp;
 264
 265         for (;;) {
 266                 mtx_lock(&ndisk->bioqlock);
 267                 bp = bioq_takefirst(&ndisk->bioq);
 268                 mtx_unlock(&ndisk->bioqlock);
 269                 if (bp == NULL)
 270                         break;
 271
 272                 if (nvd_bio_submit(ndisk, bp) != 0) {
 273                         continue;
 274                 }
 275
 276 #ifdef BIO_ORDERED
 277                 /*
 278                  * BIO_ORDERED flag dictates that the bio with BIO_ORDERED
 279                  *  flag set must be completed before proceeding with
 280                  *  additional bios.
 281                  */
 282                 if (bp->bio_flags & BIO_ORDERED) {
 283                         while (ndisk->cur_depth > 0) {
 284                                 pause("nvd flush", 1);
 285                         }
 286                 }
 287 #endif
 288         }
 289 }
 290
 291 static void *
 292 nvd_new_controller(struct nvme_controller *ctrlr)
 293 {
 294         struct nvd_controller   *nvd_ctrlr;
 295
 296         nvd_ctrlr = malloc(sizeof(struct nvd_controller), M_NVD,
 297             M_ZERO | M_WAITOK);
 298
 299         TAILQ_INIT(&nvd_ctrlr->disk_head);
 300         TAILQ_INSERT_TAIL(&ctrlr_head, nvd_ctrlr, tailq);
 301
 302         return (nvd_ctrlr);
 303 }
 304
 305 static void *
 306 nvd_new_disk(struct nvme_namespace *ns, void *ctrlr_arg)
 307 {
 308         uint8_t                 descr[NVME_MODEL_NUMBER_LENGTH+1];
 309         struct nvd_disk         *ndisk;
 310         struct disk             *disk;
 311         struct nvd_controller   *ctrlr = ctrlr_arg;
 312
 313         ndisk = malloc(sizeof(struct nvd_disk), M_NVD, M_ZERO | M_WAITOK);
 314
 315         disk = disk_alloc();
 316         disk->d_strategy = nvd_strategy;
 317         disk->d_ioctl = nvd_ioctl;
 318         disk->d_dump = nvd_dump;
 319         disk->d_name = NVD_STR;
 320         disk->d_drv1 = ndisk;
 321
 322         disk->d_maxsize = nvme_ns_get_max_io_xfer_size(ns);
 323         disk->d_sectorsize = nvme_ns_get_sector_size(ns);
 324         disk->d_mediasize = (off_t)nvme_ns_get_size(ns);
 325         disk->d_delmaxsize = (off_t)nvme_ns_get_size(ns);
 326         if (disk->d_delmaxsize > nvd_delete_max)
 327                 disk->d_delmaxsize = nvd_delete_max;
 328         disk->d_stripesize = nvme_ns_get_stripesize(ns);
 329
 330         if (TAILQ_EMPTY(&disk_head))
 331                 disk->d_unit = 0;
 332         else
 333                 disk->d_unit =
 334                     TAILQ_LAST(&disk_head, disk_list)->disk->d_unit + 1;
 335
 336         disk->d_flags = DISKFLAG_DIRECT_COMPLETION;
 337
 338         if (nvme_ns_get_flags(ns) & NVME_NS_DEALLOCATE_SUPPORTED)
 339                 disk->d_flags |= DISKFLAG_CANDELETE;
 340
 341         if (nvme_ns_get_flags(ns) & NVME_NS_FLUSH_SUPPORTED)
 342                 disk->d_flags |= DISKFLAG_CANFLUSHCACHE;
 343
 344 /* ifdef used here to ease porting to stable branches at a later point. */
 345 #ifdef DISKFLAG_UNMAPPED_BIO
 346         disk->d_flags |= DISKFLAG_UNMAPPED_BIO;
 347 #endif
 348
 349         /*
 350          * d_ident and d_descr are both far bigger than the length of either
 351          *  the serial or model number strings.
 352          */
 353         nvme_strvis(disk->d_ident, nvme_ns_get_serial_number(ns),
 354             sizeof(disk->d_ident), NVME_SERIAL_NUMBER_LENGTH);
 355
 356         nvme_strvis(descr, nvme_ns_get_model_number(ns), sizeof(descr),
 357             NVME_MODEL_NUMBER_LENGTH);
 358
 359 #if __FreeBSD_version >= 900034
 360         strlcpy(disk->d_descr, descr, sizeof(descr));
 361 #endif
 362
 363         ndisk->ns = ns;
 364         ndisk->disk = disk;
 365         ndisk->cur_depth = 0;
 366         ndisk->ordered_in_flight = 0;
 367
 368         mtx_init(&ndisk->bioqlock, "NVD bioq lock", NULL, MTX_DEF);
 369         bioq_init(&ndisk->bioq);
 370
 371         TASK_INIT(&ndisk->bioqtask, 0, nvd_bioq_process, ndisk);
 372         ndisk->tq = taskqueue_create("nvd_taskq", M_WAITOK,
 373             taskqueue_thread_enqueue, &ndisk->tq);
 374         taskqueue_start_threads(&ndisk->tq, 1, PI_DISK, "nvd taskq");
 375
 376         TAILQ_INSERT_TAIL(&disk_head, ndisk, global_tailq);
 377         TAILQ_INSERT_TAIL(&ctrlr->disk_head, ndisk, ctrlr_tailq);
 378
 379         disk_create(disk, DISK_VERSION);
 380
 381         printf(NVD_STR"%u: <%s> NVMe namespace\n", disk->d_unit, descr);
 382         printf(NVD_STR"%u: %juMB (%ju %u byte sectors)\n", disk->d_unit,
 383                 (uintmax_t)disk->d_mediasize / (1024*1024),
 384                 (uintmax_t)disk->d_mediasize / disk->d_sectorsize,
 385                 disk->d_sectorsize);
 386
 387         return (NULL);
 388 }
 389
 390 static void
 391 destroy_geom_disk(struct nvd_disk *ndisk)
 392 {
 393         struct bio      *bp;
 394         struct disk     *disk;
 395         uint32_t        unit;
 396         int             cnt = 0;
 397
 398         disk = ndisk->disk;
 399         unit = disk->d_unit;
 400         taskqueue_free(ndisk->tq);
 401
 402         disk_destroy(ndisk->disk);
 403
 404         mtx_lock(&ndisk->bioqlock);
 405         for (;;) {
 406                 bp = bioq_takefirst(&ndisk->bioq);
 407                 if (bp == NULL)
 408                         break;
 409                 bp->bio_error = EIO;
 410                 bp->bio_flags |= BIO_ERROR;
 411                 bp->bio_resid = bp->bio_bcount;
 412                 cnt++;
 413                 biodone(bp);
 414         }
 415
 416         printf(NVD_STR"%u: lost device - %d outstanding\n", unit, cnt);
 417         printf(NVD_STR"%u: removing device entry\n", unit);
 418
 419         mtx_unlock(&ndisk->bioqlock);
 420
 421         mtx_destroy(&ndisk->bioqlock);
 422 }
 423
 424 static void
 425 nvd_controller_fail(void *ctrlr_arg)
 426 {
 427         struct nvd_controller   *ctrlr = ctrlr_arg;
 428         struct nvd_disk         *disk;
 429
 430         while (!TAILQ_EMPTY(&ctrlr->disk_head)) {
 431                 disk = TAILQ_FIRST(&ctrlr->disk_head);
 432                 TAILQ_REMOVE(&disk_head, disk, global_tailq);
 433                 TAILQ_REMOVE(&ctrlr->disk_head, disk, ctrlr_tailq);
 434                 destroy_geom_disk(disk);
 435                 free(disk, M_NVD);
 436         }
 437
 438         TAILQ_REMOVE(&ctrlr_head, ctrlr, tailq);
 439         free(ctrlr, M_NVD);
 440 }
 441