/usr/sbin/sppptun Command

You can use the /usr/sbin/sppptun command to manually plumb and unplumb the Ethernet interfaces to be used for PPPoE tunnels. By contrast, /etc/ppp/pppoe.if is only read when the system boots. These interfaces should correspond to the interfaces that are listed in /etc/ppp/pppoe.if.

sppptun plumbs the Ethernet interfaces that are used in PPPoE tunnels in a manner that is similar to the ifconfig command. Unlike ifconfig, you must plumb interfaces twice to support PPPoE because two Ethernet protocol numbers are involved.

The basic syntax for sppptun is as follows:

# /usr/sbin/sppptun plumb pppoed device-name
     device-name:pppoed
# /usr/sbin/sppptun plumb pppoe device-name
     device-name:pppoe

The first time that you issue the sppptun command, the discovery protocol pppoed is plumbed on the interface. The second time that you run sppptun, the session protocol pppoe is plumbed. sppptun prints the name of the interface that was just plumbed. You use this name to unplumb the interface, when necessary.

For more information, refer to thesppptun(1M) man page.

Sample sppptun Commands for Administering Interfaces

• The following sample shows how to manually plumb an interface for PPPoE by using /usr/sbin/sppptun.

  ---

  Example 36–1 To plumb an Interface to Support PPPoE

  
  

  # /usr/sbin/sppptun plumb pppoed hme0 hme0:pppoed # /dev/sppptun plumb pppoe hme0 hme0:pppoe

  ---

• This sample shows how to list the interfaces on an access server that was plumbed for PPPoE.

  ---

  Example 36–2 To List All Interfaces on a PPPoE Access Server

  
  

  /usr/sbin/sppptun query hme0:pppoe hme0:pppoed hme1:pppoe hme1:pppoed hme2:pppoe hme2:pppoed

  ---

• This sample shows how to unplumb an interface.

  ---

  Example 36–3 To Unplumb an Interface With a PPPoE Tunnel

  
  

  # sppptun unplumb hme0:pppoed # sppptun unplumb hme0:pppoe

  ---