If what you are looking for is not listed here, please visit our Documentation Wiki.

RapidDisk / RapidCache

Download and installation

You can clone the latest (and stable) 2.x source tree from the git repository: $ git clone

You can clone the latest (and stable) 1.x source tree from the git repository: $ git clone

If you already have an older copy of the source code previously cloned from the git repository, you can simply update it with the git pull command. You can also download the latest tarball release from the RapidDisk Sourceforge pageNOTE – If you wish to download only the administration utilities, you can find and download the latest tarball(s) here.

Change into the directory and run the Makefile to build the management utility and kernel module:
$ cd rxdsk-1.x
$ make

NOTE – To build the rxadm management utility, you will need to have the zlib libraries and zlib development files installed on your host system. As of 1.3, the build links to zlib for compressed archiving and decompressed restoration of rxdsk volumes.
NOTE – While it will still install without it, in order to utilize the pyRxAdm graphical wrapper (introduced in 2.2), you are required to have both the Python programming language and the pyGTK module installed.
NOTE – To build the kernel module, you are required to having either the full kernel source or the kernel headers installed for your current kernel revision.

And install the management utility, kernel module, and man page (management utility is installed in /sbin): $ sudo make install

To insert the rxdsk module: $ sudo modprobe rxdsk

To remove the rxdsk module: $ sudo modprobe -r rxdsk

To insert the rxcache module: $ sudo modprobe rxcache

To remove the rxcache module: $ sudo modprobe -r rxcache

Installing modules with DKMS

This is only supported as of release 2.9.1 and later. To build: $ sudo make dkms

Installing / uninstalling the administration utilities

This is only supported as of release 2.9.1 and later.

Install: $ sudo make tools-install

Uninstall: $ sudo make tools-uninstall


Any and all patches for RapidDisk can be found at here. To install the patches intended for the module, copy it to the module/drivers/block path of the package and type the following to apply: $ patch -p0< patchname.patch

Note that each patch name will be descriptive enough to know which version of RapidDisk it applies to.


The majority of data integrity testing and benchmarking was accomplished using the fio test utility. Also byte level drive contents were closely examined via the native hexdump utility and invoked: $ hexdump -Cv /dev/rxd0|less.

Located in the test/ subdirectory of the source code is a small collection of very quick tests to run on a RapidDisk attached RAM disk raw block device. The rxio program tests a few basic block device functions which include getting the volume size, reading, writing, to even seeking, the rxioctl program tests the kernel module’s RXD_GET_STATS custom ioctl and the rxflush program sends the BLKFLSBUFioctl command to flush the block device’s buffer cache.

Building & executing the test tools

To compile:
$ gcc rxio.c -o rxio
$ gcc rxioctl.c -o rxioctl
$ gcc rxflush.c -o rxflush

To execute in place (make sure you create an rxd0 RapidDisk volume prior to executing):
$ ./rxio
$ ./rxioctl
$ ./rxflush

Note – The applications will only test the node named /dev/rxd0. You can change this in the code if necessary and recompile.