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 void __vfs_msg(struct super_block
*sb
, const char *prefix
, const char *fmt
, ...)
65 printk_ratelimited("%sVFS (%s): %pV\n", prefix
, sb
->s_id
, &vaf
);
69 static void bdev_write_inode(struct block_device
*bdev
)
71 struct inode
*inode
= bdev
->bd_inode
;
74 spin_lock(&inode
->i_lock
);
75 while (inode
->i_state
& I_DIRTY
) {
76 spin_unlock(&inode
->i_lock
);
77 ret
= write_inode_now(inode
, true);
79 char name
[BDEVNAME_SIZE
];
80 pr_warn_ratelimited("VFS: Dirty inode writeback failed "
81 "for block device %s (err=%d).\n",
82 bdevname(bdev
, name
), ret
);
84 spin_lock(&inode
->i_lock
);
86 spin_unlock(&inode
->i_lock
);
89 /* Kill _all_ buffers and pagecache , dirty or not.. */
90 void kill_bdev(struct block_device
*bdev
)
92 struct address_space
*mapping
= bdev
->bd_inode
->i_mapping
;
94 if (mapping
->nrpages
== 0 && mapping
->nrexceptional
== 0)
98 truncate_inode_pages(mapping
, 0);
100 EXPORT_SYMBOL(kill_bdev
);
102 /* Invalidate clean unused buffers and pagecache. */
103 void invalidate_bdev(struct block_device
*bdev
)
105 struct address_space
*mapping
= bdev
->bd_inode
->i_mapping
;
107 if (mapping
->nrpages
) {
108 invalidate_bh_lrus();
109 lru_add_drain_all(); /* make sure all lru add caches are flushed */
110 invalidate_mapping_pages(mapping
, 0, -1);
112 /* 99% of the time, we don't need to flush the cleancache on the bdev.
113 * But, for the strange corners, lets be cautious
115 cleancache_invalidate_inode(mapping
);
117 EXPORT_SYMBOL(invalidate_bdev
);
119 int set_blocksize(struct block_device
*bdev
, int size
)
121 /* Size must be a power of two, and between 512 and PAGE_SIZE */
122 if (size
> PAGE_SIZE
|| size
< 512 || !is_power_of_2(size
))
125 /* Size cannot be smaller than the size supported by the device */
126 if (size
< bdev_logical_block_size(bdev
))
129 /* Don't change the size if it is same as current */
130 if (bdev
->bd_block_size
!= size
) {
132 bdev
->bd_block_size
= size
;
133 bdev
->bd_inode
->i_blkbits
= blksize_bits(size
);
139 EXPORT_SYMBOL(set_blocksize
);
141 int sb_set_blocksize(struct super_block
*sb
, int size
)
143 if (set_blocksize(sb
->s_bdev
, size
))
145 /* If we get here, we know size is power of two
146 * and it's value is between 512 and PAGE_SIZE */
147 sb
->s_blocksize
= size
;
148 sb
->s_blocksize_bits
= blksize_bits(size
);
149 return sb
->s_blocksize
;
152 EXPORT_SYMBOL(sb_set_blocksize
);
154 int sb_min_blocksize(struct super_block
*sb
, int size
)
156 int minsize
= bdev_logical_block_size(sb
->s_bdev
);
159 return sb_set_blocksize(sb
, size
);
162 EXPORT_SYMBOL(sb_min_blocksize
);
165 blkdev_get_block(struct inode
*inode
, sector_t iblock
,
166 struct buffer_head
*bh
, int create
)
168 bh
->b_bdev
= I_BDEV(inode
);
169 bh
->b_blocknr
= iblock
;
170 set_buffer_mapped(bh
);
174 static struct inode
*bdev_file_inode(struct file
*file
)
176 return file
->f_mapping
->host
;
179 static unsigned int dio_bio_write_op(struct kiocb
*iocb
)
181 unsigned int op
= REQ_OP_WRITE
| REQ_SYNC
| REQ_IDLE
;
183 /* avoid the need for a I/O completion work item */
184 if (iocb
->ki_flags
& IOCB_DSYNC
)
189 #define DIO_INLINE_BIO_VECS 4
191 static void blkdev_bio_end_io_simple(struct bio
*bio
)
193 struct task_struct
*waiter
= bio
->bi_private
;
195 WRITE_ONCE(bio
->bi_private
, NULL
);
196 wake_up_process(waiter
);
200 __blkdev_direct_IO_simple(struct kiocb
*iocb
, struct iov_iter
*iter
,
203 struct file
*file
= iocb
->ki_filp
;
204 struct block_device
*bdev
= I_BDEV(bdev_file_inode(file
));
205 struct bio_vec inline_vecs
[DIO_INLINE_BIO_VECS
], *vecs
, *bvec
;
206 loff_t pos
= iocb
->ki_pos
;
207 bool should_dirty
= false;
213 if ((pos
| iov_iter_alignment(iter
)) &
214 (bdev_logical_block_size(bdev
) - 1))
217 if (nr_pages
<= DIO_INLINE_BIO_VECS
)
220 vecs
= kmalloc(nr_pages
* sizeof(struct bio_vec
), GFP_KERNEL
);
225 bio_init(&bio
, vecs
, nr_pages
);
227 bio
.bi_iter
.bi_sector
= pos
>> 9;
228 bio
.bi_private
= current
;
229 bio
.bi_end_io
= blkdev_bio_end_io_simple
;
231 ret
= bio_iov_iter_get_pages(&bio
, iter
);
234 ret
= bio
.bi_iter
.bi_size
;
236 if (iov_iter_rw(iter
) == READ
) {
237 bio
.bi_opf
= REQ_OP_READ
;
238 if (iter_is_iovec(iter
))
241 bio
.bi_opf
= dio_bio_write_op(iocb
);
242 task_io_account_write(ret
);
245 qc
= submit_bio(&bio
);
247 set_current_state(TASK_UNINTERRUPTIBLE
);
248 if (!READ_ONCE(bio
.bi_private
))
250 if (!(iocb
->ki_flags
& IOCB_HIPRI
) ||
251 !blk_mq_poll(bdev_get_queue(bdev
), qc
))
254 __set_current_state(TASK_RUNNING
);
256 bio_for_each_segment_all(bvec
, &bio
, i
) {
257 if (should_dirty
&& !PageCompound(bvec
->bv_page
))
258 set_page_dirty_lock(bvec
->bv_page
);
259 put_page(bvec
->bv_page
);
262 if (vecs
!= inline_vecs
)
265 if (unlikely(bio
.bi_error
))
276 struct task_struct
*waiter
;
281 bool should_dirty
: 1;
286 static struct bio_set
*blkdev_dio_pool __read_mostly
;
288 static void blkdev_bio_end_io(struct bio
*bio
)
290 struct blkdev_dio
*dio
= bio
->bi_private
;
291 bool should_dirty
= dio
->should_dirty
;
293 if (dio
->multi_bio
&& !atomic_dec_and_test(&dio
->ref
)) {
294 if (bio
->bi_error
&& !dio
->bio
.bi_error
)
295 dio
->bio
.bi_error
= bio
->bi_error
;
298 struct kiocb
*iocb
= dio
->iocb
;
299 ssize_t ret
= dio
->bio
.bi_error
;
306 dio
->iocb
->ki_complete(iocb
, ret
, 0);
309 struct task_struct
*waiter
= dio
->waiter
;
311 WRITE_ONCE(dio
->waiter
, NULL
);
312 wake_up_process(waiter
);
317 bio_check_pages_dirty(bio
);
319 struct bio_vec
*bvec
;
322 bio_for_each_segment_all(bvec
, bio
, i
)
323 put_page(bvec
->bv_page
);
329 __blkdev_direct_IO(struct kiocb
*iocb
, struct iov_iter
*iter
, int nr_pages
)
331 struct file
*file
= iocb
->ki_filp
;
332 struct inode
*inode
= bdev_file_inode(file
);
333 struct block_device
*bdev
= I_BDEV(inode
);
334 struct blk_plug plug
;
335 struct blkdev_dio
*dio
;
337 bool is_read
= (iov_iter_rw(iter
) == READ
), is_sync
;
338 loff_t pos
= iocb
->ki_pos
;
339 blk_qc_t qc
= BLK_QC_T_NONE
;
342 if ((pos
| iov_iter_alignment(iter
)) &
343 (bdev_logical_block_size(bdev
) - 1))
346 bio
= bio_alloc_bioset(GFP_KERNEL
, nr_pages
, blkdev_dio_pool
);
347 bio_get(bio
); /* extra ref for the completion handler */
349 dio
= container_of(bio
, struct blkdev_dio
, bio
);
350 dio
->is_sync
= is_sync
= is_sync_kiocb(iocb
);
352 dio
->waiter
= current
;
357 dio
->multi_bio
= false;
358 dio
->should_dirty
= is_read
&& (iter
->type
== ITER_IOVEC
);
360 blk_start_plug(&plug
);
363 bio
->bi_iter
.bi_sector
= pos
>> 9;
364 bio
->bi_private
= dio
;
365 bio
->bi_end_io
= blkdev_bio_end_io
;
367 ret
= bio_iov_iter_get_pages(bio
, iter
);
375 bio
->bi_opf
= REQ_OP_READ
;
376 if (dio
->should_dirty
)
377 bio_set_pages_dirty(bio
);
379 bio
->bi_opf
= dio_bio_write_op(iocb
);
380 task_io_account_write(bio
->bi_iter
.bi_size
);
383 dio
->size
+= bio
->bi_iter
.bi_size
;
384 pos
+= bio
->bi_iter
.bi_size
;
386 nr_pages
= iov_iter_npages(iter
, BIO_MAX_PAGES
);
388 qc
= submit_bio(bio
);
392 if (!dio
->multi_bio
) {
393 dio
->multi_bio
= true;
394 atomic_set(&dio
->ref
, 2);
396 atomic_inc(&dio
->ref
);
400 bio
= bio_alloc(GFP_KERNEL
, nr_pages
);
402 blk_finish_plug(&plug
);
408 set_current_state(TASK_UNINTERRUPTIBLE
);
409 if (!READ_ONCE(dio
->waiter
))
412 if (!(iocb
->ki_flags
& IOCB_HIPRI
) ||
413 !blk_mq_poll(bdev_get_queue(bdev
), qc
))
416 __set_current_state(TASK_RUNNING
);
418 ret
= dio
->bio
.bi_error
;
427 blkdev_direct_IO(struct kiocb
*iocb
, struct iov_iter
*iter
)
431 nr_pages
= iov_iter_npages(iter
, BIO_MAX_PAGES
+ 1);
434 if (is_sync_kiocb(iocb
) && nr_pages
<= BIO_MAX_PAGES
)
435 return __blkdev_direct_IO_simple(iocb
, iter
, nr_pages
);
437 return __blkdev_direct_IO(iocb
, iter
, min(nr_pages
, BIO_MAX_PAGES
));
440 static __init
int blkdev_init(void)
442 blkdev_dio_pool
= bioset_create(4, offsetof(struct blkdev_dio
, bio
));
443 if (!blkdev_dio_pool
)
447 module_init(blkdev_init
);
449 int __sync_blockdev(struct block_device
*bdev
, int wait
)
454 return filemap_flush(bdev
->bd_inode
->i_mapping
);
455 return filemap_write_and_wait(bdev
->bd_inode
->i_mapping
);
459 * Write out and wait upon all the dirty data associated with a block
460 * device via its mapping. Does not take the superblock lock.
462 int sync_blockdev(struct block_device
*bdev
)
464 return __sync_blockdev(bdev
, 1);
466 EXPORT_SYMBOL(sync_blockdev
);
469 * Write out and wait upon all dirty data associated with this
470 * device. Filesystem data as well as the underlying block
471 * device. Takes the superblock lock.
473 int fsync_bdev(struct block_device
*bdev
)
475 struct super_block
*sb
= get_super(bdev
);
477 int res
= sync_filesystem(sb
);
481 return sync_blockdev(bdev
);
483 EXPORT_SYMBOL(fsync_bdev
);
486 * freeze_bdev -- lock a filesystem and force it into a consistent state
487 * @bdev: blockdevice to lock
489 * If a superblock is found on this device, we take the s_umount semaphore
490 * on it to make sure nobody unmounts until the snapshot creation is done.
491 * The reference counter (bd_fsfreeze_count) guarantees that only the last
492 * unfreeze process can unfreeze the frozen filesystem actually when multiple
493 * freeze requests arrive simultaneously. It counts up in freeze_bdev() and
494 * count down in thaw_bdev(). When it becomes 0, thaw_bdev() will unfreeze
497 struct super_block
*freeze_bdev(struct block_device
*bdev
)
499 struct super_block
*sb
;
502 mutex_lock(&bdev
->bd_fsfreeze_mutex
);
503 if (++bdev
->bd_fsfreeze_count
> 1) {
505 * We don't even need to grab a reference - the first call
506 * to freeze_bdev grab an active reference and only the last
507 * thaw_bdev drops it.
509 sb
= get_super(bdev
);
512 mutex_unlock(&bdev
->bd_fsfreeze_mutex
);
516 sb
= get_active_super(bdev
);
519 if (sb
->s_op
->freeze_super
)
520 error
= sb
->s_op
->freeze_super(sb
);
522 error
= freeze_super(sb
);
524 deactivate_super(sb
);
525 bdev
->bd_fsfreeze_count
--;
526 mutex_unlock(&bdev
->bd_fsfreeze_mutex
);
527 return ERR_PTR(error
);
529 deactivate_super(sb
);
532 mutex_unlock(&bdev
->bd_fsfreeze_mutex
);
533 return sb
; /* thaw_bdev releases s->s_umount */
535 EXPORT_SYMBOL(freeze_bdev
);
538 * thaw_bdev -- unlock filesystem
539 * @bdev: blockdevice to unlock
540 * @sb: associated superblock
542 * Unlocks the filesystem and marks it writeable again after freeze_bdev().
544 int thaw_bdev(struct block_device
*bdev
, struct super_block
*sb
)
548 mutex_lock(&bdev
->bd_fsfreeze_mutex
);
549 if (!bdev
->bd_fsfreeze_count
)
553 if (--bdev
->bd_fsfreeze_count
> 0)
559 if (sb
->s_op
->thaw_super
)
560 error
= sb
->s_op
->thaw_super(sb
);
562 error
= thaw_super(sb
);
564 bdev
->bd_fsfreeze_count
++;
566 mutex_unlock(&bdev
->bd_fsfreeze_mutex
);
569 EXPORT_SYMBOL(thaw_bdev
);
571 static int blkdev_writepage(struct page
*page
, struct writeback_control
*wbc
)
573 return block_write_full_page(page
, blkdev_get_block
, wbc
);
576 static int blkdev_readpage(struct file
* file
, struct page
* page
)
578 return block_read_full_page(page
, blkdev_get_block
);
581 static int blkdev_readpages(struct file
*file
, struct address_space
*mapping
,
582 struct list_head
*pages
, unsigned nr_pages
)
584 return mpage_readpages(mapping
, pages
, nr_pages
, blkdev_get_block
);
587 static int blkdev_write_begin(struct file
*file
, struct address_space
*mapping
,
588 loff_t pos
, unsigned len
, unsigned flags
,
589 struct page
**pagep
, void **fsdata
)
591 return block_write_begin(mapping
, pos
, len
, flags
, pagep
,
595 static int blkdev_write_end(struct file
*file
, struct address_space
*mapping
,
596 loff_t pos
, unsigned len
, unsigned copied
,
597 struct page
*page
, void *fsdata
)
600 ret
= block_write_end(file
, mapping
, pos
, len
, copied
, page
, fsdata
);
610 * for a block special file file_inode(file)->i_size is zero
611 * so we compute the size by hand (just as in block_read/write above)
613 static loff_t
block_llseek(struct file
*file
, loff_t offset
, int whence
)
615 struct inode
*bd_inode
= bdev_file_inode(file
);
618 inode_lock(bd_inode
);
619 retval
= fixed_size_llseek(file
, offset
, whence
, i_size_read(bd_inode
));
620 inode_unlock(bd_inode
);
624 int blkdev_fsync(struct file
*filp
, loff_t start
, loff_t end
, int datasync
)
626 struct inode
*bd_inode
= bdev_file_inode(filp
);
627 struct block_device
*bdev
= I_BDEV(bd_inode
);
630 error
= filemap_write_and_wait_range(filp
->f_mapping
, start
, end
);
635 * There is no need to serialise calls to blkdev_issue_flush with
636 * i_mutex and doing so causes performance issues with concurrent
637 * O_SYNC writers to a block device.
639 error
= blkdev_issue_flush(bdev
, GFP_KERNEL
, NULL
);
640 if (error
== -EOPNOTSUPP
)
645 EXPORT_SYMBOL(blkdev_fsync
);
648 * bdev_read_page() - Start reading a page from a block device
649 * @bdev: The device to read the page from
650 * @sector: The offset on the device to read the page to (need not be aligned)
651 * @page: The page to read
653 * On entry, the page should be locked. It will be unlocked when the page
654 * has been read. If the block driver implements rw_page synchronously,
655 * that will be true on exit from this function, but it need not be.
657 * Errors returned by this function are usually "soft", eg out of memory, or
658 * queue full; callers should try a different route to read this page rather
659 * than propagate an error back up the stack.
661 * Return: negative errno if an error occurs, 0 if submission was successful.
663 int bdev_read_page(struct block_device
*bdev
, sector_t sector
,
666 const struct block_device_operations
*ops
= bdev
->bd_disk
->fops
;
667 int result
= -EOPNOTSUPP
;
669 if (!ops
->rw_page
|| bdev_get_integrity(bdev
))
672 result
= blk_queue_enter(bdev
->bd_queue
, false);
675 result
= ops
->rw_page(bdev
, sector
+ get_start_sect(bdev
), page
, false);
676 blk_queue_exit(bdev
->bd_queue
);
679 EXPORT_SYMBOL_GPL(bdev_read_page
);
682 * bdev_write_page() - Start writing a page to a block device
683 * @bdev: The device to write the page to
684 * @sector: The offset on the device to write the page to (need not be aligned)
685 * @page: The page to write
686 * @wbc: The writeback_control for the write
688 * On entry, the page should be locked and not currently under writeback.
689 * On exit, if the write started successfully, the page will be unlocked and
690 * under writeback. If the write failed already (eg the driver failed to
691 * queue the page to the device), the page will still be locked. If the
692 * caller is a ->writepage implementation, it will need to unlock the page.
694 * Errors returned by this function are usually "soft", eg out of memory, or
695 * queue full; callers should try a different route to write this page rather
696 * than propagate an error back up the stack.
698 * Return: negative errno if an error occurs, 0 if submission was successful.
700 int bdev_write_page(struct block_device
*bdev
, sector_t sector
,
701 struct page
*page
, struct writeback_control
*wbc
)
704 const struct block_device_operations
*ops
= bdev
->bd_disk
->fops
;
706 if (!ops
->rw_page
|| bdev_get_integrity(bdev
))
708 result
= blk_queue_enter(bdev
->bd_queue
, false);
712 set_page_writeback(page
);
713 result
= ops
->rw_page(bdev
, sector
+ get_start_sect(bdev
), page
, true);
715 end_page_writeback(page
);
718 blk_queue_exit(bdev
->bd_queue
);
721 EXPORT_SYMBOL_GPL(bdev_write_page
);
727 static __cacheline_aligned_in_smp
DEFINE_SPINLOCK(bdev_lock
);
728 static struct kmem_cache
* bdev_cachep __read_mostly
;
730 static struct inode
*bdev_alloc_inode(struct super_block
*sb
)
732 struct bdev_inode
*ei
= kmem_cache_alloc(bdev_cachep
, GFP_KERNEL
);
735 return &ei
->vfs_inode
;
738 static void bdev_i_callback(struct rcu_head
*head
)
740 struct inode
*inode
= container_of(head
, struct inode
, i_rcu
);
741 struct bdev_inode
*bdi
= BDEV_I(inode
);
743 kmem_cache_free(bdev_cachep
, bdi
);
746 static void bdev_destroy_inode(struct inode
*inode
)
748 call_rcu(&inode
->i_rcu
, bdev_i_callback
);
751 static void init_once(void *foo
)
753 struct bdev_inode
*ei
= (struct bdev_inode
*) foo
;
754 struct block_device
*bdev
= &ei
->bdev
;
756 memset(bdev
, 0, sizeof(*bdev
));
757 mutex_init(&bdev
->bd_mutex
);
758 INIT_LIST_HEAD(&bdev
->bd_list
);
760 INIT_LIST_HEAD(&bdev
->bd_holder_disks
);
762 bdev
->bd_bdi
= &noop_backing_dev_info
;
763 inode_init_once(&ei
->vfs_inode
);
764 /* Initialize mutex for freeze. */
765 mutex_init(&bdev
->bd_fsfreeze_mutex
);
768 static void bdev_evict_inode(struct inode
*inode
)
770 struct block_device
*bdev
= &BDEV_I(inode
)->bdev
;
771 truncate_inode_pages_final(&inode
->i_data
);
772 invalidate_inode_buffers(inode
); /* is it needed here? */
774 spin_lock(&bdev_lock
);
775 list_del_init(&bdev
->bd_list
);
776 spin_unlock(&bdev_lock
);
777 /* Detach inode from wb early as bdi_put() may free bdi->wb */
778 inode_detach_wb(inode
);
779 if (bdev
->bd_bdi
!= &noop_backing_dev_info
) {
780 bdi_put(bdev
->bd_bdi
);
781 bdev
->bd_bdi
= &noop_backing_dev_info
;
785 static const struct super_operations bdev_sops
= {
786 .statfs
= simple_statfs
,
787 .alloc_inode
= bdev_alloc_inode
,
788 .destroy_inode
= bdev_destroy_inode
,
789 .drop_inode
= generic_delete_inode
,
790 .evict_inode
= bdev_evict_inode
,
793 static struct dentry
*bd_mount(struct file_system_type
*fs_type
,
794 int flags
, const char *dev_name
, void *data
)
797 dent
= mount_pseudo(fs_type
, "bdev:", &bdev_sops
, NULL
, BDEVFS_MAGIC
);
799 dent
->d_sb
->s_iflags
|= SB_I_CGROUPWB
;
803 static struct file_system_type bd_type
= {
806 .kill_sb
= kill_anon_super
,
809 struct super_block
*blockdev_superblock __read_mostly
;
810 EXPORT_SYMBOL_GPL(blockdev_superblock
);
812 void __init
bdev_cache_init(void)
815 static struct vfsmount
*bd_mnt
;
817 bdev_cachep
= kmem_cache_create("bdev_cache", sizeof(struct bdev_inode
),
818 0, (SLAB_HWCACHE_ALIGN
|SLAB_RECLAIM_ACCOUNT
|
819 SLAB_MEM_SPREAD
|SLAB_ACCOUNT
|SLAB_PANIC
),
821 err
= register_filesystem(&bd_type
);
823 panic("Cannot register bdev pseudo-fs");
824 bd_mnt
= kern_mount(&bd_type
);
826 panic("Cannot create bdev pseudo-fs");
827 blockdev_superblock
= bd_mnt
->mnt_sb
; /* For writeback */
831 * Most likely _very_ bad one - but then it's hardly critical for small
832 * /dev and can be fixed when somebody will need really large one.
833 * Keep in mind that it will be fed through icache hash function too.
835 static inline unsigned long hash(dev_t dev
)
837 return MAJOR(dev
)+MINOR(dev
);
840 static int bdev_test(struct inode
*inode
, void *data
)
842 return BDEV_I(inode
)->bdev
.bd_dev
== *(dev_t
*)data
;
845 static int bdev_set(struct inode
*inode
, void *data
)
847 BDEV_I(inode
)->bdev
.bd_dev
= *(dev_t
*)data
;
851 static LIST_HEAD(all_bdevs
);
854 * If there is a bdev inode for this device, unhash it so that it gets evicted
855 * as soon as last inode reference is dropped.
857 void bdev_unhash_inode(dev_t dev
)
861 inode
= ilookup5(blockdev_superblock
, hash(dev
), bdev_test
, &dev
);
863 remove_inode_hash(inode
);
868 struct block_device
*bdget(dev_t dev
)
870 struct block_device
*bdev
;
873 inode
= iget5_locked(blockdev_superblock
, hash(dev
),
874 bdev_test
, bdev_set
, &dev
);
879 bdev
= &BDEV_I(inode
)->bdev
;
881 if (inode
->i_state
& I_NEW
) {
882 bdev
->bd_contains
= NULL
;
883 bdev
->bd_super
= NULL
;
884 bdev
->bd_inode
= inode
;
885 bdev
->bd_block_size
= i_blocksize(inode
);
886 bdev
->bd_part_count
= 0;
887 bdev
->bd_invalidated
= 0;
888 inode
->i_mode
= S_IFBLK
;
890 inode
->i_bdev
= bdev
;
891 inode
->i_data
.a_ops
= &def_blk_aops
;
892 mapping_set_gfp_mask(&inode
->i_data
, GFP_USER
);
893 spin_lock(&bdev_lock
);
894 list_add(&bdev
->bd_list
, &all_bdevs
);
895 spin_unlock(&bdev_lock
);
896 unlock_new_inode(inode
);
901 EXPORT_SYMBOL(bdget
);
904 * bdgrab -- Grab a reference to an already referenced block device
905 * @bdev: Block device to grab a reference to.
907 struct block_device
*bdgrab(struct block_device
*bdev
)
909 ihold(bdev
->bd_inode
);
912 EXPORT_SYMBOL(bdgrab
);
914 long nr_blockdev_pages(void)
916 struct block_device
*bdev
;
918 spin_lock(&bdev_lock
);
919 list_for_each_entry(bdev
, &all_bdevs
, bd_list
) {
920 ret
+= bdev
->bd_inode
->i_mapping
->nrpages
;
922 spin_unlock(&bdev_lock
);
926 void bdput(struct block_device
*bdev
)
928 iput(bdev
->bd_inode
);
931 EXPORT_SYMBOL(bdput
);
933 static struct block_device
*bd_acquire(struct inode
*inode
)
935 struct block_device
*bdev
;
937 spin_lock(&bdev_lock
);
938 bdev
= inode
->i_bdev
;
939 if (bdev
&& !inode_unhashed(bdev
->bd_inode
)) {
941 spin_unlock(&bdev_lock
);
944 spin_unlock(&bdev_lock
);
947 * i_bdev references block device inode that was already shut down
948 * (corresponding device got removed). Remove the reference and look
949 * up block device inode again just in case new device got
950 * reestablished under the same device number.
955 bdev
= bdget(inode
->i_rdev
);
957 spin_lock(&bdev_lock
);
958 if (!inode
->i_bdev
) {
960 * We take an additional reference to bd_inode,
961 * and it's released in clear_inode() of inode.
962 * So, we can access it via ->i_mapping always
966 inode
->i_bdev
= bdev
;
967 inode
->i_mapping
= bdev
->bd_inode
->i_mapping
;
969 spin_unlock(&bdev_lock
);
974 /* Call when you free inode */
976 void bd_forget(struct inode
*inode
)
978 struct block_device
*bdev
= NULL
;
980 spin_lock(&bdev_lock
);
981 if (!sb_is_blkdev_sb(inode
->i_sb
))
982 bdev
= inode
->i_bdev
;
983 inode
->i_bdev
= NULL
;
984 inode
->i_mapping
= &inode
->i_data
;
985 spin_unlock(&bdev_lock
);
992 * bd_may_claim - test whether a block device can be claimed
993 * @bdev: block device of interest
994 * @whole: whole block device containing @bdev, may equal @bdev
995 * @holder: holder trying to claim @bdev
997 * Test whether @bdev can be claimed by @holder.
1000 * spin_lock(&bdev_lock).
1003 * %true if @bdev can be claimed, %false otherwise.
1005 static bool bd_may_claim(struct block_device
*bdev
, struct block_device
*whole
,
1008 if (bdev
->bd_holder
== holder
)
1009 return true; /* already a holder */
1010 else if (bdev
->bd_holder
!= NULL
)
1011 return false; /* held by someone else */
1012 else if (whole
== bdev
)
1013 return true; /* is a whole device which isn't held */
1015 else if (whole
->bd_holder
== bd_may_claim
)
1016 return true; /* is a partition of a device that is being partitioned */
1017 else if (whole
->bd_holder
!= NULL
)
1018 return false; /* is a partition of a held device */
1020 return true; /* is a partition of an un-held device */
1024 * bd_prepare_to_claim - prepare to claim a block device
1025 * @bdev: block device of interest
1026 * @whole: the whole device containing @bdev, may equal @bdev
1027 * @holder: holder trying to claim @bdev
1029 * Prepare to claim @bdev. This function fails if @bdev is already
1030 * claimed by another holder and waits if another claiming is in
1031 * progress. This function doesn't actually claim. On successful
1032 * return, the caller has ownership of bd_claiming and bd_holder[s].
1035 * spin_lock(&bdev_lock). Might release bdev_lock, sleep and regrab
1036 * it multiple times.
1039 * 0 if @bdev can be claimed, -EBUSY otherwise.
1041 static int bd_prepare_to_claim(struct block_device
*bdev
,
1042 struct block_device
*whole
, void *holder
)
1045 /* if someone else claimed, fail */
1046 if (!bd_may_claim(bdev
, whole
, holder
))
1049 /* if claiming is already in progress, wait for it to finish */
1050 if (whole
->bd_claiming
) {
1051 wait_queue_head_t
*wq
= bit_waitqueue(&whole
->bd_claiming
, 0);
1054 prepare_to_wait(wq
, &wait
, TASK_UNINTERRUPTIBLE
);
1055 spin_unlock(&bdev_lock
);
1057 finish_wait(wq
, &wait
);
1058 spin_lock(&bdev_lock
);
1067 * bd_start_claiming - start claiming a block device
1068 * @bdev: block device of interest
1069 * @holder: holder trying to claim @bdev
1071 * @bdev is about to be opened exclusively. Check @bdev can be opened
1072 * exclusively and mark that an exclusive open is in progress. Each
1073 * successful call to this function must be matched with a call to
1074 * either bd_finish_claiming() or bd_abort_claiming() (which do not
1077 * This function is used to gain exclusive access to the block device
1078 * without actually causing other exclusive open attempts to fail. It
1079 * should be used when the open sequence itself requires exclusive
1080 * access but may subsequently fail.
1086 * Pointer to the block device containing @bdev on success, ERR_PTR()
1089 static struct block_device
*bd_start_claiming(struct block_device
*bdev
,
1092 struct gendisk
*disk
;
1093 struct block_device
*whole
;
1099 * @bdev might not have been initialized properly yet, look up
1100 * and grab the outer block device the hard way.
1102 disk
= get_gendisk(bdev
->bd_dev
, &partno
);
1104 return ERR_PTR(-ENXIO
);
1107 * Normally, @bdev should equal what's returned from bdget_disk()
1108 * if partno is 0; however, some drivers (floppy) use multiple
1109 * bdev's for the same physical device and @bdev may be one of the
1110 * aliases. Keep @bdev if partno is 0. This means claimer
1111 * tracking is broken for those devices but it has always been that
1115 whole
= bdget_disk(disk
, 0);
1117 whole
= bdgrab(bdev
);
1119 module_put(disk
->fops
->owner
);
1122 return ERR_PTR(-ENOMEM
);
1124 /* prepare to claim, if successful, mark claiming in progress */
1125 spin_lock(&bdev_lock
);
1127 err
= bd_prepare_to_claim(bdev
, whole
, holder
);
1129 whole
->bd_claiming
= holder
;
1130 spin_unlock(&bdev_lock
);
1133 spin_unlock(&bdev_lock
);
1135 return ERR_PTR(err
);
1140 struct bd_holder_disk
{
1141 struct list_head list
;
1142 struct gendisk
*disk
;
1146 static struct bd_holder_disk
*bd_find_holder_disk(struct block_device
*bdev
,
1147 struct gendisk
*disk
)
1149 struct bd_holder_disk
*holder
;
1151 list_for_each_entry(holder
, &bdev
->bd_holder_disks
, list
)
1152 if (holder
->disk
== disk
)
1157 static int add_symlink(struct kobject
*from
, struct kobject
*to
)
1159 return sysfs_create_link(from
, to
, kobject_name(to
));
1162 static void del_symlink(struct kobject
*from
, struct kobject
*to
)
1164 sysfs_remove_link(from
, kobject_name(to
));
1168 * bd_link_disk_holder - create symlinks between holding disk and slave bdev
1169 * @bdev: the claimed slave bdev
1170 * @disk: the holding disk
1172 * DON'T USE THIS UNLESS YOU'RE ALREADY USING IT.
1174 * This functions creates the following sysfs symlinks.
1176 * - from "slaves" directory of the holder @disk to the claimed @bdev
1177 * - from "holders" directory of the @bdev to the holder @disk
1179 * For example, if /dev/dm-0 maps to /dev/sda and disk for dm-0 is
1180 * passed to bd_link_disk_holder(), then:
1182 * /sys/block/dm-0/slaves/sda --> /sys/block/sda
1183 * /sys/block/sda/holders/dm-0 --> /sys/block/dm-0
1185 * The caller must have claimed @bdev before calling this function and
1186 * ensure that both @bdev and @disk are valid during the creation and
1187 * lifetime of these symlinks.
1193 * 0 on success, -errno on failure.
1195 int bd_link_disk_holder(struct block_device
*bdev
, struct gendisk
*disk
)
1197 struct bd_holder_disk
*holder
;
1200 mutex_lock(&bdev
->bd_mutex
);
1202 WARN_ON_ONCE(!bdev
->bd_holder
);
1204 /* FIXME: remove the following once add_disk() handles errors */
1205 if (WARN_ON(!disk
->slave_dir
|| !bdev
->bd_part
->holder_dir
))
1208 holder
= bd_find_holder_disk(bdev
, disk
);
1214 holder
= kzalloc(sizeof(*holder
), GFP_KERNEL
);
1220 INIT_LIST_HEAD(&holder
->list
);
1221 holder
->disk
= disk
;
1224 ret
= add_symlink(disk
->slave_dir
, &part_to_dev(bdev
->bd_part
)->kobj
);
1228 ret
= add_symlink(bdev
->bd_part
->holder_dir
, &disk_to_dev(disk
)->kobj
);
1232 * bdev could be deleted beneath us which would implicitly destroy
1233 * the holder directory. Hold on to it.
1235 kobject_get(bdev
->bd_part
->holder_dir
);
1237 list_add(&holder
->list
, &bdev
->bd_holder_disks
);
1241 del_symlink(disk
->slave_dir
, &part_to_dev(bdev
->bd_part
)->kobj
);
1245 mutex_unlock(&bdev
->bd_mutex
);
1248 EXPORT_SYMBOL_GPL(bd_link_disk_holder
);
1251 * bd_unlink_disk_holder - destroy symlinks created by bd_link_disk_holder()
1252 * @bdev: the calimed slave bdev
1253 * @disk: the holding disk
1255 * DON'T USE THIS UNLESS YOU'RE ALREADY USING IT.
1260 void bd_unlink_disk_holder(struct block_device
*bdev
, struct gendisk
*disk
)
1262 struct bd_holder_disk
*holder
;
1264 mutex_lock(&bdev
->bd_mutex
);
1266 holder
= bd_find_holder_disk(bdev
, disk
);
1268 if (!WARN_ON_ONCE(holder
== NULL
) && !--holder
->refcnt
) {
1269 del_symlink(disk
->slave_dir
, &part_to_dev(bdev
->bd_part
)->kobj
);
1270 del_symlink(bdev
->bd_part
->holder_dir
,
1271 &disk_to_dev(disk
)->kobj
);
1272 kobject_put(bdev
->bd_part
->holder_dir
);
1273 list_del_init(&holder
->list
);
1277 mutex_unlock(&bdev
->bd_mutex
);
1279 EXPORT_SYMBOL_GPL(bd_unlink_disk_holder
);
1283 * flush_disk - invalidates all buffer-cache entries on a disk
1285 * @bdev: struct block device to be flushed
1286 * @kill_dirty: flag to guide handling of dirty inodes
1288 * Invalidates all buffer-cache entries on a disk. It should be called
1289 * when a disk has been changed -- either by a media change or online
1292 static void flush_disk(struct block_device
*bdev
, bool kill_dirty
)
1294 if (__invalidate_device(bdev
, kill_dirty
)) {
1295 printk(KERN_WARNING
"VFS: busy inodes on changed media or "
1296 "resized disk %s\n",
1297 bdev
->bd_disk
? bdev
->bd_disk
->disk_name
: "");
1302 if (disk_part_scan_enabled(bdev
->bd_disk
))
1303 bdev
->bd_invalidated
= 1;
1307 * check_disk_size_change - checks for disk size change and adjusts bdev size.
1308 * @disk: struct gendisk to check
1309 * @bdev: struct bdev to adjust.
1311 * This routine checks to see if the bdev size does not match the disk size
1312 * and adjusts it if it differs.
1314 void check_disk_size_change(struct gendisk
*disk
, struct block_device
*bdev
)
1316 loff_t disk_size
, bdev_size
;
1318 disk_size
= (loff_t
)get_capacity(disk
) << 9;
1319 bdev_size
= i_size_read(bdev
->bd_inode
);
1320 if (disk_size
!= bdev_size
) {
1322 "%s: detected capacity change from %lld to %lld\n",
1323 disk
->disk_name
, bdev_size
, disk_size
);
1324 i_size_write(bdev
->bd_inode
, disk_size
);
1325 flush_disk(bdev
, false);
1328 EXPORT_SYMBOL(check_disk_size_change
);
1331 * revalidate_disk - wrapper for lower-level driver's revalidate_disk call-back
1332 * @disk: struct gendisk to be revalidated
1334 * This routine is a wrapper for lower-level driver's revalidate_disk
1335 * call-backs. It is used to do common pre and post operations needed
1336 * for all revalidate_disk operations.
1338 int revalidate_disk(struct gendisk
*disk
)
1340 struct block_device
*bdev
;
1343 if (disk
->fops
->revalidate_disk
)
1344 ret
= disk
->fops
->revalidate_disk(disk
);
1345 bdev
= bdget_disk(disk
, 0);
1349 mutex_lock(&bdev
->bd_mutex
);
1350 check_disk_size_change(disk
, bdev
);
1351 bdev
->bd_invalidated
= 0;
1352 mutex_unlock(&bdev
->bd_mutex
);
1356 EXPORT_SYMBOL(revalidate_disk
);
1359 * This routine checks whether a removable media has been changed,
1360 * and invalidates all buffer-cache-entries in that case. This
1361 * is a relatively slow routine, so we have to try to minimize using
1362 * it. Thus it is called only upon a 'mount' or 'open'. This
1363 * is the best way of combining speed and utility, I think.
1364 * People changing diskettes in the middle of an operation deserve
1367 int check_disk_change(struct block_device
*bdev
)
1369 struct gendisk
*disk
= bdev
->bd_disk
;
1370 const struct block_device_operations
*bdops
= disk
->fops
;
1371 unsigned int events
;
1373 events
= disk_clear_events(disk
, DISK_EVENT_MEDIA_CHANGE
|
1374 DISK_EVENT_EJECT_REQUEST
);
1375 if (!(events
& DISK_EVENT_MEDIA_CHANGE
))
1378 flush_disk(bdev
, true);
1379 if (bdops
->revalidate_disk
)
1380 bdops
->revalidate_disk(bdev
->bd_disk
);
1384 EXPORT_SYMBOL(check_disk_change
);
1386 void bd_set_size(struct block_device
*bdev
, loff_t size
)
1388 unsigned bsize
= bdev_logical_block_size(bdev
);
1390 inode_lock(bdev
->bd_inode
);
1391 i_size_write(bdev
->bd_inode
, size
);
1392 inode_unlock(bdev
->bd_inode
);
1393 while (bsize
< PAGE_SIZE
) {
1398 bdev
->bd_block_size
= bsize
;
1399 bdev
->bd_inode
->i_blkbits
= blksize_bits(bsize
);
1401 EXPORT_SYMBOL(bd_set_size
);
1403 static void __blkdev_put(struct block_device
*bdev
, fmode_t mode
, int for_part
);
1408 * mutex_lock(part->bd_mutex)
1409 * mutex_lock_nested(whole->bd_mutex, 1)
1412 static int __blkdev_get(struct block_device
*bdev
, fmode_t mode
, int for_part
)
1414 struct gendisk
*disk
;
1415 struct module
*owner
;
1420 if (mode
& FMODE_READ
)
1422 if (mode
& FMODE_WRITE
)
1425 * hooks: /n/, see "layering violations".
1428 ret
= devcgroup_inode_permission(bdev
->bd_inode
, perm
);
1438 disk
= get_gendisk(bdev
->bd_dev
, &partno
);
1441 owner
= disk
->fops
->owner
;
1443 disk_block_events(disk
);
1444 mutex_lock_nested(&bdev
->bd_mutex
, for_part
);
1445 if (!bdev
->bd_openers
) {
1446 bdev
->bd_disk
= disk
;
1447 bdev
->bd_queue
= disk
->queue
;
1448 bdev
->bd_contains
= bdev
;
1452 bdev
->bd_part
= disk_get_part(disk
, partno
);
1457 if (disk
->fops
->open
) {
1458 ret
= disk
->fops
->open(bdev
, mode
);
1459 if (ret
== -ERESTARTSYS
) {
1460 /* Lost a race with 'disk' being
1461 * deleted, try again.
1464 disk_put_part(bdev
->bd_part
);
1465 bdev
->bd_part
= NULL
;
1466 bdev
->bd_disk
= NULL
;
1467 bdev
->bd_queue
= NULL
;
1468 mutex_unlock(&bdev
->bd_mutex
);
1469 disk_unblock_events(disk
);
1477 bd_set_size(bdev
,(loff_t
)get_capacity(disk
)<<9);
1480 * If the device is invalidated, rescan partition
1481 * if open succeeded or failed with -ENOMEDIUM.
1482 * The latter is necessary to prevent ghost
1483 * partitions on a removed medium.
1485 if (bdev
->bd_invalidated
) {
1487 rescan_partitions(disk
, bdev
);
1488 else if (ret
== -ENOMEDIUM
)
1489 invalidate_partitions(disk
, bdev
);
1495 struct block_device
*whole
;
1496 whole
= bdget_disk(disk
, 0);
1501 ret
= __blkdev_get(whole
, mode
, 1);
1504 bdev
->bd_contains
= whole
;
1505 bdev
->bd_part
= disk_get_part(disk
, partno
);
1506 if (!(disk
->flags
& GENHD_FL_UP
) ||
1507 !bdev
->bd_part
|| !bdev
->bd_part
->nr_sects
) {
1511 bd_set_size(bdev
, (loff_t
)bdev
->bd_part
->nr_sects
<< 9);
1514 if (bdev
->bd_bdi
== &noop_backing_dev_info
)
1515 bdev
->bd_bdi
= bdi_get(disk
->queue
->backing_dev_info
);
1517 if (bdev
->bd_contains
== bdev
) {
1519 if (bdev
->bd_disk
->fops
->open
)
1520 ret
= bdev
->bd_disk
->fops
->open(bdev
, mode
);
1521 /* the same as first opener case, read comment there */
1522 if (bdev
->bd_invalidated
) {
1524 rescan_partitions(bdev
->bd_disk
, bdev
);
1525 else if (ret
== -ENOMEDIUM
)
1526 invalidate_partitions(bdev
->bd_disk
, bdev
);
1529 goto out_unlock_bdev
;
1531 /* only one opener holds refs to the module and disk */
1537 bdev
->bd_part_count
++;
1538 mutex_unlock(&bdev
->bd_mutex
);
1539 disk_unblock_events(disk
);
1543 disk_put_part(bdev
->bd_part
);
1544 bdev
->bd_disk
= NULL
;
1545 bdev
->bd_part
= NULL
;
1546 bdev
->bd_queue
= NULL
;
1547 if (bdev
!= bdev
->bd_contains
)
1548 __blkdev_put(bdev
->bd_contains
, mode
, 1);
1549 bdev
->bd_contains
= NULL
;
1551 mutex_unlock(&bdev
->bd_mutex
);
1552 disk_unblock_events(disk
);
1562 * blkdev_get - open a block device
1563 * @bdev: block_device to open
1564 * @mode: FMODE_* mask
1565 * @holder: exclusive holder identifier
1567 * Open @bdev with @mode. If @mode includes %FMODE_EXCL, @bdev is
1568 * open with exclusive access. Specifying %FMODE_EXCL with %NULL
1569 * @holder is invalid. Exclusive opens may nest for the same @holder.
1571 * On success, the reference count of @bdev is unchanged. On failure,
1578 * 0 on success, -errno on failure.
1580 int blkdev_get(struct block_device
*bdev
, fmode_t mode
, void *holder
)
1582 struct block_device
*whole
= NULL
;
1585 WARN_ON_ONCE((mode
& FMODE_EXCL
) && !holder
);
1587 if ((mode
& FMODE_EXCL
) && holder
) {
1588 whole
= bd_start_claiming(bdev
, holder
);
1589 if (IS_ERR(whole
)) {
1591 return PTR_ERR(whole
);
1595 res
= __blkdev_get(bdev
, mode
, 0);
1598 struct gendisk
*disk
= whole
->bd_disk
;
1600 /* finish claiming */
1601 mutex_lock(&bdev
->bd_mutex
);
1602 spin_lock(&bdev_lock
);
1605 BUG_ON(!bd_may_claim(bdev
, whole
, holder
));
1607 * Note that for a whole device bd_holders
1608 * will be incremented twice, and bd_holder
1609 * will be set to bd_may_claim before being
1612 whole
->bd_holders
++;
1613 whole
->bd_holder
= bd_may_claim
;
1615 bdev
->bd_holder
= holder
;
1618 /* tell others that we're done */
1619 BUG_ON(whole
->bd_claiming
!= holder
);
1620 whole
->bd_claiming
= NULL
;
1621 wake_up_bit(&whole
->bd_claiming
, 0);
1623 spin_unlock(&bdev_lock
);
1626 * Block event polling for write claims if requested. Any
1627 * write holder makes the write_holder state stick until
1628 * all are released. This is good enough and tracking
1629 * individual writeable reference is too fragile given the
1630 * way @mode is used in blkdev_get/put().
1632 if (!res
&& (mode
& FMODE_WRITE
) && !bdev
->bd_write_holder
&&
1633 (disk
->flags
& GENHD_FL_BLOCK_EVENTS_ON_EXCL_WRITE
)) {
1634 bdev
->bd_write_holder
= true;
1635 disk_block_events(disk
);
1638 mutex_unlock(&bdev
->bd_mutex
);
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 if (filp
->f_flags
& O_NDELAY
)
1738 filp
->f_mode
|= FMODE_NDELAY
;
1739 if (filp
->f_flags
& O_EXCL
)
1740 filp
->f_mode
|= FMODE_EXCL
;
1741 if ((filp
->f_flags
& O_ACCMODE
) == 3)
1742 filp
->f_mode
|= FMODE_WRITE_IOCTL
;
1744 bdev
= bd_acquire(inode
);
1748 filp
->f_mapping
= bdev
->bd_inode
->i_mapping
;
1750 return blkdev_get(bdev
, filp
->f_mode
, filp
);
1753 static void __blkdev_put(struct block_device
*bdev
, fmode_t mode
, int for_part
)
1755 struct gendisk
*disk
= bdev
->bd_disk
;
1756 struct block_device
*victim
= NULL
;
1758 mutex_lock_nested(&bdev
->bd_mutex
, for_part
);
1760 bdev
->bd_part_count
--;
1762 if (!--bdev
->bd_openers
) {
1763 WARN_ON_ONCE(bdev
->bd_holders
);
1764 sync_blockdev(bdev
);
1767 bdev_write_inode(bdev
);
1769 if (bdev
->bd_contains
== bdev
) {
1770 if (disk
->fops
->release
)
1771 disk
->fops
->release(disk
, mode
);
1773 if (!bdev
->bd_openers
) {
1774 struct module
*owner
= disk
->fops
->owner
;
1776 disk_put_part(bdev
->bd_part
);
1777 bdev
->bd_part
= NULL
;
1778 bdev
->bd_disk
= NULL
;
1779 if (bdev
!= bdev
->bd_contains
)
1780 victim
= bdev
->bd_contains
;
1781 bdev
->bd_contains
= NULL
;
1786 mutex_unlock(&bdev
->bd_mutex
);
1789 __blkdev_put(victim
, mode
, 1);
1792 void blkdev_put(struct block_device
*bdev
, fmode_t mode
)
1794 mutex_lock(&bdev
->bd_mutex
);
1796 if (mode
& FMODE_EXCL
) {
1800 * Release a claim on the device. The holder fields
1801 * are protected with bdev_lock. bd_mutex is to
1802 * synchronize disk_holder unlinking.
1804 spin_lock(&bdev_lock
);
1806 WARN_ON_ONCE(--bdev
->bd_holders
< 0);
1807 WARN_ON_ONCE(--bdev
->bd_contains
->bd_holders
< 0);
1809 /* bd_contains might point to self, check in a separate step */
1810 if ((bdev_free
= !bdev
->bd_holders
))
1811 bdev
->bd_holder
= NULL
;
1812 if (!bdev
->bd_contains
->bd_holders
)
1813 bdev
->bd_contains
->bd_holder
= NULL
;
1815 spin_unlock(&bdev_lock
);
1818 * If this was the last claim, remove holder link and
1819 * unblock evpoll if it was a write holder.
1821 if (bdev_free
&& bdev
->bd_write_holder
) {
1822 disk_unblock_events(bdev
->bd_disk
);
1823 bdev
->bd_write_holder
= false;
1828 * Trigger event checking and tell drivers to flush MEDIA_CHANGE
1829 * event. This is to ensure detection of media removal commanded
1830 * from userland - e.g. eject(1).
1832 disk_flush_events(bdev
->bd_disk
, DISK_EVENT_MEDIA_CHANGE
);
1834 mutex_unlock(&bdev
->bd_mutex
);
1836 __blkdev_put(bdev
, mode
, 0);
1838 EXPORT_SYMBOL(blkdev_put
);
1840 static int blkdev_close(struct inode
* inode
, struct file
* filp
)
1842 struct block_device
*bdev
= I_BDEV(bdev_file_inode(filp
));
1843 blkdev_put(bdev
, filp
->f_mode
);
1847 static long block_ioctl(struct file
*file
, unsigned cmd
, unsigned long arg
)
1849 struct block_device
*bdev
= I_BDEV(bdev_file_inode(file
));
1850 fmode_t mode
= file
->f_mode
;
1853 * O_NDELAY can be altered using fcntl(.., F_SETFL, ..), so we have
1854 * to updated it before every ioctl.
1856 if (file
->f_flags
& O_NDELAY
)
1857 mode
|= FMODE_NDELAY
;
1859 mode
&= ~FMODE_NDELAY
;
1861 return blkdev_ioctl(bdev
, mode
, cmd
, arg
);
1865 * Write data to the block device. Only intended for the block device itself
1866 * and the raw driver which basically is a fake block device.
1868 * Does not take i_mutex for the write and thus is not for general purpose
1871 ssize_t
blkdev_write_iter(struct kiocb
*iocb
, struct iov_iter
*from
)
1873 struct file
*file
= iocb
->ki_filp
;
1874 struct inode
*bd_inode
= bdev_file_inode(file
);
1875 loff_t size
= i_size_read(bd_inode
);
1876 struct blk_plug plug
;
1879 if (bdev_read_only(I_BDEV(bd_inode
)))
1882 if (!iov_iter_count(from
))
1885 if (iocb
->ki_pos
>= size
)
1888 iov_iter_truncate(from
, size
- iocb
->ki_pos
);
1890 blk_start_plug(&plug
);
1891 ret
= __generic_file_write_iter(iocb
, from
);
1893 ret
= generic_write_sync(iocb
, ret
);
1894 blk_finish_plug(&plug
);
1897 EXPORT_SYMBOL_GPL(blkdev_write_iter
);
1899 ssize_t
blkdev_read_iter(struct kiocb
*iocb
, struct iov_iter
*to
)
1901 struct file
*file
= iocb
->ki_filp
;
1902 struct inode
*bd_inode
= bdev_file_inode(file
);
1903 loff_t size
= i_size_read(bd_inode
);
1904 loff_t pos
= iocb
->ki_pos
;
1910 iov_iter_truncate(to
, size
);
1911 return generic_file_read_iter(iocb
, to
);
1913 EXPORT_SYMBOL_GPL(blkdev_read_iter
);
1916 * Try to release a page associated with block device when the system
1917 * is under memory pressure.
1919 static int blkdev_releasepage(struct page
*page
, gfp_t wait
)
1921 struct super_block
*super
= BDEV_I(page
->mapping
->host
)->bdev
.bd_super
;
1923 if (super
&& super
->s_op
->bdev_try_to_free_page
)
1924 return super
->s_op
->bdev_try_to_free_page(super
, page
, wait
);
1926 return try_to_free_buffers(page
);
1929 static int blkdev_writepages(struct address_space
*mapping
,
1930 struct writeback_control
*wbc
)
1932 if (dax_mapping(mapping
)) {
1933 struct block_device
*bdev
= I_BDEV(mapping
->host
);
1935 return dax_writeback_mapping_range(mapping
, bdev
, wbc
);
1937 return generic_writepages(mapping
, wbc
);
1940 static const struct address_space_operations def_blk_aops
= {
1941 .readpage
= blkdev_readpage
,
1942 .readpages
= blkdev_readpages
,
1943 .writepage
= blkdev_writepage
,
1944 .write_begin
= blkdev_write_begin
,
1945 .write_end
= blkdev_write_end
,
1946 .writepages
= blkdev_writepages
,
1947 .releasepage
= blkdev_releasepage
,
1948 .direct_IO
= blkdev_direct_IO
,
1949 .is_dirty_writeback
= buffer_check_dirty_writeback
,
1952 #define BLKDEV_FALLOC_FL_SUPPORTED \
1953 (FALLOC_FL_KEEP_SIZE | FALLOC_FL_PUNCH_HOLE | \
1954 FALLOC_FL_ZERO_RANGE | FALLOC_FL_NO_HIDE_STALE)
1956 static long blkdev_fallocate(struct file
*file
, int mode
, loff_t start
,
1959 struct block_device
*bdev
= I_BDEV(bdev_file_inode(file
));
1960 struct address_space
*mapping
;
1961 loff_t end
= start
+ len
- 1;
1965 /* Fail if we don't recognize the flags. */
1966 if (mode
& ~BLKDEV_FALLOC_FL_SUPPORTED
)
1969 /* Don't go off the end of the device. */
1970 isize
= i_size_read(bdev
->bd_inode
);
1974 if (mode
& FALLOC_FL_KEEP_SIZE
) {
1975 len
= isize
- start
;
1976 end
= start
+ len
- 1;
1982 * Don't allow IO that isn't aligned to logical block size.
1984 if ((start
| len
) & (bdev_logical_block_size(bdev
) - 1))
1987 /* Invalidate the page cache, including dirty pages. */
1988 mapping
= bdev
->bd_inode
->i_mapping
;
1989 truncate_inode_pages_range(mapping
, start
, end
);
1992 case FALLOC_FL_ZERO_RANGE
:
1993 case FALLOC_FL_ZERO_RANGE
| FALLOC_FL_KEEP_SIZE
:
1994 error
= blkdev_issue_zeroout(bdev
, start
>> 9, len
>> 9,
1995 GFP_KERNEL
, BLKDEV_ZERO_NOUNMAP
);
1997 case FALLOC_FL_PUNCH_HOLE
| FALLOC_FL_KEEP_SIZE
:
1998 error
= blkdev_issue_zeroout(bdev
, start
>> 9, len
>> 9,
1999 GFP_KERNEL
, BLKDEV_ZERO_NOFALLBACK
);
2001 case FALLOC_FL_PUNCH_HOLE
| FALLOC_FL_KEEP_SIZE
| FALLOC_FL_NO_HIDE_STALE
:
2002 error
= blkdev_issue_discard(bdev
, start
>> 9, len
>> 9,
2012 * Invalidate again; if someone wandered in and dirtied a page,
2013 * the caller will be given -EBUSY. The third argument is
2014 * inclusive, so the rounding here is safe.
2016 return invalidate_inode_pages2_range(mapping
,
2017 start
>> PAGE_SHIFT
,
2021 const struct file_operations def_blk_fops
= {
2022 .open
= blkdev_open
,
2023 .release
= blkdev_close
,
2024 .llseek
= block_llseek
,
2025 .read_iter
= blkdev_read_iter
,
2026 .write_iter
= blkdev_write_iter
,
2027 .mmap
= generic_file_mmap
,
2028 .fsync
= blkdev_fsync
,
2029 .unlocked_ioctl
= block_ioctl
,
2030 #ifdef CONFIG_COMPAT
2031 .compat_ioctl
= compat_blkdev_ioctl
,
2033 .splice_read
= generic_file_splice_read
,
2034 .splice_write
= iter_file_splice_write
,
2035 .fallocate
= blkdev_fallocate
,
2038 int ioctl_by_bdev(struct block_device
*bdev
, unsigned cmd
, unsigned long arg
)
2041 mm_segment_t old_fs
= get_fs();
2043 res
= blkdev_ioctl(bdev
, 0, cmd
, arg
);
2048 EXPORT_SYMBOL(ioctl_by_bdev
);
2051 * lookup_bdev - lookup a struct block_device by name
2052 * @pathname: special file representing the block device
2054 * Get a reference to the blockdevice at @pathname in the current
2055 * namespace if possible and return it. Return ERR_PTR(error)
2058 struct block_device
*lookup_bdev(const char *pathname
)
2060 struct block_device
*bdev
;
2061 struct inode
*inode
;
2065 if (!pathname
|| !*pathname
)
2066 return ERR_PTR(-EINVAL
);
2068 error
= kern_path(pathname
, LOOKUP_FOLLOW
, &path
);
2070 return ERR_PTR(error
);
2072 inode
= d_backing_inode(path
.dentry
);
2074 if (!S_ISBLK(inode
->i_mode
))
2077 if (!may_open_dev(&path
))
2080 bdev
= bd_acquire(inode
);
2087 bdev
= ERR_PTR(error
);
2090 EXPORT_SYMBOL(lookup_bdev
);
2092 int __invalidate_device(struct block_device
*bdev
, bool kill_dirty
)
2094 struct super_block
*sb
= get_super(bdev
);
2099 * no need to lock the super, get_super holds the
2100 * read mutex so the filesystem cannot go away
2101 * under us (->put_super runs with the write lock
2104 shrink_dcache_sb(sb
);
2105 res
= invalidate_inodes(sb
, kill_dirty
);
2108 invalidate_bdev(bdev
);
2111 EXPORT_SYMBOL(__invalidate_device
);
2113 void iterate_bdevs(void (*func
)(struct block_device
*, void *), void *arg
)
2115 struct inode
*inode
, *old_inode
= NULL
;
2117 spin_lock(&blockdev_superblock
->s_inode_list_lock
);
2118 list_for_each_entry(inode
, &blockdev_superblock
->s_inodes
, i_sb_list
) {
2119 struct address_space
*mapping
= inode
->i_mapping
;
2120 struct block_device
*bdev
;
2122 spin_lock(&inode
->i_lock
);
2123 if (inode
->i_state
& (I_FREEING
|I_WILL_FREE
|I_NEW
) ||
2124 mapping
->nrpages
== 0) {
2125 spin_unlock(&inode
->i_lock
);
2129 spin_unlock(&inode
->i_lock
);
2130 spin_unlock(&blockdev_superblock
->s_inode_list_lock
);
2132 * We hold a reference to 'inode' so it couldn't have been
2133 * removed from s_inodes list while we dropped the
2134 * s_inode_list_lock We cannot iput the inode now as we can
2135 * be holding the last reference and we cannot iput it under
2136 * s_inode_list_lock. So we keep the reference and iput it
2141 bdev
= I_BDEV(inode
);
2143 mutex_lock(&bdev
->bd_mutex
);
2144 if (bdev
->bd_openers
)
2146 mutex_unlock(&bdev
->bd_mutex
);
2148 spin_lock(&blockdev_superblock
->s_inode_list_lock
);
2150 spin_unlock(&blockdev_superblock
->s_inode_list_lock
);