nftnl-sys 0.6.4

Low level FFI bindings to libnftnl. Provides low-level userspace access to the in-kernel nf_tables subsystem
Documentation 
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
41
42
43
44
45
46
47
48

# nftnl-sys

Low level FFI bindings to [`libnftnl`], a userspace library providing a low-level netlink
programming interface (API) to the in-kernel nf_tables subsystem.

See [`nftnl`] for a higher level safe abstraction.

## Linking to libmnl and libnftnl

### `pkg-config`
By default this crate uses pkg-config to find and link to its C dependencies, [`libmnl`] and
[`libnftnl`].

### Manually
To manually configure where to look for these libraries, either set the environment
variables `LIBMNL_LIB_DIR` and `LIBNFTNL_LIB_DIR` to point to the directories where `libmnl.so`
(or `libmnl.a`) and `libnftnl.so` (or `libnftnl.a`) reside, or [`override the build script`] to
manually set the linker directives for both `nftnl` and `mnl`:

```toml
# .cargo/config.toml
[target.x86_64-unknown-linux-gnu.nftnl]
rustc-link-lib = ["nftnl", "mnl"]
rustc-link-search = ["<type>=<path-to-libnftnl>", "<type>=<path-to-libmnl>"]
```

## Selecting version of `libnftnl`

This crate has bindings for most versions of [`libnftnl`]. All bindings are generated by
[`bindgen`] via the `generate_bindings.sh` script in this repository.

Only one version of `libnftnl` can be exposed via this crate. By default the crate exports the
bindings for the oldest supported version (`libnftnl-1.0.6`). To get newer versions activate the
corresponding features. See `Cargo.toml` for available features/versions.

So for example, to get bindings to `libnftnl-1.0.9` depend on this crate like this:
```toml
[dependencies]
nftnl-sys = { version = "0.1", features = ["nftnl-1-0-9"] }
```

[`libnftnl`]: https://netfilter.org/projects/libnftnl/
[`libmnl`]: https://netfilter.org/projects/libmnl/
[`nftnl`]: https://crates.io/crates/nftnl
[`bindgen`]: https://crates.io/crates/bindgen
[`override the build script`]: https://doc.rust-lang.org/cargo/reference/build-scripts.html#overriding-build-scripts

License: MIT/Apache-2.0