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

FreeBSD Manual Pages


home | help
MIREDO.CONF(5)		    System Manager's Manual		MIREDO.CONF(5)

       miredo.conf - configuration for Miredo


       miredo.conf   is	the configuration file for Miredo.  Each configuration
       directive consists of one directive name, possibly followed by  one  or
       several	spaces	and  a	value  for the directive.  White spaces, empty
       lines and lines starting	with '#' are ignored.

       Directives are case-insensitive.	A comprehensive	list of	the  supported
       directives follows:

       RelayType (client|autoclient|relay|cone|restricted)
	      Specifies	what type of Teredo relay/client Miredo	will serve as.
	      There are	three possible choices:

       client mode (the	default)
	      In client	mode, Miredo acts as  a	 Teredo	 client.  Miredo  will
	      first authenticate with a	Teredo server (see ServerAddress), and
	      if successful, will setup	a Teredo tunneling  interface  with  a
	      public  Teredo  IPv6 address and a default IPv6 route. That vir-
	      tual networking interface	can be used to reach the IPv6 Internet
	      as well as Teredo	clients.

	      The use of Miredo	as a Teredo client allows nodes	to get an IPv6
	      connectivity from	behind a NAT router device, as it tunnels IPv6
	      packets  over  UDP/IPv4  with  special  support for NAT routers.
	      Routers of that kind usually only	forward	 TCP,  UDP,  and  some
	      ICMP, IPv4 packets (with some limitation).

	      NOTE:  Use  of Miredo as a Teredo	client is possible even	if the
	      system already has IPv6 connectivity through  another  way  (na-
	      tive, 6to4, TSP, etc). In	that case, Miredo will only be used to
	      reach other Teredo clients, as its tunneling interface has a de-
	      fault route with a higher	metric (which is to say	a lower	prior-
	      ity) than	the other network interfaces.

       autoclient is currently an alias	for client mode.

       cone mode (relay	also works)
	      In cone mode, Miredo acts	as a Teredo relay. It will assume that
	      it  has  public  global  IPv4 connectivity with no firewall.  In
	      other words, the UDP  port  used	by  Miredo  must  receive  un-
	      soliticited  traffic from	the IPv4 Internet (see also BindPort).
	      Miredo will create a virtual networking interface	with  a	 route
	      toward Teredo clients.

	      Teredo  relays  forward  IPv6 packets between Teredo clients and
	      the IPv6 Internet. For that to work, Teredo relays MUST  have  a
	      working  IPv6  connectivity  through  a way distinct from	Teredo
	      tunneling	(native, 6to4, ISATAP, etc).

	      Warning: This mode should	only be	used if	the node has a	public
	      IPv4  address,  or  if  it is behind a full cone NAT-router with
	      proper port forwarding rules.  Otherwise	the  tunnel  will  NOT
	      WORK  PROPERLY.	Note that many NAT port	forwarding implementa-
	      tions are	broken.

       restricted mode
	      This mode	is identical to	the cone mode documented  above,  with
	      the exception that direct	Teredo bubbles will be sent.  Theoret-
	      ically (see RFC4380) this	permits	operation of  a	 Teredo	 relay
	      from  behind a restricted-port NAT.  In practice,	this makes NAT
	      traversal	extremely unreliable.  This  setting  is  present  for
	      backward syntax compatibility of the miredo.conf file. PLEASE DO

       The following directives	are only available in (auto)client mode.

       ServerAddress hostname
	      The ServerAddress	directive specifies the	hostname or  numerical
	      IPv4  address of the Teredo server to use.  Teredo clients needs
	      a	 Teredo	server to  establish  and  maintain  their  IPv6  over
	      UDP/IPv4 tunnel across a NAT device.

	      This  directive MUST be specified	when Miredo is in client mode.
	      hostname must resolve to a valid IPv4  address.  If  it  is  not
	      present, and no server hostname is specified on the command line
	      when starting miredo either, the program will fail.

       ServerAddress2 hostname2
	      Miredo assumes that the secondary	Teredo server  address	equals
	      the  primary  server  address plus one. If that is not the case,
	      this directive must be used.

       The following directives	are only available in relay  mode.   They  are
       not available in	(auto)client mode.

       Prefix teredo_prefix
	      This  directive specifies	the Teredo prefix which	the Teredo re-
	      lay and/or server	will advertise.	 teredo_prefix must be a valid
	      IPv6 prefix.

	      The default value	is 2001:0000::.

	      Do  not use that directive if you	don't know what	you are	doing,
	      as it is more than likely	to  break  your	 Teredo	 connectivity.
	      That  option  must  not  be  used	when Miredo serves as a	Teredo

       InterfaceMTU mtu
	      This directive overrides the default MTU size of 1280 bytes  for
	      the Teredo tunneling interface. It should	not be used if the de-
	      fault Teredo prefix is used.

       InterfaceName ifname
	      Specify the name of the Teredo tunneling interface which	Miredo
	      will  create  ("miredo"  by default). On some systems, it	is not
	      possible to redefine the tunnel name.

       BindAddress bind_address
	      Bind the Teredo relay or Teredo client to	a  specific  IPv4  ad-
	      dress.   By  default, it is not bound to any particular IPv4 ad-

	      Use this option if you have trouble with the default value, such
	      as  if you have a	multi-homed host with equal-cost IPv4 routing,
	      or if you	have specific firewalling constraints.

       BindPort	udp_port
	      Define the UDP (IPv4) port number	to be used  by	the  relay  or
	      client.	By  default,  the operating system allocates an	unused
	      port automatically.

	      Use this option if you have firewalling  constraints  which  can
	      cause Miredo to fail when	not using a fixed predefined port.

       SyslogFacility facility
	      Specify which syslog's facility is to be used by Miredo for log-
	      ging.  Possible values are: daemon (the  default),  local0,  ...
	      local7, kern and user (see syslog(2)).


       Remi Denis-Courmont <remi at remlab dot net>

miredo				  August 2007			MIREDO.CONF(5)


Want to link to this manual page? Use this URL:

home | help