gping(1)

📦
version 1.21.0 · 4 versions
, in arch rolling, nixpkgs unstable

🌸 gping(1) — the manual, but make it cute 🌸

okay bestie, you found the gping(1) page from the General Commands Manual and honestly? you're about to have a great time. this is the ping tool that ate and left no crumbs 💅

✨ NAME ✨

gping — Ping, but with a graph.

🦋 SYNOPSIS 🦋

gping [--cmd] [-n|--watch-interval] [-b|--buffer] [-4 ] [-6 ]
[-i|--interface] [-s|--simple-graphics] [--vertical-margin]
[--horizontal-margin] [--ymin] [--ymax] [-0 ] [--tcp] [--tcp-rst]
[--tcp-port] [-c|--color] [--clear] [--ping-args] [-h|--help]
[HOSTS_OR_COMMANDS]

💖 DESCRIPTION 💖

Ping, but with a graph.

(that's it. that's the whole description. short king behavior fr fr 👑)

🎀 OPTIONS 🎀

  • --cmd — graph the execution time of a list of commands instead of pinging hosts. it's giving "speedrun my scripts" energy ⏱️
  • -n, --watch-interval <WATCH_INTERVAL> — the watch interval in seconds, and yes you can pass partial seconds like '0.5' 🫶. default for ping is 0.2 (but 1.0 on OpenBSD, special little guy), default for cmd is 0.5
  • -b, --buffer <BUFFER> [default: 30] — how many seconds of data the graph shows. big buffer = big picture energy 🔥
  • -4 — resolve ping targets to IPv4 addresses
  • -6 — resolve ping targets to IPv6 addresses
  • -i, --interface <INTERFACE> — the interface to use when pinging. pick your lane bestie 🛣️
  • -s, --simple-graphics — no description in the original, just vibes and mystery 🙈 iconic honestly
  • --vertical-margin <VERTICAL_MARGIN> [default: 1] — vertical margin around the graph (top and bottom)
  • --horizontal-margin <HORIZONTAL_MARGIN> [default: 0] — horizontal margin around the graph (left and right). breathing room, we love to see it 🌬️
  • --ymin <YMIN> — set the vertical axis min (ms)
  • --ymax <YMAX> — set the vertical axis max (ms)
  • -0 — literally equivalent to --ymin=0. shortcut slay ⭐
  • --tcp — use TCP pings instead of ICMP
  • --tcp-rst <TCP_RST> [default: pong] — how to treat a connection refused (RST) when TCP pinging. the possible values are:
    • pong: count it as a successful ping — the host answered, it just isn't listening. it replied, that counts 💅
    • drop: count it as a failed ping
  • --tcp-port <TCP_PORT> [default: 80] — port to connect to (only used for TCP pings)
  • -c, --color <color> — assign a color to a graph entry 🎨

this option can be defined more than once as a comma separated string, 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 these 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' 🌈

  • --clear — clear the graph from the terminal after closing the program. leaving no trace, ghost mode 👻
  • --ping-args [<PING_ARGS>...] — extra arguments to pass to ping. heads up: these are platform dependent 🫠
  • -h, --help — print help (see a summary with '-h')
  • [HOSTS_OR_COMMANDS] — hosts or IPs to ping, or commands to run if --cmd is provided. you can use cloud shorthands like aws:eu-west-1 ☁️

👑 AUTHORS 👑

Tom Forbes <tom@tomforb.es> — the main character who made all of this happen 💜

lowkey reminder bestie: nothing here is vibes-only, it's all real flags — so copy the spelling exactly, --tcp-rst is not the moment for typos 😭

🌸 and that's the whole page! it's the gping(1) manual from the gping source, footer and all — the version stamp at the bottom just says gping and it lives in section gping(1), so we're keeping it iconic and signing off. bye bestie, go graph something pretty 💖✨🎀

📦 where this page comes from