Wishlist: more visible examples, especially without option `tokio`

[ydirson]

tokio is mentioned as being optional, and it would be useful for newcomers to get an idea how rust-netlink can be used without it.

I'm reporting this in netlink-proto since it is the one showing example code on docs.rs. It would be really useful to have links to example code more visible, directly on https://github.com/rust-netlink/ which gives a good idea of what's in this project, but not really of where to start (which package doc to look at first, where to find examples to get you started).

Note I did find the async_std example. It does however suffer from the same problem described in #7. Providing ready-to-go Cargo.toml files for all examples would make it really easier for users to try them, and would make it possible to check in CI jobs that they are still up-to-date with current code.

Also maybe a non-async example (e.g. with use polling) can be useful (or an explicit mention that only async style is supported), as not everyone has jumped aboard the async train yet.

[cathay4t]

This crate is design for internal usage.

The https://github.com/rust-netlink/ has updated with notes for new comer. Please check whether that helps.

I am afraid rust-netlink crates is designed to with tokio and smol in mind. If you have your socket implementation, you may try stuff like:

rtnetlink::new_connection_with_socket() and implement netlink_sys::AsyncSocket.

I haven't play with async_std for years, just don't have time to fix it up. Pull requests are welcome as always.

rust-netlink crates are divided into two parts:

• Packet parsing and emitting: netlink-packet-route, netlink-packet-netfilter, netlink-packet-generic, netlink-packet-audit, netlink-packet-wireguard, netlink-packet-xfrm, etc
• Async communication for linux kernel: rtnetlink, ethtool, wl-nl80211, etc

For non-async/blocking way, we do not have top level wrappin. Please give tokio a try, if your use case require minimum dependency, you need to code your own socket communication and use above packet parsing and emitting crates.