Pluto

A tcping tool.

Binary usage

Basic:

❯ pluto google.com -m http -w
Ping http://google.com:80(198.18.1.70:80) - Connected - time=378.73608ms
Ping http://google.com:80(198.18.1.70:80) - Connected - time=370.01617ms
Ping http://google.com:80(198.18.1.70:80) - Connected - time=375.24347ms
Ping http://google.com:80(198.18.1.70:80) - Connected - time=370.21255ms
Ping statistics for google.com:80
4 package sent, 4 package success, 0 package loss
Approximate trip timesin milliseconds:
Minimum = 378.73608ms, Maximum = 370.01617ms, Average = 373.55206ms

HTTP:

pluto google.com -m http

Waitting response (HTTP only)

pluto google.com -m http -w

And more:

❯ pluto google.com 443 -m http -w -b 512 -c 5
Ping http://google.com:443(198.18.1.70:443) - Connected - time=516.17883ms
Ping http://google.com:443(198.18.1.70:443) - Connected - time=308.3648ms
Ping http://google.com:443(198.18.1.70:443) - Connected - time=301.67624ms
Ping http://google.com:443(198.18.1.70:443) - Connected - time=267.50793ms
Ping http://google.com:443(198.18.1.70:443) - Connected - time=349.98373ms
Ping statistics for google.com:443
5 package sent, 5 package success, 0 package loss
Approximate trip timesin milliseconds:
Minimum = 516.17883ms, Maximum = 267.50793ms, Average = 348.7423ms

❯ pluto -h
A tcping tool
Usage: pluto [OPTIONS] [HOST] [PORT]
Arguments:
[HOST] Target host address
[PORT] Target host port [default: 80]
Options:
-c, --count <COUNT> Total package send count [default: 4]
-m, --method <METHOD> The protocol will used, http or tcp [default: tcp] [possible values: tcp, http]
-w, --wait Wait http response, only for -m http
-b, --bytes <BYTES> Send package size, will add to body with http [default: 56]
-X, --x <X> Http request method [default: get] [possible values: get, head, post, put, delete, connect, options, trace, patch]
-t, --timeout Ignore count, send packages forever
-h, --help Print help
-V, --version Print version

Build from source

cargo build --release

Install with cargo

cargo install --path .

Cross compile

Requirement:

brew tap SergioBenitez/osxct
brew install FiloSottile/musl-cross/musl-cross
brew install SergioBenitez/osxct/x86_64-unknown-linux-gnu
brew install mingw-w64

rustup target add x86_64-unknown-linux-musl
rustup target add x86_64-unknown-linux-gnu
rustup target add x86_64-pc-windows-gnu

Build dynamic link for Linux on MacOS

TARGET_CC=x86_64-unknown-linux-gnu cargo build --release --target x86_64-unknown-linux-gnu

Static link for Linx on MacOS

TARGET_CC=x86_64-linux-musl-gcc \
RUSTFLAGS="-C linker=x86_64-linux-musl-gcc" \
cargo build --target=x86_64-unknown-linux-musl --release

For Windows on MacOS

cargo build --target=x86_64-pc-windows-gnu --release

Library usage

Install

# Cargo.toml
[dependencies]
pluto = { git = "https://github.com/DefectingCat/pluto", branch = 'master' }

Minimum dependencies:

anyhow = "1.0.72"clap = { version = "4.3.15", features = ["derive"] }
thiserror = "1.0.43"

Build with args

letmut pluto = Pluto::build(args.method, host, args.port);
pluto = Pluto{wait: args.wait,bytes: args.bytes,http_method: args.x,
..pluto
};
pluto.ping().await?;

Full example

letmut pluto = Pluto::build(args.method, host, args.port);
pluto = Pluto{wait: args.wait,bytes: args.bytes,http_method: args.x,
..pluto
};for _ in0..args.count{match pluto.ping().await{Ok(_) => {}Err(err) => {eprintln!("Ping {}", err)}};}match pluto.end(){Ok(_) => {
thread::sleep(Duration::from_millis(500));}Err(err) => {eprintln!("{}", err);}}let len = pluto.queue.len();println!();println!("Ping statistics for {}", pluto.host);println!("{} package sent, {} package success, {} package loss",
len,
pluto.result.success,
len - pluto.result.success
);println!("Approximate trip times in milliseconds:");println!("Minimum = {}ms, Maximum = {}ms, Average = {}ms",
pluto.result.maximum, pluto.result.minimum, pluto.result.average
);

Options

pubstructPluto{/// Calculate total timepubstart:Instant,/// Connect method, tcp or httppubmethod:PingMethod,/// Target host port, default 80pubport:u32,/// Tcp package queuepubqueue:Vec<TcpFrame>,/// Target hostpubhost:String,/// elapsed time millispubelapsed:f32,/// Wait target host response, only for httppubwait:bool,/// Data lengthpubbytes:usize,/// The method of httppubhttp_method:HttpMethod,/// All resultspubresult:PingResult,}