Utilities Added or Modified for IPv6

The following utilities have been modified or added to the IPv6 implementation:

• ifconfig – This command now includes several modifications for IPv6 support.

• 6to4relay – This command sets up a tunnel between a 6to4 router and a relay router.

IPv6 Extensions to the ifconfig Utility

The ifconfig utility now enables IPv6 interfaces and the tunneling module to be plumbed. The ifconfig(1M) utility uses an extended set of ioctls to configure both IPv4 and IPv6 network interfaces. The following table shows the set of options that are added to ifconfig. See How to Display Interface Address Assignments for a description of useful diagnostic procedures that use this utility.

Enabling IPv6 Nodes provides IPv6 configuration procedures.

Examples—New ifconfig Command Options

The following usage of the ifconfig command creates the hme0:3 logical interface to the 1234::5678/64 IPv6 address. This command enables the interface with the up option. The command also reports status. The command disables the interface. Finally, the command deletes the interface.

Example 3–1 Examples—Using addif and removeif

# ifconfig hme0 inet6 addif 1234::5678/64 up
Created new logical interface hme0:3

# ifconfig hme0:3 inet6
hme0:3: flags=2000841<UP,RUNNING,MULTICAST,IPv6> mtu 1500 index 2
		inet6 1234::5678/64 

# ifconfig hme0:3 inet6 down

# ifconfig hme0 inet6 removeif 1234::5678

The following usage of the ifconfig command opens the device that is associated with the physical interface name. The command configures the streams that are needed for TCP/IP to use the device. The command reports the status of the device. The command configures the source and the destination address for the tunnel. Finally, the command reports the new status of the device after the configuration.

Example 3–2 Examples—Using tsrc, tdst, and index

# ifconfig ip.tun0 inet6 plumb index 13

# ifconfig ip.tun0 inet6
ip.tun0: flags=2200850<POINTOPOINT,RUNNING,MULTICAST,NONUD,
#IPv6> mtu 1480 index 13
		inet tunnel src 0.0.0.0 
		inet6 fe80::/10 --> :: 

# ifconfig ip.tun0 inet6 tsrc 120.46.86.158 tdst 120.46.86.122

# ifconfig ip.tun0 inet6
ip.tun0: flags=2200850<POINTOPOINT,RUNNING,MULTICAST,NONUD,
IPv6> mtu 1480 index 13
		inet tunnel src 120.46.86.158  tunnel dst 120.46.86.122
		inet6 fe80::8192:569e/10 --> fe80::8192:567a

Example 3–3 Configuring 6to4 Through ifconfig—Long Form

# ifconfig ip.6to4tun0 inet6 plumb
# ifconfig ip.6to4tun0 inet tsrc 129.146.86.187 \
2002:8192:56bb:1::8192:56bb/64 up

# ifconfig ip.6to4tun0 inet6
ip.6to4tun0: flags=2200041<UP,RUNNING,NONUD,IPv6>mtu 1480 index 11
        inet tunnel src 129.146.86.187 
        tunnel hop limit 60 
        inet6 2002:8192:56bb:1::8192:56bb/64 

This example of the 6to4 pseudo-interface configuration uses the subnet ID of 1 and also specifies the host ID, in hexadecimal form.

Example 3–4 Configuring 6to4 Through ifconfig—Short Form

# ifconfig ip.6to4tun0 inet6 plumb
# ifconfig ip.6to4tun0 inet tsrc 129.146.86.187 up

# ifconfig ip.6to4tun0 inet6
ip.6to4tun0: flags=2200041<UP,RUNNING,NONUD,IPv6>mtu 1480 index 11
        inet tunnel src 129.146.86.187 
        tunnel hop limit 60 
        inet6 2002:8192:56bb::1/64 

6to4relay Command

6to4 tunneling enables communication between isolated 6to4 sites. However, to transfer packets with a native, non-6to4, IPv6 site, the 6to4 router must establish a tunnel with a 6to4 relay router. The 6to4 relay router then forwards the 6to4 packets to IPv6 network and ultimately, the native IPv6 site. If your 6to4 site must exchange data with a native IPv6 site, you use the 6to4relay command to enable the appropriate tunnel.

Because the use of relay routers is insecure, tunneling to a relay router is disabled by default in the Solaris operating system. Carefully consider the issues that are involved in creating a tunnel to a 6to4 relay router before deploying this scenario. For detailed information on 6to4 relay routers, refer to Considerations for Tunnels to a 6to4 Relay Router. Should you decide to enable 6to4 relay router support, you can find the related procedures in How to Configure a 6to4 Tunnel to a 6to4 Relay Router.

Syntax of 6to4relay

The 6to4relay command has the following format:

6to4relay -e [-a IPv4-address] -d -h

-e

Enables support for tunnels between the 6to4 router and an anycast 6to4 relay router. The tunnel endpoint address is then set to 192.88.99.1, the default address for the anycast group of 6to4 relay routers.

-a IPv4–address

Enables support for tunnels between the 6to4 router and a 6to4 relay router with the specified IPv4–address.

-d

Disables support for tunneling to the 6to4 relay router, the default for the Solaris operating system.

–h

Displays usage help for 6to4relay.

For more information, refer to the 6to4relay(1M) man page.

Examples—Displaying the Status of 6to4 Relay Router Support

6to4relay, without arguments, shows the current status of 6to4 relay router support. The first example shows the default.

# /usr/sbin/6to4relay
6to4relay:6to4 Relay Router communication support is disabled

If relay router support is enabled, 6to4relay displays the following output.

# /usr/sbin/6to4relay
6to4relay:6to4 Relay Router communication support is enabled
IPv4 destination address of Relay Router=192.88.99.1

If you specified the -a option and IPv4 address to 6to4relay, the IPv4 address that you gave with -a is displayed instead of 192.88.99.1.

6to4relay does not report successful execution of the –d, –e, and -a IPv4 address options. However, 6to4relay does display any errors that might have occurred when you ran these options.