block/genhd.c

   1 // SPDX-License-Identifier: GPL-2.0
   2 /*
   3  *  gendisk handling
   4  *
   5  * Portions Copyright (C) 2020 Christoph Hellwig
   6  */
   7
   8 #include <linux/module.h>
   9 #include <linux/ctype.h>
  10 #include <linux/fs.h>
  11 #include <linux/genhd.h>
  12 #include <linux/kdev_t.h>
  13 #include <linux/kernel.h>
  14 #include <linux/blkdev.h>
  15 #include <linux/backing-dev.h>
  16 #include <linux/init.h>
  17 #include <linux/spinlock.h>
  18 #include <linux/proc_fs.h>
  19 #include <linux/seq_file.h>
  20 #include <linux/slab.h>
  21 #include <linux/kmod.h>
  22 #include <linux/major.h>
  23 #include <linux/mutex.h>
  24 #include <linux/idr.h>
  25 #include <linux/log2.h>
  26 #include <linux/pm_runtime.h>
  27 #include <linux/badblocks.h>
  28
  29 #include "blk.h"
  30 #include "blk-rq-qos.h"
  31
  32 static struct kobject *block_depr;
  33
  34 /*
  35  * Unique, monotonically increasing sequential number associated with block
  36  * devices instances (i.e. incremented each time a device is attached).
  37  * Associating uevents with block devices in userspace is difficult and racy:
  38  * the uevent netlink socket is lossy, and on slow and overloaded systems has
  39  * a very high latency.
  40  * Block devices do not have exclusive owners in userspace, any process can set
  41  * one up (e.g. loop devices). Moreover, device names can be reused (e.g. loop0
  42  * can be reused again and again).
  43  * A userspace process setting up a block device and watching for its events
  44  * cannot thus reliably tell whether an event relates to the device it just set
  45  * up or another earlier instance with the same name.
  46  * This sequential number allows userspace processes to solve this problem, and
  47  * uniquely associate an uevent to the lifetime to a device.
  48  */
  49 static atomic64_t diskseq;
  50
  51 /* for extended dynamic devt allocation, currently only one major is used */
  52 #define NR_EXT_DEVT             (1 << MINORBITS)
  53 static DEFINE_IDA(ext_devt_ida);
  54
  55 void set_capacity(struct gendisk *disk, sector_t sectors)
  56 {
  57         struct block_device *bdev = disk->part0;
  58
  59         spin_lock(&bdev->bd_size_lock);
  60         i_size_write(bdev->bd_inode, (loff_t)sectors << SECTOR_SHIFT);
  61         spin_unlock(&bdev->bd_size_lock);
  62 }
  63 EXPORT_SYMBOL(set_capacity);
  64
  65 /*
  66  * Set disk capacity and notify if the size is not currently zero and will not
  67  * be set to zero.  Returns true if a uevent was sent, otherwise false.
  68  */
  69 bool set_capacity_and_notify(struct gendisk *disk, sector_t size)
  70 {
  71         sector_t capacity = get_capacity(disk);
  72         char *envp[] = { "RESIZE=1", NULL };
  73
  74         set_capacity(disk, size);
  75
  76         /*
  77          * Only print a message and send a uevent if the gendisk is user visible
  78          * and alive.  This avoids spamming the log and udev when setting the
  79          * initial capacity during probing.
  80          */
  81         if (size == capacity ||
  82             !disk_live(disk) ||
  83             (disk->flags & GENHD_FL_HIDDEN))
  84                 return false;
  85
  86         pr_info("%s: detected capacity change from %lld to %lld\n",
  87                 disk->disk_name, capacity, size);
  88
  89         /*
  90          * Historically we did not send a uevent for changes to/from an empty
  91          * device.
  92          */
  93         if (!capacity || !size)
  94                 return false;
  95         kobject_uevent_env(&disk_to_dev(disk)->kobj, KOBJ_CHANGE, envp);
  96         return true;
  97 }
  98 EXPORT_SYMBOL_GPL(set_capacity_and_notify);
  99
 100 /*
 101  * Format the device name of the indicated block device into the supplied buffer
 102  * and return a pointer to that same buffer for convenience.
 103  *
 104  * Note: do not use this in new code, use the %pg specifier to sprintf and
 105  * printk insted.
 106  */
 107 const char *bdevname(struct block_device *bdev, char *buf)
 108 {
 109         struct gendisk *hd = bdev->bd_disk;
 110         int partno = bdev->bd_partno;
 111
 112         if (!partno)
 113                 snprintf(buf, BDEVNAME_SIZE, "%s", hd->disk_name);
 114         else if (isdigit(hd->disk_name[strlen(hd->disk_name)-1]))
 115                 snprintf(buf, BDEVNAME_SIZE, "%sp%d", hd->disk_name, partno);
 116         else
 117                 snprintf(buf, BDEVNAME_SIZE, "%s%d", hd->disk_name, partno);
 118
 119         return buf;
 120 }
 121 EXPORT_SYMBOL(bdevname);
 122
 123 static void part_stat_read_all(struct block_device *part,
 124                 struct disk_stats *stat)
 125 {
 126         int cpu;
 127
 128         memset(stat, 0, sizeof(struct disk_stats));
 129         for_each_possible_cpu(cpu) {
 130                 struct disk_stats *ptr = per_cpu_ptr(part->bd_stats, cpu);
 131                 int group;
 132
 133                 for (group = 0; group < NR_STAT_GROUPS; group++) {
 134                         stat->nsecs[group] += ptr->nsecs[group];
 135                         stat->sectors[group] += ptr->sectors[group];
 136                         stat->ios[group] += ptr->ios[group];
 137                         stat->merges[group] += ptr->merges[group];
 138                 }
 139
 140                 stat->io_ticks += ptr->io_ticks;
 141         }
 142 }
 143
 144 static unsigned int part_in_flight(struct block_device *part)
 145 {
 146         unsigned int inflight = 0;
 147         int cpu;
 148
 149         for_each_possible_cpu(cpu) {
 150                 inflight += part_stat_local_read_cpu(part, in_flight[0], cpu) +
 151                             part_stat_local_read_cpu(part, in_flight[1], cpu);
 152         }
 153         if ((int)inflight < 0)
 154                 inflight = 0;
 155
 156         return inflight;
 157 }
 158
 159 static void part_in_flight_rw(struct block_device *part,
 160                 unsigned int inflight[2])
 161 {
 162         int cpu;
 163
 164         inflight[0] = 0;
 165         inflight[1] = 0;
 166         for_each_possible_cpu(cpu) {
 167                 inflight[0] += part_stat_local_read_cpu(part, in_flight[0], cpu);
 168                 inflight[1] += part_stat_local_read_cpu(part, in_flight[1], cpu);
 169         }
 170         if ((int)inflight[0] < 0)
 171                 inflight[0] = 0;
 172         if ((int)inflight[1] < 0)
 173                 inflight[1] = 0;
 174 }
 175
 176 /*
 177  * Can be deleted altogether. Later.
 178  *
 179  */
 180 #define BLKDEV_MAJOR_HASH_SIZE 255
 181 static struct blk_major_name {
 182         struct blk_major_name *next;
 183         int major;
 184         char name[16];
 185         void (*probe)(dev_t devt);
 186 } *major_names[BLKDEV_MAJOR_HASH_SIZE];
 187 static DEFINE_MUTEX(major_names_lock);
 188 static DEFINE_SPINLOCK(major_names_spinlock);
 189
 190 /* index in the above - for now: assume no multimajor ranges */
 191 static inline int major_to_index(unsigned major)
 192 {
 193         return major % BLKDEV_MAJOR_HASH_SIZE;
 194 }
 195
 196 #ifdef CONFIG_PROC_FS
 197 void blkdev_show(struct seq_file *seqf, off_t offset)
 198 {
 199         struct blk_major_name *dp;
 200
 201         spin_lock(&major_names_spinlock);
 202         for (dp = major_names[major_to_index(offset)]; dp; dp = dp->next)
 203                 if (dp->major == offset)
 204                         seq_printf(seqf, "%3d %s\n", dp->major, dp->name);
 205         spin_unlock(&major_names_spinlock);
 206 }
 207 #endif /* CONFIG_PROC_FS */
 208
 209 /**
 210  * __register_blkdev - register a new block device
 211  *
 212  * @major: the requested major device number [1..BLKDEV_MAJOR_MAX-1]. If
 213  *         @major = 0, try to allocate any unused major number.
 214  * @name: the name of the new block device as a zero terminated string
 215  * @probe: allback that is called on access to any minor number of @major
 216  *
 217  * The @name must be unique within the system.
 218  *
 219  * The return value depends on the @major input parameter:
 220  *
 221  *  - if a major device number was requested in range [1..BLKDEV_MAJOR_MAX-1]
 222  *    then the function returns zero on success, or a negative error code
 223  *  - if any unused major number was requested with @major = 0 parameter
 224  *    then the return value is the allocated major number in range
 225  *    [1..BLKDEV_MAJOR_MAX-1] or a negative error code otherwise
 226  *
 227  * See Documentation/admin-guide/devices.txt for the list of allocated
 228  * major numbers.
 229  *
 230  * Use register_blkdev instead for any new code.
 231  */
 232 int __register_blkdev(unsigned int major, const char *name,
 233                 void (*probe)(dev_t devt))
 234 {
 235         struct blk_major_name **n, *p;
 236         int index, ret = 0;
 237
 238         mutex_lock(&major_names_lock);
 239
 240         /* temporary */
 241         if (major == 0) {
 242                 for (index = ARRAY_SIZE(major_names)-1; index > 0; index--) {
 243                         if (major_names[index] == NULL)
 244                                 break;
 245                 }
 246
 247                 if (index == 0) {
 248                         printk("%s: failed to get major for %s\n",
 249                                __func__, name);
 250                         ret = -EBUSY;
 251                         goto out;
 252                 }
 253                 major = index;
 254                 ret = major;
 255         }
 256
 257         if (major >= BLKDEV_MAJOR_MAX) {
 258                 pr_err("%s: major requested (%u) is greater than the maximum (%u) for %s\n",
 259                        __func__, major, BLKDEV_MAJOR_MAX-1, name);
 260
 261                 ret = -EINVAL;
 262                 goto out;
 263         }
 264
 265         p = kmalloc(sizeof(struct blk_major_name), GFP_KERNEL);
 266         if (p == NULL) {
 267                 ret = -ENOMEM;
 268                 goto out;
 269         }
 270
 271         p->major = major;
 272         p->probe = probe;
 273         strlcpy(p->name, name, sizeof(p->name));
 274         p->next = NULL;
 275         index = major_to_index(major);
 276
 277         spin_lock(&major_names_spinlock);
 278         for (n = &major_names[index]; *n; n = &(*n)->next) {
 279                 if ((*n)->major == major)
 280                         break;
 281         }
 282         if (!*n)
 283                 *n = p;
 284         else
 285                 ret = -EBUSY;
 286         spin_unlock(&major_names_spinlock);
 287
 288         if (ret < 0) {
 289                 printk("register_blkdev: cannot get major %u for %s\n",
 290                        major, name);
 291                 kfree(p);
 292         }
 293 out:
 294         mutex_unlock(&major_names_lock);
 295         return ret;
 296 }
 297 EXPORT_SYMBOL(__register_blkdev);
 298
 299 void unregister_blkdev(unsigned int major, const char *name)
 300 {
 301         struct blk_major_name **n;
 302         struct blk_major_name *p = NULL;
 303         int index = major_to_index(major);
 304
 305         mutex_lock(&major_names_lock);
 306         spin_lock(&major_names_spinlock);
 307         for (n = &major_names[index]; *n; n = &(*n)->next)
 308                 if ((*n)->major == major)
 309                         break;
 310         if (!*n || strcmp((*n)->name, name)) {
 311                 WARN_ON(1);
 312         } else {
 313                 p = *n;
 314                 *n = p->next;
 315         }
 316         spin_unlock(&major_names_spinlock);
 317         mutex_unlock(&major_names_lock);
 318         kfree(p);
 319 }
 320
 321 EXPORT_SYMBOL(unregister_blkdev);
 322
 323 int blk_alloc_ext_minor(void)
 324 {
 325         int idx;
 326
 327         idx = ida_alloc_range(&ext_devt_ida, 0, NR_EXT_DEVT, GFP_KERNEL);
 328         if (idx == -ENOSPC)
 329                 return -EBUSY;
 330         return idx;
 331 }
 332
 333 void blk_free_ext_minor(unsigned int minor)
 334 {
 335         ida_free(&ext_devt_ida, minor);
 336 }
 337
 338 static char *bdevt_str(dev_t devt, char *buf)
 339 {
 340         if (MAJOR(devt) <= 0xff && MINOR(devt) <= 0xff) {
 341                 char tbuf[BDEVT_SIZE];
 342                 snprintf(tbuf, BDEVT_SIZE, "%02x%02x", MAJOR(devt), MINOR(devt));
 343                 snprintf(buf, BDEVT_SIZE, "%-9s", tbuf);
 344         } else
 345                 snprintf(buf, BDEVT_SIZE, "%03x:%05x", MAJOR(devt), MINOR(devt));
 346
 347         return buf;
 348 }
 349
 350 void disk_uevent(struct gendisk *disk, enum kobject_action action)
 351 {
 352         struct block_device *part;
 353         unsigned long idx;
 354
 355         rcu_read_lock();
 356         xa_for_each(&disk->part_tbl, idx, part) {
 357                 if (bdev_is_partition(part) && !bdev_nr_sectors(part))
 358                         continue;
 359                 if (!kobject_get_unless_zero(&part->bd_device.kobj))
 360                         continue;
 361
 362                 rcu_read_unlock();
 363                 kobject_uevent(bdev_kobj(part), action);
 364                 put_device(&part->bd_device);
 365                 rcu_read_lock();
 366         }
 367         rcu_read_unlock();
 368 }
 369 EXPORT_SYMBOL_GPL(disk_uevent);
 370
 371 static void disk_scan_partitions(struct gendisk *disk)
 372 {
 373         struct block_device *bdev;
 374
 375         if (!get_capacity(disk) || !disk_part_scan_enabled(disk))
 376                 return;
 377
 378         set_bit(GD_NEED_PART_SCAN, &disk->state);
 379         bdev = blkdev_get_by_dev(disk_devt(disk), FMODE_READ, NULL);
 380         if (!IS_ERR(bdev))
 381                 blkdev_put(bdev, FMODE_READ);
 382 }
 383
 384 /**
 385  * device_add_disk - add disk information to kernel list
 386  * @parent: parent device for the disk
 387  * @disk: per-device partitioning information
 388  * @groups: Additional per-device sysfs groups
 389  *
 390  * This function registers the partitioning information in @disk
 391  * with the kernel.
 392  */
 393 int device_add_disk(struct device *parent, struct gendisk *disk,
 394                      const struct attribute_group **groups)
 395
 396 {
 397         struct device *ddev = disk_to_dev(disk);
 398         int ret;
 399
 400         /*
 401          * The disk queue should now be all set with enough information about
 402          * the device for the elevator code to pick an adequate default
 403          * elevator if one is needed, that is, for devices requesting queue
 404          * registration.
 405          */
 406         elevator_init_mq(disk->queue);
 407
 408         /*
 409          * If the driver provides an explicit major number it also must provide
 410          * the number of minors numbers supported, and those will be used to
 411          * setup the gendisk.
 412          * Otherwise just allocate the device numbers for both the whole device
 413          * and all partitions from the extended dev_t space.
 414          */
 415         if (disk->major) {
 416                 if (WARN_ON(!disk->minors))
 417                         return -EINVAL;
 418
 419                 if (disk->minors > DISK_MAX_PARTS) {
 420                         pr_err("block: can't allocate more than %d partitions\n",
 421                                 DISK_MAX_PARTS);
 422                         disk->minors = DISK_MAX_PARTS;
 423                 }
 424         } else {
 425                 if (WARN_ON(disk->minors))
 426                         return -EINVAL;
 427
 428                 ret = blk_alloc_ext_minor();
 429                 if (ret < 0)
 430                         return ret;
 431                 disk->major = BLOCK_EXT_MAJOR;
 432                 disk->first_minor = ret;
 433                 disk->flags |= GENHD_FL_EXT_DEVT;
 434         }
 435
 436         ret = disk_alloc_events(disk);
 437         if (ret)
 438                 goto out_free_ext_minor;
 439
 440         /* delay uevents, until we scanned partition table */
 441         dev_set_uevent_suppress(ddev, 1);
 442
 443         ddev->parent = parent;
 444         ddev->groups = groups;
 445         dev_set_name(ddev, "%s", disk->disk_name);
 446         if (!(disk->flags & GENHD_FL_HIDDEN))
 447                 ddev->devt = MKDEV(disk->major, disk->first_minor);
 448         ret = device_add(ddev);
 449         if (ret)
 450                 goto out_disk_release_events;
 451         if (!sysfs_deprecated) {
 452                 ret = sysfs_create_link(block_depr, &ddev->kobj,
 453                                         kobject_name(&ddev->kobj));
 454                 if (ret)
 455                         goto out_device_del;
 456         }
 457
 458         /*
 459          * avoid probable deadlock caused by allocating memory with
 460          * GFP_KERNEL in runtime_resume callback of its all ancestor
 461          * devices
 462          */
 463         pm_runtime_set_memalloc_noio(ddev, true);
 464
 465         ret = blk_integrity_add(disk);
 466         if (ret)
 467                 goto out_del_block_link;
 468
 469         disk->part0->bd_holder_dir =
 470                 kobject_create_and_add("holders", &ddev->kobj);
 471         if (!disk->part0->bd_holder_dir)
 472                 goto out_del_integrity;
 473         disk->slave_dir = kobject_create_and_add("slaves", &ddev->kobj);
 474         if (!disk->slave_dir)
 475                 goto out_put_holder_dir;
 476
 477         ret = bd_register_pending_holders(disk);
 478         if (ret < 0)
 479                 goto out_put_slave_dir;
 480
 481         ret = blk_register_queue(disk);
 482         if (ret)
 483                 goto out_put_slave_dir;
 484
 485         if (disk->flags & GENHD_FL_HIDDEN) {
 486                 /*
 487                  * Don't let hidden disks show up in /proc/partitions,
 488                  * and don't bother scanning for partitions either.
 489                  */
 490                 disk->flags |= GENHD_FL_SUPPRESS_PARTITION_INFO;
 491                 disk->flags |= GENHD_FL_NO_PART_SCAN;
 492         } else {
 493                 ret = bdi_register(disk->bdi, "%u:%u",
 494                                    disk->major, disk->first_minor);
 495                 if (ret)
 496                         goto out_unregister_queue;
 497                 bdi_set_owner(disk->bdi, ddev);
 498                 ret = sysfs_create_link(&ddev->kobj,
 499                                         &disk->bdi->dev->kobj, "bdi");
 500                 if (ret)
 501                         goto out_unregister_bdi;
 502
 503                 bdev_add(disk->part0, ddev->devt);
 504                 disk_scan_partitions(disk);
 505
 506                 /*
 507                  * Announce the disk and partitions after all partitions are
 508                  * created. (for hidden disks uevents remain suppressed forever)
 509                  */
 510                 dev_set_uevent_suppress(ddev, 0);
 511                 disk_uevent(disk, KOBJ_ADD);
 512         }
 513
 514         disk_update_readahead(disk);
 515         disk_add_events(disk);
 516         return 0;
 517
 518 out_unregister_bdi:
 519         if (!(disk->flags & GENHD_FL_HIDDEN))
 520                 bdi_unregister(disk->bdi);
 521 out_unregister_queue:
 522         blk_unregister_queue(disk);
 523 out_put_slave_dir:
 524         kobject_put(disk->slave_dir);
 525 out_put_holder_dir:
 526         kobject_put(disk->part0->bd_holder_dir);
 527 out_del_integrity:
 528         blk_integrity_del(disk);
 529 out_del_block_link:
 530         if (!sysfs_deprecated)
 531                 sysfs_remove_link(block_depr, dev_name(ddev));
 532 out_device_del:
 533         device_del(ddev);
 534 out_disk_release_events:
 535         disk_release_events(disk);
 536 out_free_ext_minor:
 537         if (disk->major == BLOCK_EXT_MAJOR)
 538                 blk_free_ext_minor(disk->first_minor);
 539         return WARN_ON_ONCE(ret); /* keep until all callers handle errors */
 540 }
 541 EXPORT_SYMBOL(device_add_disk);
 542
 543 /**
 544  * del_gendisk - remove the gendisk
 545  * @disk: the struct gendisk to remove
 546  *
 547  * Removes the gendisk and all its associated resources. This deletes the
 548  * partitions associated with the gendisk, and unregisters the associated
 549  * request_queue.
 550  *
 551  * This is the counter to the respective __device_add_disk() call.
 552  *
 553  * The final removal of the struct gendisk happens when its refcount reaches 0
 554  * with put_disk(), which should be called after del_gendisk(), if
 555  * __device_add_disk() was used.
 556  *
 557  * Drivers exist which depend on the release of the gendisk to be synchronous,
 558  * it should not be deferred.
 559  *
 560  * Context: can sleep
 561  */
 562 void del_gendisk(struct gendisk *disk)
 563 {
 564         struct request_queue *q = disk->queue;
 565
 566         might_sleep();
 567
 568         if (WARN_ON_ONCE(!disk_live(disk) && !(disk->flags & GENHD_FL_HIDDEN)))
 569                 return;
 570
 571         blk_integrity_del(disk);
 572         disk_del_events(disk);
 573
 574         mutex_lock(&disk->open_mutex);
 575         remove_inode_hash(disk->part0->bd_inode);
 576         blk_drop_partitions(disk);
 577         mutex_unlock(&disk->open_mutex);
 578
 579         fsync_bdev(disk->part0);
 580         __invalidate_device(disk->part0, true);
 581
 582         /*
 583          * Fail any new I/O.
 584          */
 585         set_bit(GD_DEAD, &disk->state);
 586         set_capacity(disk, 0);
 587
 588         /*
 589          * Prevent new I/O from crossing bio_queue_enter().
 590          */
 591         blk_queue_start_drain(q);
 592         blk_mq_freeze_queue_wait(q);
 593
 594         rq_qos_exit(q);
 595         blk_sync_queue(q);
 596         blk_flush_integrity();
 597         /*
 598          * Allow using passthrough request again after the queue is torn down.
 599          */
 600         blk_queue_flag_clear(QUEUE_FLAG_INIT_DONE, q);
 601         __blk_mq_unfreeze_queue(q, true);
 602
 603         if (!(disk->flags & GENHD_FL_HIDDEN)) {
 604                 sysfs_remove_link(&disk_to_dev(disk)->kobj, "bdi");
 605
 606                 /*
 607                  * Unregister bdi before releasing device numbers (as they can
 608                  * get reused and we'd get clashes in sysfs).
 609                  */
 610                 bdi_unregister(disk->bdi);
 611         }
 612
 613         blk_unregister_queue(disk);
 614
 615         kobject_put(disk->part0->bd_holder_dir);
 616         kobject_put(disk->slave_dir);
 617
 618         part_stat_set_all(disk->part0, 0);
 619         disk->part0->bd_stamp = 0;
 620         if (!sysfs_deprecated)
 621                 sysfs_remove_link(block_depr, dev_name(disk_to_dev(disk)));
 622         pm_runtime_set_memalloc_noio(disk_to_dev(disk), false);
 623         device_del(disk_to_dev(disk));
 624 }
 625 EXPORT_SYMBOL(del_gendisk);
 626
 627 /* sysfs access to bad-blocks list. */
 628 static ssize_t disk_badblocks_show(struct device *dev,
 629                                         struct device_attribute *attr,
 630                                         char *page)
 631 {
 632         struct gendisk *disk = dev_to_disk(dev);
 633
 634         if (!disk->bb)
 635                 return sprintf(page, "\n");
 636
 637         return badblocks_show(disk->bb, page, 0);
 638 }
 639
 640 static ssize_t disk_badblocks_store(struct device *dev,
 641                                         struct device_attribute *attr,
 642                                         const char *page, size_t len)
 643 {
 644         struct gendisk *disk = dev_to_disk(dev);
 645
 646         if (!disk->bb)
 647                 return -ENXIO;
 648
 649         return badblocks_store(disk->bb, page, len, 0);
 650 }
 651
 652 void blk_request_module(dev_t devt)
 653 {
 654         unsigned int major = MAJOR(devt);
 655         struct blk_major_name **n;
 656
 657         mutex_lock(&major_names_lock);
 658         for (n = &major_names[major_to_index(major)]; *n; n = &(*n)->next) {
 659                 if ((*n)->major == major && (*n)->probe) {
 660                         (*n)->probe(devt);
 661                         mutex_unlock(&major_names_lock);
 662                         return;
 663                 }
 664         }
 665         mutex_unlock(&major_names_lock);
 666
 667         if (request_module("block-major-%d-%d", MAJOR(devt), MINOR(devt)) > 0)
 668                 /* Make old-style 2.4 aliases work */
 669                 request_module("block-major-%d", MAJOR(devt));
 670 }
 671
 672 /*
 673  * print a full list of all partitions - intended for places where the root
 674  * filesystem can't be mounted and thus to give the victim some idea of what
 675  * went wrong
 676  */
 677 void __init printk_all_partitions(void)
 678 {
 679         struct class_dev_iter iter;
 680         struct device *dev;
 681
 682         class_dev_iter_init(&iter, &block_class, NULL, &disk_type);
 683         while ((dev = class_dev_iter_next(&iter))) {
 684                 struct gendisk *disk = dev_to_disk(dev);
 685                 struct block_device *part;
 686                 char devt_buf[BDEVT_SIZE];
 687                 unsigned long idx;
 688
 689                 /*
 690                  * Don't show empty devices or things that have been
 691                  * suppressed
 692                  */
 693                 if (get_capacity(disk) == 0 ||
 694                     (disk->flags & GENHD_FL_SUPPRESS_PARTITION_INFO))
 695                         continue;
 696
 697                 /*
 698                  * Note, unlike /proc/partitions, I am showing the numbers in
 699                  * hex - the same format as the root= option takes.
 700                  */
 701                 rcu_read_lock();
 702                 xa_for_each(&disk->part_tbl, idx, part) {
 703                         if (!bdev_nr_sectors(part))
 704                                 continue;
 705                         printk("%s%s %10llu %pg %s",
 706                                bdev_is_partition(part) ? "  " : "",
 707                                bdevt_str(part->bd_dev, devt_buf),
 708                                bdev_nr_sectors(part) >> 1, part,
 709                                part->bd_meta_info ?
 710                                         part->bd_meta_info->uuid : "");
 711                         if (bdev_is_partition(part))
 712                                 printk("\n");
 713                         else if (dev->parent && dev->parent->driver)
 714                                 printk(" driver: %s\n",
 715                                         dev->parent->driver->name);
 716                         else
 717                                 printk(" (driver?)\n");
 718                 }
 719                 rcu_read_unlock();
 720         }
 721         class_dev_iter_exit(&iter);
 722 }
 723
 724 #ifdef CONFIG_PROC_FS
 725 /* iterator */
 726 static void *disk_seqf_start(struct seq_file *seqf, loff_t *pos)
 727 {
 728         loff_t skip = *pos;
 729         struct class_dev_iter *iter;
 730         struct device *dev;
 731
 732         iter = kmalloc(sizeof(*iter), GFP_KERNEL);
 733         if (!iter)
 734                 return ERR_PTR(-ENOMEM);
 735
 736         seqf->private = iter;
 737         class_dev_iter_init(iter, &block_class, NULL, &disk_type);
 738         do {
 739                 dev = class_dev_iter_next(iter);
 740                 if (!dev)
 741                         return NULL;
 742         } while (skip--);
 743
 744         return dev_to_disk(dev);
 745 }
 746
 747 static void *disk_seqf_next(struct seq_file *seqf, void *v, loff_t *pos)
 748 {
 749         struct device *dev;
 750
 751         (*pos)++;
 752         dev = class_dev_iter_next(seqf->private);
 753         if (dev)
 754                 return dev_to_disk(dev);
 755
 756         return NULL;
 757 }
 758
 759 static void disk_seqf_stop(struct seq_file *seqf, void *v)
 760 {
 761         struct class_dev_iter *iter = seqf->private;
 762
 763         /* stop is called even after start failed :-( */
 764         if (iter) {
 765                 class_dev_iter_exit(iter);
 766                 kfree(iter);
 767                 seqf->private = NULL;
 768         }
 769 }
 770
 771 static void *show_partition_start(struct seq_file *seqf, loff_t *pos)
 772 {
 773         void *p;
 774
 775         p = disk_seqf_start(seqf, pos);
 776         if (!IS_ERR_OR_NULL(p) && !*pos)
 777                 seq_puts(seqf, "major minor  #blocks  name\n\n");
 778         return p;
 779 }
 780
 781 static int show_partition(struct seq_file *seqf, void *v)
 782 {
 783         struct gendisk *sgp = v;
 784         struct block_device *part;
 785         unsigned long idx;
 786
 787         /* Don't show non-partitionable removeable devices or empty devices */
 788         if (!get_capacity(sgp) || (!disk_max_parts(sgp) &&
 789                                    (sgp->flags & GENHD_FL_REMOVABLE)))
 790                 return 0;
 791         if (sgp->flags & GENHD_FL_SUPPRESS_PARTITION_INFO)
 792                 return 0;
 793
 794         rcu_read_lock();
 795         xa_for_each(&sgp->part_tbl, idx, part) {
 796                 if (!bdev_nr_sectors(part))
 797                         continue;
 798                 seq_printf(seqf, "%4d  %7d %10llu %pg\n",
 799                            MAJOR(part->bd_dev), MINOR(part->bd_dev),
 800                            bdev_nr_sectors(part) >> 1, part);
 801         }
 802         rcu_read_unlock();
 803         return 0;
 804 }
 805
 806 static const struct seq_operations partitions_op = {
 807         .start  = show_partition_start,
 808         .next   = disk_seqf_next,
 809         .stop   = disk_seqf_stop,
 810         .show   = show_partition
 811 };
 812 #endif
 813
 814 static int __init genhd_device_init(void)
 815 {
 816         int error;
 817
 818         block_class.dev_kobj = sysfs_dev_block_kobj;
 819         error = class_register(&block_class);
 820         if (unlikely(error))
 821                 return error;
 822         blk_dev_init();
 823
 824         register_blkdev(BLOCK_EXT_MAJOR, "blkext");
 825
 826         /* create top-level block dir */
 827         if (!sysfs_deprecated)
 828                 block_depr = kobject_create_and_add("block", NULL);
 829         return 0;
 830 }
 831
 832 subsys_initcall(genhd_device_init);
 833
 834 static ssize_t disk_range_show(struct device *dev,
 835                                struct device_attribute *attr, char *buf)
 836 {
 837         struct gendisk *disk = dev_to_disk(dev);
 838
 839         return sprintf(buf, "%d\n", disk->minors);
 840 }
 841
 842 static ssize_t disk_ext_range_show(struct device *dev,
 843                                    struct device_attribute *attr, char *buf)
 844 {
 845         struct gendisk *disk = dev_to_disk(dev);
 846
 847         return sprintf(buf, "%d\n", disk_max_parts(disk));
 848 }
 849
 850 static ssize_t disk_removable_show(struct device *dev,
 851                                    struct device_attribute *attr, char *buf)
 852 {
 853         struct gendisk *disk = dev_to_disk(dev);
 854
 855         return sprintf(buf, "%d\n",
 856                        (disk->flags & GENHD_FL_REMOVABLE ? 1 : 0));
 857 }
 858
 859 static ssize_t disk_hidden_show(struct device *dev,
 860                                    struct device_attribute *attr, char *buf)
 861 {
 862         struct gendisk *disk = dev_to_disk(dev);
 863
 864         return sprintf(buf, "%d\n",
 865                        (disk->flags & GENHD_FL_HIDDEN ? 1 : 0));
 866 }
 867
 868 static ssize_t disk_ro_show(struct device *dev,
 869                                    struct device_attribute *attr, char *buf)
 870 {
 871         struct gendisk *disk = dev_to_disk(dev);
 872
 873         return sprintf(buf, "%d\n", get_disk_ro(disk) ? 1 : 0);
 874 }
 875
 876 ssize_t part_size_show(struct device *dev,
 877                        struct device_attribute *attr, char *buf)
 878 {
 879         return sprintf(buf, "%llu\n", bdev_nr_sectors(dev_to_bdev(dev)));
 880 }
 881
 882 ssize_t part_stat_show(struct device *dev,
 883                        struct device_attribute *attr, char *buf)
 884 {
 885         struct block_device *bdev = dev_to_bdev(dev);
 886         struct request_queue *q = bdev_get_queue(bdev);
 887         struct disk_stats stat;
 888         unsigned int inflight;
 889
 890         part_stat_read_all(bdev, &stat);
 891         if (queue_is_mq(q))
 892                 inflight = blk_mq_in_flight(q, bdev);
 893         else
 894                 inflight = part_in_flight(bdev);
 895
 896         return sprintf(buf,
 897                 "%8lu %8lu %8llu %8u "
 898                 "%8lu %8lu %8llu %8u "
 899                 "%8u %8u %8u "
 900                 "%8lu %8lu %8llu %8u "
 901                 "%8lu %8u"
 902                 "\n",
 903                 stat.ios[STAT_READ],
 904                 stat.merges[STAT_READ],
 905                 (unsigned long long)stat.sectors[STAT_READ],
 906                 (unsigned int)div_u64(stat.nsecs[STAT_READ], NSEC_PER_MSEC),
 907                 stat.ios[STAT_WRITE],
 908                 stat.merges[STAT_WRITE],
 909                 (unsigned long long)stat.sectors[STAT_WRITE],
 910                 (unsigned int)div_u64(stat.nsecs[STAT_WRITE], NSEC_PER_MSEC),
 911                 inflight,
 912                 jiffies_to_msecs(stat.io_ticks),
 913                 (unsigned int)div_u64(stat.nsecs[STAT_READ] +
 914                                       stat.nsecs[STAT_WRITE] +
 915                                       stat.nsecs[STAT_DISCARD] +
 916                                       stat.nsecs[STAT_FLUSH],
 917                                                 NSEC_PER_MSEC),
 918                 stat.ios[STAT_DISCARD],
 919                 stat.merges[STAT_DISCARD],
 920                 (unsigned long long)stat.sectors[STAT_DISCARD],
 921                 (unsigned int)div_u64(stat.nsecs[STAT_DISCARD], NSEC_PER_MSEC),
 922                 stat.ios[STAT_FLUSH],
 923                 (unsigned int)div_u64(stat.nsecs[STAT_FLUSH], NSEC_PER_MSEC));
 924 }
 925
 926 ssize_t part_inflight_show(struct device *dev, struct device_attribute *attr,
 927                            char *buf)
 928 {
 929         struct block_device *bdev = dev_to_bdev(dev);
 930         struct request_queue *q = bdev_get_queue(bdev);
 931         unsigned int inflight[2];
 932
 933         if (queue_is_mq(q))
 934                 blk_mq_in_flight_rw(q, bdev, inflight);
 935         else
 936                 part_in_flight_rw(bdev, inflight);
 937
 938         return sprintf(buf, "%8u %8u\n", inflight[0], inflight[1]);
 939 }
 940
 941 static ssize_t disk_capability_show(struct device *dev,
 942                                     struct device_attribute *attr, char *buf)
 943 {
 944         struct gendisk *disk = dev_to_disk(dev);
 945
 946         return sprintf(buf, "%x\n", disk->flags);
 947 }
 948
 949 static ssize_t disk_alignment_offset_show(struct device *dev,
 950                                           struct device_attribute *attr,
 951                                           char *buf)
 952 {
 953         struct gendisk *disk = dev_to_disk(dev);
 954
 955         return sprintf(buf, "%d\n", queue_alignment_offset(disk->queue));
 956 }
 957
 958 static ssize_t disk_discard_alignment_show(struct device *dev,
 959                                            struct device_attribute *attr,
 960                                            char *buf)
 961 {
 962         struct gendisk *disk = dev_to_disk(dev);
 963
 964         return sprintf(buf, "%d\n", queue_discard_alignment(disk->queue));
 965 }
 966
 967 static ssize_t diskseq_show(struct device *dev,
 968                             struct device_attribute *attr, char *buf)
 969 {
 970         struct gendisk *disk = dev_to_disk(dev);
 971
 972         return sprintf(buf, "%llu\n", disk->diskseq);
 973 }
 974
 975 static DEVICE_ATTR(range, 0444, disk_range_show, NULL);
 976 static DEVICE_ATTR(ext_range, 0444, disk_ext_range_show, NULL);
 977 static DEVICE_ATTR(removable, 0444, disk_removable_show, NULL);
 978 static DEVICE_ATTR(hidden, 0444, disk_hidden_show, NULL);
 979 static DEVICE_ATTR(ro, 0444, disk_ro_show, NULL);
 980 static DEVICE_ATTR(size, 0444, part_size_show, NULL);
 981 static DEVICE_ATTR(alignment_offset, 0444, disk_alignment_offset_show, NULL);
 982 static DEVICE_ATTR(discard_alignment, 0444, disk_discard_alignment_show, NULL);
 983 static DEVICE_ATTR(capability, 0444, disk_capability_show, NULL);
 984 static DEVICE_ATTR(stat, 0444, part_stat_show, NULL);
 985 static DEVICE_ATTR(inflight, 0444, part_inflight_show, NULL);
 986 static DEVICE_ATTR(badblocks, 0644, disk_badblocks_show, disk_badblocks_store);
 987 static DEVICE_ATTR(diskseq, 0444, diskseq_show, NULL);
 988
 989 #ifdef CONFIG_FAIL_MAKE_REQUEST
 990 ssize_t part_fail_show(struct device *dev,
 991                        struct device_attribute *attr, char *buf)
 992 {
 993         return sprintf(buf, "%d\n", dev_to_bdev(dev)->bd_make_it_fail);
 994 }
 995
 996 ssize_t part_fail_store(struct device *dev,
 997                         struct device_attribute *attr,
 998                         const char *buf, size_t count)
 999 {
1000         int i;
1001
1002         if (count > 0 && sscanf(buf, "%d", &i) > 0)
1003                 dev_to_bdev(dev)->bd_make_it_fail = i;
1004
1005         return count;
1006 }
1007
1008 static struct device_attribute dev_attr_fail =
1009         __ATTR(make-it-fail, 0644, part_fail_show, part_fail_store);
1010 #endif /* CONFIG_FAIL_MAKE_REQUEST */
1011
1012 #ifdef CONFIG_FAIL_IO_TIMEOUT
1013 static struct device_attribute dev_attr_fail_timeout =
1014         __ATTR(io-timeout-fail, 0644, part_timeout_show, part_timeout_store);
1015 #endif
1016
1017 static struct attribute *disk_attrs[] = {
1018         &dev_attr_range.attr,
1019         &dev_attr_ext_range.attr,
1020         &dev_attr_removable.attr,
1021         &dev_attr_hidden.attr,
1022         &dev_attr_ro.attr,
1023         &dev_attr_size.attr,
1024         &dev_attr_alignment_offset.attr,
1025         &dev_attr_discard_alignment.attr,
1026         &dev_attr_capability.attr,
1027         &dev_attr_stat.attr,
1028         &dev_attr_inflight.attr,
1029         &dev_attr_badblocks.attr,
1030         &dev_attr_events.attr,
1031         &dev_attr_events_async.attr,
1032         &dev_attr_events_poll_msecs.attr,
1033         &dev_attr_diskseq.attr,
1034 #ifdef CONFIG_FAIL_MAKE_REQUEST
1035         &dev_attr_fail.attr,
1036 #endif
1037 #ifdef CONFIG_FAIL_IO_TIMEOUT
1038         &dev_attr_fail_timeout.attr,
1039 #endif
1040         NULL
1041 };
1042
1043 static umode_t disk_visible(struct kobject *kobj, struct attribute *a, int n)
1044 {
1045         struct device *dev = container_of(kobj, typeof(*dev), kobj);
1046         struct gendisk *disk = dev_to_disk(dev);
1047
1048         if (a == &dev_attr_badblocks.attr && !disk->bb)
1049                 return 0;
1050         return a->mode;
1051 }
1052
1053 static struct attribute_group disk_attr_group = {
1054         .attrs = disk_attrs,
1055         .is_visible = disk_visible,
1056 };
1057
1058 static const struct attribute_group *disk_attr_groups[] = {
1059         &disk_attr_group,
1060         NULL
1061 };
1062
1063 /**
1064  * disk_release - releases all allocated resources of the gendisk
1065  * @dev: the device representing this disk
1066  *
1067  * This function releases all allocated resources of the gendisk.
1068  *
1069  * Drivers which used __device_add_disk() have a gendisk with a request_queue
1070  * assigned. Since the request_queue sits on top of the gendisk for these
1071  * drivers we also call blk_put_queue() for them, and we expect the
1072  * request_queue refcount to reach 0 at this point, and so the request_queue
1073  * will also be freed prior to the disk.
1074  *
1075  * Context: can sleep
1076  */
1077 static void disk_release(struct device *dev)
1078 {
1079         struct gendisk *disk = dev_to_disk(dev);
1080
1081         might_sleep();
1082         WARN_ON_ONCE(disk_live(disk));
1083
1084         disk_release_events(disk);
1085         kfree(disk->random);
1086         xa_destroy(&disk->part_tbl);
1087         disk->queue->disk = NULL;
1088         blk_put_queue(disk->queue);
1089         iput(disk->part0->bd_inode);    /* frees the disk */
1090 }
1091
1092 static int block_uevent(struct device *dev, struct kobj_uevent_env *env)
1093 {
1094         struct gendisk *disk = dev_to_disk(dev);
1095
1096         return add_uevent_var(env, "DISKSEQ=%llu", disk->diskseq);
1097 }
1098
1099 struct class block_class = {
1100         .name           = "block",
1101         .dev_uevent     = block_uevent,
1102 };
1103
1104 static char *block_devnode(struct device *dev, umode_t *mode,
1105                            kuid_t *uid, kgid_t *gid)
1106 {
1107         struct gendisk *disk = dev_to_disk(dev);
1108
1109         if (disk->fops->devnode)
1110                 return disk->fops->devnode(disk, mode);
1111         return NULL;
1112 }
1113
1114 const struct device_type disk_type = {
1115         .name           = "disk",
1116         .groups         = disk_attr_groups,
1117         .release        = disk_release,
1118         .devnode        = block_devnode,
1119 };
1120
1121 #ifdef CONFIG_PROC_FS
1122 /*
1123  * aggregate disk stat collector.  Uses the same stats that the sysfs
1124  * entries do, above, but makes them available through one seq_file.
1125  *
1126  * The output looks suspiciously like /proc/partitions with a bunch of
1127  * extra fields.
1128  */
1129 static int diskstats_show(struct seq_file *seqf, void *v)
1130 {
1131         struct gendisk *gp = v;
1132         struct block_device *hd;
1133         unsigned int inflight;
1134         struct disk_stats stat;
1135         unsigned long idx;
1136
1137         /*
1138         if (&disk_to_dev(gp)->kobj.entry == block_class.devices.next)
1139                 seq_puts(seqf,  "major minor name"
1140                                 "     rio rmerge rsect ruse wio wmerge "
1141                                 "wsect wuse running use aveq"
1142                                 "\n\n");
1143         */
1144
1145         rcu_read_lock();
1146         xa_for_each(&gp->part_tbl, idx, hd) {
1147                 if (bdev_is_partition(hd) && !bdev_nr_sectors(hd))
1148                         continue;
1149                 part_stat_read_all(hd, &stat);
1150                 if (queue_is_mq(gp->queue))
1151                         inflight = blk_mq_in_flight(gp->queue, hd);
1152                 else
1153                         inflight = part_in_flight(hd);
1154
1155                 seq_printf(seqf, "%4d %7d %pg "
1156                            "%lu %lu %lu %u "
1157                            "%lu %lu %lu %u "
1158                            "%u %u %u "
1159                            "%lu %lu %lu %u "
1160                            "%lu %u"
1161                            "\n",
1162                            MAJOR(hd->bd_dev), MINOR(hd->bd_dev), hd,
1163                            stat.ios[STAT_READ],
1164                            stat.merges[STAT_READ],
1165                            stat.sectors[STAT_READ],
1166                            (unsigned int)div_u64(stat.nsecs[STAT_READ],
1167                                                         NSEC_PER_MSEC),
1168                            stat.ios[STAT_WRITE],
1169                            stat.merges[STAT_WRITE],
1170                            stat.sectors[STAT_WRITE],
1171                            (unsigned int)div_u64(stat.nsecs[STAT_WRITE],
1172                                                         NSEC_PER_MSEC),
1173                            inflight,
1174                            jiffies_to_msecs(stat.io_ticks),
1175                            (unsigned int)div_u64(stat.nsecs[STAT_READ] +
1176                                                  stat.nsecs[STAT_WRITE] +
1177                                                  stat.nsecs[STAT_DISCARD] +
1178                                                  stat.nsecs[STAT_FLUSH],
1179                                                         NSEC_PER_MSEC),
1180                            stat.ios[STAT_DISCARD],
1181                            stat.merges[STAT_DISCARD],
1182                            stat.sectors[STAT_DISCARD],
1183                            (unsigned int)div_u64(stat.nsecs[STAT_DISCARD],
1184                                                  NSEC_PER_MSEC),
1185                            stat.ios[STAT_FLUSH],
1186                            (unsigned int)div_u64(stat.nsecs[STAT_FLUSH],
1187                                                  NSEC_PER_MSEC)
1188                         );
1189         }
1190         rcu_read_unlock();
1191
1192         return 0;
1193 }
1194
1195 static const struct seq_operations diskstats_op = {
1196         .start  = disk_seqf_start,
1197         .next   = disk_seqf_next,
1198         .stop   = disk_seqf_stop,
1199         .show   = diskstats_show
1200 };
1201
1202 static int __init proc_genhd_init(void)
1203 {
1204         proc_create_seq("diskstats", 0, NULL, &diskstats_op);
1205         proc_create_seq("partitions", 0, NULL, &partitions_op);
1206         return 0;
1207 }
1208 module_init(proc_genhd_init);
1209 #endif /* CONFIG_PROC_FS */
1210
1211 dev_t part_devt(struct gendisk *disk, u8 partno)
1212 {
1213         struct block_device *part;
1214         dev_t devt = 0;
1215
1216         rcu_read_lock();
1217         part = xa_load(&disk->part_tbl, partno);
1218         if (part)
1219                 devt = part->bd_dev;
1220         rcu_read_unlock();
1221
1222         return devt;
1223 }
1224
1225 dev_t blk_lookup_devt(const char *name, int partno)
1226 {
1227         dev_t devt = MKDEV(0, 0);
1228         struct class_dev_iter iter;
1229         struct device *dev;
1230
1231         class_dev_iter_init(&iter, &block_class, NULL, &disk_type);
1232         while ((dev = class_dev_iter_next(&iter))) {
1233                 struct gendisk *disk = dev_to_disk(dev);
1234
1235                 if (strcmp(dev_name(dev), name))
1236                         continue;
1237
1238                 if (partno < disk->minors) {
1239                         /* We need to return the right devno, even
1240                          * if the partition doesn't exist yet.
1241                          */
1242                         devt = MKDEV(MAJOR(dev->devt),
1243                                      MINOR(dev->devt) + partno);
1244                 } else {
1245                         devt = part_devt(disk, partno);
1246                         if (devt)
1247                                 break;
1248                 }
1249         }
1250         class_dev_iter_exit(&iter);
1251         return devt;
1252 }
1253
1254 struct gendisk *__alloc_disk_node(struct request_queue *q, int node_id,
1255                 struct lock_class_key *lkclass)
1256 {
1257         struct gendisk *disk;
1258
1259         if (!blk_get_queue(q))
1260                 return NULL;
1261
1262         disk = kzalloc_node(sizeof(struct gendisk), GFP_KERNEL, node_id);
1263         if (!disk)
1264                 goto out_put_queue;
1265
1266         disk->bdi = bdi_alloc(node_id);
1267         if (!disk->bdi)
1268                 goto out_free_disk;
1269
1270         /* bdev_alloc() might need the queue, set before the first call */
1271         disk->queue = q;
1272
1273         disk->part0 = bdev_alloc(disk, 0);
1274         if (!disk->part0)
1275                 goto out_free_bdi;
1276
1277         disk->node_id = node_id;
1278         mutex_init(&disk->open_mutex);
1279         xa_init(&disk->part_tbl);
1280         if (xa_insert(&disk->part_tbl, 0, disk->part0, GFP_KERNEL))
1281                 goto out_destroy_part_tbl;
1282
1283         rand_initialize_disk(disk);
1284         disk_to_dev(disk)->class = &block_class;
1285         disk_to_dev(disk)->type = &disk_type;
1286         device_initialize(disk_to_dev(disk));
1287         inc_diskseq(disk);
1288         q->disk = disk;
1289         lockdep_init_map(&disk->lockdep_map, "(bio completion)", lkclass, 0);
1290 #ifdef CONFIG_BLOCK_HOLDER_DEPRECATED
1291         INIT_LIST_HEAD(&disk->slave_bdevs);
1292 #endif
1293         return disk;
1294
1295 out_destroy_part_tbl:
1296         xa_destroy(&disk->part_tbl);
1297         disk->part0->bd_disk = NULL;
1298         iput(disk->part0->bd_inode);
1299 out_free_bdi:
1300         bdi_put(disk->bdi);
1301 out_free_disk:
1302         kfree(disk);
1303 out_put_queue:
1304         blk_put_queue(q);
1305         return NULL;
1306 }
1307 EXPORT_SYMBOL(__alloc_disk_node);
1308
1309 struct gendisk *__blk_alloc_disk(int node, struct lock_class_key *lkclass)
1310 {
1311         struct request_queue *q;
1312         struct gendisk *disk;
1313
1314         q = blk_alloc_queue(node);
1315         if (!q)
1316                 return NULL;
1317
1318         disk = __alloc_disk_node(q, node, lkclass);
1319         if (!disk) {
1320                 blk_cleanup_queue(q);
1321                 return NULL;
1322         }
1323         return disk;
1324 }
1325 EXPORT_SYMBOL(__blk_alloc_disk);
1326
1327 /**
1328  * put_disk - decrements the gendisk refcount
1329  * @disk: the struct gendisk to decrement the refcount for
1330  *
1331  * This decrements the refcount for the struct gendisk. When this reaches 0
1332  * we'll have disk_release() called.
1333  *
1334  * Context: Any context, but the last reference must not be dropped from
1335  *          atomic context.
1336  */
1337 void put_disk(struct gendisk *disk)
1338 {
1339         if (disk)
1340                 put_device(disk_to_dev(disk));
1341 }
1342 EXPORT_SYMBOL(put_disk);
1343
1344 /**
1345  * blk_cleanup_disk - shutdown a gendisk allocated by blk_alloc_disk
1346  * @disk: gendisk to shutdown
1347  *
1348  * Mark the queue hanging off @disk DYING, drain all pending requests, then mark
1349  * the queue DEAD, destroy and put it and the gendisk structure.
1350  *
1351  * Context: can sleep
1352  */
1353 void blk_cleanup_disk(struct gendisk *disk)
1354 {
1355         blk_cleanup_queue(disk->queue);
1356         put_disk(disk);
1357 }
1358 EXPORT_SYMBOL(blk_cleanup_disk);
1359
1360 static void set_disk_ro_uevent(struct gendisk *gd, int ro)
1361 {
1362         char event[] = "DISK_RO=1";
1363         char *envp[] = { event, NULL };
1364
1365         if (!ro)
1366                 event[8] = '0';
1367         kobject_uevent_env(&disk_to_dev(gd)->kobj, KOBJ_CHANGE, envp);
1368 }
1369
1370 /**
1371  * set_disk_ro - set a gendisk read-only
1372  * @disk:       gendisk to operate on
1373  * @read_only:  %true to set the disk read-only, %false set the disk read/write
1374  *
1375  * This function is used to indicate whether a given disk device should have its
1376  * read-only flag set. set_disk_ro() is typically used by device drivers to
1377  * indicate whether the underlying physical device is write-protected.
1378  */
1379 void set_disk_ro(struct gendisk *disk, bool read_only)
1380 {
1381         if (read_only) {
1382                 if (test_and_set_bit(GD_READ_ONLY, &disk->state))
1383                         return;
1384         } else {
1385                 if (!test_and_clear_bit(GD_READ_ONLY, &disk->state))
1386                         return;
1387         }
1388         set_disk_ro_uevent(disk, read_only);
1389 }
1390 EXPORT_SYMBOL(set_disk_ro);
1391
1392 void inc_diskseq(struct gendisk *disk)
1393 {
1394         disk->diskseq = atomic64_inc_return(&diskseq);
1395 }