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)