Staging: zram: Rename ramzswap to zram in documentation
authorNitin Gupta <ngupta@vflare.org>
Tue, 1 Jun 2010 08:01:26 +0000 (13:31 +0530)
committerGreg Kroah-Hartman <gregkh@suse.de>
Fri, 18 Jun 2010 19:50:30 +0000 (12:50 -0700)
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>
drivers/staging/zram/zram.txt

index 9694acfeb43f319d0ddb5be4a82eb85a9c94365b..520edc1bea73c0c048b6da52eb0edd24ea360080 100644 (file)
@@ -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: