UPNPC(1)

💖 UPNPC — the miniupnpc library test client, bestie 💖

okay so like. this is upnpc, from the User Commands corner of the manual-verse. she's a test client for the miniupnpc library and she is, genuinely, so much. let's get into it 🫶

---

✨ NAME ✨

upnpc — miniupnpc library test client. that's it, that's her. iconic. 💅

---

🌸 SYNOPSIS 🌸

okay bestie, there are so many ways to run her. let's go one by one, no skips, no cap.

💖 Add port redirection

upnpc [options] -a ip port external_port protocol [duration]

🗑️ Delete port redirection

upnpc [options] -d external_port protocol <remote host>

📡 Get Connection status

upnpc [options] -s

📋 List redirections

upnpc [options] -l

📋✨ List redirections (using GetListOfPortMappings (for IGD:2 only)

upnpc [options] -L

🌈 Add (any) port redirection allowing IGD to use alternative external_port (for IGD:2 only)

upnpc [options] -n ip port external_port protocol [duration]

🧹 Delete range of port redirections (for IGD:2 only)

upnpc [options] -N external_port_start external_port_end protocol [manage]

🏠 Add all redirections to the current host

upnpc [options] -r port1 [external_port1] protocol1 [port2
[external_port2] protocol2] [...]

🕳️ Add Pinhole (for IGD:2 only)

upnpc [options] -A remote_ip remote_port internal_ip internal_port
protocol lease_time

🕳️🔄 Update Pinhole (for IGD:2 only)

upnpc [options] -U uniqueID new_lease_time

🕳️✅ Check if Pinhole is Working (for IGD:2 only)

upnpc [options] -C uniqueID

📦 Get Number of packets going through the rule (for IGD:2 only)

upnpc [options] -K uniqueID

🕳️🗑️ Delete Pinhole (for IGD:2 only)

upnpc [options] -D uniqueID

🔥 Get Firewall status (for IGD:2 only)

upnpc [options] -S

⏳ Get Outbound Pinhole Timeout (for IGD:2 only)

upnpc [options] -G remote_ip remote_port internal_ip internal_port
protocol

🖥️ Get Presentation url

upnpc [options] -P

---

🦋 DESCRIPTION 🦋

upnpc is a sample program for the miniupnpc library. like, a lil demo bestie that also happens to be useful. both things can be true. ✨

---

💅 OPTIONS 💅

okay these are the lil extras you can sprinkle on top of whatever mode you picked. main character energy only.

• -e description — sets the description for the port mapping. give your mapping a lil name tag 🎀
• -6 — use ip v6 instead of ip v4. glow up to the sixth version, fr fr 🌈
• -u url — bypass the discovery process entirely by providing the XML root description url. skipping the line, no waiting 💨
• -m address/interface — provides the ip address (ip v4) or the interface name (ip v4 or v6) to use for sending SSDP multicast packets. tell her where to shout from 📣
• -z localport — the SSDP packets' local (source) port. range is 1024-65535. pick your lane 🔢
• -p path — use this path for the MiniSSDPd socket. custom socket address, we love to see it 🛤️
• -t ttl — set the multicast TTL. the default value is 2. don't touch it if you don't need to, bestie 😌

---

👀 SEE ALSO 👀

go check out her friends, they're all slaying too:

• external-ip(1)
• upnp-listdevices(1)
• https://miniupnp.tuxfamily.org/

---

⚠️ real talk though: lots of these flags are marked for IGD:2 only — the pinhole ones, -L, -n, -N, -S, -G, -K, -U, -C, -D — so if your router is on an older IGD vibe, they simply will not hit the same. no cap. 🙈

---

miniupnpc · January 2018 — that's the source and the date, bestie, and that's the whole page 💜 stay hydrated, read your manpages, and remember: port redirection is self care 🫶✨