drivers/staging/zram/zram_drv.h

   1 /*
   2  * Compressed RAM block device
   3  *
   4  * Copyright (C) 2008, 2009, 2010  Nitin Gupta
   5  *
   6  * This code is released using a dual license strategy: BSD/GPL
   7  * You can choose the licence that better fits your requirements.
   8  *
   9  * Released under the terms of 3-clause BSD License
  10  * Released under the terms of GNU General Public License Version 2.0
  11  *
  12  * Project home: http://compcache.googlecode.com
  13  */
  14
  15 #ifndef _ZRAM_DRV_H_
  16 #define _ZRAM_DRV_H_
  17
  18 #include <linux/spinlock.h>
  19 #include <linux/mutex.h>
  20
  21 #include "xvmalloc.h"
  22
  23 /*
  24  * Some arbitrary value. This is just to catch
  25  * invalid value for num_devices module parameter.
  26  */
  27 static const unsigned max_num_devices = 32;
  28
  29 /*
  30  * Stored at beginning of each compressed object.
  31  *
  32  * It stores back-reference to table entry which points to this
  33  * object. This is required to support memory defragmentation.
  34  */
  35 struct zobj_header {
  36 #if 0
  37         u32 table_idx;
  38 #endif
  39 };
  40
  41 /*-- Configurable parameters */
  42
  43 /* Default zram disk size: 25% of total RAM */
  44 static const unsigned default_disksize_perc_ram = 25;
  45
  46 /*
  47  * Pages that compress to size greater than this are stored
  48  * uncompressed in memory.
  49  */
  50 static const unsigned max_zpage_size = PAGE_SIZE / 4 * 3;
  51
  52 /*
  53  * NOTE: max_zpage_size must be less than or equal to:
  54  *   XV_MAX_ALLOC_SIZE - sizeof(struct zobj_header)
  55  * otherwise, xv_malloc() would always return failure.
  56  */
  57
  58 /*-- End of configurable params */
  59
  60 #define SECTOR_SHIFT            9
  61 #define SECTOR_SIZE             (1 << SECTOR_SHIFT)
  62 #define SECTORS_PER_PAGE_SHIFT  (PAGE_SHIFT - SECTOR_SHIFT)
  63 #define SECTORS_PER_PAGE        (1 << SECTORS_PER_PAGE_SHIFT)
  64
  65 /* Flags for zram pages (table[page_no].flags) */
  66 enum zram_pageflags {
  67         /* Page is stored uncompressed */
  68         ZRAM_UNCOMPRESSED,
  69
  70         /* Page consists entirely of zeros */
  71         ZRAM_ZERO,
  72
  73         __NR_ZRAM_PAGEFLAGS,
  74 };
  75
  76 /*-- Data structures */
  77
  78 /* Allocated for each disk page */
  79 struct table {
  80         struct page *page;
  81         u16 offset;
  82         u8 count;       /* object ref count (not yet used) */
  83         u8 flags;
  84 } __attribute__((aligned(4)));
  85
  86 struct zram_stats {
  87         u64 compr_size;         /* compressed size of pages stored */
  88         u64 num_reads;          /* failed + successful */
  89         u64 num_writes;         /* --do-- */
  90         u64 failed_reads;       /* should NEVER! happen */
  91         u64 failed_writes;      /* can happen when memory is too low */
  92         u64 invalid_io;         /* non-page-aligned I/O requests */
  93         u64 notify_free;        /* no. of swap slot free notifications */
  94         u32 pages_zero;         /* no. of zero filled pages */
  95         u32 pages_stored;       /* no. of pages currently stored */
  96         u32 good_compress;      /* % of pages with compression ratio<=50% */
  97         u32 pages_expand;       /* % of incompressible pages */
  98 };
  99
 100 struct zram {
 101         struct xv_pool *mem_pool;
 102         void *compress_workmem;
 103         void *compress_buffer;
 104         struct table *table;
 105         spinlock_t stat64_lock; /* protect 64-bit stats */
 106         struct mutex lock;      /* protect compression buffers against
 107                                  * concurrent writes */
 108         struct request_queue *queue;
 109         struct gendisk *disk;
 110         int init_done;
 111         /* Prevent concurrent execution of device init and reset */
 112         struct mutex init_lock;
 113         /*
 114          * This is the limit on amount of *uncompressed* worth of data
 115          * we can store in a disk.
 116          */
 117         u64 disksize;   /* bytes */
 118
 119         struct zram_stats stats;
 120 };
 121
 122 extern struct zram *devices;
 123 extern unsigned int num_devices;
 124 #ifdef CONFIG_SYSFS
 125 extern struct attribute_group zram_disk_attr_group;
 126 #endif
 127
 128 extern int zram_init_device(struct zram *zram);
 129 extern void zram_reset_device(struct zram *zram);
 130
 131 #endif