tcping 1.2.5

🛠️ tcping-rs: Rust (rs) TCP Ping (tcping) Utility for Port Reachability.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

<div align=right>Table of Contents↗️</div>

<h1 align=center><code>tcping-rs</code></h1>

<p align=center>🛠️ tcping-rs: Rust (rs) TCP Ping (tcping) Utility for Port Reachability.</p>

<div align=center>
  <a href="https://crates.io/crates/tcping">
    <img src="https://img.shields.io/crates/v/tcping.svg" alt="crates.io version">
  </a>
  <a href="https://crates.io/crates/tcping">
    <img src="https://img.shields.io/github/repo-size/lvillis/tcping-rs?style=flat-square&color=328657" alt="crates.io version">
  </a>
  <a href="https://github.com/lvillis/tcping-rs/actions">
    <img src="https://github.com/lvillis/tcping-rs/actions/workflows/ci.yaml/badge.svg" alt="build status">
  </a>
  <a href="https://hub.docker.com/r/lvillis/tcping">
    <img src="https://img.shields.io/docker/pulls/lvillis/tcping?style=flat-square" alt="docker pulls">
  </a>
  <a href="https://hub.docker.com/r/lvillis/tcping">
    <img src="https://img.shields.io/docker/image-size/lvillis/tcping/latest?style=flat-square" alt="image size">
  </a>
  <a href="mailto:lvillis@outlook.com?subject=Thanks%20for%20tcping-rs!">
    <img src="https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg" alt="say thanks">
  </a>

</div>

---

## Usage


```bash
tcping <host:port> [-c count] [-t] [-e] [-j] [-o mode]
```

Where:

- `host:port` is the host and port to ping
- `-c count` specifies the number of times to ping the host (default: 4)
- `-t` enables continuous pinging
- `-e` exits immediately after a successful probe
- `-j` calculates and displays jitter
- `-o mode` sets the output mode (`normal`, `json`, `csv`)
- `-h` displays help
- `-V` displays version

## Example


```bash
$ tcping github.com:443

Resolved address in 0.9340 ms
Probing 140.82.113.4:443/tcp - Port is open - time=12.7510ms
Probing 140.82.113.4:443/tcp - Port is open - time=12.4270ms
Probing 140.82.113.4:443/tcp - Port is open - time=11.4410ms
Probing 140.82.113.4:443/tcp - Port is open - time=12.7510ms

--- 140.82.113.4:443 tcping statistics ---
4 probes sent, 4 successful, 0.00% packet loss
Round-trip min/avg/max = 11.4410ms/12.3425ms/12.7510ms
Address resolved in 0.9340 ms
```

## Installation


### Download from Releases


Download the precompiled binaries from the [Releases Page](https://github.com/lvillis/tcping-rs/releases).

* Navigate to the [Releases](https://github.com/lvillis/tcping-rs/releases) section.
* Download the appropriate binary for your operating system.
* Extract the executable and place it in a directory included in your PATH.

### Using Docker


Run `tcping-rs` using the Docker image:

```shell
docker run --rm docker.io/lvillis/tcping:latest <host:port> [options]

```

## About


This tool allows you to measure the latency to a server using TCP. It is built with Rust and uses the clap library for
command line argument parsing.

## Special thanks


[![Jetbrains Logo](https://krwu.github.io/img/jetbrains.svg)](https://www.jetbrains.com/?from=init-rs)

Thanks to [Jetbrains](https://www.jetbrains.com/?from=tcping-rs) for supporting this small open source project!