1stunc(1)                           sofia-sip                          stunc(1)
2
3
4

NAME

6       stunc - STUN test client.
7

Synopsis

9       stunc [OPTIONS] <stun-server-address>
10

Description

12       The stunc utility can be used to gather information about possible NAT
13       devices that are located between the client and STUN server.
14
15       stunc can provide the following information: the IP address and port as
16       seen by the STUN server, detecting presence of NATs, and hints on the
17       type of address translation done. It should be noted that the results
18       of NAT type and life-time detection should be considered as hints.
19       There is no guarantee that NAT(s) will handle future packets in the
20       same way.
21

Command Line Options

23       The stunc utility accepts following command line options:
24
25       -b  Perform a STUN binding discovery. stunc will report the client
26           transport address (IP:port) as seen by the STUN server. In the
27           presence of NATs, this address is allocated by the NAT closest to
28           the STUN server.
29
30       -l  Perform a STUN binding life-time check.
31
32       -n  Perform a STUN binding type check. Notice that the results are only
33           hints. Nondeterministic behaviour, resource exhaustion, or reboots
34           of network elements can cause changes in NAT behaviour between
35           successive runs of stunc.
36
37       -r  Randomize the local port. Otherwise stunc let's the operating
38           system select a free port.
39
40       -s  Request a shared-secret over TLS. Tests whether the STUN server
41           supports the shared-secret mechanism (needed to protect message
42           integrity). Can be combined with -b, -l and -n.
43

Return Codes

45       0when successful 1when any errors detected
46

Examples

48       Discover the NAT binding, use a random local port:
49
50        $ stunc stunserver.org -b -r
51
52

Environment

54       STUN_DEBUG
55

Reporting Bugs

57       Report bugs to <sofia-sip-devel@lists.sourceforge.net>.
58

Authors

60       · Pekka Pessi <pekka -dot pessi -at- nokia -dot- com>
61
62       · Martti Mela <martti -dot mela -at- nokia -dot- com>
63
64       · Kai Vehmanen <kai -dot vehmanen -at- nokia -dot- com>
65

67       Copyright (C) 2005,2006 Nokia Corporation.
68
69       This program is free software; see the source for copying conditions.
70       There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
71       PARTICULAR PURPOSE.
72
73
74
75Version 1.12.6                    31 Jul 2007                         stunc(1)
Impressum