]> git.proxmox.com Git - mirror_ubuntu-jammy-kernel.git/blame - drivers/block/brd.c
skd_main: remove unused including <linux/version.h>
[mirror_ubuntu-jammy-kernel.git] / drivers / block / brd.c
CommitLineData
09c434b8 1// SPDX-License-Identifier: GPL-2.0-only
9db5579b
NP
2/*
3 * Ram backed block device driver.
4 *
5 * Copyright (C) 2007 Nick Piggin
6 * Copyright (C) 2007 Novell Inc.
7 *
8 * Parts derived from drivers/block/rd.c, and drivers/block/loop.c, copyright
9 * of their respective owners.
10 */
11
12#include <linux/init.h>
287f3ca5 13#include <linux/initrd.h>
9db5579b
NP
14#include <linux/module.h>
15#include <linux/moduleparam.h>
16#include <linux/major.h>
17#include <linux/blkdev.h>
18#include <linux/bio.h>
19#include <linux/highmem.h>
2a48fc0a 20#include <linux/mutex.h>
9db5579b 21#include <linux/radix-tree.h>
ff01bb48 22#include <linux/fs.h>
5a0e3ad6 23#include <linux/slab.h>
23c47d2a 24#include <linux/backing-dev.h>
9db5579b 25
7c0f6ba6 26#include <linux/uaccess.h>
9db5579b 27
9db5579b
NP
28#define PAGE_SECTORS_SHIFT (PAGE_SHIFT - SECTOR_SHIFT)
29#define PAGE_SECTORS (1 << PAGE_SECTORS_SHIFT)
30
31/*
32 * Each block ramdisk device has a radix_tree brd_pages of pages that stores
33 * the pages containing the block device's contents. A brd page's ->index is
34 * its offset in PAGE_SIZE units. This is similar to, but in no way connected
35 * with, the kernel's pagecache or buffer cache (which sit above our block
36 * device).
37 */
38struct brd_device {
39 int brd_number;
9db5579b
NP
40
41 struct request_queue *brd_queue;
42 struct gendisk *brd_disk;
43 struct list_head brd_list;
44
45 /*
46 * Backing store of pages and lock to protect it. This is the contents
47 * of the block device.
48 */
49 spinlock_t brd_lock;
50 struct radix_tree_root brd_pages;
51};
52
53/*
54 * Look up and return a brd's page for a given sector.
55 */
56static struct page *brd_lookup_page(struct brd_device *brd, sector_t sector)
57{
58 pgoff_t idx;
59 struct page *page;
60
61 /*
62 * The page lifetime is protected by the fact that we have opened the
63 * device node -- brd pages will never be deleted under us, so we
64 * don't need any further locking or refcounting.
65 *
66 * This is strictly true for the radix-tree nodes as well (ie. we
67 * don't actually need the rcu_read_lock()), however that is not a
68 * documented feature of the radix-tree API so it is better to be
69 * safe here (we don't have total exclusion from radix tree updates
70 * here, only deletes).
71 */
72 rcu_read_lock();
73 idx = sector >> PAGE_SECTORS_SHIFT; /* sector to page index */
74 page = radix_tree_lookup(&brd->brd_pages, idx);
75 rcu_read_unlock();
76
77 BUG_ON(page && page->index != idx);
78
79 return page;
80}
81
82/*
83 * Look up and return a brd's page for a given sector.
84 * If one does not exist, allocate an empty page, and insert that. Then
85 * return it.
86 */
87static struct page *brd_insert_page(struct brd_device *brd, sector_t sector)
88{
89 pgoff_t idx;
90 struct page *page;
75acb9cd 91 gfp_t gfp_flags;
9db5579b
NP
92
93 page = brd_lookup_page(brd, sector);
94 if (page)
95 return page;
96
97 /*
98 * Must use NOIO because we don't want to recurse back into the
99 * block or filesystem layers from page reclaim.
100 */
f6b50160 101 gfp_flags = GFP_NOIO | __GFP_ZERO | __GFP_HIGHMEM;
26defe34 102 page = alloc_page(gfp_flags);
9db5579b
NP
103 if (!page)
104 return NULL;
105
106 if (radix_tree_preload(GFP_NOIO)) {
107 __free_page(page);
108 return NULL;
109 }
110
111 spin_lock(&brd->brd_lock);
112 idx = sector >> PAGE_SECTORS_SHIFT;
dfd20b2b 113 page->index = idx;
9db5579b
NP
114 if (radix_tree_insert(&brd->brd_pages, idx, page)) {
115 __free_page(page);
116 page = radix_tree_lookup(&brd->brd_pages, idx);
117 BUG_ON(!page);
118 BUG_ON(page->index != idx);
dfd20b2b 119 }
9db5579b
NP
120 spin_unlock(&brd->brd_lock);
121
122 radix_tree_preload_end();
123
124 return page;
125}
126
127/*
128 * Free all backing store pages and radix tree. This must only be called when
129 * there are no other users of the device.
130 */
131#define FREE_BATCH 16
132static void brd_free_pages(struct brd_device *brd)
133{
134 unsigned long pos = 0;
135 struct page *pages[FREE_BATCH];
136 int nr_pages;
137
138 do {
139 int i;
140
141 nr_pages = radix_tree_gang_lookup(&brd->brd_pages,
142 (void **)pages, pos, FREE_BATCH);
143
144 for (i = 0; i < nr_pages; i++) {
145 void *ret;
146
147 BUG_ON(pages[i]->index < pos);
148 pos = pages[i]->index;
149 ret = radix_tree_delete(&brd->brd_pages, pos);
150 BUG_ON(!ret || ret != pages[i]);
151 __free_page(pages[i]);
152 }
153
154 pos++;
155
936b33f7
MP
156 /*
157 * It takes 3.4 seconds to remove 80GiB ramdisk.
158 * So, we need cond_resched to avoid stalling the CPU.
159 */
160 cond_resched();
161
9db5579b
NP
162 /*
163 * This assumes radix_tree_gang_lookup always returns as
164 * many pages as possible. If the radix-tree code changes,
165 * so will this have to.
166 */
167 } while (nr_pages == FREE_BATCH);
168}
169
170/*
171 * copy_to_brd_setup must be called before copy_to_brd. It may sleep.
172 */
173static int copy_to_brd_setup(struct brd_device *brd, sector_t sector, size_t n)
174{
175 unsigned int offset = (sector & (PAGE_SECTORS-1)) << SECTOR_SHIFT;
176 size_t copy;
177
178 copy = min_t(size_t, n, PAGE_SIZE - offset);
179 if (!brd_insert_page(brd, sector))
96f8d8e0 180 return -ENOSPC;
9db5579b
NP
181 if (copy < n) {
182 sector += copy >> SECTOR_SHIFT;
183 if (!brd_insert_page(brd, sector))
96f8d8e0 184 return -ENOSPC;
9db5579b
NP
185 }
186 return 0;
187}
188
189/*
190 * Copy n bytes from src to the brd starting at sector. Does not sleep.
191 */
192static void copy_to_brd(struct brd_device *brd, const void *src,
193 sector_t sector, size_t n)
194{
195 struct page *page;
196 void *dst;
197 unsigned int offset = (sector & (PAGE_SECTORS-1)) << SECTOR_SHIFT;
198 size_t copy;
199
200 copy = min_t(size_t, n, PAGE_SIZE - offset);
201 page = brd_lookup_page(brd, sector);
202 BUG_ON(!page);
203
cfd8005c 204 dst = kmap_atomic(page);
9db5579b 205 memcpy(dst + offset, src, copy);
cfd8005c 206 kunmap_atomic(dst);
9db5579b
NP
207
208 if (copy < n) {
209 src += copy;
210 sector += copy >> SECTOR_SHIFT;
211 copy = n - copy;
212 page = brd_lookup_page(brd, sector);
213 BUG_ON(!page);
214
cfd8005c 215 dst = kmap_atomic(page);
9db5579b 216 memcpy(dst, src, copy);
cfd8005c 217 kunmap_atomic(dst);
9db5579b
NP
218 }
219}
220
221/*
222 * Copy n bytes to dst from the brd starting at sector. Does not sleep.
223 */
224static void copy_from_brd(void *dst, struct brd_device *brd,
225 sector_t sector, size_t n)
226{
227 struct page *page;
228 void *src;
229 unsigned int offset = (sector & (PAGE_SECTORS-1)) << SECTOR_SHIFT;
230 size_t copy;
231
232 copy = min_t(size_t, n, PAGE_SIZE - offset);
233 page = brd_lookup_page(brd, sector);
234 if (page) {
cfd8005c 235 src = kmap_atomic(page);
9db5579b 236 memcpy(dst, src + offset, copy);
cfd8005c 237 kunmap_atomic(src);
9db5579b
NP
238 } else
239 memset(dst, 0, copy);
240
241 if (copy < n) {
242 dst += copy;
243 sector += copy >> SECTOR_SHIFT;
244 copy = n - copy;
245 page = brd_lookup_page(brd, sector);
246 if (page) {
cfd8005c 247 src = kmap_atomic(page);
9db5579b 248 memcpy(dst, src, copy);
cfd8005c 249 kunmap_atomic(src);
9db5579b
NP
250 } else
251 memset(dst, 0, copy);
252 }
253}
254
255/*
256 * Process a single bvec of a bio.
257 */
258static int brd_do_bvec(struct brd_device *brd, struct page *page,
3f289dcb 259 unsigned int len, unsigned int off, unsigned int op,
9db5579b
NP
260 sector_t sector)
261{
262 void *mem;
263 int err = 0;
264
3f289dcb 265 if (op_is_write(op)) {
9db5579b
NP
266 err = copy_to_brd_setup(brd, sector, len);
267 if (err)
268 goto out;
269 }
270
cfd8005c 271 mem = kmap_atomic(page);
3f289dcb 272 if (!op_is_write(op)) {
9db5579b
NP
273 copy_from_brd(mem + off, brd, sector, len);
274 flush_dcache_page(page);
c2572f2b
NP
275 } else {
276 flush_dcache_page(page);
9db5579b 277 copy_to_brd(brd, mem + off, sector, len);
c2572f2b 278 }
cfd8005c 279 kunmap_atomic(mem);
9db5579b
NP
280
281out:
282 return err;
283}
284
c62b37d9 285static blk_qc_t brd_submit_bio(struct bio *bio)
9db5579b 286{
74d46992 287 struct brd_device *brd = bio->bi_disk->private_data;
7988613b 288 struct bio_vec bvec;
9db5579b 289 sector_t sector;
7988613b 290 struct bvec_iter iter;
9db5579b 291
4f024f37 292 sector = bio->bi_iter.bi_sector;
74d46992 293 if (bio_end_sector(bio) > get_capacity(bio->bi_disk))
4246a0b6 294 goto io_error;
9db5579b 295
7988613b
KO
296 bio_for_each_segment(bvec, bio, iter) {
297 unsigned int len = bvec.bv_len;
4246a0b6
CH
298 int err;
299
f1acbf21
ML
300 /* Don't support un-aligned buffer */
301 WARN_ON_ONCE((bvec.bv_offset & (SECTOR_SIZE - 1)) ||
302 (len & (SECTOR_SIZE - 1)));
303
c11f0c0b 304 err = brd_do_bvec(brd, bvec.bv_page, len, bvec.bv_offset,
3f289dcb 305 bio_op(bio), sector);
9db5579b 306 if (err)
4246a0b6 307 goto io_error;
9db5579b
NP
308 sector += len >> SECTOR_SHIFT;
309 }
310
4246a0b6 311 bio_endio(bio);
dece1635 312 return BLK_QC_T_NONE;
4246a0b6
CH
313io_error:
314 bio_io_error(bio);
dece1635 315 return BLK_QC_T_NONE;
9db5579b
NP
316}
317
a72132c3 318static int brd_rw_page(struct block_device *bdev, sector_t sector,
3f289dcb 319 struct page *page, unsigned int op)
a72132c3
MW
320{
321 struct brd_device *brd = bdev->bd_disk->private_data;
98cc093c
HY
322 int err;
323
324 if (PageTransHuge(page))
325 return -ENOTSUPP;
3f289dcb
TH
326 err = brd_do_bvec(brd, page, PAGE_SIZE, 0, op, sector);
327 page_endio(page, op_is_write(op), err);
a72132c3
MW
328 return err;
329}
330
83d5cde4 331static const struct block_device_operations brd_fops = {
75acb9cd 332 .owner = THIS_MODULE,
c62b37d9 333 .submit_bio = brd_submit_bio,
a72132c3 334 .rw_page = brd_rw_page,
9db5579b
NP
335};
336
337/*
338 * And now the modules code and kernel interface.
339 */
937af5ec 340static int rd_nr = CONFIG_BLK_DEV_RAM_COUNT;
5657a819 341module_param(rd_nr, int, 0444);
9db5579b 342MODULE_PARM_DESC(rd_nr, "Maximum number of brd devices");
937af5ec 343
366f4aea 344unsigned long rd_size = CONFIG_BLK_DEV_RAM_SIZE;
5657a819 345module_param(rd_size, ulong, 0444);
9db5579b 346MODULE_PARM_DESC(rd_size, "Size of each RAM disk in kbytes.");
937af5ec
BH
347
348static int max_part = 1;
5657a819 349module_param(max_part, int, 0444);
937af5ec
BH
350MODULE_PARM_DESC(max_part, "Num Minors to reserve between devices");
351
9db5579b
NP
352MODULE_LICENSE("GPL");
353MODULE_ALIAS_BLOCKDEV_MAJOR(RAMDISK_MAJOR);
efedf51c 354MODULE_ALIAS("rd");
9db5579b
NP
355
356#ifndef MODULE
357/* Legacy boot options - nonmodular */
358static int __init ramdisk_size(char *str)
359{
360 rd_size = simple_strtol(str, NULL, 0);
361 return 1;
362}
1adbee50 363__setup("ramdisk_size=", ramdisk_size);
9db5579b
NP
364#endif
365
366/*
367 * The device scheme is derived from loop.c. Keep them in synch where possible
368 * (should share code eventually).
369 */
370static LIST_HEAD(brd_devices);
371static DEFINE_MUTEX(brd_devices_mutex);
372
373static struct brd_device *brd_alloc(int i)
374{
375 struct brd_device *brd;
376 struct gendisk *disk;
377
378 brd = kzalloc(sizeof(*brd), GFP_KERNEL);
379 if (!brd)
380 goto out;
381 brd->brd_number = i;
382 spin_lock_init(&brd->brd_lock);
383 INIT_RADIX_TREE(&brd->brd_pages, GFP_ATOMIC);
384
c62b37d9 385 brd->brd_queue = blk_alloc_queue(NUMA_NO_NODE);
9db5579b
NP
386 if (!brd->brd_queue)
387 goto out_free_dev;
c8fa3173 388
c8fa3173
BH
389 /* This is so fdisk will align partitions on 4k, because of
390 * direct_access API needing 4k alignment, returning a PFN
391 * (This is only a problem on very small devices <= 4M,
392 * otherwise fdisk will align on 1M. Regardless this call
393 * is harmless)
394 */
395 blk_queue_physical_block_size(brd->brd_queue, PAGE_SIZE);
937af5ec 396 disk = brd->brd_disk = alloc_disk(max_part);
9db5579b
NP
397 if (!disk)
398 goto out_free_queue;
399 disk->major = RAMDISK_MAJOR;
937af5ec 400 disk->first_minor = i * max_part;
9db5579b
NP
401 disk->fops = &brd_fops;
402 disk->private_data = brd;
937af5ec 403 disk->flags = GENHD_FL_EXT_DEVT;
9db5579b
NP
404 sprintf(disk->disk_name, "ram%d", i);
405 set_capacity(disk, rd_size * 2);
406
316ba573 407 /* Tell the block layer that this is not a rotational device */
153fcd5f
ML
408 blk_queue_flag_set(QUEUE_FLAG_NONROT, brd->brd_queue);
409 blk_queue_flag_clear(QUEUE_FLAG_ADD_RANDOM, brd->brd_queue);
316ba573 410
9db5579b
NP
411 return brd;
412
413out_free_queue:
414 blk_cleanup_queue(brd->brd_queue);
415out_free_dev:
416 kfree(brd);
417out:
418 return NULL;
419}
420
421static void brd_free(struct brd_device *brd)
422{
423 put_disk(brd->brd_disk);
424 blk_cleanup_queue(brd->brd_queue);
425 brd_free_pages(brd);
426 kfree(brd);
427}
428
937af5ec 429static struct brd_device *brd_init_one(int i, bool *new)
9db5579b
NP
430{
431 struct brd_device *brd;
432
937af5ec 433 *new = false;
9db5579b
NP
434 list_for_each_entry(brd, &brd_devices, brd_list) {
435 if (brd->brd_number == i)
436 goto out;
437 }
438
439 brd = brd_alloc(i);
440 if (brd) {
153fcd5f 441 brd->brd_disk->queue = brd->brd_queue;
9db5579b
NP
442 add_disk(brd->brd_disk);
443 list_add_tail(&brd->brd_list, &brd_devices);
444 }
937af5ec 445 *new = true;
9db5579b
NP
446out:
447 return brd;
448}
449
450static void brd_del_one(struct brd_device *brd)
451{
452 list_del(&brd->brd_list);
453 del_gendisk(brd->brd_disk);
454 brd_free(brd);
455}
456
457static struct kobject *brd_probe(dev_t dev, int *part, void *data)
458{
459 struct brd_device *brd;
460 struct kobject *kobj;
937af5ec 461 bool new;
9db5579b
NP
462
463 mutex_lock(&brd_devices_mutex);
937af5ec 464 brd = brd_init_one(MINOR(dev) / max_part, &new);
3079c22e 465 kobj = brd ? get_disk_and_module(brd->brd_disk) : NULL;
9db5579b
NP
466 mutex_unlock(&brd_devices_mutex);
467
937af5ec
BH
468 if (new)
469 *part = 0;
470
9db5579b
NP
471 return kobj;
472}
473
c8ab4225
ZL
474static inline void brd_check_and_reset_par(void)
475{
476 if (unlikely(!max_part))
477 max_part = 1;
478
479 /*
480 * make sure 'max_part' can be divided exactly by (1U << MINORBITS),
481 * otherwise, it is possiable to get same dev_t when adding partitions.
482 */
483 if ((1U << MINORBITS) % max_part != 0)
484 max_part = 1UL << fls(max_part);
485
486 if (max_part > DISK_MAX_PARTS) {
487 pr_info("brd: max_part can't be larger than %d, reset max_part = %d.\n",
488 DISK_MAX_PARTS, DISK_MAX_PARTS);
489 max_part = DISK_MAX_PARTS;
490 }
491}
492
9db5579b
NP
493static int __init brd_init(void)
494{
9db5579b 495 struct brd_device *brd, *next;
937af5ec 496 int i;
9db5579b
NP
497
498 /*
499 * brd module now has a feature to instantiate underlying device
500 * structure on-demand, provided that there is an access dev node.
9db5579b 501 *
937af5ec
BH
502 * (1) if rd_nr is specified, create that many upfront. else
503 * it defaults to CONFIG_BLK_DEV_RAM_COUNT
504 * (2) User can further extend brd devices by create dev node themselves
505 * and have kernel automatically instantiate actual device
506 * on-demand. Example:
507 * mknod /path/devnod_name b 1 X # 1 is the rd major
508 * fdisk -l /path/devnod_name
509 * If (X / max_part) was not already created it will be created
510 * dynamically.
9db5579b 511 */
d7853d1f 512
9db5579b
NP
513 if (register_blkdev(RAMDISK_MAJOR, "ramdisk"))
514 return -EIO;
515
c8ab4225 516 brd_check_and_reset_par();
937af5ec
BH
517
518 for (i = 0; i < rd_nr; i++) {
9db5579b
NP
519 brd = brd_alloc(i);
520 if (!brd)
521 goto out_free;
522 list_add_tail(&brd->brd_list, &brd_devices);
523 }
524
525 /* point of no return */
526
153fcd5f
ML
527 list_for_each_entry(brd, &brd_devices, brd_list) {
528 /*
529 * associate with queue just before adding disk for
530 * avoiding to mess up failure path
531 */
532 brd->brd_disk->queue = brd->brd_queue;
9db5579b 533 add_disk(brd->brd_disk);
153fcd5f 534 }
9db5579b 535
937af5ec 536 blk_register_region(MKDEV(RAMDISK_MAJOR, 0), 1UL << MINORBITS,
9db5579b
NP
537 THIS_MODULE, brd_probe, NULL, NULL);
538
937af5ec 539 pr_info("brd: module loaded\n");
9db5579b
NP
540 return 0;
541
542out_free:
543 list_for_each_entry_safe(brd, next, &brd_devices, brd_list) {
544 list_del(&brd->brd_list);
545 brd_free(brd);
546 }
c82f2966 547 unregister_blkdev(RAMDISK_MAJOR, "ramdisk");
9db5579b 548
937af5ec 549 pr_info("brd: module NOT loaded !!!\n");
9db5579b
NP
550 return -ENOMEM;
551}
552
553static void __exit brd_exit(void)
554{
9db5579b
NP
555 struct brd_device *brd, *next;
556
9db5579b
NP
557 list_for_each_entry_safe(brd, next, &brd_devices, brd_list)
558 brd_del_one(brd);
559
937af5ec 560 blk_unregister_region(MKDEV(RAMDISK_MAJOR, 0), 1UL << MINORBITS);
9db5579b 561 unregister_blkdev(RAMDISK_MAJOR, "ramdisk");
937af5ec
BH
562
563 pr_info("brd: module unloaded\n");
9db5579b
NP
564}
565
566module_init(brd_init);
567module_exit(brd_exit);
568