]> git.proxmox.com Git - mirror_ifupdown2.git/blob - ifupdown2-addons/docs/source/intro.rst
Initial import of ifupdown2 sources
[mirror_ifupdown2.git] / ifupdown2-addons / docs / source / intro.rst
1 python-ifupdown2-addons
2 -----------------------
3
4 The python-ifupdown2-addons package contains ifupdown2 addon modules.
5
6 addon modules are responsible for applying interface configuration.
7 The modules are installed under /usr/share/ifupdownmodules.
8
9 Each module can declare its own set of supported attributes. Each module
10 is passed the iface object (which is a representation of /etc/network/interfaces
11 iface entry). Each module is also passed the operation to be performed.
12
13 Example modules are /usr/share/ifupdownmodules/address.py,
14 /usr/share/ifupdownmodules/bridge.py etc
15
16 The order in which these modules are invoked is listed in
17 /var/lib/ifupdownaddons/addons.conf. There is a ifaddon utility in the works
18 to better manage the module ordering.
19
20 For details on how to add a module, see the api reference and development
21 documentation.