Staging: zram: Rename ramzswap to zram in documentation
Related changes: - Included example to show usage as generic (non-swap) disk with ext4 filesystem. - Renamed rzscontrol to zramconfig to match with new device naming. Signed-off-by: Nitin Gupta <ngupta@vflare.org> Acked-by: Pekka Enberg <penberg@cs.helsinki.fi> Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
This commit is contained in:
parent
f1e3cfff4d
commit
00ac9ba01d
|
@ -1,46 +1,57 @@
|
|||
ramzswap: Compressed RAM based swap device
|
||||
-------------------------------------------
|
||||
zram: Compressed RAM based block devices
|
||||
----------------------------------------
|
||||
|
||||
Project home: http://compcache.googlecode.com/
|
||||
|
||||
* Introduction
|
||||
|
||||
The ramzswap module creates RAM based block devices which can (only) be used as
|
||||
swap disks. Pages swapped to these devices are compressed and stored in memory
|
||||
itself. See project home for use cases, performance numbers and a lot more.
|
||||
The zram module creates RAM based block devices: /dev/ramX (X = 0, 1, ...).
|
||||
Pages written to these disks are compressed and stored in memory itself.
|
||||
These disks allow very fast I/O and compression provides good amounts of
|
||||
memory savings.
|
||||
|
||||
Individual ramzswap devices are configured and initialized using rzscontrol
|
||||
userspace utility as shown in examples below. See rzscontrol man page for more
|
||||
details.
|
||||
See project home for use cases, performance numbers and a lot more.
|
||||
|
||||
Individual zram devices are configured and initialized using zramconfig
|
||||
userspace utility as shown in examples below. See zramconfig man page for
|
||||
more details.
|
||||
|
||||
* Usage
|
||||
|
||||
Following shows a typical sequence of steps for using ramzswap.
|
||||
Following shows a typical sequence of steps for using zram.
|
||||
|
||||
1) Load Modules:
|
||||
modprobe ramzswap num_devices=4
|
||||
This creates 4 (uninitialized) devices: /dev/ramzswap{0,1,2,3}
|
||||
modprobe zram num_devices=4
|
||||
This creates 4 (uninitialized) devices: /dev/zram{0,1,2,3}
|
||||
(num_devices parameter is optional. Default: 1)
|
||||
|
||||
2) Initialize:
|
||||
Use rzscontrol utility to configure and initialize individual
|
||||
ramzswap devices. Example:
|
||||
rzscontrol /dev/ramzswap2 --init # uses default value of disksize_kb
|
||||
Use zramconfig utility to configure and initialize individual
|
||||
zram devices. For example:
|
||||
zramconfig /dev/zram0 --init # uses default value of disksize_kb
|
||||
zramconfig /dev/zram1 --disksize_kb=102400 # 100MB /dev/zram1
|
||||
|
||||
*See rzscontrol man page for more details and examples*
|
||||
*See zramconfig man page for more details and examples*
|
||||
|
||||
3) Activate:
|
||||
swapon /dev/ramzswap2 # or any other initialized ramzswap device
|
||||
mkswap /dev/zram0
|
||||
swapon /dev/zram0
|
||||
|
||||
mkfs.ext4 /dev/zram1
|
||||
mount /dev/zram1 /tmp
|
||||
|
||||
4) Stats:
|
||||
rzscontrol /dev/ramzswap2 --stats
|
||||
zramconfig /dev/zram0 --stats
|
||||
zramconfig /dev/zram1 --stats
|
||||
|
||||
5) Deactivate:
|
||||
swapoff /dev/ramzswap2
|
||||
swapoff /dev/zram0
|
||||
umount /dev/zram1
|
||||
|
||||
6) Reset:
|
||||
rzscontrol /dev/ramzswap2 --reset
|
||||
(This frees all the memory allocated for this device).
|
||||
zramconfig /dev/zram0 --reset
|
||||
zramconfig /dev/zram1 --reset
|
||||
(This frees memory allocated for the given device).
|
||||
|
||||
|
||||
Please report any problems at:
|
||||
|
|
Loading…
Reference in New Issue