manuals

          --- old/usr/src/man/man1m/dladm.1m
          +++ new/usr/src/man/man1m/dladm.1m

   1    1  '\" te
   2    2  .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
   3    3  .\" Copyright (c) 2014, Joyent, Inc. All Rights Reserved
   4    4  .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/.
   5    5  .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text
   6    6  .\" are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical
   7    7  .\" and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
   8    8  .\"  This notice shall appear on any product containing this material.

   9    9  .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
  10   10  .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the
  11   11  .\" fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
  12   12  .TH DLADM 1M "Dec 03, 2014"
  13   13  .SH NAME
  14   14  dladm \- administer data links
  15   15  .SH SYNOPSIS
  16   16  .LP
  17   17  .nf
  18   18  \fBdladm show-link\fR [\fB-P\fR] [\fB-s\fR [\fB-i\fR \fIinterval\fR]] [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]] [\fIlink\fR]
  19      -\fBdladm rename-link\fR [\fB-R\fR \fIroot-dir\fR] \fIlink\fR \fInew-link\fR
       19 +\fBdladm rename-link\fR [\fB-R\fR \fIroot-dir\fR] [\fB-z\fR \fIzonename\fR] \fIlink\fR \fInew-link\fR
  20   20  .fi
  21   21  
  22   22  .LP
  23   23  .nf
  24   24  \fBdladm delete-phys\fR \fIphys-link\fR
  25   25  \fBdladm show-phys\fR [\fB-m\fR | \fB-H\fR | \fB-P\fR] [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]] [\fIphys-link\fR]
  26   26  .fi
  27   27  
  28   28  .LP
  29   29  .nf

  30   30  \fBdladm create-aggr\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-P\fR \fIpolicy\fR] [\fB-L\fR \fImode\fR]
  31   31       [\fB-T\fR \fItime\fR] [\fB-u\fR \fIaddress\fR] \fB-l\fR \fIether-link1\fR [\fB-l\fR \fIether-link2\fR...] \fIaggr-link\fR
  32   32  \fBdladm modify-aggr\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-P\fR \fIpolicy\fR] [\fB-L\fR \fImode\fR]
  33   33       [\fB-T\fR \fItime\fR] [\fB-u\fR \fIaddress\fR] \fIaggr-link\fR
  34   34  \fBdladm delete-aggr\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fIaggr-link\fR
  35   35  \fBdladm add-aggr\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fB-l\fR \fIether-link1\fR [\fB-l\fR \fIether-link2\fR...]
  36   36       \fIaggr-link\fR
  37   37  \fBdladm remove-aggr\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fB-l\fR \fIether-link1\fR [\fB-l\fR \fIether-link2\fR...]
  38   38       \fIaggr-link\fR
  39   39  \fBdladm show-aggr\fR [\fB-PLx\fR] [\fB-s\fR [\fB-i\fR \fIinterval\fR]] [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]]
  40   40       [\fIaggr-link\fR]
  41   41  .fi
  42   42  
  43   43  .LP
  44   44  .nf
  45   45  \fBdladm create-bridge\fR [\fB-P\fR \fIprotect\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-p\fR \fIpriority\fR]
  46   46       [\fB-m\fR \fImax-age\fR] [\fB-h\fR \fIhello-time\fR] [\fB-d\fR \fIforward-delay\fR] [\fB-f\fR \fIforce-protocol\fR]
  47   47       [\fB-l\fR \fIlink\fR...] \fIbridge-name\fR
  48   48  .fi
  49   49  
  50   50  .LP
  51   51  .nf
  52   52  \fBdladm modify-bridge\fR [\fB-P\fR \fIprotect\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-p\fR \fIpriority\fR]
  53   53       [\fB-m\fR \fImax-age\fR] [\fB-h\fR \fIhello-time\fR] [\fB-d\fR \fIforward-delay\fR] [\fB-f\fR \fIforce-protocol\fR]
  54   54       \fIbridge-name\fR
  55   55  .fi
  56   56  
  57   57  .LP
  58   58  .nf
  59   59  \fBdladm delete-bridge\fR [\fB-R\fR \fIroot-dir\fR] \fIbridge-name\fR
  60   60  .fi
  61   61  
  62   62  .LP
  63   63  .nf
  64   64  \fBdladm add-bridge\fR [\fB-R\fR \fIroot-dir\fR] \fB-l\fR \fIlink\fR [\fB-l\fR \fIlink\fR...]\fIbridge-name\fR
  65   65  .fi
  66   66  
  67   67  .LP
  68   68  .nf
  69   69  \fBdladm remove-bridge\fR [\fB-R\fR \fIroot-dir\fR] \fB-l\fR \fIlink\fR [\fB-l\fR \fIlink\fR...] \fIbridge-name\fR
  70   70  .fi
  71   71  
  72   72  .LP
  73   73  .nf
  74   74  \fBdladm show-bridge\fR [\fB-flt\fR] [\fB-s\fR [\fB-i\fR \fIinterval\fR]] [[\fB-p\fR] \fB-o\fR \fIfield\fR,...]
  75   75       [\fIbridge-name\fR]
  76   76  .fi
  77   77  
  78   78  .LP
  79   79  .nf
  80   80  \fBdladm create-vlan\fR [\fB-ft\fR] [\fB-R\fR \fIroot-dir\fR] \fB-l\fR \fIether-link\fR \fB-v\fR \fIvid\fR [\fIvlan-link\fR]
  81   81  \fBdladm delete-vlan\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fIvlan-link\fR
  82   82  \fBdladm show-vlan\fR [\fB-P\fR] [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]] [\fIvlan-link\fR]
  83   83  .fi
  84   84  
  85   85  .LP
  86   86  .nf
  87   87  \fBdladm scan-wifi\fR [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]] [\fIwifi-link\fR]
  88   88  \fBdladm connect-wifi\fR [\fB-e\fR \fIessid\fR] [\fB-i\fR \fIbssid\fR] [\fB-k\fR \fIkey\fR,...]
  89   89       [\fB-s\fR none | wep | wpa ] [\fB-a\fR open | shared] [\fB-b\fR bss | ibss] [\fB-c\fR]
  90   90       [\fB-m\fR a | b | g] [\fB-T\fR \fItime\fR] [\fIwifi-link\fR]
  91   91  \fBdladm disconnect-wifi\fR [\fB-a\fR] [\fIwifi-link\fR]

  92   92  \fBdladm show-wifi\fR [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]] [\fIwifi-link\fR]
  93   93  .fi
  94   94  
  95   95  .LP
  96   96  .nf
  97   97  \fBdladm show-ether\fR [\fB-x\fR] [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]] [\fIether-link\fR]
  98   98  .fi
  99   99  
 100  100  .LP
 101  101  .nf
 102      -\fBdladm set-linkprop\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fB-p\fR \fIprop\fR=\fIvalue\fR[,...] \fIlink\fR
 103      -\fBdladm reset-linkprop\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-p\fR \fIprop\fR[,...]] \fIlink\fR
 104      -\fBdladm show-linkprop\fR [\fB-P\fR] [[\fB-c\fR] \fB-o\fR \fIfield\fR[,...]] [\fB-p\fR \fIprop\fR[,...]] [\fIlink\fR]
      102 +\fBdladm set-linkprop\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-z\fR \fIzonename\fR] \fB-p\fR \fIprop\fR=\fIvalue\fR[,...]
      103 +     \fIlink\fR
      104 +\fBdladm reset-linkprop\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-z\fR \fIzonename\fR] [\fB-p\fR \fIprop\fR[,...]] \fIlink\fR
      105 +\fBdladm show-linkprop\fR [\fB-P\fR] [\fB-z\fR \fIzonename\fR] [[\fB-c\fR] \fB-o\fR \fIfield\fR[,...]]
      106 +     [\fB-p\fR \fIprop\fR[,...]] [\fIlink\fR]
 105  107  .fi
 106  108  
 107  109  .LP
 108  110  .nf
 109  111  \fBdladm create-secobj\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-f\fR \fIfile\fR] \fB-c\fR \fIclass\fR \fIsecobj\fR
 110  112  \fBdladm delete-secobj\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fIsecobj\fR[,...]
 111  113  \fBdladm show-secobj\fR [\fB-P\fR] [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]] [\fIsecobj\fR,...]
 112  114  .fi
 113  115  
 114  116  .LP
 115  117  .nf
 116  118  \fBdladm create-vnic\fR [\fB-t\fR] \fB-l\fR \fIlink\fR [\fB-R\fR \fIroot-dir\fR] [\fB-m\fR \fIvalue\fR | auto |
 117  119       {factory \fB-n\fR \fIslot-identifier\fR]} | {random [\fB-r\fR \fIprefix\fR]}]
 118  120       [\fB-v\fR \fIvlan-id\fR] [\fB-p\fR \fIprop\fR=\fIvalue\fR[,...]] \fIvnic-link\fR
 119      -\fBdladm delete-vnic\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fIvnic-link\fR
      121 +\fBdladm delete-vnic\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-z\fR \fIzonename\fR] \fIvnic-link\fR
 120  122  \fBdladm show-vnic\fR [\fB-pP\fR] [\fB-s\fR [\fB-i\fR \fIinterval\fR]] [\fB-o\fR \fIfield\fR[,...]]
 121      -     [\fB-l\fR \fIlink\fR] [\fIvnic-link\fR]
      123 +     [\fB-l\fR \fIlink\fR] [\fB-z\fR \fIzonename\fR] [\fIvnic-link\fR]
 122  124  .fi
 123  125  
 124  126  .LP
 125  127  .nf
 126  128  \fBdladm create-etherstub\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fIetherstub\fR
 127  129  \fBdladm delete-etherstub\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fIetherstub\fR
 128  130  \fBdladm show-etherstub\fR [\fIetherstub\fR]
 129  131  .fi
 130  132  
 131  133  .LP

 132  134  .nf
 133  135  \fBdladm create-iptun\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fB-T\fR \fItype\fR [\fB-s\fR \fItsrc\fR] [\fB-d\fR \fItdst\fR]
 134  136       \fIiptun-link\fR
 135  137  \fBdladm modify-iptun\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-s\fR \fItsrc\fR] [\fB-d\fR \fItdst\fR] \fIiptun-link\fR
 136  138  \fBdladm delete-iptun\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fIiptun-link\fR
 137  139  \fBdladm show-iptun\fR [\fB-P\fR] [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]] [\fIiptun-link\fR]
 138  140  .fi
 139  141  
 140  142  .LP
 141  143  .nf
 142  144  \fBdladm show-usage\fR [\fB-a\fR] \fB-f\fR \fIfilename\fR [\fB-p\fR \fIplotfile\fR \fB-F\fR \fIformat\fR] [\fB-s\fR \fItime\fR]
 143  145       [\fB-e\fR \fItime\fR] [\fIlink\fR]
 144  146  .fi
 145  147  
 146  148  .SH DESCRIPTION
 147  149  .LP
 148  150  The \fBdladm\fR command is used to administer data-links. A data-link is
 149  151  represented in the system as a \fBSTREAMS DLPI\fR (v2) interface which can be
 150  152  plumbed under protocol stacks such as \fBTCP/IP\fR. Each data-link relies on
 151  153  either a single network device or an aggregation of devices to send packets to
 152  154  or receive packets from a network.
 153  155  .sp
 154  156  .LP
 155  157  Each \fBdladm\fR subcommand operates on one of the following objects:
 156  158  .sp
 157  159  .ne 2
 158  160  .na
 159  161  \fB\fBlink\fR\fR
 160  162  .ad
 161  163  .sp .6
 162  164  .RS 4n
 163  165  A datalink, identified by a name. In general, the name can use any alphanumeric
 164  166  characters (or the underscore, \fB_\fR), but must start with an alphabetic
 165  167  character and end with a number. A datalink name can be at most 31 characters,
 166  168  and the ending number must be between 0 and 4294967294 (inclusive). The ending
 167  169  number must not begin with a zero. Datalink names between 3 and 8 characters
 168  170  are recommended.
 169  171  .sp
 170  172  Some subcommands operate only on certain types or classes of datalinks. For
 171  173  those cases, the following object names are used:
 172  174  .sp
 173  175  .ne 2
 174  176  .na
 175  177  \fB\fBphys-link\fR\fR
 176  178  .ad
 177  179  .sp .6
 178  180  .RS 4n
 179  181  A physical datalink.
 180  182  .RE
 181  183  
 182  184  .sp
 183  185  .ne 2
 184  186  .na
 185  187  \fB\fBvlan-link\fR\fR
 186  188  .ad
 187  189  .sp .6
 188  190  .RS 4n
 189  191  A VLAN datalink.
 190  192  .RE
 191  193  
 192  194  .sp
 193  195  .ne 2
 194  196  .na
 195  197  \fB\fBaggr-link\fR\fR
 196  198  .ad
 197  199  .sp .6
 198  200  .RS 4n
 199  201  An aggregation datalink (or a key; see NOTES).
 200  202  .RE
 201  203  
 202  204  .sp
 203  205  .ne 2
 204  206  .na
 205  207  \fB\fBether-link\fR\fR
 206  208  .ad
 207  209  .sp .6
 208  210  .RS 4n
 209  211  A physical Ethernet datalink.
 210  212  .RE
 211  213  
 212  214  .sp
 213  215  .ne 2
 214  216  .na
 215  217  \fB\fBwifi-link\fR\fR
 216  218  .ad
 217  219  .sp .6
 218  220  .RS 4n
 219  221  A WiFi datalink.
 220  222  .RE
 221  223  
 222  224  .sp
 223  225  .ne 2
 224  226  .na
 225  227  \fB\fBvnic-link\fR\fR
 226  228  .ad
 227  229  .sp .6
 228  230  .RS 4n
 229  231  A virtual network interface created on a link or an \fBetherstub\fR. It is a
 230  232  pseudo device that can be treated as if it were an network interface card on a
 231  233  machine.
 232  234  .RE
 233  235  
 234  236  .sp
 235  237  .ne 2
 236  238  .na
 237  239  \fB\fBiptun-link\fR\fR
 238  240  .ad
 239  241  .sp .6
 240  242  .RS 4n
 241  243  An IP tunnel link.
 242  244  .RE
 243  245  
 244  246  .RE
 245  247  
 246  248  .sp
 247  249  .ne 2
 248  250  .na
 249  251  \fB\fBdev\fR\fR
 250  252  .ad
 251  253  .sp .6
 252  254  .RS 4n
 253  255  A network device, identified by concatenation of a driver name and an instance
 254  256  number.
 255  257  .RE
 256  258  
 257  259  .sp
 258  260  .ne 2
 259  261  .na
 260  262  \fB\fBetherstub\fR\fR
 261  263  .ad
 262  264  .sp .6
 263  265  .RS 4n
 264  266  An Ethernet stub can be used instead of a physical NIC to create VNICs. VNICs
 265  267  created on an \fBetherstub\fR will appear to be connected through a virtual
 266  268  switch, allowing complete virtual networks to be built without physical
 267  269  hardware.
 268  270  .RE
 269  271  
 270  272  .sp
 271  273  .ne 2
 272  274  .na
 273  275  \fB\fBbridge\fR\fR
 274  276  .ad
 275  277  .sp .6
 276  278  .RS 4n
 277  279  A bridge instance, identified by an administratively-chosen name. The name may
 278  280  use any alphanumeric characters or the underscore, \fB_\fR, but must start and
 279  281  end with an alphabetic character. A bridge name can be at most 31 characters.
 280  282  The name \fBdefault\fR is reserved, as are all names starting with \fBSUNW\fR.
 281  283  .sp
 282  284  Note that appending a zero (\fB0\fR) to a bridge name produces a valid link
 283  285  name, used for observability.
 284  286  .RE
 285  287  
 286  288  .sp
 287  289  .ne 2
 288  290  .na
 289  291  \fB\fBsecobj\fR\fR
 290  292  .ad
 291  293  .sp .6
 292  294  .RS 4n
 293  295  A secure object, identified by an administratively-chosen name. The name can
 294  296  use any alphanumeric characters, as well as underscore (\fB_\fR), period
 295  297  (\fB\&.\fR), and hyphen (\fB-\fR). A secure object name can be at most 32
 296  298  characters.
 297  299  .RE
 298  300  
 299  301  .SS "Options"
 300  302  .LP
 301  303  Each \fBdladm\fR subcommand has its own set of options. However, many of the
 302  304  subcommands have the following as a common option:
 303  305  .sp
 304  306  .ne 2
 305  307  .na
 306  308  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
 307  309  .ad
 308  310  .sp .6
 309  311  .RS 4n
 310  312  Specifies an alternate root directory where the operation-such as creation,
 311  313  deletion, or renaming-should apply.
 312  314  .RE
 313  315  
 314  316  .SS "SUBCOMMANDS"
 315  317  .LP
 316  318  The following subcommands are supported:
 317  319  .sp
 318  320  .ne 2
 319  321  .na
 320  322  \fB\fBdladm show-link\fR [\fB-P\fR] [\fB-s\fR [\fB-i\fR \fIinterval\fR]]
 321  323  [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]][\fIlink\fR]\fR
 322  324  .ad
 323  325  .sp .6
 324  326  .RS 4n
 325  327  Show link configuration information (the default) or statistics, either for all
 326  328  datalinks or for the specified link \fIlink\fR. By default, the system is
 327  329  configured with one datalink for each known network device.
 328  330  .sp
 329  331  .ne 2
 330  332  .na
 331  333  \fB\fB-o\fR \fIfield\fR[,...], \fB--output\fR=\fIfield\fR[,...]\fR
 332  334  .ad
 333  335  .sp .6
 334  336  .RS 4n
 335  337  A case-insensitive, comma-separated list of output fields to display. When not
 336  338  modified by the \fB-s\fR option (described below), the field name must be one
 337  339  of the fields listed below, or the special value \fBall\fR to display all
 338  340  fields. By default (without \fB-o\fR), \fBshow-link\fR displays all fields.
 339  341  .sp
 340  342  .ne 2
 341  343  .na
 342  344  \fB\fBLINK\fR\fR
 343  345  .ad
 344  346  .sp .6
 345  347  .RS 4n
 346  348  The name of the datalink.
 347  349  .RE
 348  350  
 349  351  .sp
 350  352  .ne 2
 351  353  .na
 352  354  \fB\fBCLASS\fR\fR
 353  355  .ad
 354  356  .sp .6
 355  357  .RS 4n
 356  358  The class of the datalink. \fBdladm\fR distinguishes between the following
 357  359  classes:
 358  360  .sp
 359  361  .ne 2
 360  362  .na
 361  363  \fB\fBphys\fR\fR
 362  364  .ad
 363  365  .sp .6
 364  366  .RS 4n
 365  367  A physical datalink. The \fBshow-phys\fR subcommand displays more detail for
 366  368  this class of datalink.
 367  369  .RE
 368  370  
 369  371  .sp
 370  372  .ne 2
 371  373  .na
 372  374  \fB\fBaggr\fR\fR
 373  375  .ad
 374  376  .sp .6
 375  377  .RS 4n
 376  378  An IEEE 802.3ad link aggregation. The \fBshow-aggr\fR subcommand displays more
 377  379  detail for this class of datalink.
 378  380  .RE
 379  381  
 380  382  .sp
 381  383  .ne 2
 382  384  .na
 383  385  \fB\fBvlan\fR\fR
 384  386  .ad
 385  387  .sp .6
 386  388  .RS 4n
 387  389  A VLAN datalink. The \fBshow-vlan\fR subcommand displays more detail for this
 388  390  class of datalink.
 389  391  .RE
 390  392  
 391  393  .sp
 392  394  .ne 2
 393  395  .na
 394  396  \fB\fBvnic\fR\fR
 395  397  .ad
 396  398  .sp .6
 397  399  .RS 4n
 398  400  A virtual network interface. The \fBshow-vnic\fR subcommand displays more
 399  401  detail for this class of datalink.
 400  402  .RE
 401  403  
 402  404  .RE
 403  405  
 404  406  .sp
 405  407  .ne 2
 406  408  .na
 407  409  \fB\fBMTU\fR\fR
 408  410  .ad
 409  411  .sp .6
 410  412  .RS 4n
 411  413  The maximum transmission unit size for the datalink being displayed.
 412  414  .RE
 413  415  
 414  416  .sp
 415  417  .ne 2
 416  418  .na
 417  419  \fB\fBSTATE\fR\fR
 418  420  .ad
 419  421  .sp .6
 420  422  .RS 4n
 421  423  The link state of the datalink. The state can be \fBup\fR, \fBdown\fR, or
 422  424  \fBunknown\fR.
 423  425  .RE
 424  426  
 425  427  .sp
 426  428  .ne 2
 427  429  .na
 428  430  \fB\fBBRIDGE\fR\fR
 429  431  .ad
 430  432  .sp .6
 431  433  .RS 4n
 432  434  The name of the bridge to which this link is assigned, if any.
 433  435  .RE
 434  436  
 435  437  .sp
 436  438  .ne 2
 437  439  .na
 438  440  \fB\fBOVER\fR\fR
 439  441  .ad
 440  442  .sp .6
 441  443  .RS 4n
 442  444  The physical datalink(s) over which the datalink is operating. This applies to
 443  445  \fBaggr\fR, \fBbridge\fR, and \fBvlan\fR classes of datalinks. A VLAN is
 444  446  created over a single physical datalink, a bridge has multiple attached links,
 445  447  and an aggregation is comprised of one or more physical datalinks.
 446  448  .RE
 447  449  
 448  450  When the \fB-o\fR option is used in conjunction with the \fB-s\fR option, used
 449  451  to display link statistics, the field name must be one of the fields listed
 450  452  below, or the special value \fBall\fR to display all fields
 451  453  .sp
 452  454  .ne 2
 453  455  .na
 454  456  \fB\fBLINK\fR\fR
 455  457  .ad
 456  458  .sp .6
 457  459  .RS 4n
 458  460  The name of the datalink.
 459  461  .RE
 460  462  
 461  463  .sp
 462  464  .ne 2
 463  465  .na
 464  466  \fB\fBIPACKETS\fR\fR
 465  467  .ad
 466  468  .sp .6
 467  469  .RS 4n
 468  470  Number of packets received on this link.
 469  471  .RE
 470  472  
 471  473  .sp
 472  474  .ne 2
 473  475  .na
 474  476  \fB\fBRBYTES\fR\fR
 475  477  .ad
 476  478  .sp .6
 477  479  .RS 4n
 478  480  Number of bytes received on this link.
 479  481  .RE
 480  482  
 481  483  .sp
 482  484  .ne 2
 483  485  .na
 484  486  \fB\fBIERRORS\fR\fR
 485  487  .ad
 486  488  .sp .6
 487  489  .RS 4n
 488  490  Number of input errors.
 489  491  .RE
 490  492  
 491  493  .sp
 492  494  .ne 2
 493  495  .na
 494  496  \fB\fBOPACKETS\fR\fR
 495  497  .ad
 496  498  .sp .6
 497  499  .RS 4n
 498  500  Number of packets sent on this link.
 499  501  .RE
 500  502  
 501  503  .sp
 502  504  .ne 2
 503  505  .na
 504  506  \fB\fBOBYTES\fR\fR
 505  507  .ad
 506  508  .sp .6
 507  509  .RS 4n
 508  510  Number of bytes received on this link.
 509  511  .RE
 510  512  
 511  513  .sp
 512  514  .ne 2
 513  515  .na
 514  516  \fB\fBOERRORS\fR\fR
 515  517  .ad
 516  518  .sp .6
 517  519  .RS 4n
 518  520  Number of output errors.
 519  521  .RE
 520  522  
 521  523  .RE
 522  524  
 523  525  .sp
 524  526  .ne 2
 525  527  .na
 526  528  \fB\fB-p\fR, \fB--parseable\fR\fR
 527  529  .ad
 528  530  .sp .6
 529  531  .RS 4n
 530  532  Display using a stable machine-parseable format. The \fB-o\fR option is
 531  533  required with \fB-p\fR. See "Parseable Output Format", below.
 532  534  .RE
 533  535  
 534  536  .sp
 535  537  .ne 2
 536  538  .na
 537  539  \fB\fB-P\fR, \fB--persistent\fR\fR
 538  540  .ad
 539  541  .sp .6
 540  542  .RS 4n
 541  543  Display the persistent link configuration.
 542  544  .RE
 543  545  
 544  546  .sp
 545  547  .ne 2
 546  548  .na
 547  549  \fB\fB-s\fR, \fB--statistics\fR\fR
 548  550  .ad
 549  551  .sp .6
 550  552  .RS 4n
 551  553  Display link statistics.
 552  554  .RE
 553  555  
 554  556  .sp
 555  557  .ne 2
 556  558  .na
 557  559  \fB\fB-i\fR \fIinterval\fR, \fB--interval\fR=\fIinterval\fR\fR
 558  560  .ad
 559  561  .sp .6
 560  562  .RS 4n

 561  563  Used with the \fB-s\fR option to specify an interval, in seconds, at which
 562  564  statistics should be displayed. If this option is not specified, statistics
 563  565  will be displayed only once.
 564  566  .RE
 565  567  
 566  568  .RE
 567  569  
 568  570  .sp
 569  571  .ne 2
 570  572  .na
 571      -\fB\fBdladm rename-link\fR [\fB-R\fR \fIroot-dir\fR] \fIlink\fR
 572      -\fInew-link\fR\fR
      573 +\fB\fBdladm rename-link\fR [\fB-R\fR \fIroot-dir\fR] [\fB-z\fR \fIzonename\fR] \fIlink\fR \fInew-link\fR\fR
 573  574  .ad
 574  575  .sp .6
 575  576  .RS 4n
 576  577  Rename \fIlink\fR to \fInew-link\fR. This is used to give a link a meaningful
 577  578  name, or to associate existing link configuration such as link properties of a
 578  579  removed device with a new device. See the \fBEXAMPLES\fR section for specific
 579  580  examples of how this subcommand is used.
 580  581  .sp
 581  582  .ne 2
 582  583  .na
 583  584  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
 584  585  .ad
 585  586  .sp .6
 586  587  .RS 4n
 587  588  See "Options," above.
 588  589  .RE
 589  590  
      591 +.sp
      592 +.ne 2
      593 +.na
      594 +\fB\fB-z\fR \fIzonename\fR
      595 +.ad
      596 +.sp .6
      597 +.RS 4n
      598 +A link assigned to a zone can only be renamed while the zone is in the ready state.
 590  599  .RE
 591  600  
      601 +.RE
      602 +
 592  603  .sp
 593  604  .ne 2
 594  605  .na
 595  606  \fB\fBdladm delete-phys\fR \fIphys-link\fR\fR
 596  607  .ad
 597  608  .sp .6
 598  609  .RS 4n
 599  610  This command is used to delete the persistent configuration of a link
 600  611  associated with physical hardware which has been removed from the system. See
 601  612  the \fBEXAMPLES\fR section.

 602  613  .RE
 603  614  
 604  615  .sp
 605  616  .ne 2
 606  617  .na
 607  618  \fB\fBdladm show-phys\fR [\fB-m\fR | \fB-H\fR | \fB-P\fR] [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]]
 608  619  [\fIphys-link\fR]\fR
 609  620  .ad
 610  621  .sp .6
 611  622  .RS 4n
 612  623  Show the physical device and attributes of all physical links, or of the named
 613  624  physical link. Without \fB-P\fR, only physical links that are available on the
 614  625  running system are displayed.
 615  626  .sp
 616  627  .ne 2
 617  628  .na
 618  629  \fB\fB-H\fR\fR
 619  630  .ad
 620  631  .sp .6
 621  632  .RS 4n
 622  633  Show hardware resource usage, as returned by the NIC driver. Output from
 623  634  \fB-H\fR displays the following elements:
 624  635  .sp
 625  636  .ne 2
 626  637  .na
 627  638  \fB\fBLINK\fR\fR
 628  639  .ad
 629  640  .sp .6
 630  641  .RS 4n
 631  642  A physical device corresponding to a NIC driver.
 632  643  .RE
 633  644  
 634  645  .sp
 635  646  .ne 2
 636  647  .na
 637  648  \fB\fBGROUP\fR\fR
 638  649  .ad
 639  650  .sp .6
 640  651  .RS 4n
 641  652  A collection of rings.
 642  653  .RE
 643  654  
 644  655  .sp
 645  656  .ne 2
 646  657  .na
 647  658  \fB\fBGROUPTYPE\fR\fR
 648  659  .ad
 649  660  .sp .6
 650  661  .RS 4n
 651  662  RX or TX. All rings in a group are of the same group type.
 652  663  .RE
 653  664  
 654  665  .sp
 655  666  .ne 2
 656  667  .na
 657  668  \fB\fBRINGS\fR\fR
 658  669  .ad
 659  670  .sp .6
 660  671  .RS 4n
 661  672  A hardware resource used by a data link, subject to assignment by a driver to
 662  673  different groups.
 663  674  .RE
 664  675  
 665  676  .sp
 666  677  .ne 2
 667  678  .na
 668  679  \fB\fBCLIENTS\fR\fR
 669  680  .ad
 670  681  .sp .6
 671  682  .RS 4n
 672  683  MAC clients that are using the rings within a group.
 673  684  .RE
 674  685  
 675  686  .RE
 676  687  
 677  688  .sp
 678  689  .ne 2
 679  690  .na
 680  691  \fB\fB-m\fR\fR
 681  692  .ad
 682  693  .sp .6
 683  694  .RS 4n
 684  695  Show MAC addresses and related information. Output from \fB-m\fR
 685  696  displays the following elements:
 686  697  .sp
 687  698  .ne 2
 688  699  .na
 689  700  \fB\fBLINK\fR\fR
 690  701  .ad
 691  702  .sp .6
 692  703  .RS 4n
 693  704  A physical device corresponding to a NIC driver.
 694  705  .RE
 695  706  .sp
 696  707  .ne 2
 697  708  .na
 698  709  \fB\fBSLOT\fR\fR
 699  710  .ad
 700  711  .sp .6
 701  712  .RS 4n
 702  713  When a given physical device has multiple factory MAC addresses, this
 703  714  indicates the slot of the corresponding MAC address which can be used as
 704  715  part of a call to \fBcreate-vnic\fR.
 705  716  .RE
 706  717  .sp
 707  718  .ne 2
 708  719  .na
 709  720  \fB\fBADDRESS\fR\fR
 710  721  .ad
 711  722  .sp .6
 712  723  .RS 4n
 713  724  Displays the MAC address of the device.
 714  725  .RE
 715  726  .sp
 716  727  .ne 2
 717  728  .na
 718  729  \fB\fBINUSE\fR\fR
 719  730  .ad
 720  731  .sp .6
 721  732  .RS 4n
 722  733  Displays whether or not a MAC Address is actively being used.
 723  734  .RE
 724  735  .sp
 725  736  .ne 2
 726  737  .na
 727  738  \fB\fBCLIENT\fR\fR
 728  739  .ad
 729  740  .sp .6
 730  741  .RS 4n
 731  742  MAC clients that are using the address.
 732  743  .RE
 733  744  .RE
 734  745  .sp
 735  746  .ne 2
 736  747  .na
 737  748  \fB\fB-o\fR \fIfield\fR, \fB--output\fR=\fIfield\fR\fR
 738  749  .ad
 739  750  .sp .6
 740  751  .RS 4n
 741  752  A case-insensitive, comma-separated list of output fields to display. The field
 742  753  name must be one of the fields listed below, or the special value \fBall\fR, to
 743  754  display all fields. Note that if either \fB-H\fR or \fB-m\fR are specified, then
 744  755  the valid options are those described in their respective sections. For each
 745  756  link, the following fields can be displayed:
 746  757  .sp
 747  758  .ne 2
 748  759  .na
 749  760  \fB\fBLINK\fR\fR
 750  761  .ad
 751  762  .sp .6
 752  763  .RS 4n
 753  764  The name of the datalink.
 754  765  .RE
 755  766  
 756  767  .sp
 757  768  .ne 2
 758  769  .na
 759  770  \fB\fBMEDIA\fR\fR
 760  771  .ad
 761  772  .sp .6
 762  773  .RS 4n
 763  774  The media type provided by the physical datalink.
 764  775  .RE
 765  776  
 766  777  .sp
 767  778  .ne 2
 768  779  .na
 769  780  \fB\fBSTATE\fR\fR
 770  781  .ad
 771  782  .sp .6
 772  783  .RS 4n
 773  784  The state of the link. This can be \fBup\fR, \fBdown\fR, or \fBunknown\fR.
 774  785  .RE
 775  786  
 776  787  .sp
 777  788  .ne 2
 778  789  .na
 779  790  \fB\fBSPEED\fR\fR
 780  791  .ad
 781  792  .sp .6
 782  793  .RS 4n
 783  794  The current speed of the link, in megabits per second.
 784  795  .RE
 785  796  
 786  797  .sp
 787  798  .ne 2
 788  799  .na
 789  800  \fB\fBDUPLEX\fR\fR
 790  801  .ad
 791  802  .sp .6
 792  803  .RS 4n
 793  804  For Ethernet links, the full/half duplex status of the link is displayed if the
 794  805  link state is \fBup\fR. The duplex is displayed as \fBunknown\fR in all other
 795  806  cases.
 796  807  .RE
 797  808  
 798  809  .sp
 799  810  .ne 2
 800  811  .na
 801  812  \fB\fBDEVICE\fR\fR
 802  813  .ad
 803  814  .sp .6
 804  815  .RS 4n
 805  816  The name of the physical device under this link.
 806  817  .RE
 807  818  
 808  819  .RE
 809  820  
 810  821  .sp
 811  822  .ne 2
 812  823  .na
 813  824  \fB\fB-p\fR, \fB--parseable\fR\fR
 814  825  .ad
 815  826  .sp .6
 816  827  .RS 4n
 817  828  Display using a stable machine-parseable format. The \fB-o\fR option is
 818  829  required with \fB-p\fR. See "Parseable Output Format", below.
 819  830  .RE
 820  831  
 821  832  .sp
 822  833  .ne 2
 823  834  .na
 824  835  \fB\fB-P\fR, \fB--persistent\fR\fR
 825  836  .ad
 826  837  .sp .6
 827  838  .RS 4n
 828  839  This option displays persistent configuration for all links, including those
 829  840  that have been removed from the system. The output provides a \fBFLAGS\fR
 830  841  column in which the \fBr\fR flag indicates that the physical device associated
 831  842  with a physical link has been removed. For such links, \fBdelete-phys\fR can be
 832  843  used to purge the link's configuration from the system.
 833  844  .RE
 834  845  
 835  846  .RE
 836  847  
 837  848  .sp
 838  849  .ne 2
 839  850  .na
 840  851  \fB\fBdladm create-aggr\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-P\fR
 841  852  \fIpolicy\fR] [\fB-L\fR \fImode\fR] [\fB-T\fR \fItime\fR] [\fB-u\fR
 842  853  \fIaddress\fR] \fB-l\fR \fIether-link1\fR [\fB-l\fR \fIether-link2\fR...]
 843  854  \fIaggr-link\fR\fR
 844  855  .ad
 845  856  .sp .6
 846  857  .RS 4n
 847  858  Combine a set of links into a single IEEE 802.3ad link aggregation named
 848  859  \fIaggr-link\fR. The use of an integer \fIkey\fR to generate a link name for
 849  860  the aggregation is also supported for backward compatibility. Many of the
 850  861  \fB*\fR\fB-aggr\fR subcommands below also support the use of a \fIkey\fR to
 851  862  refer to a given aggregation, but use of the aggregation link name is
 852  863  preferred. See the \fBNOTES\fR section for more information on keys.
 853  864  .sp
 854  865  \fBdladm\fR supports a number of port selection policies for an aggregation of
 855  866  ports. (See the description of the \fB-P\fR option, below.) If you do not
 856  867  specify a policy, \fBcreate-aggr\fR uses the default, the L4 policy, described
 857  868  under the \fB-P\fR option.
 858  869  .sp
 859  870  .ne 2
 860  871  .na
 861  872  \fB\fB-l\fR \fIether-link\fR, \fB--link\fR=\fIether-link\fR\fR
 862  873  .ad
 863  874  .sp .6
 864  875  .RS 4n
 865  876  Each Ethernet link (or port) in the aggregation is specified using an \fB-l\fR
 866  877  option followed by the name of the link to be included in the aggregation.
 867  878  Multiple links are included in the aggregation by specifying multiple \fB-l\fR
 868  879  options. For backward compatibility with previous versions of Solaris, the
 869  880  \fBdladm\fR command also supports the using the \fB-d\fR option (or
 870  881  \fB--dev\fR) with a device name to specify links by their underlying device
 871  882  name. The other \fB*\fR\fB-aggr\fR subcommands that take \fB-l\fRoptions also
 872  883  accept \fB-d\fR.
 873  884  .RE
 874  885  
 875  886  .sp
 876  887  .ne 2
 877  888  .na
 878  889  \fB\fB-t\fR, \fB--temporary\fR\fR
 879  890  .ad
 880  891  .sp .6
 881  892  .RS 4n
 882  893  Specifies that the aggregation is temporary. Temporary aggregations last until
 883  894  the next reboot.
 884  895  .RE
 885  896  
 886  897  .sp
 887  898  .ne 2
 888  899  .na
 889  900  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
 890  901  .ad
 891  902  .sp .6
 892  903  .RS 4n
 893  904  See "Options," above.
 894  905  .RE
 895  906  
 896  907  .sp
 897  908  .ne 2
 898  909  .na
 899  910  \fB\fB-P\fR \fIpolicy\fR, \fB--policy\fR=\fIpolicy\fR\fR
 900  911  .ad
 901  912  .br
 902  913  .na
 903  914  \fB\fR
 904  915  .ad
 905  916  .sp .6
 906  917  .RS 4n
 907  918  Specifies the port selection policy to use for load spreading of outbound
 908  919  traffic. The policy specifies which \fIdev\fR object is used to send packets. A
 909  920  policy is a list of one or more layers specifiers separated by commas. A layer
 910  921  specifier is one of the following:
 911  922  .sp
 912  923  .ne 2
 913  924  .na
 914  925  \fB\fBL2\fR\fR
 915  926  .ad
 916  927  .sp .6
 917  928  .RS 4n
 918  929  Select outbound device according to source and destination \fBMAC\fR addresses
 919  930  of the packet.
 920  931  .RE
 921  932  
 922  933  .sp
 923  934  .ne 2
 924  935  .na
 925  936  \fB\fBL3\fR\fR
 926  937  .ad
 927  938  .sp .6
 928  939  .RS 4n
 929  940  Select outbound device according to source and destination \fBIP\fR addresses
 930  941  of the packet.
 931  942  .RE
 932  943  
 933  944  .sp
 934  945  .ne 2
 935  946  .na
 936  947  \fB\fBL4\fR\fR
 937  948  .ad
 938  949  .sp .6
 939  950  .RS 4n
 940  951  Select outbound device according to the upper layer protocol information
 941  952  contained in the packet. For \fBTCP\fR and \fBUDP\fR, this includes source and
 942  953  destination ports. For IPsec, this includes the \fBSPI\fR (Security Parameters
 943  954  Index).
 944  955  .RE
 945  956  
 946  957  For example, to use upper layer protocol information, the following policy can
 947  958  be used:
 948  959  .sp
 949  960  .in +2
 950  961  .nf
 951  962  -P L4
 952  963  .fi
 953  964  .in -2
 954  965  .sp
 955  966  
 956  967  Note that policy L4 is the default.
 957  968  .sp
 958  969  To use the source and destination \fBMAC\fR addresses as well as the source and
 959  970  destination \fBIP\fR addresses, the following policy can be used:
 960  971  .sp
 961  972  .in +2
 962  973  .nf
 963  974  -P L2,L3
 964  975  .fi
 965  976  .in -2
 966  977  .sp
 967  978  
 968  979  .RE
 969  980  
 970  981  .sp
 971  982  .ne 2
 972  983  .na
 973  984  \fB\fB-L\fR \fImode\fR, \fB--lacp-mode\fR=\fImode\fR\fR
 974  985  .ad
 975  986  .sp .6
 976  987  .RS 4n
 977  988  Specifies whether \fBLACP\fR should be used and, if used, the mode in which it
 978  989  should operate. Supported values are \fBoff\fR, \fBactive\fR or \fBpassive\fR.
 979  990  .RE
 980  991  
 981  992  .sp
 982  993  .ne 2
 983  994  .na
 984  995  \fB\fB-T\fR \fItime\fR, \fB--lacp-timer\fR=\fItime\fR\fR
 985  996  .ad
 986  997  .br
 987  998  .na
 988  999  \fB\fR
 989 1000  .ad
 990 1001  .sp .6
 991 1002  .RS 4n
 992 1003  Specifies the \fBLACP\fR timer value. The supported values are \fBshort\fR or
 993 1004  \fBlong\fRjjj.
 994 1005  .RE
 995 1006  
 996 1007  .sp
 997 1008  .ne 2
 998 1009  .na
 999 1010  \fB\fB-u\fR \fIaddress\fR, \fB--unicast\fR=\fIaddress\fR\fR
