This code is a simple implementation of the Internet Control Message Protocol (ICMP) ping utility.
Go to file
Dandaedre 9a2d0c036a
rping CI rping passed CI.
Archive/rping/pipeline/head This commit looks good Details
fix: handle null Cargo metadata resolution
2026-10-04 04:19:51 +02:00
docs release: add rust_realease workflow 2026-10-04 04:08:53 +02:00
scripts ci: enforce MSRV and generate status badges 2026-10-04 03:58:34 +02:00
src ci: enforce MSRV and generate status badges 2026-10-04 03:58:34 +02:00
tests release: add rust_realease workflow 2026-10-04 04:08:53 +02:00
.gitignore release: add rust_realease workflow 2026-10-04 04:08:53 +02:00
CHANGELOG.md release: add rust_realease workflow 2026-10-04 04:08:53 +02:00
Cargo.lock ci: enforce MSRV and generate status badges 2026-10-04 03:58:34 +02:00
Cargo.toml release: add rust_realease workflow 2026-10-04 04:08:53 +02:00
Jenkinsfile fix: handle null Cargo metadata resolution 2026-10-04 04:19:51 +02:00
LICENSE Initial commit 2022-12-08 12:36:53 +01:00
README.md release: add rust_realease workflow 2026-10-04 04:08:53 +02:00
release.sh release: add rust_realease workflow 2026-10-04 04:08:53 +02:00
rust-release.toml release: add rust_realease workflow 2026-10-04 04:08:53 +02:00
rust-toolchain.toml ci: enforce MSRV and generate status badges 2026-10-04 03:58:34 +02:00

README.md

rping

rping is a Linux command-line utility for constructing and sending IPv4 or IPv6 ICMP packets. It is intended for network troubleshooting and packet inspection when the standard ping command does not expose enough control over packet fields and payloads.

Requirements

  • Rust 1.70 or newer; rustup uses the repository's pinned toolchain automatically.
  • Linux for live probes.
  • Permission to create ping sockets for normal live probes. Raw probes require root or CAP_NET_RAW.

Dry runs only construct and display packets, so they do not require network access or socket privileges.

Build

From the repository root:

cargo build --locked --release

The executable is written to target/release/rping.

Quick start

Construct an exact-size IPv4 echo request without DNS lookups or socket access:

cargo run --locked --quiet -- 127.0.0.1 \
  --payload-hex '00 ff 01' \
  --padding none \
  --dry-run

Expected output:

probe 1 seq=16962 dry run
1 probes, 0 replies, 0 ICMP errors, 1 dry runs

For a live probe, omit --dry-run. Review the Linux permissions described in Usage first; do not grant broader privileges than necessary.

Advanced

  • Usage covers address families, payloads, packet sizing, output formats, live probes, and raw sockets.
  • Development and CI covers contributor commands, the minimum supported Rust version, dependency policy, coverage, and badge publication.
  • Releasing covers release preparation, local packaging, collision checks, and publication through rust_realease.

The complete command reference is always available locally:

cargo run --locked -- --help

Development

Run the local quality gates from the repository root:

cargo fmt --all -- --check
cargo check --locked --all-targets --all-features
cargo +1.70.0 check --locked --all-targets --all-features
cargo test --locked --all-targets --all-features
cargo clippy --locked --all-targets --all-features -- -D warnings
cargo build --locked --release --all-features

See Development and CI for toolchain setup, documentation, and coverage commands.

License

Licensed under the MIT License.