aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAndy Grover <agrover@redhat.com>2012-03-13 15:00:37 -0700
committerLucas De Marchi <lucas.demarchi@intel.com>2014-03-25 00:34:14 -0300
commit3aa27ba9882651a16dfae30daad15480039261e1 (patch)
treeaa249f1b48d077afdeee950f7696f505d3a4cbf6
parent8a4d09336e881d1062751b0c62021ca5487a3ae0 (diff)
downloadkmod-3aa27ba9882651a16dfae30daad15480039261e1.tar.gz
python: Add README
-rw-r--r--libkmod/python/README44
1 files changed, 44 insertions, 0 deletions
diff --git a/libkmod/python/README b/libkmod/python/README
new file mode 100644
index 0000000..9498ba0
--- /dev/null
+++ b/libkmod/python/README
@@ -0,0 +1,44 @@
+python-kmod
+===========
+
+Python bindings for libkmod
+
+libkmod is a C library to make inserting, removing, and listing
+Linux kernel modules easier. It can be found at:
+
+http://git.kernel.org/?p=utils/kernel/kmod/kmod.git;a=summary
+
+python-kmod is a Python wrapper module for libkmod, exposing common
+module operations: listing installed modules, modprobe, and rmmod.
+It is at:
+
+https://github.com/agrover/python-kmod
+
+Example (python invoked as root)
+--------------------------------
+
+>>>import kmod
+
+>>>km = kmod.Kmod()
+
+>>>km.loaded_modules()
+
+[('nfs', 407706),
+ ('nfs_acl', 12741)
+
+...
+
+ ('virtio_blk', 17549)]
+
+>>>km.modprobe("btrfs")
+
+>>>km.rmmod("btrfs")
+
+Building
+--------
+
+Ensure Python and kmod headers are installed and run:
+
+python setup.py build
+
+