1000 1011  .ad
1001 1012  .sp .6
1002 1013  .RS 4n
1003 1014  Specifies a fixed unicast hardware address to be used for the aggregation. If
1004 1015  this option is not specified, then an address is automatically chosen from the
1005 1016  set of addresses of the component devices.
1006 1017  .RE
1007 1018  
1008 1019  .RE
1009 1020  
1010 1021  .sp
1011 1022  .ne 2
1012 1023  .na
1013 1024  \fB\fBdladm modify-aggr\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-P\fR
1014 1025  \fIpolicy\fR] [\fB-L\fR \fImode\fR] [\fB-T\fR \fItime\fR] [\fB-u\fR
1015 1026  \fIaddress\fR] \fIaggr-link\fR\fR
1016 1027  .ad
1017 1028  .sp .6
1018 1029  .RS 4n
1019 1030  Modify the parameters of the specified aggregation.
1020 1031  .sp
1021 1032  .ne 2
1022 1033  .na
1023 1034  \fB\fB-t\fR, \fB--temporary\fR\fR
1024 1035  .ad
1025 1036  .sp .6
1026 1037  .RS 4n
1027 1038  Specifies that the modification is temporary. Temporary aggregations last until
1028 1039  the next reboot.
1029 1040  .RE
1030 1041  
1031 1042  .sp
1032 1043  .ne 2
1033 1044  .na
1034 1045  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
1035 1046  .ad
1036 1047  .sp .6
1037 1048  .RS 4n
1038 1049  See "Options," above.
1039 1050  .RE
1040 1051  
1041 1052  .sp
1042 1053  .ne 2
1043 1054  .na
1044 1055  \fB\fB-P\fR \fIpolicy\fR, \fB--policy\fR=\fIpolicy\fR\fR
1045 1056  .ad
1046 1057  .sp .6
1047 1058  .RS 4n
1048 1059  Specifies the port selection policy to use for load spreading of outbound
1049 1060  traffic. See \fBdladm create-aggr\fR for a description of valid policy values.
1050 1061  .RE
1051 1062  
1052 1063  .sp
1053 1064  .ne 2
1054 1065  .na
1055 1066  \fB\fB-L\fR \fImode\fR, \fB--lacp-mode\fR=\fImode\fR\fR
1056 1067  .ad
1057 1068  .sp .6
1058 1069  .RS 4n
1059 1070  Specifies whether \fBLACP\fR should be used and, if used, the mode in which it
1060 1071  should operate. Supported values are \fBoff\fR, \fBactive\fR, or \fBpassive\fR.
1061 1072  .RE
1062 1073  
1063 1074  .sp
1064 1075  .ne 2
1065 1076  .na
1066 1077  \fB\fB-T\fR \fItime\fR, \fB--lacp-timer\fR=\fItime\fR\fR
1067 1078  .ad
1068 1079  .br
1069 1080  .na
1070 1081  \fB\fR
1071 1082  .ad
1072 1083  .sp .6
1073 1084  .RS 4n
1074 1085  Specifies the \fBLACP\fR timer value. The supported values are \fBshort\fR or
1075 1086  \fBlong\fR.
1076 1087  .RE
1077 1088  
1078 1089  .sp
1079 1090  .ne 2
1080 1091  .na
1081 1092  \fB\fB-u\fR \fIaddress\fR, \fB--unicast\fR=\fIaddress\fR\fR
1082 1093  .ad
1083 1094  .sp .6
1084 1095  .RS 4n
1085 1096  Specifies a fixed unicast hardware address to be used for the aggregation. If
1086 1097  this option is not specified, then an address is automatically chosen from the
1087 1098  set of addresses of the component devices.
1088 1099  .RE
1089 1100  
1090 1101  .RE
1091 1102  
1092 1103  .sp
1093 1104  .ne 2
1094 1105  .na
1095 1106  \fB\fBdladm delete-aggr\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR]
1096 1107  \fIaggr-link\fR\fR
1097 1108  .ad
1098 1109  .sp .6
1099 1110  .RS 4n
1100 1111  Deletes the specified aggregation.
1101 1112  .sp
1102 1113  .ne 2
1103 1114  .na
1104 1115  \fB\fB-t\fR, \fB--temporary\fR\fR
1105 1116  .ad
1106 1117  .sp .6
1107 1118  .RS 4n
1108 1119  Specifies that the deletion is temporary. Temporary deletions last until the
1109 1120  next reboot.
1110 1121  .RE
1111 1122  
1112 1123  .sp
1113 1124  .ne 2
1114 1125  .na
1115 1126  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
1116 1127  .ad
1117 1128  .sp .6
1118 1129  .RS 4n
1119 1130  See "Options," above.
1120 1131  .RE
1121 1132  
1122 1133  .RE
1123 1134  
1124 1135  .sp
1125 1136  .ne 2
1126 1137  .na
1127 1138  \fB\fBdladm add-aggr\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fB-l\fR
1128 1139  \fIether-link1\fR [\fB--link\fR=\fIether-link2\fR...] \fIaggr-link\fR\fR
1129 1140  .ad
1130 1141  .sp .6
1131 1142  .RS 4n
1132 1143  Adds links to the specified aggregation.
1133 1144  .sp
1134 1145  .ne 2
1135 1146  .na
1136 1147  \fB\fB-l\fR \fIether-link\fR, \fB--link\fR=\fIether-link\fR\fR
1137 1148  .ad
1138 1149  .sp .6
1139 1150  .RS 4n
1140 1151  Specifies an Ethernet link to add to the aggregation. Multiple links can be
1141 1152  added by supplying multiple \fB-l\fR options.
1142 1153  .RE
1143 1154  
1144 1155  .sp
1145 1156  .ne 2
1146 1157  .na
1147 1158  \fB\fB-t\fR, \fB--temporary\fR\fR
1148 1159  .ad
1149 1160  .sp .6
1150 1161  .RS 4n
1151 1162  Specifies that the additions are temporary. Temporary additions last until the
1152 1163  next reboot.
1153 1164  .RE
1154 1165  
1155 1166  .sp
1156 1167  .ne 2
1157 1168  .na
1158 1169  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
1159 1170  .ad
1160 1171  .sp .6
1161 1172  .RS 4n
1162 1173  See "Options," above.
1163 1174  .RE
1164 1175  
1165 1176  .RE
1166 1177  
1167 1178  .sp
1168 1179  .ne 2
1169 1180  .na
1170 1181  \fB\fBdladm remove-aggr\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fB-l\fR
1171 1182  \fIether-link1\fR [\fB--l\fR=\fIether-link2\fR...] \fIaggr-link\fR\fR
1172 1183  .ad
1173 1184  .sp .6
1174 1185  .RS 4n
1175 1186  Removes links from the specified aggregation.
1176 1187  .sp
1177 1188  .ne 2
1178 1189  .na
1179 1190  \fB\fB-l\fR \fIether-link\fR, \fB--link\fR=\fIether-link\fR\fR
1180 1191  .ad
1181 1192  .sp .6
1182 1193  .RS 4n
1183 1194  Specifies an Ethernet link to remove from the aggregation. Multiple links can
1184 1195  be added by supplying multiple \fB-l\fR options.
1185 1196  .RE
1186 1197  
1187 1198  .sp
1188 1199  .ne 2
1189 1200  .na
1190 1201  \fB\fB-t\fR, \fB--temporary\fR\fR
1191 1202  .ad
1192 1203  .sp .6
1193 1204  .RS 4n
1194 1205  Specifies that the removals are temporary. Temporary removal last until the
1195 1206  next reboot.
1196 1207  .RE
1197 1208  
1198 1209  .sp
1199 1210  .ne 2
1200 1211  .na
1201 1212  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
1202 1213  .ad
1203 1214  .sp .6
1204 1215  .RS 4n
1205 1216  See "Options," above.
1206 1217  .RE
1207 1218  
1208 1219  .RE
1209 1220  
1210 1221  .sp
1211 1222  .ne 2
1212 1223  .na
1213 1224  \fB\fBdladm show-aggr\fR [\fB-PLx\fR] [\fB-s\fR [\fB-i\fR \fIinterval\fR]]
1214 1225  [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]] [\fIaggr-link\fR]\fR
1215 1226  .ad
1216 1227  .sp .6
1217 1228  .RS 4n
1218 1229  Show aggregation configuration (the default), \fBLACP\fR information, or
1219 1230  statistics, either for all aggregations or for the specified aggregation.
1220 1231  .sp
1221 1232  By default (with no options), the following fields can be displayed:
1222 1233  .sp
1223 1234  .ne 2
1224 1235  .na
1225 1236  \fB\fBLINK\fR\fR
1226 1237  .ad
1227 1238  .sp .6
1228 1239  .RS 4n
1229 1240  The name of the aggregation link.
1230 1241  .RE
1231 1242  
1232 1243  .sp
1233 1244  .ne 2
1234 1245  .na
1235 1246  \fB\fBPOLICY\fR\fR
1236 1247  .ad
1237 1248  .sp .6
1238 1249  .RS 4n
1239 1250  The LACP policy of the aggregation. See the \fBcreate-aggr\fR \fB-P\fR option
1240 1251  for a description of the possible values.
1241 1252  .RE
1242 1253  
1243 1254  .sp
1244 1255  .ne 2
1245 1256  .na
1246 1257  \fB\fBADDRPOLICY\fR\fR
1247 1258  .ad
1248 1259  .sp .6
1249 1260  .RS 4n
1250 1261  Either \fBauto\fR, if the aggregation is configured to automatically configure
1251 1262  its unicast MAC address (the default if the \fB-u\fR option was not used to
1252 1263  create or modify the aggregation), or \fBfixed\fR, if \fB-u\fR was used to set
1253 1264  a fixed MAC address.
1254 1265  .RE
1255 1266  
1256 1267  .sp
1257 1268  .ne 2
1258 1269  .na
1259 1270  \fB\fBLACPACTIVITY\fR\fR
1260 1271  .ad
1261 1272  .sp .6
1262 1273  .RS 4n
1263 1274  The LACP mode of the aggregation. Possible values are \fBoff\fR, \fBactive\fR,
1264 1275  or \fBpassive\fR, as set by the \fB-l\fR option to \fBcreate-aggr\fR or
1265 1276  \fBmodify-aggr\fR.
1266 1277  .RE
1267 1278  
1268 1279  .sp
1269 1280  .ne 2
1270 1281  .na
1271 1282  \fB\fBLACPTIMER\fR\fR
1272 1283  .ad
1273 1284  .sp .6
1274 1285  .RS 4n
1275 1286  The LACP timer value of the aggregation as set by the \fB-T\fR option of
1276 1287  \fBcreate-aggr\fR or \fBmodify-aggr\fR.
1277 1288  .RE
1278 1289  
1279 1290  .sp
1280 1291  .ne 2
1281 1292  .na
1282 1293  \fB\fBFLAGS\fR\fR
1283 1294  .ad
1284 1295  .sp .6
1285 1296  .RS 4n
1286 1297  A set of state flags associated with the aggregation. The only possible flag is
1287 1298  \fBf\fR, which is displayed if the administrator forced the creation the
1288 1299  aggregation using the \fB-f\fR option to \fBcreate-aggr\fR. Other flags might
1289 1300  be defined in the future.
1290 1301  .RE
1291 1302  
1292 1303  The \fBshow-aggr\fR command accepts the following options:
1293 1304  .sp
1294 1305  .ne 2
1295 1306  .na
1296 1307  \fB\fB-L\fR, \fB--lacp\fR\fR
1297 1308  .ad
1298 1309  .sp .6
1299 1310  .RS 4n
1300 1311  Displays detailed \fBLACP\fR information for the aggregation link and each
1301 1312  underlying port. Most of the state information displayed by this option is
1302 1313  defined by IEEE 802.3. With this option, the following fields can be displayed:
1303 1314  .sp
1304 1315  .ne 2
1305 1316  .na
1306 1317  \fB\fBLINK\fR\fR
1307 1318  .ad
1308 1319  .sp .6
1309 1320  .RS 4n
1310 1321  The name of the aggregation link.
1311 1322  .RE
1312 1323  
1313 1324  .sp
1314 1325  .ne 2
1315 1326  .na
1316 1327  \fB\fBPORT\fR\fR
1317 1328  .ad
1318 1329  .sp .6
1319 1330  .RS 4n
1320 1331  The name of one of the underlying aggregation ports.
1321 1332  .RE
1322 1333  
1323 1334  .sp
1324 1335  .ne 2
1325 1336  .na
1326 1337  \fB\fBAGGREGATABLE\fR\fR
1327 1338  .ad
1328 1339  .sp .6
1329 1340  .RS 4n
1330 1341  Whether the port can be added to the aggregation.
1331 1342  .RE
1332 1343  
1333 1344  .sp
1334 1345  .ne 2
1335 1346  .na
1336 1347  \fB\fBSYNC\fR\fR
1337 1348  .ad
1338 1349  .sp .6
1339 1350  .RS 4n
1340 1351  If \fByes\fR, the system considers the port to be synchronized and part of the
1341 1352  aggregation.
1342 1353  .RE
1343 1354  
1344 1355  .sp
1345 1356  .ne 2
1346 1357  .na
1347 1358  \fB\fBCOLL\fR\fR
1348 1359  .ad
1349 1360  .sp .6
1350 1361  .RS 4n
1351 1362  If \fByes\fR, collection of incoming frames is enabled on the associated port.
1352 1363  .RE
1353 1364  
1354 1365  .sp
1355 1366  .ne 2
1356 1367  .na
1357 1368  \fB\fBDIST\fR\fR
1358 1369  .ad
1359 1370  .sp .6
1360 1371  .RS 4n
1361 1372  If \fByes\fR, distribution of outgoing frames is enabled on the associated
1362 1373  port.
1363 1374  .RE
1364 1375  
1365 1376  .sp
1366 1377  .ne 2
1367 1378  .na
1368 1379  \fB\fBDEFAULTED\fR\fR
1369 1380  .ad
1370 1381  .sp .6
1371 1382  .RS 4n
1372 1383  If \fByes\fR, the port is using defaulted partner information (that is, has not
1373 1384  received LACP data from the LACP partner).
1374 1385  .RE
1375 1386  
1376 1387  .sp
1377 1388  .ne 2
1378 1389  .na
1379 1390  \fB\fBEXPIRED\fR\fR
1380 1391  .ad
1381 1392  .sp .6
1382 1393  .RS 4n
1383 1394  If \fByes\fR, the receive state of the port is in the \fBEXPIRED\fR state.
1384 1395  .RE
1385 1396  
1386 1397  .RE
1387 1398  
1388 1399  .sp
1389 1400  .ne 2
1390 1401  .na
1391 1402  \fB\fB-x\fR, \fB--extended\fR\fR
1392 1403  .ad
1393 1404  .sp .6
1394 1405  .RS 4n
1395 1406  Display additional aggregation information including detailed information on
1396 1407  each underlying port. With \fB-x\fR, the following fields can be displayed:
1397 1408  .sp
1398 1409  .ne 2
1399 1410  .na
1400 1411  \fB\fBLINK\fR\fR
1401 1412  .ad
1402 1413  .sp .6
1403 1414  .RS 4n
1404 1415  The name of the aggregation link.
1405 1416  .RE
1406 1417  
1407 1418  .sp
1408 1419  .ne 2
1409 1420  .na
1410 1421  \fB\fBPORT\fR\fR
1411 1422  .ad
1412 1423  .sp .6
1413 1424  .RS 4n
1414 1425  The name of one of the underlying aggregation ports.
1415 1426  .RE
1416 1427  
1417 1428  .sp
1418 1429  .ne 2
1419 1430  .na
1420 1431  \fB\fBSPEED\fR\fR
1421 1432  .ad
1422 1433  .sp .6
1423 1434  .RS 4n
1424 1435  The speed of the link or port in megabits per second.
1425 1436  .RE
1426 1437  
1427 1438  .sp
1428 1439  .ne 2
1429 1440  .na
1430 1441  \fB\fBDUPLEX\fR\fR
1431 1442  .ad
1432 1443  .sp .6
1433 1444  .RS 4n
1434 1445  The full/half duplex status of the link or port is displayed if the link state
1435 1446  is \fBup\fR. The duplex status is displayed as \fBunknown\fR in all other
1436 1447  cases.
1437 1448  .RE
1438 1449  
1439 1450  .sp
1440 1451  .ne 2
1441 1452  .na
1442 1453  \fB\fBSTATE\fR\fR
1443 1454  .ad
1444 1455  .sp .6
1445 1456  .RS 4n
1446 1457  The link state. This can be \fBup\fR, \fBdown\fR, or \fBunknown\fR.
1447 1458  .RE
1448 1459  
1449 1460  .sp
1450 1461  .ne 2
1451 1462  .na
1452 1463  \fB\fBADDRESS\fR\fR
1453 1464  .ad
1454 1465  .sp .6
1455 1466  .RS 4n
1456 1467  The MAC address of the link or port.
1457 1468  .RE
1458 1469  
1459 1470  .sp
1460 1471  .ne 2
1461 1472  .na
1462 1473  \fB\fBPORTSTATE\fR\fR
1463 1474  .ad
1464 1475  .sp .6
1465 1476  .RS 4n
1466 1477  This indicates whether the individual aggregation port is in the \fBstandby\fR
1467 1478  or \fBattached\fR state.
1468 1479  .RE
1469 1480  
1470 1481  .RE
1471 1482  
1472 1483  .sp
1473 1484  .ne 2
1474 1485  .na
1475 1486  \fB\fB-o\fR \fIfield\fR[,...], \fB--output\fR=\fIfield\fR[,...]\fR
1476 1487  .ad
1477 1488  .sp .6
1478 1489  .RS 4n
1479 1490  A case-insensitive, comma-separated list of output fields to display. The field
1480 1491  name must be one of the fields listed above, or the special value \fBall\fR, to
1481 1492  display all fields. The fields applicable to the \fB-o\fR option are limited to
1482 1493  those listed under each output mode. For example, if using \fB-L\fR, only the
1483 1494  fields listed under \fB-L\fR, above, can be used with \fB-o\fR.
1484 1495  .RE
1485 1496  
1486 1497  .sp
1487 1498  .ne 2
1488 1499  .na
1489 1500  \fB\fB-p\fR, \fB--parseable\fR\fR
1490 1501  .ad
1491 1502  .sp .6
1492 1503  .RS 4n
1493 1504  Display using a stable machine-parseable format. The \fB-o\fR option is
1494 1505  required with \fB-p\fR. See "Parseable Output Format", below.
1495 1506  .RE
1496 1507  
1497 1508  .sp
1498 1509  .ne 2
1499 1510  .na
1500 1511  \fB\fB-P\fR, \fB--persistent\fR\fR
1501 1512  .ad
1502 1513  .sp .6
1503 1514  .RS 4n
1504 1515  Display the persistent aggregation configuration rather than the state of the
1505 1516  running system.
1506 1517  .RE
1507 1518  
1508 1519  .sp
1509 1520  .ne 2
1510 1521  .na
1511 1522  \fB\fB-s\fR, \fB--statistics\fR\fR
1512 1523  .ad
1513 1524  .sp .6
1514 1525  .RS 4n
1515 1526  Displays aggregation statistics.
1516 1527  .RE
1517 1528  
1518 1529  .sp
1519 1530  .ne 2
1520 1531  .na
1521 1532  \fB\fB-i\fR \fIinterval\fR, \fB--interval\fR=\fIinterval\fR\fR
1522 1533  .ad
1523 1534  .sp .6
1524 1535  .RS 4n
1525 1536  Used with the \fB-s\fR option to specify an interval, in seconds, at which
1526 1537  statistics should be displayed. If this option is not specified, statistics
1527 1538  will be displayed only once.
1528 1539  .RE
1529 1540  
1530 1541  .RE
1531 1542  
1532 1543  .sp
1533 1544  .ne 2
1534 1545  .na
1535 1546  \fB\fBdladm create-bridge\fR [ \fB-P\fR \fIprotect\fR] [\fB-R\fR
1536 1547  \fIroot-dir\fR] [ \fB-p\fR \fIpriority\fR] [ \fB-m\fR \fImax-age\fR] [ \fB-h\fR
1537 1548  \fIhello-time\fR] [ \fB-d\fR \fIforward-delay\fR] [ \fB-f\fR
1538 1549  \fIforce-protocol\fR] [\fB-l\fR \fIlink\fR...] \fIbridge-name\fR\fR
1539 1550  .ad
1540 1551  .sp .6
1541 1552  .RS 4n
1542 1553  Create an 802.1D bridge instance and optionally assign one or more network
1543 1554  links to the new bridge. By default, no bridge instances are present on the
1544 1555  system.
1545 1556  .sp
1546 1557  In order to bridge between links, you must create at least one bridge instance.
1547 1558  Each bridge instance is separate, and there is no forwarding connection between
1548 1559  bridges.
1549 1560  .sp
1550 1561  .ne 2
1551 1562  .na
1552 1563  \fB\fB-P\fR \fIprotect\fR, \fB--protect\fR=\fIprotect\fR\fR
1553 1564  .ad
1554 1565  .sp .6
1555 1566  .RS 4n
1556 1567  Specifies a protection method. The defined protection methods are \fBstp\fR for
1557 1568  the Spanning Tree Protocol and trill for \fBTRILL\fR, which is used on
1558 1569  RBridges. The default value is \fBstp\fR.
1559 1570  .RE
1560 1571  
1561 1572  .sp
1562 1573  .ne 2
1563 1574  .na
1564 1575  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
1565 1576  .ad
1566 1577  .sp .6
1567 1578  .RS 4n
1568 1579  See "Options," above.
1569 1580  .RE
1570 1581  
1571 1582  .sp
1572 1583  .ne 2
1573 1584  .na
1574 1585  \fB\fB-p\fR \fIpriority\fR, \fB--priority\fR=\fIpriority\fR\fR
1575 1586  .ad
1576 1587  .sp .6
1577 1588  .RS 4n
1578 1589  Specifies the Bridge Priority. This sets the IEEE STP priority value for
1579 1590  determining the root bridge node in the network. The default value is
1580 1591  \fB32768\fR. Valid values are \fB0\fR (highest priority) to \fB61440\fR (lowest
1581 1592  priority), in increments of 4096.
1582 1593  .sp
1583 1594  If a value not evenly divisible by 4096 is used, the system silently rounds
1584 1595  downward to the next lower value that is divisible by 4096.
1585 1596  .RE
1586 1597  
1587 1598  .sp
1588 1599  .ne 2
1589 1600  .na
1590 1601  \fB\fB-m\fR \fImax-age\fR, \fB--max-age\fR=\fImax-age\fR\fR
1591 1602  .ad
1592 1603  .sp .6
1593 1604  .RS 4n
1594 1605  Specifies the maximum age for configuration information in seconds. This sets
1595 1606  the STP Bridge Max Age parameter. This value is used for all nodes in the
1596 1607  network if this node is the root bridge. Bridge link information older than
1597 1608  this time is discarded. It defaults to 20 seconds. Valid values are from 6 to
1598 1609  40 seconds. See the \fB-d\fR \fIforward-delay\fR parameter for additional
1599 1610  constraints.
1600 1611  .RE
1601 1612  
1602 1613  .sp
1603 1614  .ne 2
1604 1615  .na
1605 1616  \fB\fB-h\fR \fIhello-time\fR, \fB--hello-time\fR=\fIhello-time\fR\fR
1606 1617  .ad
1607 1618  .sp .6
1608 1619  .RS 4n
1609 1620  Specifies the STP Bridge Hello Time parameter. When this node is the root node,
1610 1621  it sends Configuration BPDUs at this interval throughout the network. The
1611 1622  default value is 2 seconds. Valid values are from 1 to 10 seconds. See the
1612 1623  \fB-d\fR \fIforward-delay\fR parameter for additional constraints.
1613 1624  .RE
1614 1625  
1615 1626  .sp
1616 1627  .ne 2
1617 1628  .na
1618 1629  \fB\fB-d\fR \fIforward-delay\fR, \fB--forward-delay\fR=\fIforward-delay\fR\fR
1619 1630  .ad
1620 1631  .sp .6
1621 1632  .RS 4n
1622 1633  Specifies the STP Bridge Forward Delay parameter. When this node is the root
1623 1634  node, then all bridges in the network use this timer to sequence the link
1624 1635  states when a port is enabled. The default value is 15 seconds. Valid values
1625 1636  are from 4 to 30 seconds.
1626 1637  .sp
1627 1638  Bridges must obey the following two constraints:
1628 1639  .sp
1629 1640  .in +2
1630 1641  .nf
1631 1642  2 * (\fIforward-delay\fR - 1.0) >= \fImax-age\fR
1632 1643  
1633 1644  \fImax-age\fR >= 2 * (\fIhello-time\fR + 1.0)
1634 1645  .fi
1635 1646  .in -2
1636 1647  .sp
1637 1648  
1638 1649  Any parameter setting that would violate those constraints is treated as an
1639 1650  error and causes the command to fail with a diagnostic message. The message
1640 1651  provides valid alternatives to the supplied values.
1641 1652  .RE
1642 1653  
1643 1654  .sp
1644 1655  .ne 2
1645 1656  .na
1646 1657  \fB\fB-f\fR \fIforce-protocol\fR,
1647 1658  \fB--force-protocol\fR=\fIforce-protocol\fR\fR
1648 1659  .ad
1649 1660  .sp .6
1650 1661  .RS 4n
1651 1662  Specifies the MSTP forced maximum supported protocol. The default value is 3.
1652 1663  Valid values are non-negative integers. The current implementation does not
1653 1664  support RSTP or MSTP, so this currently has no effect. However, to prevent MSTP
1654 1665  from being used in the future, the parameter may be set to \fB0\fR for STP only
1655 1666  or \fB2\fR for STP and RSTP.
1656 1667  .RE
1657 1668  
1658 1669  .sp
1659 1670  .ne 2
1660 1671  .na
1661 1672  \fB\fB-l\fR \fIlink\fR, \fB--link\fR=\fIlink\fR\fR
1662 1673  .ad
1663 1674  .sp .6
1664 1675  .RS 4n
1665 1676  Specifies one or more links to add to the newly-created bridge. This is similar
1666 1677  to creating the bridge and then adding one or more links, as with the
1667 1678  \fBadd-bridge\fR subcommand. However, if any of the links cannot be added, the
1668 1679  entire command fails, and the new bridge itself is not created. To add multiple
1669 1680  links on the same command line, repeat this option for each link. You are
1670 1681  permitted to create bridges without links. For more information about link
1671 1682  assignments, see the \fBadd-bridge\fR subcommand.
1672 1683  .RE
1673 1684  
1674 1685  Bridge creation and link assignment require the \fBPRIV_SYS_DL_CONFIG\fR
1675 1686  privilege. Bridge creation might fail if the optional bridging feature is not
1676 1687  installed on the system.
1677 1688  .RE
1678 1689  
1679 1690  .sp
1680 1691  .ne 2
1681 1692  .na
1682 1693  \fB\fBdladm modify-bridge\fR [ \fB-P\fR \fIprotect\fR] [\fB-R\fR
1683 1694  \fIroot-dir\fR] [ \fB-p\fR \fIpriority\fR] [ \fB-m\fR \fImax-age\fR] [ \fB-h\fR
1684 1695  \fIhello-time\fR] [ \fB-d\fR \fIforward-delay\fR] [ \fB-f\fR
1685 1696  \fIforce-protocol\fR] [\fB-l\fR \fIlink\fR...] \fIbridge-name\fR\fR
1686 1697  .ad
1687 1698  .sp .6
1688 1699  .RS 4n
1689 1700  Modify the operational parameters of an existing bridge. The options are the
1690 1701  same as for the \fBcreate-bridge\fR subcommand, except that the \fB-l\fR option
1691 1702  is not permitted. To add links to an existing bridge, use the \fBadd-bridge\fR
1692 1703  subcommand.
1693 1704  .sp
1694 1705  Bridge parameter modification requires the \fBPRIV_SYS_DL_CONFIG\fR privilege.
1695 1706  .RE
1696 1707  
1697 1708  .sp
1698 1709  .ne 2
1699 1710  .na
1700 1711  \fB\fBdladm delete-bridge\fR [\fB-R\fR \fIroot-dir\fR] \fIbridge-name\fR\fR
1701 1712  .ad
1702 1713  .sp .6
1703 1714  .RS 4n
1704 1715  Delete a bridge instance. The bridge being deleted must not have any attached
1705 1716  links. Use the \fBremove-bridge\fR subcommand to deactivate links before
1706 1717  deleting a bridge.
1707 1718  .sp
1708 1719  Bridge deletion requires the \fBPRIV_SYS_DL_CONFIG\fR privilege.
1709 1720  .sp
1710 1721  The \fB-R\fR (\fB--root-dir\fR) option is the same as for the
1711 1722  \fBcreate-bridge\fR subcommand.
1712 1723  .RE
1713 1724  
1714 1725  .sp
1715 1726  .ne 2
1716 1727  .na
1717 1728  \fB\fBdladm add-bridge\fR [\fB-R\fR \fIroot-dir\fR] \fB-l\fR \fIlink\fR
1718 1729  [\fB-l\fR \fIlink\fR...] \fIbridge-name\fR\fR
1719 1730  .ad
1720 1731  .sp .6
1721 1732  .RS 4n
1722 1733  Add one or more links to an existing bridge. If multiple links are specified,
1723 1734  and adding any one of them results in an error, the command fails and no
1724 1735  changes are made to the system.
1725 1736  .sp
1726 1737  Link addition to a bridge requires the \fBPRIV_SYS_DL_CONFIG\fR privilege.
1727 1738  .sp
1728 1739  A link may be a member of at most one bridge. An error occurs when you attempt
1729 1740  to add a link that already belongs to another bridge. To move a link from one
1730 1741  bridge instance to another, remove it from the current bridge before adding it
1731 1742  to a new one.
1732 1743  .sp
1733 1744  The links assigned to a bridge must not also be VLANs, VNICs, or tunnels. Only
1734 1745  physical Ethernet datalinks, aggregation datalinks, wireless links, and
1735 1746  Ethernet stubs are permitted to be assigned to a bridge.
1736 1747  .sp
1737 1748  Links assigned to a bridge must all have the same MTU. This is checked when the
1738 1749  link is assigned. The link is added to the bridge in a deactivated form if it
1739 1750  is not the first link on the bridge and it has a differing MTU.
1740 1751  .sp
1741 1752  Note that systems using bridging should not set the \fBeeprom\fR(1M)
1742 1753  \fBlocal-mac-address?\fR variable to false.
1743 1754  .sp
1744 1755  The options are the same as for the \fBcreate-bridge\fR subcommand.
1745 1756  .RE
1746 1757  
1747 1758  .sp
1748 1759  .ne 2
1749 1760  .na
1750 1761  \fB\fBdladm remove-bridge\fR [\fB-R\fR \fIroot-dir\fR] \fB-l\fR \fIlink\fR
1751 1762  [\fB-l\fR \fIlink\fR...] \fIbridge-name\fR\fR
1752 1763  .ad
1753 1764  .sp .6
1754 1765  .RS 4n
1755 1766  Remove one or more links from a bridge instance. If multiple links are
1756 1767  specified, and removing any one of them would result in an error, the command
1757 1768  fails and none are removed.
1758 1769  .sp
1759 1770  Link removal from a bridge requires the \fBPRIV_SYS_DL_CONFIG\fR privilege.
1760 1771  .sp
1761 1772  The options are the same as for the \fBcreate-bridge\fR subcommand.
1762 1773  .RE
1763 1774  
1764 1775  .sp
1765 1776  .ne 2
1766 1777  .na
1767 1778  \fB\fBdladm show-bridge\fR [\fB-flt\fR] [\fB-s\fR [\fB-i\fR \fIinterval\fR]]
1768 1779  [[\fB-p\fR] \fB-o\fR \fIfield\fR,...] [\fIbridge-name\fR]\fR
1769 1780  .ad
1770 1781  .sp .6
1771 1782  .RS 4n
1772 1783  Show the running status and configuration of bridges, their attached links,
1773 1784  learned forwarding entries, and \fBTRILL\fR nickname databases. When showing
1774 1785  overall bridge status and configuration, the bridge name can be omitted to show
1775 1786  all bridges. The other forms require a specified bridge.
1776 1787  .sp
1777 1788  The show-bridge subcommand accepts the following options:
1778 1789  .sp
1779 1790  .ne 2
1780 1791  .na
1781 1792  \fB\fB-i\fR \fIinterval\fR, \fB--interval\fR=\fIinterval\fR\fR
1782 1793  .ad
1783 1794  .sp .6
1784 1795  .RS 4n
1785 1796  Used with the \fB-s\fR option to specify an interval, in seconds, at which
1786 1797  statistics should be displayed. If this option is not specified, statistics
1787 1798  will be displayed only once.
1788 1799  .RE
1789 1800  
1790 1801  .sp
1791 1802  .ne 2
1792 1803  .na
1793 1804  \fB\fB-s\fR, \fB--statistics\fR\fR
1794 1805  .ad
1795 1806  .sp .6
1796 1807  .RS 4n
1797 1808  Display statistics for the specified bridges or for a given bridge's attached
1798 1809  links. This option cannot be used with the \fB-f\fR and \fB-t\fR options.
1799 1810  .RE
1800 1811  
1801 1812  .sp
1802 1813  .ne 2
1803 1814  .na
1804 1815  \fB\fB-p\fR, \fB--parseable\fR\fR
1805 1816  .ad
1806 1817  .sp .6
1807 1818  .RS 4n
1808 1819  Display using a stable machine-parsable format. See "Parsable Output Format,"
1809 1820  below.
1810 1821  .RE
1811 1822  
1812 1823  .sp
1813 1824  .ne 2
1814 1825  .na
1815 1826  \fB\fB-o\fR \fIfield\fR[,...], \fB--output\fR=\fIfield\fR[,...]\fR
1816 1827  .ad
1817 1828  .sp .6
1818 1829  .RS 4n
1819 1830  A case-insensitive, comma-separated list of output fields to display. The field
1820 1831  names are described below. The special value all displays all fields. Each set
1821 1832  of fields has its own default set to display when \fB-o\fR is not specified.
1822 1833  .RE
1823 1834  
1824 1835  By default, the \fBshow-bridge\fR subcommand shows bridge configuration. The
1825 1836  following fields can be shown:
1826 1837  .sp
1827 1838  .ne 2
1828 1839  .na
1829 1840  \fB\fBBRIDGE\fR\fR
1830 1841  .ad
1831 1842  .sp .6
1832 1843  .RS 4n
1833 1844  The name of the bridge.
1834 1845  .RE
1835 1846  
1836 1847  .sp
1837 1848  .ne 2
1838 1849  .na
1839 1850  \fB\fBADDRESS\fR\fR
1840 1851  .ad
1841 1852  .sp .6
1842 1853  .RS 4n
1843 1854  The Bridge Unique Identifier value (MAC address).
1844 1855  .RE
1845 1856  
1846 1857  .sp
1847 1858  .ne 2
1848 1859  .na
1849 1860  \fB\fBPRIORITY\fR\fR
1850 1861  .ad
1851 1862  .sp .6
1852 1863  .RS 4n
1853 1864  Configured priority value; set by \fB-p\fR with \fBcreate-bridge\fR and
1854 1865  \fBmodify-bridge\fR.
1855 1866  .RE
1856 1867  
1857 1868  .sp
1858 1869  .ne 2
1859 1870  .na
1860 1871  \fB\fBBMAXAGE\fR\fR
1861 1872  .ad
1862 1873  .sp .6
1863 1874  .RS 4n
1864 1875  Configured bridge maximum age; set by \fB-m\fR with \fBcreate-bridge\fR and
1865 1876  \fBmodify-bridge\fR.
1866 1877  .RE
1867 1878  
1868 1879  .sp
1869 1880  .ne 2
1870 1881  .na
1871 1882  \fB\fBBHELLOTIME\fR\fR
1872 1883  .ad
1873 1884  .sp .6
1874 1885  .RS 4n
1875 1886  Configured bridge hello time; set by \fB-h\fR with \fBcreate-bridge\fR and
1876 1887  \fBmodify-bridge\fR.
1877 1888  .RE
1878 1889  
1879 1890  .sp
1880 1891  .ne 2
1881 1892  .na
1882 1893  \fB\fBBFWDDELAY\fR\fR
1883 1894  .ad
1884 1895  .sp .6
1885 1896  .RS 4n
1886 1897  Configured forwarding delay; set by \fB-d\fR with \fBcreate-bridge\fR and
1887 1898  \fBmodify-bridge\fR.
1888 1899  .RE
1889 1900  
1890 1901  .sp
1891 1902  .ne 2
1892 1903  .na
1893 1904  \fB\fBFORCEPROTO\fR\fR
1894 1905  .ad
1895 1906  .sp .6
1896 1907  .RS 4n
1897 1908  Configured forced maximum protocol; set by \fB-f\fR with \fBcreate-bridge\fR
1898 1909  and \fBmodify-bridge\fR.
1899 1910  .RE
1900 1911  
1901 1912  .sp
1902 1913  .ne 2
1903 1914  .na
1904 1915  \fB\fBTCTIME\fR\fR
1905 1916  .ad
1906 1917  .sp .6
1907 1918  .RS 4n
1908 1919  Time, in seconds, since last topology change.
1909 1920  .RE
1910 1921  
1911 1922  .sp
1912 1923  .ne 2
1913 1924  .na
1914 1925  \fB\fBTCCOUNT\fR\fR
1915 1926  .ad
1916 1927  .sp .6
1917 1928  .RS 4n
1918 1929  Count of the number of topology changes.
1919 1930  .RE
1920 1931  
1921 1932  .sp
1922 1933  .ne 2
1923 1934  .na
1924 1935  \fB\fBTCHANGE\fR\fR
1925 1936  .ad
1926 1937  .sp .6
1927 1938  .RS 4n
1928 1939  This indicates that a topology change was detected.
1929 1940  .RE
1930 1941  
1931 1942  .sp
1932 1943  .ne 2
1933 1944  .na
1934 1945  \fB\fBDESROOT\fR\fR
1935 1946  .ad
1936 1947  .sp .6
1937 1948  .RS 4n
1938 1949  Bridge Identifier of the root node.
1939 1950  .RE
1940 1951  
1941 1952  .sp
1942 1953  .ne 2
1943 1954  .na
1944 1955  \fB\fBROOTCOST\fR\fR
1945 1956  .ad
1946 1957  .sp .6
1947 1958  .RS 4n
1948 1959  Cost of the path to the root node.
1949 1960  .RE
1950 1961  
1951 1962  .sp
1952 1963  .ne 2
1953 1964  .na
1954 1965  \fB\fBROOTPORT\fR\fR
1955 1966  .ad
1956 1967  .sp .6
1957 1968  .RS 4n
1958 1969  Port number used to reach the root node.
1959 1970  .RE
1960 1971  
1961 1972  .sp
1962 1973  .ne 2
1963 1974  .na
1964 1975  \fB\fBMAXAGE\fR\fR
1965 1976  .ad
1966 1977  .sp .6
1967 1978  .RS 4n
1968 1979  Maximum age value from the root node.
1969 1980  .RE
1970 1981  
1971 1982  .sp
1972 1983  .ne 2
1973 1984  .na
1974 1985  \fB\fBHELLOTIME\fR\fR
1975 1986  .ad
1976 1987  .sp .6
1977 1988  .RS 4n
1978 1989  Hello time value from the root node.
1979 1990  .RE
1980 1991  
1981 1992  .sp
1982 1993  .ne 2
1983 1994  .na
1984 1995  \fB\fBFWDDELAY\fR\fR
1985 1996  .ad
1986 1997  .sp .6
1987 1998  .RS 4n
1988 1999  Forward delay value from the root node.
1989 2000  .RE
1990 2001  
1991 2002  .sp
1992 2003  .ne 2
1993 2004  .na
1994 2005  \fB\fBHOLDTIME\fR\fR
1995 2006  .ad
1996 2007  .sp .6
1997 2008  .RS 4n
1998 2009  Minimum BPDU interval.
1999 2010  .RE
2000 2011  
2001 2012  By default, when the \fB-o\fR option is not specified, only the \fBBRIDGE\fR,
2002 2013  \fBADDRESS\fR, \fBPRIORITY\fR, and \fBDESROOT\fR fields are shown.
2003 2014  .sp
2004 2015  When the \fB-s\fR option is specified, the \fBshow-bridge\fR subcommand shows
2005 2016  bridge statistics. The following fields can be shown:
2006 2017  .sp
2007 2018  .ne 2
2008 2019  .na
2009 2020  \fB\fBBRIDGE\fR\fR
2010 2021  .ad
2011 2022  .sp .6
2012 2023  .RS 4n
2013 2024  Bridge name.
2014 2025  .RE
2015 2026  
2016 2027  .sp
2017 2028  .ne 2
2018 2029  .na
2019 2030  \fB\fBDROPS\fR\fR
2020 2031  .ad
2021 2032  .sp .6
2022 2033  .RS 4n
2023 2034  Number of packets dropped due to resource problems.
2024 2035  .RE
2025 2036  
2026 2037  .sp
2027 2038  .ne 2
2028 2039  .na
2029 2040  \fB\fBFORWARDS\fR\fR
2030 2041  .ad
2031 2042  .sp .6
2032 2043  .RS 4n
2033 2044  Number of packets forwarded from one link to another.
2034 2045  .RE
2035 2046  
2036 2047  .sp
2037 2048  .ne 2
2038 2049  .na
2039 2050  \fB\fBMBCAST\fR\fR
2040 2051  .ad
2041 2052  .sp .6
2042 2053  .RS 4n
2043 2054  Number of multicast and broadcast packets handled by the bridge.
2044 2055  .RE
2045 2056  
2046 2057  .sp
2047 2058  .ne 2
2048 2059  .na
2049 2060  \fB\fBRECV\fR\fR
2050 2061  .ad
2051 2062  .sp .6
2052 2063  .RS 4n
2053 2064  Number of packets received on all attached links.
2054 2065  .RE
2055 2066  
2056 2067  .sp
2057 2068  .ne 2
2058 2069  .na
2059 2070  \fB\fBSENT\fR\fR
2060 2071  .ad
2061 2072  .sp .6
2062 2073  .RS 4n
2063 2074  Number of packets sent on all attached links.
2064 2075  .RE
2065 2076  
2066 2077  .sp
2067 2078  .ne 2
2068 2079  .na
2069 2080  \fB\fBUNKNOWN\fR\fR
2070 2081  .ad
2071 2082  .sp .6
2072 2083  .RS 4n
2073 2084  Number of packets handled that have an unknown destination. Such packets are
2074 2085  sent to all links.
2075 2086  .RE
2076 2087  
2077 2088  By default, when the \fB-o\fR option is not specified, only the \fBBRIDGE\fR,
2078 2089  \fBDROPS\fR, and \fBFORWARDS\fR fields are shown.
2079 2090  .sp
2080 2091  The \fBshow-bridge\fR subcommand also accepts the following options:
2081 2092  .sp
2082 2093  .ne 2
2083 2094  .na
2084 2095  \fB\fB-l\fR, \fB--link\fR\fR
2085 2096  .ad
2086 2097  .sp .6
2087 2098  .RS 4n
2088 2099  Displays link-related status and statistics information for all links attached
2089 2100  to a single bridge instance. By using this option and without the \fB-s\fR
2090 2101  option, the following fields can be displayed for each link:
2091 2102  .sp
2092 2103  .ne 2
2093 2104  .na
2094 2105  \fB\fBLINK\fR\fR
2095 2106  .ad
2096 2107  .sp .6
2097 2108  .RS 4n
2098 2109  The link name.
2099 2110  .RE
2100 2111  
2101 2112  .sp
2102 2113  .ne 2
2103 2114  .na
2104 2115  \fB\fBINDEX\fR\fR
2105 2116  .ad
2106 2117  .sp .6
2107 2118  .RS 4n
2108 2119  Port (link) index number on the bridge.
2109 2120  .RE
2110 2121  
2111 2122  .sp
2112 2123  .ne 2
2113 2124  .na
2114 2125  \fB\fBSTATE\fR\fR
2115 2126  .ad
2116 2127  .sp .6
2117 2128  .RS 4n
2118 2129  State of the link. The state can be \fBdisabled\fR, \fBdiscarding\fR,
2119 2130  \fBlearning\fR, \fBforwarding\fR, \fBnon-stp\fR, or \fBbad-mtu\fR.
2120 2131  .RE
2121 2132  
2122 2133  .sp
2123 2134  .ne 2
2124 2135  .na
2125 2136  \fB\fBUPTIME\fR\fR
2126 2137  .ad
2127 2138  .sp .6
2128 2139  .RS 4n
2129 2140  Number of seconds since the last reset or initialization.
2130 2141  .RE
2131 2142  
2132 2143  .sp
2133 2144  .ne 2
2134 2145  .na
2135 2146  \fB\fBOPERCOST\fR\fR
2136 2147  .ad
2137 2148  .sp .6
2138 2149  .RS 4n
2139 2150  Actual cost in use (1-65535).
2140 2151  .RE
2141 2152  
2142 2153  .sp
2143 2154  .ne 2
2144 2155  .na
2145 2156  \fB\fBOPERP2P\fR\fR
2146 2157  .ad
2147 2158  .sp .6
2148 2159  .RS 4n
2149 2160  This indicates whether point-to-point (\fBP2P\fR) mode been detected.
2150 2161  .RE
2151 2162  
2152 2163  .sp
2153 2164  .ne 2
2154 2165  .na
2155 2166  \fB\fBOPEREDGE\fR\fR
2156 2167  .ad
2157 2168  .sp .6
2158 2169  .RS 4n
2159 2170  This indicates whether edge mode has been detected.
2160 2171  .RE
2161 2172  
2162 2173  .sp
2163 2174  .ne 2
2164 2175  .na
2165 2176  \fB\fBDESROOT\fR\fR
2166 2177  .ad
2167 2178  .sp .6
2168 2179  .RS 4n
2169 2180  The Root Bridge Identifier that has been seen on this port.
2170 2181  .RE
2171 2182  
2172 2183  .sp
2173 2184  .ne 2
2174 2185  .na
2175 2186  \fB\fBDESCOST\fR\fR
2176 2187  .ad
2177 2188  .sp .6
2178 2189  .RS 4n
2179 2190  Path cost to the network root node through the designated port.
2180 2191  .RE
2181 2192  
2182 2193  .sp
2183 2194  .ne 2
2184 2195  .na
2185 2196  \fB\fBDESBRIDGE\fR\fR
2186 2197  .ad
2187 2198  .sp .6
2188 2199  .RS 4n
2189 2200  Bridge Identifier for this port.
2190 2201  .RE
2191 2202  
2192 2203  .sp
2193 2204  .ne 2
2194 2205  .na
2195 2206  \fB\fBDESPORT\fR\fR
2196 2207  .ad
2197 2208  .sp .6
2198 2209  .RS 4n
2199 2210  The ID and priority of the port used to transmit configuration messages for
2200 2211  this port.
2201 2212  .RE
2202 2213  
2203 2214  .sp
2204 2215  .ne 2
2205 2216  .na
2206 2217  \fB\fBTCACK\fR\fR
2207 2218  .ad
2208 2219  .sp .6
2209 2220  .RS 4n
2210 2221  This indicates whether Topology Change Acknowledge has been seen.
2211 2222  .RE
2212 2223  
2213 2224  When the \fB-l\fR option is specified without the \fB-o\fR option, only the
2214 2225  \fBLINK\fR, \fBSTATE\fR, \fBUPTIME\fR, and \fBDESROOT\fR fields are shown.
2215 2226  .sp
2216 2227  When the \fB-l\fR option is specified, the \fB-s\fR option can be used to
2217 2228  display the following fields for each link:
2218 2229  .sp
2219 2230  .ne 2
2220 2231  .na
2221 2232  \fB\fBLINK\fR\fR
2222 2233  .ad
2223 2234  .sp .6
2224 2235  .RS 4n
2225 2236  Link name.
2226 2237  .RE
2227 2238  
2228 2239  .sp
2229 2240  .ne 2
2230 2241  .na
2231 2242  \fB\fBCFGBPDU\fR\fR
2232 2243  .ad
2233 2244  .sp .6
2234 2245  .RS 4n
2235 2246  Number of configuration BPDUs received.
2236 2247  .RE
2237 2248  
2238 2249  .sp
2239 2250  .ne 2
2240 2251  .na
2241 2252  \fB\fBTCNBPDU\fR\fR
2242 2253  .ad
2243 2254  .sp .6
2244 2255  .RS 4n
2245 2256  Number of topology change BPDUs received.
2246 2257  .RE
2247 2258  
2248 2259  .sp
2249 2260  .ne 2
2250 2261  .na
2251 2262  \fB\fBRSTPBPDU\fR\fR
2252 2263  .ad
2253 2264  .sp .6
2254 2265  .RS 4n
2255 2266  Number of Rapid Spanning Tree BPDUs received.
2256 2267  .RE
2257 2268  
2258 2269  .sp
2259 2270  .ne 2
2260 2271  .na
2261 2272  \fB\fBTXBPDU\fR\fR
2262 2273  .ad
2263 2274  .sp .6
2264 2275  .RS 4n
2265 2276  Number of BPDUs transmitted.
2266 2277  .RE
2267 2278  
2268 2279  .sp
2269 2280  .ne 2
2270 2281  .na
2271 2282  \fB\fBDROPS\fR\fR
2272 2283  .ad
2273 2284  .sp .6
2274 2285  .RS 4n
2275 2286  Number of packets dropped due to resource problems.
2276 2287  .RE
2277 2288  
2278 2289  .sp
2279 2290  .ne 2
2280 2291  .na
2281 2292  \fB\fBRECV\fR\fR
2282 2293  .ad
2283 2294  .sp .6
2284 2295  .RS 4n
2285 2296  Number of packets received by the bridge.
2286 2297  .RE
2287 2298  
2288 2299  .sp
2289 2300  .ne 2
2290 2301  .na
2291 2302  \fB\fBXMIT\fR\fR
2292 2303  .ad
2293 2304  .sp .6
2294 2305  .RS 4n
2295 2306  Number of packets sent by the bridge.
2296 2307  .RE
2297 2308  
2298 2309  When the \fB-o\fR option is not specified, only the \fBLINK\fR, \fBDROPS\fR,
2299 2310  \fBRECV\fR, and \fBXMIT\fR fields are shown.
2300 2311  .RE
2301 2312  
2302 2313  .sp
2303 2314  .ne 2
2304 2315  .na
2305 2316  \fB\fB-f\fR, \fB--forwarding\fR\fR
2306 2317  .ad
2307 2318  .sp .6
2308 2319  .RS 4n
2309 2320  Displays forwarding entries for a single bridge instance. With this option, the
2310 2321  following fields can be shown for each forwarding entry:
2311 2322  .sp
2312 2323  .ne 2
2313 2324  .na
2314 2325  \fB\fBDEST\fR\fR
2315 2326  .ad
2316 2327  .sp .6
2317 2328  .RS 4n
2318 2329  Destination MAC address.
2319 2330  .RE
2320 2331  
2321 2332  .sp
2322 2333  .ne 2
2323 2334  .na
2324 2335  \fB\fBAGE\fR\fR
2325 2336  .ad
2326 2337  .sp .6
2327 2338  .RS 4n
2328 2339  Age of entry in seconds and milliseconds. Omitted for local entries.
2329 2340  .RE
2330 2341  
2331 2342  .sp
2332 2343  .ne 2
2333 2344  .na
2334 2345  \fB\fBFLAGS\fR\fR
2335 2346  .ad
2336 2347  .sp .6
2337 2348  .RS 4n
2338 2349  The \fBL\fR (local) flag is shown if the MAC address belongs to an attached
2339 2350  link or to a VNIC on one of the attached links.
2340 2351  .RE
2341 2352  
2342 2353  .sp
2343 2354  .ne 2
2344 2355  .na
2345 2356  \fB\fBOUTPUT\fR\fR
2346 2357  .ad
2347 2358  .sp .6
2348 2359  .RS 4n
2349 2360  For local entries, this is the name of the attached link that has the MAC
2350 2361  address. Otherwise, for bridges that use Spanning Tree Protocol, this is the
2351 2362  output interface name. For RBridges, this is the output \fBTRILL\fR nickname.
2352 2363  .RE
2353 2364  
2354 2365  When the \fB-o\fR option is not specified, the \fBDEST\fR, \fBAGE\fR,
2355 2366  \fBFLAGS\fR, and \fBOUTPUT\fR fields are shown.
2356 2367  .RE
2357 2368  
2358 2369  .sp
2359 2370  .ne 2
2360 2371  .na
2361 2372  \fB\fB-t\fR, \fB--trill\fR\fR
2362 2373  .ad
2363 2374  .sp .6
2364 2375  .RS 4n
2365 2376  Displays \fBTRILL\fR nickname entries for a single bridge instance. With this
2366 2377  option, the following fields can be shown for each \fBTRILL\fR nickname entry:
2367 2378  .sp
2368 2379  .ne 2
2369 2380  .na
2370 2381  \fB\fBNICK\fR\fR
2371 2382  .ad
2372 2383  .sp .6
2373 2384  .RS 4n
2374 2385  \fBTRILL\fR nickname for this RBridge, which is a number from 1 to 65535.
2375 2386  .RE
2376 2387  
2377 2388  .sp
2378 2389  .ne 2
2379 2390  .na
2380 2391  \fB\fBFLAGS\fR\fR
2381 2392  .ad
2382 2393  .sp .6
2383 2394  .RS 4n
2384 2395  The \fBL\fR flag is shown if the nickname identifies the local system.
2385 2396  .RE
2386 2397  
2387 2398  .sp
2388 2399  .ne 2
2389 2400  .na
2390 2401  \fB\fBLINK\fR\fR
2391 2402  .ad
2392 2403  .sp .6
2393 2404  .RS 4n
2394 2405  Link name for output when sending messages to this RBridge.
2395 2406  .RE
2396 2407  
2397 2408  .sp
2398 2409  .ne 2
2399 2410  .na
2400 2411  \fB\fBNEXTHOP\fR\fR
2401 2412  .ad
2402 2413  .sp .6
2403 2414  .RS 4n
2404 2415  MAC address of the next hop RBridge that is used to reach the RBridge with this
2405 2416  nickname.
2406 2417  .RE
2407 2418  
2408 2419  When the \fB-o\fR option is not specified, the \fBNICK\fR, \fBFLAGS\fR,
2409 2420  \fBLINK\fR, and \fBNEXTHOP\fR fields are shown.
2410 2421  .RE
2411 2422  
2412 2423  .RE
2413 2424  
2414 2425  .sp
2415 2426  .ne 2
2416 2427  .na
2417 2428  \fB\fBdladm create-vlan\fR [\fB-ft\fR] [\fB-R\fR \fIroot-dir\fR] \fB-l\fR
2418 2429  \fIether-link\fR \fB-v\fR \fIvid\fR [\fIvlan-link\fR]\fR
2419 2430  .ad
2420 2431  .sp .6
2421 2432  .RS 4n
2422 2433  Create a tagged VLAN link with an ID of \fIvid\fR over Ethernet link
2423 2434  \fIether-link\fR. The name of the VLAN link can be specified as
2424 2435  \fIvlan\fR-\fIlink\fR. If the name is not specified, a name will be
2425 2436  automatically generated (assuming that \fIether-link\fR is \fIname\fR\fIPPA\fR)
2426 2437  as:
2427 2438  .sp
2428 2439  .in +2
2429 2440  .nf
2430 2441  <\fIname\fR><1000 * \fIvlan-tag\fR + \fIPPA\fR>
2431 2442  .fi
2432 2443  .in -2
2433 2444  .sp
2434 2445  
2435 2446  For example, if \fIether-link\fR is \fBbge1\fR and \fIvid\fR is 2, the name
2436 2447  generated is \fBbge2001\fR.
2437 2448  .sp
2438 2449  .ne 2
2439 2450  .na
2440 2451  \fB\fB-f\fR, \fB--force\fR\fR
2441 2452  .ad
2442 2453  .sp .6
2443 2454  .RS 4n
2444 2455  Force the creation of the VLAN link. Some devices do not allow frame sizes
2445 2456  large enough to include a VLAN header. When creating a VLAN link over such a
2446 2457  device, the \fB-f\fR option is needed, and the MTU of the IP interfaces on the
2447 2458  resulting VLAN must be set to 1496 instead of 1500.
2448 2459  .RE
2449 2460  
2450 2461  .sp
2451 2462  .ne 2
2452 2463  .na
2453 2464  \fB\fB-l\fR \fIether-link\fR\fR
2454 2465  .ad
2455 2466  .sp .6
2456 2467  .RS 4n
2457 2468  Specifies Ethernet link over which VLAN is created.
2458 2469  .RE
2459 2470  
2460 2471  .sp
2461 2472  .ne 2
2462 2473  .na
2463 2474  \fB\fB-t\fR, \fB--temporary\fR\fR
2464 2475  .ad
2465 2476  .sp .6
2466 2477  .RS 4n
2467 2478  Specifies that the VLAN link is temporary. Temporary VLAN links last until the
2468 2479  next reboot.
2469 2480  .RE
2470 2481  
2471 2482  .sp
2472 2483  .ne 2
2473 2484  .na
2474 2485  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
2475 2486  .ad
2476 2487  .sp .6
2477 2488  .RS 4n
2478 2489  See "Options," above.
2479 2490  .RE
2480 2491  
2481 2492  .RE
2482 2493  
2483 2494  .sp
2484 2495  .ne 2
2485 2496  .na
2486 2497  \fB\fBdladm delete-vlan\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR]
2487 2498  \fIvlan-link\fR\fR
2488 2499  .ad
2489 2500  .sp .6
2490 2501  .RS 4n
2491 2502  Delete the VLAN link specified.
2492 2503  .sp
2493 2504  The \fBdelete-vlan\fRsubcommand accepts the following options:
2494 2505  .sp
2495 2506  .ne 2
2496 2507  .na
2497 2508  \fB\fB-t\fR, \fB--temporary\fR\fR
2498 2509  .ad
2499 2510  .sp .6
2500 2511  .RS 4n
2501 2512  Specifies that the deletion is temporary. Temporary deletions last until the
2502 2513  next reboot.
2503 2514  .RE
2504 2515  
2505 2516  .sp
2506 2517  .ne 2
2507 2518  .na
2508 2519  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
2509 2520  .ad
2510 2521  .sp .6
2511 2522  .RS 4n
2512 2523  See "Options," above.
2513 2524  .RE
2514 2525  
2515 2526  .RE
2516 2527  
2517 2528  .sp
2518 2529  .ne 2
2519 2530  .na
2520 2531  \fB\fBdladm show-vlan\fR [\fB-P\fR] [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]]
2521 2532  [\fIvlan-link\fR]\fR
2522 2533  .ad
2523 2534  .sp .6
2524 2535  .RS 4n
2525 2536  Display VLAN configuration for all VLAN links or for the specified VLAN link.
2526 2537  .sp
2527 2538  The \fBshow-vlan\fRsubcommand accepts the following options:
2528 2539  .sp
2529 2540  .ne 2
2530 2541  .na
2531 2542  \fB\fB-o\fR \fIfield\fR[,...], \fB--output\fR=\fIfield\fR[,...]\fR
2532 2543  .ad
2533 2544  .sp .6
2534 2545  .RS 4n
2535 2546  A case-insensitive, comma-separated list of output fields to display. The field
2536 2547  name must be one of the fields listed below, or the special value \fBall\fR, to
2537 2548  display all fields. For each VLAN link, the following fields can be displayed:
2538 2549  .sp
2539 2550  .ne 2
2540 2551  .na
2541 2552  \fB\fBLINK\fR\fR
2542 2553  .ad
2543 2554  .sp .6
2544 2555  .RS 4n
2545 2556  The name of the VLAN link.
2546 2557  .RE
2547 2558  
2548 2559  .sp
2549 2560  .ne 2
2550 2561  .na
2551 2562  \fB\fBVID\fR\fR
2552 2563  .ad
2553 2564  .sp .6
2554 2565  .RS 4n
2555 2566  The ID associated with the VLAN.
2556 2567  .RE
2557 2568  
2558 2569  .sp
2559 2570  .ne 2
2560 2571  .na
2561 2572  \fB\fBOVER\fR\fR
2562 2573  .ad
2563 2574  .sp .6
2564 2575  .RS 4n
2565 2576  The name of the physical link over which this VLAN is configured.
2566 2577  .RE
2567 2578  
2568 2579  .sp
2569 2580  .ne 2
2570 2581  .na
2571 2582  \fB\fBFLAGS\fR\fR
2572 2583  .ad
2573 2584  .sp .6
2574 2585  .RS 4n
2575 2586  A set of flags associated with the VLAN link. Possible flags are:
2576 2587  .sp
2577 2588  .ne 2
2578 2589  .na
2579 2590  \fB\fBf\fR\fR
2580 2591  .ad
2581 2592  .sp .6
2582 2593  .RS 4n
2583 2594  The VLAN was created using the \fB-f\fR option to \fBcreate-vlan\fR.
2584 2595  .RE
2585 2596  
2586 2597  .sp
2587 2598  .ne 2
2588 2599  .na
2589 2600  \fB\fBi\fR\fR
2590 2601  .ad
2591 2602  .sp .6
2592 2603  .RS 4n
2593 2604  The VLAN was implicitly created when the DLPI link was opened. These VLAN links
2594 2605  are automatically deleted on last close of the DLPI link (for example, when the
2595 2606  IP interface associated with the VLAN link is unplumbed).
2596 2607  .RE
2597 2608  
2598 2609  Additional flags might be defined in the future.
2599 2610  .RE
2600 2611  
2601 2612  .RE
2602 2613  
2603 2614  .sp
2604 2615  .ne 2
2605 2616  .na
2606 2617  \fB\fB-p\fR, \fB--parseable\fR\fR
2607 2618  .ad
2608 2619  .sp .6
2609 2620  .RS 4n
2610 2621  Display using a stable machine-parseable format. The \fB-o\fR option is
2611 2622  required with \fB-p\fR. See "Parseable Output Format", below.
2612 2623  .RE
2613 2624  
2614 2625  .sp
2615 2626  .ne 2
2616 2627  .na
2617 2628  \fB\fB-P\fR, \fB--persistent\fR\fR
2618 2629  .ad
2619 2630  .sp .6
2620 2631  .RS 4n
2621 2632  Display the persistent VLAN configuration rather than the state of the running
2622 2633  system.
2623 2634  .RE
2624 2635  
2625 2636  .RE
2626 2637  
2627 2638  .sp
2628 2639  .ne 2
2629 2640  .na
2630 2641  \fB\fBdladm scan-wifi\fR [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]]
2631 2642  [\fIwifi-link\fR]\fR
2632 2643  .ad
2633 2644  .sp .6
2634 2645  .RS 4n
2635 2646  Scans for \fBWiFi\fR networks, either on all \fBWiFi\fR links, or just on the
2636 2647  specified \fIwifi-link\fR.
2637 2648  .sp
2638 2649  By default, currently all fields but \fBBSSTYPE\fR are displayed.
2639 2650  .sp
2640 2651  .ne 2
2641 2652  .na
2642 2653  \fB\fB-o\fR \fIfield\fR[,...], \fB--output\fR=\fIfield\fR[,...]\fR
2643 2654  .ad
2644 2655  .sp .6
2645 2656  .RS 4n
2646 2657  A case-insensitive, comma-separated list of output fields to display. The field
2647 2658  name must be one of the fields listed below, or the special value \fBall\fR to
2648 2659  display all fields. For each \fBWiFi\fR network found, the following fields can
2649 2660  be displayed:
2650 2661  .sp
2651 2662  .ne 2
2652 2663  .na
2653 2664  \fB\fBLINK\fR\fR
2654 2665  .ad
2655 2666  .sp .6
2656 2667  .RS 4n
2657 2668  The name of the link the \fBWiFi\fR network is on.
2658 2669  .RE
2659 2670  
2660 2671  .sp
2661 2672  .ne 2
2662 2673  .na
2663 2674  \fB\fBESSID\fR\fR
2664 2675  .ad
2665 2676  .sp .6
2666 2677  .RS 4n
2667 2678  The \fBESSID\fR (name) of the \fBWiFi\fR network.
2668 2679  .RE
2669 2680  
2670 2681  .sp
2671 2682  .ne 2
2672 2683  .na
2673 2684  \fB\fBBSSID\fR\fR
2674 2685  .ad
2675 2686  .sp .6
2676 2687  .RS 4n
2677 2688  Either the hardware address of the \fBWiFi\fR network's Access Point (for
2678 2689  \fBBSS\fR networks), or the \fBWiFi\fR network's randomly generated unique
2679 2690  token (for \fBIBSS\fR networks).
2680 2691  .RE
2681 2692  
2682 2693  .sp
2683 2694  .ne 2
2684 2695  .na
2685 2696  \fB\fBSEC\fR\fR
2686 2697  .ad
2687 2698  .sp .6
2688 2699  .RS 4n
2689 2700  Either \fBnone\fR for a \fBWiFi\fR network that uses no security, \fBwep\fR for
2690 2701  a \fBWiFi\fR network that requires WEP (Wired Equivalent Privacy), or \fBwpa\fR
2691 2702  for a WiFi network that requires WPA (Wi-Fi Protected Access).
2692 2703  .RE
2693 2704  
2694 2705  .sp
2695 2706  .ne 2
2696 2707  .na
2697 2708  \fB\fBMODE\fR\fR
2698 2709  .ad
2699 2710  .sp .6
2700 2711  .RS 4n
2701 2712  The supported connection modes: one or more of \fBa\fR, \fBb\fR, or \fBg\fR.
2702 2713  .RE
2703 2714  
2704 2715  .sp
2705 2716  .ne 2
2706 2717  .na
2707 2718  \fB\fBSTRENGTH\fR\fR
2708 2719  .ad
2709 2720  .sp .6
2710 2721  .RS 4n
2711 2722  The strength of the signal: one of \fBexcellent\fR, \fBvery good\fR,
2712 2723  \fBgood\fR, \fBweak\fR, or \fBvery weak\fR.
2713 2724  .RE
2714 2725  
2715 2726  .sp
2716 2727  .ne 2
2717 2728  .na
2718 2729  \fB\fBSPEED\fR\fR
2719 2730  .ad
2720 2731  .sp .6
2721 2732  .RS 4n
2722 2733  The maximum speed of the \fBWiFi\fR network, in megabits per second.
2723 2734  .RE
2724 2735  
2725 2736  .sp
2726 2737  .ne 2
2727 2738  .na
2728 2739  \fB\fBBSSTYPE\fR\fR
2729 2740  .ad
2730 2741  .sp .6
2731 2742  .RS 4n
2732 2743  Either \fBbss\fR for \fBBSS\fR (infrastructure) networks, or \fBibss\fR for
2733 2744  \fBIBSS\fR (ad-hoc) networks.
2734 2745  .RE
2735 2746  
2736 2747  .RE
2737 2748  
2738 2749  .sp
2739 2750  .ne 2
2740 2751  .na
2741 2752  \fB\fB-p\fR, \fB--parseable\fR\fR
2742 2753  .ad
2743 2754  .sp .6
2744 2755  .RS 4n
2745 2756  Display using a stable machine-parseable format. The \fB-o\fR option is
2746 2757  required with \fB-p\fR. See "Parseable Output Format", below.
2747 2758  .RE
2748 2759  
2749 2760  .RE
2750 2761  
2751 2762  .sp
2752 2763  .ne 2
2753 2764  .na
2754 2765  \fB\fBdladm connect-wifi\fR [\fB-e\fR \fIessid\fR] [\fB-i\fR \fIbssid\fR]
2755 2766  [\fB-k\fR \fIkey\fR,...] [\fB-s\fR \fBnone\fR | \fBwep\fR | \fBwpa\fR]
2756 2767  [\fB-a\fR \fBopen\fR|\fBshared\fR] [\fB-b\fR \fBbss\fR|\fBibss\fR] [\fB-c\fR]
2757 2768  [\fB-m\fR \fBa\fR|\fBb\fR|\fBg\fR] [\fB-T\fR \fItime\fR] [\fIwifi-link\fR]\fR
2758 2769  .ad
2759 2770  .sp .6
2760 2771  .RS 4n
2761 2772  Connects to a \fBWiFi\fR network. This consists of four steps: \fIdiscovery\fR,
2762 2773  \fIfiltration\fR, \fIprioritization\fR, and \fIassociation\fR. However, to
2763 2774  enable connections to non-broadcast \fBWiFi\fR networks and to improve
2764 2775  performance, if a \fBBSSID\fR or \fBESSID\fR is specified using the \fB-e\fR or
2765 2776  \fB-i\fR options, then the first three steps are skipped and \fBconnect-wifi\fR
2766 2777  immediately attempts to associate with a \fBBSSID\fR or \fBESSID\fR that
2767 2778  matches the rest of the provided parameters. If this association fails, but
2768 2779  there is a possibility that other networks matching the specified criteria
2769 2780  exist, then the traditional discovery process begins as specified below.
2770 2781  .sp
2771 2782  The discovery step finds all available \fBWiFi\fR networks on the specified
2772 2783  WiFi link, which must not yet be connected. For administrative convenience, if
2773 2784  there is only one \fBWiFi\fR link on the system, \fIwifi-link\fR can be
2774 2785  omitted.
2775 2786  .sp
2776 2787  Once discovery is complete, the list of networks is filtered according to the
2777 2788  value of the following options:
2778 2789  .sp
2779 2790  .ne 2
2780 2791  .na
2781 2792  \fB\fB-e\fR \fIessid,\fR \fB--essid\fR=\fIessid\fR\fR
2782 2793  .ad
2783 2794  .sp .6
2784 2795  .RS 4n
2785 2796  Networks that do not have the same \fIessid\fR are filtered out.
2786 2797  .RE
2787 2798  
2788 2799  .sp
2789 2800  .ne 2
2790 2801  .na
2791 2802  \fB\fB-b\fR \fBbss\fR|\fBibss\fR, \fB--bsstype\fR=\fBbss\fR|\fBibss\fR\fR
2792 2803  .ad
2793 2804  .sp .6
2794 2805  .RS 4n
2795 2806  Networks that do not have the same \fBbsstype\fR are filtered out.
2796 2807  .RE
2797 2808  
2798 2809  .sp
2799 2810  .ne 2
2800 2811  .na
2801 2812  \fB\fB-m\fR \fBa\fR|\fBb\fR|\fBg\fR, \fB--mode\fR=\fBa\fR|\fBb\fR|\fBg\fR\fR
2802 2813  .ad
2803 2814  .sp .6
2804 2815  .RS 4n
2805 2816  Networks not appropriate for the specified 802.11 mode are filtered out.
2806 2817  .RE
2807 2818  
2808 2819  .sp
2809 2820  .ne 2
2810 2821  .na
2811 2822  \fB\fB-k\fR \fIkey,...\fR, \fB--key\fR=\fIkey, ...\fR\fR
2812 2823  .ad
2813 2824  .sp .6
2814 2825  .RS 4n
2815 2826  Use the specified \fBsecobj\fR named by the key to connect to the network.
2816 2827  Networks not appropriate for the specified keys are filtered out.
2817 2828  .RE
2818 2829  
2819 2830  .sp
2820 2831  .ne 2
2821 2832  .na
2822 2833  \fB\fB-s\fR \fBnone\fR|\fBwep\fR|\fBwpa\fR,
2823 2834  \fB--sec\fR=\fBnone\fR|\fBwep\fR|\fBwpa\fR\fR
2824 2835  .ad
2825 2836  .sp .6
2826 2837  .RS 4n
2827 2838  Networks not appropriate for the specified security mode are filtered out.
2828 2839  .RE
2829 2840  
2830 2841  Next, the remaining networks are prioritized, first by signal strength, and
2831 2842  then by maximum speed. Finally, an attempt is made to associate with each
2832 2843  network in the list, in order, until one succeeds or no networks remain.
2833 2844  .sp
2834 2845  In addition to the options described above, the following options also control
2835 2846  the behavior of \fBconnect-wifi\fR:
2836 2847  .sp
2837 2848  .ne 2
2838 2849  .na
2839 2850  \fB\fB-a\fR \fBopen\fR|\fBshared\fR, \fB--auth\fR=\fBopen\fR|\fBshared\fR\fR
2840 2851  .ad
2841 2852  .sp .6
2842 2853  .RS 4n
2843 2854  Connect using the specified authentication mode. By default, \fBopen\fR and
2844 2855  \fBshared\fR are tried in order.
2845 2856  .RE
2846 2857  
2847 2858  .sp
2848 2859  .ne 2
2849 2860  .na
2850 2861  \fB\fB-c\fR, \fB--create-ibss\fR\fR
2851 2862  .ad
2852 2863  .sp .6
2853 2864  .RS 4n
2854 2865  Used with \fB-b ibss\fR to create a new ad-hoc network if one matching the
2855 2866  specified \fBESSID\fR cannot be found. If no \fBESSID\fR is specified, then
2856 2867  \fB-c -b ibss\fR always triggers the creation of a new ad-hoc network.
2857 2868  .RE
2858 2869  
2859 2870  .sp
2860 2871  .ne 2
2861 2872  .na
2862 2873  \fB\fB-T\fR \fItime\fR, \fB--timeout\fR=\fItime\fR\fR
2863 2874  .ad
2864 2875  .sp .6
2865 2876  .RS 4n
2866 2877  Specifies the number of seconds to wait for association to succeed. If
2867 2878  \fItime\fR is \fBforever\fR, then the associate will wait indefinitely. The
2868 2879  current default is ten seconds, but this might change in the future. Timeouts
2869 2880  shorter than the default might not succeed reliably.
2870 2881  .RE
2871 2882  
2872 2883  .sp
2873 2884  .ne 2
2874 2885  .na
2875 2886  \fB\fB-k\fR \fIkey,...\fR, \fB--key\fR=\fIkey,...\fR\fR
2876 2887  .ad
2877 2888  .sp .6
2878 2889  .RS 4n
2879 2890  In addition to the filtering previously described, the specified keys will be
2880 2891  used to secure the association. The security mode to use will be based on the
2881 2892  key class; if a security mode was explicitly specified, it must be compatible
2882 2893  with the key class. All keys must be of the same class.
2883 2894  .sp
2884 2895  For security modes that support multiple key slots, the slot to place the key
2885 2896  will be specified by a colon followed by an index. Therefore, \fB-k mykey:3\fR
2886 2897  places \fBmykey\fR in slot 3. By default, slot 1 is assumed. For security modes
2887 2898  that support multiple keys, a comma-separated list can be specified, with the
2888 2899  first key being the active key.
2889 2900  .RE
2890 2901  
2891 2902  .RE
2892 2903  
2893 2904  .sp
2894 2905  .ne 2
2895 2906  .na
2896 2907  \fB\fBdladm disconnect-wifi\fR [\fB-a\fR] [\fIwifi-link\fR]\fR
2897 2908  .ad
2898 2909  .sp .6
2899 2910  .RS 4n
2900 2911  Disconnect from one or more \fBWiFi\fR networks. If \fIwifi-link\fR specifies a
2901 2912  connected \fBWiFi\fR link, then it is disconnected. For administrative
2902 2913  convenience, if only one \fBWiFi\fR link is connected, \fIwifi-link\fR can be
2903 2914  omitted.
2904 2915  .sp
2905 2916  .ne 2
2906 2917  .na
2907 2918  \fB\fB-a\fR, \fB--all-links\fR\fR
2908 2919  .ad
2909 2920  .sp .6
2910 2921  .RS 4n
2911 2922  Disconnects from all connected links. This is primarily intended for use by
2912 2923  scripts.
2913 2924  .RE
2914 2925  
2915 2926  .RE
2916 2927  
2917 2928  .sp
2918 2929  .ne 2
2919 2930  .na
2920 2931  \fB\fBdladm show-wifi\fR [[\fB-p\fR] \fB-o\fR \fIfield\fR,...]
2921 2932  [\fIwifi-link\fR]\fR
2922 2933  .ad
2923 2934  .sp .6
2924 2935  .RS 4n
2925 2936  Shows \fBWiFi\fR configuration information either for all \fBWiFi\fR links or
2926 2937  for the specified link \fIwifi-link\fR.
2927 2938  .sp
2928 2939  .ne 2
2929 2940  .na
2930 2941  \fB\fB-o\fR \fIfield,...\fR, \fB--output\fR=\fIfield\fR\fR
2931 2942  .ad
2932 2943  .sp .6
2933 2944  .RS 4n
2934 2945  A case-insensitive, comma-separated list of output fields to display. The field
2935 2946  name must be one of the fields listed below, or the special value \fBall\fR, to
2936 2947  display all fields. For each \fBWiFi\fR link, the following fields can be
2937 2948  displayed:
2938 2949  .sp
2939 2950  .ne 2
2940 2951  .na
2941 2952  \fB\fBLINK\fR\fR
2942 2953  .ad
2943 2954  .sp .6
2944 2955  .RS 4n
2945 2956  The name of the link being displayed.
2946 2957  .RE
2947 2958  
2948 2959  .sp
2949 2960  .ne 2
2950 2961  .na
2951 2962  \fB\fBSTATUS\fR\fR
2952 2963  .ad
2953 2964  .sp .6
2954 2965  .RS 4n
2955 2966  Either \fBconnected\fR if the link is connected, or \fBdisconnected\fR if it is
2956 2967  not connected. If the link is disconnected, all remaining fields have the value
2957 2968  \fB--\fR.
2958 2969  .RE
2959 2970  
2960 2971  .sp
2961 2972  .ne 2
2962 2973  .na
2963 2974  \fB\fBESSID\fR\fR
2964 2975  .ad
2965 2976  .sp .6
2966 2977  .RS 4n
2967 2978  The \fBESSID\fR (name) of the connected \fBWiFi\fR network.
2968 2979  .RE
2969 2980  
2970 2981  .sp
2971 2982  .ne 2
2972 2983  .na
2973 2984  \fB\fBBSSID\fR\fR
2974 2985  .ad
2975 2986  .sp .6
2976 2987  .RS 4n
2977 2988  Either the hardware address of the \fBWiFi\fR network's Access Point (for
2978 2989  \fBBSS\fR networks), or the \fBWiFi\fR network's randomly generated unique
2979 2990  token (for \fBIBSS\fR networks).
2980 2991  .RE
2981 2992  
2982 2993  .sp
2983 2994  .ne 2
2984 2995  .na
2985 2996  \fB\fBSEC\fR\fR
2986 2997  .ad
2987 2998  .sp .6
2988 2999  .RS 4n
2989 3000  Either \fBnone\fR for a \fBWiFi\fR network that uses no security, \fBwep\fR for
2990 3001  a \fBWiFi\fR network that requires WEP, or \fBwpa\fR for a WiFi network that
2991 3002  requires WPA.
2992 3003  .RE
2993 3004  
2994 3005  .sp
2995 3006  .ne 2
2996 3007  .na
2997 3008  \fB\fBMODE\fR\fR
2998 3009  .ad
2999 3010  .sp .6
3000 3011  .RS 4n
3001 3012  The supported connection modes: one or more of \fBa\fR, \fBb\fR, or \fBg\fR.
3002 3013  .RE
3003 3014  
3004 3015  .sp
3005 3016  .ne 2
3006 3017  .na
3007 3018  \fB\fBSTRENGTH\fR\fR
3008 3019  .ad
3009 3020  .sp .6
3010 3021  .RS 4n
3011 3022  The connection strength: one of \fBexcellent\fR, \fBvery good\fR, \fBgood\fR,
3012 3023  \fBweak\fR, or \fBvery weak\fR.
3013 3024  .RE
3014 3025  
3015 3026  .sp
3016 3027  .ne 2
3017 3028  .na
3018 3029  \fB\fBSPEED\fR\fR
3019 3030  .ad
3020 3031  .sp .6
3021 3032  .RS 4n
3022 3033  The connection speed, in megabits per second.
3023 3034  .RE
3024 3035  
3025 3036  .sp
3026 3037  .ne 2
3027 3038  .na
3028 3039  \fB\fBAUTH\fR\fR
3029 3040  .ad
3030 3041  .sp .6
3031 3042  .RS 4n
3032 3043  Either \fBopen\fR or \fBshared\fR (see \fBconnect-wifi\fR).
3033 3044  .RE
3034 3045  
3035 3046  .sp
3036 3047  .ne 2
3037 3048  .na
3038 3049  \fB\fBBSSTYPE\fR\fR
3039 3050  .ad
3040 3051  .sp .6
3041 3052  .RS 4n
3042 3053  Either \fBbss\fR for \fBBSS\fR (infrastructure) networks, or \fBibss\fR for
3043 3054  \fBIBSS\fR (ad-hoc) networks.
3044 3055  .RE
3045 3056  
3046 3057  By default, currently all fields but \fBAUTH\fR, \fBBSSID\fR, \fBBSSTYPE\fR are
3047 3058  displayed.
3048 3059  .RE
3049 3060  
3050 3061  .sp
3051 3062  .ne 2
3052 3063  .na
3053 3064  \fB\fB-p\fR, \fB--parseable\fR\fR
3054 3065  .ad
3055 3066  .sp .6
3056 3067  .RS 4n
3057 3068  Displays using a stable machine-parseable format. The \fB-o\fR option is
3058 3069  required with \fB-p\fR. See "Parseable Output Format", below.
3059 3070  .RE
3060 3071  
3061 3072  .RE
3062 3073  
3063 3074  .sp
3064 3075  .ne 2
3065 3076  .na
3066 3077  \fB\fBdladm show-ether\fR [\fB-x\fR] [[\fB-p\fR] \fB-o\fR \fIfield\fR,...]
3067 3078  [\fIether-link\fR]\fR
3068 3079  .ad
3069 3080  .sp .6
3070 3081  .RS 4n
3071 3082  Shows state information either for all physical Ethernet links or for a
3072 3083  specified physical Ethernet link.
3073 3084  .sp
3074 3085  The \fBshow-ether\fR subcommand accepts the following options:
3075 3086  .sp
3076 3087  .ne 2
3077 3088  .na
3078 3089  \fB\fB-o\fR \fIfield\fR,..., \fB--output\fR=\fIfield\fR\fR
3079 3090  .ad
3080 3091  .sp .6
3081 3092  .RS 4n
3082 3093  A case-insensitive, comma-separated list of output fields to display. The field
3083 3094  name must be one of the fields listed below, or the special value \fBall\fR to
3084 3095  display all fields. For each link, the following fields can be displayed:
3085 3096  .sp
3086 3097  .ne 2
3087 3098  .na
3088 3099  \fB\fBLINK\fR\fR
3089 3100  .ad
3090 3101  .sp .6
3091 3102  .RS 4n
3092 3103  The name of the link being displayed.
3093 3104  .RE
3094 3105  
3095 3106  .sp
3096 3107  .ne 2
3097 3108  .na
3098 3109  \fB\fBPTYPE\fR\fR
3099 3110  .ad
3100 3111  .sp .6
3101 3112  .RS 4n
3102 3113  Parameter type, where \fBcurrent\fR indicates the negotiated state of the link,
3103 3114  \fBcapable\fR indicates capabilities supported by the device, \fBadv\fR
3104 3115  indicates the advertised capabilities, and \fBpeeradv\fR indicates the
3105 3116  capabilities advertised by the link-partner.
3106 3117  .RE
3107 3118  
3108 3119  .sp
3109 3120  .ne 2
3110 3121  .na
3111 3122  \fB\fBSTATE\fR\fR
3112 3123  .ad
3113 3124  .sp .6
3114 3125  .RS 4n
3115 3126  The state of the link.
3116 3127  .RE
3117 3128  
3118 3129  .sp
3119 3130  .ne 2
3120 3131  .na
3121 3132  \fB\fBAUTO\fR\fR
3122 3133  .ad
3123 3134  .sp .6
3124 3135  .RS 4n
3125 3136  A \fByes\fR/\fBno\fR value indicating whether auto-negotiation is advertised.
3126 3137  .RE
3127 3138  
3128 3139  .sp
3129 3140  .ne 2
3130 3141  .na
3131 3142  \fB\fBSPEED-DUPLEX\fR\fR
3132 3143  .ad
3133 3144  .sp .6
3134 3145  .RS 4n
3135 3146  Combinations of speed and duplex values available. The units of speed are
3136 3147  encoded with a trailing suffix of \fBG\fR (Gigabits/s) or \fBM\fR (Mb/s).
3137 3148  Duplex values are encoded as \fBf\fR (full-duplex) or \fBh\fR (half-duplex).
3138 3149  .RE
3139 3150  
3140 3151  .sp
3141 3152  .ne 2
3142 3153  .na
3143 3154  \fB\fBPAUSE\fR\fR
3144 3155  .ad
3145 3156  .sp .6
3146 3157  .RS 4n
3147 3158  Flow control information. Can be \fBno\fR, indicating no flow control is
3148 3159  available; \fBtx\fR, indicating that the end-point can transmit pause frames,
3149 3160  but ignores any received pause frames; \fBrx\fR, indicating that the end-point
3150 3161  receives and acts upon received pause frames; or \fBbi\fR, indicating
3151 3162  bi-directional flow-control.
3152 3163  .RE
3153 3164  
3154 3165  .sp
3155 3166  .ne 2
3156 3167  .na
3157 3168  \fB\fBREM_FAULT\fR\fR
3158 3169  .ad
3159 3170  .sp .6
3160 3171  .RS 4n
3161 3172  Fault detection information. Valid values are \fBnone\fR or \fBfault\fR.
3162 3173  .RE
3163 3174  
3164 3175  By default, all fields except \fBREM_FAULT\fR are displayed for the "current"
3165 3176  \fBPTYPE\fR.
3166 3177  .RE
3167 3178  
3168 3179  .sp
3169 3180  .ne 2
3170 3181  .na
3171 3182  \fB\fB-p\fR, \fB--parseable\fR\fR
3172 3183  .ad
3173 3184  .sp .6
3174 3185  .RS 4n
3175 3186  Displays using a stable machine-parseable format. The \fB-o\fR option is
3176 3187  required with \fB-p\fR. See "Parseable Output Format", below.
3177 3188  .RE
3178 3189  
3179 3190  .sp
3180 3191  .ne 2
3181 3192  .na
3182 3193  \fB\fB-x\fR, \fB--extended\fR\fR
3183 3194  .ad
3184 3195  .sp .6

