Introduction

TCPING is ping probe command line tool, supporting ICMP, TCP and HTTP protocols.

You can also use it to query IP information from third-party api provider (currently we use https://ip-api.com).

Features

Support ICMP/TCP/HTTP protocols
Query basic IP information

Installation

Download latest release (recommend)
Use go get

go get -u github.com/i3h/tcping

Build on your own

git clone https://github.com/i3h/tcping.git
cd tcping
go build

Usage

  -h string
        HTTP Ping
  -i string
        ICMP Ping
  -m string
        MTR Trace
  -q string
        Query ip information
  -t string
        TCP Ping
  -v    Version

Examples

$ tcping -h https://www.google.com
Proxy     :    false
Scheme    :    https
Host      :    www.google.com
DNS Lookup:    2.05 ms
TCP       :    2.41 ms
TLS       :    68.92 ms
Process   :    29.28 ms
Transfer  :    0.19 ms
Total     :    103.06 ms

$ tcping -i www.google.com
ICMP   OPEN      74.125.200.147    2.2 ms

$ tcping -t www.google.com:443
TCP    OPEN      www.google.com:443

$ tcping -q www.google.com
IP     :    172.217.194.103
City   :    Queenstown Estate
Country:    Singapore
ISP    :    Google LLC
AS     :    AS15169 Google LLC

Note

Root permission is required when running ICMP ping, since it needs to open raw socket.

You can either use sudo command, or set setuid bit for tcping.

// Use sudo for one-time ping
$ sudo tcping -i google.com

// Set setuid bit
$ sudo chown root:root tcping
$ sudo chmod u+s tcping

License

See the LICENSE file for license rights and limitations (MIT).

Acknowledgements

2.0 KiB Raw Permalink Blame History