| Andy Grover | 3aa27ba | 2012-03-13 15:00:37 -0700 | [diff] [blame] | 1 | python-kmod |
| 2 | =========== |
| 3 | |
| Andy Grover | 31aa683 | 2012-03-13 15:06:37 -0700 | [diff] [blame] | 4 | Python bindings for kmod/libkmod |
| Andy Grover | 3aa27ba | 2012-03-13 15:00:37 -0700 | [diff] [blame] | 5 | |
| Andy Grover | 31aa683 | 2012-03-13 15:06:37 -0700 | [diff] [blame] | 6 | kmod is a set of tools to handle common tasks with Linux kernel modules like |
| 7 | insert, remove, list, check properties, resolve dependencies and aliases. |
| 8 | |
| 9 | These tools are designed on top of libkmod, a library that is shipped with |
| 10 | kmod. It can be found at: |
| Andy Grover | 3aa27ba | 2012-03-13 15:00:37 -0700 | [diff] [blame] | 11 | |
| 12 | http://git.kernel.org/?p=utils/kernel/kmod/kmod.git;a=summary |
| 13 | |
| 14 | python-kmod is a Python wrapper module for libkmod, exposing common |
| 15 | module operations: listing installed modules, modprobe, and rmmod. |
| 16 | It is at: |
| 17 | |
| 18 | https://github.com/agrover/python-kmod |
| 19 | |
| 20 | Example (python invoked as root) |
| 21 | -------------------------------- |
| 22 | |
| W. Trevor King | 028fc12 | 2012-10-19 00:10:20 -0400 | [diff] [blame] | 23 | :: |
| Andy Grover | 3aa27ba | 2012-03-13 15:00:37 -0700 | [diff] [blame] | 24 | |
| W. Trevor King | 028fc12 | 2012-10-19 00:10:20 -0400 | [diff] [blame] | 25 | >>> import kmod |
| 26 | >>> km = kmod.Kmod() |
| Andy Grover | 9ebfb9c | 2012-12-14 09:27:36 -0800 | [diff] [blame^] | 27 | >>> [(m.name, m.size) for m in km.loaded()] |
| 28 | [(u'nfs', 407706), |
| 29 | (u'nfs_acl', 12741) |
| W. Trevor King | 028fc12 | 2012-10-19 00:10:20 -0400 | [diff] [blame] | 30 | ... |
| Andy Grover | 9ebfb9c | 2012-12-14 09:27:36 -0800 | [diff] [blame^] | 31 | (u'virtio_blk', 17549)] |
| W. Trevor King | 028fc12 | 2012-10-19 00:10:20 -0400 | [diff] [blame] | 32 | >>> km.modprobe("btrfs") |
| 33 | >>> km.rmmod("btrfs") |
| Andy Grover | 3aa27ba | 2012-03-13 15:00:37 -0700 | [diff] [blame] | 34 | |
| 35 | Building |
| 36 | -------- |
| 37 | |
| W. Trevor King | 161576d | 2012-10-19 00:11:17 -0400 | [diff] [blame] | 38 | Ensure Python, Cython, and the kmod headers are installed and run:: |
| Andy Grover | 3aa27ba | 2012-03-13 15:00:37 -0700 | [diff] [blame] | 39 | |
| W. Trevor King | 028fc12 | 2012-10-19 00:10:20 -0400 | [diff] [blame] | 40 | $ python setup.py build |