summaryrefslogtreecommitdiff
path: root/libkmod/python/README
blob: f03147667782d2aa40ca9e58accf91fd7d2fd4a4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
python-kmod
===========

Python bindings for kmod/libkmod

kmod is a set of tools to handle common tasks with Linux kernel modules like
insert, remove, list, check properties, resolve dependencies and aliases.

These tools are designed on top of libkmod, a library that is shipped with
kmod. 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()
  >>> [(m.name, m.size) for m in km.loaded()]
  [(u'nfs', 407706),
   (u'nfs_acl', 12741)
   ...
   (u'virtio_blk', 17549)]
  >>> km.modprobe("btrfs")
  >>> km.rmmod("btrfs")

Building
--------

Ensure Python, Cython, and the kmod headers are installed and run::

  $ python setup.py build