lagertonne/ifupdown-ng
1
0
Fork 0
Code Issues Pull requests Projects Releases 4 Wiki Activity
No description
558 commits 2 branches 32 tags 762 KiB
C 77.9%
Shell 18.9%
Makefile 3.2%
Find a file
Maximilian Wilhelm d86297f29c compat: Add glue for ifupdown2 bridge port VLAN inheritance. 
Add config options <compat_ifupdown2_bridge_ports_inherit_vlans>.

  In ifupdown2 <bridge-vids> as well as the <bridge-pvid> set on a bridge
  interface will be inherited by all member ports if not set explicitly.
  When set to 1 ifupdown-ng behaves the same way and will internally copy
  both options from the bridge member ports if they are not set on the
  member port. Valid values are 0 and 1, the default is 1.

Signed-off-by: Maximilian Wilhelm <max@sdn.clinic>
2020-10-18 04:58:23 +02:00
.github/workflows github: add kyua debug 2020-08-24 03:32:56 -06:00
cmd ifquery: Apply compatibility glue, too. 2020-10-18 04:57:24 +02:00
dist compat: Add glue for ifupdown2 bridge port VLAN inheritance. 2020-10-18 04:58:23 +02:00
doc compat: Add glue for ifupdown2 bridge port VLAN inheritance. 2020-10-18 04:58:23 +02:00
executor-scripts bridge: Remove fall back to IF_REQUIRES 2020-10-18 03:28:20 +02:00
libifupdown compat: Add glue for ifupdown2 bridge port VLAN inheritance. 2020-10-18 04:58:23 +02:00
tests tests: add dependency loop breaking test for ifdown 2020-10-08 02:09:30 -06:00
.gitignore ifctrstat: Initial structure for new applet 2020-08-14 11:27:43 -05:00
CODE_OF_CONDUCT.md add code of conduct 2020-07-18 04:51:25 -06:00
COPYING initial commit 2020-07-18 01:17:51 -06:00
Kyuafile tests: start working on testing capabilities 2020-07-18 19:46:32 -06:00
Makefile Introduce an compatibility layer which is empty for now. 2020-10-18 03:26:40 +02:00
README.md doc: Update build section in README 2020-10-14 00:12:24 +02:00

README.md

ifupdown-ng

ifupdown-ng is a network device manager that is largely compatible with Debian ifupdown, BusyBox ifupdown and Cumulus Networks' ifupdown2.

For more information read the admin guide.

Dependency Resolution

Dependency resolution example

ifupdown-ng uses a dependency resolver to determine interface bring-up order in a deterministic way.

This is accomplished through a combination of manual hinting using the requires keyword and dependency learning using native executors.

For compatibility with some legacy ifupdown executors, we also provide the requires keyword under other environment variables in some cases.

Caveats

  • ifupdown2 python plugins are not supported at this time. An executor could be written to handle them.

  • ifupdown-ng retains compatibility with /etc/network/if-X.d scripts, but will prefer using executors in /usr/libexec/ifupdown-ng where appropriate.

Building

On musl systems, simply do make and make install to build and install.

On glibc systems, you must install libbsd-dev or equivalent and additionally define LIBBSD_CFLAGS and LIBBSD_LIBS:

# instal packages
apt install build-essential libbsd0 libbsd-dev

# build ifupdown-ng
make LIBBSD_CFLAGS="$(pkg-config --cflags libbsd-overlay)" LIBBSD_LIBS="$(pkg-config --cflags --libs libbsd-overlay)"
make install

To run the tests, do make check. Running the checks requires kyua (apk add kyua, not packaged for Debian).

To build the documentation, do make docs and make install_docs. Building the documentation requires scdoc (apk add scdoc / apt install scdoc).

Discussion

Discuss ifupdown-ng on IRC: irc.as7007.net #ifupdown-ng