Skip to content

Latest commit

 

History

History
94 lines (77 loc) · 3.97 KB

readme.md

File metadata and controls

94 lines (77 loc) · 3.97 KB

gping 🚀

Crates.io Actions Status

Ping, but with a graph.

Comes with the following super-powers:

  • Graph the ping time for multiple hosts
  • Graph the execution time for commands via the --cmd flag
  • Custom colours
  • Windows, Mac and Linux support

Table of Contents

Packaging status

Install 💿

  • macOS
  • Linux (Homebrew): brew install orf/brew/gping
  • CentOS (and other distributions with an old glibc): Download the MUSL build from the latest release
  • Windows/ARM:
  • Fedora (COPR): sudo dnf copr enable atim/gping -y && sudo dnf install gping
  • Cargo (This requires rustc version 1.44.0 or greater): cargo install gping
  • Arch Linux: pacman -S gping
  • Ubuntu/Debian (Azlux's repo):
echo "deb http://packages.azlux.fr/debian/ buster main" | sudo tee /etc/apt/sources.list.d/azlux.list
wget -qO - https://azlux.fr/repo.gpg.key | sudo apt-key add -
sudo apt update
sudo apt install gping
sudo eselect repository enable dm9pZCAq
sudo emerge --sync dm9pZCAq
sudo emerge net-misc/gping::dm9pZCAq

Usage 🎷

Just run gping [host]. host can be a command like curl google.com if the --cmd flag is used. You can also use shorthands like aws:eu-west-1 or aws:ca-central-1 to ping specific cloud regions. Only aws is currently supported.

$ gping --help
gping 1.3.2
Ping, but with a graph.

USAGE:
    gping [FLAGS] [OPTIONS] [--] [hosts-or-commands]...

FLAGS:
        --cmd                Graph the execution time for a list of commands rather than pinging hosts
    -h, --help               Prints help information
    -4                       Resolve ping targets to IPv4 address
    -6                       Resolve ping targets to IPv6 address
    -s, --simple-graphics    Uses dot characters instead of braille
    -V, --version            Prints version information

OPTIONS:
    -b, --buffer <buffer>
            Determines the number of seconds to display in the graph. [default: 30]

    -c, --color <color>...
            Assign color to a graph entry. This option can be defined more than once and the order which the colors are
            provided will be matched against the hosts or commands passed to gping. Hexadecimal RGB color codes are
            accepted in the form of '#RRGGBB' or the following color names: 'black', 'red', 'green', 'yellow', 'blue',
            'magenta', 'cyan', 'gray', 'dark-gray', 'light-red', 'light-green', 'light-yellow', 'light-blue', 'light-
            magenta', 'light-cyan', and 'white'
        --horizontal-margin <horizontal-margin>    Horizontal margin around the graph (left and right) [default: 0]
        --vertical-margin <vertical-margin>        Vertical margin around the graph (top and bottom) [default: 1]
    -n, --watch-interval <watch-interval>
            Watch interval seconds (provide partial seconds like '0.5'). Default for ping is 0.2, default for cmd is
            0.5.

ARGS:
    <hosts-or-commands>...    Hosts or IPs to ping, or commands to run if --cmd is provided. Can use cloud
                              shorthands like aws:eu-west-1.