...Teredo for FreeBSD...

[Last release 1.13]

Description
- About the authors
- Related works: Ethereal
- Use teredo.ipv6.6wind.com
Download
Mailing list
TODO
ng_teredo(4)
Installation
- Compiling
- Usage
How to use Teredo with a symetric NAT

Description

Teredo allows nodes located behind an IPv4 NAT to obtain IPv6 unicast connectivity by tunnelling packets over UDP/IPv4. This service has 3 entities: the "Teredo Server", the "Teredo Relay" and the "Teredo client". A Teredo Server is stateless whereas the Teredo Relay keeps a state of each peer. We support the following IETF draft "draft-huitema-v6ops-teredo-00.txt".

About the authors

This work is funded by 6WIND, LIP6 and Euronetlab. It is provided under a BSD license.

Related works: Ethereal

6WIND has provided a patch for Ethereal. It allows analysing the Teredo packets on Windows, Linux, FreeBSD, AIX, ... It is available since the release 0.9.15.

Ethereal patch [cvsweb]
Download Ethereal [binary]

Use teredo.ipv6.6wind.com

We provide a temporary Teredo server and relay that is compatible with the Advanced Networking Pack of Windows XP. Configure Windows XP with the netsh command:

    C:\>netsh
      interface ipv6
        set teredo client teredo.ipv6.6wind.com 30

That's all.

Download

ChangeLog
Version 1.00 ng_teredo-1.00.tgz
Version 1.03 ng_teredo-1.03.tgz
Version 1.04 ng_teredo-1.04.tgz
Version 1.08 ng_teredo-1.08.tgz
Version 1.13 ng_teredo-1.13.tgz

Thanks to report bugs to the authors or the Teredo-netgraph mailing list.

Mailing list

Subscribe to the Teredo-netgraph mailing list [subscribe].

TODO

This node could be extended to support the Teredo Client protocol too.

ng_teredo(4)

ng_teredo is part of the section 4 of man. See the web version.

Installation

Compiling

You can compile the Teredo feature with the following procedure:

   tar xvzf ng_teredo-1.13.tgz
   cd netgraph
   make
   su
   make install

Set TEREDO_SERVER_DISABLE into the Makefile in order to disable the Teredo Server. It means that the node could only be a Teredo Relay.

Usage

Edit the teredo.server file and set your primary, A.B.C.D, and secondary Teredo addresses, A.B.C.D+1. The secondary Teredo address should be the primary address + 1.
```
        vi /usr/share/examples/netgraph/teredo.server
  
```

Start teredo.server

        sh /usr/share/examples/netgraph/teredo.server

Or see teredo.relay
Update Windows XP
It supports natively IPv6. However the Teredo Client is provided with the updates KB817778 that is the Advanced Networking Pack. http://support.microsoft.com/default.aspx?scid=817778
Configure Windows XP
```
    C:\>netsh
      interface ipv6
        set teredo client A.B.C.D 30 [SOURCE_PORT]
   
```
Where:
- A.B.C.D is the address of your Teredo server (for example teredo.ipv6.6wind.com)
- SOURCE_PORT is the source port of the Teredo client. It is only required when you have a symetric NAT. In this case, a forwarding UDP rule should be added in your NAT to enforce a cone mode.

Check your configuration

Windows XP

    C:\>netsh
      interface ipv6
        show teredo

where the status should be qualified.

FreeBSD - ngctl list It should display the Teredo nodes and the Teredo interface (ng0).

There are 5 total nodes:
  Name: ngctl1911       Type: socket          ID: 0000006a   Num hooks: 0
  Name: <unnamed>       Type: ksocket         ID: 00000061   Num hooks: 1
  Name: <unnamed>       Type: ksocket         ID: 0000005e   Num hooks: 1
  Name: ter0            Type: teredo          ID: 00000058   Num hooks: 3
  Name: ng0             Type: iface           ID: 00000056   Num hooks: 1

FreeBSD - ngctl msg ter0: getstats

   ngctl msg ter0: getstats
   Rec'd response "getstats" (6) from "ter0:":
   Args: { xmitPackets=92 xmitOctets=7380 xmitRA=40 fwdBubbles=1
           recvPackets=153 recvOctets=9520 recvInvalid=4 recvBubbles=1
           recvIcmpv6=97 recvRS=40 recvAuth=40 recvAuthOK=40 }

How to use Teredo with a symetric NAT

When you are behind a symetric NAT, it can be enforced to a cone NAT by setting a proxy rule with your NAT that forwards all the UDP packets. For example, if your Teredo client is using the UDP port 48831, your NAT must forward all the UDP packets that arrive on this port to your Teredo client.

Konstantin Kabassanov <Konstantin.Kabassanov@lip6.fr> Vincent Jardin <jardin@6WIND.com>

Last update $Id: index.html,v 1.3 2003/10/22 23:57:09 vjardin Exp $