2 * Compressed RAM block device
4 * Copyright (C) 2008, 2009, 2010 Nitin Gupta
5 * 2012, 2013 Minchan Kim
7 * This code is released using a dual license strategy: BSD/GPL
8 * You can choose the licence that better fits your requirements.
10 * Released under the terms of 3-clause BSD License
11 * Released under the terms of GNU General Public License Version 2.0
15 #define KMSG_COMPONENT "zram"
16 #define pr_fmt(fmt) KMSG_COMPONENT ": " fmt
18 #include <linux/module.h>
19 #include <linux/kernel.h>
20 #include <linux/bio.h>
21 #include <linux/bitops.h>
22 #include <linux/blkdev.h>
23 #include <linux/buffer_head.h>
24 #include <linux/device.h>
25 #include <linux/genhd.h>
26 #include <linux/highmem.h>
27 #include <linux/slab.h>
28 #include <linux/backing-dev.h>
29 #include <linux/string.h>
30 #include <linux/vmalloc.h>
31 #include <linux/err.h>
32 #include <linux/idr.h>
33 #include <linux/sysfs.h>
34 #include <linux/cpuhotplug.h>
38 static DEFINE_IDR(zram_index_idr);
39 /* idr index must be protected */
40 static DEFINE_MUTEX(zram_index_mutex);
42 static int zram_major;
43 static const char *default_compressor = "lzo";
45 /* Module params (documentation at end) */
46 static unsigned int num_devices = 1;
48 static void zram_free_page(struct zram *zram, size_t index);
50 static inline bool init_done(struct zram *zram)
52 return zram->disksize;
55 static inline struct zram *dev_to_zram(struct device *dev)
57 return (struct zram *)dev_to_disk(dev)->private_data;
60 static unsigned long zram_get_handle(struct zram *zram, u32 index)
62 return zram->table[index].handle;
65 static void zram_set_handle(struct zram *zram, u32 index, unsigned long handle)
67 zram->table[index].handle = handle;
70 /* flag operations require table entry bit_spin_lock() being held */
71 static int zram_test_flag(struct zram *zram, u32 index,
72 enum zram_pageflags flag)
74 return zram->table[index].value & BIT(flag);
77 static void zram_set_flag(struct zram *zram, u32 index,
78 enum zram_pageflags flag)
80 zram->table[index].value |= BIT(flag);
83 static void zram_clear_flag(struct zram *zram, u32 index,
84 enum zram_pageflags flag)
86 zram->table[index].value &= ~BIT(flag);
89 static inline void zram_set_element(struct zram *zram, u32 index,
90 unsigned long element)
92 zram->table[index].element = element;
95 static unsigned long zram_get_element(struct zram *zram, u32 index)
97 return zram->table[index].element;
100 static size_t zram_get_obj_size(struct zram *zram, u32 index)
102 return zram->table[index].value & (BIT(ZRAM_FLAG_SHIFT) - 1);
105 static void zram_set_obj_size(struct zram *zram,
106 u32 index, size_t size)
108 unsigned long flags = zram->table[index].value >> ZRAM_FLAG_SHIFT;
110 zram->table[index].value = (flags << ZRAM_FLAG_SHIFT) | size;
113 #if PAGE_SIZE != 4096
114 static inline bool is_partial_io(struct bio_vec *bvec)
116 return bvec->bv_len != PAGE_SIZE;
119 static inline bool is_partial_io(struct bio_vec *bvec)
125 static void zram_revalidate_disk(struct zram *zram)
127 revalidate_disk(zram->disk);
128 /* revalidate_disk reset the BDI_CAP_STABLE_WRITES so set again */
129 zram->disk->queue->backing_dev_info->capabilities |=
130 BDI_CAP_STABLE_WRITES;
134 * Check if request is within bounds and aligned on zram logical blocks.
136 static inline bool valid_io_request(struct zram *zram,
137 sector_t start, unsigned int size)
141 /* unaligned request */
142 if (unlikely(start & (ZRAM_SECTOR_PER_LOGICAL_BLOCK - 1)))
144 if (unlikely(size & (ZRAM_LOGICAL_BLOCK_SIZE - 1)))
147 end = start + (size >> SECTOR_SHIFT);
148 bound = zram->disksize >> SECTOR_SHIFT;
149 /* out of range range */
150 if (unlikely(start >= bound || end > bound || start > end))
153 /* I/O request is valid */
157 static void update_position(u32 *index, int *offset, struct bio_vec *bvec)
159 *index += (*offset + bvec->bv_len) / PAGE_SIZE;
160 *offset = (*offset + bvec->bv_len) % PAGE_SIZE;
163 static inline void update_used_max(struct zram *zram,
164 const unsigned long pages)
166 unsigned long old_max, cur_max;
168 old_max = atomic_long_read(&zram->stats.max_used_pages);
173 old_max = atomic_long_cmpxchg(
174 &zram->stats.max_used_pages, cur_max, pages);
175 } while (old_max != cur_max);
178 static inline void zram_fill_page(void *ptr, unsigned long len,
181 WARN_ON_ONCE(!IS_ALIGNED(len, sizeof(unsigned long)));
182 memset_l(ptr, value, len / sizeof(unsigned long));
185 static bool page_same_filled(void *ptr, unsigned long *element)
191 page = (unsigned long *)ptr;
194 for (pos = 1; pos < PAGE_SIZE / sizeof(*page); pos++) {
195 if (val != page[pos])
204 static ssize_t initstate_show(struct device *dev,
205 struct device_attribute *attr, char *buf)
208 struct zram *zram = dev_to_zram(dev);
210 down_read(&zram->init_lock);
211 val = init_done(zram);
212 up_read(&zram->init_lock);
214 return scnprintf(buf, PAGE_SIZE, "%u\n", val);
217 static ssize_t disksize_show(struct device *dev,
218 struct device_attribute *attr, char *buf)
220 struct zram *zram = dev_to_zram(dev);
222 return scnprintf(buf, PAGE_SIZE, "%llu\n", zram->disksize);
225 static ssize_t mem_limit_store(struct device *dev,
226 struct device_attribute *attr, const char *buf, size_t len)
230 struct zram *zram = dev_to_zram(dev);
232 limit = memparse(buf, &tmp);
233 if (buf == tmp) /* no chars parsed, invalid input */
236 down_write(&zram->init_lock);
237 zram->limit_pages = PAGE_ALIGN(limit) >> PAGE_SHIFT;
238 up_write(&zram->init_lock);
243 static ssize_t mem_used_max_store(struct device *dev,
244 struct device_attribute *attr, const char *buf, size_t len)
248 struct zram *zram = dev_to_zram(dev);
250 err = kstrtoul(buf, 10, &val);
254 down_read(&zram->init_lock);
255 if (init_done(zram)) {
256 atomic_long_set(&zram->stats.max_used_pages,
257 zs_get_total_pages(zram->mem_pool));
259 up_read(&zram->init_lock);
264 #ifdef CONFIG_ZRAM_WRITEBACK
265 static bool zram_wb_enabled(struct zram *zram)
267 return zram->backing_dev;
270 static void reset_bdev(struct zram *zram)
272 struct block_device *bdev;
274 if (!zram_wb_enabled(zram))
278 if (zram->old_block_size)
279 set_blocksize(bdev, zram->old_block_size);
280 blkdev_put(bdev, FMODE_READ|FMODE_WRITE|FMODE_EXCL);
281 /* hope filp_close flush all of IO */
282 filp_close(zram->backing_dev, NULL);
283 zram->backing_dev = NULL;
284 zram->old_block_size = 0;
287 kvfree(zram->bitmap);
291 static ssize_t backing_dev_show(struct device *dev,
292 struct device_attribute *attr, char *buf)
294 struct zram *zram = dev_to_zram(dev);
295 struct file *file = zram->backing_dev;
299 down_read(&zram->init_lock);
300 if (!zram_wb_enabled(zram)) {
301 memcpy(buf, "none\n", 5);
302 up_read(&zram->init_lock);
306 p = file_path(file, buf, PAGE_SIZE - 1);
313 memmove(buf, p, ret);
316 up_read(&zram->init_lock);
320 static ssize_t backing_dev_store(struct device *dev,
321 struct device_attribute *attr, const char *buf, size_t len)
324 struct file *backing_dev = NULL;
326 struct address_space *mapping;
327 unsigned int bitmap_sz, old_block_size = 0;
328 unsigned long nr_pages, *bitmap = NULL;
329 struct block_device *bdev = NULL;
331 struct zram *zram = dev_to_zram(dev);
333 file_name = kmalloc(PATH_MAX, GFP_KERNEL);
337 down_write(&zram->init_lock);
338 if (init_done(zram)) {
339 pr_info("Can't setup backing device for initialized device\n");
344 strlcpy(file_name, buf, len);
346 backing_dev = filp_open(file_name, O_RDWR|O_LARGEFILE, 0);
347 if (IS_ERR(backing_dev)) {
348 err = PTR_ERR(backing_dev);
353 mapping = backing_dev->f_mapping;
354 inode = mapping->host;
356 /* Support only block device in this moment */
357 if (!S_ISBLK(inode->i_mode)) {
362 bdev = bdgrab(I_BDEV(inode));
363 err = blkdev_get(bdev, FMODE_READ | FMODE_WRITE | FMODE_EXCL, zram);
367 nr_pages = i_size_read(inode) >> PAGE_SHIFT;
368 bitmap_sz = BITS_TO_LONGS(nr_pages) * sizeof(long);
369 bitmap = kvzalloc(bitmap_sz, GFP_KERNEL);
375 old_block_size = block_size(bdev);
376 err = set_blocksize(bdev, PAGE_SIZE);
381 spin_lock_init(&zram->bitmap_lock);
383 zram->old_block_size = old_block_size;
385 zram->backing_dev = backing_dev;
386 zram->bitmap = bitmap;
387 zram->nr_pages = nr_pages;
388 up_write(&zram->init_lock);
390 pr_info("setup backing device %s\n", file_name);
399 blkdev_put(bdev, FMODE_READ | FMODE_WRITE | FMODE_EXCL);
402 filp_close(backing_dev, NULL);
404 up_write(&zram->init_lock);
411 static unsigned long get_entry_bdev(struct zram *zram)
415 spin_lock(&zram->bitmap_lock);
416 /* skip 0 bit to confuse zram.handle = 0 */
417 entry = find_next_zero_bit(zram->bitmap, zram->nr_pages, 1);
418 if (entry == zram->nr_pages) {
419 spin_unlock(&zram->bitmap_lock);
423 set_bit(entry, zram->bitmap);
424 spin_unlock(&zram->bitmap_lock);
429 static void put_entry_bdev(struct zram *zram, unsigned long entry)
433 spin_lock(&zram->bitmap_lock);
434 was_set = test_and_clear_bit(entry, zram->bitmap);
435 spin_unlock(&zram->bitmap_lock);
436 WARN_ON_ONCE(!was_set);
439 void zram_page_end_io(struct bio *bio)
441 struct page *page = bio->bi_io_vec[0].bv_page;
443 page_endio(page, op_is_write(bio_op(bio)),
444 blk_status_to_errno(bio->bi_status));
449 * Returns 1 if the submission is successful.
451 static int read_from_bdev_async(struct zram *zram, struct bio_vec *bvec,
452 unsigned long entry, struct bio *parent)
456 bio = bio_alloc(GFP_ATOMIC, 1);
460 bio->bi_iter.bi_sector = entry * (PAGE_SIZE >> 9);
461 bio_set_dev(bio, zram->bdev);
462 if (!bio_add_page(bio, bvec->bv_page, bvec->bv_len, bvec->bv_offset)) {
468 bio->bi_opf = REQ_OP_READ;
469 bio->bi_end_io = zram_page_end_io;
471 bio->bi_opf = parent->bi_opf;
472 bio_chain(bio, parent);
480 struct work_struct work;
486 #if PAGE_SIZE != 4096
487 static void zram_sync_read(struct work_struct *work)
490 struct zram_work *zw = container_of(work, struct zram_work, work);
491 struct zram *zram = zw->zram;
492 unsigned long entry = zw->entry;
493 struct bio *bio = zw->bio;
495 read_from_bdev_async(zram, &bvec, entry, bio);
499 * Block layer want one ->make_request_fn to be active at a time
500 * so if we use chained IO with parent IO in same context,
501 * it's a deadlock. To avoid, it, it uses worker thread context.
503 static int read_from_bdev_sync(struct zram *zram, struct bio_vec *bvec,
504 unsigned long entry, struct bio *bio)
506 struct zram_work work;
512 INIT_WORK_ONSTACK(&work.work, zram_sync_read);
513 queue_work(system_unbound_wq, &work.work);
514 flush_work(&work.work);
515 destroy_work_on_stack(&work.work);
520 static int read_from_bdev_sync(struct zram *zram, struct bio_vec *bvec,
521 unsigned long entry, struct bio *bio)
528 static int read_from_bdev(struct zram *zram, struct bio_vec *bvec,
529 unsigned long entry, struct bio *parent, bool sync)
532 return read_from_bdev_sync(zram, bvec, entry, parent);
534 return read_from_bdev_async(zram, bvec, entry, parent);
537 static int write_to_bdev(struct zram *zram, struct bio_vec *bvec,
538 u32 index, struct bio *parent,
539 unsigned long *pentry)
544 bio = bio_alloc(GFP_ATOMIC, 1);
548 entry = get_entry_bdev(zram);
554 bio->bi_iter.bi_sector = entry * (PAGE_SIZE >> 9);
555 bio_set_dev(bio, zram->bdev);
556 if (!bio_add_page(bio, bvec->bv_page, bvec->bv_len,
559 put_entry_bdev(zram, entry);
564 bio->bi_opf = REQ_OP_WRITE | REQ_SYNC;
565 bio->bi_end_io = zram_page_end_io;
567 bio->bi_opf = parent->bi_opf;
568 bio_chain(bio, parent);
577 static void zram_wb_clear(struct zram *zram, u32 index)
581 zram_clear_flag(zram, index, ZRAM_WB);
582 entry = zram_get_element(zram, index);
583 zram_set_element(zram, index, 0);
584 put_entry_bdev(zram, entry);
588 static bool zram_wb_enabled(struct zram *zram) { return false; }
589 static inline void reset_bdev(struct zram *zram) {};
590 static int write_to_bdev(struct zram *zram, struct bio_vec *bvec,
591 u32 index, struct bio *parent,
592 unsigned long *pentry)
598 static int read_from_bdev(struct zram *zram, struct bio_vec *bvec,
599 unsigned long entry, struct bio *parent, bool sync)
603 static void zram_wb_clear(struct zram *zram, u32 index) {}
608 * We switched to per-cpu streams and this attr is not needed anymore.
609 * However, we will keep it around for some time, because:
610 * a) we may revert per-cpu streams in the future
611 * b) it's visible to user space and we need to follow our 2 years
612 * retirement rule; but we already have a number of 'soon to be
613 * altered' attrs, so max_comp_streams need to wait for the next
616 static ssize_t max_comp_streams_show(struct device *dev,
617 struct device_attribute *attr, char *buf)
619 return scnprintf(buf, PAGE_SIZE, "%d\n", num_online_cpus());
622 static ssize_t max_comp_streams_store(struct device *dev,
623 struct device_attribute *attr, const char *buf, size_t len)
628 static ssize_t comp_algorithm_show(struct device *dev,
629 struct device_attribute *attr, char *buf)
632 struct zram *zram = dev_to_zram(dev);
634 down_read(&zram->init_lock);
635 sz = zcomp_available_show(zram->compressor, buf);
636 up_read(&zram->init_lock);
641 static ssize_t comp_algorithm_store(struct device *dev,
642 struct device_attribute *attr, const char *buf, size_t len)
644 struct zram *zram = dev_to_zram(dev);
645 char compressor[ARRAY_SIZE(zram->compressor)];
648 strlcpy(compressor, buf, sizeof(compressor));
649 /* ignore trailing newline */
650 sz = strlen(compressor);
651 if (sz > 0 && compressor[sz - 1] == '\n')
652 compressor[sz - 1] = 0x00;
654 if (!zcomp_available_algorithm(compressor))
657 down_write(&zram->init_lock);
658 if (init_done(zram)) {
659 up_write(&zram->init_lock);
660 pr_info("Can't change algorithm for initialized device\n");
664 strcpy(zram->compressor, compressor);
665 up_write(&zram->init_lock);
669 static ssize_t compact_store(struct device *dev,
670 struct device_attribute *attr, const char *buf, size_t len)
672 struct zram *zram = dev_to_zram(dev);
674 down_read(&zram->init_lock);
675 if (!init_done(zram)) {
676 up_read(&zram->init_lock);
680 zs_compact(zram->mem_pool);
681 up_read(&zram->init_lock);
686 static ssize_t io_stat_show(struct device *dev,
687 struct device_attribute *attr, char *buf)
689 struct zram *zram = dev_to_zram(dev);
692 down_read(&zram->init_lock);
693 ret = scnprintf(buf, PAGE_SIZE,
694 "%8llu %8llu %8llu %8llu\n",
695 (u64)atomic64_read(&zram->stats.failed_reads),
696 (u64)atomic64_read(&zram->stats.failed_writes),
697 (u64)atomic64_read(&zram->stats.invalid_io),
698 (u64)atomic64_read(&zram->stats.notify_free));
699 up_read(&zram->init_lock);
704 static ssize_t mm_stat_show(struct device *dev,
705 struct device_attribute *attr, char *buf)
707 struct zram *zram = dev_to_zram(dev);
708 struct zs_pool_stats pool_stats;
709 u64 orig_size, mem_used = 0;
713 memset(&pool_stats, 0x00, sizeof(struct zs_pool_stats));
715 down_read(&zram->init_lock);
716 if (init_done(zram)) {
717 mem_used = zs_get_total_pages(zram->mem_pool);
718 zs_pool_stats(zram->mem_pool, &pool_stats);
721 orig_size = atomic64_read(&zram->stats.pages_stored);
722 max_used = atomic_long_read(&zram->stats.max_used_pages);
724 ret = scnprintf(buf, PAGE_SIZE,
725 "%8llu %8llu %8llu %8lu %8ld %8llu %8lu\n",
726 orig_size << PAGE_SHIFT,
727 (u64)atomic64_read(&zram->stats.compr_data_size),
728 mem_used << PAGE_SHIFT,
729 zram->limit_pages << PAGE_SHIFT,
730 max_used << PAGE_SHIFT,
731 (u64)atomic64_read(&zram->stats.same_pages),
732 pool_stats.pages_compacted);
733 up_read(&zram->init_lock);
738 static ssize_t debug_stat_show(struct device *dev,
739 struct device_attribute *attr, char *buf)
742 struct zram *zram = dev_to_zram(dev);
745 down_read(&zram->init_lock);
746 ret = scnprintf(buf, PAGE_SIZE,
747 "version: %d\n%8llu\n",
749 (u64)atomic64_read(&zram->stats.writestall));
750 up_read(&zram->init_lock);
755 static DEVICE_ATTR_RO(io_stat);
756 static DEVICE_ATTR_RO(mm_stat);
757 static DEVICE_ATTR_RO(debug_stat);
759 static void zram_slot_lock(struct zram *zram, u32 index)
761 bit_spin_lock(ZRAM_ACCESS, &zram->table[index].value);
764 static void zram_slot_unlock(struct zram *zram, u32 index)
766 bit_spin_unlock(ZRAM_ACCESS, &zram->table[index].value);
769 static void zram_meta_free(struct zram *zram, u64 disksize)
771 size_t num_pages = disksize >> PAGE_SHIFT;
774 /* Free all pages that are still in this zram device */
775 for (index = 0; index < num_pages; index++)
776 zram_free_page(zram, index);
778 zs_destroy_pool(zram->mem_pool);
782 static bool zram_meta_alloc(struct zram *zram, u64 disksize)
786 num_pages = disksize >> PAGE_SHIFT;
787 zram->table = vzalloc(num_pages * sizeof(*zram->table));
791 zram->mem_pool = zs_create_pool(zram->disk->disk_name);
792 if (!zram->mem_pool) {
801 * To protect concurrent access to the same index entry,
802 * caller should hold this table index entry's bit_spinlock to
803 * indicate this index entry is accessing.
805 static void zram_free_page(struct zram *zram, size_t index)
807 unsigned long handle;
809 if (zram_wb_enabled(zram) && zram_test_flag(zram, index, ZRAM_WB)) {
810 zram_wb_clear(zram, index);
811 atomic64_dec(&zram->stats.pages_stored);
816 * No memory is allocated for same element filled pages.
817 * Simply clear same page flag.
819 if (zram_test_flag(zram, index, ZRAM_SAME)) {
820 zram_clear_flag(zram, index, ZRAM_SAME);
821 zram_set_element(zram, index, 0);
822 atomic64_dec(&zram->stats.same_pages);
823 atomic64_dec(&zram->stats.pages_stored);
827 handle = zram_get_handle(zram, index);
831 zs_free(zram->mem_pool, handle);
833 atomic64_sub(zram_get_obj_size(zram, index),
834 &zram->stats.compr_data_size);
835 atomic64_dec(&zram->stats.pages_stored);
837 zram_set_handle(zram, index, 0);
838 zram_set_obj_size(zram, index, 0);
841 static int __zram_bvec_read(struct zram *zram, struct page *page, u32 index,
842 struct bio *bio, bool partial_io)
845 unsigned long handle;
849 if (zram_wb_enabled(zram)) {
850 zram_slot_lock(zram, index);
851 if (zram_test_flag(zram, index, ZRAM_WB)) {
854 zram_slot_unlock(zram, index);
857 bvec.bv_len = PAGE_SIZE;
859 return read_from_bdev(zram, &bvec,
860 zram_get_element(zram, index),
863 zram_slot_unlock(zram, index);
866 zram_slot_lock(zram, index);
867 handle = zram_get_handle(zram, index);
868 if (!handle || zram_test_flag(zram, index, ZRAM_SAME)) {
872 value = handle ? zram_get_element(zram, index) : 0;
873 mem = kmap_atomic(page);
874 zram_fill_page(mem, PAGE_SIZE, value);
876 zram_slot_unlock(zram, index);
880 size = zram_get_obj_size(zram, index);
882 src = zs_map_object(zram->mem_pool, handle, ZS_MM_RO);
883 if (size == PAGE_SIZE) {
884 dst = kmap_atomic(page);
885 memcpy(dst, src, PAGE_SIZE);
889 struct zcomp_strm *zstrm = zcomp_stream_get(zram->comp);
891 dst = kmap_atomic(page);
892 ret = zcomp_decompress(zstrm, src, size, dst);
894 zcomp_stream_put(zram->comp);
896 zs_unmap_object(zram->mem_pool, handle);
897 zram_slot_unlock(zram, index);
899 /* Should NEVER happen. Return bio error if it does. */
901 pr_err("Decompression failed! err=%d, page=%u\n", ret, index);
906 static int zram_bvec_read(struct zram *zram, struct bio_vec *bvec,
907 u32 index, int offset, struct bio *bio)
912 page = bvec->bv_page;
913 if (is_partial_io(bvec)) {
914 /* Use a temporary buffer to decompress the page */
915 page = alloc_page(GFP_NOIO|__GFP_HIGHMEM);
920 ret = __zram_bvec_read(zram, page, index, bio, is_partial_io(bvec));
924 if (is_partial_io(bvec)) {
925 void *dst = kmap_atomic(bvec->bv_page);
926 void *src = kmap_atomic(page);
928 memcpy(dst + bvec->bv_offset, src + offset, bvec->bv_len);
933 if (is_partial_io(bvec))
939 static int __zram_bvec_write(struct zram *zram, struct bio_vec *bvec,
940 u32 index, struct bio *bio)
943 unsigned long alloced_pages;
944 unsigned long handle = 0;
945 unsigned int comp_len = 0;
946 void *src, *dst, *mem;
947 struct zcomp_strm *zstrm;
948 struct page *page = bvec->bv_page;
949 unsigned long element = 0;
950 enum zram_pageflags flags = 0;
951 bool allow_wb = true;
953 mem = kmap_atomic(page);
954 if (page_same_filled(mem, &element)) {
956 /* Free memory associated with this sector now. */
958 atomic64_inc(&zram->stats.same_pages);
964 zstrm = zcomp_stream_get(zram->comp);
965 src = kmap_atomic(page);
966 ret = zcomp_compress(zstrm, src, &comp_len);
970 zcomp_stream_put(zram->comp);
971 pr_err("Compression failed! err=%d\n", ret);
972 zs_free(zram->mem_pool, handle);
976 if (unlikely(comp_len > max_zpage_size)) {
977 if (zram_wb_enabled(zram) && allow_wb) {
978 zcomp_stream_put(zram->comp);
979 ret = write_to_bdev(zram, bvec, index, bio, &element);
988 comp_len = PAGE_SIZE;
992 * handle allocation has 2 paths:
993 * a) fast path is executed with preemption disabled (for
994 * per-cpu streams) and has __GFP_DIRECT_RECLAIM bit clear,
995 * since we can't sleep;
996 * b) slow path enables preemption and attempts to allocate
997 * the page with __GFP_DIRECT_RECLAIM bit set. we have to
998 * put per-cpu compression stream and, thus, to re-do
999 * the compression once handle is allocated.
1001 * if we have a 'non-null' handle here then we are coming
1002 * from the slow path and handle has already been allocated.
1005 handle = zs_malloc(zram->mem_pool, comp_len,
1006 __GFP_KSWAPD_RECLAIM |
1011 zcomp_stream_put(zram->comp);
1012 atomic64_inc(&zram->stats.writestall);
1013 handle = zs_malloc(zram->mem_pool, comp_len,
1014 GFP_NOIO | __GFP_HIGHMEM |
1017 goto compress_again;
1021 alloced_pages = zs_get_total_pages(zram->mem_pool);
1022 update_used_max(zram, alloced_pages);
1024 if (zram->limit_pages && alloced_pages > zram->limit_pages) {
1025 zcomp_stream_put(zram->comp);
1026 zs_free(zram->mem_pool, handle);
1030 dst = zs_map_object(zram->mem_pool, handle, ZS_MM_WO);
1032 src = zstrm->buffer;
1033 if (comp_len == PAGE_SIZE)
1034 src = kmap_atomic(page);
1035 memcpy(dst, src, comp_len);
1036 if (comp_len == PAGE_SIZE)
1039 zcomp_stream_put(zram->comp);
1040 zs_unmap_object(zram->mem_pool, handle);
1041 atomic64_add(comp_len, &zram->stats.compr_data_size);
1044 * Free memory associated with this sector
1045 * before overwriting unused sectors.
1047 zram_slot_lock(zram, index);
1048 zram_free_page(zram, index);
1051 zram_set_flag(zram, index, flags);
1052 zram_set_element(zram, index, element);
1054 zram_set_handle(zram, index, handle);
1055 zram_set_obj_size(zram, index, comp_len);
1057 zram_slot_unlock(zram, index);
1060 atomic64_inc(&zram->stats.pages_stored);
1064 static int zram_bvec_write(struct zram *zram, struct bio_vec *bvec,
1065 u32 index, int offset, struct bio *bio)
1068 struct page *page = NULL;
1073 if (is_partial_io(bvec)) {
1076 * This is a partial IO. We need to read the full page
1077 * before to write the changes.
1079 page = alloc_page(GFP_NOIO|__GFP_HIGHMEM);
1083 ret = __zram_bvec_read(zram, page, index, bio, true);
1087 src = kmap_atomic(bvec->bv_page);
1088 dst = kmap_atomic(page);
1089 memcpy(dst + offset, src + bvec->bv_offset, bvec->bv_len);
1094 vec.bv_len = PAGE_SIZE;
1098 ret = __zram_bvec_write(zram, &vec, index, bio);
1100 if (is_partial_io(bvec))
1106 * zram_bio_discard - handler on discard request
1107 * @index: physical block index in PAGE_SIZE units
1108 * @offset: byte offset within physical block
1110 static void zram_bio_discard(struct zram *zram, u32 index,
1111 int offset, struct bio *bio)
1113 size_t n = bio->bi_iter.bi_size;
1116 * zram manages data in physical block size units. Because logical block
1117 * size isn't identical with physical block size on some arch, we
1118 * could get a discard request pointing to a specific offset within a
1119 * certain physical block. Although we can handle this request by
1120 * reading that physiclal block and decompressing and partially zeroing
1121 * and re-compressing and then re-storing it, this isn't reasonable
1122 * because our intent with a discard request is to save memory. So
1123 * skipping this logical block is appropriate here.
1126 if (n <= (PAGE_SIZE - offset))
1129 n -= (PAGE_SIZE - offset);
1133 while (n >= PAGE_SIZE) {
1134 zram_slot_lock(zram, index);
1135 zram_free_page(zram, index);
1136 zram_slot_unlock(zram, index);
1137 atomic64_inc(&zram->stats.notify_free);
1144 * Returns errno if it has some problem. Otherwise return 0 or 1.
1145 * Returns 0 if IO request was done synchronously
1146 * Returns 1 if IO request was successfully submitted.
1148 static int zram_bvec_rw(struct zram *zram, struct bio_vec *bvec, u32 index,
1149 int offset, bool is_write, struct bio *bio)
1151 unsigned long start_time = jiffies;
1152 int rw_acct = is_write ? REQ_OP_WRITE : REQ_OP_READ;
1153 struct request_queue *q = zram->disk->queue;
1156 generic_start_io_acct(q, rw_acct, bvec->bv_len >> SECTOR_SHIFT,
1157 &zram->disk->part0);
1160 atomic64_inc(&zram->stats.num_reads);
1161 ret = zram_bvec_read(zram, bvec, index, offset, bio);
1162 flush_dcache_page(bvec->bv_page);
1164 atomic64_inc(&zram->stats.num_writes);
1165 ret = zram_bvec_write(zram, bvec, index, offset, bio);
1168 generic_end_io_acct(q, rw_acct, &zram->disk->part0, start_time);
1170 if (unlikely(ret < 0)) {
1172 atomic64_inc(&zram->stats.failed_reads);
1174 atomic64_inc(&zram->stats.failed_writes);
1180 static void __zram_make_request(struct zram *zram, struct bio *bio)
1184 struct bio_vec bvec;
1185 struct bvec_iter iter;
1187 index = bio->bi_iter.bi_sector >> SECTORS_PER_PAGE_SHIFT;
1188 offset = (bio->bi_iter.bi_sector &
1189 (SECTORS_PER_PAGE - 1)) << SECTOR_SHIFT;
1191 switch (bio_op(bio)) {
1192 case REQ_OP_DISCARD:
1193 case REQ_OP_WRITE_ZEROES:
1194 zram_bio_discard(zram, index, offset, bio);
1201 bio_for_each_segment(bvec, bio, iter) {
1202 struct bio_vec bv = bvec;
1203 unsigned int unwritten = bvec.bv_len;
1206 bv.bv_len = min_t(unsigned int, PAGE_SIZE - offset,
1208 if (zram_bvec_rw(zram, &bv, index, offset,
1209 op_is_write(bio_op(bio)), bio) < 0)
1212 bv.bv_offset += bv.bv_len;
1213 unwritten -= bv.bv_len;
1215 update_position(&index, &offset, &bv);
1216 } while (unwritten);
1227 * Handler function for all zram I/O requests.
1229 static blk_qc_t zram_make_request(struct request_queue *queue, struct bio *bio)
1231 struct zram *zram = queue->queuedata;
1233 if (!valid_io_request(zram, bio->bi_iter.bi_sector,
1234 bio->bi_iter.bi_size)) {
1235 atomic64_inc(&zram->stats.invalid_io);
1239 __zram_make_request(zram, bio);
1240 return BLK_QC_T_NONE;
1244 return BLK_QC_T_NONE;
1247 static void zram_slot_free_notify(struct block_device *bdev,
1248 unsigned long index)
1252 zram = bdev->bd_disk->private_data;
1254 zram_slot_lock(zram, index);
1255 zram_free_page(zram, index);
1256 zram_slot_unlock(zram, index);
1257 atomic64_inc(&zram->stats.notify_free);
1260 static int zram_rw_page(struct block_device *bdev, sector_t sector,
1261 struct page *page, bool is_write)
1268 if (PageTransHuge(page))
1270 zram = bdev->bd_disk->private_data;
1272 if (!valid_io_request(zram, sector, PAGE_SIZE)) {
1273 atomic64_inc(&zram->stats.invalid_io);
1278 index = sector >> SECTORS_PER_PAGE_SHIFT;
1279 offset = (sector & (SECTORS_PER_PAGE - 1)) << SECTOR_SHIFT;
1282 bv.bv_len = PAGE_SIZE;
1285 ret = zram_bvec_rw(zram, &bv, index, offset, is_write, NULL);
1288 * If I/O fails, just return error(ie, non-zero) without
1289 * calling page_endio.
1290 * It causes resubmit the I/O with bio request by upper functions
1291 * of rw_page(e.g., swap_readpage, __swap_writepage) and
1292 * bio->bi_end_io does things to handle the error
1293 * (e.g., SetPageError, set_page_dirty and extra works).
1295 if (unlikely(ret < 0))
1300 page_endio(page, is_write, 0);
1311 static void zram_reset_device(struct zram *zram)
1316 down_write(&zram->init_lock);
1318 zram->limit_pages = 0;
1320 if (!init_done(zram)) {
1321 up_write(&zram->init_lock);
1326 disksize = zram->disksize;
1329 set_capacity(zram->disk, 0);
1330 part_stat_set_all(&zram->disk->part0, 0);
1332 up_write(&zram->init_lock);
1333 /* I/O operation under all of CPU are done so let's free */
1334 zram_meta_free(zram, disksize);
1335 memset(&zram->stats, 0, sizeof(zram->stats));
1336 zcomp_destroy(comp);
1340 static ssize_t disksize_store(struct device *dev,
1341 struct device_attribute *attr, const char *buf, size_t len)
1345 struct zram *zram = dev_to_zram(dev);
1348 disksize = memparse(buf, NULL);
1352 down_write(&zram->init_lock);
1353 if (init_done(zram)) {
1354 pr_info("Cannot change disksize for initialized device\n");
1359 disksize = PAGE_ALIGN(disksize);
1360 if (!zram_meta_alloc(zram, disksize)) {
1365 comp = zcomp_create(zram->compressor);
1367 pr_err("Cannot initialise %s compressing backend\n",
1369 err = PTR_ERR(comp);
1374 zram->disksize = disksize;
1375 set_capacity(zram->disk, zram->disksize >> SECTOR_SHIFT);
1376 zram_revalidate_disk(zram);
1377 up_write(&zram->init_lock);
1382 zram_meta_free(zram, disksize);
1384 up_write(&zram->init_lock);
1388 static ssize_t reset_store(struct device *dev,
1389 struct device_attribute *attr, const char *buf, size_t len)
1392 unsigned short do_reset;
1394 struct block_device *bdev;
1396 ret = kstrtou16(buf, 10, &do_reset);
1403 zram = dev_to_zram(dev);
1404 bdev = bdget_disk(zram->disk, 0);
1408 mutex_lock(&bdev->bd_mutex);
1409 /* Do not reset an active device or claimed device */
1410 if (bdev->bd_openers || zram->claim) {
1411 mutex_unlock(&bdev->bd_mutex);
1416 /* From now on, anyone can't open /dev/zram[0-9] */
1418 mutex_unlock(&bdev->bd_mutex);
1420 /* Make sure all the pending I/O are finished */
1422 zram_reset_device(zram);
1423 zram_revalidate_disk(zram);
1426 mutex_lock(&bdev->bd_mutex);
1427 zram->claim = false;
1428 mutex_unlock(&bdev->bd_mutex);
1433 static int zram_open(struct block_device *bdev, fmode_t mode)
1438 WARN_ON(!mutex_is_locked(&bdev->bd_mutex));
1440 zram = bdev->bd_disk->private_data;
1441 /* zram was claimed to reset so open request fails */
1448 static const struct block_device_operations zram_devops = {
1450 .swap_slot_free_notify = zram_slot_free_notify,
1451 .rw_page = zram_rw_page,
1452 .owner = THIS_MODULE
1455 static DEVICE_ATTR_WO(compact);
1456 static DEVICE_ATTR_RW(disksize);
1457 static DEVICE_ATTR_RO(initstate);
1458 static DEVICE_ATTR_WO(reset);
1459 static DEVICE_ATTR_WO(mem_limit);
1460 static DEVICE_ATTR_WO(mem_used_max);
1461 static DEVICE_ATTR_RW(max_comp_streams);
1462 static DEVICE_ATTR_RW(comp_algorithm);
1463 #ifdef CONFIG_ZRAM_WRITEBACK
1464 static DEVICE_ATTR_RW(backing_dev);
1467 static struct attribute *zram_disk_attrs[] = {
1468 &dev_attr_disksize.attr,
1469 &dev_attr_initstate.attr,
1470 &dev_attr_reset.attr,
1471 &dev_attr_compact.attr,
1472 &dev_attr_mem_limit.attr,
1473 &dev_attr_mem_used_max.attr,
1474 &dev_attr_max_comp_streams.attr,
1475 &dev_attr_comp_algorithm.attr,
1476 #ifdef CONFIG_ZRAM_WRITEBACK
1477 &dev_attr_backing_dev.attr,
1479 &dev_attr_io_stat.attr,
1480 &dev_attr_mm_stat.attr,
1481 &dev_attr_debug_stat.attr,
1485 static const struct attribute_group zram_disk_attr_group = {
1486 .attrs = zram_disk_attrs,
1490 * Allocate and initialize new zram device. the function returns
1491 * '>= 0' device_id upon success, and negative value otherwise.
1493 static int zram_add(void)
1496 struct request_queue *queue;
1499 zram = kzalloc(sizeof(struct zram), GFP_KERNEL);
1503 ret = idr_alloc(&zram_index_idr, zram, 0, 0, GFP_KERNEL);
1508 init_rwsem(&zram->init_lock);
1510 queue = blk_alloc_queue(GFP_KERNEL);
1512 pr_err("Error allocating disk queue for device %d\n",
1518 blk_queue_make_request(queue, zram_make_request);
1520 /* gendisk structure */
1521 zram->disk = alloc_disk(1);
1523 pr_err("Error allocating disk structure for device %d\n",
1526 goto out_free_queue;
1529 zram->disk->major = zram_major;
1530 zram->disk->first_minor = device_id;
1531 zram->disk->fops = &zram_devops;
1532 zram->disk->queue = queue;
1533 zram->disk->queue->queuedata = zram;
1534 zram->disk->private_data = zram;
1535 snprintf(zram->disk->disk_name, 16, "zram%d", device_id);
1537 /* Actual capacity set using syfs (/sys/block/zram<id>/disksize */
1538 set_capacity(zram->disk, 0);
1539 /* zram devices sort of resembles non-rotational disks */
1540 queue_flag_set_unlocked(QUEUE_FLAG_NONROT, zram->disk->queue);
1541 queue_flag_clear_unlocked(QUEUE_FLAG_ADD_RANDOM, zram->disk->queue);
1543 * To ensure that we always get PAGE_SIZE aligned
1544 * and n*PAGE_SIZED sized I/O requests.
1546 blk_queue_physical_block_size(zram->disk->queue, PAGE_SIZE);
1547 blk_queue_logical_block_size(zram->disk->queue,
1548 ZRAM_LOGICAL_BLOCK_SIZE);
1549 blk_queue_io_min(zram->disk->queue, PAGE_SIZE);
1550 blk_queue_io_opt(zram->disk->queue, PAGE_SIZE);
1551 zram->disk->queue->limits.discard_granularity = PAGE_SIZE;
1552 blk_queue_max_discard_sectors(zram->disk->queue, UINT_MAX);
1553 queue_flag_set_unlocked(QUEUE_FLAG_DISCARD, zram->disk->queue);
1556 * zram_bio_discard() will clear all logical blocks if logical block
1557 * size is identical with physical block size(PAGE_SIZE). But if it is
1558 * different, we will skip discarding some parts of logical blocks in
1559 * the part of the request range which isn't aligned to physical block
1560 * size. So we can't ensure that all discarded logical blocks are
1563 if (ZRAM_LOGICAL_BLOCK_SIZE == PAGE_SIZE)
1564 blk_queue_max_write_zeroes_sectors(zram->disk->queue, UINT_MAX);
1566 add_disk(zram->disk);
1568 ret = sysfs_create_group(&disk_to_dev(zram->disk)->kobj,
1569 &zram_disk_attr_group);
1571 pr_err("Error creating sysfs group for device %d\n",
1575 strlcpy(zram->compressor, default_compressor, sizeof(zram->compressor));
1577 pr_info("Added device: %s\n", zram->disk->disk_name);
1581 del_gendisk(zram->disk);
1582 put_disk(zram->disk);
1584 blk_cleanup_queue(queue);
1586 idr_remove(&zram_index_idr, device_id);
1592 static int zram_remove(struct zram *zram)
1594 struct block_device *bdev;
1596 bdev = bdget_disk(zram->disk, 0);
1600 mutex_lock(&bdev->bd_mutex);
1601 if (bdev->bd_openers || zram->claim) {
1602 mutex_unlock(&bdev->bd_mutex);
1608 mutex_unlock(&bdev->bd_mutex);
1611 * Remove sysfs first, so no one will perform a disksize
1612 * store while we destroy the devices. This also helps during
1613 * hot_remove -- zram_reset_device() is the last holder of
1614 * ->init_lock, no later/concurrent disksize_store() or any
1615 * other sysfs handlers are possible.
1617 sysfs_remove_group(&disk_to_dev(zram->disk)->kobj,
1618 &zram_disk_attr_group);
1620 /* Make sure all the pending I/O are finished */
1622 zram_reset_device(zram);
1625 pr_info("Removed device: %s\n", zram->disk->disk_name);
1627 blk_cleanup_queue(zram->disk->queue);
1628 del_gendisk(zram->disk);
1629 put_disk(zram->disk);
1634 /* zram-control sysfs attributes */
1637 * NOTE: hot_add attribute is not the usual read-only sysfs attribute. In a
1638 * sense that reading from this file does alter the state of your system -- it
1639 * creates a new un-initialized zram device and returns back this device's
1640 * device_id (or an error code if it fails to create a new device).
1642 static ssize_t hot_add_show(struct class *class,
1643 struct class_attribute *attr,
1648 mutex_lock(&zram_index_mutex);
1650 mutex_unlock(&zram_index_mutex);
1654 return scnprintf(buf, PAGE_SIZE, "%d\n", ret);
1656 static CLASS_ATTR_RO(hot_add);
1658 static ssize_t hot_remove_store(struct class *class,
1659 struct class_attribute *attr,
1666 /* dev_id is gendisk->first_minor, which is `int' */
1667 ret = kstrtoint(buf, 10, &dev_id);
1673 mutex_lock(&zram_index_mutex);
1675 zram = idr_find(&zram_index_idr, dev_id);
1677 ret = zram_remove(zram);
1679 idr_remove(&zram_index_idr, dev_id);
1684 mutex_unlock(&zram_index_mutex);
1685 return ret ? ret : count;
1687 static CLASS_ATTR_WO(hot_remove);
1689 static struct attribute *zram_control_class_attrs[] = {
1690 &class_attr_hot_add.attr,
1691 &class_attr_hot_remove.attr,
1694 ATTRIBUTE_GROUPS(zram_control_class);
1696 static struct class zram_control_class = {
1697 .name = "zram-control",
1698 .owner = THIS_MODULE,
1699 .class_groups = zram_control_class_groups,
1702 static int zram_remove_cb(int id, void *ptr, void *data)
1708 static void destroy_devices(void)
1710 class_unregister(&zram_control_class);
1711 idr_for_each(&zram_index_idr, &zram_remove_cb, NULL);
1712 idr_destroy(&zram_index_idr);
1713 unregister_blkdev(zram_major, "zram");
1714 cpuhp_remove_multi_state(CPUHP_ZCOMP_PREPARE);
1717 static int __init zram_init(void)
1721 ret = cpuhp_setup_state_multi(CPUHP_ZCOMP_PREPARE, "block/zram:prepare",
1722 zcomp_cpu_up_prepare, zcomp_cpu_dead);
1726 ret = class_register(&zram_control_class);
1728 pr_err("Unable to register zram-control class\n");
1729 cpuhp_remove_multi_state(CPUHP_ZCOMP_PREPARE);
1733 zram_major = register_blkdev(0, "zram");
1734 if (zram_major <= 0) {
1735 pr_err("Unable to get major number\n");
1736 class_unregister(&zram_control_class);
1737 cpuhp_remove_multi_state(CPUHP_ZCOMP_PREPARE);
1741 while (num_devices != 0) {
1742 mutex_lock(&zram_index_mutex);
1744 mutex_unlock(&zram_index_mutex);
1757 static void __exit zram_exit(void)
1762 module_init(zram_init);
1763 module_exit(zram_exit);
1765 module_param(num_devices, uint, 0);
1766 MODULE_PARM_DESC(num_devices, "Number of pre-created zram devices");
1768 MODULE_LICENSE("Dual BSD/GPL");
1769 MODULE_AUTHOR("Nitin Gupta <ngupta@vflare.org>");
1770 MODULE_DESCRIPTION("Compressed RAM Block Device");