https://github.com/mullvad/mnl-rs

Rust bindings and abstraction for libmnl. A minimalistic user-space library oriented to Netlink developers
https://github.com/mullvad/mnl-rs

Last synced: about 2 months ago
JSON representation

Rust bindings and abstraction for libmnl. A minimalistic user-space library oriented to Netlink developers

• Host: GitHub
• URL: https://github.com/mullvad/mnl-rs
• Owner: mullvad
• License: apache-2.0
• Created: 2018-02-22T22:34:57.000Z (almost 7 years ago)
• Default Branch: main
• Last Pushed: 2024-06-10T02:37:15.000Z (7 months ago)
• Last Synced: 2024-10-31T11:27:35.331Z (about 2 months ago)
• Language: Rust
• Homepage: https://crates.io/crates/mnl
• Size: 54.7 KB
• Stars: 8
• Watchers: 10
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

        
# mnl

Safe abstraction for [`libmnl`], a minimalistic user-space library oriented to Netlink

developers. See [`mnl-sys`] for the low level FFI bindings to the C library.

This is work in progress and does not implement all of [`libmnl`] yet. Feel free to submit PRs

to support the parts you need!

The initial focus here was to support sockets and the parsing of responses. So far, the parts

that are covered the best are `mnl_socket_*` and `mnl_cb_run`. However the netlink messages are

just treated as raw byte buffers. It might make sense to add some abstraction struct at some

point.

## Selecting version of `libmnl`

See the documentation for the corresponding sys crate for details: [`mnl-sys`].

This crate has the same features as the sys crate, so the same features applies here.

## Prior/related work

The [`crslmnl`] crate is another wrapper around [`libmnl`]. At this stage it is a far more

complete abstraction of the library than this is. There are a few reasons I decided to start a

new wrapper crate. I'm not going to go into details on why, but basically it did not support

part of my use-case and I was no fan of the design choices made. Instead of having local

definitions of all the Linux header constants I made sure to get everything needed for netlink

[merged into `libc`]. I also want a separate [`mnl-sys`] crate that is pure FFI bindings

without logic or abstractions.

[`libmnl`]: https://netfilter.org/projects/libmnl/

[`mnl-sys`]: https://crates.io/crates/mnl-sys

[`crslmnl`]: https://crates.io/crates/crslmnl

[merged into `libc`]: https://github.com/rust-lang/libc/pull/922

License: MIT/Apache-2.0