stunc(1)

📦
version 1.12.11+20110422.1+1e14eea · 4 versions
, in ubuntu noble, ubuntu questing

💖 stunc — the STUN test client, bestie edition 💖

okay so first things first, this is stunc from the sofia-sip-utils crew, and she's a STUN test client. that's the whole vibe. but like, who made her? let's give credit where credit is due 🫶

  • Author: Pekka Pessi <Pekka.Pessi@nokia.com>, Martti Mela <Martti.Mela@nokia.com>, Kai Vehmanen <Kai.Vehmanen@nokia.com>
  • Date: Created: Thu Jul 24 17:21:00 2003 ppessi

✨ SYNOPSIS ✨

stunc [OPTIONS] <stun-server-address>

🌸 DESCRIPTION 🌸

so stunc is literally the girl you call when you wanna snoop on the NAT devices chilling between you and your STUN server. she gathers all the info. it's giving detective energy 🔍

here's the tea she can serve you: the IP address and port as seen by the STUN server, detecting the presence of NATs, and hints on the type of address translation being done. slay.

⚠️ bestie, listen — the results of NAT type and life-time detection should be considered hints. there is no guarantee that NAT(s) will handle future packets in the same way. so don't come for her if the network switches up on you, okay? 😭

💅 COMMAND LINE OPTIONS 💅

the stunc utility accepts the following command line options, and yes we're going through every single one:

  • -b — perform a STUN binding discovery. stunc will report the client transport address (IP:port) as seen by the STUN server. when NATs are in the picture, this address is allocated by the NAT closest to the STUN server. iconic behavior honestly.
  • -l — perform a STUN binding life-time check.
  • -n — perform a STUN binding type check. and like, heads up: the results are only hints. nondeterministic behaviour, resource exhaustion, or reboots of network elements can cause changes in NAT behaviour between successive runs of stunc. so run it twice and get different answers? not a bug, that's just the network being messy 💀
  • -r — randomize the local port. otherwise stunc lets the operating system select a free port. (letting the OS pick is lowkey fine too, but go off 👑)
  • -s — request a shared-secret over TLS. tests whether the STUN server supports the shared-secret mechanism (needed to protect message integrity). can be combined with -b, -l and -n. the way she multi-tasks?? obsessed. 💜

🔥 RETURN CODES 🔥

  • 0 — when successful ✨
  • 1 — when any errors detected 💀

🌈 EXAMPLES 🌈

discover the NAT binding, use a random local port:

$ stunc stunserver.org -b -r

that's it. that's the whole flex. main character energy fr fr 🎀

🦋 ENVIRONMENT 🦋

#STUN_DEBUG

🙈 REPORTING BUGS 🙈

found something cursed? report bugs to sofia-sip-devel@lists.sourceforge.net. she wants to know, bestie 🫶

👑 AUTHORS 👑

  • Pekka Pessi <pekka -dot pessi -at- nokia -dot- com>
  • Martti Mela <martti -dot mela -at- nokia -dot- com>
  • Kai Vehmanen <kai -dot vehmanen -at- nokia -dot- com>

Copyright (C) 2005,2006 Nokia Corporation.

This program is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

and that's the whole page babes 🌟 brought to you by sofia-sip-utils, Version 1.12.11devel, from the stunc(1) manual — mwah, go discover some NATs, periodt. 💅✨🌸

📦 where this page comes from