3185 3196  .RS 4n
3186 3197  Extended output is displayed for \fBPTYPE\fR values of \fBcurrent\fR,
3187 3198  \fBcapable\fR, \fBadv\fR and \fBpeeradv\fR.
3188 3199  .RE
3189 3200  
3190 3201  .RE
3191 3202  
3192 3203  .sp
3193 3204  .ne 2
3194 3205  .na
3195      -\fB\fBdladm set-linkprop\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fB-p\fR
3196      -\fIprop\fR=\fIvalue\fR[,...] \fIlink\fR\fR
     3206 +\fB\fBdladm set-linkprop\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-z\fR \fIzonename\fR] \fB-p\fR \fIprop\fR=\fIvalue\fR[,...] \fIlink\fR\fR
3197 3207  .ad
3198 3208  .sp .6
3199 3209  .RS 4n
3200 3210  Sets the values of one or more properties on the link specified. The list of
3201 3211  properties and their possible values depend on the link type, the network
3202 3212  device driver, and networking hardware. These properties can be retrieved using
3203 3213  \fBshow-linkprop\fR.
3204 3214  .sp
3205 3215  .ne 2
3206 3216  .na

3207 3217  \fB\fB-t\fR, \fB--temporary\fR\fR
3208 3218  .ad
3209 3219  .sp .6
3210 3220  .RS 4n
3211 3221  Specifies that the changes are temporary. Temporary changes last until the next
3212 3222  reboot.
3213 3223  .RE
3214 3224  
3215 3225  .sp
3216 3226  .ne 2
3217 3227  .na

