Provided by: miredo_1.2.6-2_amd64 bug

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

SEE ALSO

       miredo(8)

AUTHOR

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

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