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. Be superuser, or have equivalent authorizations.

   For more information about roles, see Configuring and Using RBAC (Task Map) in System Administration Guide: Security Services.

2. Show the assignment of data-links on the system.

   global# dladm show-linkprop

Example 25-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        VALUE          DEFAULT        POSSIBLE
   bge0         zone            --             --             --
   ath0         channel         6              --             --
   ath0         powermode       ?              off            off,fast,max
   ath0         radio           ?              on             on,off
   ath0         speed           11             -- 
   1,2,5.5,6,9,11,12,18,24,36,48,54
   ath0         zone            --             --             --

2. Zone 49bge is booted.

   global# zoneadm -z 49bge boot

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

   global# dladm show-linkprop
   LINK         PROPERTY        VALUE          DEFAULT        POSSIBLE
   bge0         zone            49bge          --             --
   ath0         channel         6              --             --
   ath0         powermode       ?              off            off,fast,max
   ath0         radio           ?              on             on,off
   ath0         speed           11             -- 
   1,2,5.5,6,9,11,12,18,24,36,48,54
   ath0         zone            --             --             --

How to Use dladm set-linkprop

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. Be superuser, or have equivalent authorizations.

   For more information about roles, see Configuring and Using RBAC (Task Map) in System Administration Guide: Security Services.

2. Use dladm set-linkprop with the -t to add bge0 to a running zone called excl.

   global# dladm set-linkprop -t -p zone=excl bge0
   LINK         PROPERTY        VALUE          DEFAULT        POSSIBLE
   bge0         zone            excl           --             --

   ---

   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. Be superuser, or have equivalent authorizations.

   For more information about roles, see Configuring and Using RBAC (Task Map) in System Administration Guide: Security Services.

2. Use dladm reset-linkprop with the -t to undo the zone assignment of the bge0 device.

   global# dladm set-linkprop -t -p zone=excl bge0
   LINK         PROPERTY        VALUE          DEFAULT        POSSIBLE
   bge0         zone            excl           --             --

   ---

   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.