3218 3228  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
3219 3229  .ad
3220 3230  .sp .6
3221 3231  .RS 4n
3222 3232  See "Options," above.
3223 3233  .RE
3224 3234  
3225 3235  .sp
3226 3236  .ne 2
3227 3237  .na
     3238 +\fB\fB-z\fR \fIzonenme\fR
     3239 +.ad
     3240 +.sp .6
     3241 +.RS 4n
     3242 +Operate on a link that has been delegated to the specified zone.
     3243 +.RE
     3244 +
     3245 +.sp
     3246 +.ne 2
     3247 +.na
3228 3248  \fB\fB-p\fR \fIprop\fR=\fIvalue\fR[,...], \fB--prop\fR
3229 3249  \fIprop\fR=\fIvalue\fR[,...]\fR
3230 3250  .ad
3231 3251  .br
3232 3252  .na
3233 3253  \fB\fR
3234 3254  .ad
3235 3255  .sp .6
3236 3256  .RS 4n
3237 3257  A comma-separated list of properties to set to the specified values.
3238 3258  .RE
3239 3259  
3240 3260  Note that when the persistent value is set, the temporary value changes to the
3241 3261  same value.
3242 3262  .RE
3243 3263  
3244 3264  .sp
3245 3265  .ne 2
3246 3266  .na
3247      -\fB\fBdladm reset-linkprop\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-p\fR
3248      -\fIprop\fR,...] \fIlink\fR\fR
     3267 +\fB\fBdladm reset-linkprop\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-z\fR \fIzonename\fR] [\fB-p\fR \fIprop\fR,...] \fIlink\fR\fR
