Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Python library for configuring the Linux kernel-based multiprotocol SCSI target (LIO)
Python Makefile Shell
Latest commit 5afe6d9 @agrover Do not use realpath() on fileio paths
RBD creates block device nodes named /dev/rbd0 -> rbdX, but these may refer
to different volumes after reboot. Users should use consistent names like
/dev/rbd/foo/bar, these are symlinks to rbdX.

rtslib should not use realpath() to get the rbdX name, but should just use
what was given, which may be a symlink, but it will point to the right

Resolves #57

Signed-off-by: Andy Grover <>


A Python object API for managing the Linux LIO kernel target

rtslib-fb is an object-based Python library for configuring the LIO generic SCSI target, present in 3.x Linux kernel versions.

This runs with Python 2 and 2to3 is run by to run on Python 3.

rtslib-fb development

rtslib-fb is licensed under the Apache 2.0 license. Contributions are welcome.

Since rtslib-fb is used most often with targetcli-fb, the targetcli-fb mailing should be used for rtslib-fb discussion.

In-repo packaging

Packaging scripts for RPM and DEB are included, but these are to make end-user custom packaging easier -- distributions tend to maintain their own packaging scripts separately. If you run into issues with packaging, start with opening a bug on your distro's bug reporting system.

Some people do use these scripts, so we want to keep them around. Fixes for any breakage you encounter are welcome.

"fb" -- "free branch"

rtslib-fb is a fork of the "rtslib" code written by RisingTide Systems. The "-fb" differentiates between the original and this version. Please ensure to use either all "fb" versions of the targetcli components -- targetcli, rtslib, and configshell, or stick with all non-fb versions, since they are no longer strictly compatible.

Something went wrong with that request. Please try again.