Skip to content

A prettier lightweight colored ping utility written in Rust

License

Notifications You must be signed in to change notification settings

k4yt3x/rustyping

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

rustyping

A prettier lightweight colored ping utility written in Rust.

screenshot

Installation

There are three installation options:

You will need cargo and rustup for the compilation. rustup is required since rustyping requires the nightly channel of the Rust toolchain. Currently, rustyping only support UNIX platforms (Linux and macOS). If you want it to be supported on other platforms, open an issue.

git clone https://github.com/k4yt3x/rustyping.git
cd rustyping
cargo build --release
cargo install --path .
strip $(which rp)

rustyping's binary will be installed to Cargo's binary directory (e.g., ~/.cargo/bin/rp). You can use the command rp to launch rustyping. Note that programs on Linux require the CAP_NET_RAW capability to be able to open raw sockets as an non-root user. The command below gives rustyping's binary this capability.

sudo setcap cap_net_raw=+eip $(which rp)

Unrestricted Mode

By default, non-root users can send pings at a minimal interval of 200ms or 0.2s. This is to prevent normal users from being able to cause ICMP floods. If you wish to disable this safety feature, you can compile rustyping with the unrestricted feature.

cargo build --release --features unrestricted

Usages

You can see the usages using the -h/--help switch.

USAGE:
    rp [OPTIONS] <DESTINATION>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -c, --count <COUNT>          stop after <count> replies [default: 0]
    -i, --interval <INTERVAL>    seconds between sending each packet [default: 1.0]
    -W, --timeout <TIMEOUT>      time to wait for response [default: 2.0]

ARGS:
    <DESTINATION>    dns name or ip address