3249 3268  .ad
3250 3269  .sp .6
3251 3270  .RS 4n
3252 3271  Resets one or more properties to their values on the link specified. Properties
3253 3272  are reset to the values they had at startup. If no properties are specified,
3254 3273  all properties are reset. See \fBshow-linkprop\fR for a description of
3255 3274  properties.
3256 3275  .sp
3257 3276  .ne 2
3258 3277  .na

3259 3278  \fB\fB-t\fR, \fB--temporary\fR\fR
3260 3279  .ad
3261 3280  .sp .6
3262 3281  .RS 4n
3263 3282  Specifies that the resets are temporary. Values are reset to default values.
3264 3283  Temporary resets last until the next reboot.
3265 3284  .RE
3266 3285  
3267 3286  .sp
3268 3287  .ne 2
3269 3288  .na

3270 3289  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
3271 3290  .ad
3272 3291  .sp .6
3273 3292  .RS 4n
3274 3293  See "Options," above.
3275 3294  .RE
3276 3295  
3277 3296  .sp
3278 3297  .ne 2
3279 3298  .na
     3299 +\fB\fB-z\fR \fIzonenme\fR
     3300 +.ad
     3301 +.sp .6
     3302 +.RS 4n
     3303 +Operate on a link that has been delegated to the specified zone.
     3304 +.RE
     3305 +
     3306 +.sp
     3307 +.ne 2
     3308 +.na
3280 3309  \fB\fB-p\fR \fIprop, ...\fR, \fB--prop\fR=\fIprop, ...\fR\fR
3281 3310  .ad
3282 3311  .sp .6
3283 3312  .RS 4n
3284 3313  A comma-separated list of properties to reset.
3285 3314  .RE
3286 3315  
3287 3316  Note that when the persistent value is reset, the temporary value changes to
3288 3317  the same value.
3289 3318  .RE
3290 3319  
3291 3320  .sp
3292 3321  .ne 2
3293 3322  .na
3294      -\fB\fBdladm show-linkprop\fR [\fB-P\fR] [[\fB-c\fR] \fB-o\fR
3295      -\fIfield\fR[,...]][\fB-p\fR \fIprop\fR[,...]] [\fIlink\fR]\fR
     3323 +\fB\fBdladm show-linkprop\fR [\fB-P\fR] [\fB-z\fR \fIzonename\fR] [[\fB-c\fR] \fB-o\fR \fIfield\fR[,...]][\fB-p\fR \fIprop\fR[,...]] [\fIlink\fR]\fR
3296 3324  .ad
3297 3325  .sp .6
3298 3326  .RS 4n
3299 3327  Show the current or persistent values of one or more properties, either for all
3300 3328  datalinks or for the specified link. By default, current values are shown. If
3301 3329  no properties are specified, all available link properties are displayed. For
3302 3330  each property, the following fields are displayed:
3303 3331  .sp
3304 3332  .ne 2
3305 3333  .na

3306 3334  \fB\fB-o\fR \fIfield\fR[,...], \fB--output\fR=\fIfield\fR\fR
3307 3335  .ad
3308 3336  .sp .6
3309 3337  .RS 4n
3310 3338  A case-insensitive, comma-separated list of output fields to display. The field
3311 3339  name must be one of the fields listed below, or the special value \fBall\fR to
3312 3340  display all fields. For each link, the following fields can be displayed:
3313 3341  .sp
3314 3342  .ne 2
3315 3343  .na
3316 3344  \fB\fBLINK\fR\fR
3317 3345  .ad
3318 3346  .sp .6
3319 3347  .RS 4n
3320 3348  The name of the datalink.
3321 3349  .RE
3322 3350  
3323 3351  .sp
3324 3352  .ne 2
3325 3353  .na
3326 3354  \fB\fBPROPERTY\fR\fR
3327 3355  .ad
3328 3356  .sp .6
3329 3357  .RS 4n
3330 3358  The name of the property.
3331 3359  .RE
3332 3360  
3333 3361  .sp
3334 3362  .ne 2
3335 3363  .na
3336 3364  \fB\fBPERM\fR\fR
3337 3365  .ad
3338 3366  .sp .6
3339 3367  .RS 4n
3340 3368  The read/write permissions of the property. The value shown is one of \fBro\fR
3341 3369  or \fBrw\fR.
3342 3370  .RE
3343 3371  
3344 3372  .sp
3345 3373  .ne 2
3346 3374  .na
3347 3375  \fB\fBVALUE\fR\fR
3348 3376  .ad
3349 3377  .sp .6
3350 3378  .RS 4n
3351 3379  The current (or persistent) property value. If the value is not set, it is
3352 3380  shown as \fB--\fR. If it is unknown, the value is shown as \fB?\fR. Persistent
3353 3381  values that are not set or have been reset will be shown as \fB--\fR and will
3354 3382  use the system \fBDEFAULT\fR value (if any).
3355 3383  .RE
3356 3384  
3357 3385  .sp
3358 3386  .ne 2
3359 3387  .na
3360 3388  \fB\fBDEFAULT\fR\fR
3361 3389  .ad
3362 3390  .sp .6
3363 3391  .RS 4n
3364 3392  The default value of the property. If the property has no default value,
3365 3393  \fB--\fR is shown.
3366 3394  .RE
3367 3395  
3368 3396  .sp
3369 3397  .ne 2
3370 3398  .na
3371 3399  \fB\fBPOSSIBLE\fR\fR
3372 3400  .ad
3373 3401  .sp .6
3374 3402  .RS 4n
3375 3403  A comma-separated list of the values the property can have. If the values span
3376 3404  a numeric range, \fImin\fR - \fImax\fR might be shown as shorthand. If the
3377 3405  possible values are unknown or unbounded, \fB--\fR is shown.
3378 3406  .RE
3379 3407  
3380 3408  The list of properties depends on the link type and network device driver, and
3381 3409  the available values for a given property further depends on the underlying
3382 3410  network hardware and its state. General link properties are documented in the
3383 3411  \fBLINK PROPERTIES\fR section. However, link properties that begin with
3384 3412  "\fB_\fR" (underbar) are specific to a given link or its underlying network
3385 3413  device and subject to change or removal. See the appropriate network device
3386 3414  driver man page for details.
3387 3415  .RE
3388 3416  
3389 3417  .sp
3390 3418  .ne 2
3391 3419  .na
3392 3420  \fB\fB-c\fR, \fB--parseable\fR\fR
3393 3421  .ad
3394 3422  .sp .6
3395 3423  .RS 4n
3396 3424  Display using a stable machine-parseable format. The \fB-o\fR option is
3397 3425  required with this option. See "Parseable Output Format", below.
3398 3426  .RE
3399 3427  
3400 3428  .sp
3401 3429  .ne 2
3402 3430  .na

3403 3431  \fB\fB-P\fR, \fB--persistent\fR\fR
3404 3432  .ad
3405 3433  .sp .6
3406 3434  .RS 4n
3407 3435  Display persistent link property information
3408 3436  .RE
3409 3437  
3410 3438  .sp
3411 3439  .ne 2
3412 3440  .na
     3441 +\fB\fB-z\fR \fIzonenme\fR
     3442 +.ad
     3443 +.sp .6
     3444 +.RS 4n
     3445 +Operate on a link that has been delegated to the specified zone.
     3446 +.RE
     3447 +
     3448 +.sp
     3449 +.ne 2
     3450 +.na
3413 3451  \fB\fB-p\fR \fIprop, ...\fR, \fB--prop\fR=\fIprop, ...\fR\fR
3414 3452  .ad
3415 3453  .sp .6
3416 3454  .RS 4n
3417 3455  A comma-separated list of properties to show. See the sections on link
3418 3456  properties following subcommand descriptions.
3419 3457  .RE
3420 3458  
3421 3459  .RE
3422 3460  

