5 #include <linux/module.h>
7 #include <linux/genhd.h>
8 #include <linux/kdev_t.h>
9 #include <linux/kernel.h>
10 #include <linux/blkdev.h>
11 #include <linux/backing-dev.h>
12 #include <linux/init.h>
13 #include <linux/spinlock.h>
14 #include <linux/proc_fs.h>
15 #include <linux/seq_file.h>
16 #include <linux/slab.h>
17 #include <linux/kmod.h>
18 #include <linux/kobj_map.h>
19 #include <linux/mutex.h>
20 #include <linux/idr.h>
21 #include <linux/log2.h>
22 #include <linux/pm_runtime.h>
23 #include <linux/badblocks.h>
27 static DEFINE_MUTEX(block_class_lock
);
28 struct kobject
*block_depr
;
30 /* for extended dynamic devt allocation, currently only one major is used */
31 #define NR_EXT_DEVT (1 << MINORBITS)
33 /* For extended devt allocation. ext_devt_lock prevents look up
34 * results from going away underneath its user.
36 static DEFINE_SPINLOCK(ext_devt_lock
);
37 static DEFINE_IDR(ext_devt_idr
);
39 static const struct device_type disk_type
;
41 static void disk_check_events(struct disk_events
*ev
,
42 unsigned int *clearing_ptr
);
43 static void disk_alloc_events(struct gendisk
*disk
);
44 static void disk_add_events(struct gendisk
*disk
);
45 static void disk_del_events(struct gendisk
*disk
);
46 static void disk_release_events(struct gendisk
*disk
);
48 void part_inc_in_flight(struct request_queue
*q
, struct hd_struct
*part
, int rw
)
53 part_stat_local_inc(part
, in_flight
[rw
]);
55 part_stat_local_inc(&part_to_disk(part
)->part0
, in_flight
[rw
]);
58 void part_dec_in_flight(struct request_queue
*q
, struct hd_struct
*part
, int rw
)
63 part_stat_local_dec(part
, in_flight
[rw
]);
65 part_stat_local_dec(&part_to_disk(part
)->part0
, in_flight
[rw
]);
68 unsigned int part_in_flight(struct request_queue
*q
, struct hd_struct
*part
)
71 unsigned int inflight
;
74 return blk_mq_in_flight(q
, part
);
78 for_each_possible_cpu(cpu
) {
79 inflight
+= part_stat_local_read_cpu(part
, in_flight
[0], cpu
) +
80 part_stat_local_read_cpu(part
, in_flight
[1], cpu
);
82 if ((int)inflight
< 0)
88 void part_in_flight_rw(struct request_queue
*q
, struct hd_struct
*part
,
89 unsigned int inflight
[2])
94 blk_mq_in_flight_rw(q
, part
, inflight
);
100 for_each_possible_cpu(cpu
) {
101 inflight
[0] += part_stat_local_read_cpu(part
, in_flight
[0], cpu
);
102 inflight
[1] += part_stat_local_read_cpu(part
, in_flight
[1], cpu
);
104 if ((int)inflight
[0] < 0)
106 if ((int)inflight
[1] < 0)
110 struct hd_struct
*__disk_get_part(struct gendisk
*disk
, int partno
)
112 struct disk_part_tbl
*ptbl
= rcu_dereference(disk
->part_tbl
);
114 if (unlikely(partno
< 0 || partno
>= ptbl
->len
))
116 return rcu_dereference(ptbl
->part
[partno
]);
120 * disk_get_part - get partition
121 * @disk: disk to look partition from
122 * @partno: partition number
124 * Look for partition @partno from @disk. If found, increment
125 * reference count and return it.
131 * Pointer to the found partition on success, NULL if not found.
133 struct hd_struct
*disk_get_part(struct gendisk
*disk
, int partno
)
135 struct hd_struct
*part
;
138 part
= __disk_get_part(disk
, partno
);
140 get_device(part_to_dev(part
));
145 EXPORT_SYMBOL_GPL(disk_get_part
);
148 * disk_part_iter_init - initialize partition iterator
149 * @piter: iterator to initialize
150 * @disk: disk to iterate over
151 * @flags: DISK_PITER_* flags
153 * Initialize @piter so that it iterates over partitions of @disk.
158 void disk_part_iter_init(struct disk_part_iter
*piter
, struct gendisk
*disk
,
161 struct disk_part_tbl
*ptbl
;
164 ptbl
= rcu_dereference(disk
->part_tbl
);
169 if (flags
& DISK_PITER_REVERSE
)
170 piter
->idx
= ptbl
->len
- 1;
171 else if (flags
& (DISK_PITER_INCL_PART0
| DISK_PITER_INCL_EMPTY_PART0
))
176 piter
->flags
= flags
;
180 EXPORT_SYMBOL_GPL(disk_part_iter_init
);
183 * disk_part_iter_next - proceed iterator to the next partition and return it
184 * @piter: iterator of interest
186 * Proceed @piter to the next partition and return it.
191 struct hd_struct
*disk_part_iter_next(struct disk_part_iter
*piter
)
193 struct disk_part_tbl
*ptbl
;
196 /* put the last partition */
197 disk_put_part(piter
->part
);
202 ptbl
= rcu_dereference(piter
->disk
->part_tbl
);
204 /* determine iteration parameters */
205 if (piter
->flags
& DISK_PITER_REVERSE
) {
207 if (piter
->flags
& (DISK_PITER_INCL_PART0
|
208 DISK_PITER_INCL_EMPTY_PART0
))
217 /* iterate to the next partition */
218 for (; piter
->idx
!= end
; piter
->idx
+= inc
) {
219 struct hd_struct
*part
;
221 part
= rcu_dereference(ptbl
->part
[piter
->idx
]);
224 if (!part_nr_sects_read(part
) &&
225 !(piter
->flags
& DISK_PITER_INCL_EMPTY
) &&
226 !(piter
->flags
& DISK_PITER_INCL_EMPTY_PART0
&&
230 get_device(part_to_dev(part
));
240 EXPORT_SYMBOL_GPL(disk_part_iter_next
);
243 * disk_part_iter_exit - finish up partition iteration
244 * @piter: iter of interest
246 * Called when iteration is over. Cleans up @piter.
251 void disk_part_iter_exit(struct disk_part_iter
*piter
)
253 disk_put_part(piter
->part
);
256 EXPORT_SYMBOL_GPL(disk_part_iter_exit
);
258 static inline int sector_in_part(struct hd_struct
*part
, sector_t sector
)
260 return part
->start_sect
<= sector
&&
261 sector
< part
->start_sect
+ part_nr_sects_read(part
);
265 * disk_map_sector_rcu - map sector to partition
266 * @disk: gendisk of interest
267 * @sector: sector to map
269 * Find out which partition @sector maps to on @disk. This is
270 * primarily used for stats accounting.
273 * RCU read locked. The returned partition pointer is valid only
274 * while preemption is disabled.
277 * Found partition on success, part0 is returned if no partition matches
279 struct hd_struct
*disk_map_sector_rcu(struct gendisk
*disk
, sector_t sector
)
281 struct disk_part_tbl
*ptbl
;
282 struct hd_struct
*part
;
285 ptbl
= rcu_dereference(disk
->part_tbl
);
287 part
= rcu_dereference(ptbl
->last_lookup
);
288 if (part
&& sector_in_part(part
, sector
))
291 for (i
= 1; i
< ptbl
->len
; i
++) {
292 part
= rcu_dereference(ptbl
->part
[i
]);
294 if (part
&& sector_in_part(part
, sector
)) {
295 rcu_assign_pointer(ptbl
->last_lookup
, part
);
301 EXPORT_SYMBOL_GPL(disk_map_sector_rcu
);
304 * Can be deleted altogether. Later.
307 #define BLKDEV_MAJOR_HASH_SIZE 255
308 static struct blk_major_name
{
309 struct blk_major_name
*next
;
312 } *major_names
[BLKDEV_MAJOR_HASH_SIZE
];
314 /* index in the above - for now: assume no multimajor ranges */
315 static inline int major_to_index(unsigned major
)
317 return major
% BLKDEV_MAJOR_HASH_SIZE
;
320 #ifdef CONFIG_PROC_FS
321 void blkdev_show(struct seq_file
*seqf
, off_t offset
)
323 struct blk_major_name
*dp
;
325 mutex_lock(&block_class_lock
);
326 for (dp
= major_names
[major_to_index(offset
)]; dp
; dp
= dp
->next
)
327 if (dp
->major
== offset
)
328 seq_printf(seqf
, "%3d %s\n", dp
->major
, dp
->name
);
329 mutex_unlock(&block_class_lock
);
331 #endif /* CONFIG_PROC_FS */
334 * register_blkdev - register a new block device
336 * @major: the requested major device number [1..BLKDEV_MAJOR_MAX-1]. If
337 * @major = 0, try to allocate any unused major number.
338 * @name: the name of the new block device as a zero terminated string
340 * The @name must be unique within the system.
342 * The return value depends on the @major input parameter:
344 * - if a major device number was requested in range [1..BLKDEV_MAJOR_MAX-1]
345 * then the function returns zero on success, or a negative error code
346 * - if any unused major number was requested with @major = 0 parameter
347 * then the return value is the allocated major number in range
348 * [1..BLKDEV_MAJOR_MAX-1] or a negative error code otherwise
350 * See Documentation/admin-guide/devices.txt for the list of allocated
353 int register_blkdev(unsigned int major
, const char *name
)
355 struct blk_major_name
**n
, *p
;
358 mutex_lock(&block_class_lock
);
362 for (index
= ARRAY_SIZE(major_names
)-1; index
> 0; index
--) {
363 if (major_names
[index
] == NULL
)
368 printk("%s: failed to get major for %s\n",
377 if (major
>= BLKDEV_MAJOR_MAX
) {
378 pr_err("%s: major requested (%u) is greater than the maximum (%u) for %s\n",
379 __func__
, major
, BLKDEV_MAJOR_MAX
-1, name
);
385 p
= kmalloc(sizeof(struct blk_major_name
), GFP_KERNEL
);
392 strlcpy(p
->name
, name
, sizeof(p
->name
));
394 index
= major_to_index(major
);
396 for (n
= &major_names
[index
]; *n
; n
= &(*n
)->next
) {
397 if ((*n
)->major
== major
)
406 printk("register_blkdev: cannot get major %u for %s\n",
411 mutex_unlock(&block_class_lock
);
415 EXPORT_SYMBOL(register_blkdev
);
417 void unregister_blkdev(unsigned int major
, const char *name
)
419 struct blk_major_name
**n
;
420 struct blk_major_name
*p
= NULL
;
421 int index
= major_to_index(major
);
423 mutex_lock(&block_class_lock
);
424 for (n
= &major_names
[index
]; *n
; n
= &(*n
)->next
)
425 if ((*n
)->major
== major
)
427 if (!*n
|| strcmp((*n
)->name
, name
)) {
433 mutex_unlock(&block_class_lock
);
437 EXPORT_SYMBOL(unregister_blkdev
);
439 static struct kobj_map
*bdev_map
;
442 * blk_mangle_minor - scatter minor numbers apart
443 * @minor: minor number to mangle
445 * Scatter consecutively allocated @minor number apart if MANGLE_DEVT
446 * is enabled. Mangling twice gives the original value.
454 static int blk_mangle_minor(int minor
)
456 #ifdef CONFIG_DEBUG_BLOCK_EXT_DEVT
459 for (i
= 0; i
< MINORBITS
/ 2; i
++) {
460 int low
= minor
& (1 << i
);
461 int high
= minor
& (1 << (MINORBITS
- 1 - i
));
462 int distance
= MINORBITS
- 1 - 2 * i
;
464 minor
^= low
| high
; /* clear both bits */
465 low
<<= distance
; /* swap the positions */
467 minor
|= low
| high
; /* and set */
474 * blk_alloc_devt - allocate a dev_t for a partition
475 * @part: partition to allocate dev_t for
476 * @devt: out parameter for resulting dev_t
478 * Allocate a dev_t for block device.
481 * 0 on success, allocated dev_t is returned in *@devt. -errno on
487 int blk_alloc_devt(struct hd_struct
*part
, dev_t
*devt
)
489 struct gendisk
*disk
= part_to_disk(part
);
492 /* in consecutive minor range? */
493 if (part
->partno
< disk
->minors
) {
494 *devt
= MKDEV(disk
->major
, disk
->first_minor
+ part
->partno
);
498 /* allocate ext devt */
499 idr_preload(GFP_KERNEL
);
501 spin_lock_bh(&ext_devt_lock
);
502 idx
= idr_alloc(&ext_devt_idr
, part
, 0, NR_EXT_DEVT
, GFP_NOWAIT
);
503 spin_unlock_bh(&ext_devt_lock
);
507 return idx
== -ENOSPC
? -EBUSY
: idx
;
509 *devt
= MKDEV(BLOCK_EXT_MAJOR
, blk_mangle_minor(idx
));
514 * blk_free_devt - free a dev_t
515 * @devt: dev_t to free
517 * Free @devt which was allocated using blk_alloc_devt().
522 void blk_free_devt(dev_t devt
)
524 if (devt
== MKDEV(0, 0))
527 if (MAJOR(devt
) == BLOCK_EXT_MAJOR
) {
528 spin_lock_bh(&ext_devt_lock
);
529 idr_remove(&ext_devt_idr
, blk_mangle_minor(MINOR(devt
)));
530 spin_unlock_bh(&ext_devt_lock
);
535 * We invalidate devt by assigning NULL pointer for devt in idr.
537 void blk_invalidate_devt(dev_t devt
)
539 if (MAJOR(devt
) == BLOCK_EXT_MAJOR
) {
540 spin_lock_bh(&ext_devt_lock
);
541 idr_replace(&ext_devt_idr
, NULL
, blk_mangle_minor(MINOR(devt
)));
542 spin_unlock_bh(&ext_devt_lock
);
546 static char *bdevt_str(dev_t devt
, char *buf
)
548 if (MAJOR(devt
) <= 0xff && MINOR(devt
) <= 0xff) {
549 char tbuf
[BDEVT_SIZE
];
550 snprintf(tbuf
, BDEVT_SIZE
, "%02x%02x", MAJOR(devt
), MINOR(devt
));
551 snprintf(buf
, BDEVT_SIZE
, "%-9s", tbuf
);
553 snprintf(buf
, BDEVT_SIZE
, "%03x:%05x", MAJOR(devt
), MINOR(devt
));
559 * Register device numbers dev..(dev+range-1)
560 * range must be nonzero
561 * The hash chain is sorted on range, so that subranges can override.
563 void blk_register_region(dev_t devt
, unsigned long range
, struct module
*module
,
564 struct kobject
*(*probe
)(dev_t
, int *, void *),
565 int (*lock
)(dev_t
, void *), void *data
)
567 kobj_map(bdev_map
, devt
, range
, module
, probe
, lock
, data
);
570 EXPORT_SYMBOL(blk_register_region
);
572 void blk_unregister_region(dev_t devt
, unsigned long range
)
574 kobj_unmap(bdev_map
, devt
, range
);
577 EXPORT_SYMBOL(blk_unregister_region
);
579 static struct kobject
*exact_match(dev_t devt
, int *partno
, void *data
)
581 struct gendisk
*p
= data
;
583 return &disk_to_dev(p
)->kobj
;
586 static int exact_lock(dev_t devt
, void *data
)
588 struct gendisk
*p
= data
;
590 if (!get_disk_and_module(p
))
595 static void register_disk(struct device
*parent
, struct gendisk
*disk
,
596 const struct attribute_group
**groups
)
598 struct device
*ddev
= disk_to_dev(disk
);
599 struct block_device
*bdev
;
600 struct disk_part_iter piter
;
601 struct hd_struct
*part
;
604 ddev
->parent
= parent
;
606 dev_set_name(ddev
, "%s", disk
->disk_name
);
608 /* delay uevents, until we scanned partition table */
609 dev_set_uevent_suppress(ddev
, 1);
612 WARN_ON(ddev
->groups
);
613 ddev
->groups
= groups
;
615 if (device_add(ddev
))
617 if (!sysfs_deprecated
) {
618 err
= sysfs_create_link(block_depr
, &ddev
->kobj
,
619 kobject_name(&ddev
->kobj
));
627 * avoid probable deadlock caused by allocating memory with
628 * GFP_KERNEL in runtime_resume callback of its all ancestor
631 pm_runtime_set_memalloc_noio(ddev
, true);
633 disk
->part0
.holder_dir
= kobject_create_and_add("holders", &ddev
->kobj
);
634 disk
->slave_dir
= kobject_create_and_add("slaves", &ddev
->kobj
);
636 if (disk
->flags
& GENHD_FL_HIDDEN
) {
637 dev_set_uevent_suppress(ddev
, 0);
641 /* No minors to use for partitions */
642 if (!disk_part_scan_enabled(disk
))
645 /* No such device (e.g., media were just removed) */
646 if (!get_capacity(disk
))
649 bdev
= bdget_disk(disk
, 0);
653 bdev
->bd_invalidated
= 1;
654 err
= blkdev_get(bdev
, FMODE_READ
, NULL
);
657 blkdev_put(bdev
, FMODE_READ
);
660 /* announce disk after possible partitions are created */
661 dev_set_uevent_suppress(ddev
, 0);
662 kobject_uevent(&ddev
->kobj
, KOBJ_ADD
);
664 /* announce possible partitions */
665 disk_part_iter_init(&piter
, disk
, 0);
666 while ((part
= disk_part_iter_next(&piter
)))
667 kobject_uevent(&part_to_dev(part
)->kobj
, KOBJ_ADD
);
668 disk_part_iter_exit(&piter
);
670 if (disk
->queue
->backing_dev_info
->dev
) {
671 err
= sysfs_create_link(&ddev
->kobj
,
672 &disk
->queue
->backing_dev_info
->dev
->kobj
,
679 * __device_add_disk - add disk information to kernel list
680 * @parent: parent device for the disk
681 * @disk: per-device partitioning information
682 * @groups: Additional per-device sysfs groups
683 * @register_queue: register the queue if set to true
685 * This function registers the partitioning information in @disk
688 * FIXME: error handling
690 static void __device_add_disk(struct device
*parent
, struct gendisk
*disk
,
691 const struct attribute_group
**groups
,
697 /* minors == 0 indicates to use ext devt from part0 and should
698 * be accompanied with EXT_DEVT flag. Make sure all
699 * parameters make sense.
701 WARN_ON(disk
->minors
&& !(disk
->major
|| disk
->first_minor
));
702 WARN_ON(!disk
->minors
&&
703 !(disk
->flags
& (GENHD_FL_EXT_DEVT
| GENHD_FL_HIDDEN
)));
705 disk
->flags
|= GENHD_FL_UP
;
707 retval
= blk_alloc_devt(&disk
->part0
, &devt
);
712 disk
->major
= MAJOR(devt
);
713 disk
->first_minor
= MINOR(devt
);
715 disk_alloc_events(disk
);
717 if (disk
->flags
& GENHD_FL_HIDDEN
) {
719 * Don't let hidden disks show up in /proc/partitions,
720 * and don't bother scanning for partitions either.
722 disk
->flags
|= GENHD_FL_SUPPRESS_PARTITION_INFO
;
723 disk
->flags
|= GENHD_FL_NO_PART_SCAN
;
727 /* Register BDI before referencing it from bdev */
728 disk_to_dev(disk
)->devt
= devt
;
729 ret
= bdi_register_owner(disk
->queue
->backing_dev_info
,
732 blk_register_region(disk_devt(disk
), disk
->minors
, NULL
,
733 exact_match
, exact_lock
, disk
);
735 register_disk(parent
, disk
, groups
);
737 blk_register_queue(disk
);
740 * Take an extra ref on queue which will be put on disk_release()
741 * so that it sticks around as long as @disk is there.
743 WARN_ON_ONCE(!blk_get_queue(disk
->queue
));
745 disk_add_events(disk
);
746 blk_integrity_add(disk
);
749 void device_add_disk(struct device
*parent
, struct gendisk
*disk
,
750 const struct attribute_group
**groups
)
753 __device_add_disk(parent
, disk
, groups
, true);
755 EXPORT_SYMBOL(device_add_disk
);
757 void device_add_disk_no_queue_reg(struct device
*parent
, struct gendisk
*disk
)
759 __device_add_disk(parent
, disk
, NULL
, false);
761 EXPORT_SYMBOL(device_add_disk_no_queue_reg
);
763 void del_gendisk(struct gendisk
*disk
)
765 struct disk_part_iter piter
;
766 struct hd_struct
*part
;
768 blk_integrity_del(disk
);
769 disk_del_events(disk
);
772 * Block lookups of the disk until all bdevs are unhashed and the
773 * disk is marked as dead (GENHD_FL_UP cleared).
775 down_write(&disk
->lookup_sem
);
776 /* invalidate stuff */
777 disk_part_iter_init(&piter
, disk
,
778 DISK_PITER_INCL_EMPTY
| DISK_PITER_REVERSE
);
779 while ((part
= disk_part_iter_next(&piter
))) {
780 invalidate_partition(disk
, part
->partno
);
781 bdev_unhash_inode(part_devt(part
));
782 delete_partition(disk
, part
->partno
);
784 disk_part_iter_exit(&piter
);
786 invalidate_partition(disk
, 0);
787 bdev_unhash_inode(disk_devt(disk
));
788 set_capacity(disk
, 0);
789 disk
->flags
&= ~GENHD_FL_UP
;
790 up_write(&disk
->lookup_sem
);
792 if (!(disk
->flags
& GENHD_FL_HIDDEN
))
793 sysfs_remove_link(&disk_to_dev(disk
)->kobj
, "bdi");
796 * Unregister bdi before releasing device numbers (as they can
797 * get reused and we'd get clashes in sysfs).
799 if (!(disk
->flags
& GENHD_FL_HIDDEN
))
800 bdi_unregister(disk
->queue
->backing_dev_info
);
801 blk_unregister_queue(disk
);
806 if (!(disk
->flags
& GENHD_FL_HIDDEN
))
807 blk_unregister_region(disk_devt(disk
), disk
->minors
);
809 * Remove gendisk pointer from idr so that it cannot be looked up
810 * while RCU period before freeing gendisk is running to prevent
811 * use-after-free issues. Note that the device number stays
812 * "in-use" until we really free the gendisk.
814 blk_invalidate_devt(disk_devt(disk
));
816 kobject_put(disk
->part0
.holder_dir
);
817 kobject_put(disk
->slave_dir
);
819 part_stat_set_all(&disk
->part0
, 0);
820 disk
->part0
.stamp
= 0;
821 if (!sysfs_deprecated
)
822 sysfs_remove_link(block_depr
, dev_name(disk_to_dev(disk
)));
823 pm_runtime_set_memalloc_noio(disk_to_dev(disk
), false);
824 device_del(disk_to_dev(disk
));
826 EXPORT_SYMBOL(del_gendisk
);
828 /* sysfs access to bad-blocks list. */
829 static ssize_t
disk_badblocks_show(struct device
*dev
,
830 struct device_attribute
*attr
,
833 struct gendisk
*disk
= dev_to_disk(dev
);
836 return sprintf(page
, "\n");
838 return badblocks_show(disk
->bb
, page
, 0);
841 static ssize_t
disk_badblocks_store(struct device
*dev
,
842 struct device_attribute
*attr
,
843 const char *page
, size_t len
)
845 struct gendisk
*disk
= dev_to_disk(dev
);
850 return badblocks_store(disk
->bb
, page
, len
, 0);
854 * get_gendisk - get partitioning information for a given device
855 * @devt: device to get partitioning information for
856 * @partno: returned partition index
858 * This function gets the structure containing partitioning
859 * information for the given device @devt.
861 struct gendisk
*get_gendisk(dev_t devt
, int *partno
)
863 struct gendisk
*disk
= NULL
;
865 if (MAJOR(devt
) != BLOCK_EXT_MAJOR
) {
866 struct kobject
*kobj
;
868 kobj
= kobj_lookup(bdev_map
, devt
, partno
);
870 disk
= dev_to_disk(kobj_to_dev(kobj
));
872 struct hd_struct
*part
;
874 spin_lock_bh(&ext_devt_lock
);
875 part
= idr_find(&ext_devt_idr
, blk_mangle_minor(MINOR(devt
)));
876 if (part
&& get_disk_and_module(part_to_disk(part
))) {
877 *partno
= part
->partno
;
878 disk
= part_to_disk(part
);
880 spin_unlock_bh(&ext_devt_lock
);
887 * Synchronize with del_gendisk() to not return disk that is being
890 down_read(&disk
->lookup_sem
);
891 if (unlikely((disk
->flags
& GENHD_FL_HIDDEN
) ||
892 !(disk
->flags
& GENHD_FL_UP
))) {
893 up_read(&disk
->lookup_sem
);
894 put_disk_and_module(disk
);
897 up_read(&disk
->lookup_sem
);
901 EXPORT_SYMBOL(get_gendisk
);
904 * bdget_disk - do bdget() by gendisk and partition number
905 * @disk: gendisk of interest
906 * @partno: partition number
908 * Find partition @partno from @disk, do bdget() on it.
914 * Resulting block_device on success, NULL on failure.
916 struct block_device
*bdget_disk(struct gendisk
*disk
, int partno
)
918 struct hd_struct
*part
;
919 struct block_device
*bdev
= NULL
;
921 part
= disk_get_part(disk
, partno
);
923 bdev
= bdget(part_devt(part
));
928 EXPORT_SYMBOL(bdget_disk
);
931 * print a full list of all partitions - intended for places where the root
932 * filesystem can't be mounted and thus to give the victim some idea of what
935 void __init
printk_all_partitions(void)
937 struct class_dev_iter iter
;
940 class_dev_iter_init(&iter
, &block_class
, NULL
, &disk_type
);
941 while ((dev
= class_dev_iter_next(&iter
))) {
942 struct gendisk
*disk
= dev_to_disk(dev
);
943 struct disk_part_iter piter
;
944 struct hd_struct
*part
;
945 char name_buf
[BDEVNAME_SIZE
];
946 char devt_buf
[BDEVT_SIZE
];
949 * Don't show empty devices or things that have been
952 if (get_capacity(disk
) == 0 ||
953 (disk
->flags
& GENHD_FL_SUPPRESS_PARTITION_INFO
))
957 * Note, unlike /proc/partitions, I am showing the
958 * numbers in hex - the same format as the root=
961 disk_part_iter_init(&piter
, disk
, DISK_PITER_INCL_PART0
);
962 while ((part
= disk_part_iter_next(&piter
))) {
963 bool is_part0
= part
== &disk
->part0
;
965 printk("%s%s %10llu %s %s", is_part0
? "" : " ",
966 bdevt_str(part_devt(part
), devt_buf
),
967 (unsigned long long)part_nr_sects_read(part
) >> 1
968 , disk_name(disk
, part
->partno
, name_buf
),
969 part
->info
? part
->info
->uuid
: "");
971 if (dev
->parent
&& dev
->parent
->driver
)
972 printk(" driver: %s\n",
973 dev
->parent
->driver
->name
);
975 printk(" (driver?)\n");
979 disk_part_iter_exit(&piter
);
981 class_dev_iter_exit(&iter
);
984 #ifdef CONFIG_PROC_FS
986 static void *disk_seqf_start(struct seq_file
*seqf
, loff_t
*pos
)
989 struct class_dev_iter
*iter
;
992 iter
= kmalloc(sizeof(*iter
), GFP_KERNEL
);
994 return ERR_PTR(-ENOMEM
);
996 seqf
->private = iter
;
997 class_dev_iter_init(iter
, &block_class
, NULL
, &disk_type
);
999 dev
= class_dev_iter_next(iter
);
1004 return dev_to_disk(dev
);
1007 static void *disk_seqf_next(struct seq_file
*seqf
, void *v
, loff_t
*pos
)
1012 dev
= class_dev_iter_next(seqf
->private);
1014 return dev_to_disk(dev
);
1019 static void disk_seqf_stop(struct seq_file
*seqf
, void *v
)
1021 struct class_dev_iter
*iter
= seqf
->private;
1023 /* stop is called even after start failed :-( */
1025 class_dev_iter_exit(iter
);
1027 seqf
->private = NULL
;
1031 static void *show_partition_start(struct seq_file
*seqf
, loff_t
*pos
)
1035 p
= disk_seqf_start(seqf
, pos
);
1036 if (!IS_ERR_OR_NULL(p
) && !*pos
)
1037 seq_puts(seqf
, "major minor #blocks name\n\n");
1041 static int show_partition(struct seq_file
*seqf
, void *v
)
1043 struct gendisk
*sgp
= v
;
1044 struct disk_part_iter piter
;
1045 struct hd_struct
*part
;
1046 char buf
[BDEVNAME_SIZE
];
1048 /* Don't show non-partitionable removeable devices or empty devices */
1049 if (!get_capacity(sgp
) || (!disk_max_parts(sgp
) &&
1050 (sgp
->flags
& GENHD_FL_REMOVABLE
)))
1052 if (sgp
->flags
& GENHD_FL_SUPPRESS_PARTITION_INFO
)
1055 /* show the full disk and all non-0 size partitions of it */
1056 disk_part_iter_init(&piter
, sgp
, DISK_PITER_INCL_PART0
);
1057 while ((part
= disk_part_iter_next(&piter
)))
1058 seq_printf(seqf
, "%4d %7d %10llu %s\n",
1059 MAJOR(part_devt(part
)), MINOR(part_devt(part
)),
1060 (unsigned long long)part_nr_sects_read(part
) >> 1,
1061 disk_name(sgp
, part
->partno
, buf
));
1062 disk_part_iter_exit(&piter
);
1067 static const struct seq_operations partitions_op
= {
1068 .start
= show_partition_start
,
1069 .next
= disk_seqf_next
,
1070 .stop
= disk_seqf_stop
,
1071 .show
= show_partition
1076 static struct kobject
*base_probe(dev_t devt
, int *partno
, void *data
)
1078 if (request_module("block-major-%d-%d", MAJOR(devt
), MINOR(devt
)) > 0)
1079 /* Make old-style 2.4 aliases work */
1080 request_module("block-major-%d", MAJOR(devt
));
1084 static int __init
genhd_device_init(void)
1088 block_class
.dev_kobj
= sysfs_dev_block_kobj
;
1089 error
= class_register(&block_class
);
1090 if (unlikely(error
))
1092 bdev_map
= kobj_map_init(base_probe
, &block_class_lock
);
1095 register_blkdev(BLOCK_EXT_MAJOR
, "blkext");
1097 /* create top-level block dir */
1098 if (!sysfs_deprecated
)
1099 block_depr
= kobject_create_and_add("block", NULL
);
1103 subsys_initcall(genhd_device_init
);
1105 static ssize_t
disk_range_show(struct device
*dev
,
1106 struct device_attribute
*attr
, char *buf
)
1108 struct gendisk
*disk
= dev_to_disk(dev
);
1110 return sprintf(buf
, "%d\n", disk
->minors
);
1113 static ssize_t
disk_ext_range_show(struct device
*dev
,
1114 struct device_attribute
*attr
, char *buf
)
1116 struct gendisk
*disk
= dev_to_disk(dev
);
1118 return sprintf(buf
, "%d\n", disk_max_parts(disk
));
1121 static ssize_t
disk_removable_show(struct device
*dev
,
1122 struct device_attribute
*attr
, char *buf
)
1124 struct gendisk
*disk
= dev_to_disk(dev
);
1126 return sprintf(buf
, "%d\n",
1127 (disk
->flags
& GENHD_FL_REMOVABLE
? 1 : 0));
1130 static ssize_t
disk_hidden_show(struct device
*dev
,
1131 struct device_attribute
*attr
, char *buf
)
1133 struct gendisk
*disk
= dev_to_disk(dev
);
1135 return sprintf(buf
, "%d\n",
1136 (disk
->flags
& GENHD_FL_HIDDEN
? 1 : 0));
1139 static ssize_t
disk_ro_show(struct device
*dev
,
1140 struct device_attribute
*attr
, char *buf
)
1142 struct gendisk
*disk
= dev_to_disk(dev
);
1144 return sprintf(buf
, "%d\n", get_disk_ro(disk
) ? 1 : 0);
1147 static ssize_t
disk_capability_show(struct device
*dev
,
1148 struct device_attribute
*attr
, char *buf
)
1150 struct gendisk
*disk
= dev_to_disk(dev
);
1152 return sprintf(buf
, "%x\n", disk
->flags
);
1155 static ssize_t
disk_alignment_offset_show(struct device
*dev
,
1156 struct device_attribute
*attr
,
1159 struct gendisk
*disk
= dev_to_disk(dev
);
1161 return sprintf(buf
, "%d\n", queue_alignment_offset(disk
->queue
));
1164 static ssize_t
disk_discard_alignment_show(struct device
*dev
,
1165 struct device_attribute
*attr
,
1168 struct gendisk
*disk
= dev_to_disk(dev
);
1170 return sprintf(buf
, "%d\n", queue_discard_alignment(disk
->queue
));
1173 static DEVICE_ATTR(range
, 0444, disk_range_show
, NULL
);
1174 static DEVICE_ATTR(ext_range
, 0444, disk_ext_range_show
, NULL
);
1175 static DEVICE_ATTR(removable
, 0444, disk_removable_show
, NULL
);
1176 static DEVICE_ATTR(hidden
, 0444, disk_hidden_show
, NULL
);
1177 static DEVICE_ATTR(ro
, 0444, disk_ro_show
, NULL
);
1178 static DEVICE_ATTR(size
, 0444, part_size_show
, NULL
);
1179 static DEVICE_ATTR(alignment_offset
, 0444, disk_alignment_offset_show
, NULL
);
1180 static DEVICE_ATTR(discard_alignment
, 0444, disk_discard_alignment_show
, NULL
);
1181 static DEVICE_ATTR(capability
, 0444, disk_capability_show
, NULL
);
1182 static DEVICE_ATTR(stat
, 0444, part_stat_show
, NULL
);
1183 static DEVICE_ATTR(inflight
, 0444, part_inflight_show
, NULL
);
1184 static DEVICE_ATTR(badblocks
, 0644, disk_badblocks_show
, disk_badblocks_store
);
1185 #ifdef CONFIG_FAIL_MAKE_REQUEST
1186 static struct device_attribute dev_attr_fail
=
1187 __ATTR(make
-it
-fail
, 0644, part_fail_show
, part_fail_store
);
1189 #ifdef CONFIG_FAIL_IO_TIMEOUT
1190 static struct device_attribute dev_attr_fail_timeout
=
1191 __ATTR(io
-timeout
-fail
, 0644, part_timeout_show
, part_timeout_store
);
1194 static struct attribute
*disk_attrs
[] = {
1195 &dev_attr_range
.attr
,
1196 &dev_attr_ext_range
.attr
,
1197 &dev_attr_removable
.attr
,
1198 &dev_attr_hidden
.attr
,
1200 &dev_attr_size
.attr
,
1201 &dev_attr_alignment_offset
.attr
,
1202 &dev_attr_discard_alignment
.attr
,
1203 &dev_attr_capability
.attr
,
1204 &dev_attr_stat
.attr
,
1205 &dev_attr_inflight
.attr
,
1206 &dev_attr_badblocks
.attr
,
1207 #ifdef CONFIG_FAIL_MAKE_REQUEST
1208 &dev_attr_fail
.attr
,
1210 #ifdef CONFIG_FAIL_IO_TIMEOUT
1211 &dev_attr_fail_timeout
.attr
,
1216 static umode_t
disk_visible(struct kobject
*kobj
, struct attribute
*a
, int n
)
1218 struct device
*dev
= container_of(kobj
, typeof(*dev
), kobj
);
1219 struct gendisk
*disk
= dev_to_disk(dev
);
1221 if (a
== &dev_attr_badblocks
.attr
&& !disk
->bb
)
1226 static struct attribute_group disk_attr_group
= {
1227 .attrs
= disk_attrs
,
1228 .is_visible
= disk_visible
,
1231 static const struct attribute_group
*disk_attr_groups
[] = {
1237 * disk_replace_part_tbl - replace disk->part_tbl in RCU-safe way
1238 * @disk: disk to replace part_tbl for
1239 * @new_ptbl: new part_tbl to install
1241 * Replace disk->part_tbl with @new_ptbl in RCU-safe way. The
1242 * original ptbl is freed using RCU callback.
1245 * Matching bd_mutex locked or the caller is the only user of @disk.
1247 static void disk_replace_part_tbl(struct gendisk
*disk
,
1248 struct disk_part_tbl
*new_ptbl
)
1250 struct disk_part_tbl
*old_ptbl
=
1251 rcu_dereference_protected(disk
->part_tbl
, 1);
1253 rcu_assign_pointer(disk
->part_tbl
, new_ptbl
);
1256 rcu_assign_pointer(old_ptbl
->last_lookup
, NULL
);
1257 kfree_rcu(old_ptbl
, rcu_head
);
1262 * disk_expand_part_tbl - expand disk->part_tbl
1263 * @disk: disk to expand part_tbl for
1264 * @partno: expand such that this partno can fit in
1266 * Expand disk->part_tbl such that @partno can fit in. disk->part_tbl
1267 * uses RCU to allow unlocked dereferencing for stats and other stuff.
1270 * Matching bd_mutex locked or the caller is the only user of @disk.
1274 * 0 on success, -errno on failure.
1276 int disk_expand_part_tbl(struct gendisk
*disk
, int partno
)
1278 struct disk_part_tbl
*old_ptbl
=
1279 rcu_dereference_protected(disk
->part_tbl
, 1);
1280 struct disk_part_tbl
*new_ptbl
;
1281 int len
= old_ptbl
? old_ptbl
->len
: 0;
1286 * check for int overflow, since we can get here from blkpg_ioctl()
1287 * with a user passed 'partno'.
1289 target
= partno
+ 1;
1293 /* disk_max_parts() is zero during initialization, ignore if so */
1294 if (disk_max_parts(disk
) && target
> disk_max_parts(disk
))
1300 size
= sizeof(*new_ptbl
) + target
* sizeof(new_ptbl
->part
[0]);
1301 new_ptbl
= kzalloc_node(size
, GFP_KERNEL
, disk
->node_id
);
1305 new_ptbl
->len
= target
;
1307 for (i
= 0; i
< len
; i
++)
1308 rcu_assign_pointer(new_ptbl
->part
[i
], old_ptbl
->part
[i
]);
1310 disk_replace_part_tbl(disk
, new_ptbl
);
1314 static void disk_release(struct device
*dev
)
1316 struct gendisk
*disk
= dev_to_disk(dev
);
1318 blk_free_devt(dev
->devt
);
1319 disk_release_events(disk
);
1320 kfree(disk
->random
);
1321 disk_replace_part_tbl(disk
, NULL
);
1322 hd_free_part(&disk
->part0
);
1324 blk_put_queue(disk
->queue
);
1327 struct class block_class
= {
1331 static char *block_devnode(struct device
*dev
, umode_t
*mode
,
1332 kuid_t
*uid
, kgid_t
*gid
)
1334 struct gendisk
*disk
= dev_to_disk(dev
);
1337 return disk
->devnode(disk
, mode
);
1341 static const struct device_type disk_type
= {
1343 .groups
= disk_attr_groups
,
1344 .release
= disk_release
,
1345 .devnode
= block_devnode
,
1348 #ifdef CONFIG_PROC_FS
1350 * aggregate disk stat collector. Uses the same stats that the sysfs
1351 * entries do, above, but makes them available through one seq_file.
1353 * The output looks suspiciously like /proc/partitions with a bunch of
1356 static int diskstats_show(struct seq_file
*seqf
, void *v
)
1358 struct gendisk
*gp
= v
;
1359 struct disk_part_iter piter
;
1360 struct hd_struct
*hd
;
1361 char buf
[BDEVNAME_SIZE
];
1362 unsigned int inflight
;
1365 if (&disk_to_dev(gp)->kobj.entry == block_class.devices.next)
1366 seq_puts(seqf, "major minor name"
1367 " rio rmerge rsect ruse wio wmerge "
1368 "wsect wuse running use aveq"
1372 disk_part_iter_init(&piter
, gp
, DISK_PITER_INCL_EMPTY_PART0
);
1373 while ((hd
= disk_part_iter_next(&piter
))) {
1374 inflight
= part_in_flight(gp
->queue
, hd
);
1375 seq_printf(seqf
, "%4d %7d %s "
1380 MAJOR(part_devt(hd
)), MINOR(part_devt(hd
)),
1381 disk_name(gp
, hd
->partno
, buf
),
1382 part_stat_read(hd
, ios
[STAT_READ
]),
1383 part_stat_read(hd
, merges
[STAT_READ
]),
1384 part_stat_read(hd
, sectors
[STAT_READ
]),
1385 (unsigned int)part_stat_read_msecs(hd
, STAT_READ
),
1386 part_stat_read(hd
, ios
[STAT_WRITE
]),
1387 part_stat_read(hd
, merges
[STAT_WRITE
]),
1388 part_stat_read(hd
, sectors
[STAT_WRITE
]),
1389 (unsigned int)part_stat_read_msecs(hd
, STAT_WRITE
),
1391 jiffies_to_msecs(part_stat_read(hd
, io_ticks
)),
1392 jiffies_to_msecs(part_stat_read(hd
, time_in_queue
)),
1393 part_stat_read(hd
, ios
[STAT_DISCARD
]),
1394 part_stat_read(hd
, merges
[STAT_DISCARD
]),
1395 part_stat_read(hd
, sectors
[STAT_DISCARD
]),
1396 (unsigned int)part_stat_read_msecs(hd
, STAT_DISCARD
)
1399 disk_part_iter_exit(&piter
);
1404 static const struct seq_operations diskstats_op
= {
1405 .start
= disk_seqf_start
,
1406 .next
= disk_seqf_next
,
1407 .stop
= disk_seqf_stop
,
1408 .show
= diskstats_show
1411 static int __init
proc_genhd_init(void)
1413 proc_create_seq("diskstats", 0, NULL
, &diskstats_op
);
1414 proc_create_seq("partitions", 0, NULL
, &partitions_op
);
1417 module_init(proc_genhd_init
);
1418 #endif /* CONFIG_PROC_FS */
1420 dev_t
blk_lookup_devt(const char *name
, int partno
)
1422 dev_t devt
= MKDEV(0, 0);
1423 struct class_dev_iter iter
;
1426 class_dev_iter_init(&iter
, &block_class
, NULL
, &disk_type
);
1427 while ((dev
= class_dev_iter_next(&iter
))) {
1428 struct gendisk
*disk
= dev_to_disk(dev
);
1429 struct hd_struct
*part
;
1431 if (strcmp(dev_name(dev
), name
))
1434 if (partno
< disk
->minors
) {
1435 /* We need to return the right devno, even
1436 * if the partition doesn't exist yet.
1438 devt
= MKDEV(MAJOR(dev
->devt
),
1439 MINOR(dev
->devt
) + partno
);
1442 part
= disk_get_part(disk
, partno
);
1444 devt
= part_devt(part
);
1445 disk_put_part(part
);
1448 disk_put_part(part
);
1450 class_dev_iter_exit(&iter
);
1453 EXPORT_SYMBOL(blk_lookup_devt
);
1455 struct gendisk
*__alloc_disk_node(int minors
, int node_id
)
1457 struct gendisk
*disk
;
1458 struct disk_part_tbl
*ptbl
;
1460 if (minors
> DISK_MAX_PARTS
) {
1462 "block: can't allocate more than %d partitions\n",
1464 minors
= DISK_MAX_PARTS
;
1467 disk
= kzalloc_node(sizeof(struct gendisk
), GFP_KERNEL
, node_id
);
1469 if (!init_part_stats(&disk
->part0
)) {
1473 init_rwsem(&disk
->lookup_sem
);
1474 disk
->node_id
= node_id
;
1475 if (disk_expand_part_tbl(disk
, 0)) {
1476 free_part_stats(&disk
->part0
);
1480 ptbl
= rcu_dereference_protected(disk
->part_tbl
, 1);
1481 rcu_assign_pointer(ptbl
->part
[0], &disk
->part0
);
1484 * set_capacity() and get_capacity() currently don't use
1485 * seqcounter to read/update the part0->nr_sects. Still init
1486 * the counter as we can read the sectors in IO submission
1487 * patch using seqence counters.
1489 * TODO: Ideally set_capacity() and get_capacity() should be
1490 * converted to make use of bd_mutex and sequence counters.
1492 seqcount_init(&disk
->part0
.nr_sects_seq
);
1493 if (hd_ref_init(&disk
->part0
)) {
1494 hd_free_part(&disk
->part0
);
1499 disk
->minors
= minors
;
1500 rand_initialize_disk(disk
);
1501 disk_to_dev(disk
)->class = &block_class
;
1502 disk_to_dev(disk
)->type
= &disk_type
;
1503 device_initialize(disk_to_dev(disk
));
1507 EXPORT_SYMBOL(__alloc_disk_node
);
1509 struct kobject
*get_disk_and_module(struct gendisk
*disk
)
1511 struct module
*owner
;
1512 struct kobject
*kobj
;
1516 owner
= disk
->fops
->owner
;
1517 if (owner
&& !try_module_get(owner
))
1519 kobj
= kobject_get_unless_zero(&disk_to_dev(disk
)->kobj
);
1527 EXPORT_SYMBOL(get_disk_and_module
);
1529 void put_disk(struct gendisk
*disk
)
1532 kobject_put(&disk_to_dev(disk
)->kobj
);
1534 EXPORT_SYMBOL(put_disk
);
1537 * This is a counterpart of get_disk_and_module() and thus also of
1540 void put_disk_and_module(struct gendisk
*disk
)
1543 struct module
*owner
= disk
->fops
->owner
;
1549 EXPORT_SYMBOL(put_disk_and_module
);
1551 static void set_disk_ro_uevent(struct gendisk
*gd
, int ro
)
1553 char event
[] = "DISK_RO=1";
1554 char *envp
[] = { event
, NULL
};
1558 kobject_uevent_env(&disk_to_dev(gd
)->kobj
, KOBJ_CHANGE
, envp
);
1561 void set_device_ro(struct block_device
*bdev
, int flag
)
1563 bdev
->bd_part
->policy
= flag
;
1566 EXPORT_SYMBOL(set_device_ro
);
1568 void set_disk_ro(struct gendisk
*disk
, int flag
)
1570 struct disk_part_iter piter
;
1571 struct hd_struct
*part
;
1573 if (disk
->part0
.policy
!= flag
) {
1574 set_disk_ro_uevent(disk
, flag
);
1575 disk
->part0
.policy
= flag
;
1578 disk_part_iter_init(&piter
, disk
, DISK_PITER_INCL_EMPTY
);
1579 while ((part
= disk_part_iter_next(&piter
)))
1580 part
->policy
= flag
;
1581 disk_part_iter_exit(&piter
);
1584 EXPORT_SYMBOL(set_disk_ro
);
1586 int bdev_read_only(struct block_device
*bdev
)
1590 return bdev
->bd_part
->policy
;
1593 EXPORT_SYMBOL(bdev_read_only
);
1595 int invalidate_partition(struct gendisk
*disk
, int partno
)
1598 struct block_device
*bdev
= bdget_disk(disk
, partno
);
1601 res
= __invalidate_device(bdev
, true);
1607 EXPORT_SYMBOL(invalidate_partition
);
1610 * Disk events - monitor disk events like media change and eject request.
1612 struct disk_events
{
1613 struct list_head node
; /* all disk_event's */
1614 struct gendisk
*disk
; /* the associated disk */
1617 struct mutex block_mutex
; /* protects blocking */
1618 int block
; /* event blocking depth */
1619 unsigned int pending
; /* events already sent out */
1620 unsigned int clearing
; /* events being cleared */
1622 long poll_msecs
; /* interval, -1 for default */
1623 struct delayed_work dwork
;
1626 static const char *disk_events_strs
[] = {
1627 [ilog2(DISK_EVENT_MEDIA_CHANGE
)] = "media_change",
1628 [ilog2(DISK_EVENT_EJECT_REQUEST
)] = "eject_request",
1631 static char *disk_uevents
[] = {
1632 [ilog2(DISK_EVENT_MEDIA_CHANGE
)] = "DISK_MEDIA_CHANGE=1",
1633 [ilog2(DISK_EVENT_EJECT_REQUEST
)] = "DISK_EJECT_REQUEST=1",
1636 /* list of all disk_events */
1637 static DEFINE_MUTEX(disk_events_mutex
);
1638 static LIST_HEAD(disk_events
);
1640 /* disable in-kernel polling by default */
1641 static unsigned long disk_events_dfl_poll_msecs
;
1643 static unsigned long disk_events_poll_jiffies(struct gendisk
*disk
)
1645 struct disk_events
*ev
= disk
->ev
;
1646 long intv_msecs
= 0;
1649 * If device-specific poll interval is set, always use it. If
1650 * the default is being used, poll iff there are events which
1651 * can't be monitored asynchronously.
1653 if (ev
->poll_msecs
>= 0)
1654 intv_msecs
= ev
->poll_msecs
;
1655 else if (disk
->events
& ~disk
->async_events
)
1656 intv_msecs
= disk_events_dfl_poll_msecs
;
1658 return msecs_to_jiffies(intv_msecs
);
1662 * disk_block_events - block and flush disk event checking
1663 * @disk: disk to block events for
1665 * On return from this function, it is guaranteed that event checking
1666 * isn't in progress and won't happen until unblocked by
1667 * disk_unblock_events(). Events blocking is counted and the actual
1668 * unblocking happens after the matching number of unblocks are done.
1670 * Note that this intentionally does not block event checking from
1671 * disk_clear_events().
1676 void disk_block_events(struct gendisk
*disk
)
1678 struct disk_events
*ev
= disk
->ev
;
1679 unsigned long flags
;
1686 * Outer mutex ensures that the first blocker completes canceling
1687 * the event work before further blockers are allowed to finish.
1689 mutex_lock(&ev
->block_mutex
);
1691 spin_lock_irqsave(&ev
->lock
, flags
);
1692 cancel
= !ev
->block
++;
1693 spin_unlock_irqrestore(&ev
->lock
, flags
);
1696 cancel_delayed_work_sync(&disk
->ev
->dwork
);
1698 mutex_unlock(&ev
->block_mutex
);
1701 static void __disk_unblock_events(struct gendisk
*disk
, bool check_now
)
1703 struct disk_events
*ev
= disk
->ev
;
1705 unsigned long flags
;
1707 spin_lock_irqsave(&ev
->lock
, flags
);
1709 if (WARN_ON_ONCE(ev
->block
<= 0))
1715 intv
= disk_events_poll_jiffies(disk
);
1717 queue_delayed_work(system_freezable_power_efficient_wq
,
1720 queue_delayed_work(system_freezable_power_efficient_wq
,
1723 spin_unlock_irqrestore(&ev
->lock
, flags
);
1727 * disk_unblock_events - unblock disk event checking
1728 * @disk: disk to unblock events for
1730 * Undo disk_block_events(). When the block count reaches zero, it
1731 * starts events polling if configured.
1734 * Don't care. Safe to call from irq context.
1736 void disk_unblock_events(struct gendisk
*disk
)
1739 __disk_unblock_events(disk
, false);
1743 * disk_flush_events - schedule immediate event checking and flushing
1744 * @disk: disk to check and flush events for
1745 * @mask: events to flush
1747 * Schedule immediate event checking on @disk if not blocked. Events in
1748 * @mask are scheduled to be cleared from the driver. Note that this
1749 * doesn't clear the events from @disk->ev.
1752 * If @mask is non-zero must be called with bdev->bd_mutex held.
1754 void disk_flush_events(struct gendisk
*disk
, unsigned int mask
)
1756 struct disk_events
*ev
= disk
->ev
;
1761 spin_lock_irq(&ev
->lock
);
1762 ev
->clearing
|= mask
;
1764 mod_delayed_work(system_freezable_power_efficient_wq
,
1766 spin_unlock_irq(&ev
->lock
);
1770 * disk_clear_events - synchronously check, clear and return pending events
1771 * @disk: disk to fetch and clear events from
1772 * @mask: mask of events to be fetched and cleared
1774 * Disk events are synchronously checked and pending events in @mask
1775 * are cleared and returned. This ignores the block count.
1780 unsigned int disk_clear_events(struct gendisk
*disk
, unsigned int mask
)
1782 const struct block_device_operations
*bdops
= disk
->fops
;
1783 struct disk_events
*ev
= disk
->ev
;
1784 unsigned int pending
;
1785 unsigned int clearing
= mask
;
1788 /* for drivers still using the old ->media_changed method */
1789 if ((mask
& DISK_EVENT_MEDIA_CHANGE
) &&
1790 bdops
->media_changed
&& bdops
->media_changed(disk
))
1791 return DISK_EVENT_MEDIA_CHANGE
;
1795 disk_block_events(disk
);
1798 * store the union of mask and ev->clearing on the stack so that the
1799 * race with disk_flush_events does not cause ambiguity (ev->clearing
1800 * can still be modified even if events are blocked).
1802 spin_lock_irq(&ev
->lock
);
1803 clearing
|= ev
->clearing
;
1805 spin_unlock_irq(&ev
->lock
);
1807 disk_check_events(ev
, &clearing
);
1809 * if ev->clearing is not 0, the disk_flush_events got called in the
1810 * middle of this function, so we want to run the workfn without delay.
1812 __disk_unblock_events(disk
, ev
->clearing
? true : false);
1814 /* then, fetch and clear pending events */
1815 spin_lock_irq(&ev
->lock
);
1816 pending
= ev
->pending
& mask
;
1817 ev
->pending
&= ~mask
;
1818 spin_unlock_irq(&ev
->lock
);
1819 WARN_ON_ONCE(clearing
& mask
);
1825 * Separate this part out so that a different pointer for clearing_ptr can be
1826 * passed in for disk_clear_events.
1828 static void disk_events_workfn(struct work_struct
*work
)
1830 struct delayed_work
*dwork
= to_delayed_work(work
);
1831 struct disk_events
*ev
= container_of(dwork
, struct disk_events
, dwork
);
1833 disk_check_events(ev
, &ev
->clearing
);
1836 static void disk_check_events(struct disk_events
*ev
,
1837 unsigned int *clearing_ptr
)
1839 struct gendisk
*disk
= ev
->disk
;
1840 char *envp
[ARRAY_SIZE(disk_uevents
) + 1] = { };
1841 unsigned int clearing
= *clearing_ptr
;
1842 unsigned int events
;
1844 int nr_events
= 0, i
;
1847 events
= disk
->fops
->check_events(disk
, clearing
);
1849 /* accumulate pending events and schedule next poll if necessary */
1850 spin_lock_irq(&ev
->lock
);
1852 events
&= ~ev
->pending
;
1853 ev
->pending
|= events
;
1854 *clearing_ptr
&= ~clearing
;
1856 intv
= disk_events_poll_jiffies(disk
);
1857 if (!ev
->block
&& intv
)
1858 queue_delayed_work(system_freezable_power_efficient_wq
,
1861 spin_unlock_irq(&ev
->lock
);
1864 * Tell userland about new events. Only the events listed in
1865 * @disk->events are reported. Unlisted events are processed the
1866 * same internally but never get reported to userland.
1868 for (i
= 0; i
< ARRAY_SIZE(disk_uevents
); i
++)
1869 if (events
& disk
->events
& (1 << i
))
1870 envp
[nr_events
++] = disk_uevents
[i
];
1873 kobject_uevent_env(&disk_to_dev(disk
)->kobj
, KOBJ_CHANGE
, envp
);
1877 * A disk events enabled device has the following sysfs nodes under
1878 * its /sys/block/X/ directory.
1880 * events : list of all supported events
1881 * events_async : list of events which can be detected w/o polling
1882 * events_poll_msecs : polling interval, 0: disable, -1: system default
1884 static ssize_t
__disk_events_show(unsigned int events
, char *buf
)
1886 const char *delim
= "";
1890 for (i
= 0; i
< ARRAY_SIZE(disk_events_strs
); i
++)
1891 if (events
& (1 << i
)) {
1892 pos
+= sprintf(buf
+ pos
, "%s%s",
1893 delim
, disk_events_strs
[i
]);
1897 pos
+= sprintf(buf
+ pos
, "\n");
1901 static ssize_t
disk_events_show(struct device
*dev
,
1902 struct device_attribute
*attr
, char *buf
)
1904 struct gendisk
*disk
= dev_to_disk(dev
);
1906 return __disk_events_show(disk
->events
, buf
);
1909 static ssize_t
disk_events_async_show(struct device
*dev
,
1910 struct device_attribute
*attr
, char *buf
)
1912 struct gendisk
*disk
= dev_to_disk(dev
);
1914 return __disk_events_show(disk
->async_events
, buf
);
1917 static ssize_t
disk_events_poll_msecs_show(struct device
*dev
,
1918 struct device_attribute
*attr
,
1921 struct gendisk
*disk
= dev_to_disk(dev
);
1923 return sprintf(buf
, "%ld\n", disk
->ev
->poll_msecs
);
1926 static ssize_t
disk_events_poll_msecs_store(struct device
*dev
,
1927 struct device_attribute
*attr
,
1928 const char *buf
, size_t count
)
1930 struct gendisk
*disk
= dev_to_disk(dev
);
1933 if (!count
|| !sscanf(buf
, "%ld", &intv
))
1936 if (intv
< 0 && intv
!= -1)
1939 disk_block_events(disk
);
1940 disk
->ev
->poll_msecs
= intv
;
1941 __disk_unblock_events(disk
, true);
1946 static const DEVICE_ATTR(events
, 0444, disk_events_show
, NULL
);
1947 static const DEVICE_ATTR(events_async
, 0444, disk_events_async_show
, NULL
);
1948 static const DEVICE_ATTR(events_poll_msecs
, 0644,
1949 disk_events_poll_msecs_show
,
1950 disk_events_poll_msecs_store
);
1952 static const struct attribute
*disk_events_attrs
[] = {
1953 &dev_attr_events
.attr
,
1954 &dev_attr_events_async
.attr
,
1955 &dev_attr_events_poll_msecs
.attr
,
1960 * The default polling interval can be specified by the kernel
1961 * parameter block.events_dfl_poll_msecs which defaults to 0
1962 * (disable). This can also be modified runtime by writing to
1963 * /sys/module/block/events_dfl_poll_msecs.
1965 static int disk_events_set_dfl_poll_msecs(const char *val
,
1966 const struct kernel_param
*kp
)
1968 struct disk_events
*ev
;
1971 ret
= param_set_ulong(val
, kp
);
1975 mutex_lock(&disk_events_mutex
);
1977 list_for_each_entry(ev
, &disk_events
, node
)
1978 disk_flush_events(ev
->disk
, 0);
1980 mutex_unlock(&disk_events_mutex
);
1985 static const struct kernel_param_ops disk_events_dfl_poll_msecs_param_ops
= {
1986 .set
= disk_events_set_dfl_poll_msecs
,
1987 .get
= param_get_ulong
,
1990 #undef MODULE_PARAM_PREFIX
1991 #define MODULE_PARAM_PREFIX "block."
1993 module_param_cb(events_dfl_poll_msecs
, &disk_events_dfl_poll_msecs_param_ops
,
1994 &disk_events_dfl_poll_msecs
, 0644);
1997 * disk_{alloc|add|del|release}_events - initialize and destroy disk_events.
1999 static void disk_alloc_events(struct gendisk
*disk
)
2001 struct disk_events
*ev
;
2003 if (!disk
->fops
->check_events
)
2006 ev
= kzalloc(sizeof(*ev
), GFP_KERNEL
);
2008 pr_warn("%s: failed to initialize events\n", disk
->disk_name
);
2012 INIT_LIST_HEAD(&ev
->node
);
2014 spin_lock_init(&ev
->lock
);
2015 mutex_init(&ev
->block_mutex
);
2017 ev
->poll_msecs
= -1;
2018 INIT_DELAYED_WORK(&ev
->dwork
, disk_events_workfn
);
2023 static void disk_add_events(struct gendisk
*disk
)
2028 /* FIXME: error handling */
2029 if (sysfs_create_files(&disk_to_dev(disk
)->kobj
, disk_events_attrs
) < 0)
2030 pr_warn("%s: failed to create sysfs files for events\n",
2033 mutex_lock(&disk_events_mutex
);
2034 list_add_tail(&disk
->ev
->node
, &disk_events
);
2035 mutex_unlock(&disk_events_mutex
);
2038 * Block count is initialized to 1 and the following initial
2039 * unblock kicks it into action.
2041 __disk_unblock_events(disk
, true);
2044 static void disk_del_events(struct gendisk
*disk
)
2049 disk_block_events(disk
);
2051 mutex_lock(&disk_events_mutex
);
2052 list_del_init(&disk
->ev
->node
);
2053 mutex_unlock(&disk_events_mutex
);
2055 sysfs_remove_files(&disk_to_dev(disk
)->kobj
, disk_events_attrs
);
2058 static void disk_release_events(struct gendisk
*disk
)
2060 /* the block count should be 1 from disk_del_events() */
2061 WARN_ON_ONCE(disk
->ev
&& disk
->ev
->block
!= 1);