System Administration Commands 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 -? DESCRIPTION The dladm command is used to configure data-links. A con- figured 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 SunOS 5.10 Last change: 23 Mar 2005 1 System Administration Commands dladm(1M) 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 speci- fied. 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. SunOS 5.10 Last change: 23 Mar 2005 2 System Administration Commands dladm(1M) 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 aggre- gation. show-aggr Shows configuration information for all aggregations or the specified aggregation. OPTIONS 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. SunOS 5.10 Last change: 23 Mar 2005 3 System Administration Commands dladm(1M) -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 con- sists of a list of one or more layers specifiers separated by commas. A layer specifier is one of the following: 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 follow- ing 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. SunOS 5.10 Last change: 23 Mar 2005 4 System Administration Commands dladm(1M) -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 chosen 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 subcom- mands to show the statistics of data-links, aggregations or devices, respectively. -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 SunOS 5.10 Last change: 23 Mar 2005 5 System Administration Commands dladm(1M) 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 sub- sequent 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 SunOS 5.10 Last change: 23 Mar 2005 6 System Administration Commands dladm(1M) commands: # dladm create-aggr -d bge0 -d bge1 1 - ATTRIBUTES See attributes(5) for descriptions of the following attri- butes: /usr/sbin ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWcsu | |_____________________________|_____________________________| | Interface Stability | Evolving | |_____________________________|_____________________________| /sbin ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWcsr | |_____________________________|_____________________________| | Interface Stability | Evolving | |_____________________________|_____________________________| SEE ALSO ifconfig(1M), attributes(5), dlpi(7P) NOTES - The configuration of all objects will persist across reboot.