NAME

       gnunet-nat — interact with the NAT service

SYNOPSIS

       gnunet-nat     [-b     ADDRESS     |     --bind=ADDRESS]     [-c     FILENAME     |    --config=FILENAME]
                  [-e ADDRESS | --external=ADDRESS] [-i ADDRESS | --in=ADDRESS] [-r ADDRESS |  --remote=ADDRESS]
                  [-S NAME | --section=NAME] [-s | --stun] [-t | --tcp] [-u | --udp] [-W | --watch]

DESCRIPTION

       This tool allows testing various NAT traversal functions, as well as attempting auto-configuration.

OPTIONS

       -b ADDRESS | --bind=ADDRESS
               Assume that the service is (locally) bound to ADDRESS.

       -c FILENAME | --config=FILENAME
               Use the configuration file FILENAME.

       -e ADDRESS | --external=ADDRESS
               Assume that ADDRESS is the globally visible address of the peer.

       -i ADDRESS | --in=ADDRESS
               Assuming we are listening at ADDRESS for connection reversal requests.

       -r ADDRESS | --remote=ADDRESS
               Ask  the  peer at ADDRESS for connection reversal, using the local address for the target address
               of the reversal.

       -S NAME | --section=NAME
               Name of section in configuration file to use for additional options.

       -s | --stun
               Enable processing of STUN requests.  Will try to read UDP  packets  from  the  bind  address  and
               handle the packets if they are STUN packets.  Will only work with UDP.

       -t | --tcp
               Use TCP.

       -u | --udp
               Use UDP.

       -W | --watch
               Watch for connection reversal requests.

EXAMPLES

   Basic examples
             # gnunet-nat -i 0.0.0.0:8080 -u

       We are bound to "0.0.0.0:8080" on UDP and want to obtain all applicable IP addresses.

             # gnunet-nat -i '[::0]':8080 -t

       We are bound to "::0" on port 8080 on TCP and want to obtain all applicable IP addresses.

             # gnunet-nat -i 127.0.0.1:8080 -u

       We are bound to "127.0.0.1:8080" on UDP and want to obtain all applicable IP addresses:

   ICMP-based NAT traversal
             # gnunet-nat -Wt -i 192.168.178.12:8080

       Watch  for  connection  reversal  request  (you must be bound to NAT range or to wildcard, 0.0.0.0), only
       works for IPv4:

             # gnunet-nat -t -r 1.2.3.4:8080 -i 2.3.4.5:8080

             # gnunet-nat -t -r 1.2.3.4:8080 -i 0.0.0.0:8080

       Initiate connection reversal request from peer at external IPv4 address 1.2.3.4, and let the kernel  fill
       in whatever IPv4 address we happen to have:

   Manual hole punching
             # gnunet-nat -t -p AUTO:8080

       Assume manually punched NAT, but determine external IP automatically:

   STUN-based XXX:
             # gnunet-nat FIXME -s

       XXX

SEE ALSO

       gnunet-transport(1)

       The  full documentation for gnunet is maintained as a Texinfo manual.  If the info(1) and gnunet programs
       are properly installed at your site, the command

             info gnunet

       should give you access to the complete handbook,

             info gnunet-c-tutorial

       will give you access to a tutorial for developers.

       Depending on your installation, this information is also available in gnunet(7) and gnunet-c-tutorial(7).

BUGS

       Report   bugs   by    using    https://bugs.gnunet.org    or    by    sending    electronic    mail    to
       ⟨gnunet-developers@gnu.org⟩.

Debian                                          October 26, 2018                                   GNUNET-NAT(1)