1 // SPDX-License-Identifier: GPL-2.0-only
5 * Copyright (C) 1991, 1992 Linus Torvalds
6 * Copyright (C) 2001 Andrea Arcangeli <andrea@suse.de> SuSE
9 #include <linux/init.h>
11 #include <linux/fcntl.h>
12 #include <linux/slab.h>
13 #include <linux/kmod.h>
14 #include <linux/major.h>
15 #include <linux/device_cgroup.h>
16 #include <linux/highmem.h>
17 #include <linux/blkdev.h>
18 #include <linux/backing-dev.h>
19 #include <linux/module.h>
20 #include <linux/blkpg.h>
21 #include <linux/magic.h>
22 #include <linux/buffer_head.h>
23 #include <linux/swap.h>
24 #include <linux/pagevec.h>
25 #include <linux/writeback.h>
26 #include <linux/mpage.h>
27 #include <linux/mount.h>
28 #include <linux/pseudo_fs.h>
29 #include <linux/uio.h>
30 #include <linux/namei.h>
31 #include <linux/log2.h>
32 #include <linux/cleancache.h>
33 #include <linux/task_io_accounting_ops.h>
34 #include <linux/falloc.h>
35 #include <linux/uaccess.h>
36 #include <linux/suspend.h>
40 struct block_device bdev
;
41 struct inode vfs_inode
;
44 static const struct address_space_operations def_blk_aops
;
46 static inline struct bdev_inode
*BDEV_I(struct inode
*inode
)
48 return container_of(inode
, struct bdev_inode
, vfs_inode
);
51 struct block_device
*I_BDEV(struct inode
*inode
)
53 return &BDEV_I(inode
)->bdev
;
55 EXPORT_SYMBOL(I_BDEV
);
57 static void bdev_write_inode(struct block_device
*bdev
)
59 struct inode
*inode
= bdev
->bd_inode
;
62 spin_lock(&inode
->i_lock
);
63 while (inode
->i_state
& I_DIRTY
) {
64 spin_unlock(&inode
->i_lock
);
65 ret
= write_inode_now(inode
, true);
67 char name
[BDEVNAME_SIZE
];
68 pr_warn_ratelimited("VFS: Dirty inode writeback failed "
69 "for block device %s (err=%d).\n",
70 bdevname(bdev
, name
), ret
);
72 spin_lock(&inode
->i_lock
);
74 spin_unlock(&inode
->i_lock
);
77 /* Kill _all_ buffers and pagecache , dirty or not.. */
78 static void kill_bdev(struct block_device
*bdev
)
80 struct address_space
*mapping
= bdev
->bd_inode
->i_mapping
;
82 if (mapping
->nrpages
== 0 && mapping
->nrexceptional
== 0)
86 truncate_inode_pages(mapping
, 0);
89 /* Invalidate clean unused buffers and pagecache. */
90 void invalidate_bdev(struct block_device
*bdev
)
92 struct address_space
*mapping
= bdev
->bd_inode
->i_mapping
;
94 if (mapping
->nrpages
) {
96 lru_add_drain_all(); /* make sure all lru add caches are flushed */
97 invalidate_mapping_pages(mapping
, 0, -1);
99 /* 99% of the time, we don't need to flush the cleancache on the bdev.
100 * But, for the strange corners, lets be cautious
102 cleancache_invalidate_inode(mapping
);
104 EXPORT_SYMBOL(invalidate_bdev
);
106 static void set_init_blocksize(struct block_device
*bdev
)
108 bdev
->bd_inode
->i_blkbits
= blksize_bits(bdev_logical_block_size(bdev
));
111 int set_blocksize(struct block_device
*bdev
, int size
)
113 /* Size must be a power of two, and between 512 and PAGE_SIZE */
114 if (size
> PAGE_SIZE
|| size
< 512 || !is_power_of_2(size
))
117 /* Size cannot be smaller than the size supported by the device */
118 if (size
< bdev_logical_block_size(bdev
))
121 /* Don't change the size if it is same as current */
122 if (bdev
->bd_inode
->i_blkbits
!= blksize_bits(size
)) {
124 bdev
->bd_inode
->i_blkbits
= blksize_bits(size
);
130 EXPORT_SYMBOL(set_blocksize
);
132 int sb_set_blocksize(struct super_block
*sb
, int size
)
134 if (set_blocksize(sb
->s_bdev
, size
))
136 /* If we get here, we know size is power of two
137 * and it's value is between 512 and PAGE_SIZE */
138 sb
->s_blocksize
= size
;
139 sb
->s_blocksize_bits
= blksize_bits(size
);
140 return sb
->s_blocksize
;
143 EXPORT_SYMBOL(sb_set_blocksize
);
145 int sb_min_blocksize(struct super_block
*sb
, int size
)
147 int minsize
= bdev_logical_block_size(sb
->s_bdev
);
150 return sb_set_blocksize(sb
, size
);
153 EXPORT_SYMBOL(sb_min_blocksize
);
156 blkdev_get_block(struct inode
*inode
, sector_t iblock
,
157 struct buffer_head
*bh
, int create
)
159 bh
->b_bdev
= I_BDEV(inode
);
160 bh
->b_blocknr
= iblock
;
161 set_buffer_mapped(bh
);
165 static struct inode
*bdev_file_inode(struct file
*file
)
167 return file
->f_mapping
->host
;
170 static unsigned int dio_bio_write_op(struct kiocb
*iocb
)
172 unsigned int op
= REQ_OP_WRITE
| REQ_SYNC
| REQ_IDLE
;
174 /* avoid the need for a I/O completion work item */
175 if (iocb
->ki_flags
& IOCB_DSYNC
)
180 #define DIO_INLINE_BIO_VECS 4
182 static void blkdev_bio_end_io_simple(struct bio
*bio
)
184 struct task_struct
*waiter
= bio
->bi_private
;
186 WRITE_ONCE(bio
->bi_private
, NULL
);
187 blk_wake_io_task(waiter
);
191 __blkdev_direct_IO_simple(struct kiocb
*iocb
, struct iov_iter
*iter
,
194 struct file
*file
= iocb
->ki_filp
;
195 struct block_device
*bdev
= I_BDEV(bdev_file_inode(file
));
196 struct bio_vec inline_vecs
[DIO_INLINE_BIO_VECS
], *vecs
;
197 loff_t pos
= iocb
->ki_pos
;
198 bool should_dirty
= false;
203 if ((pos
| iov_iter_alignment(iter
)) &
204 (bdev_logical_block_size(bdev
) - 1))
207 if (nr_pages
<= DIO_INLINE_BIO_VECS
)
210 vecs
= kmalloc_array(nr_pages
, sizeof(struct bio_vec
),
216 bio_init(&bio
, vecs
, nr_pages
);
217 bio_set_dev(&bio
, bdev
);
218 bio
.bi_iter
.bi_sector
= pos
>> 9;
219 bio
.bi_write_hint
= iocb
->ki_hint
;
220 bio
.bi_private
= current
;
221 bio
.bi_end_io
= blkdev_bio_end_io_simple
;
222 bio
.bi_ioprio
= iocb
->ki_ioprio
;
224 ret
= bio_iov_iter_get_pages(&bio
, iter
);
227 ret
= bio
.bi_iter
.bi_size
;
229 if (iov_iter_rw(iter
) == READ
) {
230 bio
.bi_opf
= REQ_OP_READ
;
231 if (iter_is_iovec(iter
))
234 bio
.bi_opf
= dio_bio_write_op(iocb
);
235 task_io_account_write(ret
);
237 if (iocb
->ki_flags
& IOCB_HIPRI
)
238 bio_set_polled(&bio
, iocb
);
240 qc
= submit_bio(&bio
);
242 set_current_state(TASK_UNINTERRUPTIBLE
);
243 if (!READ_ONCE(bio
.bi_private
))
245 if (!(iocb
->ki_flags
& IOCB_HIPRI
) ||
246 !blk_poll(bdev_get_queue(bdev
), qc
, true))
249 __set_current_state(TASK_RUNNING
);
251 bio_release_pages(&bio
, should_dirty
);
252 if (unlikely(bio
.bi_status
))
253 ret
= blk_status_to_errno(bio
.bi_status
);
256 if (vecs
!= inline_vecs
)
267 struct task_struct
*waiter
;
272 bool should_dirty
: 1;
277 static struct bio_set blkdev_dio_pool
;
279 static int blkdev_iopoll(struct kiocb
*kiocb
, bool wait
)
281 struct block_device
*bdev
= I_BDEV(kiocb
->ki_filp
->f_mapping
->host
);
282 struct request_queue
*q
= bdev_get_queue(bdev
);
284 return blk_poll(q
, READ_ONCE(kiocb
->ki_cookie
), wait
);
287 static void blkdev_bio_end_io(struct bio
*bio
)
289 struct blkdev_dio
*dio
= bio
->bi_private
;
290 bool should_dirty
= dio
->should_dirty
;
292 if (bio
->bi_status
&& !dio
->bio
.bi_status
)
293 dio
->bio
.bi_status
= bio
->bi_status
;
295 if (!dio
->multi_bio
|| atomic_dec_and_test(&dio
->ref
)) {
297 struct kiocb
*iocb
= dio
->iocb
;
300 if (likely(!dio
->bio
.bi_status
)) {
304 ret
= blk_status_to_errno(dio
->bio
.bi_status
);
307 dio
->iocb
->ki_complete(iocb
, ret
, 0);
311 struct task_struct
*waiter
= dio
->waiter
;
313 WRITE_ONCE(dio
->waiter
, NULL
);
314 blk_wake_io_task(waiter
);
319 bio_check_pages_dirty(bio
);
321 bio_release_pages(bio
, false);
327 __blkdev_direct_IO(struct kiocb
*iocb
, struct iov_iter
*iter
, int nr_pages
)
329 struct file
*file
= iocb
->ki_filp
;
330 struct inode
*inode
= bdev_file_inode(file
);
331 struct block_device
*bdev
= I_BDEV(inode
);
332 struct blk_plug plug
;
333 struct blkdev_dio
*dio
;
335 bool is_poll
= (iocb
->ki_flags
& IOCB_HIPRI
) != 0;
336 bool is_read
= (iov_iter_rw(iter
) == READ
), is_sync
;
337 loff_t pos
= iocb
->ki_pos
;
338 blk_qc_t qc
= BLK_QC_T_NONE
;
341 if ((pos
| iov_iter_alignment(iter
)) &
342 (bdev_logical_block_size(bdev
) - 1))
345 bio
= bio_alloc_bioset(GFP_KERNEL
, nr_pages
, &blkdev_dio_pool
);
347 dio
= container_of(bio
, struct blkdev_dio
, bio
);
348 dio
->is_sync
= is_sync
= is_sync_kiocb(iocb
);
350 dio
->waiter
= current
;
357 dio
->multi_bio
= false;
358 dio
->should_dirty
= is_read
&& iter_is_iovec(iter
);
361 * Don't plug for HIPRI/polled IO, as those should go straight
365 blk_start_plug(&plug
);
368 bio_set_dev(bio
, bdev
);
369 bio
->bi_iter
.bi_sector
= pos
>> 9;
370 bio
->bi_write_hint
= iocb
->ki_hint
;
371 bio
->bi_private
= dio
;
372 bio
->bi_end_io
= blkdev_bio_end_io
;
373 bio
->bi_ioprio
= iocb
->ki_ioprio
;
375 ret
= bio_iov_iter_get_pages(bio
, iter
);
377 bio
->bi_status
= BLK_STS_IOERR
;
383 bio
->bi_opf
= REQ_OP_READ
;
384 if (dio
->should_dirty
)
385 bio_set_pages_dirty(bio
);
387 bio
->bi_opf
= dio_bio_write_op(iocb
);
388 task_io_account_write(bio
->bi_iter
.bi_size
);
391 dio
->size
+= bio
->bi_iter
.bi_size
;
392 pos
+= bio
->bi_iter
.bi_size
;
394 nr_pages
= iov_iter_npages(iter
, BIO_MAX_PAGES
);
398 if (iocb
->ki_flags
& IOCB_HIPRI
) {
399 bio_set_polled(bio
, iocb
);
403 qc
= submit_bio(bio
);
406 WRITE_ONCE(iocb
->ki_cookie
, qc
);
410 if (!dio
->multi_bio
) {
412 * AIO needs an extra reference to ensure the dio
413 * structure which is embedded into the first bio
418 dio
->multi_bio
= true;
419 atomic_set(&dio
->ref
, 2);
421 atomic_inc(&dio
->ref
);
425 bio
= bio_alloc(GFP_KERNEL
, nr_pages
);
429 blk_finish_plug(&plug
);
435 set_current_state(TASK_UNINTERRUPTIBLE
);
436 if (!READ_ONCE(dio
->waiter
))
439 if (!(iocb
->ki_flags
& IOCB_HIPRI
) ||
440 !blk_poll(bdev_get_queue(bdev
), qc
, true))
443 __set_current_state(TASK_RUNNING
);
446 ret
= blk_status_to_errno(dio
->bio
.bi_status
);
455 blkdev_direct_IO(struct kiocb
*iocb
, struct iov_iter
*iter
)
459 nr_pages
= iov_iter_npages(iter
, BIO_MAX_PAGES
+ 1);
462 if (is_sync_kiocb(iocb
) && nr_pages
<= BIO_MAX_PAGES
)
463 return __blkdev_direct_IO_simple(iocb
, iter
, nr_pages
);
465 return __blkdev_direct_IO(iocb
, iter
, min(nr_pages
, BIO_MAX_PAGES
));
468 static __init
int blkdev_init(void)
470 return bioset_init(&blkdev_dio_pool
, 4, offsetof(struct blkdev_dio
, bio
), BIOSET_NEED_BVECS
);
472 module_init(blkdev_init
);
474 int __sync_blockdev(struct block_device
*bdev
, int wait
)
479 return filemap_flush(bdev
->bd_inode
->i_mapping
);
480 return filemap_write_and_wait(bdev
->bd_inode
->i_mapping
);
484 * Write out and wait upon all the dirty data associated with a block
485 * device via its mapping. Does not take the superblock lock.
487 int sync_blockdev(struct block_device
*bdev
)
489 return __sync_blockdev(bdev
, 1);
491 EXPORT_SYMBOL(sync_blockdev
);
494 * Write out and wait upon all dirty data associated with this
495 * device. Filesystem data as well as the underlying block
496 * device. Takes the superblock lock.
498 int fsync_bdev(struct block_device
*bdev
)
500 struct super_block
*sb
= get_super(bdev
);
502 int res
= sync_filesystem(sb
);
506 return sync_blockdev(bdev
);
508 EXPORT_SYMBOL(fsync_bdev
);
511 * freeze_bdev -- lock a filesystem and force it into a consistent state
512 * @bdev: blockdevice to lock
514 * If a superblock is found on this device, we take the s_umount semaphore
515 * on it to make sure nobody unmounts until the snapshot creation is done.
516 * The reference counter (bd_fsfreeze_count) guarantees that only the last
517 * unfreeze process can unfreeze the frozen filesystem actually when multiple
518 * freeze requests arrive simultaneously. It counts up in freeze_bdev() and
519 * count down in thaw_bdev(). When it becomes 0, thaw_bdev() will unfreeze
522 struct super_block
*freeze_bdev(struct block_device
*bdev
)
524 struct super_block
*sb
;
527 mutex_lock(&bdev
->bd_fsfreeze_mutex
);
528 if (++bdev
->bd_fsfreeze_count
> 1) {
530 * We don't even need to grab a reference - the first call
531 * to freeze_bdev grab an active reference and only the last
532 * thaw_bdev drops it.
534 sb
= get_super(bdev
);
537 mutex_unlock(&bdev
->bd_fsfreeze_mutex
);
541 sb
= get_active_super(bdev
);
544 if (sb
->s_op
->freeze_super
)
545 error
= sb
->s_op
->freeze_super(sb
);
547 error
= freeze_super(sb
);
549 deactivate_super(sb
);
550 bdev
->bd_fsfreeze_count
--;
551 mutex_unlock(&bdev
->bd_fsfreeze_mutex
);
552 return ERR_PTR(error
);
554 deactivate_super(sb
);
557 mutex_unlock(&bdev
->bd_fsfreeze_mutex
);
558 return sb
; /* thaw_bdev releases s->s_umount */
560 EXPORT_SYMBOL(freeze_bdev
);
563 * thaw_bdev -- unlock filesystem
564 * @bdev: blockdevice to unlock
565 * @sb: associated superblock
567 * Unlocks the filesystem and marks it writeable again after freeze_bdev().
569 int thaw_bdev(struct block_device
*bdev
, struct super_block
*sb
)
573 mutex_lock(&bdev
->bd_fsfreeze_mutex
);
574 if (!bdev
->bd_fsfreeze_count
)
578 if (--bdev
->bd_fsfreeze_count
> 0)
584 if (sb
->s_op
->thaw_super
)
585 error
= sb
->s_op
->thaw_super(sb
);
587 error
= thaw_super(sb
);
589 bdev
->bd_fsfreeze_count
++;
591 mutex_unlock(&bdev
->bd_fsfreeze_mutex
);
594 EXPORT_SYMBOL(thaw_bdev
);
596 static int blkdev_writepage(struct page
*page
, struct writeback_control
*wbc
)
598 return block_write_full_page(page
, blkdev_get_block
, wbc
);
601 static int blkdev_readpage(struct file
* file
, struct page
* page
)
603 return block_read_full_page(page
, blkdev_get_block
);
606 static void blkdev_readahead(struct readahead_control
*rac
)
608 mpage_readahead(rac
, blkdev_get_block
);
611 static int blkdev_write_begin(struct file
*file
, struct address_space
*mapping
,
612 loff_t pos
, unsigned len
, unsigned flags
,
613 struct page
**pagep
, void **fsdata
)
615 return block_write_begin(mapping
, pos
, len
, flags
, pagep
,
619 static int blkdev_write_end(struct file
*file
, struct address_space
*mapping
,
620 loff_t pos
, unsigned len
, unsigned copied
,
621 struct page
*page
, void *fsdata
)
624 ret
= block_write_end(file
, mapping
, pos
, len
, copied
, page
, fsdata
);
634 * for a block special file file_inode(file)->i_size is zero
635 * so we compute the size by hand (just as in block_read/write above)
637 static loff_t
block_llseek(struct file
*file
, loff_t offset
, int whence
)
639 struct inode
*bd_inode
= bdev_file_inode(file
);
642 inode_lock(bd_inode
);
643 retval
= fixed_size_llseek(file
, offset
, whence
, i_size_read(bd_inode
));
644 inode_unlock(bd_inode
);
648 int blkdev_fsync(struct file
*filp
, loff_t start
, loff_t end
, int datasync
)
650 struct inode
*bd_inode
= bdev_file_inode(filp
);
651 struct block_device
*bdev
= I_BDEV(bd_inode
);
654 error
= file_write_and_wait_range(filp
, start
, end
);
659 * There is no need to serialise calls to blkdev_issue_flush with
660 * i_mutex and doing so causes performance issues with concurrent
661 * O_SYNC writers to a block device.
663 error
= blkdev_issue_flush(bdev
, GFP_KERNEL
);
664 if (error
== -EOPNOTSUPP
)
669 EXPORT_SYMBOL(blkdev_fsync
);
672 * bdev_read_page() - Start reading a page from a block device
673 * @bdev: The device to read the page from
674 * @sector: The offset on the device to read the page to (need not be aligned)
675 * @page: The page to read
677 * On entry, the page should be locked. It will be unlocked when the page
678 * has been read. If the block driver implements rw_page synchronously,
679 * that will be true on exit from this function, but it need not be.
681 * Errors returned by this function are usually "soft", eg out of memory, or
682 * queue full; callers should try a different route to read this page rather
683 * than propagate an error back up the stack.
685 * Return: negative errno if an error occurs, 0 if submission was successful.
687 int bdev_read_page(struct block_device
*bdev
, sector_t sector
,
690 const struct block_device_operations
*ops
= bdev
->bd_disk
->fops
;
691 int result
= -EOPNOTSUPP
;
693 if (!ops
->rw_page
|| bdev_get_integrity(bdev
))
696 result
= blk_queue_enter(bdev
->bd_disk
->queue
, 0);
699 result
= ops
->rw_page(bdev
, sector
+ get_start_sect(bdev
), page
,
701 blk_queue_exit(bdev
->bd_disk
->queue
);
706 * bdev_write_page() - Start writing a page to a block device
707 * @bdev: The device to write the page to
708 * @sector: The offset on the device to write the page to (need not be aligned)
709 * @page: The page to write
710 * @wbc: The writeback_control for the write
712 * On entry, the page should be locked and not currently under writeback.
713 * On exit, if the write started successfully, the page will be unlocked and
714 * under writeback. If the write failed already (eg the driver failed to
715 * queue the page to the device), the page will still be locked. If the
716 * caller is a ->writepage implementation, it will need to unlock the page.
718 * Errors returned by this function are usually "soft", eg out of memory, or
719 * queue full; callers should try a different route to write this page rather
720 * than propagate an error back up the stack.
722 * Return: negative errno if an error occurs, 0 if submission was successful.
724 int bdev_write_page(struct block_device
*bdev
, sector_t sector
,
725 struct page
*page
, struct writeback_control
*wbc
)
728 const struct block_device_operations
*ops
= bdev
->bd_disk
->fops
;
730 if (!ops
->rw_page
|| bdev_get_integrity(bdev
))
732 result
= blk_queue_enter(bdev
->bd_disk
->queue
, 0);
736 set_page_writeback(page
);
737 result
= ops
->rw_page(bdev
, sector
+ get_start_sect(bdev
), page
,
740 end_page_writeback(page
);
742 clean_page_buffers(page
);
745 blk_queue_exit(bdev
->bd_disk
->queue
);
753 static __cacheline_aligned_in_smp
DEFINE_SPINLOCK(bdev_lock
);
754 static struct kmem_cache
* bdev_cachep __read_mostly
;
756 static struct inode
*bdev_alloc_inode(struct super_block
*sb
)
758 struct bdev_inode
*ei
= kmem_cache_alloc(bdev_cachep
, GFP_KERNEL
);
761 return &ei
->vfs_inode
;
764 static void bdev_free_inode(struct inode
*inode
)
766 kmem_cache_free(bdev_cachep
, BDEV_I(inode
));
769 static void init_once(void *foo
)
771 struct bdev_inode
*ei
= (struct bdev_inode
*) foo
;
772 struct block_device
*bdev
= &ei
->bdev
;
774 memset(bdev
, 0, sizeof(*bdev
));
775 mutex_init(&bdev
->bd_mutex
);
777 INIT_LIST_HEAD(&bdev
->bd_holder_disks
);
779 bdev
->bd_bdi
= &noop_backing_dev_info
;
780 inode_init_once(&ei
->vfs_inode
);
781 /* Initialize mutex for freeze. */
782 mutex_init(&bdev
->bd_fsfreeze_mutex
);
785 static void bdev_evict_inode(struct inode
*inode
)
787 struct block_device
*bdev
= &BDEV_I(inode
)->bdev
;
788 truncate_inode_pages_final(&inode
->i_data
);
789 invalidate_inode_buffers(inode
); /* is it needed here? */
791 /* Detach inode from wb early as bdi_put() may free bdi->wb */
792 inode_detach_wb(inode
);
793 if (bdev
->bd_bdi
!= &noop_backing_dev_info
) {
794 bdi_put(bdev
->bd_bdi
);
795 bdev
->bd_bdi
= &noop_backing_dev_info
;
799 static const struct super_operations bdev_sops
= {
800 .statfs
= simple_statfs
,
801 .alloc_inode
= bdev_alloc_inode
,
802 .free_inode
= bdev_free_inode
,
803 .drop_inode
= generic_delete_inode
,
804 .evict_inode
= bdev_evict_inode
,
807 static int bd_init_fs_context(struct fs_context
*fc
)
809 struct pseudo_fs_context
*ctx
= init_pseudo(fc
, BDEVFS_MAGIC
);
812 fc
->s_iflags
|= SB_I_CGROUPWB
;
813 ctx
->ops
= &bdev_sops
;
817 static struct file_system_type bd_type
= {
819 .init_fs_context
= bd_init_fs_context
,
820 .kill_sb
= kill_anon_super
,
823 struct super_block
*blockdev_superblock __read_mostly
;
824 EXPORT_SYMBOL_GPL(blockdev_superblock
);
826 void __init
bdev_cache_init(void)
829 static struct vfsmount
*bd_mnt
;
831 bdev_cachep
= kmem_cache_create("bdev_cache", sizeof(struct bdev_inode
),
832 0, (SLAB_HWCACHE_ALIGN
|SLAB_RECLAIM_ACCOUNT
|
833 SLAB_MEM_SPREAD
|SLAB_ACCOUNT
|SLAB_PANIC
),
835 err
= register_filesystem(&bd_type
);
837 panic("Cannot register bdev pseudo-fs");
838 bd_mnt
= kern_mount(&bd_type
);
840 panic("Cannot create bdev pseudo-fs");
841 blockdev_superblock
= bd_mnt
->mnt_sb
; /* For writeback */
845 * Most likely _very_ bad one - but then it's hardly critical for small
846 * /dev and can be fixed when somebody will need really large one.
847 * Keep in mind that it will be fed through icache hash function too.
849 static inline unsigned long hash(dev_t dev
)
851 return MAJOR(dev
)+MINOR(dev
);
854 static int bdev_test(struct inode
*inode
, void *data
)
856 return BDEV_I(inode
)->bdev
.bd_dev
== *(dev_t
*)data
;
859 static int bdev_set(struct inode
*inode
, void *data
)
861 BDEV_I(inode
)->bdev
.bd_dev
= *(dev_t
*)data
;
865 struct block_device
*bdget(dev_t dev
)
867 struct block_device
*bdev
;
870 inode
= iget5_locked(blockdev_superblock
, hash(dev
),
871 bdev_test
, bdev_set
, &dev
);
876 bdev
= &BDEV_I(inode
)->bdev
;
878 if (inode
->i_state
& I_NEW
) {
879 bdev
->bd_contains
= NULL
;
880 bdev
->bd_super
= NULL
;
881 bdev
->bd_inode
= inode
;
882 bdev
->bd_part_count
= 0;
883 bdev
->bd_invalidated
= 0;
884 inode
->i_mode
= S_IFBLK
;
886 inode
->i_bdev
= bdev
;
887 inode
->i_data
.a_ops
= &def_blk_aops
;
888 mapping_set_gfp_mask(&inode
->i_data
, GFP_USER
);
889 unlock_new_inode(inode
);
894 EXPORT_SYMBOL(bdget
);
897 * bdgrab -- Grab a reference to an already referenced block device
898 * @bdev: Block device to grab a reference to.
900 struct block_device
*bdgrab(struct block_device
*bdev
)
902 ihold(bdev
->bd_inode
);
905 EXPORT_SYMBOL(bdgrab
);
907 long nr_blockdev_pages(void)
912 spin_lock(&blockdev_superblock
->s_inode_list_lock
);
913 list_for_each_entry(inode
, &blockdev_superblock
->s_inodes
, i_sb_list
)
914 ret
+= inode
->i_mapping
->nrpages
;
915 spin_unlock(&blockdev_superblock
->s_inode_list_lock
);
920 void bdput(struct block_device
*bdev
)
922 iput(bdev
->bd_inode
);
925 EXPORT_SYMBOL(bdput
);
927 static struct block_device
*bd_acquire(struct inode
*inode
)
929 struct block_device
*bdev
;
931 spin_lock(&bdev_lock
);
932 bdev
= inode
->i_bdev
;
933 if (bdev
&& !inode_unhashed(bdev
->bd_inode
)) {
935 spin_unlock(&bdev_lock
);
938 spin_unlock(&bdev_lock
);
941 * i_bdev references block device inode that was already shut down
942 * (corresponding device got removed). Remove the reference and look
943 * up block device inode again just in case new device got
944 * reestablished under the same device number.
949 bdev
= bdget(inode
->i_rdev
);
951 spin_lock(&bdev_lock
);
952 if (!inode
->i_bdev
) {
954 * We take an additional reference to bd_inode,
955 * and it's released in clear_inode() of inode.
956 * So, we can access it via ->i_mapping always
960 inode
->i_bdev
= bdev
;
961 inode
->i_mapping
= bdev
->bd_inode
->i_mapping
;
963 spin_unlock(&bdev_lock
);
968 /* Call when you free inode */
970 void bd_forget(struct inode
*inode
)
972 struct block_device
*bdev
= NULL
;
974 spin_lock(&bdev_lock
);
975 if (!sb_is_blkdev_sb(inode
->i_sb
))
976 bdev
= inode
->i_bdev
;
977 inode
->i_bdev
= NULL
;
978 inode
->i_mapping
= &inode
->i_data
;
979 spin_unlock(&bdev_lock
);
986 * bd_may_claim - test whether a block device can be claimed
987 * @bdev: block device of interest
988 * @whole: whole block device containing @bdev, may equal @bdev
989 * @holder: holder trying to claim @bdev
991 * Test whether @bdev can be claimed by @holder.
994 * spin_lock(&bdev_lock).
997 * %true if @bdev can be claimed, %false otherwise.
999 static bool bd_may_claim(struct block_device
*bdev
, struct block_device
*whole
,
1002 if (bdev
->bd_holder
== holder
)
1003 return true; /* already a holder */
1004 else if (bdev
->bd_holder
!= NULL
)
1005 return false; /* held by someone else */
1006 else if (whole
== bdev
)
1007 return true; /* is a whole device which isn't held */
1009 else if (whole
->bd_holder
== bd_may_claim
)
1010 return true; /* is a partition of a device that is being partitioned */
1011 else if (whole
->bd_holder
!= NULL
)
1012 return false; /* is a partition of a held device */
1014 return true; /* is a partition of an un-held device */
1018 * bd_prepare_to_claim - claim a block device
1019 * @bdev: block device of interest
1020 * @whole: the whole device containing @bdev, may equal @bdev
1021 * @holder: holder trying to claim @bdev
1023 * Claim @bdev. This function fails if @bdev is already claimed by another
1024 * holder and waits if another claiming is in progress. return, the caller
1025 * has ownership of bd_claiming and bd_holder[s].
1028 * 0 if @bdev can be claimed, -EBUSY otherwise.
1030 int bd_prepare_to_claim(struct block_device
*bdev
, struct block_device
*whole
,
1034 spin_lock(&bdev_lock
);
1035 /* if someone else claimed, fail */
1036 if (!bd_may_claim(bdev
, whole
, holder
)) {
1037 spin_unlock(&bdev_lock
);
1041 /* if claiming is already in progress, wait for it to finish */
1042 if (whole
->bd_claiming
) {
1043 wait_queue_head_t
*wq
= bit_waitqueue(&whole
->bd_claiming
, 0);
1046 prepare_to_wait(wq
, &wait
, TASK_UNINTERRUPTIBLE
);
1047 spin_unlock(&bdev_lock
);
1049 finish_wait(wq
, &wait
);
1054 whole
->bd_claiming
= holder
;
1055 spin_unlock(&bdev_lock
);
1058 EXPORT_SYMBOL_GPL(bd_prepare_to_claim
); /* only for the loop driver */
1060 static struct gendisk
*bdev_get_gendisk(struct block_device
*bdev
, int *partno
)
1062 struct gendisk
*disk
= get_gendisk(bdev
->bd_dev
, partno
);
1067 * Now that we hold gendisk reference we make sure bdev we looked up is
1068 * not stale. If it is, it means device got removed and created before
1069 * we looked up gendisk and we fail open in such case. Associating
1070 * unhashed bdev with newly created gendisk could lead to two bdevs
1071 * (and thus two independent caches) being associated with one device
1074 if (inode_unhashed(bdev
->bd_inode
)) {
1075 put_disk_and_module(disk
);
1081 static void bd_clear_claiming(struct block_device
*whole
, void *holder
)
1083 lockdep_assert_held(&bdev_lock
);
1084 /* tell others that we're done */
1085 BUG_ON(whole
->bd_claiming
!= holder
);
1086 whole
->bd_claiming
= NULL
;
1087 wake_up_bit(&whole
->bd_claiming
, 0);
1091 * bd_finish_claiming - finish claiming of a block device
1092 * @bdev: block device of interest
1093 * @whole: whole block device
1094 * @holder: holder that has claimed @bdev
1096 * Finish exclusive open of a block device. Mark the device as exlusively
1097 * open by the holder and wake up all waiters for exclusive open to finish.
1099 static void bd_finish_claiming(struct block_device
*bdev
,
1100 struct block_device
*whole
, void *holder
)
1102 spin_lock(&bdev_lock
);
1103 BUG_ON(!bd_may_claim(bdev
, whole
, holder
));
1105 * Note that for a whole device bd_holders will be incremented twice,
1106 * and bd_holder will be set to bd_may_claim before being set to holder
1108 whole
->bd_holders
++;
1109 whole
->bd_holder
= bd_may_claim
;
1111 bdev
->bd_holder
= holder
;
1112 bd_clear_claiming(whole
, holder
);
1113 spin_unlock(&bdev_lock
);
1117 * bd_abort_claiming - abort claiming of a block device
1118 * @bdev: block device of interest
1119 * @whole: whole block device
1120 * @holder: holder that has claimed @bdev
1122 * Abort claiming of a block device when the exclusive open failed. This can be
1123 * also used when exclusive open is not actually desired and we just needed
1124 * to block other exclusive openers for a while.
1126 void bd_abort_claiming(struct block_device
*bdev
, struct block_device
*whole
,
1129 spin_lock(&bdev_lock
);
1130 bd_clear_claiming(whole
, holder
);
1131 spin_unlock(&bdev_lock
);
1133 EXPORT_SYMBOL(bd_abort_claiming
);
1136 struct bd_holder_disk
{
1137 struct list_head list
;
1138 struct gendisk
*disk
;
1142 static struct bd_holder_disk
*bd_find_holder_disk(struct block_device
*bdev
,
1143 struct gendisk
*disk
)
1145 struct bd_holder_disk
*holder
;
1147 list_for_each_entry(holder
, &bdev
->bd_holder_disks
, list
)
1148 if (holder
->disk
== disk
)
1153 static int add_symlink(struct kobject
*from
, struct kobject
*to
)
1155 return sysfs_create_link(from
, to
, kobject_name(to
));
1158 static void del_symlink(struct kobject
*from
, struct kobject
*to
)
1160 sysfs_remove_link(from
, kobject_name(to
));
1164 * bd_link_disk_holder - create symlinks between holding disk and slave bdev
1165 * @bdev: the claimed slave bdev
1166 * @disk: the holding disk
1168 * DON'T USE THIS UNLESS YOU'RE ALREADY USING IT.
1170 * This functions creates the following sysfs symlinks.
1172 * - from "slaves" directory of the holder @disk to the claimed @bdev
1173 * - from "holders" directory of the @bdev to the holder @disk
1175 * For example, if /dev/dm-0 maps to /dev/sda and disk for dm-0 is
1176 * passed to bd_link_disk_holder(), then:
1178 * /sys/block/dm-0/slaves/sda --> /sys/block/sda
1179 * /sys/block/sda/holders/dm-0 --> /sys/block/dm-0
1181 * The caller must have claimed @bdev before calling this function and
1182 * ensure that both @bdev and @disk are valid during the creation and
1183 * lifetime of these symlinks.
1189 * 0 on success, -errno on failure.
1191 int bd_link_disk_holder(struct block_device
*bdev
, struct gendisk
*disk
)
1193 struct bd_holder_disk
*holder
;
1196 mutex_lock(&bdev
->bd_mutex
);
1198 WARN_ON_ONCE(!bdev
->bd_holder
);
1200 /* FIXME: remove the following once add_disk() handles errors */
1201 if (WARN_ON(!disk
->slave_dir
|| !bdev
->bd_part
->holder_dir
))
1204 holder
= bd_find_holder_disk(bdev
, disk
);
1210 holder
= kzalloc(sizeof(*holder
), GFP_KERNEL
);
1216 INIT_LIST_HEAD(&holder
->list
);
1217 holder
->disk
= disk
;
1220 ret
= add_symlink(disk
->slave_dir
, &part_to_dev(bdev
->bd_part
)->kobj
);
1224 ret
= add_symlink(bdev
->bd_part
->holder_dir
, &disk_to_dev(disk
)->kobj
);
1228 * bdev could be deleted beneath us which would implicitly destroy
1229 * the holder directory. Hold on to it.
1231 kobject_get(bdev
->bd_part
->holder_dir
);
1233 list_add(&holder
->list
, &bdev
->bd_holder_disks
);
1237 del_symlink(disk
->slave_dir
, &part_to_dev(bdev
->bd_part
)->kobj
);
1241 mutex_unlock(&bdev
->bd_mutex
);
1244 EXPORT_SYMBOL_GPL(bd_link_disk_holder
);
1247 * bd_unlink_disk_holder - destroy symlinks created by bd_link_disk_holder()
1248 * @bdev: the calimed slave bdev
1249 * @disk: the holding disk
1251 * DON'T USE THIS UNLESS YOU'RE ALREADY USING IT.
1256 void bd_unlink_disk_holder(struct block_device
*bdev
, struct gendisk
*disk
)
1258 struct bd_holder_disk
*holder
;
1260 mutex_lock(&bdev
->bd_mutex
);
1262 holder
= bd_find_holder_disk(bdev
, disk
);
1264 if (!WARN_ON_ONCE(holder
== NULL
) && !--holder
->refcnt
) {
1265 del_symlink(disk
->slave_dir
, &part_to_dev(bdev
->bd_part
)->kobj
);
1266 del_symlink(bdev
->bd_part
->holder_dir
,
1267 &disk_to_dev(disk
)->kobj
);
1268 kobject_put(bdev
->bd_part
->holder_dir
);
1269 list_del_init(&holder
->list
);
1273 mutex_unlock(&bdev
->bd_mutex
);
1275 EXPORT_SYMBOL_GPL(bd_unlink_disk_holder
);
1279 * check_disk_size_change - checks for disk size change and adjusts bdev size.
1280 * @disk: struct gendisk to check
1281 * @bdev: struct bdev to adjust.
1282 * @verbose: if %true log a message about a size change if there is any
1284 * This routine checks to see if the bdev size does not match the disk size
1285 * and adjusts it if it differs. When shrinking the bdev size, its all caches
1288 static void check_disk_size_change(struct gendisk
*disk
,
1289 struct block_device
*bdev
, bool verbose
)
1291 loff_t disk_size
, bdev_size
;
1293 disk_size
= (loff_t
)get_capacity(disk
) << 9;
1294 bdev_size
= i_size_read(bdev
->bd_inode
);
1295 if (disk_size
!= bdev_size
) {
1298 "%s: detected capacity change from %lld to %lld\n",
1299 disk
->disk_name
, bdev_size
, disk_size
);
1301 i_size_write(bdev
->bd_inode
, disk_size
);
1302 if (bdev_size
> disk_size
&& __invalidate_device(bdev
, false))
1303 pr_warn("VFS: busy inodes on resized disk %s\n",
1306 bdev
->bd_invalidated
= 0;
1310 * revalidate_disk - wrapper for lower-level driver's revalidate_disk call-back
1311 * @disk: struct gendisk to be revalidated
1313 * This routine is a wrapper for lower-level driver's revalidate_disk
1314 * call-backs. It is used to do common pre and post operations needed
1315 * for all revalidate_disk operations.
1317 int revalidate_disk(struct gendisk
*disk
)
1321 if (disk
->fops
->revalidate_disk
)
1322 ret
= disk
->fops
->revalidate_disk(disk
);
1325 * Hidden disks don't have associated bdev so there's no point in
1328 if (!(disk
->flags
& GENHD_FL_HIDDEN
)) {
1329 struct block_device
*bdev
= bdget_disk(disk
, 0);
1334 mutex_lock(&bdev
->bd_mutex
);
1335 check_disk_size_change(disk
, bdev
, ret
== 0);
1336 mutex_unlock(&bdev
->bd_mutex
);
1341 EXPORT_SYMBOL(revalidate_disk
);
1344 * This routine checks whether a removable media has been changed,
1345 * and invalidates all buffer-cache-entries in that case. This
1346 * is a relatively slow routine, so we have to try to minimize using
1347 * it. Thus it is called only upon a 'mount' or 'open'. This
1348 * is the best way of combining speed and utility, I think.
1349 * People changing diskettes in the middle of an operation deserve
1352 int check_disk_change(struct block_device
*bdev
)
1354 struct gendisk
*disk
= bdev
->bd_disk
;
1355 const struct block_device_operations
*bdops
= disk
->fops
;
1356 unsigned int events
;
1358 events
= disk_clear_events(disk
, DISK_EVENT_MEDIA_CHANGE
|
1359 DISK_EVENT_EJECT_REQUEST
);
1360 if (!(events
& DISK_EVENT_MEDIA_CHANGE
))
1363 if (__invalidate_device(bdev
, true))
1364 pr_warn("VFS: busy inodes on changed media %s\n",
1366 bdev
->bd_invalidated
= 1;
1367 if (bdops
->revalidate_disk
)
1368 bdops
->revalidate_disk(bdev
->bd_disk
);
1372 EXPORT_SYMBOL(check_disk_change
);
1374 void bd_set_size(struct block_device
*bdev
, loff_t size
)
1376 inode_lock(bdev
->bd_inode
);
1377 i_size_write(bdev
->bd_inode
, size
);
1378 inode_unlock(bdev
->bd_inode
);
1380 EXPORT_SYMBOL(bd_set_size
);
1382 static void __blkdev_put(struct block_device
*bdev
, fmode_t mode
, int for_part
);
1384 int bdev_disk_changed(struct block_device
*bdev
, bool invalidate
)
1386 struct gendisk
*disk
= bdev
->bd_disk
;
1389 lockdep_assert_held(&bdev
->bd_mutex
);
1392 ret
= blk_drop_partitions(bdev
);
1397 * Historically we only set the capacity to zero for devices that
1398 * support partitions (independ of actually having partitions created).
1399 * Doing that is rather inconsistent, but changing it broke legacy
1400 * udisks polling for legacy ide-cdrom devices. Use the crude check
1401 * below to get the sane behavior for most device while not breaking
1402 * userspace for this particular setup.
1405 if (disk_part_scan_enabled(disk
) ||
1406 !(disk
->flags
& GENHD_FL_REMOVABLE
))
1407 set_capacity(disk
, 0);
1409 if (disk
->fops
->revalidate_disk
)
1410 disk
->fops
->revalidate_disk(disk
);
1413 check_disk_size_change(disk
, bdev
, !invalidate
);
1415 if (get_capacity(disk
)) {
1416 ret
= blk_add_partitions(disk
, bdev
);
1419 } else if (invalidate
) {
1421 * Tell userspace that the media / partition table may have
1424 kobject_uevent(&disk_to_dev(disk
)->kobj
, KOBJ_CHANGE
);
1430 * Only exported for for loop and dasd for historic reasons. Don't use in new
1433 EXPORT_SYMBOL_GPL(bdev_disk_changed
);
1438 * mutex_lock(part->bd_mutex)
1439 * mutex_lock_nested(whole->bd_mutex, 1)
1442 static int __blkdev_get(struct block_device
*bdev
, fmode_t mode
, void *holder
,
1445 struct block_device
*whole
= NULL
, *claiming
= NULL
;
1446 struct gendisk
*disk
;
1450 bool first_open
= false, unblock_events
= true, need_restart
;
1452 if (mode
& FMODE_READ
)
1454 if (mode
& FMODE_WRITE
)
1457 * hooks: /n/, see "layering violations".
1460 ret
= devcgroup_inode_permission(bdev
->bd_inode
, perm
);
1466 need_restart
= false;
1468 disk
= bdev_get_gendisk(bdev
, &partno
);
1473 whole
= bdget_disk(disk
, 0);
1480 if (!for_part
&& (mode
& FMODE_EXCL
)) {
1481 WARN_ON_ONCE(!holder
);
1486 ret
= bd_prepare_to_claim(bdev
, claiming
, holder
);
1491 disk_block_events(disk
);
1492 mutex_lock_nested(&bdev
->bd_mutex
, for_part
);
1493 if (!bdev
->bd_openers
) {
1495 bdev
->bd_disk
= disk
;
1496 bdev
->bd_contains
= bdev
;
1497 bdev
->bd_partno
= partno
;
1501 bdev
->bd_part
= disk_get_part(disk
, partno
);
1506 if (disk
->fops
->open
) {
1507 ret
= disk
->fops
->open(bdev
, mode
);
1509 * If we lost a race with 'disk' being deleted,
1510 * try again. See md.c
1512 if (ret
== -ERESTARTSYS
)
1513 need_restart
= true;
1517 bd_set_size(bdev
,(loff_t
)get_capacity(disk
)<<9);
1518 set_init_blocksize(bdev
);
1522 * If the device is invalidated, rescan partition
1523 * if open succeeded or failed with -ENOMEDIUM.
1524 * The latter is necessary to prevent ghost
1525 * partitions on a removed medium.
1527 if (bdev
->bd_invalidated
&&
1528 (!ret
|| ret
== -ENOMEDIUM
))
1529 bdev_disk_changed(bdev
, ret
== -ENOMEDIUM
);
1535 ret
= __blkdev_get(whole
, mode
, NULL
, 1);
1538 bdev
->bd_contains
= bdgrab(whole
);
1539 bdev
->bd_part
= disk_get_part(disk
, partno
);
1540 if (!(disk
->flags
& GENHD_FL_UP
) ||
1541 !bdev
->bd_part
|| !bdev
->bd_part
->nr_sects
) {
1545 bd_set_size(bdev
, (loff_t
)bdev
->bd_part
->nr_sects
<< 9);
1546 set_init_blocksize(bdev
);
1549 if (bdev
->bd_bdi
== &noop_backing_dev_info
)
1550 bdev
->bd_bdi
= bdi_get(disk
->queue
->backing_dev_info
);
1552 if (bdev
->bd_contains
== bdev
) {
1554 if (bdev
->bd_disk
->fops
->open
)
1555 ret
= bdev
->bd_disk
->fops
->open(bdev
, mode
);
1556 /* the same as first opener case, read comment there */
1557 if (bdev
->bd_invalidated
&&
1558 (!ret
|| ret
== -ENOMEDIUM
))
1559 bdev_disk_changed(bdev
, ret
== -ENOMEDIUM
);
1561 goto out_unlock_bdev
;
1566 bdev
->bd_part_count
++;
1568 bd_finish_claiming(bdev
, claiming
, holder
);
1571 * Block event polling for write claims if requested. Any write holder
1572 * makes the write_holder state stick until all are released. This is
1573 * good enough and tracking individual writeable reference is too
1574 * fragile given the way @mode is used in blkdev_get/put().
1576 if (claiming
&& (mode
& FMODE_WRITE
) && !bdev
->bd_write_holder
&&
1577 (disk
->flags
& GENHD_FL_BLOCK_EVENTS_ON_EXCL_WRITE
)) {
1578 bdev
->bd_write_holder
= true;
1579 unblock_events
= false;
1581 mutex_unlock(&bdev
->bd_mutex
);
1584 disk_unblock_events(disk
);
1586 /* only one opener holds refs to the module and disk */
1588 put_disk_and_module(disk
);
1594 disk_put_part(bdev
->bd_part
);
1595 bdev
->bd_disk
= NULL
;
1596 bdev
->bd_part
= NULL
;
1597 if (bdev
!= bdev
->bd_contains
)
1598 __blkdev_put(bdev
->bd_contains
, mode
, 1);
1599 bdev
->bd_contains
= NULL
;
1602 bd_abort_claiming(bdev
, claiming
, holder
);
1603 mutex_unlock(&bdev
->bd_mutex
);
1604 disk_unblock_events(disk
);
1609 put_disk_and_module(disk
);
1617 * blkdev_get - open a block device
1618 * @bdev: block_device to open
1619 * @mode: FMODE_* mask
1620 * @holder: exclusive holder identifier
1622 * Open @bdev with @mode. If @mode includes %FMODE_EXCL, @bdev is
1623 * open with exclusive access. Specifying %FMODE_EXCL with %NULL
1624 * @holder is invalid. Exclusive opens may nest for the same @holder.
1626 * On success, the reference count of @bdev is unchanged. On failure,
1633 * 0 on success, -errno on failure.
1635 int blkdev_get(struct block_device
*bdev
, fmode_t mode
, void *holder
)
1639 res
=__blkdev_get(bdev
, mode
, holder
, 0);
1644 EXPORT_SYMBOL(blkdev_get
);
1647 * blkdev_get_by_path - open a block device by name
1648 * @path: path to the block device to open
1649 * @mode: FMODE_* mask
1650 * @holder: exclusive holder identifier
1652 * Open the blockdevice described by the device file at @path. @mode
1653 * and @holder are identical to blkdev_get().
1655 * On success, the returned block_device has reference count of one.
1661 * Pointer to block_device on success, ERR_PTR(-errno) on failure.
1663 struct block_device
*blkdev_get_by_path(const char *path
, fmode_t mode
,
1666 struct block_device
*bdev
;
1669 bdev
= lookup_bdev(path
);
1673 err
= blkdev_get(bdev
, mode
, holder
);
1675 return ERR_PTR(err
);
1677 if ((mode
& FMODE_WRITE
) && bdev_read_only(bdev
)) {
1678 blkdev_put(bdev
, mode
);
1679 return ERR_PTR(-EACCES
);
1684 EXPORT_SYMBOL(blkdev_get_by_path
);
1687 * blkdev_get_by_dev - open a block device by device number
1688 * @dev: device number of block device to open
1689 * @mode: FMODE_* mask
1690 * @holder: exclusive holder identifier
1692 * Open the blockdevice described by device number @dev. @mode and
1693 * @holder are identical to blkdev_get().
1695 * Use it ONLY if you really do not have anything better - i.e. when
1696 * you are behind a truly sucky interface and all you are given is a
1697 * device number. _Never_ to be used for internal purposes. If you
1698 * ever need it - reconsider your API.
1700 * On success, the returned block_device has reference count of one.
1706 * Pointer to block_device on success, ERR_PTR(-errno) on failure.
1708 struct block_device
*blkdev_get_by_dev(dev_t dev
, fmode_t mode
, void *holder
)
1710 struct block_device
*bdev
;
1715 return ERR_PTR(-ENOMEM
);
1717 err
= blkdev_get(bdev
, mode
, holder
);
1719 return ERR_PTR(err
);
1723 EXPORT_SYMBOL(blkdev_get_by_dev
);
1725 static int blkdev_open(struct inode
* inode
, struct file
* filp
)
1727 struct block_device
*bdev
;
1730 * Preserve backwards compatibility and allow large file access
1731 * even if userspace doesn't ask for it explicitly. Some mkfs
1732 * binary needs it. We might want to drop this workaround
1733 * during an unstable branch.
1735 filp
->f_flags
|= O_LARGEFILE
;
1737 filp
->f_mode
|= FMODE_NOWAIT
| FMODE_BUF_RASYNC
;
1739 if (filp
->f_flags
& O_NDELAY
)
1740 filp
->f_mode
|= FMODE_NDELAY
;
1741 if (filp
->f_flags
& O_EXCL
)
1742 filp
->f_mode
|= FMODE_EXCL
;
1743 if ((filp
->f_flags
& O_ACCMODE
) == 3)
1744 filp
->f_mode
|= FMODE_WRITE_IOCTL
;
1746 bdev
= bd_acquire(inode
);
1750 filp
->f_mapping
= bdev
->bd_inode
->i_mapping
;
1751 filp
->f_wb_err
= filemap_sample_wb_err(filp
->f_mapping
);
1753 return blkdev_get(bdev
, filp
->f_mode
, filp
);
1756 static void __blkdev_put(struct block_device
*bdev
, fmode_t mode
, int for_part
)
1758 struct gendisk
*disk
= bdev
->bd_disk
;
1759 struct block_device
*victim
= NULL
;
1762 * Sync early if it looks like we're the last one. If someone else
1763 * opens the block device between now and the decrement of bd_openers
1764 * then we did a sync that we didn't need to, but that's not the end
1765 * of the world and we want to avoid long (could be several minute)
1766 * syncs while holding the mutex.
1768 if (bdev
->bd_openers
== 1)
1769 sync_blockdev(bdev
);
1771 mutex_lock_nested(&bdev
->bd_mutex
, for_part
);
1773 bdev
->bd_part_count
--;
1775 if (!--bdev
->bd_openers
) {
1776 WARN_ON_ONCE(bdev
->bd_holders
);
1777 sync_blockdev(bdev
);
1780 bdev_write_inode(bdev
);
1782 if (bdev
->bd_contains
== bdev
) {
1783 if (disk
->fops
->release
)
1784 disk
->fops
->release(disk
, mode
);
1786 if (!bdev
->bd_openers
) {
1787 disk_put_part(bdev
->bd_part
);
1788 bdev
->bd_part
= NULL
;
1789 bdev
->bd_disk
= NULL
;
1790 if (bdev
!= bdev
->bd_contains
)
1791 victim
= bdev
->bd_contains
;
1792 bdev
->bd_contains
= NULL
;
1794 put_disk_and_module(disk
);
1796 mutex_unlock(&bdev
->bd_mutex
);
1799 __blkdev_put(victim
, mode
, 1);
1802 void blkdev_put(struct block_device
*bdev
, fmode_t mode
)
1804 mutex_lock(&bdev
->bd_mutex
);
1806 if (mode
& FMODE_EXCL
) {
1810 * Release a claim on the device. The holder fields
1811 * are protected with bdev_lock. bd_mutex is to
1812 * synchronize disk_holder unlinking.
1814 spin_lock(&bdev_lock
);
1816 WARN_ON_ONCE(--bdev
->bd_holders
< 0);
1817 WARN_ON_ONCE(--bdev
->bd_contains
->bd_holders
< 0);
1819 /* bd_contains might point to self, check in a separate step */
1820 if ((bdev_free
= !bdev
->bd_holders
))
1821 bdev
->bd_holder
= NULL
;
1822 if (!bdev
->bd_contains
->bd_holders
)
1823 bdev
->bd_contains
->bd_holder
= NULL
;
1825 spin_unlock(&bdev_lock
);
1828 * If this was the last claim, remove holder link and
1829 * unblock evpoll if it was a write holder.
1831 if (bdev_free
&& bdev
->bd_write_holder
) {
1832 disk_unblock_events(bdev
->bd_disk
);
1833 bdev
->bd_write_holder
= false;
1838 * Trigger event checking and tell drivers to flush MEDIA_CHANGE
1839 * event. This is to ensure detection of media removal commanded
1840 * from userland - e.g. eject(1).
1842 disk_flush_events(bdev
->bd_disk
, DISK_EVENT_MEDIA_CHANGE
);
1844 mutex_unlock(&bdev
->bd_mutex
);
1846 __blkdev_put(bdev
, mode
, 0);
1848 EXPORT_SYMBOL(blkdev_put
);
1850 static int blkdev_close(struct inode
* inode
, struct file
* filp
)
1852 struct block_device
*bdev
= I_BDEV(bdev_file_inode(filp
));
1853 blkdev_put(bdev
, filp
->f_mode
);
1857 static long block_ioctl(struct file
*file
, unsigned cmd
, unsigned long arg
)
1859 struct block_device
*bdev
= I_BDEV(bdev_file_inode(file
));
1860 fmode_t mode
= file
->f_mode
;
1863 * O_NDELAY can be altered using fcntl(.., F_SETFL, ..), so we have
1864 * to updated it before every ioctl.
1866 if (file
->f_flags
& O_NDELAY
)
1867 mode
|= FMODE_NDELAY
;
1869 mode
&= ~FMODE_NDELAY
;
1871 return blkdev_ioctl(bdev
, mode
, cmd
, arg
);
1875 * Write data to the block device. Only intended for the block device itself
1876 * and the raw driver which basically is a fake block device.
1878 * Does not take i_mutex for the write and thus is not for general purpose
1881 ssize_t
blkdev_write_iter(struct kiocb
*iocb
, struct iov_iter
*from
)
1883 struct file
*file
= iocb
->ki_filp
;
1884 struct inode
*bd_inode
= bdev_file_inode(file
);
1885 loff_t size
= i_size_read(bd_inode
);
1886 struct blk_plug plug
;
1889 if (bdev_read_only(I_BDEV(bd_inode
)))
1892 if (IS_SWAPFILE(bd_inode
) && !is_hibernate_resume_dev(bd_inode
))
1895 if (!iov_iter_count(from
))
1898 if (iocb
->ki_pos
>= size
)
1901 if ((iocb
->ki_flags
& (IOCB_NOWAIT
| IOCB_DIRECT
)) == IOCB_NOWAIT
)
1904 iov_iter_truncate(from
, size
- iocb
->ki_pos
);
1906 blk_start_plug(&plug
);
1907 ret
= __generic_file_write_iter(iocb
, from
);
1909 ret
= generic_write_sync(iocb
, ret
);
1910 blk_finish_plug(&plug
);
1913 EXPORT_SYMBOL_GPL(blkdev_write_iter
);
1915 ssize_t
blkdev_read_iter(struct kiocb
*iocb
, struct iov_iter
*to
)
1917 struct file
*file
= iocb
->ki_filp
;
1918 struct inode
*bd_inode
= bdev_file_inode(file
);
1919 loff_t size
= i_size_read(bd_inode
);
1920 loff_t pos
= iocb
->ki_pos
;
1926 iov_iter_truncate(to
, size
);
1927 return generic_file_read_iter(iocb
, to
);
1929 EXPORT_SYMBOL_GPL(blkdev_read_iter
);
1932 * Try to release a page associated with block device when the system
1933 * is under memory pressure.
1935 static int blkdev_releasepage(struct page
*page
, gfp_t wait
)
1937 struct super_block
*super
= BDEV_I(page
->mapping
->host
)->bdev
.bd_super
;
1939 if (super
&& super
->s_op
->bdev_try_to_free_page
)
1940 return super
->s_op
->bdev_try_to_free_page(super
, page
, wait
);
1942 return try_to_free_buffers(page
);
1945 static int blkdev_writepages(struct address_space
*mapping
,
1946 struct writeback_control
*wbc
)
1948 return generic_writepages(mapping
, wbc
);
1951 static const struct address_space_operations def_blk_aops
= {
1952 .readpage
= blkdev_readpage
,
1953 .readahead
= blkdev_readahead
,
1954 .writepage
= blkdev_writepage
,
1955 .write_begin
= blkdev_write_begin
,
1956 .write_end
= blkdev_write_end
,
1957 .writepages
= blkdev_writepages
,
1958 .releasepage
= blkdev_releasepage
,
1959 .direct_IO
= blkdev_direct_IO
,
1960 .migratepage
= buffer_migrate_page_norefs
,
1961 .is_dirty_writeback
= buffer_check_dirty_writeback
,
1964 #define BLKDEV_FALLOC_FL_SUPPORTED \
1965 (FALLOC_FL_KEEP_SIZE | FALLOC_FL_PUNCH_HOLE | \
1966 FALLOC_FL_ZERO_RANGE | FALLOC_FL_NO_HIDE_STALE)
1968 static long blkdev_fallocate(struct file
*file
, int mode
, loff_t start
,
1971 struct block_device
*bdev
= I_BDEV(bdev_file_inode(file
));
1972 struct address_space
*mapping
;
1973 loff_t end
= start
+ len
- 1;
1977 /* Fail if we don't recognize the flags. */
1978 if (mode
& ~BLKDEV_FALLOC_FL_SUPPORTED
)
1981 /* Don't go off the end of the device. */
1982 isize
= i_size_read(bdev
->bd_inode
);
1986 if (mode
& FALLOC_FL_KEEP_SIZE
) {
1987 len
= isize
- start
;
1988 end
= start
+ len
- 1;
1994 * Don't allow IO that isn't aligned to logical block size.
1996 if ((start
| len
) & (bdev_logical_block_size(bdev
) - 1))
1999 /* Invalidate the page cache, including dirty pages. */
2000 mapping
= bdev
->bd_inode
->i_mapping
;
2001 truncate_inode_pages_range(mapping
, start
, end
);
2004 case FALLOC_FL_ZERO_RANGE
:
2005 case FALLOC_FL_ZERO_RANGE
| FALLOC_FL_KEEP_SIZE
:
2006 error
= blkdev_issue_zeroout(bdev
, start
>> 9, len
>> 9,
2007 GFP_KERNEL
, BLKDEV_ZERO_NOUNMAP
);
2009 case FALLOC_FL_PUNCH_HOLE
| FALLOC_FL_KEEP_SIZE
:
2010 error
= blkdev_issue_zeroout(bdev
, start
>> 9, len
>> 9,
2011 GFP_KERNEL
, BLKDEV_ZERO_NOFALLBACK
);
2013 case FALLOC_FL_PUNCH_HOLE
| FALLOC_FL_KEEP_SIZE
| FALLOC_FL_NO_HIDE_STALE
:
2014 error
= blkdev_issue_discard(bdev
, start
>> 9, len
>> 9,
2024 * Invalidate again; if someone wandered in and dirtied a page,
2025 * the caller will be given -EBUSY. The third argument is
2026 * inclusive, so the rounding here is safe.
2028 return invalidate_inode_pages2_range(mapping
,
2029 start
>> PAGE_SHIFT
,
2033 const struct file_operations def_blk_fops
= {
2034 .open
= blkdev_open
,
2035 .release
= blkdev_close
,
2036 .llseek
= block_llseek
,
2037 .read_iter
= blkdev_read_iter
,
2038 .write_iter
= blkdev_write_iter
,
2039 .iopoll
= blkdev_iopoll
,
2040 .mmap
= generic_file_mmap
,
2041 .fsync
= blkdev_fsync
,
2042 .unlocked_ioctl
= block_ioctl
,
2043 #ifdef CONFIG_COMPAT
2044 .compat_ioctl
= compat_blkdev_ioctl
,
2046 .splice_read
= generic_file_splice_read
,
2047 .splice_write
= iter_file_splice_write
,
2048 .fallocate
= blkdev_fallocate
,
2052 * lookup_bdev - lookup a struct block_device by name
2053 * @pathname: special file representing the block device
2055 * Get a reference to the blockdevice at @pathname in the current
2056 * namespace if possible and return it. Return ERR_PTR(error)
2059 struct block_device
*lookup_bdev(const char *pathname
)
2061 struct block_device
*bdev
;
2062 struct inode
*inode
;
2066 if (!pathname
|| !*pathname
)
2067 return ERR_PTR(-EINVAL
);
2069 error
= kern_path(pathname
, LOOKUP_FOLLOW
, &path
);
2071 return ERR_PTR(error
);
2073 inode
= d_backing_inode(path
.dentry
);
2075 if (!S_ISBLK(inode
->i_mode
))
2078 if (!may_open_dev(&path
))
2081 bdev
= bd_acquire(inode
);
2088 bdev
= ERR_PTR(error
);
2091 EXPORT_SYMBOL(lookup_bdev
);
2093 int __invalidate_device(struct block_device
*bdev
, bool kill_dirty
)
2095 struct super_block
*sb
= get_super(bdev
);
2100 * no need to lock the super, get_super holds the
2101 * read mutex so the filesystem cannot go away
2102 * under us (->put_super runs with the write lock
2105 shrink_dcache_sb(sb
);
2106 res
= invalidate_inodes(sb
, kill_dirty
);
2109 invalidate_bdev(bdev
);
2112 EXPORT_SYMBOL(__invalidate_device
);
2114 void iterate_bdevs(void (*func
)(struct block_device
*, void *), void *arg
)
2116 struct inode
*inode
, *old_inode
= NULL
;
2118 spin_lock(&blockdev_superblock
->s_inode_list_lock
);
2119 list_for_each_entry(inode
, &blockdev_superblock
->s_inodes
, i_sb_list
) {
2120 struct address_space
*mapping
= inode
->i_mapping
;
2121 struct block_device
*bdev
;
2123 spin_lock(&inode
->i_lock
);
2124 if (inode
->i_state
& (I_FREEING
|I_WILL_FREE
|I_NEW
) ||
2125 mapping
->nrpages
== 0) {
2126 spin_unlock(&inode
->i_lock
);
2130 spin_unlock(&inode
->i_lock
);
2131 spin_unlock(&blockdev_superblock
->s_inode_list_lock
);
2133 * We hold a reference to 'inode' so it couldn't have been
2134 * removed from s_inodes list while we dropped the
2135 * s_inode_list_lock We cannot iput the inode now as we can
2136 * be holding the last reference and we cannot iput it under
2137 * s_inode_list_lock. So we keep the reference and iput it
2142 bdev
= I_BDEV(inode
);
2144 mutex_lock(&bdev
->bd_mutex
);
2145 if (bdev
->bd_openers
)
2147 mutex_unlock(&bdev
->bd_mutex
);
2149 spin_lock(&blockdev_superblock
->s_inode_list_lock
);
2151 spin_unlock(&blockdev_superblock
->s_inode_list_lock
);