3423 3461  .sp
3424 3462  .ne 2
3425 3463  .na
3426 3464  \fB\fBdladm create-secobj\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-f\fR
3427 3465  \fIfile\fR] \fB-c\fR \fIclass\fR \fIsecobj\fR\fR
3428 3466  .ad
3429 3467  .sp .6
3430 3468  .RS 4n
3431 3469  Create a secure object named \fIsecobj\fR in the specified \fIclass\fR to be
3432 3470  later used as a WEP or WPA key in connecting to an encrypted network. The value
3433 3471  of the secure object can either be provided interactively or read from a file.
3434 3472  The sequence of interactive prompts and the file format depends on the class of
3435 3473  the secure object.
3436 3474  .sp
3437 3475  Currently, the classes \fBwep\fR and \fBwpa\fR are supported. The \fBWEP\fR
3438 3476  (Wired Equivalent Privacy) key can be either 5 or 13 bytes long. It can be
3439 3477  provided either as an \fBASCII\fR or hexadecimal string -- thus, \fB12345\fR
3440 3478  and \fB0x3132333435\fR are equivalent 5-byte keys (the \fB0x\fR prefix can be
3441 3479  omitted). A file containing a \fBWEP\fR key must consist of a single line using
3442 3480  either \fBWEP\fR key format. The WPA (Wi-Fi Protected Access) key must be
3443 3481  provided as an ASCII string with a length between 8 and 63 bytes.
3444 3482  .sp
3445 3483  This subcommand is only usable by users or roles that belong to the "Network
3446 3484  Link Security" \fBRBAC\fR profile.
3447 3485  .sp
3448 3486  .ne 2
3449 3487  .na
3450 3488  \fB\fB-c\fR \fIclass\fR, \fB--class\fR=\fIclass\fR\fR
3451 3489  .ad
3452 3490  .sp .6
3453 3491  .RS 4n
3454 3492  \fIclass\fR can be \fBwep\fR or \fBwpa\fR. See preceding discussion.
3455 3493  .RE
3456 3494  
3457 3495  .sp
3458 3496  .ne 2
3459 3497  .na
3460 3498  \fB\fB-t\fR, \fB--temporary\fR\fR
3461 3499  .ad
3462 3500  .sp .6
3463 3501  .RS 4n
3464 3502  Specifies that the creation is temporary. Temporary creation last until the
3465 3503  next reboot.
3466 3504  .RE
3467 3505  
3468 3506  .sp
3469 3507  .ne 2
3470 3508  .na
3471 3509  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
3472 3510  .ad
3473 3511  .sp .6
3474 3512  .RS 4n
3475 3513  See "Options," above.
3476 3514  .RE
3477 3515  
3478 3516  .sp
3479 3517  .ne 2
3480 3518  .na
3481 3519  \fB\fB-f\fR \fIfile\fR, \fB--file\fR=\fIfile\fR\fR
3482 3520  .ad
3483 3521  .sp .6
3484 3522  .RS 4n
3485 3523  Specifies a file that should be used to obtain the secure object's value. The
3486 3524  format of this file depends on the secure object class. See the \fBEXAMPLES\fR
3487 3525  section for an example of using this option to set a \fBWEP\fR key.
3488 3526  .RE
3489 3527  
3490 3528  .RE
3491 3529  
3492 3530  .sp
3493 3531  .ne 2
3494 3532  .na
3495 3533  \fB\fBdladm delete-secobj\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR]
3496 3534  \fIsecobj\fR[,...]\fR
3497 3535  .ad
3498 3536  .sp .6
3499 3537  .RS 4n
3500 3538  Delete one or more specified secure objects. This subcommand is only usable by
3501 3539  users or roles that belong to the "Network Link Security" \fBRBAC\fR profile.
3502 3540  .sp
3503 3541  .ne 2
3504 3542  .na
3505 3543  \fB\fB-t\fR, \fB--temporary\fR\fR
3506 3544  .ad
3507 3545  .sp .6
3508 3546  .RS 4n
3509 3547  Specifies that the deletions are temporary. Temporary deletions last until the
3510 3548  next reboot.
3511 3549  .RE
3512 3550  
3513 3551  .sp
3514 3552  .ne 2
3515 3553  .na
3516 3554  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
3517 3555  .ad
3518 3556  .sp .6
3519 3557  .RS 4n
3520 3558  See "Options," above.
3521 3559  .RE
3522 3560  
3523 3561  .RE
3524 3562  
3525 3563  .sp
3526 3564  .ne 2
3527 3565  .na
3528 3566  \fB\fBdladm show-secobj\fR [\fB-P\fR] [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]]
3529 3567  [\fIsecobj\fR,...]\fR
3530 3568  .ad
3531 3569  .sp .6
3532 3570  .RS 4n
3533 3571  Show current or persistent secure object information. If one or more secure
3534 3572  objects are specified, then information for each is displayed. Otherwise, all
3535 3573  current or persistent secure objects are displayed.
3536 3574  .sp
3537 3575  By default, current secure objects are displayed, which are all secure objects
3538 3576  that have either been persistently created and not temporarily deleted, or
3539 3577  temporarily created.
3540 3578  .sp
3541 3579  For security reasons, it is not possible to show the value of a secure object.
3542 3580  .sp
3543 3581  .ne 2
3544 3582  .na
3545 3583  \fB\fB-o\fR \fIfield\fR[,...] , \fB--output\fR=\fIfield\fR[,...]\fR
3546 3584  .ad
3547 3585  .sp .6
3548 3586  .RS 4n
3549 3587  A case-insensitive, comma-separated list of output fields to display. The field
3550 3588  name must be one of the fields listed below. For displayed secure object, the
3551 3589  following fields can be shown:
3552 3590  .sp
3553 3591  .ne 2
3554 3592  .na
3555 3593  \fB\fBOBJECT\fR\fR
3556 3594  .ad
3557 3595  .sp .6
3558 3596  .RS 4n
3559 3597  The name of the secure object.
3560 3598  .RE
3561 3599  
3562 3600  .sp
3563 3601  .ne 2
3564 3602  .na
3565 3603  \fB\fBCLASS\fR\fR
3566 3604  .ad
3567 3605  .sp .6
3568 3606  .RS 4n
3569 3607  The class of the secure object.
3570 3608  .RE
3571 3609  
3572 3610  .RE
3573 3611  
3574 3612  .sp
3575 3613  .ne 2
3576 3614  .na
3577 3615  \fB\fB-p\fR, \fB--parseable\fR\fR
3578 3616  .ad
3579 3617  .sp .6
3580 3618  .RS 4n
3581 3619  Display using a stable machine-parseable format. The \fB-o\fR option is
3582 3620  required with \fB-p\fR. See "Parseable Output Format", below.
3583 3621  .RE
3584 3622  
3585 3623  .sp
3586 3624  .ne 2
3587 3625  .na
3588 3626  \fB\fB-P\fR, \fB--persistent\fR\fR
3589 3627  .ad
3590 3628  .sp .6
3591 3629  .RS 4n
3592 3630  Display persistent secure object information
3593 3631  .RE
3594 3632  
3595 3633  .RE
3596 3634  
3597 3635  .sp
3598 3636  .ne 2
3599 3637  .na
3600 3638  \fB\fBdladm create-vnic\fR [\fB-t\fR] \fB-l\fR \fIlink\fR [\fB-R\fR
3601 3639  \fIroot-dir\fR] [\fB-m\fR \fIvalue\fR | auto | {factory [\fB-n\fR
3602 3640  \fIslot-identifier\fR]} | {random [\fB-r\fR \fIprefix\fR]}] [\fB-v\fR
3603 3641  \fIvlan-id\fR] [\fB-p\fR \fIprop\fR=\fIvalue\fR[,...]] \fIvnic-link\fR\fR
3604 3642  .ad
3605 3643  .sp .6
3606 3644  .RS 4n
3607 3645  Create a VNIC with name \fIvnic-link\fR over the specified link.
3608 3646  .sp
3609 3647  .ne 2
3610 3648  .na
3611 3649  \fB\fB-t\fR, \fB--temporary\fR\fR
3612 3650  .ad
3613 3651  .sp .6
3614 3652  .RS 4n
3615 3653  Specifies that the VNIC is temporary. Temporary VNICs last until the next
3616 3654  reboot.
3617 3655  .RE
3618 3656  
3619 3657  .sp
3620 3658  .ne 2
3621 3659  .na
3622 3660  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
3623 3661  .ad
3624 3662  .sp .6
3625 3663  .RS 4n
3626 3664  See "Options," above.
3627 3665  .RE
3628 3666  
3629 3667  .sp
3630 3668  .ne 2
3631 3669  .na
3632 3670  \fB\fB-l\fR \fIlink\fR, \fB--link\fR=\fIlink\fR\fR
3633 3671  .ad
3634 3672  .sp .6
3635 3673  .RS 4n
3636 3674  \fIlink\fR can be a physical link or an \fBetherstub\fR.
3637 3675  .RE
3638 3676  
3639 3677  .sp
3640 3678  .ne 2
3641 3679  .na
3642 3680  \fB\fB-m\fR \fIvalue\fR | \fIkeyword\fR, \fB--mac-address\fR=\fIvalue\fR |
3643 3681  \fIkeyword\fR\fR
3644 3682  .ad
3645 3683  .sp .6
3646 3684  .RS 4n
3647 3685  Sets the VNIC's MAC address based on the specified value or keyword. If
3648 3686  \fIvalue\fR is not a keyword, it is interpreted as a unicast MAC address, which
3649 3687  must be valid for the underlying NIC. The following special keywords can be
3650 3688  used:
3651 3689  .sp
3652 3690  .ne 2
3653 3691  .na
3654 3692  \fBfactory [\fB-n\fR \fIslot-identifier\fR],\fR
3655 3693  .ad
3656 3694  .br
3657 3695  .na
3658 3696  \fBfactory [\fB--slot\fR=\fIslot-identifier\fR]\fR
3659 3697  .ad
3660 3698  .sp .6
3661 3699  .RS 4n
3662 3700  Assign a factory MAC address to the VNIC. When a factory MAC address is
3663 3701  requested, \fB-m\fR can be combined with the \fB-n\fR option to specify a MAC
3664 3702  address slot to be used. If \fB-n\fR is not specified, the system will choose
3665 3703  the next available factory MAC address. The \fB-m\fR option of the
3666 3704  \fBshow-phys\fR subcommand can be used to display the list of factory MAC
3667 3705  addresses, their slot identifiers, and their availability.
3668 3706  .RE
3669 3707  
3670 3708  .sp
3671 3709  .ne 2
3672 3710  .na
3673 3711  \fB\fR
3674 3712  .ad
3675 3713  .br
3676 3714  .na
3677 3715  \fBrandom [\fB-r\fR \fIprefix\fR],\fR
3678 3716  .ad
3679 3717  .br
3680 3718  .na
3681 3719  \fBrandom [\fB--mac-prefix\fR=\fIprefix\fR]\fR
3682 3720  .ad
3683 3721  .sp .6
3684 3722  .RS 4n
3685 3723  Assign a random MAC address to the VNIC. A default prefix consisting of a valid
3686 3724  IEEE OUI with the local bit set will be used. That prefix can be overridden
3687 3725  with the \fB-r\fR option.
3688 3726  .RE
3689 3727  
3690 3728  .sp
3691 3729  .ne 2
3692 3730  .na
3693 3731  \fBauto\fR
3694 3732  .ad
3695 3733  .sp .6
3696 3734  .RS 4n
3697 3735  Try and use a factory MAC address first. If none is available, assign a random
3698 3736  MAC address. \fBauto\fR is the default action if the \fB-m\fR option is not
3699 3737  specified.
3700 3738  .RE
3701 3739  
3702 3740  .sp
3703 3741  .ne 2
3704 3742  .na
3705 3743  \fB\fB-v\fR \fIvlan-id\fR\fR
3706 3744  .ad
3707 3745  .sp .6
3708 3746  .RS 4n
3709 3747  Enable VLAN tagging for this VNIC. The VLAN tag will have id \fIvlan-id\fR.
3710 3748  .RE
3711 3749  
3712 3750  .RE
3713 3751  
3714 3752  .sp
3715 3753  .ne 2
3716 3754  .na
3717 3755  \fB\fB-p\fR \fIprop\fR=\fIvalue\fR,..., \fB--prop\fR
3718 3756  \fIprop\fR=\fIvalue\fR,...\fR
3719 3757  .ad

3720 3758  .sp .6
3721 3759  .RS 4n
3722 3760  A comma-separated list of properties to set to the specified values.
3723 3761  .RE
3724 3762  
3725 3763  .RE
3726 3764  
3727 3765  .sp
3728 3766  .ne 2
3729 3767  .na
3730      -\fB\fBdladm delete-vnic\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR]
3731      -\fIvnic-link\fR\fR
     3768 +\fB\fBdladm delete-vnic\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-z\fR \fIzonename\fR] \fIvnic-link\fR\fR
3732 3769  .ad
3733 3770  .sp .6
3734 3771  .RS 4n
3735 3772  Deletes the specified VNIC.
3736 3773  .sp
3737 3774  .ne 2
3738 3775  .na
3739 3776  \fB\fB-t\fR, \fB--temporary\fR\fR
3740 3777  .ad
3741 3778  .sp .6

3742 3779  .RS 4n
3743 3780  Specifies that the deletion is temporary. Temporary deletions last until the
3744 3781  next reboot.
3745 3782  .RE
3746 3783  

3747 3784  .sp
3748 3785  .ne 2
3749 3786  .na
3750 3787  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
3751 3788  .ad
3752 3789  .sp .6
3753 3790  .RS 4n
3754 3791  See "Options," above.
3755 3792  .RE
3756 3793  
     3794 +.sp
     3795 +.ne 2
     3796 +.na
     3797 +\fB\fB-z\fR \fIzonenme\fR
     3798 +.ad
     3799 +.sp .6
     3800 +.RS 4n
     3801 +Operate on a link that has been delegated to the specified zone.
3757 3802  .RE
3758 3803  
     3804 +.RE
     3805 +
3759 3806  .sp
3760 3807  .ne 2
3761 3808  .na
3762      -\fB\fBdladm show-vnic\fR [\fB-pP\fR] [\fB-s\fR [\fB-i\fR \fIinterval\fR]]
3763      -[\fB-o\fR \fIfield\fR[,...]] [\fB-l\fR \fIlink\fR] [\fIvnic-link\fR]\fR
     3809 +\fB\fBdladm show-vnic\fR [\fB-pP\fR] [\fB-s\fR [\fB-i\fR \fIinterval\fR]] [\fB-o\fR \fIfield\fR[,...]] [\fB-l\fR \fIlink\fR] [\fB-z\fR \fIzonename\fR] [\fIvnic-link\fR]\fR
3764 3810  .ad
3765 3811  .sp .6
3766 3812  .RS 4n
3767 3813  Show VNIC configuration information (the default) or statistics, for all VNICs,
3768 3814  all VNICs on a link, or only the specified \fIvnic-link\fR.
3769 3815  .sp
3770 3816  .ne 2
3771 3817  .na
3772 3818  \fB\fB-o\fR \fIfield\fR[,...] , \fB--output\fR=\fIfield\fR[,...]\fR
3773 3819  .ad

3774 3820  .sp .6
3775 3821  .RS 4n
3776 3822  A case-insensitive, comma-separated list of output fields to display. The field
3777 3823  name must be one of the fields listed below. The field name must be one of the
3778 3824  fields listed below, or the special value \fBall\fR to display all fields. By
3779 3825  default (without \fB-o\fR), \fBshow-vnic\fR displays all fields.
3780 3826  .sp
3781 3827  .ne 2
3782 3828  .na
3783 3829  \fB\fBLINK\fR\fR
3784 3830  .ad
3785 3831  .sp .6
3786 3832  .RS 4n
3787 3833  The name of the VNIC.
3788 3834  .RE
3789 3835  
3790 3836  .sp
3791 3837  .ne 2
3792 3838  .na
3793 3839  \fB\fBOVER\fR\fR
3794 3840  .ad
3795 3841  .sp .6
3796 3842  .RS 4n
3797 3843  The name of the physical link over which this VNIC is configured.
3798 3844  .RE
3799 3845  
3800 3846  .sp
3801 3847  .ne 2
3802 3848  .na
3803 3849  \fB\fBSPEED\fR\fR
3804 3850  .ad
3805 3851  .sp .6
3806 3852  .RS 4n
3807 3853  The maximum speed of the VNIC, in megabits per second.
3808 3854  .RE
3809 3855  
3810 3856  .sp
3811 3857  .ne 2
3812 3858  .na
3813 3859  \fB\fBMACADDRESS\fR\fR
3814 3860  .ad
3815 3861  .sp .6
3816 3862  .RS 4n
3817 3863  MAC address of the VNIC.
3818 3864  .RE
3819 3865  
3820 3866  .sp
3821 3867  .ne 2
3822 3868  .na
3823 3869  \fB\fBMACADDRTYPE\fR\fR
3824 3870  .ad
3825 3871  .sp .6
3826 3872  .RS 4n
3827 3873  MAC address type of the VNIC. \fBdladm\fR distinguishes among the following MAC
3828 3874  address types:
3829 3875  .sp
3830 3876  .ne 2
3831 3877  .na
3832 3878  \fB\fBrandom\fR\fR
3833 3879  .ad
3834 3880  .sp .6
3835 3881  .RS 4n
3836 3882  A random address assigned to the VNIC.
3837 3883  .RE
3838 3884  
3839 3885  .sp
3840 3886  .ne 2
3841 3887  .na
3842 3888  \fB\fBfactory\fR\fR
3843 3889  .ad
3844 3890  .sp .6
3845 3891  .RS 4n
3846 3892  A factory MAC address used by the VNIC.
3847 3893  .RE
3848 3894  
3849 3895  .RE
3850 3896  
3851 3897  .RE
3852 3898  
3853 3899  .sp
3854 3900  .ne 2
3855 3901  .na
3856 3902  \fB\fB-p\fR, \fB--parseable\fR\fR
3857 3903  .ad
3858 3904  .sp .6
3859 3905  .RS 4n
3860 3906  Display using a stable machine-parseable format. The \fB-o\fR option is
3861 3907  required with \fB-p\fR. See "Parseable Output Format", below.
3862 3908  .RE
3863 3909  
3864 3910  .sp
3865 3911  .ne 2
3866 3912  .na
3867 3913  \fB\fB-P\fR, \fB--persistent\fR\fR
3868 3914  .ad
3869 3915  .sp .6
3870 3916  .RS 4n
3871 3917  Display the persistent VNIC configuration.
3872 3918  .RE
3873 3919  
3874 3920  .sp
3875 3921  .ne 2
3876 3922  .na
3877 3923  \fB\fB-s\fR, \fB--statistics\fR\fR
3878 3924  .ad
3879 3925  .sp .6
3880 3926  .RS 4n
3881 3927  Displays VNIC statistics.
3882 3928  .RE
3883 3929  
3884 3930  .sp
3885 3931  .ne 2
3886 3932  .na
3887 3933  \fB\fB-i\fR \fIinterval\fR, \fB--interval\fR=\fIinterval\fR\fR
3888 3934  .ad
3889 3935  .sp .6
3890 3936  .RS 4n
3891 3937  Used with the \fB-s\fR option to specify an interval, in seconds, at which
3892 3938  statistics should be displayed. If this option is not specified, statistics
3893 3939  will be displayed only once.
3894 3940  .RE
3895 3941  

3896 3942  .sp
3897 3943  .ne 2
3898 3944  .na
3899 3945  \fB\fB-l\fR \fIlink\fR, \fB--link\fR=\fIlink\fR\fR
3900 3946  .ad
3901 3947  .sp .6
3902 3948  .RS 4n
3903 3949  Display information for all VNICs on the named link.
3904 3950  .RE
3905 3951  
     3952 +.sp
     3953 +.ne 2
     3954 +.na
     3955 +\fB\fB-z\fR \fIzonenme\fR
     3956 +.ad
     3957 +.sp .6
     3958 +.RS 4n
     3959 +Operate on a link that has been delegated to the specified zone.
     3960 +.RE
     3961 +
3906 3962  .RE
3907 3963  
3908 3964  .sp
3909 3965  .ne 2
3910 3966  .na
3911 3967  \fB\fR
3912 3968  .ad
3913 3969  .br
3914 3970  .na
3915 3971  \fB\fBdladm create-etherstub\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR]

