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 in the global zone to administer data-links.

Become superuser, or assume the Primary Administrator role.
To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.
Show the assignment of data-links on the system.
```
global# dladm show-linkprop
```

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

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            --             --             --

Zone 49bge is booted.
```
global# zoneadm -z 49bge boot
```

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 in the global zone to administer data-links.

Become superuser, or assume the Primary Administrator role.
To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

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.

Become superuser, or assume the Primary Administrator role.
To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

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.