1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (C) 1991, 1992 Linus Torvalds
5 * Copyright (C) 2016 - 2020 Christoph Hellwig
8 #include <linux/init.h>
10 #include <linux/slab.h>
11 #include <linux/kmod.h>
12 #include <linux/major.h>
13 #include <linux/device_cgroup.h>
14 #include <linux/blkdev.h>
15 #include <linux/blk-integrity.h>
16 #include <linux/backing-dev.h>
17 #include <linux/module.h>
18 #include <linux/blkpg.h>
19 #include <linux/magic.h>
20 #include <linux/buffer_head.h>
21 #include <linux/swap.h>
22 #include <linux/writeback.h>
23 #include <linux/mount.h>
24 #include <linux/pseudo_fs.h>
25 #include <linux/uio.h>
26 #include <linux/namei.h>
27 #include <linux/part_stat.h>
28 #include <linux/uaccess.h>
29 #include <linux/stat.h>
30 #include "../fs/internal.h"
33 /* Should we allow writing to mounted block devices? */
34 static bool bdev_allow_write_mounted = IS_ENABLED(CONFIG_BLK_DEV_WRITE_MOUNTED);
37 struct block_device bdev;
38 struct inode vfs_inode;
41 static inline struct bdev_inode *BDEV_I(struct inode *inode)
43 return container_of(inode, struct bdev_inode, vfs_inode);
46 struct block_device *I_BDEV(struct inode *inode)
48 return &BDEV_I(inode)->bdev;
50 EXPORT_SYMBOL(I_BDEV);
52 struct block_device *file_bdev(struct file *bdev_file)
54 return I_BDEV(bdev_file->f_mapping->host);
56 EXPORT_SYMBOL(file_bdev);
58 static void bdev_write_inode(struct block_device *bdev)
60 struct inode *inode = bdev->bd_inode;
63 spin_lock(&inode->i_lock);
64 while (inode->i_state & I_DIRTY) {
65 spin_unlock(&inode->i_lock);
66 ret = write_inode_now(inode, true);
69 "VFS: Dirty inode writeback failed for block device %pg (err=%d).\n",
71 spin_lock(&inode->i_lock);
73 spin_unlock(&inode->i_lock);
76 /* Kill _all_ buffers and pagecache , dirty or not.. */
77 static void kill_bdev(struct block_device *bdev)
79 struct address_space *mapping = bdev->bd_inode->i_mapping;
81 if (mapping_empty(mapping))
85 truncate_inode_pages(mapping, 0);
88 /* Invalidate clean unused buffers and pagecache. */
89 void invalidate_bdev(struct block_device *bdev)
91 struct address_space *mapping = bdev->bd_inode->i_mapping;
93 if (mapping->nrpages) {
95 lru_add_drain_all(); /* make sure all lru add caches are flushed */
96 invalidate_mapping_pages(mapping, 0, -1);
99 EXPORT_SYMBOL(invalidate_bdev);
102 * Drop all buffers & page cache for given bdev range. This function bails
103 * with error if bdev has other exclusive owner (such as filesystem).
105 int truncate_bdev_range(struct block_device *bdev, blk_mode_t mode,
106 loff_t lstart, loff_t lend)
109 * If we don't hold exclusive handle for the device, upgrade to it
110 * while we discard the buffer cache to avoid discarding buffers
111 * under live filesystem.
113 if (!(mode & BLK_OPEN_EXCL)) {
114 int err = bd_prepare_to_claim(bdev, truncate_bdev_range, NULL);
119 truncate_inode_pages_range(bdev->bd_inode->i_mapping, lstart, lend);
120 if (!(mode & BLK_OPEN_EXCL))
121 bd_abort_claiming(bdev, truncate_bdev_range);
126 * Someone else has handle exclusively open. Try invalidating instead.
127 * The 'end' argument is inclusive so the rounding is safe.
129 return invalidate_inode_pages2_range(bdev->bd_inode->i_mapping,
130 lstart >> PAGE_SHIFT,
134 static void set_init_blocksize(struct block_device *bdev)
136 unsigned int bsize = bdev_logical_block_size(bdev);
137 loff_t size = i_size_read(bdev->bd_inode);
139 while (bsize < PAGE_SIZE) {
144 bdev->bd_inode->i_blkbits = blksize_bits(bsize);
147 int set_blocksize(struct block_device *bdev, int size)
149 /* Size must be a power of two, and between 512 and PAGE_SIZE */
150 if (size > PAGE_SIZE || size < 512 || !is_power_of_2(size))
153 /* Size cannot be smaller than the size supported by the device */
154 if (size < bdev_logical_block_size(bdev))
157 /* Don't change the size if it is same as current */
158 if (bdev->bd_inode->i_blkbits != blksize_bits(size)) {
160 bdev->bd_inode->i_blkbits = blksize_bits(size);
166 EXPORT_SYMBOL(set_blocksize);
168 int sb_set_blocksize(struct super_block *sb, int size)
170 if (set_blocksize(sb->s_bdev, size))
172 /* If we get here, we know size is power of two
173 * and it's value is between 512 and PAGE_SIZE */
174 sb->s_blocksize = size;
175 sb->s_blocksize_bits = blksize_bits(size);
176 return sb->s_blocksize;
179 EXPORT_SYMBOL(sb_set_blocksize);
181 int sb_min_blocksize(struct super_block *sb, int size)
183 int minsize = bdev_logical_block_size(sb->s_bdev);
186 return sb_set_blocksize(sb, size);
189 EXPORT_SYMBOL(sb_min_blocksize);
191 int sync_blockdev_nowait(struct block_device *bdev)
195 return filemap_flush(bdev->bd_inode->i_mapping);
197 EXPORT_SYMBOL_GPL(sync_blockdev_nowait);
200 * Write out and wait upon all the dirty data associated with a block
201 * device via its mapping. Does not take the superblock lock.
203 int sync_blockdev(struct block_device *bdev)
207 return filemap_write_and_wait(bdev->bd_inode->i_mapping);
209 EXPORT_SYMBOL(sync_blockdev);
211 int sync_blockdev_range(struct block_device *bdev, loff_t lstart, loff_t lend)
213 return filemap_write_and_wait_range(bdev->bd_inode->i_mapping,
216 EXPORT_SYMBOL(sync_blockdev_range);
219 * bdev_freeze - lock a filesystem and force it into a consistent state
220 * @bdev: blockdevice to lock
222 * If a superblock is found on this device, we take the s_umount semaphore
223 * on it to make sure nobody unmounts until the snapshot creation is done.
224 * The reference counter (bd_fsfreeze_count) guarantees that only the last
225 * unfreeze process can unfreeze the frozen filesystem actually when multiple
226 * freeze requests arrive simultaneously. It counts up in bdev_freeze() and
227 * count down in bdev_thaw(). When it becomes 0, thaw_bdev() will unfreeze
230 * Return: On success zero is returned, negative error code on failure.
232 int bdev_freeze(struct block_device *bdev)
236 mutex_lock(&bdev->bd_fsfreeze_mutex);
238 if (atomic_inc_return(&bdev->bd_fsfreeze_count) > 1) {
239 mutex_unlock(&bdev->bd_fsfreeze_mutex);
243 mutex_lock(&bdev->bd_holder_lock);
244 if (bdev->bd_holder_ops && bdev->bd_holder_ops->freeze) {
245 error = bdev->bd_holder_ops->freeze(bdev);
246 lockdep_assert_not_held(&bdev->bd_holder_lock);
248 mutex_unlock(&bdev->bd_holder_lock);
249 error = sync_blockdev(bdev);
253 atomic_dec(&bdev->bd_fsfreeze_count);
255 mutex_unlock(&bdev->bd_fsfreeze_mutex);
258 EXPORT_SYMBOL(bdev_freeze);
261 * bdev_thaw - unlock filesystem
262 * @bdev: blockdevice to unlock
264 * Unlocks the filesystem and marks it writeable again after bdev_freeze().
266 * Return: On success zero is returned, negative error code on failure.
268 int bdev_thaw(struct block_device *bdev)
270 int error = -EINVAL, nr_freeze;
272 mutex_lock(&bdev->bd_fsfreeze_mutex);
275 * If this returns < 0 it means that @bd_fsfreeze_count was
276 * already 0 and no decrement was performed.
278 nr_freeze = atomic_dec_if_positive(&bdev->bd_fsfreeze_count);
286 mutex_lock(&bdev->bd_holder_lock);
287 if (bdev->bd_holder_ops && bdev->bd_holder_ops->thaw) {
288 error = bdev->bd_holder_ops->thaw(bdev);
289 lockdep_assert_not_held(&bdev->bd_holder_lock);
291 mutex_unlock(&bdev->bd_holder_lock);
295 atomic_inc(&bdev->bd_fsfreeze_count);
297 mutex_unlock(&bdev->bd_fsfreeze_mutex);
300 EXPORT_SYMBOL(bdev_thaw);
306 static __cacheline_aligned_in_smp DEFINE_MUTEX(bdev_lock);
307 static struct kmem_cache *bdev_cachep __ro_after_init;
309 static struct inode *bdev_alloc_inode(struct super_block *sb)
311 struct bdev_inode *ei = alloc_inode_sb(sb, bdev_cachep, GFP_KERNEL);
315 memset(&ei->bdev, 0, sizeof(ei->bdev));
316 return &ei->vfs_inode;
319 static void bdev_free_inode(struct inode *inode)
321 struct block_device *bdev = I_BDEV(inode);
323 free_percpu(bdev->bd_stats);
324 kfree(bdev->bd_meta_info);
326 if (!bdev_is_partition(bdev)) {
327 if (bdev->bd_disk && bdev->bd_disk->bdi)
328 bdi_put(bdev->bd_disk->bdi);
329 kfree(bdev->bd_disk);
332 if (MAJOR(bdev->bd_dev) == BLOCK_EXT_MAJOR)
333 blk_free_ext_minor(MINOR(bdev->bd_dev));
335 kmem_cache_free(bdev_cachep, BDEV_I(inode));
338 static void init_once(void *data)
340 struct bdev_inode *ei = data;
342 inode_init_once(&ei->vfs_inode);
345 static void bdev_evict_inode(struct inode *inode)
347 truncate_inode_pages_final(&inode->i_data);
348 invalidate_inode_buffers(inode); /* is it needed here? */
352 static const struct super_operations bdev_sops = {
353 .statfs = simple_statfs,
354 .alloc_inode = bdev_alloc_inode,
355 .free_inode = bdev_free_inode,
356 .drop_inode = generic_delete_inode,
357 .evict_inode = bdev_evict_inode,
360 static int bd_init_fs_context(struct fs_context *fc)
362 struct pseudo_fs_context *ctx = init_pseudo(fc, BDEVFS_MAGIC);
365 fc->s_iflags |= SB_I_CGROUPWB;
366 ctx->ops = &bdev_sops;
370 static struct file_system_type bd_type = {
372 .init_fs_context = bd_init_fs_context,
373 .kill_sb = kill_anon_super,
376 struct super_block *blockdev_superblock __ro_after_init;
377 struct vfsmount *blockdev_mnt __ro_after_init;
378 EXPORT_SYMBOL_GPL(blockdev_superblock);
380 void __init bdev_cache_init(void)
384 bdev_cachep = kmem_cache_create("bdev_cache", sizeof(struct bdev_inode),
385 0, (SLAB_HWCACHE_ALIGN|SLAB_RECLAIM_ACCOUNT|
386 SLAB_ACCOUNT|SLAB_PANIC),
388 err = register_filesystem(&bd_type);
390 panic("Cannot register bdev pseudo-fs");
391 blockdev_mnt = kern_mount(&bd_type);
392 if (IS_ERR(blockdev_mnt))
393 panic("Cannot create bdev pseudo-fs");
394 blockdev_superblock = blockdev_mnt->mnt_sb; /* For writeback */
397 struct block_device *bdev_alloc(struct gendisk *disk, u8 partno)
399 struct block_device *bdev;
402 inode = new_inode(blockdev_superblock);
405 inode->i_mode = S_IFBLK;
407 inode->i_data.a_ops = &def_blk_aops;
408 mapping_set_gfp_mask(&inode->i_data, GFP_USER);
410 bdev = I_BDEV(inode);
411 mutex_init(&bdev->bd_fsfreeze_mutex);
412 spin_lock_init(&bdev->bd_size_lock);
413 mutex_init(&bdev->bd_holder_lock);
414 bdev->bd_partno = partno;
415 bdev->bd_inode = inode;
416 bdev->bd_queue = disk->queue;
418 bdev->bd_has_submit_bio = disk->part0->bd_has_submit_bio;
420 bdev->bd_has_submit_bio = false;
421 bdev->bd_stats = alloc_percpu(struct disk_stats);
422 if (!bdev->bd_stats) {
426 bdev->bd_disk = disk;
430 void bdev_set_nr_sectors(struct block_device *bdev, sector_t sectors)
432 spin_lock(&bdev->bd_size_lock);
433 i_size_write(bdev->bd_inode, (loff_t)sectors << SECTOR_SHIFT);
434 bdev->bd_nr_sectors = sectors;
435 spin_unlock(&bdev->bd_size_lock);
438 void bdev_add(struct block_device *bdev, dev_t dev)
440 if (bdev_stable_writes(bdev))
441 mapping_set_stable_writes(bdev->bd_inode->i_mapping);
443 bdev->bd_inode->i_rdev = dev;
444 bdev->bd_inode->i_ino = dev;
445 insert_inode_hash(bdev->bd_inode);
448 long nr_blockdev_pages(void)
453 spin_lock(&blockdev_superblock->s_inode_list_lock);
454 list_for_each_entry(inode, &blockdev_superblock->s_inodes, i_sb_list)
455 ret += inode->i_mapping->nrpages;
456 spin_unlock(&blockdev_superblock->s_inode_list_lock);
462 * bd_may_claim - test whether a block device can be claimed
463 * @bdev: block device of interest
464 * @holder: holder trying to claim @bdev
467 * Test whether @bdev can be claimed by @holder.
470 * %true if @bdev can be claimed, %false otherwise.
472 static bool bd_may_claim(struct block_device *bdev, void *holder,
473 const struct blk_holder_ops *hops)
475 struct block_device *whole = bdev_whole(bdev);
477 lockdep_assert_held(&bdev_lock);
479 if (bdev->bd_holder) {
481 * The same holder can always re-claim.
483 if (bdev->bd_holder == holder) {
484 if (WARN_ON_ONCE(bdev->bd_holder_ops != hops))
492 * If the whole devices holder is set to bd_may_claim, a partition on
493 * the device is claimed, but not the whole device.
496 whole->bd_holder && whole->bd_holder != bd_may_claim)
502 * bd_prepare_to_claim - claim a block device
503 * @bdev: block device of interest
504 * @holder: holder trying to claim @bdev
507 * Claim @bdev. This function fails if @bdev is already claimed by another
508 * holder and waits if another claiming is in progress. return, the caller
509 * has ownership of bd_claiming and bd_holder[s].
512 * 0 if @bdev can be claimed, -EBUSY otherwise.
514 int bd_prepare_to_claim(struct block_device *bdev, void *holder,
515 const struct blk_holder_ops *hops)
517 struct block_device *whole = bdev_whole(bdev);
519 if (WARN_ON_ONCE(!holder))
522 mutex_lock(&bdev_lock);
523 /* if someone else claimed, fail */
524 if (!bd_may_claim(bdev, holder, hops)) {
525 mutex_unlock(&bdev_lock);
529 /* if claiming is already in progress, wait for it to finish */
530 if (whole->bd_claiming) {
531 wait_queue_head_t *wq = bit_waitqueue(&whole->bd_claiming, 0);
534 prepare_to_wait(wq, &wait, TASK_UNINTERRUPTIBLE);
535 mutex_unlock(&bdev_lock);
537 finish_wait(wq, &wait);
542 whole->bd_claiming = holder;
543 mutex_unlock(&bdev_lock);
546 EXPORT_SYMBOL_GPL(bd_prepare_to_claim); /* only for the loop driver */
548 static void bd_clear_claiming(struct block_device *whole, void *holder)
550 lockdep_assert_held(&bdev_lock);
551 /* tell others that we're done */
552 BUG_ON(whole->bd_claiming != holder);
553 whole->bd_claiming = NULL;
554 wake_up_bit(&whole->bd_claiming, 0);
558 * bd_finish_claiming - finish claiming of a block device
559 * @bdev: block device of interest
560 * @holder: holder that has claimed @bdev
561 * @hops: block device holder operations
563 * Finish exclusive open of a block device. Mark the device as exlusively
564 * open by the holder and wake up all waiters for exclusive open to finish.
566 static void bd_finish_claiming(struct block_device *bdev, void *holder,
567 const struct blk_holder_ops *hops)
569 struct block_device *whole = bdev_whole(bdev);
571 mutex_lock(&bdev_lock);
572 BUG_ON(!bd_may_claim(bdev, holder, hops));
574 * Note that for a whole device bd_holders will be incremented twice,
575 * and bd_holder will be set to bd_may_claim before being set to holder
578 whole->bd_holder = bd_may_claim;
580 mutex_lock(&bdev->bd_holder_lock);
581 bdev->bd_holder = holder;
582 bdev->bd_holder_ops = hops;
583 mutex_unlock(&bdev->bd_holder_lock);
584 bd_clear_claiming(whole, holder);
585 mutex_unlock(&bdev_lock);
589 * bd_abort_claiming - abort claiming of a block device
590 * @bdev: block device of interest
591 * @holder: holder that has claimed @bdev
593 * Abort claiming of a block device when the exclusive open failed. This can be
594 * also used when exclusive open is not actually desired and we just needed
595 * to block other exclusive openers for a while.
597 void bd_abort_claiming(struct block_device *bdev, void *holder)
599 mutex_lock(&bdev_lock);
600 bd_clear_claiming(bdev_whole(bdev), holder);
601 mutex_unlock(&bdev_lock);
603 EXPORT_SYMBOL(bd_abort_claiming);
605 static void bd_end_claim(struct block_device *bdev, void *holder)
607 struct block_device *whole = bdev_whole(bdev);
608 bool unblock = false;
611 * Release a claim on the device. The holder fields are protected with
612 * bdev_lock. open_mutex is used to synchronize disk_holder unlinking.
614 mutex_lock(&bdev_lock);
615 WARN_ON_ONCE(bdev->bd_holder != holder);
616 WARN_ON_ONCE(--bdev->bd_holders < 0);
617 WARN_ON_ONCE(--whole->bd_holders < 0);
618 if (!bdev->bd_holders) {
619 mutex_lock(&bdev->bd_holder_lock);
620 bdev->bd_holder = NULL;
621 bdev->bd_holder_ops = NULL;
622 mutex_unlock(&bdev->bd_holder_lock);
623 if (bdev->bd_write_holder)
626 if (!whole->bd_holders)
627 whole->bd_holder = NULL;
628 mutex_unlock(&bdev_lock);
631 * If this was the last claim, remove holder link and unblock evpoll if
632 * it was a write holder.
635 disk_unblock_events(bdev->bd_disk);
636 bdev->bd_write_holder = false;
640 static void blkdev_flush_mapping(struct block_device *bdev)
642 WARN_ON_ONCE(bdev->bd_holders);
645 bdev_write_inode(bdev);
648 static int blkdev_get_whole(struct block_device *bdev, blk_mode_t mode)
650 struct gendisk *disk = bdev->bd_disk;
653 if (disk->fops->open) {
654 ret = disk->fops->open(disk, mode);
656 /* avoid ghost partitions on a removed medium */
657 if (ret == -ENOMEDIUM &&
658 test_bit(GD_NEED_PART_SCAN, &disk->state))
659 bdev_disk_changed(disk, true);
664 if (!atomic_read(&bdev->bd_openers))
665 set_init_blocksize(bdev);
666 if (test_bit(GD_NEED_PART_SCAN, &disk->state))
667 bdev_disk_changed(disk, false);
668 atomic_inc(&bdev->bd_openers);
672 static void blkdev_put_whole(struct block_device *bdev)
674 if (atomic_dec_and_test(&bdev->bd_openers))
675 blkdev_flush_mapping(bdev);
676 if (bdev->bd_disk->fops->release)
677 bdev->bd_disk->fops->release(bdev->bd_disk);
680 static int blkdev_get_part(struct block_device *part, blk_mode_t mode)
682 struct gendisk *disk = part->bd_disk;
685 ret = blkdev_get_whole(bdev_whole(part), mode);
690 if (!bdev_nr_sectors(part))
693 if (!atomic_read(&part->bd_openers)) {
694 disk->open_partitions++;
695 set_init_blocksize(part);
697 atomic_inc(&part->bd_openers);
701 blkdev_put_whole(bdev_whole(part));
705 int bdev_permission(dev_t dev, blk_mode_t mode, void *holder)
709 ret = devcgroup_check_permission(DEVCG_DEV_BLOCK,
710 MAJOR(dev), MINOR(dev),
711 ((mode & BLK_OPEN_READ) ? DEVCG_ACC_READ : 0) |
712 ((mode & BLK_OPEN_WRITE) ? DEVCG_ACC_WRITE : 0));
716 /* Blocking writes requires exclusive opener */
717 if (mode & BLK_OPEN_RESTRICT_WRITES && !holder)
721 * We're using error pointers to indicate to ->release() when we
722 * failed to open that block device. Also this doesn't make sense.
724 if (WARN_ON_ONCE(IS_ERR(holder)))
730 static void blkdev_put_part(struct block_device *part)
732 struct block_device *whole = bdev_whole(part);
734 if (atomic_dec_and_test(&part->bd_openers)) {
735 blkdev_flush_mapping(part);
736 whole->bd_disk->open_partitions--;
738 blkdev_put_whole(whole);
741 struct block_device *blkdev_get_no_open(dev_t dev)
743 struct block_device *bdev;
746 inode = ilookup(blockdev_superblock, dev);
747 if (!inode && IS_ENABLED(CONFIG_BLOCK_LEGACY_AUTOLOAD)) {
748 blk_request_module(dev);
749 inode = ilookup(blockdev_superblock, dev);
752 "block device autoloading is deprecated and will be removed.\n");
757 /* switch from the inode reference to a device mode one: */
758 bdev = &BDEV_I(inode)->bdev;
759 if (!kobject_get_unless_zero(&bdev->bd_device.kobj))
765 void blkdev_put_no_open(struct block_device *bdev)
767 put_device(&bdev->bd_device);
770 static bool bdev_writes_blocked(struct block_device *bdev)
772 return bdev->bd_writers < 0;
775 static void bdev_block_writes(struct block_device *bdev)
780 static void bdev_unblock_writes(struct block_device *bdev)
785 static bool bdev_may_open(struct block_device *bdev, blk_mode_t mode)
787 if (bdev_allow_write_mounted)
789 /* Writes blocked? */
790 if (mode & BLK_OPEN_WRITE && bdev_writes_blocked(bdev))
792 if (mode & BLK_OPEN_RESTRICT_WRITES && bdev->bd_writers > 0)
797 static void bdev_claim_write_access(struct block_device *bdev, blk_mode_t mode)
799 if (bdev_allow_write_mounted)
802 /* Claim exclusive or shared write access. */
803 if (mode & BLK_OPEN_RESTRICT_WRITES)
804 bdev_block_writes(bdev);
805 else if (mode & BLK_OPEN_WRITE)
809 static inline bool bdev_unclaimed(const struct file *bdev_file)
811 return bdev_file->private_data == BDEV_I(bdev_file->f_mapping->host);
814 static void bdev_yield_write_access(struct file *bdev_file)
816 struct block_device *bdev;
818 if (bdev_allow_write_mounted)
821 if (bdev_unclaimed(bdev_file))
824 bdev = file_bdev(bdev_file);
826 if (bdev_file->f_mode & FMODE_WRITE_RESTRICTED)
827 bdev_unblock_writes(bdev);
828 else if (bdev_file->f_mode & FMODE_WRITE)
833 * bdev_open - open a block device
834 * @bdev: block device to open
835 * @mode: open mode (BLK_OPEN_*)
836 * @holder: exclusive holder identifier
837 * @hops: holder operations
838 * @bdev_file: file for the block device
840 * Open the block device. If @holder is not %NULL, the block device is opened
841 * with exclusive access. Exclusive opens may nest for the same @holder.
847 * zero on success, -errno on failure.
849 int bdev_open(struct block_device *bdev, blk_mode_t mode, void *holder,
850 const struct blk_holder_ops *hops, struct file *bdev_file)
852 bool unblock_events = true;
853 struct gendisk *disk = bdev->bd_disk;
857 mode |= BLK_OPEN_EXCL;
858 ret = bd_prepare_to_claim(bdev, holder, hops);
862 if (WARN_ON_ONCE(mode & BLK_OPEN_EXCL))
866 disk_block_events(disk);
868 mutex_lock(&disk->open_mutex);
870 if (!disk_live(disk))
872 if (!try_module_get(disk->fops->owner))
875 if (!bdev_may_open(bdev, mode))
877 if (bdev_is_partition(bdev))
878 ret = blkdev_get_part(bdev, mode);
880 ret = blkdev_get_whole(bdev, mode);
883 bdev_claim_write_access(bdev, mode);
885 bd_finish_claiming(bdev, holder, hops);
888 * Block event polling for write claims if requested. Any write
889 * holder makes the write_holder state stick until all are
890 * released. This is good enough and tracking individual
891 * writeable reference is too fragile given the way @mode is
892 * used in blkdev_get/put().
894 if ((mode & BLK_OPEN_WRITE) && !bdev->bd_write_holder &&
895 (disk->event_flags & DISK_EVENT_FLAG_BLOCK_ON_EXCL_WRITE)) {
896 bdev->bd_write_holder = true;
897 unblock_events = false;
900 mutex_unlock(&disk->open_mutex);
903 disk_unblock_events(disk);
905 bdev_file->f_flags |= O_LARGEFILE;
906 bdev_file->f_mode |= FMODE_BUF_RASYNC | FMODE_CAN_ODIRECT;
907 if (bdev_nowait(bdev))
908 bdev_file->f_mode |= FMODE_NOWAIT;
909 if (mode & BLK_OPEN_RESTRICT_WRITES)
910 bdev_file->f_mode |= FMODE_WRITE_RESTRICTED;
911 bdev_file->f_mapping = bdev->bd_inode->i_mapping;
912 bdev_file->f_wb_err = filemap_sample_wb_err(bdev_file->f_mapping);
913 bdev_file->private_data = holder;
917 module_put(disk->fops->owner);
920 bd_abort_claiming(bdev, holder);
921 mutex_unlock(&disk->open_mutex);
922 disk_unblock_events(disk);
927 * If BLK_OPEN_WRITE_IOCTL is set then this is a historical quirk
928 * associated with the floppy driver where it has allowed ioctls if the
929 * file was opened for writing, but does not allow reads or writes.
930 * Make sure that this quirk is reflected in @f_flags.
932 * It can also happen if a block device is opened as O_RDWR | O_WRONLY.
934 static unsigned blk_to_file_flags(blk_mode_t mode)
936 unsigned int flags = 0;
938 if ((mode & (BLK_OPEN_READ | BLK_OPEN_WRITE)) ==
939 (BLK_OPEN_READ | BLK_OPEN_WRITE))
941 else if (mode & BLK_OPEN_WRITE_IOCTL)
942 flags |= O_RDWR | O_WRONLY;
943 else if (mode & BLK_OPEN_WRITE)
945 else if (mode & BLK_OPEN_READ)
946 flags |= O_RDONLY; /* homeopathic, because O_RDONLY is 0 */
950 if (mode & BLK_OPEN_NDELAY)
956 struct file *bdev_file_open_by_dev(dev_t dev, blk_mode_t mode, void *holder,
957 const struct blk_holder_ops *hops)
959 struct file *bdev_file;
960 struct block_device *bdev;
964 ret = bdev_permission(dev, mode, holder);
968 bdev = blkdev_get_no_open(dev);
970 return ERR_PTR(-ENXIO);
972 flags = blk_to_file_flags(mode);
973 bdev_file = alloc_file_pseudo_noaccount(bdev->bd_inode,
974 blockdev_mnt, "", flags | O_LARGEFILE, &def_blk_fops);
975 if (IS_ERR(bdev_file)) {
976 blkdev_put_no_open(bdev);
979 ihold(bdev->bd_inode);
981 ret = bdev_open(bdev, mode, holder, hops, bdev_file);
983 /* We failed to open the block device. Let ->release() know. */
984 bdev_file->private_data = ERR_PTR(ret);
990 EXPORT_SYMBOL(bdev_file_open_by_dev);
992 struct file *bdev_file_open_by_path(const char *path, blk_mode_t mode,
994 const struct blk_holder_ops *hops)
1000 error = lookup_bdev(path, &dev);
1002 return ERR_PTR(error);
1004 file = bdev_file_open_by_dev(dev, mode, holder, hops);
1005 if (!IS_ERR(file) && (mode & BLK_OPEN_WRITE)) {
1006 if (bdev_read_only(file_bdev(file))) {
1008 file = ERR_PTR(-EACCES);
1014 EXPORT_SYMBOL(bdev_file_open_by_path);
1016 static inline void bd_yield_claim(struct file *bdev_file)
1018 struct block_device *bdev = file_bdev(bdev_file);
1019 void *holder = bdev_file->private_data;
1021 lockdep_assert_held(&bdev->bd_disk->open_mutex);
1023 if (WARN_ON_ONCE(IS_ERR_OR_NULL(holder)))
1026 if (!bdev_unclaimed(bdev_file))
1027 bd_end_claim(bdev, holder);
1030 void bdev_release(struct file *bdev_file)
1032 struct block_device *bdev = file_bdev(bdev_file);
1033 void *holder = bdev_file->private_data;
1034 struct gendisk *disk = bdev->bd_disk;
1036 /* We failed to open that block device. */
1041 * Sync early if it looks like we're the last one. If someone else
1042 * opens the block device between now and the decrement of bd_openers
1043 * then we did a sync that we didn't need to, but that's not the end
1044 * of the world and we want to avoid long (could be several minute)
1045 * syncs while holding the mutex.
1047 if (atomic_read(&bdev->bd_openers) == 1)
1048 sync_blockdev(bdev);
1050 mutex_lock(&disk->open_mutex);
1051 bdev_yield_write_access(bdev_file);
1054 bd_yield_claim(bdev_file);
1057 * Trigger event checking and tell drivers to flush MEDIA_CHANGE
1058 * event. This is to ensure detection of media removal commanded
1059 * from userland - e.g. eject(1).
1061 disk_flush_events(disk, DISK_EVENT_MEDIA_CHANGE);
1063 if (bdev_is_partition(bdev))
1064 blkdev_put_part(bdev);
1066 blkdev_put_whole(bdev);
1067 mutex_unlock(&disk->open_mutex);
1069 module_put(disk->fops->owner);
1071 blkdev_put_no_open(bdev);
1075 * bdev_fput - yield claim to the block device and put the file
1076 * @bdev_file: open block device
1078 * Yield claim on the block device and put the file. Ensure that the
1079 * block device can be reclaimed before the file is closed which is a
1080 * deferred operation.
1082 void bdev_fput(struct file *bdev_file)
1084 if (WARN_ON_ONCE(bdev_file->f_op != &def_blk_fops))
1087 if (bdev_file->private_data) {
1088 struct block_device *bdev = file_bdev(bdev_file);
1089 struct gendisk *disk = bdev->bd_disk;
1091 mutex_lock(&disk->open_mutex);
1092 bdev_yield_write_access(bdev_file);
1093 bd_yield_claim(bdev_file);
1095 * Tell release we already gave up our hold on the
1096 * device and if write restrictions are available that
1097 * we already gave up write access to the device.
1099 bdev_file->private_data = BDEV_I(bdev_file->f_mapping->host);
1100 mutex_unlock(&disk->open_mutex);
1105 EXPORT_SYMBOL(bdev_fput);
1108 * lookup_bdev() - Look up a struct block_device by name.
1109 * @pathname: Name of the block device in the filesystem.
1110 * @dev: Pointer to the block device's dev_t, if found.
1112 * Lookup the block device's dev_t at @pathname in the current
1113 * namespace if possible and return it in @dev.
1115 * Context: May sleep.
1116 * Return: 0 if succeeded, negative errno otherwise.
1118 int lookup_bdev(const char *pathname, dev_t *dev)
1120 struct inode *inode;
1124 if (!pathname || !*pathname)
1127 error = kern_path(pathname, LOOKUP_FOLLOW, &path);
1131 inode = d_backing_inode(path.dentry);
1133 if (!S_ISBLK(inode->i_mode))
1136 if (!may_open_dev(&path))
1139 *dev = inode->i_rdev;
1145 EXPORT_SYMBOL(lookup_bdev);
1148 * bdev_mark_dead - mark a block device as dead
1149 * @bdev: block device to operate on
1150 * @surprise: indicate a surprise removal
1152 * Tell the file system that this devices or media is dead. If @surprise is set
1153 * to %true the device or media is already gone, if not we are preparing for an
1156 * This calls into the file system, which then typicall syncs out all dirty data
1157 * and writes back inodes and then invalidates any cached data in the inodes on
1158 * the file system. In addition we also invalidate the block device mapping.
1160 void bdev_mark_dead(struct block_device *bdev, bool surprise)
1162 mutex_lock(&bdev->bd_holder_lock);
1163 if (bdev->bd_holder_ops && bdev->bd_holder_ops->mark_dead)
1164 bdev->bd_holder_ops->mark_dead(bdev, surprise);
1166 mutex_unlock(&bdev->bd_holder_lock);
1167 sync_blockdev(bdev);
1170 invalidate_bdev(bdev);
1173 * New drivers should not use this directly. There are some drivers however
1174 * that needs this for historical reasons. For example, the DASD driver has
1175 * historically had a shutdown to offline mode that doesn't actually remove the
1176 * gendisk that otherwise looks a lot like a safe device removal.
1178 EXPORT_SYMBOL_GPL(bdev_mark_dead);
1180 void sync_bdevs(bool wait)
1182 struct inode *inode, *old_inode = NULL;
1184 spin_lock(&blockdev_superblock->s_inode_list_lock);
1185 list_for_each_entry(inode, &blockdev_superblock->s_inodes, i_sb_list) {
1186 struct address_space *mapping = inode->i_mapping;
1187 struct block_device *bdev;
1189 spin_lock(&inode->i_lock);
1190 if (inode->i_state & (I_FREEING|I_WILL_FREE|I_NEW) ||
1191 mapping->nrpages == 0) {
1192 spin_unlock(&inode->i_lock);
1196 spin_unlock(&inode->i_lock);
1197 spin_unlock(&blockdev_superblock->s_inode_list_lock);
1199 * We hold a reference to 'inode' so it couldn't have been
1200 * removed from s_inodes list while we dropped the
1201 * s_inode_list_lock We cannot iput the inode now as we can
1202 * be holding the last reference and we cannot iput it under
1203 * s_inode_list_lock. So we keep the reference and iput it
1208 bdev = I_BDEV(inode);
1210 mutex_lock(&bdev->bd_disk->open_mutex);
1211 if (!atomic_read(&bdev->bd_openers)) {
1215 * We keep the error status of individual mapping so
1216 * that applications can catch the writeback error using
1217 * fsync(2). See filemap_fdatawait_keep_errors() for
1220 filemap_fdatawait_keep_errors(inode->i_mapping);
1222 filemap_fdatawrite(inode->i_mapping);
1224 mutex_unlock(&bdev->bd_disk->open_mutex);
1226 spin_lock(&blockdev_superblock->s_inode_list_lock);
1228 spin_unlock(&blockdev_superblock->s_inode_list_lock);
1233 * Handle STATX_DIOALIGN for block devices.
1235 * Note that the inode passed to this is the inode of a block device node file,
1236 * not the block device's internal inode. Therefore it is *not* valid to use
1237 * I_BDEV() here; the block device has to be looked up by i_rdev instead.
1239 void bdev_statx_dioalign(struct inode *inode, struct kstat *stat)
1241 struct block_device *bdev;
1243 bdev = blkdev_get_no_open(inode->i_rdev);
1247 stat->dio_mem_align = bdev_dma_alignment(bdev) + 1;
1248 stat->dio_offset_align = bdev_logical_block_size(bdev);
1249 stat->result_mask |= STATX_DIOALIGN;
1251 blkdev_put_no_open(bdev);
1254 static int __init setup_bdev_allow_write_mounted(char *str)
1256 if (kstrtobool(str, &bdev_allow_write_mounted))
1257 pr_warn("Invalid option string for bdev_allow_write_mounted:"
1261 __setup("bdev_allow_write_mounted=", setup_bdev_allow_write_mounted);