Administering Data-Links in Exclusive-IP Non-Global Zones

The dladm command is used from the global zone to administer data-links.

How to Use dladm show-linkprop

The dladm command can be used with the show-linkprop subcommand to show the assignment of data-links to running exclusive-IP zones.

You must be the global administrator or a user granted the appropriate authorizations in the global zone to administer data-links.

1. Become root or assume an equivalent role.
2. Show the assignment of data-links on the system.

   global# dladm show-linkprop

Example 26-1 Using dladm With the show-linkprop subcommand

1. In the first screen, zone 49bge, which is assigned bge0 has not been booted.

   global# dladm show-linkprop
   LINK     PROPERTY        PERM   VALUE        DEFAULT        POSSIBLE
   bge0     zone            rw     --           --             --
   vsw0     speed           r-     1000         1000           --
   vsw0     autopush        rw     --           --             --
   vsw0     zone            rw     --           --             --
   vsw0     duplex          r-     full         full           half,full
   vsw0     state           r-     up           up             up,down
   vsw0     adv_autoneg_cap --     --           0              1,0
   vsw0     mtu             rw     1500         1500           1500
   vsw0     flowctrl        --     --           no             no,tx,rx,bi,pfc,
                                                               auto
   ...

2. Boot zone 49bge.

   global# zoneadm -z 49bge boot

3. Execute the command dladm show-linkprop again. Note that the bge0 link is now assigned to 49bge.

   global# dladm show-linkprop
   LINK     PROPERTY        PERM   VALUE        DEFAULT        POSSIBLE
   bge0     zone            rw     49bge        --             --
   vsw0     speed           r-     1000         1000           --
   vsw0     autopush        rw     --           --             --
   vsw0     zone            rw     --           --             --
   vsw0     duplex          r-     full         full           half,full
   vsw0     state           r-     up           up             up,down
   vsw0     adv_autoneg_cap --     --           0              1,0
   vsw0     mtu             rw     1500         1500           1500
   vsw0     flowctrl        --     --           no             no,tx,rx,bi,pfc,
                                                               auto
   ...

Example 26-2 How to Display the Data-Link Name and Physical Location When Using Vanity Naming

Device physical locations are shown in the LOCATION field. To view the data-link name and physical location information for a device, use the -L option.

global# dladm show-phys -L
LINK         DEVICE        LOCATION
net0         e1000g0       MB
net1         e1000g1       MB
net2         e1000g2       MB
net3         e1000g3       MB
net4         ibp0          MB/RISER0/PCIE0/PORT1
net5         ibp1          MB/RISER0/PCIE0/PORT2
net6         eoib2         MB/RISER0/PCIE0/PORT1/cloud-nm2gw-2/1A-ETH-2
net7         eoib4         MB/RISER0/PCIE0/PORT2/cloud-nm2gw-2/1A-ETH-2

How to Use dladm to Assign Temporary Data-Links

The dladm command can be used with the set-linkprop subcommand to temporarily assign data-links to running exclusive-IP zones. Persistent assignment must be made through the zonecfg command.

You must be the global administrator or a user granted the appropriate authorizations in the global zone to administer data-links.

1. Become root or assume an equivalent role.
2. Use dladm set-linkprop with the -t to add bge0 to a running zone called zoneA.

   global# dladm set-linkprop -t -p zone bge0
   LINK     PROPERTY        PERM   VALUE        DEFAULT        POSSIBLE
   bge0     zone            rw     zoneA        --             --

   ---

   Tip - The -p option produces a display using a stable machine-parseable format.

   ---

How to Use dladm reset-linkprop

The dladm command can be used with the reset-linkprop subcommand to reset the bge0 link value to unassigned.

1. Become root or assume an equivalent role.
2. Use dladm reset-linkprop with the -t option to undo the zone assignment of the bge0 device.

   global# dladm reset-linkprop -t -p zone bge0
   LINK     PROPERTY        PERM   VALUE        DEFAULT        POSSIBLE
   bge0     zone            rw     zoneA        --             --

   ---

   Tip - The -p option produces a display using a stable machine-parseable format.

   ---

Troubleshooting

If the running zone is using the device, the reassignment fails and an error message is displayed. See Exclusive-IP Zone Is Using Device, so dladm reset-linkprop Fails.