xref: /linux/Documentation/ABI/testing/sysfs-block-zram (revision 3932b9ca55b0be314a36d3e84faff3e823c081f5)
1What:		/sys/block/zram<id>/disksize
2Date:		August 2010
3Contact:	Nitin Gupta <ngupta@vflare.org>
4Description:
5		The disksize file is read-write and specifies the disk size
6		which represents the limit on the *uncompressed* worth of data
7		that can be stored in this disk.
8		Unit: bytes
9
10What:		/sys/block/zram<id>/initstate
11Date:		August 2010
12Contact:	Nitin Gupta <ngupta@vflare.org>
13Description:
14		The initstate file is read-only and shows the initialization
15		state of the device.
16
17What:		/sys/block/zram<id>/reset
18Date:		August 2010
19Contact:	Nitin Gupta <ngupta@vflare.org>
20Description:
21		The reset file is write-only and allows resetting the
22		device. The reset operation frees all the memory associated
23		with this device.
24
25What:		/sys/block/zram<id>/num_reads
26Date:		August 2010
27Contact:	Nitin Gupta <ngupta@vflare.org>
28Description:
29		The num_reads file is read-only and specifies the number of
30		reads (failed or successful) done on this device.
31
32What:		/sys/block/zram<id>/num_writes
33Date:		August 2010
34Contact:	Nitin Gupta <ngupta@vflare.org>
35Description:
36		The num_writes file is read-only and specifies the number of
37		writes (failed or successful) done on this device.
38
39What:		/sys/block/zram<id>/invalid_io
40Date:		August 2010
41Contact:	Nitin Gupta <ngupta@vflare.org>
42Description:
43		The invalid_io file is read-only and specifies the number of
44		non-page-size-aligned I/O requests issued to this device.
45
46What:		/sys/block/zram<id>/failed_reads
47Date:		February 2014
48Contact:	Sergey Senozhatsky <sergey.senozhatsky@gmail.com>
49Description:
50		The failed_reads file is read-only and specifies the number of
51		failed reads happened on this device.
52
53What:		/sys/block/zram<id>/failed_writes
54Date:		February 2014
55Contact:	Sergey Senozhatsky <sergey.senozhatsky@gmail.com>
56Description:
57		The failed_writes file is read-only and specifies the number of
58		failed writes happened on this device.
59
60What:		/sys/block/zram<id>/max_comp_streams
61Date:		February 2014
62Contact:	Sergey Senozhatsky <sergey.senozhatsky@gmail.com>
63Description:
64		The max_comp_streams file is read-write and specifies the
65		number of backend's zcomp_strm compression streams (number of
66		concurrent compress operations).
67
68What:		/sys/block/zram<id>/comp_algorithm
69Date:		February 2014
70Contact:	Sergey Senozhatsky <sergey.senozhatsky@gmail.com>
71Description:
72		The comp_algorithm file is read-write and lets to show
73		available and selected compression algorithms, change
74		compression algorithm selection.
75
76What:		/sys/block/zram<id>/notify_free
77Date:		August 2010
78Contact:	Nitin Gupta <ngupta@vflare.org>
79Description:
80		The notify_free file is read-only and specifies the number of
81		swap slot free notifications received by this device. These
82		notifications are sent to a swap block device when a swap slot
83		is freed. This statistic is applicable only when this disk is
84		being used as a swap disk.
85
86What:		/sys/block/zram<id>/zero_pages
87Date:		August 2010
88Contact:	Nitin Gupta <ngupta@vflare.org>
89Description:
90		The zero_pages file is read-only and specifies number of zero
91		filled pages written to this disk. No memory is allocated for
92		such pages.
93
94What:		/sys/block/zram<id>/orig_data_size
95Date:		August 2010
96Contact:	Nitin Gupta <ngupta@vflare.org>
97Description:
98		The orig_data_size file is read-only and specifies uncompressed
99		size of data stored in this disk. This excludes zero-filled
100		pages (zero_pages) since no memory is allocated for them.
101		Unit: bytes
102
103What:		/sys/block/zram<id>/compr_data_size
104Date:		August 2010
105Contact:	Nitin Gupta <ngupta@vflare.org>
106Description:
107		The compr_data_size file is read-only and specifies compressed
108		size of data stored in this disk. So, compression ratio can be
109		calculated using orig_data_size and this statistic.
110		Unit: bytes
111
112What:		/sys/block/zram<id>/mem_used_total
113Date:		August 2010
114Contact:	Nitin Gupta <ngupta@vflare.org>
115Description:
116		The mem_used_total file is read-only and specifies the amount
117		of memory, including allocator fragmentation and metadata
118		overhead, allocated for this disk. So, allocator space
119		efficiency can be calculated using compr_data_size and this
120		statistic.
121		Unit: bytes
122