Configuring STREAMS Modules on Data Links

If necessary, you can set up to eight STREAMS modules to be pushed on top of a data link. These modules are typically used by third-party networking software such as virtual private networks (VPNs) and firewalls. Documentation about such networking software is provided by the software vendor.

The list of STREAMS modules to push on a specific data link is controlled by the autopush link property. In turn, the value of the autopush link property is set by using the dladm set-linkprop subcommand.

A separate autopush command can also be used to set the STREAMS autopush modules on a per-driver basis. However, the driver is always bound to the NIC. If the data link's underlying NIC is removed, then the link's autopush property information becomes lost as well.

To configure the STREAMS modules to be pushed on top of a data link, use the dladm set-linkprop command in preference over the autopush command. If both per-driver and per-link types of autoputsh configuration exist for a specific data link, the per-link information that is set with dladm set-linkprop is used and the per-driver information is ignored.

How to Set STREAMS Modules on Data Links

The following procedure describes how to configure STREAMS modules with the dladm set-linkprop command.

1. Assume the System Administrator role.

   The System Administrator role includes the Network Management profile. To create the role and assign the role to a user, see Chapter 9, Using Role-Based Access Control (Tasks), in System Administration Guide: Security Services.

2. Push the modules to the stream when the link is opened.

   # dladm set-linkprop -p autopush=modulelist link

   modulelist

   Specifies the list of modules that you want to be automatically pushed on to the stream. A maximum of eight modules can be pushed over a link. These modules are pushed in the order that they are listed in modulelist. Separate the modules in the list by using dots as delimiters.

   link

   Specifies the link on which the modules are pushed.

Example 2–3 Setting the autopush Link Property

In this example, you push the vpnmod and bufmod modules on top of the link net0. The link's underlying device is bge0.

# dladm set-linkprop -p autopush=vpnmod.bufmod net0

If you later replace the bge card with ce, you can switch to the new data link without needing to reconfigure the autopush settings. You just assign the link name to the new data link, as follows:

# dladm rename-link ce0 net0

How to Obtain autopush Link Property Settings

1. Assume the System Administrator role.

   The System Administrator role includes the Network Management profile. To create the role and assign the role to a user, see Chapter 9, Using Role-Based Access Control (Tasks), in System Administration Guide: Security Services.

2. Display autopush link property settings.

   # dladm show-linkprop -p autopush [link]

   If you do not specify link, then the information for all configured links is displayed.

How to Remove autopush Link Property Settings

1. Assume the System Administrator role.

   The System Administrator role includes the Network Management profile. To create the role and assign the role to a user, see Chapter 9, Using Role-Based Access Control (Tasks), in System Administration Guide: Security Services.

2. Remove the autopush link property settings of a specific data link.

   # dladm reset-linkprop [-t] -p autopush link

   Use the -t option to remove the property settings temporarily. The settings are restored when you reboot the system.