dladm(1M) dladm(1M)
NAME
dladm - configure data-link interfaces
SYNOPSIS
dladm show-link [-s [-i interval]] [-p] [name]
dladm show-dev [-s [-i interval]] [-p] [dev]
dladm create-aggr [-t] [-R root-dir] [-P policy] [-l mode] [-T time] [-u address] -d dev [-d dev] ... key
dladm delete-aggr [-t] [-R root-dir] key
dladm add-aggr [-t] [-R root-dir] -d dev [-d dev] ... key
dladm remove-aggr [-t] [-R root-dir] -d dev [-d dev] ... key
dladm modify-aggr [-t] [-R root-dir] [-P policy] [-l mode] [-T time] [-u address] key
dladm show-aggr [-L] [-s [-i interval]] [-p] [key]
dladm -?
The dladm command is used to configure data-links. A configured data-link is represented in the system as a STREAMS DLPI (v2) interface
which may be plumbed under protocol stacks such as TCP/IP. Each data-link relies on either a single network device or an aggregation of
devices to send packets to or receive packets from a network.
The dladm command operates on the following kinds of object:
link Data-links, identified by a name
aggr Aggregations of network devices, identified by a key
dev Network devices, identified by concatenation of a driver name and an instance number
Some devices do not support configurable data-links or aggregations. The fixed data-links provided by such devices can be viewed using
dladm, but can not be configured.
SUBCOMMANDS
The following subcommands are supported:
show-link Show configuration information for all data-links or the specified data-link. By default, the system is configured to have
one data-link for each known network device.
show-dev Shows information for all devices or the specified device.
create-aggr Creates an aggregation using the given key value from as many dev objects as are specified. A data-link is created by
default, and is given a name which is the concatenation of "aggr" and the key value of the aggregation.
delete-aggr Deletes the specified aggregation.
add-aggr Adds as many dev objects as are specified to the given aggregation.
remove-aggr Removes as many dev objects as are specified from the given aggregation.
modify-aggr Modifies the parameters of the given aggregation.
show-aggr Shows configuration information for all aggregations or the specified aggregation.
The following options are supported:
-k key
--key=key
The key of an aggregation. This must be an integer value between 1 and 999.
-d dev
--dev=dev
A device specifier. This must be a concatenation of the name and instance of the driver bound to the device.
-P policy
--policy=policy
Specifies the port selection policy to use for load spreading of outbound traffic. The policy specifies which dev object is used to
send packets. A policy consists of a list of one or more layers specifiers separated by commas. A layer specifier is one of the follow-
ing:
L2 Select outbound device according to source and destination MAC addresses of the packet.
L3 Select outbound device according to source and destination IP addresses of the packet.
L4 Select outbound device according to the upper layer protocol information contained in the packet. For TCP and UDP, this
includes source and destination ports. For IPsec, this includes the SPI (Security Parameters Index.)
For example, to use upper layer protocol information, the following policy can be used:
-P L4
To use the source and destination MAC addresses as well as the source and destination IP addresses, the following policy can be used:
-P L2,L3
-l mode
--lacp-mode=mode
Specifies whether LACP should be used and, if used, the mode in which it should operate. Legal values are off, active or passive.
-T time
--lacp-timer=time
Specifies the LACP timer value. The legal values are short or long.
-u address
--unicast=address
Specifies a fixed unicast address to be used for the aggregation. If this option is not specified then an address is automatically cho-
sen from the set of addresses of the component devices.
-L
--lacp
Specifies whether detailed LACP information should be displayed.
-s
--statistics
Used with the show-link, show-aggr, or show-dev subcommands to show the statistics of data-links, aggregations or devices, respec-
tively.
-i interval
--interval=interval
Used with the -s option to specify an interval, in seconds, at which statistics should be displayed. If this option is not specified,
statistics will only be displayed once.
-t
--temporary
Specifies that the change is temporary. Temporary changes last until the next reboot.
-R root-dir
--root-dir=root-dir
Specifies an alternate root directory where dladm applies changes. This can be useful in JumpStart scripts, where the root directory of
the system being modified is mounted elsewhere.
-p
--parseable
Specifies that configuration information should be displayed in parseable format.
-?
--help
Displays help information. (Stops interpretation of subsequent arguments).
EXAMPLES
Example 1: Configuring an aggregation
To configure a data-link over an aggregation of devices bge0 and bge1 with key 1, enter the following command:
# dladm create-aggr -d bge0 bge1 1
See attributes(5) for descriptions of the following attributes:
/usr/sbin
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWcsu |
+-----------------------------+-----------------------------+
|Interface Stability |Evolving |
+-----------------------------+-----------------------------+
/sbin
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWcsr |
+-----------------------------+-----------------------------+
|Interface Stability |Evolving |
+-----------------------------+-----------------------------+
ifconfig(1M), attributes(5), dlpi(7P)
NOTES
The configuration of all objects will persist across reboot.
28 Sep 2005 dladm(1M)