Introduction

Pingme 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

1. Download latest release (recommend)

2. Use go get

go get -u github.com/noobly314/pingme

3. Build on your own

git clone https://github.com/noobly314/pingme.git
cd pingme
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

$ pingme -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

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

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

$ pingme -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 pingme.

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

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

License

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

Acknowledgements

https://ip-api.com

lmas/icmp_ping.go

sparrc/go-ping

davecheney/httpstat