winping-rs 0.11.0

An easy-to-use ICMP Echo API for Windows programs without requiring elevated rights.
Documentation
  • Coverage
  • 100%
    30 out of 30 items documented1 out of 1 items with examples
  • Size
  • Source code size: 102.0 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 505.0 kB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 3s Average build duration of successful builds.
  • all releases: 3s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • MikeRomaniuk/winping-rs
    0 0 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • MikeRomaniuk

winping-rs

Tests (MSVC) Tests (GNU) crates.io docs.rs MIT Licensed Apache2 Licensed

An easy-to-use ICMP Echo library for Windows. Does not require elevated permissions. Has async support.

This is a maintained fork of TyPR124/winping, which was last released as winping 0.10.1. It is a drop-in replacement: the public API, the library name, and the feature flags are identical, so swapping the dependency line is the only change required. The fork modernizes the internals:

  • Edition 2024, MSRV 1.85.
  • No transitive dependencies. The only dependency is windows-sys, Microsoft's official Win32 binding crate, which itself has no dependencies. The previous winapi stack is gone.
  • Most transmute calls removed, remaining unsafe blocks documented, and a strict lint set (unsafe_op_in_unsafe_fn, undocumented_unsafe_blocks, as_conversions, …) enforced in CI.
  • Tests moved out of src/ into tests/.

Usage

Add to your Cargo.toml:

[dependencies]
winping-rs = "0.11"

The package is winping-rs, but the library is still named winping, so imports are unchanged:

use winping::{Buffer, Pinger};

See docs.rs for examples and documentation.

Migrating from winping 0.10

Drop-in: swap the dependency line and rebuild. No code changes, no import changes, no feature-flag changes. If you would rather keep the dependency spelled winping in your own manifest, rename it on the way in and even the manifest diff disappears:

[dependencies]
winping = { package = "winping-rs", version = "0.11" }

OS Compatability

This crate supports Windows 10 and later, including both desktop and server variants, on x86_64, i686, and aarch64.

Older releases were tested against Windows 7 and 8.1. Those versions are no longer supported or tested: the MSVC toolchain dropped Windows 7 support in Rust 1.78.

Minimum Supported Rust Version

Rust 1.85 (edition 2024).

Contributions

Contributions of all kinds are welcome. File a GitHub issue if you find a problem, bug, or think something can be improved.

If you wish to contribute code, please run:

cargo fmt --all
cargo clippy --all-targets -- -D warnings
cargo test

The toolchain is pinned by rust-toolchain.toml to a dated nightly, so rustup will fetch it automatically. Nightly is required because rustfmt.toml uses imports_granularity and group_imports, which are nightly-only rustfmt options. Lints are configured in Cargo.toml under [lints] (ported from Devolutions/IronRDP).

Note that the pinned nightly is far ahead of the declared MSRV (1.85), so day-to-day builds do not exercise it. CI has a dedicated MSRV (1.85) job that runs cargo +1.85.0 check to guarantee the declared minimum keeps compiling. When changing the MSRV, update rust-version in Cargo.toml, msrv in clippy.toml, and that job together.

License

Licensed under either of MIT or Apache-2.0 at your option.

Original work Copyright (c) 2020 Tyler Ruckinger. Fork modifications Copyright (c) 2026 Mike Romaniuk.