Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
GNUNET-NAT-SERVER(1)	     General Commands Manual	    GNUNET-NAT-SERVER(1)

NAME
     gnunet-nat-server -- help GNUnet setup test network setup with NAT

SYNOPSIS
     gnunet-nat-server [-c FILENAME | --config=FILENAME] [-d | --daemonize]
		       [-h | --help] [-L FILENAME | --logfile=FILENAME]
		       [-v | --version] <PORT>

DESCRIPTION
     Running  a gnunet-nat-server is similar to running a hostlist server: it is
     a special service to the community with special requirements and no benefit
     to those running the service.

     This program will listen on the specified PORT  for  incoming  requests  to
     test  a  peer's network connectivity.  Incoming requests can ask it to con-
     nect to a given IPv4 address (and port) using TCP or  UDP	and  to  send  a
     2-byte  test  message using the specified address.  The program can also be
     asked to send a "fake" ICMP response message to a given IPv4  address  (for
     autonomous NAT traversal --- see the description in the respective research
     paper).

     The  idea	is that gnunet-nat-server will be run on some trusted hosts with
     unrestricted connectivity to allow GNUnet users to test their network  con-
     figuration.   As written, the code allows any user on the Internet to cause
     the gnunet-nat-server to send 2-bytes of arbitrary data to any TCP  or  UDP
     port at any address.  We believe that this is generally harmless.

     When  running gnunet-nat-server, make sure to use a configuration that dis-
     ables most NAT options but enables  'enable_nat_client'  and  sets  'inter-
     nal_address'  to  the  global  IP	address  of  your local host.  Also, the
     gnunet-helper-nat-client should be installed  locally  and  run  with  root
     privileges (SUID), otherwise the gnunet-nat-server will not work properly.

     Note  that  gnunet-nat-server  could be run via gnunet-arm but typically is
     not.  Also, the name of the host and port that gnunet-nat-server is run  on
     should  be  specified in the NATSERVER option in the [setup] section of the
     configuration file of hosts that are supposed to  autoconfigure  with  this
     server.

     Normal  GNUnet  end-users	should	not  concern themselves with gnunet-nat-
     server.  In fact, distributions are encouraged to consider not shipping  it
     at all.

     The options are as follows:

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

     -d | --daemonize
	     Daemonize gnunet-nat-server (detach from terminal).

     -h | --help
	     Print the help page.

     -L LOGLEVEL | --log=LOGLEVEL
	     Configure logging to use LOGLEVEL.

     -l FILENAME | --logfile=FILENAME
	     Configure logging to write logs to FILENAME.

     -v | --version
	     Print the GNUnet version.

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

FreeBSD ports 15.quarterly	February 25, 2012	    GNUNET-NAT-SERVER(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnunet-nat-server&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help