Ubuntu Manpage: miredo.conf - configuration for Miredo

NAME

       miredo.conf - configuration for Miredo

SYNOPSIS

       miredo.conf

DESCRIPTON

       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:

MODES

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 virtual 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 (native, 6to4, TSP, etc). In that case, Miredo will only be used
to reach other Teredo clients, as its tunneling interface has a default route with a higher metric
(which is to say a lower priority) 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
unsoliticited 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 implementations are broken.

restricted mode
This mode is identical to the cone mode documented above, with the exception that direct Teredo
bubbles will be sent. Theoretically (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 NOT USE
THIS MODE.

CLIENT OPTIONS

       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.

RELAY OPTIONS

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

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

GENERAL OPTIONS

       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 address.  By default, it is not bound to
              any particular IPv4 address.

              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 logging.  Possible values are:  daemon
              (the default), local0, ... local7, kern and user (see syslog(2)).

AUTHOR

       Rémi Denis-Courmont <remi at remlab dot net>

       http://www.remlab.net/miredo/

miredo                                             August 2007                                    MIREDO.CONF(5)