GNUNET-NAT

Section: User Commands (1)
Page Index

BSD mandoc
 

NAME

gnunet-nat - interact with the NAT service  

SYNOPSIS

[-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-transport1

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-tutorial7.  

BUGS

Report bugs by using Lk https://bugs.gnunet.org or by sending electronic mail to Aq Mt gnunet-developers@gnu.org .


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
Basic examples
ICMP-based NAT traversal
Manual hole punching
STUN-based XXX:
SEE ALSO
BUGS