async-arp
| Crates.io | async-arp |
| lib.rs | async-arp |
| version | 0.4.0 |
| created_at | 2025-02-10 19:24:26.956444+00 |
| updated_at | 2025-02-18 15:30:26.240261+00 |
| description | An async ARP client library for probing hosts and sending advanced ARP requests. |
| homepage | |
| repository | https://github.com/skullim/async-arp |
| max_upload_size | |
| id | 1550577 |
| size | 75,343 |
(skullim)
documentation
README
async-arp
async-arp is an asynchronous Rust crate that provides a high-level client for interacting with the Address Resolution Protocol (ARP). It can be used to probe the presence of hosts in a network or send advanced, custom ARP requests. This crate is ideal for network diagnostics, monitoring, or any application requiring interaction with ARP.
Features
- Async & Extensible: Uses the Tokio runtime for efficient asynchronous networking, with plans to support other async runtimes or a runtime-agnostic implementation.
- Host Probing: Quickly probe for active devices in the network using ARP requests.
- Advanced Requests: Send custom ARP requests and interact with devices in more complex ways.
- ARP Caching: ARP responses are cached for a customizable duration, reducing redundant network requests.
- Retry capabilities: Improves reliability when probing hosts with intermittent responses.
- Unix-only: This crate is designed for Unix-based systems (Linux, macOS, BSD).
Documentation
You can find the documentation for this project, including examples, usage, and API reference, here:
- Documentation (generated by rustdoc)
Requirements
This library requires elevated privileges to access raw network interfaces. You can either:
-
Grant the program the
CAP_NET_RAWcapability (recommended):This allows the program to run without
sudowhile still being able to access raw network interfaces. It's a more secure option than running the entire program as root.To grant the necessary capability, use the following command:
sudo setcap cap_net_raw=eip /path/to/your/program -
Run the program with sudo privileges
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.