Last updated


This proposal is to implement SSU Peer Testing for IPv6. Implemented in 0.9.27.


We cannot reliably determine and track if our IPv6 address is firewalled.

When we added IPv6 support years ago, we assumed that IPv6 was never firewalled.

More recently, in 0.9.20 (May 2015), we split up v4/v6 reachability status internally (ticket #1458). See that ticket for extensive info and links.

If you have both v4 and v6 firewalled, you can just force firewalled in the TCP configuration section on /confignet.

We don't have peer testing for v6. It's prohibited in the SSU spec. If we can't regularly test v6 reachability, we can't sensibly transition from/to the v6 reachable state. What we're left with is guessing that we are reachable if we get an inbound conn, and guessing that we aren't if we haven't gotten an inbound conn in a while. The problem is that once you declare unreachable, you don't publish your v6 IP, and then you won't get any more (after the RI expires in everybody's netdb).


Implement Peer Testing for IPv6, by removing previous restrictions that peer testing was only allowed for IPv4. The peer test message already has a field for IP length.


In the Capabilities section of the SSU overview, make the following addition:

Through 0.9.26, peer testing was not supported for IPv6 addresses, and the 'B' capability, if present for an IPv6 address, must be ignored. As of 0.9.27, peer testing is supported for IPv6 addresses, and the presence or absense of the 'B' capability in an IPv6 address indicates actual support (or lack of support).

In the Peer Testing sections of the SSU overview and SSU specification, make the following changes:

IPv6 Notes: Through release 0.9.26, only testing of IPv4 addresses is supported. Therefore, all Alice-Bob and Alice-Charlie communication must be via IPv4. Bob-Charlie communication, however, may be via IPv4 or IPv6. Alice's address, when specified in the PeerTest message, must be 4 bytes. As of release 0.9.27, testing of IPv6 addresses is supported, and Alice-Bob and Alice-Charlie communication may be via IPv6, if Bob and Charlie indicate support with a 'B' capability in their published IPv6 address.

Alice sends the request to Bob using an existing session over the transport (IPv4 or IPv6) that she wishes to test. When Bob receives a request from Alice via IPv4, Bob must select a Charlie that advertises an IPv4 address. When Bob receives a request from Alice via IPv6, Bob must select a Charlie that advertises an IPv6 address. The actual Bob-Charlie communication may be via IPv4 or IPv6 (i.e., independent of Alice's address type).


Routers may either:

  1. Not increment their version to 0.9.27 or higher
  2. Remove the 'B' capability from any published IPv6 SSU addresses
  3. Implement IPv6 peer testing