ping-fox
A ping (ICMP) library - simple to use and no root or setuid required.
Getting Started
In ping-fox a PingSentToken
represents an evidence that a ping message has been sent.
Each call to PingSender::send_to
returns a PingSentToken
which can be used to call PingReceiver::recieve
.
This makes sure that PingSender::recieve
is never called without a previous call to PingSender::send_to
.
The following example describes how to configure ping-fox and how to send and receive an echo messages and its response.
# Cargo.toml
[dependencies]
ping-fox = "0.1"
// .rs file
use ;
use Ipv4Addr;
use Duration;
// ### Configure the library:
// - `socket_type` can be `SocketType::RAW` or `SocketType::DGRAM`.
// - Use `SocketType::DGRAM` to avoid the need for elevated privileges.
let config = PingFoxConfig ;
// ### Create a ping sender and a ping receiver.
let = create.unwrap;
// ### Call `PingSender::send_to`
let token: PingSentToken = ping_sender
.send_to
.unwrap;
// ### Use the `PingSentToken` to call `PingReceiver::receive`.
let ping_response = ping_receiver.receive.unwrap;
// ### Read the ping result.
match ping_response ;
Examples
There are some examples in the example folder.
Running the tests
cargo run --lib
will run the unit tests.- We can run unit and integration tests with
cargo test
, but it will need elevated privileges for some of the tests using a raw socket. If we do not have privileges, some tests will fail.
Built With
- pnet_packet
- socket2
- recvmsg in order to obtain the time to live (TTL) without elevated privileges.
Contributing
Contributions are welcome. Please open an issue and we can discuss the specifics.
License
This project is licensed under the BSD-3-Clause license - see the LICENSE.md file for details