xref: /linux/Documentation/ABI/testing/sysfs-block-zram (revision 51d8a7b0a04effbb67fd9afcda4757b0c061fc11)
1e98419c2SNitin GuptaWhat:		/sys/block/zram<id>/disksize
2e98419c2SNitin GuptaDate:		August 2010
3e98419c2SNitin GuptaContact:	Nitin Gupta <ngupta@vflare.org>
4e98419c2SNitin GuptaDescription:
5e98419c2SNitin Gupta		The disksize file is read-write and specifies the disk size
6e98419c2SNitin Gupta		which represents the limit on the *uncompressed* worth of data
7e98419c2SNitin Gupta		that can be stored in this disk.
8*51d8a7b0SBernhard M. Wiedemann		Unit: bytes
9e98419c2SNitin Gupta
10e98419c2SNitin GuptaWhat:		/sys/block/zram<id>/initstate
11e98419c2SNitin GuptaDate:		August 2010
12e98419c2SNitin GuptaContact:	Nitin Gupta <ngupta@vflare.org>
13e98419c2SNitin GuptaDescription:
14*51d8a7b0SBernhard M. Wiedemann		The initstate file is read-only and shows the initialization
15e98419c2SNitin Gupta		state of the device.
16e98419c2SNitin Gupta
17e98419c2SNitin GuptaWhat:		/sys/block/zram<id>/reset
18e98419c2SNitin GuptaDate:		August 2010
19e98419c2SNitin GuptaContact:	Nitin Gupta <ngupta@vflare.org>
20e98419c2SNitin GuptaDescription:
21*51d8a7b0SBernhard M. Wiedemann		The reset file is write-only and allows resetting the
22*51d8a7b0SBernhard M. Wiedemann		device. The reset operation frees all the memory associated
23e98419c2SNitin Gupta		with this device.
24e98419c2SNitin Gupta
25e98419c2SNitin GuptaWhat:		/sys/block/zram<id>/num_reads
26e98419c2SNitin GuptaDate:		August 2010
27e98419c2SNitin GuptaContact:	Nitin Gupta <ngupta@vflare.org>
28e98419c2SNitin GuptaDescription:
29e98419c2SNitin Gupta		The num_reads file is read-only and specifies the number of
30e98419c2SNitin Gupta		reads (failed or successful) done on this device.
31e98419c2SNitin Gupta
32e98419c2SNitin GuptaWhat:		/sys/block/zram<id>/num_writes
33e98419c2SNitin GuptaDate:		August 2010
34e98419c2SNitin GuptaContact:	Nitin Gupta <ngupta@vflare.org>
35e98419c2SNitin GuptaDescription:
36e98419c2SNitin Gupta		The num_writes file is read-only and specifies the number of
37e98419c2SNitin Gupta		writes (failed or successful) done on this device.
38e98419c2SNitin Gupta
39e98419c2SNitin GuptaWhat:		/sys/block/zram<id>/invalid_io
40e98419c2SNitin GuptaDate:		August 2010
41e98419c2SNitin GuptaContact:	Nitin Gupta <ngupta@vflare.org>
42e98419c2SNitin GuptaDescription:
43e98419c2SNitin Gupta		The invalid_io file is read-only and specifies the number of
44e98419c2SNitin Gupta		non-page-size-aligned I/O requests issued to this device.
45e98419c2SNitin Gupta
46e98419c2SNitin GuptaWhat:		/sys/block/zram<id>/notify_free
47e98419c2SNitin GuptaDate:		August 2010
48e98419c2SNitin GuptaContact:	Nitin Gupta <ngupta@vflare.org>
49e98419c2SNitin GuptaDescription:
50e98419c2SNitin Gupta		The notify_free file is read-only and specifies the number of
51e98419c2SNitin Gupta		swap slot free notifications received by this device. These
52*51d8a7b0SBernhard M. Wiedemann		notifications are sent to a swap block device when a swap slot
53e98419c2SNitin Gupta		is freed. This statistic is applicable only when this disk is
54e98419c2SNitin Gupta		being used as a swap disk.
55e98419c2SNitin Gupta
56e98419c2SNitin GuptaWhat:		/sys/block/zram<id>/discard
57e98419c2SNitin GuptaDate:		August 2010
58e98419c2SNitin GuptaContact:	Nitin Gupta <ngupta@vflare.org>
59e98419c2SNitin GuptaDescription:
60e98419c2SNitin Gupta		The discard file is read-only and specifies the number of
61e98419c2SNitin Gupta		discard requests received by this device. These requests
62e98419c2SNitin Gupta		provide information to block device regarding blocks which are
63e98419c2SNitin Gupta		no longer used by filesystem.
64e98419c2SNitin Gupta
65e98419c2SNitin GuptaWhat:		/sys/block/zram<id>/zero_pages
66e98419c2SNitin GuptaDate:		August 2010
67e98419c2SNitin GuptaContact:	Nitin Gupta <ngupta@vflare.org>
68e98419c2SNitin GuptaDescription:
69e98419c2SNitin Gupta		The zero_pages file is read-only and specifies number of zero
70e98419c2SNitin Gupta		filled pages written to this disk. No memory is allocated for
71e98419c2SNitin Gupta		such pages.
72e98419c2SNitin Gupta
73e98419c2SNitin GuptaWhat:		/sys/block/zram<id>/orig_data_size
74e98419c2SNitin GuptaDate:		August 2010
75e98419c2SNitin GuptaContact:	Nitin Gupta <ngupta@vflare.org>
76e98419c2SNitin GuptaDescription:
77e98419c2SNitin Gupta		The orig_data_size file is read-only and specifies uncompressed
78e98419c2SNitin Gupta		size of data stored in this disk. This excludes zero-filled
79e98419c2SNitin Gupta		pages (zero_pages) since no memory is allocated for them.
80e98419c2SNitin Gupta		Unit: bytes
81e98419c2SNitin Gupta
82e98419c2SNitin GuptaWhat:		/sys/block/zram<id>/compr_data_size
83e98419c2SNitin GuptaDate:		August 2010
84e98419c2SNitin GuptaContact:	Nitin Gupta <ngupta@vflare.org>
85e98419c2SNitin GuptaDescription:
86e98419c2SNitin Gupta		The compr_data_size file is read-only and specifies compressed
87e98419c2SNitin Gupta		size of data stored in this disk. So, compression ratio can be
88e98419c2SNitin Gupta		calculated using orig_data_size and this statistic.
89e98419c2SNitin Gupta		Unit: bytes
90e98419c2SNitin Gupta
91e98419c2SNitin GuptaWhat:		/sys/block/zram<id>/mem_used_total
92e98419c2SNitin GuptaDate:		August 2010
93e98419c2SNitin GuptaContact:	Nitin Gupta <ngupta@vflare.org>
94e98419c2SNitin GuptaDescription:
95e98419c2SNitin Gupta		The mem_used_total file is read-only and specifies the amount
96e98419c2SNitin Gupta		of memory, including allocator fragmentation and metadata
97e98419c2SNitin Gupta		overhead, allocated for this disk. So, allocator space
98e98419c2SNitin Gupta		efficiency can be calculated using compr_data_size and this
99e98419c2SNitin Gupta		statistic.
100e98419c2SNitin Gupta		Unit: bytes
101