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