Skip to content
netfyrPublic

About

Declarative network configuration for Linux.

Resources

Contributing

Stars

1 star

Watchers

2 watching

Forks

Repository files navigation

netfyr

Declarative network configuration for Linux, applied over netlink.

You describe the network state you want in YAML. netfyr reads the current state from the kernel, works out the difference, and applies it over netlink. The query and apply paths need no daemon.

YAML values are decoded using the embedded schema at each property path. For example, an address-looking interface name remains a string, while an ipv4.addresses[].ip value uses the declared CIDR format.

Work here is driven spec by spec from netfyr/specs.

Build and test

cargo build                    # compile the workspace
cargo test                     # unit tests
make test                      # shell integration tests
make test TAGS=ipv4,routing    # integration tests tagged ipv4 OR routing
make test TAGS=ipv4+routing    # integration tests tagged ipv4 AND routing

The workspace's first crate is netfyr-state, a library, so cargo test runs its unit tests now; the shell suite under make test will exercise the CLI once a later story lands one.

License

MIT. See LICENSE.

About

Declarative network configuration for Linux.

Resources

Contributing

Stars

1 star

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages