PING3(1)

🌸 ping3 — the manual page, but make it make sense 🌸

okay so you wanna ping stuff with Python 3, and you want it to be real ICMP, not some fake TCP-handshake situation. bestie, this is the page for you. It's PING3(1), from the General Commands Manual, and we're gonna go through it together. grab a snack. 💖

---

✨ NAME ✨

ping3 — ICMP ping using raw sockets, implemented in Python 3. yes she's doing raw sockets. yes she's doing it in Python. no we are not okay about it. 💅

---

🦋 SYNOPSIS 🦋

ping3 [OPTION] [DEST_ADDR ...]

---

🌈 DESCRIPTION 🌈

So the whole vibe is: it's an ICMP ping implementation that uses raw sockets, written in Python 3. That's it. That's the whole thing. iconic, honestly.

This manual page is specifically for the ping3 executable. If you're looking for the Python module documentation, that lives in /usr/share/doc/python3-ping3/README.md.gz. (yes, gzipped. yes you'll need zcat or less. iykyk.)

⚠️ Okay so this part matters, don't skip it: usually, only processes running as root can create raw sockets. That's just how the kernel feels about it. If you want to use ping3 without root privileges, go read /usr/share/doc/python3-ping3/TROUBLESHOOTING.md. It's literally right there. the way that file is sitting there waiting to save you… 🫶

🎀 DEST_ADDR 🎀

• DEST_ADDR — the destination address, bestie. It can be an IP address or a domain name. Ex. 192.168.1.1 or example.com. she's flexible. she's versatile. main character energy. ✨

💅 THE FLAGS 💅

okay here's the whole roster, no skips, no skimming:

• -c COUNT, --count COUNT — how many pings you're sending. The default is 4. that's it. that's the number.
• -t TIMEOUT, --timeout TIMEOUT — how long to wait for a response, in seconds. The default is 4. (notice how both defaults are 4. symmetry. slay.)
• -i INTERNAL, --interval INTERVAL — how long to wait between each packet, in seconds. The default is 0. zero. no waiting. she's impatient and we respect it. 🔥
• -I INTERFACE, --interface INTERFACE — LINUX ONLY 🌈 — the gateway network interface to ping from. The default is None. if you're not on Linux this one is just gonna look at you funny.
• -S SRC_ADDR, --src SRC_ADDR — the IP address to ping from. This one's for when you've got multiple network interfaces and you need to pick a lane. The default is None.
• -T TTL, --ttl TTL — the Time-To-Live of the outgoing packet. The default is 64. ⭐
• -s SIZE, --size SIZE — the ICMP packet payload size, in bytes. The default is 56. fifty-six lil bytes of pure payload. 🍓
• -D, --debug — turn on DEBUG mode. for when you need to see everything. 👀
• -E, --exceptions — turn on EXCEPTIONS mode. she's gonna raise things. be ready. 😭
• -h, --help — show the help message and exit. the classic. the goat. the first flag everybody meets. 🫶
• -v, --version — show the program's version number and exit. 👑

---

👑 AUTHOR 👑

This manual page was written by Carles Pina i Estany <carles@pina.cat> for the Debian system (but may be used by others — she's generous like that).

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 any later version published by the Free Software Foundation. fr fr, it's in the license, go read it. 📜

---

💜 SEE ALSO 💜

• ping(8) — the OG. the ancestor. the blueprint.
• Full documentation in /usr/share/doc/python3-ping3/README.md.gz — everything you could ever want, compressed. 🧚

---

and that's the whole page, bestie!! no cap, you now know every single flag, every default, every path, and every warning on this thing. go forth and ping. go forth and slay. 💖✨🎀🦋🌸💅🫶

this has been PING3(1) — General Commands Manual — byeeee 💜