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