Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Python library for configuring the Linux kernel-based multiprotocol SCSI target (LIO)

Change set_parameters/attributes to take an err_func

We don't want to silently hide errors when setting things, but we also
don't want to stop. Since these are both called from setup() functions,
we can just pass an err_func to them and they can call it if there's a
problem, but keep going.

When calling set_attribute for the storageobject, use a custom err_func
that also includes the name and plugin in the message.

Signed-off-by: Andy Grover <>
latest commit 9e336d2137
Andy Grover authored April 15, 2014
Octocat-spinner-32 debian debian: patch targetctl to use python3 November 02, 2013
Octocat-spinner-32 doc Add a tutorial for rtslib use January 03, 2014
Octocat-spinner-32 rpm rtslib: Change copyright to Apache License 2.0 July 23, 2013
Octocat-spinner-32 rtslib Change set_parameters/attributes to take an err_func April 15, 2014
Octocat-spinner-32 scripts Add a message if no configfile is found February 18, 2014
Octocat-spinner-32 .gitignore gitignore: remove *.spec it January 24, 2012
Octocat-spinner-32 COPYING rtslib: Change copyright to Apache License 2.0 July 23, 2013
Octocat-spinner-32 Makefile rename debian package to rtslib-fb October 25, 2013
Octocat-spinner-32 Update for in-repo packaging policy October 25, 2013
Octocat-spinner-32 update to 2.1.fb47 March 14, 2014


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.