1 // SPDX-License-Identifier: GPL-2.0
6 #include <linux/module.h>
8 #include <linux/genhd.h>
9 #include <linux/kdev_t.h>
10 #include <linux/kernel.h>
11 #include <linux/blkdev.h>
12 #include <linux/backing-dev.h>
13 #include <linux/init.h>
14 #include <linux/spinlock.h>
15 #include <linux/proc_fs.h>
16 #include <linux/seq_file.h>
17 #include <linux/slab.h>
18 #include <linux/kmod.h>
19 #include <linux/kobj_map.h>
20 #include <linux/mutex.h>
21 #include <linux/idr.h>
22 #include <linux/log2.h>
23 #include <linux/pm_runtime.h>
24 #include <linux/badblocks.h>
28 static DEFINE_MUTEX(block_class_lock
);
29 struct kobject
*block_depr
;
31 /* for extended dynamic devt allocation, currently only one major is used */
32 #define NR_EXT_DEVT (1 << MINORBITS)
34 /* For extended devt allocation. ext_devt_lock prevents look up
35 * results from going away underneath its user.
37 static DEFINE_SPINLOCK(ext_devt_lock
);
38 static DEFINE_IDR(ext_devt_idr
);
40 static const struct device_type disk_type
;
42 static void disk_check_events(struct disk_events
*ev
,
43 unsigned int *clearing_ptr
);
44 static void disk_alloc_events(struct gendisk
*disk
);
45 static void disk_add_events(struct gendisk
*disk
);
46 static void disk_del_events(struct gendisk
*disk
);
47 static void disk_release_events(struct gendisk
*disk
);
49 void part_inc_in_flight(struct request_queue
*q
, struct hd_struct
*part
, int rw
)
54 part_stat_local_inc(part
, in_flight
[rw
]);
56 part_stat_local_inc(&part_to_disk(part
)->part0
, in_flight
[rw
]);
59 void part_dec_in_flight(struct request_queue
*q
, struct hd_struct
*part
, int rw
)
64 part_stat_local_dec(part
, in_flight
[rw
]);
66 part_stat_local_dec(&part_to_disk(part
)->part0
, in_flight
[rw
]);
69 unsigned int part_in_flight(struct request_queue
*q
, struct hd_struct
*part
)
72 unsigned int inflight
;
75 return blk_mq_in_flight(q
, part
);
79 for_each_possible_cpu(cpu
) {
80 inflight
+= part_stat_local_read_cpu(part
, in_flight
[0], cpu
) +
81 part_stat_local_read_cpu(part
, in_flight
[1], cpu
);
83 if ((int)inflight
< 0)
89 void part_in_flight_rw(struct request_queue
*q
, struct hd_struct
*part
,
90 unsigned int inflight
[2])
95 blk_mq_in_flight_rw(q
, part
, inflight
);
101 for_each_possible_cpu(cpu
) {
102 inflight
[0] += part_stat_local_read_cpu(part
, in_flight
[0], cpu
);
103 inflight
[1] += part_stat_local_read_cpu(part
, in_flight
[1], cpu
);
105 if ((int)inflight
[0] < 0)
107 if ((int)inflight
[1] < 0)
111 struct hd_struct
*__disk_get_part(struct gendisk
*disk
, int partno
)
113 struct disk_part_tbl
*ptbl
= rcu_dereference(disk
->part_tbl
);
115 if (unlikely(partno
< 0 || partno
>= ptbl
->len
))
117 return rcu_dereference(ptbl
->part
[partno
]);
121 * disk_get_part - get partition
122 * @disk: disk to look partition from
123 * @partno: partition number
125 * Look for partition @partno from @disk. If found, increment
126 * reference count and return it.
132 * Pointer to the found partition on success, NULL if not found.
134 struct hd_struct
*disk_get_part(struct gendisk
*disk
, int partno
)
136 struct hd_struct
*part
;
139 part
= __disk_get_part(disk
, partno
);
141 get_device(part_to_dev(part
));
146 EXPORT_SYMBOL_GPL(disk_get_part
);
149 * disk_part_iter_init - initialize partition iterator
150 * @piter: iterator to initialize
151 * @disk: disk to iterate over
152 * @flags: DISK_PITER_* flags
154 * Initialize @piter so that it iterates over partitions of @disk.
159 void disk_part_iter_init(struct disk_part_iter
*piter
, struct gendisk
*disk
,
162 struct disk_part_tbl
*ptbl
;
165 ptbl
= rcu_dereference(disk
->part_tbl
);
170 if (flags
& DISK_PITER_REVERSE
)
171 piter
->idx
= ptbl
->len
- 1;
172 else if (flags
& (DISK_PITER_INCL_PART0
| DISK_PITER_INCL_EMPTY_PART0
))
177 piter
->flags
= flags
;
181 EXPORT_SYMBOL_GPL(disk_part_iter_init
);
184 * disk_part_iter_next - proceed iterator to the next partition and return it
185 * @piter: iterator of interest
187 * Proceed @piter to the next partition and return it.
192 struct hd_struct
*disk_part_iter_next(struct disk_part_iter
*piter
)
194 struct disk_part_tbl
*ptbl
;
197 /* put the last partition */
198 disk_put_part(piter
->part
);
203 ptbl
= rcu_dereference(piter
->disk
->part_tbl
);
205 /* determine iteration parameters */
206 if (piter
->flags
& DISK_PITER_REVERSE
) {
208 if (piter
->flags
& (DISK_PITER_INCL_PART0
|
209 DISK_PITER_INCL_EMPTY_PART0
))
218 /* iterate to the next partition */
219 for (; piter
->idx
!= end
; piter
->idx
+= inc
) {
220 struct hd_struct
*part
;
222 part
= rcu_dereference(ptbl
->part
[piter
->idx
]);
225 if (!part_nr_sects_read(part
) &&
226 !(piter
->flags
& DISK_PITER_INCL_EMPTY
) &&
227 !(piter
->flags
& DISK_PITER_INCL_EMPTY_PART0
&&
231 get_device(part_to_dev(part
));
241 EXPORT_SYMBOL_GPL(disk_part_iter_next
);
244 * disk_part_iter_exit - finish up partition iteration
245 * @piter: iter of interest
247 * Called when iteration is over. Cleans up @piter.
252 void disk_part_iter_exit(struct disk_part_iter
*piter
)
254 disk_put_part(piter
->part
);
257 EXPORT_SYMBOL_GPL(disk_part_iter_exit
);
259 static inline int sector_in_part(struct hd_struct
*part
, sector_t sector
)
261 return part
->start_sect
<= sector
&&
262 sector
< part
->start_sect
+ part_nr_sects_read(part
);
266 * disk_map_sector_rcu - map sector to partition
267 * @disk: gendisk of interest
268 * @sector: sector to map
270 * Find out which partition @sector maps to on @disk. This is
271 * primarily used for stats accounting.
274 * RCU read locked. The returned partition pointer is valid only
275 * while preemption is disabled.
278 * Found partition on success, part0 is returned if no partition matches
280 struct hd_struct
*disk_map_sector_rcu(struct gendisk
*disk
, sector_t sector
)
282 struct disk_part_tbl
*ptbl
;
283 struct hd_struct
*part
;
286 ptbl
= rcu_dereference(disk
->part_tbl
);
288 part
= rcu_dereference(ptbl
->last_lookup
);
289 if (part
&& sector_in_part(part
, sector
))
292 for (i
= 1; i
< ptbl
->len
; i
++) {
293 part
= rcu_dereference(ptbl
->part
[i
]);
295 if (part
&& sector_in_part(part
, sector
)) {
296 rcu_assign_pointer(ptbl
->last_lookup
, part
);
302 EXPORT_SYMBOL_GPL(disk_map_sector_rcu
);
305 * Can be deleted altogether. Later.
308 #define BLKDEV_MAJOR_HASH_SIZE 255
309 static struct blk_major_name
{
310 struct blk_major_name
*next
;
313 } *major_names
[BLKDEV_MAJOR_HASH_SIZE
];
315 /* index in the above - for now: assume no multimajor ranges */
316 static inline int major_to_index(unsigned major
)
318 return major
% BLKDEV_MAJOR_HASH_SIZE
;
321 #ifdef CONFIG_PROC_FS
322 void blkdev_show(struct seq_file
*seqf
, off_t offset
)
324 struct blk_major_name
*dp
;
326 mutex_lock(&block_class_lock
);
327 for (dp
= major_names
[major_to_index(offset
)]; dp
; dp
= dp
->next
)
328 if (dp
->major
== offset
)
329 seq_printf(seqf
, "%3d %s\n", dp
->major
, dp
->name
);
330 mutex_unlock(&block_class_lock
);
332 #endif /* CONFIG_PROC_FS */
335 * register_blkdev - register a new block device
337 * @major: the requested major device number [1..BLKDEV_MAJOR_MAX-1]. If
338 * @major = 0, try to allocate any unused major number.
339 * @name: the name of the new block device as a zero terminated string
341 * The @name must be unique within the system.
343 * The return value depends on the @major input parameter:
345 * - if a major device number was requested in range [1..BLKDEV_MAJOR_MAX-1]
346 * then the function returns zero on success, or a negative error code
347 * - if any unused major number was requested with @major = 0 parameter
348 * then the return value is the allocated major number in range
349 * [1..BLKDEV_MAJOR_MAX-1] or a negative error code otherwise
351 * See Documentation/admin-guide/devices.txt for the list of allocated
354 int register_blkdev(unsigned int major
, const char *name
)
356 struct blk_major_name
**n
, *p
;
359 mutex_lock(&block_class_lock
);
363 for (index
= ARRAY_SIZE(major_names
)-1; index
> 0; index
--) {
364 if (major_names
[index
] == NULL
)
369 printk("%s: failed to get major for %s\n",
378 if (major
>= BLKDEV_MAJOR_MAX
) {
379 pr_err("%s: major requested (%u) is greater than the maximum (%u) for %s\n",
380 __func__
, major
, BLKDEV_MAJOR_MAX
-1, name
);
386 p
= kmalloc(sizeof(struct blk_major_name
), GFP_KERNEL
);
393 strlcpy(p
->name
, name
, sizeof(p
->name
));
395 index
= major_to_index(major
);
397 for (n
= &major_names
[index
]; *n
; n
= &(*n
)->next
) {
398 if ((*n
)->major
== major
)
407 printk("register_blkdev: cannot get major %u for %s\n",
412 mutex_unlock(&block_class_lock
);
416 EXPORT_SYMBOL(register_blkdev
);
418 void unregister_blkdev(unsigned int major
, const char *name
)
420 struct blk_major_name
**n
;
421 struct blk_major_name
*p
= NULL
;
422 int index
= major_to_index(major
);
424 mutex_lock(&block_class_lock
);
425 for (n
= &major_names
[index
]; *n
; n
= &(*n
)->next
)
426 if ((*n
)->major
== major
)
428 if (!*n
|| strcmp((*n
)->name
, name
)) {
434 mutex_unlock(&block_class_lock
);
438 EXPORT_SYMBOL(unregister_blkdev
);
440 static struct kobj_map
*bdev_map
;
443 * blk_mangle_minor - scatter minor numbers apart
444 * @minor: minor number to mangle
446 * Scatter consecutively allocated @minor number apart if MANGLE_DEVT
447 * is enabled. Mangling twice gives the original value.
455 static int blk_mangle_minor(int minor
)
457 #ifdef CONFIG_DEBUG_BLOCK_EXT_DEVT
460 for (i
= 0; i
< MINORBITS
/ 2; i
++) {
461 int low
= minor
& (1 << i
);
462 int high
= minor
& (1 << (MINORBITS
- 1 - i
));
463 int distance
= MINORBITS
- 1 - 2 * i
;
465 minor
^= low
| high
; /* clear both bits */
466 low
<<= distance
; /* swap the positions */
468 minor
|= low
| high
; /* and set */
475 * blk_alloc_devt - allocate a dev_t for a partition
476 * @part: partition to allocate dev_t for
477 * @devt: out parameter for resulting dev_t
479 * Allocate a dev_t for block device.
482 * 0 on success, allocated dev_t is returned in *@devt. -errno on
488 int blk_alloc_devt(struct hd_struct
*part
, dev_t
*devt
)
490 struct gendisk
*disk
= part_to_disk(part
);
493 /* in consecutive minor range? */
494 if (part
->partno
< disk
->minors
) {
495 *devt
= MKDEV(disk
->major
, disk
->first_minor
+ part
->partno
);
499 /* allocate ext devt */
500 idr_preload(GFP_KERNEL
);
502 spin_lock_bh(&ext_devt_lock
);
503 idx
= idr_alloc(&ext_devt_idr
, part
, 0, NR_EXT_DEVT
, GFP_NOWAIT
);
504 spin_unlock_bh(&ext_devt_lock
);
508 return idx
== -ENOSPC
? -EBUSY
: idx
;
510 *devt
= MKDEV(BLOCK_EXT_MAJOR
, blk_mangle_minor(idx
));
515 * blk_free_devt - free a dev_t
516 * @devt: dev_t to free
518 * Free @devt which was allocated using blk_alloc_devt().
523 void blk_free_devt(dev_t devt
)
525 if (devt
== MKDEV(0, 0))
528 if (MAJOR(devt
) == BLOCK_EXT_MAJOR
) {
529 spin_lock_bh(&ext_devt_lock
);
530 idr_remove(&ext_devt_idr
, blk_mangle_minor(MINOR(devt
)));
531 spin_unlock_bh(&ext_devt_lock
);
536 * We invalidate devt by assigning NULL pointer for devt in idr.
538 void blk_invalidate_devt(dev_t devt
)
540 if (MAJOR(devt
) == BLOCK_EXT_MAJOR
) {
541 spin_lock_bh(&ext_devt_lock
);
542 idr_replace(&ext_devt_idr
, NULL
, blk_mangle_minor(MINOR(devt
)));
543 spin_unlock_bh(&ext_devt_lock
);
547 static char *bdevt_str(dev_t devt
, char *buf
)
549 if (MAJOR(devt
) <= 0xff && MINOR(devt
) <= 0xff) {
550 char tbuf
[BDEVT_SIZE
];
551 snprintf(tbuf
, BDEVT_SIZE
, "%02x%02x", MAJOR(devt
), MINOR(devt
));
552 snprintf(buf
, BDEVT_SIZE
, "%-9s", tbuf
);
554 snprintf(buf
, BDEVT_SIZE
, "%03x:%05x", MAJOR(devt
), MINOR(devt
));
560 * Register device numbers dev..(dev+range-1)
561 * range must be nonzero
562 * The hash chain is sorted on range, so that subranges can override.
564 void blk_register_region(dev_t devt
, unsigned long range
, struct module
*module
,
565 struct kobject
*(*probe
)(dev_t
, int *, void *),
566 int (*lock
)(dev_t
, void *), void *data
)
568 kobj_map(bdev_map
, devt
, range
, module
, probe
, lock
, data
);
571 EXPORT_SYMBOL(blk_register_region
);
573 void blk_unregister_region(dev_t devt
, unsigned long range
)
575 kobj_unmap(bdev_map
, devt
, range
);
578 EXPORT_SYMBOL(blk_unregister_region
);
580 static struct kobject
*exact_match(dev_t devt
, int *partno
, void *data
)
582 struct gendisk
*p
= data
;
584 return &disk_to_dev(p
)->kobj
;
587 static int exact_lock(dev_t devt
, void *data
)
589 struct gendisk
*p
= data
;
591 if (!get_disk_and_module(p
))
596 static void register_disk(struct device
*parent
, struct gendisk
*disk
,
597 const struct attribute_group
**groups
)
599 struct device
*ddev
= disk_to_dev(disk
);
600 struct block_device
*bdev
;
601 struct disk_part_iter piter
;
602 struct hd_struct
*part
;
605 ddev
->parent
= parent
;
607 dev_set_name(ddev
, "%s", disk
->disk_name
);
609 /* delay uevents, until we scanned partition table */
610 dev_set_uevent_suppress(ddev
, 1);
613 WARN_ON(ddev
->groups
);
614 ddev
->groups
= groups
;
616 if (device_add(ddev
))
618 if (!sysfs_deprecated
) {
619 err
= sysfs_create_link(block_depr
, &ddev
->kobj
,
620 kobject_name(&ddev
->kobj
));
628 * avoid probable deadlock caused by allocating memory with
629 * GFP_KERNEL in runtime_resume callback of its all ancestor
632 pm_runtime_set_memalloc_noio(ddev
, true);
634 disk
->part0
.holder_dir
= kobject_create_and_add("holders", &ddev
->kobj
);
635 disk
->slave_dir
= kobject_create_and_add("slaves", &ddev
->kobj
);
637 if (disk
->flags
& GENHD_FL_HIDDEN
) {
638 dev_set_uevent_suppress(ddev
, 0);
642 /* No minors to use for partitions */
643 if (!disk_part_scan_enabled(disk
))
646 /* No such device (e.g., media were just removed) */
647 if (!get_capacity(disk
))
650 bdev
= bdget_disk(disk
, 0);
654 bdev
->bd_invalidated
= 1;
655 err
= blkdev_get(bdev
, FMODE_READ
, NULL
);
658 blkdev_put(bdev
, FMODE_READ
);
661 /* announce disk after possible partitions are created */
662 dev_set_uevent_suppress(ddev
, 0);
663 kobject_uevent(&ddev
->kobj
, KOBJ_ADD
);
665 /* announce possible partitions */
666 disk_part_iter_init(&piter
, disk
, 0);
667 while ((part
= disk_part_iter_next(&piter
)))
668 kobject_uevent(&part_to_dev(part
)->kobj
, KOBJ_ADD
);
669 disk_part_iter_exit(&piter
);
671 if (disk
->queue
->backing_dev_info
->dev
) {
672 err
= sysfs_create_link(&ddev
->kobj
,
673 &disk
->queue
->backing_dev_info
->dev
->kobj
,
680 * __device_add_disk - add disk information to kernel list
681 * @parent: parent device for the disk
682 * @disk: per-device partitioning information
683 * @groups: Additional per-device sysfs groups
684 * @register_queue: register the queue if set to true
686 * This function registers the partitioning information in @disk
689 * FIXME: error handling
691 static void __device_add_disk(struct device
*parent
, struct gendisk
*disk
,
692 const struct attribute_group
**groups
,
699 * The disk queue should now be all set with enough information about
700 * the device for the elevator code to pick an adequate default
701 * elevator if one is needed, that is, for devices requesting queue
705 elevator_init_mq(disk
->queue
);
707 /* minors == 0 indicates to use ext devt from part0 and should
708 * be accompanied with EXT_DEVT flag. Make sure all
709 * parameters make sense.
711 WARN_ON(disk
->minors
&& !(disk
->major
|| disk
->first_minor
));
712 WARN_ON(!disk
->minors
&&
713 !(disk
->flags
& (GENHD_FL_EXT_DEVT
| GENHD_FL_HIDDEN
)));
715 disk
->flags
|= GENHD_FL_UP
;
717 retval
= blk_alloc_devt(&disk
->part0
, &devt
);
722 disk
->major
= MAJOR(devt
);
723 disk
->first_minor
= MINOR(devt
);
725 disk_alloc_events(disk
);
727 if (disk
->flags
& GENHD_FL_HIDDEN
) {
729 * Don't let hidden disks show up in /proc/partitions,
730 * and don't bother scanning for partitions either.
732 disk
->flags
|= GENHD_FL_SUPPRESS_PARTITION_INFO
;
733 disk
->flags
|= GENHD_FL_NO_PART_SCAN
;
737 /* Register BDI before referencing it from bdev */
738 disk_to_dev(disk
)->devt
= devt
;
739 ret
= bdi_register_owner(disk
->queue
->backing_dev_info
,
742 blk_register_region(disk_devt(disk
), disk
->minors
, NULL
,
743 exact_match
, exact_lock
, disk
);
745 register_disk(parent
, disk
, groups
);
747 blk_register_queue(disk
);
750 * Take an extra ref on queue which will be put on disk_release()
751 * so that it sticks around as long as @disk is there.
753 WARN_ON_ONCE(!blk_get_queue(disk
->queue
));
755 disk_add_events(disk
);
756 blk_integrity_add(disk
);
759 void device_add_disk(struct device
*parent
, struct gendisk
*disk
,
760 const struct attribute_group
**groups
)
763 __device_add_disk(parent
, disk
, groups
, true);
765 EXPORT_SYMBOL(device_add_disk
);
767 void device_add_disk_no_queue_reg(struct device
*parent
, struct gendisk
*disk
)
769 __device_add_disk(parent
, disk
, NULL
, false);
771 EXPORT_SYMBOL(device_add_disk_no_queue_reg
);
773 void del_gendisk(struct gendisk
*disk
)
775 struct disk_part_iter piter
;
776 struct hd_struct
*part
;
778 blk_integrity_del(disk
);
779 disk_del_events(disk
);
782 * Block lookups of the disk until all bdevs are unhashed and the
783 * disk is marked as dead (GENHD_FL_UP cleared).
785 down_write(&disk
->lookup_sem
);
786 /* invalidate stuff */
787 disk_part_iter_init(&piter
, disk
,
788 DISK_PITER_INCL_EMPTY
| DISK_PITER_REVERSE
);
789 while ((part
= disk_part_iter_next(&piter
))) {
790 invalidate_partition(disk
, part
->partno
);
791 bdev_unhash_inode(part_devt(part
));
792 delete_partition(disk
, part
->partno
);
794 disk_part_iter_exit(&piter
);
796 invalidate_partition(disk
, 0);
797 bdev_unhash_inode(disk_devt(disk
));
798 set_capacity(disk
, 0);
799 disk
->flags
&= ~GENHD_FL_UP
;
800 up_write(&disk
->lookup_sem
);
802 if (!(disk
->flags
& GENHD_FL_HIDDEN
))
803 sysfs_remove_link(&disk_to_dev(disk
)->kobj
, "bdi");
806 * Unregister bdi before releasing device numbers (as they can
807 * get reused and we'd get clashes in sysfs).
809 if (!(disk
->flags
& GENHD_FL_HIDDEN
))
810 bdi_unregister(disk
->queue
->backing_dev_info
);
811 blk_unregister_queue(disk
);
816 if (!(disk
->flags
& GENHD_FL_HIDDEN
))
817 blk_unregister_region(disk_devt(disk
), disk
->minors
);
819 * Remove gendisk pointer from idr so that it cannot be looked up
820 * while RCU period before freeing gendisk is running to prevent
821 * use-after-free issues. Note that the device number stays
822 * "in-use" until we really free the gendisk.
824 blk_invalidate_devt(disk_devt(disk
));
826 kobject_put(disk
->part0
.holder_dir
);
827 kobject_put(disk
->slave_dir
);
829 part_stat_set_all(&disk
->part0
, 0);
830 disk
->part0
.stamp
= 0;
831 if (!sysfs_deprecated
)
832 sysfs_remove_link(block_depr
, dev_name(disk_to_dev(disk
)));
833 pm_runtime_set_memalloc_noio(disk_to_dev(disk
), false);
834 device_del(disk_to_dev(disk
));
836 EXPORT_SYMBOL(del_gendisk
);
838 /* sysfs access to bad-blocks list. */
839 static ssize_t
disk_badblocks_show(struct device
*dev
,
840 struct device_attribute
*attr
,
843 struct gendisk
*disk
= dev_to_disk(dev
);
846 return sprintf(page
, "\n");
848 return badblocks_show(disk
->bb
, page
, 0);
851 static ssize_t
disk_badblocks_store(struct device
*dev
,
852 struct device_attribute
*attr
,
853 const char *page
, size_t len
)
855 struct gendisk
*disk
= dev_to_disk(dev
);
860 return badblocks_store(disk
->bb
, page
, len
, 0);
864 * get_gendisk - get partitioning information for a given device
865 * @devt: device to get partitioning information for
866 * @partno: returned partition index
868 * This function gets the structure containing partitioning
869 * information for the given device @devt.
871 struct gendisk
*get_gendisk(dev_t devt
, int *partno
)
873 struct gendisk
*disk
= NULL
;
875 if (MAJOR(devt
) != BLOCK_EXT_MAJOR
) {
876 struct kobject
*kobj
;
878 kobj
= kobj_lookup(bdev_map
, devt
, partno
);
880 disk
= dev_to_disk(kobj_to_dev(kobj
));
882 struct hd_struct
*part
;
884 spin_lock_bh(&ext_devt_lock
);
885 part
= idr_find(&ext_devt_idr
, blk_mangle_minor(MINOR(devt
)));
886 if (part
&& get_disk_and_module(part_to_disk(part
))) {
887 *partno
= part
->partno
;
888 disk
= part_to_disk(part
);
890 spin_unlock_bh(&ext_devt_lock
);
897 * Synchronize with del_gendisk() to not return disk that is being
900 down_read(&disk
->lookup_sem
);
901 if (unlikely((disk
->flags
& GENHD_FL_HIDDEN
) ||
902 !(disk
->flags
& GENHD_FL_UP
))) {
903 up_read(&disk
->lookup_sem
);
904 put_disk_and_module(disk
);
907 up_read(&disk
->lookup_sem
);
911 EXPORT_SYMBOL(get_gendisk
);
914 * bdget_disk - do bdget() by gendisk and partition number
915 * @disk: gendisk of interest
916 * @partno: partition number
918 * Find partition @partno from @disk, do bdget() on it.
924 * Resulting block_device on success, NULL on failure.
926 struct block_device
*bdget_disk(struct gendisk
*disk
, int partno
)
928 struct hd_struct
*part
;
929 struct block_device
*bdev
= NULL
;
931 part
= disk_get_part(disk
, partno
);
933 bdev
= bdget(part_devt(part
));
938 EXPORT_SYMBOL(bdget_disk
);
941 * print a full list of all partitions - intended for places where the root
942 * filesystem can't be mounted and thus to give the victim some idea of what
945 void __init
printk_all_partitions(void)
947 struct class_dev_iter iter
;
950 class_dev_iter_init(&iter
, &block_class
, NULL
, &disk_type
);
951 while ((dev
= class_dev_iter_next(&iter
))) {
952 struct gendisk
*disk
= dev_to_disk(dev
);
953 struct disk_part_iter piter
;
954 struct hd_struct
*part
;
955 char name_buf
[BDEVNAME_SIZE
];
956 char devt_buf
[BDEVT_SIZE
];
959 * Don't show empty devices or things that have been
962 if (get_capacity(disk
) == 0 ||
963 (disk
->flags
& GENHD_FL_SUPPRESS_PARTITION_INFO
))
967 * Note, unlike /proc/partitions, I am showing the
968 * numbers in hex - the same format as the root=
971 disk_part_iter_init(&piter
, disk
, DISK_PITER_INCL_PART0
);
972 while ((part
= disk_part_iter_next(&piter
))) {
973 bool is_part0
= part
== &disk
->part0
;
975 printk("%s%s %10llu %s %s", is_part0
? "" : " ",
976 bdevt_str(part_devt(part
), devt_buf
),
977 (unsigned long long)part_nr_sects_read(part
) >> 1
978 , disk_name(disk
, part
->partno
, name_buf
),
979 part
->info
? part
->info
->uuid
: "");
981 if (dev
->parent
&& dev
->parent
->driver
)
982 printk(" driver: %s\n",
983 dev
->parent
->driver
->name
);
985 printk(" (driver?)\n");
989 disk_part_iter_exit(&piter
);
991 class_dev_iter_exit(&iter
);
994 #ifdef CONFIG_PROC_FS
996 static void *disk_seqf_start(struct seq_file
*seqf
, loff_t
*pos
)
999 struct class_dev_iter
*iter
;
1002 iter
= kmalloc(sizeof(*iter
), GFP_KERNEL
);
1004 return ERR_PTR(-ENOMEM
);
1006 seqf
->private = iter
;
1007 class_dev_iter_init(iter
, &block_class
, NULL
, &disk_type
);
1009 dev
= class_dev_iter_next(iter
);
1014 return dev_to_disk(dev
);
1017 static void *disk_seqf_next(struct seq_file
*seqf
, void *v
, loff_t
*pos
)
1022 dev
= class_dev_iter_next(seqf
->private);
1024 return dev_to_disk(dev
);
1029 static void disk_seqf_stop(struct seq_file
*seqf
, void *v
)
1031 struct class_dev_iter
*iter
= seqf
->private;
1033 /* stop is called even after start failed :-( */
1035 class_dev_iter_exit(iter
);
1037 seqf
->private = NULL
;
1041 static void *show_partition_start(struct seq_file
*seqf
, loff_t
*pos
)
1045 p
= disk_seqf_start(seqf
, pos
);
1046 if (!IS_ERR_OR_NULL(p
) && !*pos
)
1047 seq_puts(seqf
, "major minor #blocks name\n\n");
1051 static int show_partition(struct seq_file
*seqf
, void *v
)
1053 struct gendisk
*sgp
= v
;
1054 struct disk_part_iter piter
;
1055 struct hd_struct
*part
;
1056 char buf
[BDEVNAME_SIZE
];
1058 /* Don't show non-partitionable removeable devices or empty devices */
1059 if (!get_capacity(sgp
) || (!disk_max_parts(sgp
) &&
1060 (sgp
->flags
& GENHD_FL_REMOVABLE
)))
1062 if (sgp
->flags
& GENHD_FL_SUPPRESS_PARTITION_INFO
)
1065 /* show the full disk and all non-0 size partitions of it */
1066 disk_part_iter_init(&piter
, sgp
, DISK_PITER_INCL_PART0
);
1067 while ((part
= disk_part_iter_next(&piter
)))
1068 seq_printf(seqf
, "%4d %7d %10llu %s\n",
1069 MAJOR(part_devt(part
)), MINOR(part_devt(part
)),
1070 (unsigned long long)part_nr_sects_read(part
) >> 1,
1071 disk_name(sgp
, part
->partno
, buf
));
1072 disk_part_iter_exit(&piter
);
1077 static const struct seq_operations partitions_op
= {
1078 .start
= show_partition_start
,
1079 .next
= disk_seqf_next
,
1080 .stop
= disk_seqf_stop
,
1081 .show
= show_partition
1086 static struct kobject
*base_probe(dev_t devt
, int *partno
, void *data
)
1088 if (request_module("block-major-%d-%d", MAJOR(devt
), MINOR(devt
)) > 0)
1089 /* Make old-style 2.4 aliases work */
1090 request_module("block-major-%d", MAJOR(devt
));
1094 static int __init
genhd_device_init(void)
1098 block_class
.dev_kobj
= sysfs_dev_block_kobj
;
1099 error
= class_register(&block_class
);
1100 if (unlikely(error
))
1102 bdev_map
= kobj_map_init(base_probe
, &block_class_lock
);
1105 register_blkdev(BLOCK_EXT_MAJOR
, "blkext");
1107 /* create top-level block dir */
1108 if (!sysfs_deprecated
)
1109 block_depr
= kobject_create_and_add("block", NULL
);
1113 subsys_initcall(genhd_device_init
);
1115 static ssize_t
disk_range_show(struct device
*dev
,
1116 struct device_attribute
*attr
, char *buf
)
1118 struct gendisk
*disk
= dev_to_disk(dev
);
1120 return sprintf(buf
, "%d\n", disk
->minors
);
1123 static ssize_t
disk_ext_range_show(struct device
*dev
,
1124 struct device_attribute
*attr
, char *buf
)
1126 struct gendisk
*disk
= dev_to_disk(dev
);
1128 return sprintf(buf
, "%d\n", disk_max_parts(disk
));
1131 static ssize_t
disk_removable_show(struct device
*dev
,
1132 struct device_attribute
*attr
, char *buf
)
1134 struct gendisk
*disk
= dev_to_disk(dev
);
1136 return sprintf(buf
, "%d\n",
1137 (disk
->flags
& GENHD_FL_REMOVABLE
? 1 : 0));
1140 static ssize_t
disk_hidden_show(struct device
*dev
,
1141 struct device_attribute
*attr
, char *buf
)
1143 struct gendisk
*disk
= dev_to_disk(dev
);
1145 return sprintf(buf
, "%d\n",
1146 (disk
->flags
& GENHD_FL_HIDDEN
? 1 : 0));
1149 static ssize_t
disk_ro_show(struct device
*dev
,
1150 struct device_attribute
*attr
, char *buf
)
1152 struct gendisk
*disk
= dev_to_disk(dev
);
1154 return sprintf(buf
, "%d\n", get_disk_ro(disk
) ? 1 : 0);
1157 static ssize_t
disk_capability_show(struct device
*dev
,
1158 struct device_attribute
*attr
, char *buf
)
1160 struct gendisk
*disk
= dev_to_disk(dev
);
1162 return sprintf(buf
, "%x\n", disk
->flags
);
1165 static ssize_t
disk_alignment_offset_show(struct device
*dev
,
1166 struct device_attribute
*attr
,
1169 struct gendisk
*disk
= dev_to_disk(dev
);
1171 return sprintf(buf
, "%d\n", queue_alignment_offset(disk
->queue
));
1174 static ssize_t
disk_discard_alignment_show(struct device
*dev
,
1175 struct device_attribute
*attr
,
1178 struct gendisk
*disk
= dev_to_disk(dev
);
1180 return sprintf(buf
, "%d\n", queue_discard_alignment(disk
->queue
));
1183 static DEVICE_ATTR(range
, 0444, disk_range_show
, NULL
);
1184 static DEVICE_ATTR(ext_range
, 0444, disk_ext_range_show
, NULL
);
1185 static DEVICE_ATTR(removable
, 0444, disk_removable_show
, NULL
);
1186 static DEVICE_ATTR(hidden
, 0444, disk_hidden_show
, NULL
);
1187 static DEVICE_ATTR(ro
, 0444, disk_ro_show
, NULL
);
1188 static DEVICE_ATTR(size
, 0444, part_size_show
, NULL
);
1189 static DEVICE_ATTR(alignment_offset
, 0444, disk_alignment_offset_show
, NULL
);
1190 static DEVICE_ATTR(discard_alignment
, 0444, disk_discard_alignment_show
, NULL
);
1191 static DEVICE_ATTR(capability
, 0444, disk_capability_show
, NULL
);
1192 static DEVICE_ATTR(stat
, 0444, part_stat_show
, NULL
);
1193 static DEVICE_ATTR(inflight
, 0444, part_inflight_show
, NULL
);
1194 static DEVICE_ATTR(badblocks
, 0644, disk_badblocks_show
, disk_badblocks_store
);
1195 #ifdef CONFIG_FAIL_MAKE_REQUEST
1196 static struct device_attribute dev_attr_fail
=
1197 __ATTR(make
-it
-fail
, 0644, part_fail_show
, part_fail_store
);
1199 #ifdef CONFIG_FAIL_IO_TIMEOUT
1200 static struct device_attribute dev_attr_fail_timeout
=
1201 __ATTR(io
-timeout
-fail
, 0644, part_timeout_show
, part_timeout_store
);
1204 static struct attribute
*disk_attrs
[] = {
1205 &dev_attr_range
.attr
,
1206 &dev_attr_ext_range
.attr
,
1207 &dev_attr_removable
.attr
,
1208 &dev_attr_hidden
.attr
,
1210 &dev_attr_size
.attr
,
1211 &dev_attr_alignment_offset
.attr
,
1212 &dev_attr_discard_alignment
.attr
,
1213 &dev_attr_capability
.attr
,
1214 &dev_attr_stat
.attr
,
1215 &dev_attr_inflight
.attr
,
1216 &dev_attr_badblocks
.attr
,
1217 #ifdef CONFIG_FAIL_MAKE_REQUEST
1218 &dev_attr_fail
.attr
,
1220 #ifdef CONFIG_FAIL_IO_TIMEOUT
1221 &dev_attr_fail_timeout
.attr
,
1226 static umode_t
disk_visible(struct kobject
*kobj
, struct attribute
*a
, int n
)
1228 struct device
*dev
= container_of(kobj
, typeof(*dev
), kobj
);
1229 struct gendisk
*disk
= dev_to_disk(dev
);
1231 if (a
== &dev_attr_badblocks
.attr
&& !disk
->bb
)
1236 static struct attribute_group disk_attr_group
= {
1237 .attrs
= disk_attrs
,
1238 .is_visible
= disk_visible
,
1241 static const struct attribute_group
*disk_attr_groups
[] = {
1247 * disk_replace_part_tbl - replace disk->part_tbl in RCU-safe way
1248 * @disk: disk to replace part_tbl for
1249 * @new_ptbl: new part_tbl to install
1251 * Replace disk->part_tbl with @new_ptbl in RCU-safe way. The
1252 * original ptbl is freed using RCU callback.
1255 * Matching bd_mutex locked or the caller is the only user of @disk.
1257 static void disk_replace_part_tbl(struct gendisk
*disk
,
1258 struct disk_part_tbl
*new_ptbl
)
1260 struct disk_part_tbl
*old_ptbl
=
1261 rcu_dereference_protected(disk
->part_tbl
, 1);
1263 rcu_assign_pointer(disk
->part_tbl
, new_ptbl
);
1266 rcu_assign_pointer(old_ptbl
->last_lookup
, NULL
);
1267 kfree_rcu(old_ptbl
, rcu_head
);
1272 * disk_expand_part_tbl - expand disk->part_tbl
1273 * @disk: disk to expand part_tbl for
1274 * @partno: expand such that this partno can fit in
1276 * Expand disk->part_tbl such that @partno can fit in. disk->part_tbl
1277 * uses RCU to allow unlocked dereferencing for stats and other stuff.
1280 * Matching bd_mutex locked or the caller is the only user of @disk.
1284 * 0 on success, -errno on failure.
1286 int disk_expand_part_tbl(struct gendisk
*disk
, int partno
)
1288 struct disk_part_tbl
*old_ptbl
=
1289 rcu_dereference_protected(disk
->part_tbl
, 1);
1290 struct disk_part_tbl
*new_ptbl
;
1291 int len
= old_ptbl
? old_ptbl
->len
: 0;
1295 * check for int overflow, since we can get here from blkpg_ioctl()
1296 * with a user passed 'partno'.
1298 target
= partno
+ 1;
1302 /* disk_max_parts() is zero during initialization, ignore if so */
1303 if (disk_max_parts(disk
) && target
> disk_max_parts(disk
))
1309 new_ptbl
= kzalloc_node(struct_size(new_ptbl
, part
, target
), GFP_KERNEL
,
1314 new_ptbl
->len
= target
;
1316 for (i
= 0; i
< len
; i
++)
1317 rcu_assign_pointer(new_ptbl
->part
[i
], old_ptbl
->part
[i
]);
1319 disk_replace_part_tbl(disk
, new_ptbl
);
1323 static void disk_release(struct device
*dev
)
1325 struct gendisk
*disk
= dev_to_disk(dev
);
1327 blk_free_devt(dev
->devt
);
1328 disk_release_events(disk
);
1329 kfree(disk
->random
);
1330 disk_replace_part_tbl(disk
, NULL
);
1331 hd_free_part(&disk
->part0
);
1333 blk_put_queue(disk
->queue
);
1336 struct class block_class
= {
1340 static char *block_devnode(struct device
*dev
, umode_t
*mode
,
1341 kuid_t
*uid
, kgid_t
*gid
)
1343 struct gendisk
*disk
= dev_to_disk(dev
);
1346 return disk
->devnode(disk
, mode
);
1350 static const struct device_type disk_type
= {
1352 .groups
= disk_attr_groups
,
1353 .release
= disk_release
,
1354 .devnode
= block_devnode
,
1357 #ifdef CONFIG_PROC_FS
1359 * aggregate disk stat collector. Uses the same stats that the sysfs
1360 * entries do, above, but makes them available through one seq_file.
1362 * The output looks suspiciously like /proc/partitions with a bunch of
1365 static int diskstats_show(struct seq_file
*seqf
, void *v
)
1367 struct gendisk
*gp
= v
;
1368 struct disk_part_iter piter
;
1369 struct hd_struct
*hd
;
1370 char buf
[BDEVNAME_SIZE
];
1371 unsigned int inflight
;
1374 if (&disk_to_dev(gp)->kobj.entry == block_class.devices.next)
1375 seq_puts(seqf, "major minor name"
1376 " rio rmerge rsect ruse wio wmerge "
1377 "wsect wuse running use aveq"
1381 disk_part_iter_init(&piter
, gp
, DISK_PITER_INCL_EMPTY_PART0
);
1382 while ((hd
= disk_part_iter_next(&piter
))) {
1383 inflight
= part_in_flight(gp
->queue
, hd
);
1384 seq_printf(seqf
, "%4d %7d %s "
1391 MAJOR(part_devt(hd
)), MINOR(part_devt(hd
)),
1392 disk_name(gp
, hd
->partno
, buf
),
1393 part_stat_read(hd
, ios
[STAT_READ
]),
1394 part_stat_read(hd
, merges
[STAT_READ
]),
1395 part_stat_read(hd
, sectors
[STAT_READ
]),
1396 (unsigned int)part_stat_read_msecs(hd
, STAT_READ
),
1397 part_stat_read(hd
, ios
[STAT_WRITE
]),
1398 part_stat_read(hd
, merges
[STAT_WRITE
]),
1399 part_stat_read(hd
, sectors
[STAT_WRITE
]),
1400 (unsigned int)part_stat_read_msecs(hd
, STAT_WRITE
),
1402 jiffies_to_msecs(part_stat_read(hd
, io_ticks
)),
1403 jiffies_to_msecs(part_stat_read(hd
, time_in_queue
)),
1404 part_stat_read(hd
, ios
[STAT_DISCARD
]),
1405 part_stat_read(hd
, merges
[STAT_DISCARD
]),
1406 part_stat_read(hd
, sectors
[STAT_DISCARD
]),
1407 (unsigned int)part_stat_read_msecs(hd
, STAT_DISCARD
),
1408 part_stat_read(hd
, ios
[STAT_FLUSH
]),
1409 (unsigned int)part_stat_read_msecs(hd
, STAT_FLUSH
)
1412 disk_part_iter_exit(&piter
);
1417 static const struct seq_operations diskstats_op
= {
1418 .start
= disk_seqf_start
,
1419 .next
= disk_seqf_next
,
1420 .stop
= disk_seqf_stop
,
1421 .show
= diskstats_show
1424 static int __init
proc_genhd_init(void)
1426 proc_create_seq("diskstats", 0, NULL
, &diskstats_op
);
1427 proc_create_seq("partitions", 0, NULL
, &partitions_op
);
1430 module_init(proc_genhd_init
);
1431 #endif /* CONFIG_PROC_FS */
1433 dev_t
blk_lookup_devt(const char *name
, int partno
)
1435 dev_t devt
= MKDEV(0, 0);
1436 struct class_dev_iter iter
;
1439 class_dev_iter_init(&iter
, &block_class
, NULL
, &disk_type
);
1440 while ((dev
= class_dev_iter_next(&iter
))) {
1441 struct gendisk
*disk
= dev_to_disk(dev
);
1442 struct hd_struct
*part
;
1444 if (strcmp(dev_name(dev
), name
))
1447 if (partno
< disk
->minors
) {
1448 /* We need to return the right devno, even
1449 * if the partition doesn't exist yet.
1451 devt
= MKDEV(MAJOR(dev
->devt
),
1452 MINOR(dev
->devt
) + partno
);
1455 part
= disk_get_part(disk
, partno
);
1457 devt
= part_devt(part
);
1458 disk_put_part(part
);
1461 disk_put_part(part
);
1463 class_dev_iter_exit(&iter
);
1466 EXPORT_SYMBOL(blk_lookup_devt
);
1468 struct gendisk
*__alloc_disk_node(int minors
, int node_id
)
1470 struct gendisk
*disk
;
1471 struct disk_part_tbl
*ptbl
;
1473 if (minors
> DISK_MAX_PARTS
) {
1475 "block: can't allocate more than %d partitions\n",
1477 minors
= DISK_MAX_PARTS
;
1480 disk
= kzalloc_node(sizeof(struct gendisk
), GFP_KERNEL
, node_id
);
1482 if (!init_part_stats(&disk
->part0
)) {
1486 init_rwsem(&disk
->lookup_sem
);
1487 disk
->node_id
= node_id
;
1488 if (disk_expand_part_tbl(disk
, 0)) {
1489 free_part_stats(&disk
->part0
);
1493 ptbl
= rcu_dereference_protected(disk
->part_tbl
, 1);
1494 rcu_assign_pointer(ptbl
->part
[0], &disk
->part0
);
1497 * set_capacity() and get_capacity() currently don't use
1498 * seqcounter to read/update the part0->nr_sects. Still init
1499 * the counter as we can read the sectors in IO submission
1500 * patch using seqence counters.
1502 * TODO: Ideally set_capacity() and get_capacity() should be
1503 * converted to make use of bd_mutex and sequence counters.
1505 seqcount_init(&disk
->part0
.nr_sects_seq
);
1506 if (hd_ref_init(&disk
->part0
)) {
1507 hd_free_part(&disk
->part0
);
1512 disk
->minors
= minors
;
1513 rand_initialize_disk(disk
);
1514 disk_to_dev(disk
)->class = &block_class
;
1515 disk_to_dev(disk
)->type
= &disk_type
;
1516 device_initialize(disk_to_dev(disk
));
1520 EXPORT_SYMBOL(__alloc_disk_node
);
1522 struct kobject
*get_disk_and_module(struct gendisk
*disk
)
1524 struct module
*owner
;
1525 struct kobject
*kobj
;
1529 owner
= disk
->fops
->owner
;
1530 if (owner
&& !try_module_get(owner
))
1532 kobj
= kobject_get_unless_zero(&disk_to_dev(disk
)->kobj
);
1540 EXPORT_SYMBOL(get_disk_and_module
);
1542 void put_disk(struct gendisk
*disk
)
1545 kobject_put(&disk_to_dev(disk
)->kobj
);
1547 EXPORT_SYMBOL(put_disk
);
1550 * This is a counterpart of get_disk_and_module() and thus also of
1553 void put_disk_and_module(struct gendisk
*disk
)
1556 struct module
*owner
= disk
->fops
->owner
;
1562 EXPORT_SYMBOL(put_disk_and_module
);
1564 static void set_disk_ro_uevent(struct gendisk
*gd
, int ro
)
1566 char event
[] = "DISK_RO=1";
1567 char *envp
[] = { event
, NULL
};
1571 kobject_uevent_env(&disk_to_dev(gd
)->kobj
, KOBJ_CHANGE
, envp
);
1574 void set_device_ro(struct block_device
*bdev
, int flag
)
1576 bdev
->bd_part
->policy
= flag
;
1579 EXPORT_SYMBOL(set_device_ro
);
1581 void set_disk_ro(struct gendisk
*disk
, int flag
)
1583 struct disk_part_iter piter
;
1584 struct hd_struct
*part
;
1586 if (disk
->part0
.policy
!= flag
) {
1587 set_disk_ro_uevent(disk
, flag
);
1588 disk
->part0
.policy
= flag
;
1591 disk_part_iter_init(&piter
, disk
, DISK_PITER_INCL_EMPTY
);
1592 while ((part
= disk_part_iter_next(&piter
)))
1593 part
->policy
= flag
;
1594 disk_part_iter_exit(&piter
);
1597 EXPORT_SYMBOL(set_disk_ro
);
1599 int bdev_read_only(struct block_device
*bdev
)
1603 return bdev
->bd_part
->policy
;
1606 EXPORT_SYMBOL(bdev_read_only
);
1608 int invalidate_partition(struct gendisk
*disk
, int partno
)
1611 struct block_device
*bdev
= bdget_disk(disk
, partno
);
1614 res
= __invalidate_device(bdev
, true);
1620 EXPORT_SYMBOL(invalidate_partition
);
1623 * Disk events - monitor disk events like media change and eject request.
1625 struct disk_events
{
1626 struct list_head node
; /* all disk_event's */
1627 struct gendisk
*disk
; /* the associated disk */
1630 struct mutex block_mutex
; /* protects blocking */
1631 int block
; /* event blocking depth */
1632 unsigned int pending
; /* events already sent out */
1633 unsigned int clearing
; /* events being cleared */
1635 long poll_msecs
; /* interval, -1 for default */
1636 struct delayed_work dwork
;
1639 static const char *disk_events_strs
[] = {
1640 [ilog2(DISK_EVENT_MEDIA_CHANGE
)] = "media_change",
1641 [ilog2(DISK_EVENT_EJECT_REQUEST
)] = "eject_request",
1644 static char *disk_uevents
[] = {
1645 [ilog2(DISK_EVENT_MEDIA_CHANGE
)] = "DISK_MEDIA_CHANGE=1",
1646 [ilog2(DISK_EVENT_EJECT_REQUEST
)] = "DISK_EJECT_REQUEST=1",
1649 /* list of all disk_events */
1650 static DEFINE_MUTEX(disk_events_mutex
);
1651 static LIST_HEAD(disk_events
);
1653 /* disable in-kernel polling by default */
1654 static unsigned long disk_events_dfl_poll_msecs
;
1656 static unsigned long disk_events_poll_jiffies(struct gendisk
*disk
)
1658 struct disk_events
*ev
= disk
->ev
;
1659 long intv_msecs
= 0;
1662 * If device-specific poll interval is set, always use it. If
1663 * the default is being used, poll if the POLL flag is set.
1665 if (ev
->poll_msecs
>= 0)
1666 intv_msecs
= ev
->poll_msecs
;
1667 else if (disk
->event_flags
& DISK_EVENT_FLAG_POLL
)
1668 intv_msecs
= disk_events_dfl_poll_msecs
;
1670 return msecs_to_jiffies(intv_msecs
);
1674 * disk_block_events - block and flush disk event checking
1675 * @disk: disk to block events for
1677 * On return from this function, it is guaranteed that event checking
1678 * isn't in progress and won't happen until unblocked by
1679 * disk_unblock_events(). Events blocking is counted and the actual
1680 * unblocking happens after the matching number of unblocks are done.
1682 * Note that this intentionally does not block event checking from
1683 * disk_clear_events().
1688 void disk_block_events(struct gendisk
*disk
)
1690 struct disk_events
*ev
= disk
->ev
;
1691 unsigned long flags
;
1698 * Outer mutex ensures that the first blocker completes canceling
1699 * the event work before further blockers are allowed to finish.
1701 mutex_lock(&ev
->block_mutex
);
1703 spin_lock_irqsave(&ev
->lock
, flags
);
1704 cancel
= !ev
->block
++;
1705 spin_unlock_irqrestore(&ev
->lock
, flags
);
1708 cancel_delayed_work_sync(&disk
->ev
->dwork
);
1710 mutex_unlock(&ev
->block_mutex
);
1713 static void __disk_unblock_events(struct gendisk
*disk
, bool check_now
)
1715 struct disk_events
*ev
= disk
->ev
;
1717 unsigned long flags
;
1719 spin_lock_irqsave(&ev
->lock
, flags
);
1721 if (WARN_ON_ONCE(ev
->block
<= 0))
1727 intv
= disk_events_poll_jiffies(disk
);
1729 queue_delayed_work(system_freezable_power_efficient_wq
,
1732 queue_delayed_work(system_freezable_power_efficient_wq
,
1735 spin_unlock_irqrestore(&ev
->lock
, flags
);
1739 * disk_unblock_events - unblock disk event checking
1740 * @disk: disk to unblock events for
1742 * Undo disk_block_events(). When the block count reaches zero, it
1743 * starts events polling if configured.
1746 * Don't care. Safe to call from irq context.
1748 void disk_unblock_events(struct gendisk
*disk
)
1751 __disk_unblock_events(disk
, false);
1755 * disk_flush_events - schedule immediate event checking and flushing
1756 * @disk: disk to check and flush events for
1757 * @mask: events to flush
1759 * Schedule immediate event checking on @disk if not blocked. Events in
1760 * @mask are scheduled to be cleared from the driver. Note that this
1761 * doesn't clear the events from @disk->ev.
1764 * If @mask is non-zero must be called with bdev->bd_mutex held.
1766 void disk_flush_events(struct gendisk
*disk
, unsigned int mask
)
1768 struct disk_events
*ev
= disk
->ev
;
1773 spin_lock_irq(&ev
->lock
);
1774 ev
->clearing
|= mask
;
1776 mod_delayed_work(system_freezable_power_efficient_wq
,
1778 spin_unlock_irq(&ev
->lock
);
1782 * disk_clear_events - synchronously check, clear and return pending events
1783 * @disk: disk to fetch and clear events from
1784 * @mask: mask of events to be fetched and cleared
1786 * Disk events are synchronously checked and pending events in @mask
1787 * are cleared and returned. This ignores the block count.
1792 unsigned int disk_clear_events(struct gendisk
*disk
, unsigned int mask
)
1794 const struct block_device_operations
*bdops
= disk
->fops
;
1795 struct disk_events
*ev
= disk
->ev
;
1796 unsigned int pending
;
1797 unsigned int clearing
= mask
;
1800 /* for drivers still using the old ->media_changed method */
1801 if ((mask
& DISK_EVENT_MEDIA_CHANGE
) &&
1802 bdops
->media_changed
&& bdops
->media_changed(disk
))
1803 return DISK_EVENT_MEDIA_CHANGE
;
1807 disk_block_events(disk
);
1810 * store the union of mask and ev->clearing on the stack so that the
1811 * race with disk_flush_events does not cause ambiguity (ev->clearing
1812 * can still be modified even if events are blocked).
1814 spin_lock_irq(&ev
->lock
);
1815 clearing
|= ev
->clearing
;
1817 spin_unlock_irq(&ev
->lock
);
1819 disk_check_events(ev
, &clearing
);
1821 * if ev->clearing is not 0, the disk_flush_events got called in the
1822 * middle of this function, so we want to run the workfn without delay.
1824 __disk_unblock_events(disk
, ev
->clearing
? true : false);
1826 /* then, fetch and clear pending events */
1827 spin_lock_irq(&ev
->lock
);
1828 pending
= ev
->pending
& mask
;
1829 ev
->pending
&= ~mask
;
1830 spin_unlock_irq(&ev
->lock
);
1831 WARN_ON_ONCE(clearing
& mask
);
1837 * Separate this part out so that a different pointer for clearing_ptr can be
1838 * passed in for disk_clear_events.
1840 static void disk_events_workfn(struct work_struct
*work
)
1842 struct delayed_work
*dwork
= to_delayed_work(work
);
1843 struct disk_events
*ev
= container_of(dwork
, struct disk_events
, dwork
);
1845 disk_check_events(ev
, &ev
->clearing
);
1848 static void disk_check_events(struct disk_events
*ev
,
1849 unsigned int *clearing_ptr
)
1851 struct gendisk
*disk
= ev
->disk
;
1852 char *envp
[ARRAY_SIZE(disk_uevents
) + 1] = { };
1853 unsigned int clearing
= *clearing_ptr
;
1854 unsigned int events
;
1856 int nr_events
= 0, i
;
1859 events
= disk
->fops
->check_events(disk
, clearing
);
1861 /* accumulate pending events and schedule next poll if necessary */
1862 spin_lock_irq(&ev
->lock
);
1864 events
&= ~ev
->pending
;
1865 ev
->pending
|= events
;
1866 *clearing_ptr
&= ~clearing
;
1868 intv
= disk_events_poll_jiffies(disk
);
1869 if (!ev
->block
&& intv
)
1870 queue_delayed_work(system_freezable_power_efficient_wq
,
1873 spin_unlock_irq(&ev
->lock
);
1876 * Tell userland about new events. Only the events listed in
1877 * @disk->events are reported, and only if DISK_EVENT_FLAG_UEVENT
1878 * is set. Otherwise, events are processed internally but never
1879 * get reported to userland.
1881 for (i
= 0; i
< ARRAY_SIZE(disk_uevents
); i
++)
1882 if ((events
& disk
->events
& (1 << i
)) &&
1883 (disk
->event_flags
& DISK_EVENT_FLAG_UEVENT
))
1884 envp
[nr_events
++] = disk_uevents
[i
];
1887 kobject_uevent_env(&disk_to_dev(disk
)->kobj
, KOBJ_CHANGE
, envp
);
1891 * A disk events enabled device has the following sysfs nodes under
1892 * its /sys/block/X/ directory.
1894 * events : list of all supported events
1895 * events_async : list of events which can be detected w/o polling
1896 * (always empty, only for backwards compatibility)
1897 * events_poll_msecs : polling interval, 0: disable, -1: system default
1899 static ssize_t
__disk_events_show(unsigned int events
, char *buf
)
1901 const char *delim
= "";
1905 for (i
= 0; i
< ARRAY_SIZE(disk_events_strs
); i
++)
1906 if (events
& (1 << i
)) {
1907 pos
+= sprintf(buf
+ pos
, "%s%s",
1908 delim
, disk_events_strs
[i
]);
1912 pos
+= sprintf(buf
+ pos
, "\n");
1916 static ssize_t
disk_events_show(struct device
*dev
,
1917 struct device_attribute
*attr
, char *buf
)
1919 struct gendisk
*disk
= dev_to_disk(dev
);
1921 if (!(disk
->event_flags
& DISK_EVENT_FLAG_UEVENT
))
1924 return __disk_events_show(disk
->events
, buf
);
1927 static ssize_t
disk_events_async_show(struct device
*dev
,
1928 struct device_attribute
*attr
, char *buf
)
1933 static ssize_t
disk_events_poll_msecs_show(struct device
*dev
,
1934 struct device_attribute
*attr
,
1937 struct gendisk
*disk
= dev_to_disk(dev
);
1940 return sprintf(buf
, "-1\n");
1942 return sprintf(buf
, "%ld\n", disk
->ev
->poll_msecs
);
1945 static ssize_t
disk_events_poll_msecs_store(struct device
*dev
,
1946 struct device_attribute
*attr
,
1947 const char *buf
, size_t count
)
1949 struct gendisk
*disk
= dev_to_disk(dev
);
1952 if (!count
|| !sscanf(buf
, "%ld", &intv
))
1955 if (intv
< 0 && intv
!= -1)
1961 disk_block_events(disk
);
1962 disk
->ev
->poll_msecs
= intv
;
1963 __disk_unblock_events(disk
, true);
1968 static const DEVICE_ATTR(events
, 0444, disk_events_show
, NULL
);
1969 static const DEVICE_ATTR(events_async
, 0444, disk_events_async_show
, NULL
);
1970 static const DEVICE_ATTR(events_poll_msecs
, 0644,
1971 disk_events_poll_msecs_show
,
1972 disk_events_poll_msecs_store
);
1974 static const struct attribute
*disk_events_attrs
[] = {
1975 &dev_attr_events
.attr
,
1976 &dev_attr_events_async
.attr
,
1977 &dev_attr_events_poll_msecs
.attr
,
1982 * The default polling interval can be specified by the kernel
1983 * parameter block.events_dfl_poll_msecs which defaults to 0
1984 * (disable). This can also be modified runtime by writing to
1985 * /sys/module/block/parameters/events_dfl_poll_msecs.
1987 static int disk_events_set_dfl_poll_msecs(const char *val
,
1988 const struct kernel_param
*kp
)
1990 struct disk_events
*ev
;
1993 ret
= param_set_ulong(val
, kp
);
1997 mutex_lock(&disk_events_mutex
);
1999 list_for_each_entry(ev
, &disk_events
, node
)
2000 disk_flush_events(ev
->disk
, 0);
2002 mutex_unlock(&disk_events_mutex
);
2007 static const struct kernel_param_ops disk_events_dfl_poll_msecs_param_ops
= {
2008 .set
= disk_events_set_dfl_poll_msecs
,
2009 .get
= param_get_ulong
,
2012 #undef MODULE_PARAM_PREFIX
2013 #define MODULE_PARAM_PREFIX "block."
2015 module_param_cb(events_dfl_poll_msecs
, &disk_events_dfl_poll_msecs_param_ops
,
2016 &disk_events_dfl_poll_msecs
, 0644);
2019 * disk_{alloc|add|del|release}_events - initialize and destroy disk_events.
2021 static void disk_alloc_events(struct gendisk
*disk
)
2023 struct disk_events
*ev
;
2025 if (!disk
->fops
->check_events
|| !disk
->events
)
2028 ev
= kzalloc(sizeof(*ev
), GFP_KERNEL
);
2030 pr_warn("%s: failed to initialize events\n", disk
->disk_name
);
2034 INIT_LIST_HEAD(&ev
->node
);
2036 spin_lock_init(&ev
->lock
);
2037 mutex_init(&ev
->block_mutex
);
2039 ev
->poll_msecs
= -1;
2040 INIT_DELAYED_WORK(&ev
->dwork
, disk_events_workfn
);
2045 static void disk_add_events(struct gendisk
*disk
)
2047 /* FIXME: error handling */
2048 if (sysfs_create_files(&disk_to_dev(disk
)->kobj
, disk_events_attrs
) < 0)
2049 pr_warn("%s: failed to create sysfs files for events\n",
2055 mutex_lock(&disk_events_mutex
);
2056 list_add_tail(&disk
->ev
->node
, &disk_events
);
2057 mutex_unlock(&disk_events_mutex
);
2060 * Block count is initialized to 1 and the following initial
2061 * unblock kicks it into action.
2063 __disk_unblock_events(disk
, true);
2066 static void disk_del_events(struct gendisk
*disk
)
2069 disk_block_events(disk
);
2071 mutex_lock(&disk_events_mutex
);
2072 list_del_init(&disk
->ev
->node
);
2073 mutex_unlock(&disk_events_mutex
);
2076 sysfs_remove_files(&disk_to_dev(disk
)->kobj
, disk_events_attrs
);
2079 static void disk_release_events(struct gendisk
*disk
)
2081 /* the block count should be 1 from disk_del_events() */
2082 WARN_ON_ONCE(disk
->ev
&& disk
->ev
->block
!= 1);