4 * Copyright (C) 1991, 1992 Linus Torvalds
5 * Copyright (C) 2001 Andrea Arcangeli <andrea@suse.de> SuSE
8 #include <linux/init.h>
10 #include <linux/fcntl.h>
11 #include <linux/slab.h>
12 #include <linux/kmod.h>
13 #include <linux/major.h>
14 #include <linux/device_cgroup.h>
15 #include <linux/highmem.h>
16 #include <linux/blkdev.h>
17 #include <linux/backing-dev.h>
18 #include <linux/module.h>
19 #include <linux/blkpg.h>
20 #include <linux/magic.h>
21 #include <linux/dax.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/uio.h>
29 #include <linux/namei.h>
30 #include <linux/log2.h>
31 #include <linux/cleancache.h>
32 #include <linux/dax.h>
33 #include <linux/badblocks.h>
34 #include <linux/task_io_accounting_ops.h>
35 #include <linux/falloc.h>
36 #include <linux/uaccess.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 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);
88 EXPORT_SYMBOL(kill_bdev
);
90 /* Invalidate clean unused buffers and pagecache. */
91 void invalidate_bdev(struct block_device
*bdev
)
93 struct address_space
*mapping
= bdev
->bd_inode
->i_mapping
;
95 if (mapping
->nrpages
) {
97 lru_add_drain_all(); /* make sure all lru add caches are flushed */
98 invalidate_mapping_pages(mapping
, 0, -1);
100 /* 99% of the time, we don't need to flush the cleancache on the bdev.
101 * But, for the strange corners, lets be cautious
103 cleancache_invalidate_inode(mapping
);
105 EXPORT_SYMBOL(invalidate_bdev
);
107 int set_blocksize(struct block_device
*bdev
, int size
)
109 /* Size must be a power of two, and between 512 and PAGE_SIZE */
110 if (size
> PAGE_SIZE
|| size
< 512 || !is_power_of_2(size
))
113 /* Size cannot be smaller than the size supported by the device */
114 if (size
< bdev_logical_block_size(bdev
))
117 /* Don't change the size if it is same as current */
118 if (bdev
->bd_block_size
!= size
) {
120 bdev
->bd_block_size
= size
;
121 bdev
->bd_inode
->i_blkbits
= blksize_bits(size
);
127 EXPORT_SYMBOL(set_blocksize
);
129 int sb_set_blocksize(struct super_block
*sb
, int size
)
131 if (set_blocksize(sb
->s_bdev
, size
))
133 /* If we get here, we know size is power of two
134 * and it's value is between 512 and PAGE_SIZE */
135 sb
->s_blocksize
= size
;
136 sb
->s_blocksize_bits
= blksize_bits(size
);
137 return sb
->s_blocksize
;
140 EXPORT_SYMBOL(sb_set_blocksize
);
142 int sb_min_blocksize(struct super_block
*sb
, int size
)
144 int minsize
= bdev_logical_block_size(sb
->s_bdev
);
147 return sb_set_blocksize(sb
, size
);
150 EXPORT_SYMBOL(sb_min_blocksize
);
153 blkdev_get_block(struct inode
*inode
, sector_t iblock
,
154 struct buffer_head
*bh
, int create
)
156 bh
->b_bdev
= I_BDEV(inode
);
157 bh
->b_blocknr
= iblock
;
158 set_buffer_mapped(bh
);
162 static struct inode
*bdev_file_inode(struct file
*file
)
164 return file
->f_mapping
->host
;
167 static unsigned int dio_bio_write_op(struct kiocb
*iocb
)
169 unsigned int op
= REQ_OP_WRITE
| REQ_SYNC
| REQ_IDLE
;
171 /* avoid the need for a I/O completion work item */
172 if (iocb
->ki_flags
& IOCB_DSYNC
)
177 #define DIO_INLINE_BIO_VECS 4
179 static void blkdev_bio_end_io_simple(struct bio
*bio
)
181 struct task_struct
*waiter
= bio
->bi_private
;
183 WRITE_ONCE(bio
->bi_private
, NULL
);
184 wake_up_process(waiter
);
188 __blkdev_direct_IO_simple(struct kiocb
*iocb
, struct iov_iter
*iter
,
191 struct file
*file
= iocb
->ki_filp
;
192 struct block_device
*bdev
= I_BDEV(bdev_file_inode(file
));
193 struct bio_vec inline_vecs
[DIO_INLINE_BIO_VECS
], *vecs
, *bvec
;
194 loff_t pos
= iocb
->ki_pos
;
195 bool should_dirty
= false;
201 if ((pos
| iov_iter_alignment(iter
)) &
202 (bdev_logical_block_size(bdev
) - 1))
205 if (nr_pages
<= DIO_INLINE_BIO_VECS
)
208 vecs
= kmalloc_array(nr_pages
, sizeof(struct bio_vec
),
214 bio_init(&bio
, vecs
, nr_pages
);
215 bio_set_dev(&bio
, bdev
);
216 bio
.bi_iter
.bi_sector
= pos
>> 9;
217 bio
.bi_write_hint
= iocb
->ki_hint
;
218 bio
.bi_private
= current
;
219 bio
.bi_end_io
= blkdev_bio_end_io_simple
;
220 bio
.bi_ioprio
= iocb
->ki_ioprio
;
222 ret
= bio_iov_iter_get_pages(&bio
, iter
);
225 ret
= bio
.bi_iter
.bi_size
;
227 if (iov_iter_rw(iter
) == READ
) {
228 bio
.bi_opf
= REQ_OP_READ
;
229 if (iter_is_iovec(iter
))
232 bio
.bi_opf
= dio_bio_write_op(iocb
);
233 task_io_account_write(ret
);
236 qc
= submit_bio(&bio
);
238 set_current_state(TASK_UNINTERRUPTIBLE
);
239 if (!READ_ONCE(bio
.bi_private
))
241 if (!(iocb
->ki_flags
& IOCB_HIPRI
) ||
242 !blk_poll(bdev_get_queue(bdev
), qc
))
245 __set_current_state(TASK_RUNNING
);
247 bio_for_each_segment_all(bvec
, &bio
, i
) {
248 if (should_dirty
&& !PageCompound(bvec
->bv_page
))
249 set_page_dirty_lock(bvec
->bv_page
);
250 put_page(bvec
->bv_page
);
253 if (vecs
!= inline_vecs
)
256 if (unlikely(bio
.bi_status
))
257 ret
= blk_status_to_errno(bio
.bi_status
);
267 struct task_struct
*waiter
;
272 bool should_dirty
: 1;
277 static struct bio_set blkdev_dio_pool
;
279 static void blkdev_bio_end_io(struct bio
*bio
)
281 struct blkdev_dio
*dio
= bio
->bi_private
;
282 bool should_dirty
= dio
->should_dirty
;
284 if (dio
->multi_bio
&& !atomic_dec_and_test(&dio
->ref
)) {
285 if (bio
->bi_status
&& !dio
->bio
.bi_status
)
286 dio
->bio
.bi_status
= bio
->bi_status
;
289 struct kiocb
*iocb
= dio
->iocb
;
292 if (likely(!dio
->bio
.bi_status
)) {
296 ret
= blk_status_to_errno(dio
->bio
.bi_status
);
299 dio
->iocb
->ki_complete(iocb
, ret
, 0);
302 struct task_struct
*waiter
= dio
->waiter
;
304 WRITE_ONCE(dio
->waiter
, NULL
);
305 wake_up_process(waiter
);
310 bio_check_pages_dirty(bio
);
312 struct bio_vec
*bvec
;
315 bio_for_each_segment_all(bvec
, bio
, i
)
316 put_page(bvec
->bv_page
);
322 __blkdev_direct_IO(struct kiocb
*iocb
, struct iov_iter
*iter
, int nr_pages
)
324 struct file
*file
= iocb
->ki_filp
;
325 struct inode
*inode
= bdev_file_inode(file
);
326 struct block_device
*bdev
= I_BDEV(inode
);
327 struct blk_plug plug
;
328 struct blkdev_dio
*dio
;
330 bool is_read
= (iov_iter_rw(iter
) == READ
), is_sync
;
331 loff_t pos
= iocb
->ki_pos
;
332 blk_qc_t qc
= BLK_QC_T_NONE
;
335 if ((pos
| iov_iter_alignment(iter
)) &
336 (bdev_logical_block_size(bdev
) - 1))
339 bio
= bio_alloc_bioset(GFP_KERNEL
, nr_pages
, &blkdev_dio_pool
);
340 bio_get(bio
); /* extra ref for the completion handler */
342 dio
= container_of(bio
, struct blkdev_dio
, bio
);
343 dio
->is_sync
= is_sync
= is_sync_kiocb(iocb
);
345 dio
->waiter
= current
;
350 dio
->multi_bio
= false;
351 dio
->should_dirty
= is_read
&& (iter
->type
== ITER_IOVEC
);
353 blk_start_plug(&plug
);
355 bio_set_dev(bio
, bdev
);
356 bio
->bi_iter
.bi_sector
= pos
>> 9;
357 bio
->bi_write_hint
= iocb
->ki_hint
;
358 bio
->bi_private
= dio
;
359 bio
->bi_end_io
= blkdev_bio_end_io
;
360 bio
->bi_ioprio
= iocb
->ki_ioprio
;
362 ret
= bio_iov_iter_get_pages(bio
, iter
);
364 bio
->bi_status
= BLK_STS_IOERR
;
370 bio
->bi_opf
= REQ_OP_READ
;
371 if (dio
->should_dirty
)
372 bio_set_pages_dirty(bio
);
374 bio
->bi_opf
= dio_bio_write_op(iocb
);
375 task_io_account_write(bio
->bi_iter
.bi_size
);
378 dio
->size
+= bio
->bi_iter
.bi_size
;
379 pos
+= bio
->bi_iter
.bi_size
;
381 nr_pages
= iov_iter_npages(iter
, BIO_MAX_PAGES
);
383 qc
= submit_bio(bio
);
387 if (!dio
->multi_bio
) {
388 dio
->multi_bio
= true;
389 atomic_set(&dio
->ref
, 2);
391 atomic_inc(&dio
->ref
);
395 bio
= bio_alloc(GFP_KERNEL
, nr_pages
);
397 blk_finish_plug(&plug
);
403 set_current_state(TASK_UNINTERRUPTIBLE
);
404 if (!READ_ONCE(dio
->waiter
))
407 if (!(iocb
->ki_flags
& IOCB_HIPRI
) ||
408 !blk_poll(bdev_get_queue(bdev
), qc
))
411 __set_current_state(TASK_RUNNING
);
414 ret
= blk_status_to_errno(dio
->bio
.bi_status
);
423 blkdev_direct_IO(struct kiocb
*iocb
, struct iov_iter
*iter
)
427 nr_pages
= iov_iter_npages(iter
, BIO_MAX_PAGES
+ 1);
430 if (is_sync_kiocb(iocb
) && nr_pages
<= BIO_MAX_PAGES
)
431 return __blkdev_direct_IO_simple(iocb
, iter
, nr_pages
);
433 return __blkdev_direct_IO(iocb
, iter
, min(nr_pages
, BIO_MAX_PAGES
));
436 static __init
int blkdev_init(void)
438 return bioset_init(&blkdev_dio_pool
, 4, offsetof(struct blkdev_dio
, bio
), BIOSET_NEED_BVECS
);
440 module_init(blkdev_init
);
442 int __sync_blockdev(struct block_device
*bdev
, int wait
)
447 return filemap_flush(bdev
->bd_inode
->i_mapping
);
448 return filemap_write_and_wait(bdev
->bd_inode
->i_mapping
);
452 * Write out and wait upon all the dirty data associated with a block
453 * device via its mapping. Does not take the superblock lock.
455 int sync_blockdev(struct block_device
*bdev
)
457 return __sync_blockdev(bdev
, 1);
459 EXPORT_SYMBOL(sync_blockdev
);
462 * Write out and wait upon all dirty data associated with this
463 * device. Filesystem data as well as the underlying block
464 * device. Takes the superblock lock.
466 int fsync_bdev(struct block_device
*bdev
)
468 struct super_block
*sb
= get_super(bdev
);
470 int res
= sync_filesystem(sb
);
474 return sync_blockdev(bdev
);
476 EXPORT_SYMBOL(fsync_bdev
);
479 * freeze_bdev -- lock a filesystem and force it into a consistent state
480 * @bdev: blockdevice to lock
482 * If a superblock is found on this device, we take the s_umount semaphore
483 * on it to make sure nobody unmounts until the snapshot creation is done.
484 * The reference counter (bd_fsfreeze_count) guarantees that only the last
485 * unfreeze process can unfreeze the frozen filesystem actually when multiple
486 * freeze requests arrive simultaneously. It counts up in freeze_bdev() and
487 * count down in thaw_bdev(). When it becomes 0, thaw_bdev() will unfreeze
490 struct super_block
*freeze_bdev(struct block_device
*bdev
)
492 struct super_block
*sb
;
495 mutex_lock(&bdev
->bd_fsfreeze_mutex
);
496 if (++bdev
->bd_fsfreeze_count
> 1) {
498 * We don't even need to grab a reference - the first call
499 * to freeze_bdev grab an active reference and only the last
500 * thaw_bdev drops it.
502 sb
= get_super(bdev
);
505 mutex_unlock(&bdev
->bd_fsfreeze_mutex
);
509 sb
= get_active_super(bdev
);
512 if (sb
->s_op
->freeze_super
)
513 error
= sb
->s_op
->freeze_super(sb
);
515 error
= freeze_super(sb
);
517 deactivate_super(sb
);
518 bdev
->bd_fsfreeze_count
--;
519 mutex_unlock(&bdev
->bd_fsfreeze_mutex
);
520 return ERR_PTR(error
);
522 deactivate_super(sb
);
525 mutex_unlock(&bdev
->bd_fsfreeze_mutex
);
526 return sb
; /* thaw_bdev releases s->s_umount */
528 EXPORT_SYMBOL(freeze_bdev
);
531 * thaw_bdev -- unlock filesystem
532 * @bdev: blockdevice to unlock
533 * @sb: associated superblock
535 * Unlocks the filesystem and marks it writeable again after freeze_bdev().
537 int thaw_bdev(struct block_device
*bdev
, struct super_block
*sb
)
541 mutex_lock(&bdev
->bd_fsfreeze_mutex
);
542 if (!bdev
->bd_fsfreeze_count
)
546 if (--bdev
->bd_fsfreeze_count
> 0)
552 if (sb
->s_op
->thaw_super
)
553 error
= sb
->s_op
->thaw_super(sb
);
555 error
= thaw_super(sb
);
557 bdev
->bd_fsfreeze_count
++;
559 mutex_unlock(&bdev
->bd_fsfreeze_mutex
);
562 EXPORT_SYMBOL(thaw_bdev
);
564 static int blkdev_writepage(struct page
*page
, struct writeback_control
*wbc
)
566 return block_write_full_page(page
, blkdev_get_block
, wbc
);
569 static int blkdev_readpage(struct file
* file
, struct page
* page
)
571 return block_read_full_page(page
, blkdev_get_block
);
574 static int blkdev_readpages(struct file
*file
, struct address_space
*mapping
,
575 struct list_head
*pages
, unsigned nr_pages
)
577 return mpage_readpages(mapping
, pages
, nr_pages
, blkdev_get_block
);
580 static int blkdev_write_begin(struct file
*file
, struct address_space
*mapping
,
581 loff_t pos
, unsigned len
, unsigned flags
,
582 struct page
**pagep
, void **fsdata
)
584 return block_write_begin(mapping
, pos
, len
, flags
, pagep
,
588 static int blkdev_write_end(struct file
*file
, struct address_space
*mapping
,
589 loff_t pos
, unsigned len
, unsigned copied
,
590 struct page
*page
, void *fsdata
)
593 ret
= block_write_end(file
, mapping
, pos
, len
, copied
, page
, fsdata
);
603 * for a block special file file_inode(file)->i_size is zero
604 * so we compute the size by hand (just as in block_read/write above)
606 static loff_t
block_llseek(struct file
*file
, loff_t offset
, int whence
)
608 struct inode
*bd_inode
= bdev_file_inode(file
);
611 inode_lock(bd_inode
);
612 retval
= fixed_size_llseek(file
, offset
, whence
, i_size_read(bd_inode
));
613 inode_unlock(bd_inode
);
617 int blkdev_fsync(struct file
*filp
, loff_t start
, loff_t end
, int datasync
)
619 struct inode
*bd_inode
= bdev_file_inode(filp
);
620 struct block_device
*bdev
= I_BDEV(bd_inode
);
623 error
= file_write_and_wait_range(filp
, start
, end
);
628 * There is no need to serialise calls to blkdev_issue_flush with
629 * i_mutex and doing so causes performance issues with concurrent
630 * O_SYNC writers to a block device.
632 error
= blkdev_issue_flush(bdev
, GFP_KERNEL
, NULL
);
633 if (error
== -EOPNOTSUPP
)
638 EXPORT_SYMBOL(blkdev_fsync
);
641 * bdev_read_page() - Start reading a page from a block device
642 * @bdev: The device to read the page from
643 * @sector: The offset on the device to read the page to (need not be aligned)
644 * @page: The page to read
646 * On entry, the page should be locked. It will be unlocked when the page
647 * has been read. If the block driver implements rw_page synchronously,
648 * that will be true on exit from this function, but it need not be.
650 * Errors returned by this function are usually "soft", eg out of memory, or
651 * queue full; callers should try a different route to read this page rather
652 * than propagate an error back up the stack.
654 * Return: negative errno if an error occurs, 0 if submission was successful.
656 int bdev_read_page(struct block_device
*bdev
, sector_t sector
,
659 const struct block_device_operations
*ops
= bdev
->bd_disk
->fops
;
660 int result
= -EOPNOTSUPP
;
662 if (!ops
->rw_page
|| bdev_get_integrity(bdev
))
665 result
= blk_queue_enter(bdev
->bd_queue
, 0);
668 result
= ops
->rw_page(bdev
, sector
+ get_start_sect(bdev
), page
, false);
669 blk_queue_exit(bdev
->bd_queue
);
672 EXPORT_SYMBOL_GPL(bdev_read_page
);
675 * bdev_write_page() - Start writing a page to a block device
676 * @bdev: The device to write the page to
677 * @sector: The offset on the device to write the page to (need not be aligned)
678 * @page: The page to write
679 * @wbc: The writeback_control for the write
681 * On entry, the page should be locked and not currently under writeback.
682 * On exit, if the write started successfully, the page will be unlocked and
683 * under writeback. If the write failed already (eg the driver failed to
684 * queue the page to the device), the page will still be locked. If the
685 * caller is a ->writepage implementation, it will need to unlock the page.
687 * Errors returned by this function are usually "soft", eg out of memory, or
688 * queue full; callers should try a different route to write this page rather
689 * than propagate an error back up the stack.
691 * Return: negative errno if an error occurs, 0 if submission was successful.
693 int bdev_write_page(struct block_device
*bdev
, sector_t sector
,
694 struct page
*page
, struct writeback_control
*wbc
)
697 const struct block_device_operations
*ops
= bdev
->bd_disk
->fops
;
699 if (!ops
->rw_page
|| bdev_get_integrity(bdev
))
701 result
= blk_queue_enter(bdev
->bd_queue
, 0);
705 set_page_writeback(page
);
706 result
= ops
->rw_page(bdev
, sector
+ get_start_sect(bdev
), page
, true);
708 end_page_writeback(page
);
710 clean_page_buffers(page
);
713 blk_queue_exit(bdev
->bd_queue
);
716 EXPORT_SYMBOL_GPL(bdev_write_page
);
722 static __cacheline_aligned_in_smp
DEFINE_SPINLOCK(bdev_lock
);
723 static struct kmem_cache
* bdev_cachep __read_mostly
;
725 static struct inode
*bdev_alloc_inode(struct super_block
*sb
)
727 struct bdev_inode
*ei
= kmem_cache_alloc(bdev_cachep
, GFP_KERNEL
);
730 return &ei
->vfs_inode
;
733 static void bdev_i_callback(struct rcu_head
*head
)
735 struct inode
*inode
= container_of(head
, struct inode
, i_rcu
);
736 struct bdev_inode
*bdi
= BDEV_I(inode
);
738 kmem_cache_free(bdev_cachep
, bdi
);
741 static void bdev_destroy_inode(struct inode
*inode
)
743 call_rcu(&inode
->i_rcu
, bdev_i_callback
);
746 static void init_once(void *foo
)
748 struct bdev_inode
*ei
= (struct bdev_inode
*) foo
;
749 struct block_device
*bdev
= &ei
->bdev
;
751 memset(bdev
, 0, sizeof(*bdev
));
752 mutex_init(&bdev
->bd_mutex
);
753 INIT_LIST_HEAD(&bdev
->bd_list
);
755 INIT_LIST_HEAD(&bdev
->bd_holder_disks
);
757 bdev
->bd_bdi
= &noop_backing_dev_info
;
758 inode_init_once(&ei
->vfs_inode
);
759 /* Initialize mutex for freeze. */
760 mutex_init(&bdev
->bd_fsfreeze_mutex
);
763 static void bdev_evict_inode(struct inode
*inode
)
765 struct block_device
*bdev
= &BDEV_I(inode
)->bdev
;
766 truncate_inode_pages_final(&inode
->i_data
);
767 invalidate_inode_buffers(inode
); /* is it needed here? */
769 spin_lock(&bdev_lock
);
770 list_del_init(&bdev
->bd_list
);
771 spin_unlock(&bdev_lock
);
772 /* Detach inode from wb early as bdi_put() may free bdi->wb */
773 inode_detach_wb(inode
);
774 if (bdev
->bd_bdi
!= &noop_backing_dev_info
) {
775 bdi_put(bdev
->bd_bdi
);
776 bdev
->bd_bdi
= &noop_backing_dev_info
;
780 static const struct super_operations bdev_sops
= {
781 .statfs
= simple_statfs
,
782 .alloc_inode
= bdev_alloc_inode
,
783 .destroy_inode
= bdev_destroy_inode
,
784 .drop_inode
= generic_delete_inode
,
785 .evict_inode
= bdev_evict_inode
,
788 static struct dentry
*bd_mount(struct file_system_type
*fs_type
,
789 int flags
, const char *dev_name
, void *data
)
792 dent
= mount_pseudo(fs_type
, "bdev:", &bdev_sops
, NULL
, BDEVFS_MAGIC
);
794 dent
->d_sb
->s_iflags
|= SB_I_CGROUPWB
;
798 static struct file_system_type bd_type
= {
801 .kill_sb
= kill_anon_super
,
804 struct super_block
*blockdev_superblock __read_mostly
;
805 EXPORT_SYMBOL_GPL(blockdev_superblock
);
807 void __init
bdev_cache_init(void)
810 static struct vfsmount
*bd_mnt
;
812 bdev_cachep
= kmem_cache_create("bdev_cache", sizeof(struct bdev_inode
),
813 0, (SLAB_HWCACHE_ALIGN
|SLAB_RECLAIM_ACCOUNT
|
814 SLAB_MEM_SPREAD
|SLAB_ACCOUNT
|SLAB_PANIC
),
816 err
= register_filesystem(&bd_type
);
818 panic("Cannot register bdev pseudo-fs");
819 bd_mnt
= kern_mount(&bd_type
);
821 panic("Cannot create bdev pseudo-fs");
822 blockdev_superblock
= bd_mnt
->mnt_sb
; /* For writeback */
826 * Most likely _very_ bad one - but then it's hardly critical for small
827 * /dev and can be fixed when somebody will need really large one.
828 * Keep in mind that it will be fed through icache hash function too.
830 static inline unsigned long hash(dev_t dev
)
832 return MAJOR(dev
)+MINOR(dev
);
835 static int bdev_test(struct inode
*inode
, void *data
)
837 return BDEV_I(inode
)->bdev
.bd_dev
== *(dev_t
*)data
;
840 static int bdev_set(struct inode
*inode
, void *data
)
842 BDEV_I(inode
)->bdev
.bd_dev
= *(dev_t
*)data
;
846 static LIST_HEAD(all_bdevs
);
849 * If there is a bdev inode for this device, unhash it so that it gets evicted
850 * as soon as last inode reference is dropped.
852 void bdev_unhash_inode(dev_t dev
)
856 inode
= ilookup5(blockdev_superblock
, hash(dev
), bdev_test
, &dev
);
858 remove_inode_hash(inode
);
863 struct block_device
*bdget(dev_t dev
)
865 struct block_device
*bdev
;
868 inode
= iget5_locked(blockdev_superblock
, hash(dev
),
869 bdev_test
, bdev_set
, &dev
);
874 bdev
= &BDEV_I(inode
)->bdev
;
876 if (inode
->i_state
& I_NEW
) {
877 bdev
->bd_contains
= NULL
;
878 bdev
->bd_super
= NULL
;
879 bdev
->bd_inode
= inode
;
880 bdev
->bd_block_size
= i_blocksize(inode
);
881 bdev
->bd_part_count
= 0;
882 bdev
->bd_invalidated
= 0;
883 inode
->i_mode
= S_IFBLK
;
885 inode
->i_bdev
= bdev
;
886 inode
->i_data
.a_ops
= &def_blk_aops
;
887 mapping_set_gfp_mask(&inode
->i_data
, GFP_USER
);
888 spin_lock(&bdev_lock
);
889 list_add(&bdev
->bd_list
, &all_bdevs
);
890 spin_unlock(&bdev_lock
);
891 unlock_new_inode(inode
);
896 EXPORT_SYMBOL(bdget
);
899 * bdgrab -- Grab a reference to an already referenced block device
900 * @bdev: Block device to grab a reference to.
902 struct block_device
*bdgrab(struct block_device
*bdev
)
904 ihold(bdev
->bd_inode
);
907 EXPORT_SYMBOL(bdgrab
);
909 long nr_blockdev_pages(void)
911 struct block_device
*bdev
;
913 spin_lock(&bdev_lock
);
914 list_for_each_entry(bdev
, &all_bdevs
, bd_list
) {
915 ret
+= bdev
->bd_inode
->i_mapping
->nrpages
;
917 spin_unlock(&bdev_lock
);
921 void bdput(struct block_device
*bdev
)
923 iput(bdev
->bd_inode
);
926 EXPORT_SYMBOL(bdput
);
928 static struct block_device
*bd_acquire(struct inode
*inode
)
930 struct block_device
*bdev
;
932 spin_lock(&bdev_lock
);
933 bdev
= inode
->i_bdev
;
934 if (bdev
&& !inode_unhashed(bdev
->bd_inode
)) {
936 spin_unlock(&bdev_lock
);
939 spin_unlock(&bdev_lock
);
942 * i_bdev references block device inode that was already shut down
943 * (corresponding device got removed). Remove the reference and look
944 * up block device inode again just in case new device got
945 * reestablished under the same device number.
950 bdev
= bdget(inode
->i_rdev
);
952 spin_lock(&bdev_lock
);
953 if (!inode
->i_bdev
) {
955 * We take an additional reference to bd_inode,
956 * and it's released in clear_inode() of inode.
957 * So, we can access it via ->i_mapping always
961 inode
->i_bdev
= bdev
;
962 inode
->i_mapping
= bdev
->bd_inode
->i_mapping
;
964 spin_unlock(&bdev_lock
);
969 /* Call when you free inode */
971 void bd_forget(struct inode
*inode
)
973 struct block_device
*bdev
= NULL
;
975 spin_lock(&bdev_lock
);
976 if (!sb_is_blkdev_sb(inode
->i_sb
))
977 bdev
= inode
->i_bdev
;
978 inode
->i_bdev
= NULL
;
979 inode
->i_mapping
= &inode
->i_data
;
980 spin_unlock(&bdev_lock
);
987 * bd_may_claim - test whether a block device can be claimed
988 * @bdev: block device of interest
989 * @whole: whole block device containing @bdev, may equal @bdev
990 * @holder: holder trying to claim @bdev
992 * Test whether @bdev can be claimed by @holder.
995 * spin_lock(&bdev_lock).
998 * %true if @bdev can be claimed, %false otherwise.
1000 static bool bd_may_claim(struct block_device
*bdev
, struct block_device
*whole
,
1003 if (bdev
->bd_holder
== holder
)
1004 return true; /* already a holder */
1005 else if (bdev
->bd_holder
!= NULL
)
1006 return false; /* held by someone else */
1007 else if (whole
== bdev
)
1008 return true; /* is a whole device which isn't held */
1010 else if (whole
->bd_holder
== bd_may_claim
)
1011 return true; /* is a partition of a device that is being partitioned */
1012 else if (whole
->bd_holder
!= NULL
)
1013 return false; /* is a partition of a held device */
1015 return true; /* is a partition of an un-held device */
1019 * bd_prepare_to_claim - prepare to claim a block device
1020 * @bdev: block device of interest
1021 * @whole: the whole device containing @bdev, may equal @bdev
1022 * @holder: holder trying to claim @bdev
1024 * Prepare to claim @bdev. This function fails if @bdev is already
1025 * claimed by another holder and waits if another claiming is in
1026 * progress. This function doesn't actually claim. On successful
1027 * return, the caller has ownership of bd_claiming and bd_holder[s].
1030 * spin_lock(&bdev_lock). Might release bdev_lock, sleep and regrab
1031 * it multiple times.
1034 * 0 if @bdev can be claimed, -EBUSY otherwise.
1036 static int bd_prepare_to_claim(struct block_device
*bdev
,
1037 struct block_device
*whole
, void *holder
)
1040 /* if someone else claimed, fail */
1041 if (!bd_may_claim(bdev
, whole
, holder
))
1044 /* if claiming is already in progress, wait for it to finish */
1045 if (whole
->bd_claiming
) {
1046 wait_queue_head_t
*wq
= bit_waitqueue(&whole
->bd_claiming
, 0);
1049 prepare_to_wait(wq
, &wait
, TASK_UNINTERRUPTIBLE
);
1050 spin_unlock(&bdev_lock
);
1052 finish_wait(wq
, &wait
);
1053 spin_lock(&bdev_lock
);
1061 static struct gendisk
*bdev_get_gendisk(struct block_device
*bdev
, int *partno
)
1063 struct gendisk
*disk
= get_gendisk(bdev
->bd_dev
, partno
);
1068 * Now that we hold gendisk reference we make sure bdev we looked up is
1069 * not stale. If it is, it means device got removed and created before
1070 * we looked up gendisk and we fail open in such case. Associating
1071 * unhashed bdev with newly created gendisk could lead to two bdevs
1072 * (and thus two independent caches) being associated with one device
1075 if (inode_unhashed(bdev
->bd_inode
)) {
1076 put_disk_and_module(disk
);
1083 * bd_start_claiming - start claiming a block device
1084 * @bdev: block device of interest
1085 * @holder: holder trying to claim @bdev
1087 * @bdev is about to be opened exclusively. Check @bdev can be opened
1088 * exclusively and mark that an exclusive open is in progress. Each
1089 * successful call to this function must be matched with a call to
1090 * either bd_finish_claiming() or bd_abort_claiming() (which do not
1093 * This function is used to gain exclusive access to the block device
1094 * without actually causing other exclusive open attempts to fail. It
1095 * should be used when the open sequence itself requires exclusive
1096 * access but may subsequently fail.
1102 * Pointer to the block device containing @bdev on success, ERR_PTR()
1105 static struct block_device
*bd_start_claiming(struct block_device
*bdev
,
1108 struct gendisk
*disk
;
1109 struct block_device
*whole
;
1115 * @bdev might not have been initialized properly yet, look up
1116 * and grab the outer block device the hard way.
1118 disk
= bdev_get_gendisk(bdev
, &partno
);
1120 return ERR_PTR(-ENXIO
);
1123 * Normally, @bdev should equal what's returned from bdget_disk()
1124 * if partno is 0; however, some drivers (floppy) use multiple
1125 * bdev's for the same physical device and @bdev may be one of the
1126 * aliases. Keep @bdev if partno is 0. This means claimer
1127 * tracking is broken for those devices but it has always been that
1131 whole
= bdget_disk(disk
, 0);
1133 whole
= bdgrab(bdev
);
1135 put_disk_and_module(disk
);
1137 return ERR_PTR(-ENOMEM
);
1139 /* prepare to claim, if successful, mark claiming in progress */
1140 spin_lock(&bdev_lock
);
1142 err
= bd_prepare_to_claim(bdev
, whole
, holder
);
1144 whole
->bd_claiming
= holder
;
1145 spin_unlock(&bdev_lock
);
1148 spin_unlock(&bdev_lock
);
1150 return ERR_PTR(err
);
1155 struct bd_holder_disk
{
1156 struct list_head list
;
1157 struct gendisk
*disk
;
1161 static struct bd_holder_disk
*bd_find_holder_disk(struct block_device
*bdev
,
1162 struct gendisk
*disk
)
1164 struct bd_holder_disk
*holder
;
1166 list_for_each_entry(holder
, &bdev
->bd_holder_disks
, list
)
1167 if (holder
->disk
== disk
)
1172 static int add_symlink(struct kobject
*from
, struct kobject
*to
)
1174 return sysfs_create_link(from
, to
, kobject_name(to
));
1177 static void del_symlink(struct kobject
*from
, struct kobject
*to
)
1179 sysfs_remove_link(from
, kobject_name(to
));
1183 * bd_link_disk_holder - create symlinks between holding disk and slave bdev
1184 * @bdev: the claimed slave bdev
1185 * @disk: the holding disk
1187 * DON'T USE THIS UNLESS YOU'RE ALREADY USING IT.
1189 * This functions creates the following sysfs symlinks.
1191 * - from "slaves" directory of the holder @disk to the claimed @bdev
1192 * - from "holders" directory of the @bdev to the holder @disk
1194 * For example, if /dev/dm-0 maps to /dev/sda and disk for dm-0 is
1195 * passed to bd_link_disk_holder(), then:
1197 * /sys/block/dm-0/slaves/sda --> /sys/block/sda
1198 * /sys/block/sda/holders/dm-0 --> /sys/block/dm-0
1200 * The caller must have claimed @bdev before calling this function and
1201 * ensure that both @bdev and @disk are valid during the creation and
1202 * lifetime of these symlinks.
1208 * 0 on success, -errno on failure.
1210 int bd_link_disk_holder(struct block_device
*bdev
, struct gendisk
*disk
)
1212 struct bd_holder_disk
*holder
;
1215 mutex_lock(&bdev
->bd_mutex
);
1217 WARN_ON_ONCE(!bdev
->bd_holder
);
1219 /* FIXME: remove the following once add_disk() handles errors */
1220 if (WARN_ON(!disk
->slave_dir
|| !bdev
->bd_part
->holder_dir
))
1223 holder
= bd_find_holder_disk(bdev
, disk
);
1229 holder
= kzalloc(sizeof(*holder
), GFP_KERNEL
);
1235 INIT_LIST_HEAD(&holder
->list
);
1236 holder
->disk
= disk
;
1239 ret
= add_symlink(disk
->slave_dir
, &part_to_dev(bdev
->bd_part
)->kobj
);
1243 ret
= add_symlink(bdev
->bd_part
->holder_dir
, &disk_to_dev(disk
)->kobj
);
1247 * bdev could be deleted beneath us which would implicitly destroy
1248 * the holder directory. Hold on to it.
1250 kobject_get(bdev
->bd_part
->holder_dir
);
1252 list_add(&holder
->list
, &bdev
->bd_holder_disks
);
1256 del_symlink(disk
->slave_dir
, &part_to_dev(bdev
->bd_part
)->kobj
);
1260 mutex_unlock(&bdev
->bd_mutex
);
1263 EXPORT_SYMBOL_GPL(bd_link_disk_holder
);
1266 * bd_unlink_disk_holder - destroy symlinks created by bd_link_disk_holder()
1267 * @bdev: the calimed slave bdev
1268 * @disk: the holding disk
1270 * DON'T USE THIS UNLESS YOU'RE ALREADY USING IT.
1275 void bd_unlink_disk_holder(struct block_device
*bdev
, struct gendisk
*disk
)
1277 struct bd_holder_disk
*holder
;
1279 mutex_lock(&bdev
->bd_mutex
);
1281 holder
= bd_find_holder_disk(bdev
, disk
);
1283 if (!WARN_ON_ONCE(holder
== NULL
) && !--holder
->refcnt
) {
1284 del_symlink(disk
->slave_dir
, &part_to_dev(bdev
->bd_part
)->kobj
);
1285 del_symlink(bdev
->bd_part
->holder_dir
,
1286 &disk_to_dev(disk
)->kobj
);
1287 kobject_put(bdev
->bd_part
->holder_dir
);
1288 list_del_init(&holder
->list
);
1292 mutex_unlock(&bdev
->bd_mutex
);
1294 EXPORT_SYMBOL_GPL(bd_unlink_disk_holder
);
1298 * flush_disk - invalidates all buffer-cache entries on a disk
1300 * @bdev: struct block device to be flushed
1301 * @kill_dirty: flag to guide handling of dirty inodes
1303 * Invalidates all buffer-cache entries on a disk. It should be called
1304 * when a disk has been changed -- either by a media change or online
1307 static void flush_disk(struct block_device
*bdev
, bool kill_dirty
)
1309 if (__invalidate_device(bdev
, kill_dirty
)) {
1310 printk(KERN_WARNING
"VFS: busy inodes on changed media or "
1311 "resized disk %s\n",
1312 bdev
->bd_disk
? bdev
->bd_disk
->disk_name
: "");
1317 if (disk_part_scan_enabled(bdev
->bd_disk
))
1318 bdev
->bd_invalidated
= 1;
1322 * check_disk_size_change - checks for disk size change and adjusts bdev size.
1323 * @disk: struct gendisk to check
1324 * @bdev: struct bdev to adjust.
1325 * @verbose: if %true log a message about a size change if there is any
1327 * This routine checks to see if the bdev size does not match the disk size
1328 * and adjusts it if it differs. When shrinking the bdev size, its all caches
1331 void check_disk_size_change(struct gendisk
*disk
, struct block_device
*bdev
,
1334 loff_t disk_size
, bdev_size
;
1336 disk_size
= (loff_t
)get_capacity(disk
) << 9;
1337 bdev_size
= i_size_read(bdev
->bd_inode
);
1338 if (disk_size
!= bdev_size
) {
1341 "%s: detected capacity change from %lld to %lld\n",
1342 disk
->disk_name
, bdev_size
, disk_size
);
1344 i_size_write(bdev
->bd_inode
, disk_size
);
1345 if (bdev_size
> disk_size
)
1346 flush_disk(bdev
, false);
1351 * revalidate_disk - wrapper for lower-level driver's revalidate_disk call-back
1352 * @disk: struct gendisk to be revalidated
1354 * This routine is a wrapper for lower-level driver's revalidate_disk
1355 * call-backs. It is used to do common pre and post operations needed
1356 * for all revalidate_disk operations.
1358 int revalidate_disk(struct gendisk
*disk
)
1360 struct block_device
*bdev
;
1363 if (disk
->fops
->revalidate_disk
)
1364 ret
= disk
->fops
->revalidate_disk(disk
);
1365 bdev
= bdget_disk(disk
, 0);
1369 mutex_lock(&bdev
->bd_mutex
);
1370 check_disk_size_change(disk
, bdev
, ret
== 0);
1371 bdev
->bd_invalidated
= 0;
1372 mutex_unlock(&bdev
->bd_mutex
);
1376 EXPORT_SYMBOL(revalidate_disk
);
1379 * This routine checks whether a removable media has been changed,
1380 * and invalidates all buffer-cache-entries in that case. This
1381 * is a relatively slow routine, so we have to try to minimize using
1382 * it. Thus it is called only upon a 'mount' or 'open'. This
1383 * is the best way of combining speed and utility, I think.
1384 * People changing diskettes in the middle of an operation deserve
1387 int check_disk_change(struct block_device
*bdev
)
1389 struct gendisk
*disk
= bdev
->bd_disk
;
1390 const struct block_device_operations
*bdops
= disk
->fops
;
1391 unsigned int events
;
1393 events
= disk_clear_events(disk
, DISK_EVENT_MEDIA_CHANGE
|
1394 DISK_EVENT_EJECT_REQUEST
);
1395 if (!(events
& DISK_EVENT_MEDIA_CHANGE
))
1398 flush_disk(bdev
, true);
1399 if (bdops
->revalidate_disk
)
1400 bdops
->revalidate_disk(bdev
->bd_disk
);
1404 EXPORT_SYMBOL(check_disk_change
);
1406 void bd_set_size(struct block_device
*bdev
, loff_t size
)
1408 unsigned bsize
= bdev_logical_block_size(bdev
);
1410 inode_lock(bdev
->bd_inode
);
1411 i_size_write(bdev
->bd_inode
, size
);
1412 inode_unlock(bdev
->bd_inode
);
1413 while (bsize
< PAGE_SIZE
) {
1418 bdev
->bd_block_size
= bsize
;
1419 bdev
->bd_inode
->i_blkbits
= blksize_bits(bsize
);
1421 EXPORT_SYMBOL(bd_set_size
);
1423 static void __blkdev_put(struct block_device
*bdev
, fmode_t mode
, int for_part
);
1428 * mutex_lock(part->bd_mutex)
1429 * mutex_lock_nested(whole->bd_mutex, 1)
1432 static int __blkdev_get(struct block_device
*bdev
, fmode_t mode
, int for_part
)
1434 struct gendisk
*disk
;
1438 bool first_open
= false;
1440 if (mode
& FMODE_READ
)
1442 if (mode
& FMODE_WRITE
)
1445 * hooks: /n/, see "layering violations".
1448 ret
= devcgroup_inode_permission(bdev
->bd_inode
, perm
);
1458 disk
= bdev_get_gendisk(bdev
, &partno
);
1462 disk_block_events(disk
);
1463 mutex_lock_nested(&bdev
->bd_mutex
, for_part
);
1464 if (!bdev
->bd_openers
) {
1466 bdev
->bd_disk
= disk
;
1467 bdev
->bd_queue
= disk
->queue
;
1468 bdev
->bd_contains
= bdev
;
1469 bdev
->bd_partno
= partno
;
1473 bdev
->bd_part
= disk_get_part(disk
, partno
);
1478 if (disk
->fops
->open
) {
1479 ret
= disk
->fops
->open(bdev
, mode
);
1480 if (ret
== -ERESTARTSYS
) {
1481 /* Lost a race with 'disk' being
1482 * deleted, try again.
1485 disk_put_part(bdev
->bd_part
);
1486 bdev
->bd_part
= NULL
;
1487 bdev
->bd_disk
= NULL
;
1488 bdev
->bd_queue
= NULL
;
1489 mutex_unlock(&bdev
->bd_mutex
);
1490 disk_unblock_events(disk
);
1491 put_disk_and_module(disk
);
1497 bd_set_size(bdev
,(loff_t
)get_capacity(disk
)<<9);
1500 * If the device is invalidated, rescan partition
1501 * if open succeeded or failed with -ENOMEDIUM.
1502 * The latter is necessary to prevent ghost
1503 * partitions on a removed medium.
1505 if (bdev
->bd_invalidated
) {
1507 rescan_partitions(disk
, bdev
);
1508 else if (ret
== -ENOMEDIUM
)
1509 invalidate_partitions(disk
, bdev
);
1515 struct block_device
*whole
;
1516 whole
= bdget_disk(disk
, 0);
1521 ret
= __blkdev_get(whole
, mode
, 1);
1524 bdev
->bd_contains
= whole
;
1525 bdev
->bd_part
= disk_get_part(disk
, partno
);
1526 if (!(disk
->flags
& GENHD_FL_UP
) ||
1527 !bdev
->bd_part
|| !bdev
->bd_part
->nr_sects
) {
1531 bd_set_size(bdev
, (loff_t
)bdev
->bd_part
->nr_sects
<< 9);
1534 if (bdev
->bd_bdi
== &noop_backing_dev_info
)
1535 bdev
->bd_bdi
= bdi_get(disk
->queue
->backing_dev_info
);
1537 if (bdev
->bd_contains
== bdev
) {
1539 if (bdev
->bd_disk
->fops
->open
)
1540 ret
= bdev
->bd_disk
->fops
->open(bdev
, mode
);
1541 /* the same as first opener case, read comment there */
1542 if (bdev
->bd_invalidated
) {
1544 rescan_partitions(bdev
->bd_disk
, bdev
);
1545 else if (ret
== -ENOMEDIUM
)
1546 invalidate_partitions(bdev
->bd_disk
, bdev
);
1549 goto out_unlock_bdev
;
1554 bdev
->bd_part_count
++;
1555 mutex_unlock(&bdev
->bd_mutex
);
1556 disk_unblock_events(disk
);
1557 /* only one opener holds refs to the module and disk */
1559 put_disk_and_module(disk
);
1563 disk_put_part(bdev
->bd_part
);
1564 bdev
->bd_disk
= NULL
;
1565 bdev
->bd_part
= NULL
;
1566 bdev
->bd_queue
= NULL
;
1567 if (bdev
!= bdev
->bd_contains
)
1568 __blkdev_put(bdev
->bd_contains
, mode
, 1);
1569 bdev
->bd_contains
= NULL
;
1571 mutex_unlock(&bdev
->bd_mutex
);
1572 disk_unblock_events(disk
);
1573 put_disk_and_module(disk
);
1581 * blkdev_get - open a block device
1582 * @bdev: block_device to open
1583 * @mode: FMODE_* mask
1584 * @holder: exclusive holder identifier
1586 * Open @bdev with @mode. If @mode includes %FMODE_EXCL, @bdev is
1587 * open with exclusive access. Specifying %FMODE_EXCL with %NULL
1588 * @holder is invalid. Exclusive opens may nest for the same @holder.
1590 * On success, the reference count of @bdev is unchanged. On failure,
1597 * 0 on success, -errno on failure.
1599 int blkdev_get(struct block_device
*bdev
, fmode_t mode
, void *holder
)
1601 struct block_device
*whole
= NULL
;
1604 WARN_ON_ONCE((mode
& FMODE_EXCL
) && !holder
);
1606 if ((mode
& FMODE_EXCL
) && holder
) {
1607 whole
= bd_start_claiming(bdev
, holder
);
1608 if (IS_ERR(whole
)) {
1610 return PTR_ERR(whole
);
1614 res
= __blkdev_get(bdev
, mode
, 0);
1617 struct gendisk
*disk
= whole
->bd_disk
;
1619 /* finish claiming */
1620 mutex_lock(&bdev
->bd_mutex
);
1621 spin_lock(&bdev_lock
);
1624 BUG_ON(!bd_may_claim(bdev
, whole
, holder
));
1626 * Note that for a whole device bd_holders
1627 * will be incremented twice, and bd_holder
1628 * will be set to bd_may_claim before being
1631 whole
->bd_holders
++;
1632 whole
->bd_holder
= bd_may_claim
;
1634 bdev
->bd_holder
= holder
;
1637 /* tell others that we're done */
1638 BUG_ON(whole
->bd_claiming
!= holder
);
1639 whole
->bd_claiming
= NULL
;
1640 wake_up_bit(&whole
->bd_claiming
, 0);
1642 spin_unlock(&bdev_lock
);
1645 * Block event polling for write claims if requested. Any
1646 * write holder makes the write_holder state stick until
1647 * all are released. This is good enough and tracking
1648 * individual writeable reference is too fragile given the
1649 * way @mode is used in blkdev_get/put().
1651 if (!res
&& (mode
& FMODE_WRITE
) && !bdev
->bd_write_holder
&&
1652 (disk
->flags
& GENHD_FL_BLOCK_EVENTS_ON_EXCL_WRITE
)) {
1653 bdev
->bd_write_holder
= true;
1654 disk_block_events(disk
);
1657 mutex_unlock(&bdev
->bd_mutex
);
1663 EXPORT_SYMBOL(blkdev_get
);
1666 * blkdev_get_by_path - open a block device by name
1667 * @path: path to the block device to open
1668 * @mode: FMODE_* mask
1669 * @holder: exclusive holder identifier
1671 * Open the blockdevice described by the device file at @path. @mode
1672 * and @holder are identical to blkdev_get().
1674 * On success, the returned block_device has reference count of one.
1680 * Pointer to block_device on success, ERR_PTR(-errno) on failure.
1682 struct block_device
*blkdev_get_by_path(const char *path
, fmode_t mode
,
1685 struct block_device
*bdev
;
1688 bdev
= lookup_bdev(path
);
1692 err
= blkdev_get(bdev
, mode
, holder
);
1694 return ERR_PTR(err
);
1696 if ((mode
& FMODE_WRITE
) && bdev_read_only(bdev
)) {
1697 blkdev_put(bdev
, mode
);
1698 return ERR_PTR(-EACCES
);
1703 EXPORT_SYMBOL(blkdev_get_by_path
);
1706 * blkdev_get_by_dev - open a block device by device number
1707 * @dev: device number of block device to open
1708 * @mode: FMODE_* mask
1709 * @holder: exclusive holder identifier
1711 * Open the blockdevice described by device number @dev. @mode and
1712 * @holder are identical to blkdev_get().
1714 * Use it ONLY if you really do not have anything better - i.e. when
1715 * you are behind a truly sucky interface and all you are given is a
1716 * device number. _Never_ to be used for internal purposes. If you
1717 * ever need it - reconsider your API.
1719 * On success, the returned block_device has reference count of one.
1725 * Pointer to block_device on success, ERR_PTR(-errno) on failure.
1727 struct block_device
*blkdev_get_by_dev(dev_t dev
, fmode_t mode
, void *holder
)
1729 struct block_device
*bdev
;
1734 return ERR_PTR(-ENOMEM
);
1736 err
= blkdev_get(bdev
, mode
, holder
);
1738 return ERR_PTR(err
);
1742 EXPORT_SYMBOL(blkdev_get_by_dev
);
1744 static int blkdev_open(struct inode
* inode
, struct file
* filp
)
1746 struct block_device
*bdev
;
1749 * Preserve backwards compatibility and allow large file access
1750 * even if userspace doesn't ask for it explicitly. Some mkfs
1751 * binary needs it. We might want to drop this workaround
1752 * during an unstable branch.
1754 filp
->f_flags
|= O_LARGEFILE
;
1756 filp
->f_mode
|= FMODE_NOWAIT
;
1758 if (filp
->f_flags
& O_NDELAY
)
1759 filp
->f_mode
|= FMODE_NDELAY
;
1760 if (filp
->f_flags
& O_EXCL
)
1761 filp
->f_mode
|= FMODE_EXCL
;
1762 if ((filp
->f_flags
& O_ACCMODE
) == 3)
1763 filp
->f_mode
|= FMODE_WRITE_IOCTL
;
1765 bdev
= bd_acquire(inode
);
1769 filp
->f_mapping
= bdev
->bd_inode
->i_mapping
;
1770 filp
->f_wb_err
= filemap_sample_wb_err(filp
->f_mapping
);
1772 return blkdev_get(bdev
, filp
->f_mode
, filp
);
1775 static void __blkdev_put(struct block_device
*bdev
, fmode_t mode
, int for_part
)
1777 struct gendisk
*disk
= bdev
->bd_disk
;
1778 struct block_device
*victim
= NULL
;
1780 mutex_lock_nested(&bdev
->bd_mutex
, for_part
);
1782 bdev
->bd_part_count
--;
1784 if (!--bdev
->bd_openers
) {
1785 WARN_ON_ONCE(bdev
->bd_holders
);
1786 sync_blockdev(bdev
);
1789 bdev_write_inode(bdev
);
1791 if (bdev
->bd_contains
== bdev
) {
1792 if (disk
->fops
->release
)
1793 disk
->fops
->release(disk
, mode
);
1795 if (!bdev
->bd_openers
) {
1796 disk_put_part(bdev
->bd_part
);
1797 bdev
->bd_part
= NULL
;
1798 bdev
->bd_disk
= NULL
;
1799 if (bdev
!= bdev
->bd_contains
)
1800 victim
= bdev
->bd_contains
;
1801 bdev
->bd_contains
= NULL
;
1803 put_disk_and_module(disk
);
1805 mutex_unlock(&bdev
->bd_mutex
);
1808 __blkdev_put(victim
, mode
, 1);
1811 void blkdev_put(struct block_device
*bdev
, fmode_t mode
)
1813 mutex_lock(&bdev
->bd_mutex
);
1815 if (mode
& FMODE_EXCL
) {
1819 * Release a claim on the device. The holder fields
1820 * are protected with bdev_lock. bd_mutex is to
1821 * synchronize disk_holder unlinking.
1823 spin_lock(&bdev_lock
);
1825 WARN_ON_ONCE(--bdev
->bd_holders
< 0);
1826 WARN_ON_ONCE(--bdev
->bd_contains
->bd_holders
< 0);
1828 /* bd_contains might point to self, check in a separate step */
1829 if ((bdev_free
= !bdev
->bd_holders
))
1830 bdev
->bd_holder
= NULL
;
1831 if (!bdev
->bd_contains
->bd_holders
)
1832 bdev
->bd_contains
->bd_holder
= NULL
;
1834 spin_unlock(&bdev_lock
);
1837 * If this was the last claim, remove holder link and
1838 * unblock evpoll if it was a write holder.
1840 if (bdev_free
&& bdev
->bd_write_holder
) {
1841 disk_unblock_events(bdev
->bd_disk
);
1842 bdev
->bd_write_holder
= false;
1847 * Trigger event checking and tell drivers to flush MEDIA_CHANGE
1848 * event. This is to ensure detection of media removal commanded
1849 * from userland - e.g. eject(1).
1851 disk_flush_events(bdev
->bd_disk
, DISK_EVENT_MEDIA_CHANGE
);
1853 mutex_unlock(&bdev
->bd_mutex
);
1855 __blkdev_put(bdev
, mode
, 0);
1857 EXPORT_SYMBOL(blkdev_put
);
1859 static int blkdev_close(struct inode
* inode
, struct file
* filp
)
1861 struct block_device
*bdev
= I_BDEV(bdev_file_inode(filp
));
1862 blkdev_put(bdev
, filp
->f_mode
);
1866 static long block_ioctl(struct file
*file
, unsigned cmd
, unsigned long arg
)
1868 struct block_device
*bdev
= I_BDEV(bdev_file_inode(file
));
1869 fmode_t mode
= file
->f_mode
;
1872 * O_NDELAY can be altered using fcntl(.., F_SETFL, ..), so we have
1873 * to updated it before every ioctl.
1875 if (file
->f_flags
& O_NDELAY
)
1876 mode
|= FMODE_NDELAY
;
1878 mode
&= ~FMODE_NDELAY
;
1880 return blkdev_ioctl(bdev
, mode
, cmd
, arg
);
1884 * Write data to the block device. Only intended for the block device itself
1885 * and the raw driver which basically is a fake block device.
1887 * Does not take i_mutex for the write and thus is not for general purpose
1890 ssize_t
blkdev_write_iter(struct kiocb
*iocb
, struct iov_iter
*from
)
1892 struct file
*file
= iocb
->ki_filp
;
1893 struct inode
*bd_inode
= bdev_file_inode(file
);
1894 loff_t size
= i_size_read(bd_inode
);
1895 struct blk_plug plug
;
1898 if (bdev_read_only(I_BDEV(bd_inode
)))
1901 if (!iov_iter_count(from
))
1904 if (iocb
->ki_pos
>= size
)
1907 if ((iocb
->ki_flags
& (IOCB_NOWAIT
| IOCB_DIRECT
)) == IOCB_NOWAIT
)
1910 iov_iter_truncate(from
, size
- iocb
->ki_pos
);
1912 blk_start_plug(&plug
);
1913 ret
= __generic_file_write_iter(iocb
, from
);
1915 ret
= generic_write_sync(iocb
, ret
);
1916 blk_finish_plug(&plug
);
1919 EXPORT_SYMBOL_GPL(blkdev_write_iter
);
1921 ssize_t
blkdev_read_iter(struct kiocb
*iocb
, struct iov_iter
*to
)
1923 struct file
*file
= iocb
->ki_filp
;
1924 struct inode
*bd_inode
= bdev_file_inode(file
);
1925 loff_t size
= i_size_read(bd_inode
);
1926 loff_t pos
= iocb
->ki_pos
;
1932 iov_iter_truncate(to
, size
);
1933 return generic_file_read_iter(iocb
, to
);
1935 EXPORT_SYMBOL_GPL(blkdev_read_iter
);
1938 * Try to release a page associated with block device when the system
1939 * is under memory pressure.
1941 static int blkdev_releasepage(struct page
*page
, gfp_t wait
)
1943 struct super_block
*super
= BDEV_I(page
->mapping
->host
)->bdev
.bd_super
;
1945 if (super
&& super
->s_op
->bdev_try_to_free_page
)
1946 return super
->s_op
->bdev_try_to_free_page(super
, page
, wait
);
1948 return try_to_free_buffers(page
);
1951 static int blkdev_writepages(struct address_space
*mapping
,
1952 struct writeback_control
*wbc
)
1954 return generic_writepages(mapping
, wbc
);
1957 static const struct address_space_operations def_blk_aops
= {
1958 .readpage
= blkdev_readpage
,
1959 .readpages
= blkdev_readpages
,
1960 .writepage
= blkdev_writepage
,
1961 .write_begin
= blkdev_write_begin
,
1962 .write_end
= blkdev_write_end
,
1963 .writepages
= blkdev_writepages
,
1964 .releasepage
= blkdev_releasepage
,
1965 .direct_IO
= blkdev_direct_IO
,
1966 .is_dirty_writeback
= buffer_check_dirty_writeback
,
1969 #define BLKDEV_FALLOC_FL_SUPPORTED \
1970 (FALLOC_FL_KEEP_SIZE | FALLOC_FL_PUNCH_HOLE | \
1971 FALLOC_FL_ZERO_RANGE | FALLOC_FL_NO_HIDE_STALE)
1973 static long blkdev_fallocate(struct file
*file
, int mode
, loff_t start
,
1976 struct block_device
*bdev
= I_BDEV(bdev_file_inode(file
));
1977 struct address_space
*mapping
;
1978 loff_t end
= start
+ len
- 1;
1982 /* Fail if we don't recognize the flags. */
1983 if (mode
& ~BLKDEV_FALLOC_FL_SUPPORTED
)
1986 /* Don't go off the end of the device. */
1987 isize
= i_size_read(bdev
->bd_inode
);
1991 if (mode
& FALLOC_FL_KEEP_SIZE
) {
1992 len
= isize
- start
;
1993 end
= start
+ len
- 1;
1999 * Don't allow IO that isn't aligned to logical block size.
2001 if ((start
| len
) & (bdev_logical_block_size(bdev
) - 1))
2004 /* Invalidate the page cache, including dirty pages. */
2005 mapping
= bdev
->bd_inode
->i_mapping
;
2006 truncate_inode_pages_range(mapping
, start
, end
);
2009 case FALLOC_FL_ZERO_RANGE
:
2010 case FALLOC_FL_ZERO_RANGE
| FALLOC_FL_KEEP_SIZE
:
2011 error
= blkdev_issue_zeroout(bdev
, start
>> 9, len
>> 9,
2012 GFP_KERNEL
, BLKDEV_ZERO_NOUNMAP
);
2014 case FALLOC_FL_PUNCH_HOLE
| FALLOC_FL_KEEP_SIZE
:
2015 error
= blkdev_issue_zeroout(bdev
, start
>> 9, len
>> 9,
2016 GFP_KERNEL
, BLKDEV_ZERO_NOFALLBACK
);
2018 case FALLOC_FL_PUNCH_HOLE
| FALLOC_FL_KEEP_SIZE
| FALLOC_FL_NO_HIDE_STALE
:
2019 error
= blkdev_issue_discard(bdev
, start
>> 9, len
>> 9,
2029 * Invalidate again; if someone wandered in and dirtied a page,
2030 * the caller will be given -EBUSY. The third argument is
2031 * inclusive, so the rounding here is safe.
2033 return invalidate_inode_pages2_range(mapping
,
2034 start
>> PAGE_SHIFT
,
2038 const struct file_operations def_blk_fops
= {
2039 .open
= blkdev_open
,
2040 .release
= blkdev_close
,
2041 .llseek
= block_llseek
,
2042 .read_iter
= blkdev_read_iter
,
2043 .write_iter
= blkdev_write_iter
,
2044 .mmap
= generic_file_mmap
,
2045 .fsync
= blkdev_fsync
,
2046 .unlocked_ioctl
= block_ioctl
,
2047 #ifdef CONFIG_COMPAT
2048 .compat_ioctl
= compat_blkdev_ioctl
,
2050 .splice_read
= generic_file_splice_read
,
2051 .splice_write
= iter_file_splice_write
,
2052 .fallocate
= blkdev_fallocate
,
2055 int ioctl_by_bdev(struct block_device
*bdev
, unsigned cmd
, unsigned long arg
)
2058 mm_segment_t old_fs
= get_fs();
2060 res
= blkdev_ioctl(bdev
, 0, cmd
, arg
);
2065 EXPORT_SYMBOL(ioctl_by_bdev
);
2068 * lookup_bdev - lookup a struct block_device by name
2069 * @pathname: special file representing the block device
2071 * Get a reference to the blockdevice at @pathname in the current
2072 * namespace if possible and return it. Return ERR_PTR(error)
2075 struct block_device
*lookup_bdev(const char *pathname
)
2077 struct block_device
*bdev
;
2078 struct inode
*inode
;
2082 if (!pathname
|| !*pathname
)
2083 return ERR_PTR(-EINVAL
);
2085 error
= kern_path(pathname
, LOOKUP_FOLLOW
, &path
);
2087 return ERR_PTR(error
);
2089 inode
= d_backing_inode(path
.dentry
);
2091 if (!S_ISBLK(inode
->i_mode
))
2094 if (!may_open_dev(&path
))
2097 bdev
= bd_acquire(inode
);
2104 bdev
= ERR_PTR(error
);
2107 EXPORT_SYMBOL(lookup_bdev
);
2109 int __invalidate_device(struct block_device
*bdev
, bool kill_dirty
)
2111 struct super_block
*sb
= get_super(bdev
);
2116 * no need to lock the super, get_super holds the
2117 * read mutex so the filesystem cannot go away
2118 * under us (->put_super runs with the write lock
2121 shrink_dcache_sb(sb
);
2122 res
= invalidate_inodes(sb
, kill_dirty
);
2125 invalidate_bdev(bdev
);
2128 EXPORT_SYMBOL(__invalidate_device
);
2130 void iterate_bdevs(void (*func
)(struct block_device
*, void *), void *arg
)
2132 struct inode
*inode
, *old_inode
= NULL
;
2134 spin_lock(&blockdev_superblock
->s_inode_list_lock
);
2135 list_for_each_entry(inode
, &blockdev_superblock
->s_inodes
, i_sb_list
) {
2136 struct address_space
*mapping
= inode
->i_mapping
;
2137 struct block_device
*bdev
;
2139 spin_lock(&inode
->i_lock
);
2140 if (inode
->i_state
& (I_FREEING
|I_WILL_FREE
|I_NEW
) ||
2141 mapping
->nrpages
== 0) {
2142 spin_unlock(&inode
->i_lock
);
2146 spin_unlock(&inode
->i_lock
);
2147 spin_unlock(&blockdev_superblock
->s_inode_list_lock
);
2149 * We hold a reference to 'inode' so it couldn't have been
2150 * removed from s_inodes list while we dropped the
2151 * s_inode_list_lock We cannot iput the inode now as we can
2152 * be holding the last reference and we cannot iput it under
2153 * s_inode_list_lock. So we keep the reference and iput it
2158 bdev
= I_BDEV(inode
);
2160 mutex_lock(&bdev
->bd_mutex
);
2161 if (bdev
->bd_openers
)
2163 mutex_unlock(&bdev
->bd_mutex
);
2165 spin_lock(&blockdev_superblock
->s_inode_list_lock
);
2167 spin_unlock(&blockdev_superblock
->s_inode_list_lock
);