3916 3972  \fIetherstub\fR\fR
3917 3973  .ad
3918 3974  .sp .6
3919 3975  .RS 4n
3920 3976  Create an etherstub with the specified name.
3921 3977  .sp
3922 3978  .ne 2
3923 3979  .na
3924 3980  \fB\fB-t\fR, \fB--temporary\fR\fR
3925 3981  .ad
3926 3982  .sp .6
3927 3983  .RS 4n
3928 3984  Specifies that the etherstub is temporary. Temporary etherstubs do not persist
3929 3985  across reboots.
3930 3986  .RE
3931 3987  
3932 3988  .sp
3933 3989  .ne 2
3934 3990  .na
3935 3991  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
3936 3992  .ad
3937 3993  .sp .6
3938 3994  .RS 4n
3939 3995  See "Options," above.
3940 3996  .RE
3941 3997  
3942 3998  VNICs can be created on top of etherstubs instead of physical NICs. As with
3943 3999  physical NICs, such a creation causes the stack to implicitly create a virtual
3944 4000  switch between the VNICs created on top of the same etherstub.
3945 4001  .RE
3946 4002  
3947 4003  .sp
3948 4004  .ne 2
3949 4005  .na
3950 4006  \fB\fR
3951 4007  .ad
3952 4008  .br
3953 4009  .na
3954 4010  \fB\fBdladm delete-etherstub\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR]
3955 4011  \fIetherstub\fR\fR
3956 4012  .ad
3957 4013  .sp .6
3958 4014  .RS 4n
3959 4015  Delete the specified etherstub.
3960 4016  .sp
3961 4017  .ne 2
3962 4018  .na
3963 4019  \fB\fB-t\fR, \fB--temporary\fR\fR
3964 4020  .ad
3965 4021  .sp .6
3966 4022  .RS 4n
3967 4023  Specifies that the deletion is temporary. Temporary deletions last until the
3968 4024  next reboot.
3969 4025  .RE
3970 4026  
3971 4027  .sp
3972 4028  .ne 2
3973 4029  .na
3974 4030  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
3975 4031  .ad
3976 4032  .sp .6
3977 4033  .RS 4n
3978 4034  See "Options," above.
3979 4035  .RE
3980 4036  
3981 4037  .RE
3982 4038  
3983 4039  .sp
3984 4040  .ne 2
3985 4041  .na
3986 4042  \fB\fBdladm show-etherstub\fR [\fIetherstub\fR]\fR
3987 4043  .ad
3988 4044  .sp .6
3989 4045  .RS 4n
3990 4046  Show all configured etherstubs by default, or the specified etherstub if
3991 4047  \fIetherstub\fR is specified.
3992 4048  .RE
3993 4049  
3994 4050  .sp
3995 4051  .ne 2
3996 4052  .na
3997 4053  \fB\fBdladm create-iptun\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] \fB-T\fR
3998 4054  \fItype\fR [\fB-s\fR \fItsrc\fR] [\fB-d\fR \fItdst\fR] \fIiptun-link\fR\fR
3999 4055  .ad
4000 4056  .sp .6
4001 4057  .RS 4n
4002 4058  Create an IP tunnel link named \fIiptun-link\fR. Such links can additionally be
4003 4059  protected with IPsec using \fBipsecconf\fR(1M).
4004 4060  .sp
4005 4061  An IP tunnel is conceptually comprised of two parts: a virtual link between two
4006 4062  or more IP nodes, and an IP interface above this link that allows the system to
4007 4063  transmit and receive IP packets encapsulated by the underlying link. This
4008 4064  subcommand creates a virtual link. The \fBifconfig\fR(1M) command is used to
4009 4065  configure IP interfaces above the link.
4010 4066  .sp
4011 4067  .ne 2
4012 4068  .na
4013 4069  \fB\fB-t\fR, \fB--temporary\fR\fR
4014 4070  .ad
4015 4071  .sp .6
4016 4072  .RS 4n
4017 4073  Specifies that the IP tunnel link is temporary. Temporary tunnels last until
4018 4074  the next reboot.
4019 4075  .RE
4020 4076  
4021 4077  .sp
4022 4078  .ne 2
4023 4079  .na
4024 4080  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
4025 4081  .ad
4026 4082  .sp .6
4027 4083  .RS 4n
4028 4084  See "Options," above.
4029 4085  .RE
4030 4086  
4031 4087  .sp
4032 4088  .ne 2
4033 4089  .na
4034 4090  \fB\fB-T\fR \fItype\fR, \fB--tunnel-type\fR=\fItype\fR\fR
4035 4091  .ad
4036 4092  .sp .6
4037 4093  .RS 4n
4038 4094  Specifies the type of tunnel to be created. The type must be one of the
4039 4095  following:
4040 4096  .sp
4041 4097  .ne 2
4042 4098  .na
4043 4099  \fB\fBipv4\fR\fR
4044 4100  .ad
4045 4101  .sp .6
4046 4102  .RS 4n
4047 4103  A point-to-point, IP-over-IP tunnel between two IPv4 nodes. This type of tunnel
4048 4104  requires IPv4 source and destination addresses to function. IPv4 and IPv6
4049 4105  interfaces can be plumbed above such a tunnel to create IPv4-over-IPv4 and
4050 4106  IPv6-over-IPv4 tunneling configurations.
4051 4107  .RE
4052 4108  
4053 4109  .sp
4054 4110  .ne 2
4055 4111  .na
4056 4112  \fB\fBipv6\fR\fR
4057 4113  .ad
4058 4114  .sp .6
4059 4115  .RS 4n
4060 4116  A point-to-point, IP-over-IP tunnel between two IPv6 nodes as defined in IETF
4061 4117  RFC 2473. This type of tunnel requires IPv6 source and destination addresses to
4062 4118  function. IPv4 and IPv6 interfaces can be plumbed above such a tunnel to create
4063 4119  IPv4-over-IPv6 and IPv6-over-IPv6 tunneling configurations.
4064 4120  .RE
4065 4121  
4066 4122  .sp
4067 4123  .ne 2
4068 4124  .na
4069 4125  \fB\fB6to4\fR\fR
4070 4126  .ad
4071 4127  .sp .6
4072 4128  .RS 4n
4073 4129  A 6to4, point-to-multipoint tunnel as defined in IETF RFC 3056. This type of
4074 4130  tunnel requires an IPv4 source address to function. An IPv6 interface is
4075 4131  plumbed on such a tunnel link to configure a 6to4 router.
4076 4132  .RE
4077 4133  
4078 4134  .RE
4079 4135  
4080 4136  .sp
4081 4137  .ne 2
4082 4138  .na
4083 4139  \fB\fB-s\fR \fItsrc\fR, \fB--tunnel-src\fR=\fItsrc\fR\fR
4084 4140  .ad
4085 4141  .sp .6
4086 4142  .RS 4n
4087 4143  Literal IP address or hostname corresponding to the tunnel source. If a
4088 4144  hostname is specified, it will be resolved to IP addresses, and one of those IP
4089 4145  addresses will be used as the tunnel source. Because IP tunnels are created
4090 4146  before naming services have been brought online during the boot process, it is
4091 4147  important that any hostname used be included in \fB/etc/hosts\fR.
4092 4148  .RE
4093 4149  
4094 4150  .sp
4095 4151  .ne 2
4096 4152  .na
4097 4153  \fB\fB-d\fR \fItdst\fR, \fB--tunnel-dst\fR=\fItdst\fR\fR
4098 4154  .ad
4099 4155  .sp .6
4100 4156  .RS 4n
4101 4157  Literal IP address or hostname corresponding to the tunnel destination.
4102 4158  .RE
4103 4159  
4104 4160  .RE
4105 4161  
4106 4162  .sp
4107 4163  .ne 2
4108 4164  .na
4109 4165  \fB\fBdladm modify-iptun\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR] [\fB-s\fR
4110 4166  \fItsrc\fR] [\fB-d\fR \fItdst\fR] \fIiptun-link\fR\fR
4111 4167  .ad
4112 4168  .sp .6
4113 4169  .RS 4n
4114 4170  Modify the parameters of the specified IP tunnel.
4115 4171  .sp
4116 4172  .ne 2
4117 4173  .na
4118 4174  \fB\fB-t\fR, \fB--temporary\fR\fR
4119 4175  .ad
4120 4176  .sp .6
4121 4177  .RS 4n
4122 4178  Specifies that the modification is temporary. Temporary modifications last
4123 4179  until the next reboot.
4124 4180  .RE
4125 4181  
4126 4182  .sp
4127 4183  .ne 2
4128 4184  .na
4129 4185  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
4130 4186  .ad
4131 4187  .sp .6
4132 4188  .RS 4n
4133 4189  See "Options," above.
4134 4190  .RE
4135 4191  
4136 4192  .sp
4137 4193  .ne 2
4138 4194  .na
4139 4195  \fB\fB-s\fR \fItsrc\fR, \fB--tunnel-src\fR=\fItsrc\fR\fR
4140 4196  .ad
4141 4197  .sp .6
4142 4198  .RS 4n
4143 4199  Specifies a new tunnel source address. See \fBcreate-iptun\fR for a
4144 4200  description.
4145 4201  .RE
4146 4202  
4147 4203  .sp
4148 4204  .ne 2
4149 4205  .na
4150 4206  \fB\fB-d\fR \fItdst\fR, \fB--tunnel-dst\fR=\fItdst\fR\fR
4151 4207  .ad
4152 4208  .sp .6
4153 4209  .RS 4n
4154 4210  Specifies a new tunnel destination address. See \fBcreate-iptun\fR for a
4155 4211  description.
4156 4212  .RE
4157 4213  
4158 4214  .RE
4159 4215  
4160 4216  .sp
4161 4217  .ne 2
4162 4218  .na
4163 4219  \fB\fBdladm delete-iptun\fR [\fB-t\fR] [\fB-R\fR \fIroot-dir\fR]
4164 4220  \fIiptun-link\fR\fR
4165 4221  .ad
4166 4222  .sp .6
4167 4223  .RS 4n
4168 4224  Delete the specified IP tunnel link.
4169 4225  .sp
4170 4226  .ne 2
4171 4227  .na
4172 4228  \fB\fB-t\fR, \fB--temporary\fR\fR
4173 4229  .ad
4174 4230  .sp .6
4175 4231  .RS 4n
4176 4232  Specifies that the deletion is temporary. Temporary deletions last until the
4177 4233  next reboot.
4178 4234  .RE
4179 4235  
4180 4236  .sp
4181 4237  .ne 2
4182 4238  .na
4183 4239  \fB\fB-R\fR \fIroot-dir\fR, \fB--root-dir\fR=\fIroot-dir\fR\fR
4184 4240  .ad
4185 4241  .sp .6
4186 4242  .RS 4n
4187 4243  See "Options," above.
4188 4244  .RE
4189 4245  
4190 4246  .RE
4191 4247  
4192 4248  .sp
4193 4249  .ne 2
4194 4250  .na
4195 4251  \fB\fBdladm show-iptun\fR [\fB-P\fR] [[\fB-p\fR] \fB-o\fR \fIfield\fR[,...]]
4196 4252  [\fIiptun-link\fR]\fR
4197 4253  .ad
4198 4254  .sp .6
4199 4255  .RS 4n
4200 4256  Show IP tunnel link configuration for a single IP tunnel or all IP tunnels.
4201 4257  .sp
4202 4258  .ne 2
4203 4259  .na
4204 4260  \fB\fB-P\fR, \fB--persistent\fR\fR
4205 4261  .ad
4206 4262  .sp .6
4207 4263  .RS 4n
4208 4264  Display the persistent IP tunnel configuration.
4209 4265  .RE
4210 4266  
4211 4267  .sp
4212 4268  .ne 2
4213 4269  .na
4214 4270  \fB\fB-p\fR, \fB--parseable\fR\fR
4215 4271  .ad
4216 4272  .sp .6
4217 4273  .RS 4n
4218 4274  Display using a stable machine-parseable format. The -o option is required with
4219 4275  -p. See "Parseable Output Format", below.
4220 4276  .RE
4221 4277  
4222 4278  .sp
4223 4279  .ne 2
4224 4280  .na
4225 4281  \fB\fB-o\fR \fIfield\fR[,...], \fB--output\fR=\fIfield\fR[,...]\fR
4226 4282  .ad
4227 4283  .sp .6
4228 4284  .RS 4n
4229 4285  A case-insensitive, comma-separated list of output fields to display. The field
4230 4286  name must be one of the fields listed below, or the special value \fBall\fR, to
4231 4287  display all fields. By default (without \fB-o\fR), \fBshow-iptun\fR displays
4232 4288  all fields.
4233 4289  .sp
4234 4290  .ne 2
4235 4291  .na
4236 4292  \fB\fBLINK\fR\fR
4237 4293  .ad
4238 4294  .sp .6
4239 4295  .RS 4n
4240 4296  The name of the IP tunnel link.
4241 4297  .RE
4242 4298  
4243 4299  .sp
4244 4300  .ne 2
4245 4301  .na
4246 4302  \fB\fBTYPE\fR\fR
4247 4303  .ad
4248 4304  .sp .6
4249 4305  .RS 4n
4250 4306  Type of tunnel as specified by the \fB-T\fR option of \fBcreate-iptun\fR.
4251 4307  .RE
4252 4308  
4253 4309  .sp
4254 4310  .ne 2
4255 4311  .na
4256 4312  \fB\fBFLAGS\fR\fR
4257 4313  .ad
4258 4314  .sp .6
4259 4315  .RS 4n
4260 4316  A set of flags associated with the IP tunnel link. Possible flags are:
4261 4317  .sp
4262 4318  .ne 2
4263 4319  .na
4264 4320  \fB\fBs\fR\fR
4265 4321  .ad
4266 4322  .sp .6
4267 4323  .RS 4n
4268 4324  The IP tunnel link is protected by IPsec policy. To display the IPsec policy
4269 4325  associated with the tunnel link, enter:
4270 4326  .sp
4271 4327  .in +2
4272 4328  .nf
4273 4329  # \fBipsecconf -ln -i \fItunnel-link\fR\fR
4274 4330  .fi
4275 4331  .in -2
4276 4332  .sp
4277 4333  
4278 4334  See \fBipsecconf\fR(1M) for more details on how to configure IPsec policy.
4279 4335  .RE
4280 4336  
4281 4337  .sp
4282 4338  .ne 2
4283 4339  .na
4284 4340  \fB\fBi\fR\fR
4285 4341  .ad
4286 4342  .sp .6
4287 4343  .RS 4n
4288 4344  The IP tunnel link was implicitly created with \fBifconfig\fR(1M), and will be
4289 4345  automatically deleted when it is no longer referenced (that is, when the last
4290 4346  IP interface over the tunnel is unplumbed). See \fBifconfig\fR(1M) for details
4291 4347  on implicit tunnel creation.
4292 4348  .RE
4293 4349  
4294 4350  .RE
4295 4351  
4296 4352  .sp
4297 4353  .ne 2
4298 4354  .na
4299 4355  \fB\fBSOURCE\fR\fR
4300 4356  .ad
4301 4357  .sp .6
4302 4358  .RS 4n
4303 4359  The tunnel source address.
4304 4360  .RE
4305 4361  
4306 4362  .sp
4307 4363  .ne 2
4308 4364  .na
4309 4365  \fB\fBDESTINATION\fR\fR
4310 4366  .ad
4311 4367  .sp .6
4312 4368  .RS 4n
4313 4369  The tunnel destination address.
4314 4370  .RE
4315 4371  
4316 4372  .RE
4317 4373  
4318 4374  .RE
4319 4375  
4320 4376  .sp
4321 4377  .ne 2
4322 4378  .na
4323 4379  \fB\fBdladm show-usage\fR [\fB-a\fR] \fB-f\fR \fIfilename\fR [\fB-p\fR
4324 4380  \fIplotfile\fR \fB-F\fR \fIformat\fR] [\fB-s\fR \fItime\fR] [\fB-e\fR
4325 4381  \fItime\fR] [\fIlink\fR]\fR
4326 4382  .ad
4327 4383  .sp .6
4328 4384  .RS 4n
4329 4385  Show the historical network usage from a stored extended accounting file.
4330 4386  Configuration and enabling of network accounting through \fBacctadm\fR(1M) is
4331 4387  required. The default output will be the summary of network usage for the
4332 4388  entire period of time in which extended accounting was enabled.
4333 4389  .sp
4334 4390  .ne 2
4335 4391  .na
4336 4392  \fB\fB-a\fR\fR
4337 4393  .ad
4338 4394  .sp .6
4339 4395  .RS 4n
4340 4396  Display all historical network usage for the specified period of time during
4341 4397  which extended accounting is enabled. This includes the usage information for
4342 4398  the links that have already been deleted.
4343 4399  .RE
4344 4400  
4345 4401  .sp
4346 4402  .ne 2
4347 4403  .na
4348 4404  \fB\fB-f\fR \fIfilename\fR, \fB--file\fR=\fIfilename\fR\fR
4349 4405  .ad
4350 4406  .sp .6
4351 4407  .RS 4n
4352 4408  Read extended accounting records of network usage from \fIfilename\fR.
4353 4409  .RE
4354 4410  
4355 4411  .sp
4356 4412  .ne 2
4357 4413  .na
4358 4414  \fB\fB-F\fR \fIformat\fR, \fB--format\fR=\fIformat\fR\fR
4359 4415  .ad
4360 4416  .sp .6
4361 4417  .RS 4n
4362 4418  Specifies the format of \fIplotfile\fR that is specified by the \fB-p\fR
4363 4419  option. As of this release, \fBgnuplot\fR is the only supported format.
4364 4420  .RE
4365 4421  
4366 4422  .sp
4367 4423  .ne 2
4368 4424  .na
4369 4425  \fB\fB-p\fR \fIplotfile\fR, \fB--plot\fR=\fIplotfile\fR\fR
4370 4426  .ad
4371 4427  .sp .6
4372 4428  .RS 4n
4373 4429  Write network usage data to a file of the format specified by the \fB-F\fR
4374 4430  option, which is required.
4375 4431  .RE
4376 4432  
4377 4433  .sp
4378 4434  .ne 2
4379 4435  .na
4380 4436  \fB\fB-s\fR \fItime\fR, \fB--start\fR=\fItime\fR\fR
4381 4437  .ad
4382 4438  .br
4383 4439  .na
4384 4440  \fB\fB-e\fR \fItime\fR, \fB--stop\fR=\fItime\fR\fR
4385 4441  .ad
4386 4442  .sp .6
4387 4443  .RS 4n
4388 4444  Start and stop times for data display. Time is in the format
4389 4445  \fIMM\fR/\fIDD\fR/\fIYYYY\fR,\fIhh\fR:\fImm\fR:\fIss\fR.
4390 4446  .RE
4391 4447  
4392 4448  .sp
4393 4449  .ne 2
4394 4450  .na
4395 4451  \fB\fIlink\fR\fR
4396 4452  .ad
4397 4453  .sp .6
4398 4454  .RS 4n
4399 4455  If specified, display the network usage only for the named link. Otherwise,
4400 4456  display network usage for all links.
4401 4457  .RE
4402 4458  
4403 4459  .RE
4404 4460  
4405 4461  .SS "Parseable Output Format"
4406 4462  .LP
4407 4463  Many \fBdladm\fR subcommands have an option that displays output in a
4408 4464  machine-parseable format. The output format is one or more lines of colon
4409 4465  (\fB:\fR) delimited fields. The fields displayed are specific to the subcommand
4410 4466  used and are listed under the entry for the \fB-o\fR option for a given
4411 4467  subcommand. Output includes only those fields requested by means of the
4412 4468  \fB-o\fR option, in the order requested.
4413 4469  .sp
4414 4470  .LP
4415 4471  When you request multiple fields, any literal colon characters are escaped by a
4416 4472  backslash (\fB\e\fR) before being output. Similarly, literal backslash
4417 4473  characters will also be escaped (\fB\e\e\fR). This escape format is parseable
4418 4474  by using shell \fBread\fR(1) functions with the environment variable
4419 4475  \fBIFS=:\fR (see \fBEXAMPLES\fR, below). Note that escaping is not done when
4420 4476  you request only a single field.
4421 4477  .SS "General Link Properties"
4422 4478  .LP
4423 4479  The following general link properties are supported:
4424 4480  .sp
4425 4481  .ne 2
4426 4482  .na
4427 4483  \fB\fBallowed-ips\fR\fR
4428 4484  .ad
4429 4485  .sp .6
4430 4486  .RS 4n
4431 4487  A comma-seperated list of IP addresses that are allowed on the interface.
4432 4488  .sp
4433 4489  An address in CIDR format with no host address specified is used to indicate
4434 4490  that any address on that subnet is allowed (e.g. 192.168.10.0/24 means any
4435 4491  address in the range 192.168.10.0 - 192.168.10.255 is allowed).
4436 4492  .RE
4437 4493  
4438 4494  .sp
4439 4495  .ne 2
4440 4496  .na
4441 4497  \fB\fBautopush\fR\fR
4442 4498  .ad
4443 4499  .sp .6
4444 4500  .RS 4n
4445 4501  Specifies the set of STREAMS modules to push on the stream associated with a
4446 4502  link when its DLPI device is opened. It is a space-delimited list of modules.
4447 4503  .sp
4448 4504  The optional special character sequence \fB[anchor]\fR indicates that a STREAMS
4449 4505  anchor should be placed on the stream at the module previously specified in the
4450 4506  list. It is an error to specify more than one anchor or to have an anchor first
4451 4507  in the list.
4452 4508  .sp
4453 4509  The \fBautopush\fR property is preferred over the more general
4454 4510  \fBautopush\fR(1M) command.
4455 4511  .RE
4456 4512  
4457 4513  .sp
4458 4514  .ne 2
4459 4515  .na
4460 4516  \fB\fBcpus\fR\fR
4461 4517  .ad
4462 4518  .sp .6
4463 4519  .RS 4n
4464 4520  Bind the processing of packets for a given data link to a processor or a set of
4465 4521  processors. The value can be a comma-separated list of one or more processor
4466 4522  ids. If the list consists of more than one processor, the processing will
4467 4523  spread out to all the processors. Connection to processor affinity and packet
4468 4524  ordering for any individual connection will be maintained.
4469 4525  .sp
4470 4526  The processor or set of processors are not exclusively reserved for the link.
4471 4527  Only the kernel threads and interrupts associated with processing of the link
4472 4528  are bound to the processor or the set of processors specified. In case it is
4473 4529  desired that processors be dedicated to the link, \fBpsrset\fR(1M) can be used
4474 4530  to create a processor set and then specifying the processors from the processor
4475 4531  set to bind the link to.
4476 4532  .sp
4477 4533  If the link was already bound to processor or set of processors due to a
4478 4534  previous operation, the binding will be removed and the new set of processors
4479 4535  will be used instead.
4480 4536  .sp
4481 4537  The default is no CPU binding, which is to say that the processing of packets
4482 4538  is not bound to any specific processor or processor set.
4483 4539  .RE
4484 4540  
4485 4541  .sp
4486 4542  .ne 2
4487 4543  .na
4488 4544  \fB\fBlearn_limit\fR\fR
4489 4545  .ad
4490 4546  .sp .6
4491 4547  .RS 4n
4492 4548  Limits the number of new or changed MAC sources to be learned over a bridge
4493 4549  link. When the number exceeds this value, learning on that link is temporarily
4494 4550  disabled. Only non-VLAN, non-VNIC type links have this property.
4495 4551  .sp
4496 4552  The default value is \fB1000\fR. Valid values are greater or equal to 0.
4497 4553  .RE
4498 4554  
4499 4555  .sp
4500 4556  .ne 2
4501 4557  .na
4502 4558  \fB\fBlearn_decay\fR\fR
4503 4559  .ad
4504 4560  .sp .6
4505 4561  .RS 4n
4506 4562  Specifies the decay rate for source changes limited by \fBlearn_limit\fR. This
4507 4563  number is subtracted from the counter for a bridge link every 5 seconds. Only
4508 4564  non-VLAN, non-VNIC type links have this property.
4509 4565  .sp
4510 4566  The default value is \fB200\fR. Valid values are greater or equal to 0.
4511 4567  .RE
4512 4568  
4513 4569  .sp
4514 4570  .ne 2
4515 4571  .na
4516 4572  \fB\fBmaxbw\fR\fR
4517 4573  .ad
4518 4574  .sp .6
4519 4575  .RS 4n
4520 4576  Sets the full duplex bandwidth for the link. The bandwidth is specified as an
4521 4577  integer with one of the scale suffixes (\fBK\fR, \fBM\fR, or \fBG\fR for Kbps,
4522 4578  Mbps, and Gbps). If no units are specified, the input value will be read as
4523 4579  Mbps. The default is no bandwidth limit.
4524 4580  .RE
4525 4581  
4526 4582  .sp
4527 4583  .ne 2
4528 4584  .na
4529 4585  \fB\fBpriority\fR\fR
4530 4586  .ad
4531 4587  .sp .6
4532 4588  .RS 4n
4533 4589  Sets the relative priority for the link. The value can be given as one of the
4534 4590  tokens \fBhigh\fR, \fBmedium\fR, or \fBlow\fR. The default is \fBhigh\fR.
4535 4591  .RE
4536 4592  
4537 4593  .sp
4538 4594  .ne 2
4539 4595  .na
4540 4596  \fB\fBstp\fR\fR
4541 4597  .ad
4542 4598  .sp .6
4543 4599  .RS 4n
4544 4600  Enables or disables Spanning Tree Protocol on a bridge link. Setting this value
4545 4601  to \fB0\fR disables Spanning Tree, and puts the link into forwarding mode with
4546 4602  BPDU guarding enabled. This mode is appropriate for point-to-point links
4547 4603  connected only to end nodes. Only non-VLAN, non-VNIC type links have this
4548 4604  property. The default value is \fB1\fR, to enable STP.
4549 4605  .RE
4550 4606  
4551 4607  .sp
4552 4608  .ne 2
4553 4609  .na
4554 4610  \fB\fBforward\fR\fR
4555 4611  .ad
4556 4612  .sp .6
4557 4613  .RS 4n
4558 4614  Enables or disables forwarding for a VLAN. Setting this value to \fB0\fR
4559 4615  disables bridge forwarding for a VLAN link. Disabling bridge forwarding removes
4560 4616  that VLAN from the "allowed set" for the bridge. The default value is \fB1\fR,
4561 4617  to enable bridge forwarding for configured VLANs.
4562 4618  .RE
4563 4619  
4564 4620  .sp
4565 4621  .ne 2
4566 4622  .na
4567 4623  \fB\fBdefault_tag\fR\fR
4568 4624  .ad
4569 4625  .sp .6
4570 4626  .RS 4n
4571 4627  Sets the default VLAN ID that is assumed for untagged packets sent to and
4572 4628  received from this link. Only non-VLAN, non-VNIC type links have this property.
4573 4629  Setting this value to \fB0\fR disables the bridge forwarding of untagged
4574 4630  packets to and from the port. The default value is \fBVLAN ID 1\fR. Valid
4575 4631  values values are from 0 to 4094.
4576 4632  .RE
4577 4633  
4578 4634  .sp
4579 4635  .ne 2
4580 4636  .na
4581 4637  \fB\fBstp_priority\fR\fR
4582 4638  .ad
4583 4639  .sp .6
4584 4640  .RS 4n
4585 4641  Sets the STP and RSTP Port Priority value, which is used to determine the
4586 4642  preferred root port on a bridge. Lower numerical values are higher priority.
4587 4643  The default value is \fB128\fR. Valid values range from 0 to 255.
4588 4644  .RE
4589 4645  
4590 4646  .sp
4591 4647  .ne 2
4592 4648  .na
4593 4649  \fB\fBstp_cost\fR\fR
4594 4650  .ad
4595 4651  .sp .6
4596 4652  .RS 4n
4597 4653  Sets the STP and RSTP cost for using the link. The default value is \fBauto\fR,
4598 4654  which sets the cost based on link speed, using \fB100\fR for 10Mbps, \fB19\fR
4599 4655  for 100Mbps, \fB4\fR for 1Gbps, and \fB2\fR for 10Gbps. Valid values range from
4600 4656  1 to 65535.
4601 4657  .RE
4602 4658  
4603 4659  .sp
4604 4660  .ne 2
4605 4661  .na
4606 4662  \fB\fBstp_edge\fR\fR
4607 4663  .ad
4608 4664  .sp .6
4609 4665  .RS 4n
4610 4666  Enables or disables bridge edge port detection. If set to \fB0\fR (false), the
4611 4667  system assumes that the port is connected to other bridges even if no bridge
4612 4668  PDUs of any type are seen. The default value is \fB1\fR, which detects edge
4613 4669  ports automatically.
4614 4670  .RE
4615 4671  
4616 4672  .sp
4617 4673  .ne 2
4618 4674  .na
4619 4675  \fB\fBstp_p2p\fR\fR
4620 4676  .ad
4621 4677  .sp .6
4622 4678  .RS 4n
4623 4679  Sets bridge point-to-point operation mode. Possible values are \fBtrue\fR,
4624 4680  \fBfalse\fR, and \fBauto\fR. When set to \fBauto\fR, point-to-point connections
4625 4681  are automatically discovered. When set to \fBtrue\fR, the port mode is forced
4626 4682  to use point-to-point. When set to \fBfalse\fR, the port mode is forced to use
4627 4683  normal multipoint mode. The default value is \fBauto\fR.
4628 4684  .RE
4629 4685  
4630 4686  .sp
4631 4687  .ne 2
4632 4688  .na
4633 4689  \fB\fBstp_mcheck\fR\fR
4634 4690  .ad
4635 4691  .sp .6
4636 4692  .RS 4n
4637 4693  Triggers the system to run the RSTP \fBForce BPDU Migration Check\fR procedure
4638 4694  on this link. The procedure is triggered by setting the property value to
4639 4695  \fB1\fR. The property is automatically reset back to \fB0\fR. This value cannot
4640 4696  be set unless the following are true:
4641 4697  .RS +4
4642 4698  .TP
4643 4699  .ie t \(bu
4644 4700  .el o
4645 4701  The link is bridged
4646 4702  .RE
4647 4703  .RS +4
4648 4704  .TP
4649 4705  .ie t \(bu
4650 4706  .el o
4651 4707  The bridge is protected by Spanning Tree
4652 4708  .RE
4653 4709  .RS +4
4654 4710  .TP
4655 4711  .ie t \(bu
4656 4712  .el o
4657 4713  The bridge \fBforce-protocol\fR value is at least 2 (RSTP)
4658 4714  .RE
4659 4715  The default value is 0.
4660 4716  .RE
4661 4717  
4662 4718  .sp
4663 4719  .ne 2
4664 4720  .na
4665 4721  \fB\fBzone\fR\fR
4666 4722  .ad
4667 4723  .sp .6
4668 4724  .RS 4n
4669 4725  Specifies the zone to which the link belongs. This property can be modified
4670 4726  only temporarily through \fBdladm\fR, and thus the \fB-t\fR option must be
4671 4727  specified. To modify the zone assignment such that it persists across reboots,
4672 4728  please use \fBzonecfg\fR(1M). Possible values consist of any exclusive-IP zone
4673 4729  currently running on the system. By default, the zone binding is as per
4674 4730  \fBzonecfg\fR(1M).
4675 4731  .RE
4676 4732  
4677 4733  .SS "Wifi Link Properties"
4678 4734  .LP
4679 4735  The following \fBWiFi\fR link properties are supported. Note that the ability
4680 4736  to set a given property to a given value depends on the driver and hardware.
4681 4737  .sp
4682 4738  .ne 2
4683 4739  .na
4684 4740  \fB\fBchannel\fR\fR
4685 4741  .ad
4686 4742  .sp .6
4687 4743  .RS 4n
4688 4744  Specifies the channel to use. This property can be modified only by certain
4689 4745  \fBWiFi\fR links when in \fBIBSS\fR mode. The default value and allowed range
4690 4746  of values varies by regulatory domain.
4691 4747  .RE
4692 4748  
4693 4749  .sp
4694 4750  .ne 2
4695 4751  .na
4696 4752  \fB\fBpowermode\fR\fR
4697 4753  .ad
4698 4754  .sp .6
4699 4755  .RS 4n
4700 4756  Specifies the power management mode of the \fBWiFi\fR link. Possible values are
4701 4757  \fBoff\fR (disable power management), \fBmax\fR (maximum power savings), and
4702 4758  \fBfast\fR (performance-sensitive power management). Default is \fBoff\fR.
4703 4759  .RE
4704 4760  
4705 4761  .sp
4706 4762  .ne 2
4707 4763  .na
4708 4764  \fB\fBradio\fR\fR
4709 4765  .ad
4710 4766  .sp .6
4711 4767  .RS 4n
4712 4768  Specifies the radio mode of the \fBWiFi\fR link. Possible values are \fBon\fR
4713 4769  or \fBoff\fR. Default is \fBon\fR.
4714 4770  .RE
4715 4771  
4716 4772  .sp
4717 4773  .ne 2
4718 4774  .na
4719 4775  \fB\fBspeed\fR\fR
4720 4776  .ad
4721 4777  .sp .6
4722 4778  .RS 4n
4723 4779  Specifies a fixed speed for the \fBWiFi\fR link, in megabits per second. The
4724 4780  set of possible values depends on the driver and hardware (but is shown by
4725 4781  \fBshow-linkprop\fR); common speeds include 1, 2, 11, and 54. By default, there
4726 4782  is no fixed speed.
4727 4783  .RE
4728 4784  
4729 4785  .SS "Ethernet Link Properties"
4730 4786  .LP
4731 4787  The following MII Properties, as documented in \fBieee802.3\fR(5), are
4732 4788  supported in read-only mode:
4733 4789  .RS +4
4734 4790  .TP
4735 4791  .ie t \(bu
4736 4792  .el o
4737 4793  \fBduplex\fR
4738 4794  .RE
4739 4795  .RS +4
4740 4796  .TP
4741 4797  .ie t \(bu
4742 4798  .el o
4743 4799  \fBstate\fR
4744 4800  .RE
4745 4801  .RS +4
4746 4802  .TP
4747 4803  .ie t \(bu
4748 4804  .el o
4749 4805  \fBadv_autoneg_cap\fR
4750 4806  .RE
4751 4807  .RS +4
4752 4808  .TP
4753 4809  .ie t \(bu
4754 4810  .el o
4755 4811  \fBadv_10gfdx_cap\fR
4756 4812  .RE
4757 4813  .RS +4
4758 4814  .TP
4759 4815  .ie t \(bu
4760 4816  .el o
4761 4817  \fBadv_1000fdx_cap\fR
4762 4818  .RE
4763 4819  .RS +4
4764 4820  .TP
4765 4821  .ie t \(bu
4766 4822  .el o
4767 4823  \fBadv_1000hdx_cap\fR
4768 4824  .RE
4769 4825  .RS +4
4770 4826  .TP
4771 4827  .ie t \(bu
4772 4828  .el o
4773 4829  \fBadv_100fdx_cap\fR
4774 4830  .RE
4775 4831  .RS +4
4776 4832  .TP
4777 4833  .ie t \(bu
4778 4834  .el o
4779 4835  \fBadv_100hdx_cap\fR
4780 4836  .RE
4781 4837  .RS +4
4782 4838  .TP
4783 4839  .ie t \(bu
4784 4840  .el o
4785 4841  \fBadv_10fdx_cap\fR
4786 4842  .RE
4787 4843  .RS +4
4788 4844  .TP
4789 4845  .ie t \(bu
4790 4846  .el o
4791 4847  \fBadv_10hdx_cap\fR
4792 4848  .RE
4793 4849  .sp
4794 4850  .LP
4795 4851  Each \fBadv_\fR property (for example, \fBadv_10fdx_cap\fR) also has a
4796 4852  read/write counterpart \fBen_\fR property (for example, \fBen_10fdx_cap\fR)
4797 4853  controlling parameters used at auto-negotiation. In the absence of Power
4798 4854  Management, the \fBadv\fR* speed/duplex parameters provide the values that are
4799 4855  both negotiated and currently effective in hardware. However, with Power
4800 4856  Management enabled, the speed/duplex capabilities currently exposed in hardware
4801 4857  might be a subset of the set of bits that were used in initial link parameter
4802 4858  negotiation. Thus the MII \fBadv_\fR* parameters are marked read-only, with an
4803 4859  additional set of \fBen_\fR* parameters for configuring speed and duplex
4804 4860  properties at initial negotiation.
4805 4861  .sp
4806 4862  .LP
4807 4863  Note that the \fBadv_autoneg_cap\fR does not have an \fBen_autoneg_cap\fR
4808 4864  counterpart: the \fBadv_autoneg_cap\fR is a 0/1 switch that turns off/on
4809 4865  autonegotiation itself, and therefore cannot be impacted by Power Management.
4810 4866  .sp
4811 4867  .LP
4812 4868  In addition, the following Ethernet properties are reported:
4813 4869  .sp
4814 4870  .ne 2
4815 4871  .na
4816 4872  \fB\fBspeed\fR\fR
4817 4873  .ad
4818 4874  .sp .6
4819 4875  .RS 4n
4820 4876  (read-only) The operating speed of the device, in Mbps.
4821 4877  .RE
4822 4878  
4823 4879  .sp
4824 4880  .ne 2
4825 4881  .na
4826 4882  \fB\fBmtu\fR\fR
4827 4883  .ad
4828 4884  .sp .6
4829 4885  .RS 4n
4830 4886  The maximum client SDU (Send Data Unit) supported by the device. Valid range is
4831 4887  68-65536.
4832 4888  .RE
4833 4889  
4834 4890  .sp
4835 4891  .ne 2
4836 4892  .na
4837 4893  \fB\fBflowctrl\fR\fR
4838 4894  .ad
4839 4895  .sp .6
4840 4896  .RS 4n
4841 4897  Establishes flow-control modes that will be advertised by the device. Valid
4842 4898  input is one of:
4843 4899  .sp
4844 4900  .ne 2
4845 4901  .na
4846 4902  \fB\fBno\fR\fR
4847 4903  .ad
4848 4904  .sp .6
4849 4905  .RS 4n
4850 4906  No flow control enabled.
4851 4907  .RE
4852 4908  
4853 4909  .sp
4854 4910  .ne 2
4855 4911  .na
4856 4912  \fB\fBrx\fR\fR
4857 4913  .ad
4858 4914  .sp .6
4859 4915  .RS 4n
4860 4916  Receive, and act upon incoming pause frames.
4861 4917  .RE
4862 4918  
4863 4919  .sp
4864 4920  .ne 2
4865 4921  .na
4866 4922  \fB\fBtx\fR\fR
4867 4923  .ad
4868 4924  .sp .6
4869 4925  .RS 4n
4870 4926  Transmit pause frames to the peer when congestion occurs, but ignore received
4871 4927  pause frames.
4872 4928  .RE
4873 4929  
4874 4930  .sp
4875 4931  .ne 2
4876 4932  .na
4877 4933  \fB\fBbi\fR\fR
4878 4934  .ad
4879 4935  .sp .6
4880 4936  .RS 4n
4881 4937  Bidirectional flow control.
4882 4938  .RE
4883 4939  
4884 4940  Note that the actual settings for this value are constrained by the
4885 4941  capabilities allowed by the device and the link partner.
4886 4942  .RE
4887 4943  
4888 4944  .sp
4889 4945  .ne 2
4890 4946  .na
4891 4947  \fB\fBsecondary-macs\fR\fR
4892 4948  .ad
4893 4949  .sp .6
4894 4950  .RS 4n
4895 4951  A comma-seperated list of additional MAC addresses that are allowed on the
4896 4952  interface.
4897 4953  .RE
4898 4954  
4899 4955  .sp
4900 4956  .ne 2
4901 4957  .na
4902 4958  \fB\fBtagmode\fR\fR
4903 4959  .ad
4904 4960  .sp .6
4905 4961  .RS 4n
4906 4962  This link property controls the conditions in which 802.1Q VLAN tags will be
4907 4963  inserted in packets being transmitted on the link. Two mode values can be
4908 4964  assigned to this property:
4909 4965  .sp
4910 4966  .ne 2
4911 4967  .na
4912 4968  \fB\fBnormal\fR\fR
4913 4969  .ad
4914 4970  .RS 12n
4915 4971  Insert a VLAN tag in outgoing packets under the following conditions:
4916 4972  .RS +4
4917 4973  .TP
4918 4974  .ie t \(bu
4919 4975  .el o
4920 4976  The packet belongs to a VLAN.
4921 4977  .RE
4922 4978  .RS +4
4923 4979  .TP
4924 4980  .ie t \(bu
4925 4981  .el o
4926 4982  The user requested priority tagging.
4927 4983  .RE
4928 4984  .RE
4929 4985  
4930 4986  .sp
4931 4987  .ne 2
4932 4988  .na
4933 4989  \fB\fBvlanonly\fR\fR
4934 4990  .ad
4935 4991  .RS 12n
4936 4992  Insert a VLAN tag only when the outgoing packet belongs to a VLAN. If a tag is
4937 4993  being inserted in this mode and the user has also requested a non-zero
4938 4994  priority, the priority is honored and included in the VLAN tag.
4939 4995  .RE
4940 4996  
4941 4997  The default value is \fBvlanonly\fR.
4942 4998  .RE
4943 4999  
4944 5000  .SS "IP Tunnel Link Properties"
4945 5001  .LP
4946 5002  The following IP tunnel link properties are supported.
4947 5003  .sp
4948 5004  .ne 2
4949 5005  .na
4950 5006  \fB\fBhoplimit\fR\fR
4951 5007  .ad
4952 5008  .sp .6
4953 5009  .RS 4n
4954 5010  Specifies the IPv4 TTL or IPv6 hop limit for the encapsulating outer IP header
4955 5011  of a tunnel link. This property exists for all tunnel types. The default value
4956 5012  is 64.
4957 5013  .RE
4958 5014  
4959 5015  .sp
4960 5016  .ne 2
4961 5017  .na
4962 5018  \fB\fBencaplimit\fR\fR
4963 5019  .ad
4964 5020  .sp .6
4965 5021  .RS 4n
4966 5022  Specifies the IPv6 encapsulation limit for an IPv6 tunnel as defined in RFC
4967 5023  2473. This value is the tunnel nesting limit for a given tunneled packet. The
4968 5024  default value is 4. A value of 0 disables the encapsulation limit.
4969 5025  .RE
4970 5026  
4971 5027  .SH EXAMPLES
4972 5028  .LP
4973 5029  \fBExample 1 \fRConfiguring an Aggregation
4974 5030  .sp
4975 5031  .LP
4976 5032  To configure a data-link over an aggregation of devices \fBbge0\fR and
4977 5033  \fBbge1\fR with key 1, enter the following command:
4978 5034  
4979 5035  .sp
4980 5036  .in +2
4981 5037  .nf
4982 5038  # \fBdladm create-aggr -d bge0 -d bge1 1\fR
4983 5039  .fi
4984 5040  .in -2
4985 5041  .sp
4986 5042  
4987 5043  .LP
4988 5044  \fBExample 2 \fRConnecting to a WiFi Link
4989 5045  .sp
4990 5046  .LP
4991 5047  To connect to the most optimal available unsecured network on a system with a
4992 5048  single \fBWiFi\fR link (as per the prioritization rules specified for
4993 5049  \fBconnect-wifi\fR), enter the following command:
4994 5050  
4995 5051  .sp
4996 5052  .in +2
4997 5053  .nf
4998 5054  # \fBdladm connect-wifi\fR
4999 5055  .fi
5000 5056  .in -2
5001 5057  .sp
5002 5058  
5003 5059  .LP
5004 5060  \fBExample 3 \fRCreating a WiFi Key
5005 5061  .sp
5006 5062  .LP
5007 5063  To interactively create the \fBWEP\fR key \fBmykey\fR, enter the following
5008 5064  command:
5009 5065  
5010 5066  .sp
5011 5067  .in +2
5012 5068  .nf
5013 5069  # \fBdladm create-secobj -c wep mykey\fR
5014 5070  .fi
5015 5071  .in -2
5016 5072  .sp
5017 5073  
5018 5074  .sp
5019 5075  .LP
5020 5076  Alternatively, to non-interactively create the \fBWEP\fR key \fBmykey\fR using
5021 5077  the contents of a file:
5022 5078  
5023 5079  .sp
5024 5080  .in +2
5025 5081  .nf
5026 5082  # \fBumask 077\fR
5027 5083   # \fBcat >/tmp/mykey.$$ <<EOF\fR
5028 5084   \fB12345\fR
5029 5085   \fBEOF\fR
5030 5086   # \fBdladm create-secobj -c wep -f /tmp/mykey.$$ mykey\fR
5031 5087   # \fBrm /tmp/mykey.$$\fR
5032 5088  .fi
5033 5089  .in -2
5034 5090  .sp
5035 5091  
5036 5092  .LP
5037 5093  \fBExample 4 \fRConnecting to a Specified Encrypted WiFi Link
5038 5094  .sp
5039 5095  .LP
5040 5096  To use key \fBmykey\fR to connect to \fBESSID\fR \fBwlan\fR on link \fBath0\fR,
5041 5097  enter the following command:
5042 5098  
5043 5099  .sp
5044 5100  .in +2
5045 5101  .nf
5046 5102  # \fBdladm connect-wifi -k mykey -e wlan ath0\fR
5047 5103  .fi
5048 5104  .in -2
5049 5105  .sp
5050 5106  
5051 5107  .LP
5052 5108  \fBExample 5 \fRChanging a Link Property
5053 5109  .sp
5054 5110  .LP
5055 5111  To set \fBpowermode\fR to the value \fBfast\fR on link \fBpcwl0\fR, enter the
5056 5112  following command:
5057 5113  
5058 5114  .sp
5059 5115  .in +2
5060 5116  .nf
5061 5117  # \fBdladm set-linkprop -p powermode=fast pcwl0\fR
5062 5118  .fi
5063 5119  .in -2
5064 5120  .sp
5065 5121  
5066 5122  .LP
5067 5123  \fBExample 6 \fRConnecting to a WPA-Protected WiFi Link
5068 5124  .sp
5069 5125  .LP
5070 5126  Create a WPA key \fBpsk\fR and enter the following command:
5071 5127  
5072 5128  .sp
5073 5129  .in +2
5074 5130  .nf
5075 5131  # \fBdladm create-secobj -c wpa psk\fR
5076 5132  .fi
5077 5133  .in -2
5078 5134  .sp
5079 5135  
5080 5136  .sp
5081 5137  .LP
5082 5138  To then use key \fBpsk\fR to connect to ESSID \fBwlan\fR on link \fBath0\fR,
5083 5139  enter the following command:
5084 5140  
5085 5141  .sp
5086 5142  .in +2
5087 5143  .nf
5088 5144  # \fBdladm connect-wifi -k psk -e wlan ath0\fR
5089 5145  .fi
5090 5146  .in -2
5091 5147  .sp
5092 5148  
5093 5149  .LP
5094 5150  \fBExample 7 \fRRenaming a Link
5095 5151  .sp
5096 5152  .LP
5097 5153  To rename the \fBbge0\fR link to \fBmgmt0\fR, enter the following command:
5098 5154  
5099 5155  .sp
5100 5156  .in +2
5101 5157  .nf
5102 5158  # \fBdladm rename-link bge0 mgmt0\fR
5103 5159  .fi
5104 5160  .in -2
5105 5161  .sp
5106 5162  
5107 5163  .LP
5108 5164  \fBExample 8 \fRReplacing a Network Card
5109 5165  .sp
5110 5166  .LP
5111 5167  Consider that the \fBbge0\fR device, whose link was named \fBmgmt0\fR as shown
5112 5168  in the previous example, needs to be replaced with a \fBce0\fR device because
5113 5169  of a hardware failure. The \fBbge0\fR NIC is physically removed, and replaced
5114 5170  with a new \fBce0\fR NIC. To associate the newly added \fBce0\fR device with
5115 5171  the \fBmgmt0\fR configuration previously associated with \fBbge0\fR, enter the
5116 5172  following command:
5117 5173  
5118 5174  .sp
5119 5175  .in +2
5120 5176  .nf
5121 5177  # \fBdladm rename-link ce0 mgmt0\fR
5122 5178  .fi
5123 5179  .in -2
5124 5180  .sp
5125 5181  
5126 5182  .LP
5127 5183  \fBExample 9 \fRRemoving a Network Card
5128 5184  .sp
5129 5185  .LP
5130 5186  Suppose that in the previous example, the intent is not to replace the
5131 5187  \fBbge0\fR NIC with another NIC, but rather to remove and not replace the
5132 5188  hardware. In that case, the \fBmgmt0\fR datalink configuration is not slated to
5133 5189  be associated with a different physical device as shown in the previous
5134 5190  example, but needs to be deleted. Enter the following command to delete the
5135 5191  datalink configuration associated with the \fBmgmt0\fR datalink, whose physical
5136 5192  hardware (\fBbge0\fR in this case) has been removed:
5137 5193  
5138 5194  .sp
5139 5195  .in +2
5140 5196  .nf
5141 5197  # \fBdladm delete-phys mgmt0\fR
5142 5198  .fi
5143 5199  .in -2
5144 5200  .sp
5145 5201  
5146 5202  .LP
5147 5203  \fBExample 10 \fRUsing Parseable Output to Capture a Single Field
5148 5204  .sp
5149 5205  .LP
5150 5206  The following assignment saves the MTU of link \fBnet0\fR to a variable named
5151 5207  \fBmtu\fR.
5152 5208  
5153 5209  .sp
5154 5210  .in +2
5155 5211  .nf
5156 5212  # \fBmtu=`dladm show-link -p -o mtu net0`\fR
5157 5213  .fi
5158 5214  .in -2
5159 5215  .sp
5160 5216  
5161 5217  .LP
5162 5218  \fBExample 11 \fRUsing Parseable Output to Iterate over Links
5163 5219  .sp
5164 5220  .LP
5165 5221  The following script displays the state of each link on the system.
5166 5222  
5167 5223  .sp
5168 5224  .in +2
5169 5225  .nf
5170 5226  # \fBdladm show-link -p -o link,state | while IFS=: read link state; do
5171 5227              print "Link $link is in state $state"
5172 5228          done\fR
5173 5229  .fi
5174 5230  .in -2
5175 5231  .sp
5176 5232  
5177 5233  .LP
5178 5234  \fBExample 12 \fRConfiguring VNICs
5179 5235  .sp
5180 5236  .LP
5181 5237  Create two VNICs with names \fBhello0\fR and \fBtest1\fR over a single physical
5182 5238  link \fBbge0\fR:
5183 5239  
5184 5240  .sp
5185 5241  .in +2
5186 5242  .nf
5187 5243  # \fBdladm create-vnic -l bge0 hello0\fR
5188 5244  # \fBdladm create-vnic -l bge0 test1\fR
5189 5245  .fi
5190 5246  .in -2
5191 5247  .sp
5192 5248  
5193 5249  .LP
5194 5250  \fBExample 13 \fRConfiguring VNICs and Allocating Bandwidth and Priority
5195 5251  .sp
5196 5252  .LP
5197 5253  Create two VNICs with names \fBhello0\fR and \fBtest1\fR over a single physical
5198 5254  link \fBbge0\fR and make \fBhello0\fR a high priority VNIC with a
5199 5255  factory-assigned MAC address with a maximum bandwidth of 50 Mbps. Make
5200 5256  \fBtest1\fR a low priority VNIC with a random MAC address and a maximum
5201 5257  bandwidth of 100Mbps.
5202 5258  
5203 5259  .sp
5204 5260  .in +2
5205 5261  .nf
5206 5262  # \fBdladm create-vnic -l bge0 -m factory -p maxbw=50,priority=high hello0\fR
5207 5263  # \fBdladm create-vnic -l bge0 -m random -p maxbw=100M,priority=low test1\fR
5208 5264  .fi
5209 5265  .in -2
5210 5266  .sp
5211 5267  
5212 5268  .LP
5213 5269  \fBExample 14 \fRConfiguring a VNIC with a Factory MAC Address
5214 5270  .sp
5215 5271  .LP
5216 5272  First, list the available factory MAC addresses and choose one of them:
5217 5273  
5218 5274  .sp
5219 5275  .in +2
5220 5276  .nf
5221 5277  # \fBdladm show-phys -m bge0\fR
5222 5278  LINK            SLOT         ADDRESS              INUSE    CLIENT
5223 5279  bge0            primary      0:e0:81:27:d4:47     yes      bge0
5224 5280  bge0            1            8:0:20:fe:4e:a5      no
5225 5281  bge0            2            8:0:20:fe:4e:a6      no
5226 5282  bge0            3            8:0:20:fe:4e:a7      no
5227 5283  .fi
5228 5284  .in -2
5229 5285  .sp
5230 5286  
5231 5287  .sp
5232 5288  .LP
5233 5289  Create a VNIC named \fBhello0\fR and use slot 1's address:
5234 5290  
5235 5291  .sp
5236 5292  .in +2
5237 5293  .nf
5238 5294  # \fBdladm create-vnic -l bge0 -m factory -n 1 hello0\fR
5239 5295  # \fBdladm show-phys -m bge0\fR
5240 5296  LINK            SLOT         ADDRESS              INUSE    CLIENT
5241 5297  bge0            primary      0:e0:81:27:d4:47     yes      bge0
5242 5298  bge0            1            8:0:20:fe:4e:a5      yes      hello0
5243 5299  bge0            2            8:0:20:fe:4e:a6      no
5244 5300  bge0            3            8:0:20:fe:4e:a7      no
5245 5301  .fi
5246 5302  .in -2
5247 5303  .sp
5248 5304  
5249 5305  .LP
5250 5306  \fBExample 15 \fRCreating a VNIC with User-Specified MAC Address, Binding it to
5251 5307  Set of Processors
5252 5308  .sp
5253 5309  .LP
5254 5310  Create a VNIC with name \fBhello0\fR, with a user specified MAC address, and a
5255 5311  processor binding \fB0, 1, 2, 3\fR.
5256 5312  
5257 5313  .sp
5258 5314  .in +2
5259 5315  .nf
5260 5316  # \fBdladm create-vnic -l bge0 -m 8:0:20:fe:4e:b8 -p cpus=0,1,2,3 hello0\fR
5261 5317  .fi
5262 5318  .in -2
5263 5319  .sp
5264 5320  
5265 5321  .LP
5266 5322  \fBExample 16 \fRCreating a Virtual Network Without a Physical NIC
5267 5323  .sp
5268 5324  .LP
5269 5325  First, create an etherstub with name \fBstub1\fR:
5270 5326  
5271 5327  .sp
5272 5328  .in +2
5273 5329  .nf
5274 5330  # \fBdladm create-etherstub stub1\fR
5275 5331  .fi
5276 5332  .in -2
5277 5333  .sp
5278 5334  
5279 5335  .sp
5280 5336  .LP
5281 5337  Create two VNICs with names \fBhello0\fR and \fBtest1\fR on the etherstub. This
5282 5338  operation implicitly creates a virtual switch connecting \fBhello0\fR and
5283 5339  \fBtest1\fR.
5284 5340  
5285 5341  .sp
5286 5342  .in +2
5287 5343  .nf
5288 5344  # \fBdladm create-vnic -l stub1 hello0\fR
5289 5345  # \fBdladm create-vnic -l stub1 test1\fR
5290 5346  .fi
5291 5347  .in -2
5292 5348  .sp
5293 5349  
5294 5350  .LP
5295 5351  \fBExample 17 \fRShowing Network Usage
5296 5352  .sp
5297 5353  .LP
5298 5354  Network usage statistics can be stored using the extended accounting facility,
5299 5355  \fBacctadm\fR(1M).
5300 5356  
5301 5357  .sp
5302 5358  .in +2
5303 5359  .nf
5304 5360  # \fBacctadm -e basic -f /var/log/net.log net\fR
5305 5361  # \fBacctadm net\fR
5306 5362            Network accounting: active
5307 5363       Network accounting file: /var/log/net.log
5308 5364     Tracked Network resources: basic
5309 5365   Untracked Network resources: src_ip,dst_ip,src_port,dst_port,protocol,
5310 5366                                dsfield
5311 5367  .fi
5312 5368  .in -2
5313 5369  .sp
5314 5370  
5315 5371  .sp
5316 5372  .LP
5317 5373  The saved historical data can be retrieved in summary form using the
5318 5374  \fBshow-usage\fR subcommand:
5319 5375  
5320 5376  .sp
5321 5377  .in +2
5322 5378  .nf
5323 5379  # \fBdladm show-usage -f /var/log/net.log\fR
5324 5380  LINK      DURATION  IPACKETS RBYTES      OPACKETS OBYTES      BANDWIDTH
5325 5381  e1000g0   80        1031     546908      0        0           2.44 Kbps
5326 5382  .fi
5327 5383  .in -2
5328 5384  .sp
5329 5385  
5330 5386  .LP
5331 5387  \fBExample 18 \fRDisplaying Bridge Information
5332 5388  .sp
5333 5389  .LP
5334 5390  The following commands use the \fBshow-bridge\fR subcommand with no and various
5335 5391  options.
5336 5392  
5337 5393  .sp
5338 5394  .in +2
5339 5395  .nf
5340 5396  # \fBdladm show-bridge\fR
5341 5397  BRIDGE       PROTECT ADDRESS           PRIORITY DESROOT
5342 5398  foo          stp     32768/8:0:20:bf:f 32768    8192/0:d0:0:76:14:38
5343 5399  bar          stp     32768/8:0:20:e5:8 32768    8192/0:d0:0:76:14:38
5344 5400  
5345 5401  # \fBdladm show-bridge -l foo\fR
5346 5402  LINK         STATE        UPTIME   DESROOT
5347 5403  hme0         forwarding   117      8192/0:d0:0:76:14:38
5348 5404  qfe1         forwarding   117      8192/0:d0:0:76:14:38
5349 5405  
5350 5406  # \fBdladm show-bridge -s foo\fR
5351 5407  BRIDGE       DROPS        FORWARDS
5352 5408  foo          0            302
5353 5409  
5354 5410  # \fBdladm show-bridge -ls foo\fR
5355 5411  LINK         DROPS     RECV      XMIT
5356 5412  hme0         0         360832    31797
5357 5413  qfe1         0         322311    356852
5358 5414  
5359 5415  # \fBdladm show-bridge -f foo\fR
5360 5416  DEST              AGE     FLAGS  OUTPUT
5361 5417  8:0:20:bc:a7:dc   10.860  --     hme0
5362 5418  8:0:20:bf:f9:69   --      L      hme0
5363 5419  8:0:20:c0:20:26   17.420  --     hme0
5364 5420  8:0:20:e5:86:11   --      L      qfe1
5365 5421  .fi
5366 5422  .in -2
5367 5423  .sp
5368 5424  
5369 5425  .LP
5370 5426  \fBExample 19 \fRCreating an IPv4 Tunnel
5371 5427  .sp
5372 5428  .LP
5373 5429  The following sequence of commands creates and then displays a persistent IPv4
5374 5430  tunnel link named \fBmytunnel0\fR between 66.1.2.3 and 192.4.5.6:
5375 5431  
5376 5432  .sp
5377 5433  .in +2
5378 5434  .nf
5379 5435  # \fBdladm create-iptun -T ipv4 -s 66.1.2.3 -d 192.4.5.6 mytunnel0\fR
5380 5436  # \fBdladm show-iptun mytunnel0\fR
5381 5437  LINK            TYPE  FLAGS  SOURCE              DESTINATION
5382 5438  mytunnel0       ipv4  --     66.1.2.3            192.4.5.6
5383 5439  .fi
5384 5440  .in -2
5385 5441  .sp
5386 5442  
5387 5443  .sp
5388 5444  .LP
5389 5445  A point-to-point IP interface can then be created over this tunnel link:
5390 5446  
5391 5447  .sp
5392 5448  .in +2
5393 5449  .nf
5394 5450  # \fBifconfig mytunnel0 plumb 10.1.0.1 10.1.0.2 up\fR
5395 5451  .fi
5396 5452  .in -2
5397 5453  .sp
5398 5454  
5399 5455  .sp
5400 5456  .LP
5401 5457  As with any other IP interface, configuration persistence for this IP interface
5402 5458  is achieved by placing the desired \fBifconfig\fR commands (in this case, the
5403 5459  command for "\fB10.1.0.1 10.1.0.2\fR") into \fB/etc/hostname.mytunnel0\fR.
5404 5460  
5405 5461  .LP
5406 5462  \fBExample 20 \fRCreating a 6to4 Tunnel
5407 5463  .sp
5408 5464  .LP
5409 5465  The following command creates a 6to4 tunnel link. The IPv4 address of the 6to4
5410 5466  router is 75.10.11.12.
5411 5467  
5412 5468  .sp
5413 5469  .in +2
5414 5470  .nf
5415 5471  # \fBdladm create-iptun -T 6to4 -s 75.10.11.12 sitetunnel0\fR
5416 5472  # \fBdladm show-iptun sitetunnel0\fR
5417 5473  LINK            TYPE  FLAGS  SOURCE              DESTINATION
5418 5474  sitetunnel0     6to4  --     75.10.11.12         --
5419 5475  .fi
5420 5476  .in -2
5421 5477  .sp
5422 5478  
5423 5479  .sp
5424 5480  .LP
5425 5481  The following command plumbs an IPv6 interface on this tunnel:
5426 5482  
5427 5483  .sp
5428 5484  .in +2
5429 5485  .nf
5430 5486  # \fBifconfig sitetunnel0 inet6 plumb up\fR
5431 5487  # \fBifconfig sitetunnel0 inet6\fR
5432 5488  sitetunnel0: flags=2200041 <UP,RUNNING,NONUD,IPv6> mtu 65515 index 3
5433 5489          inet tunnel src 75.10.11.12
5434 5490          tunnel hop limit 64
5435 5491          inet6 2002:4b0a:b0c::1/16
5436 5492  .fi
5437 5493  .in -2
5438 5494  .sp
5439 5495  
5440 5496  .sp
5441 5497  .LP
5442 5498  Note that the system automatically configures the IPv6 address on the 6to4 IP
5443 5499  interface. See \fBifconfig\fR(1M) for a description of how IPv6 addresses are
5444 5500  configured on 6to4 tunnel links.
5445 5501  
5446 5502  .SH ATTRIBUTES
5447 5503  .LP
5448 5504  See \fBattributes\fR(5) for descriptions of the following attributes:
5449 5505  .sp
5450 5506  .LP
5451 5507  \fB/usr/sbin\fR
5452 5508  .sp
5453 5509  
5454 5510  .sp
5455 5511  .TS
5456 5512  box;
5457 5513  c | c
5458 5514  l | l .
5459 5515  ATTRIBUTE TYPE  ATTRIBUTE VALUE
5460 5516  _
5461 5517  Interface Stability     Committed
5462 5518  .TE
5463 5519  
5464 5520  .sp
5465 5521  .LP
5466 5522  \fB/sbin\fR
5467 5523  .sp
5468 5524  
5469 5525  .sp
5470 5526  .TS
5471 5527  box;
5472 5528  c | c
5473 5529  l | l .
5474 5530  ATTRIBUTE TYPE  ATTRIBUTE VALUE
5475 5531  _
5476 5532  Interface Stability     Committed
5477 5533  .TE
5478 5534  
5479 5535  .SH SEE ALSO
5480 5536  .LP
5481 5537  \fBacctadm\fR(1M), \fBautopush\fR(1M), \fBifconfig\fR(1M), \fBipsecconf\fR(1M),
5482 5538  \fBndd\fR(1M), \fBpsrset\fR(1M), \fBwpad\fR(1M), \fBzonecfg\fR(1M),
5483 5539  \fBattributes\fR(5), \fBieee802.3\fR(5), \fBdlpi\fR(7P)
5484 5540  .SH NOTES
5485 5541  .LP
5486 5542  The preferred method of referring to an aggregation in the aggregation
5487 5543  subcommands is by its link name. Referring to an aggregation by its integer
5488 5544  \fIkey\fR is supported for backward compatibility, but is not necessary. When
5489 5545  creating an aggregation, if a \fIkey\fR is specified instead of a link name,
5490 5546  the aggregation's link name will be automatically generated by \fBdladm\fR as
5491 5547  \fBaggr\fR\fIkey\fR.

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX