IPv6 Extensions to the ifconfig Utility (IPv6 Administration Guide)

IPv6 Administration Guide

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.

Table 3–1 New ifconfig Utility Options


Option	Description
`index`	Sets the interface index
`tsrc`/`tdst`	Sets tunnel source or destination
`addif`	Creates the next available logical interface
`removeif`	Deletes a logical interface with a specific IP address
`destination`	Sets the point-to-point destination address for an interface
`set`	Sets an address, netmask, or both for an interface
`subnet`	Sets the subnet address of an interface
`xmit`/`-xmit`	Enables or disables packet transmission on an interface

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