summaryrefslogtreecommitdiff
path: root/libkmod/python/README
blob: 8ca3aae6312e2bd682db8b2ec6391ee6976f4f60 (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()
  >>> km.loaded_modules()
  [('nfs', 407706),
   ('nfs_acl', 12741)
   ...
   ('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