To obtain information about the VNICs on your system, use thedladm show-vnic command.
Example 9 Displaying VNICs on a System$dladm show-vnicLINK OVER SPEED MACADDRESS MACADDRTYPE IDS vnic1 net0 1000 2:8:20:c2:39:38 random VID:123 vnic2 net0 1000 2:8:20:5f:84:ff random VID:456
The output shows the following information:
Virtual datalink, identified by a name.
Physical or virtual datalink over which the VNIC is configured.
Maximum speed of the VNIC, in megabits per second.
MAC address of the VNIC.
MAC address type of the VNIC, which can be one of the following:
random – The random address assigned to the VNIC
factory – The factory MAC address of the NIC used by the VNIC
fixed – The MAC address assigned by the user
VLAN ID of the VNIC.
You can use anydladm command that shows information about datalinks to include information about VNICs if they exist on the system. For example, thedladm show-link command displays VNICs with other datalinks. You can use thedladm show-linkprop command to display the properties of VNICs.
To obtain information about the datalink property of a single VNIC, specify the VNIC in the following command syntax:
$ dladm show-linkprop [-pproperty]vnicExample 10 Displaying VNICs That Are Attached to Zones
In this example, information is displayed for the primary datalink and VNICs that are attached to the zones. The primary datalinknet0 is attached to the global zone. The VNICs,vnic1 andvnic2, are attached tozone1 andzone2 respectively.
$dladm show-link -ZLINK ZONE CLASS MTU STATE OVERnet0 global phys 1500 up --zone1/vnic1 zone1 vnic 1500 up net0 zone2/vnic2 zone2 vnic 1500 up net0
Multiple MAC addresses are associated with system-created VNICs in Oracle VM Server for SPARC and theanet resources in Oracle Solaris Kernel Zones. In Oracle VM Server for SPARC, you need to create avnet with thealt-mac-addrs property to support VNICs and zones inside a guest domain. In this case, the system automatically creates a VNIC with multiple MAC addresses. These multiple MAC addresses are obtained from thevnet that you created. For more information, seeOracle VM Server for SPARC 3.6 Administration Guide.
To support zones or VNICs inside kernel zones, you configure theanet resources with multiple MAC addresses. You use thezonecfg command to specify multiple MAC addresses to theanet resources created for network access in kernel zones. For more information, see thesolaris-kz(7) man page. For information about configuring kernel zones, seeCreating and Using Oracle Solaris Kernel Zones.
When multiple MAC addresses are associated with VNICs, one MAC address is used by the virtual network driver. You can use the remaining MAC addresses to create VNICs inside kernel zones or a guest domain. For example, if a VNIC is associated with three MAC addresses, one MAC address is assigned for the virtual network driver. Hence, you can create only two VNICs with the remaining two MAC addresses.
You can use the following command to display multiple MAC addresses associated with VNICs:
$ dladm show-vnic -mExample 11 Displaying VNICs With Multiple MAC Addresses in Kernel Zones
$dladm show-vnic -mLINK OVER MACADDRESSES MACADDRTYPES IDSgz_vnic0 net0 2:8:20:d7:27:9d random VID:0zone1/net0 net0 2:8:20:70:52:9 random VID:0 2:8:20:c9:d:4c fixed 2:8:20:70:db:3 randomzone1/net1 net0 0:1:2:3:4:5 fixed VID:0 0:1:2:3:4:6 fixed
In this example, kernel zonezone1 has twoanet resources:net0 andnet1. Both resources have more than one MAC address configured. Therefore, inside kernel zonezone1, you can create up to two VNICs on top of the virtual NIC driverzvnet associated with datalinknet0. You can create only one VNIC on top of the virtual NIC driverzvnet associated with datalinknet1.
Example 12 Displaying System-Created VNICs With Multiple MAC Addresses$dladm show-vnic -mLINK OVER MACADDRESSES MACADDRTYPES IDSldoms-vsw0.vport0 net1 0:14:4f:fb:e1:8f fixed VID:0,21 0:14:4f:f8:6b:9 fixed 0:14:4f:fa:48:7f fixedldoms-vsw0.vport1 net1 0:14:4f:f9:1b:8d fixed VID:45,44 0:14:4f:f9:27:4 fixed
In this example, you can create up to two VNICs on top of the guest domain's virtual network drivervnet associated withldoms-vsw0.vport0. You can create up to one VNIC on top of the virtual NIC drivervnet associated withldoms-vsw0.vport1.
The physical link state of a datalink identifies whether the physical device has connectivity with the external network. If the cable is plugged in and the state of the port on the other end of the cable isup, then the physical device has connectivity with the external network.
You can use the following commands to display the physical link state of a datalink:
$ dladm show-phys [link]
$ dladm show-ether [link]
For more information, see thedladm(8) man page.
Example 13 Displaying the Physical Link State of DatalinksThe following example displays the physical link state of datalinks on a system by using thedladm show-phys command.
$dladm show-physLINK MEDIA STATE SPEED DUPLEX DEVICEnet1 Ethernet down 0 unknown e1000g1net2 Ethernet down 0 unknown e1000g2net3 Ethernet down 0 unknown e1000g3net0 Ethernet up 1000 full e1000g0
The following example displays the physical link state of datalinks on a system by using thedladm show-ether command.
$dladm show-etherLINK PTYPE STATE AUTO SPEED-DUPLEX PAUSEnet1 current down yes 0M binet2 current down yes 0M binet3 current down yes 0M binet0 current up yes 1G-f bi
When multiple VNICs are created over a NIC, a virtual switch is created internally to enable VNICs and the primary datalink to communicate when they are on the same VLAN. These datalinks can communicate with each other even if the physical datalink has no connection with the external network. This forms the virtual link state of the datalink, which can beup,down, orunknown. The virtual link state of a datalink identifies whether a datalink has connectivity with internal networks within the system even if the physical cable is unplugged.
You use the following command to display the virtual link state of a datalink:
$ dladm show-link [link]Example 14 Displaying the Virtual Link State of Datalinks
This example displays the virtual link state of datalinks on a system.
$dladm show-linkLINK CLASS MTU STATE OVERnet0 phys 1500 up --net2 phys 1500 down --net4 phys 1500 down --net1 phys 1500 up --net5 phys 1500 up --vnic0 vnic 1500 up net5vnic1 vnic 1500 up net5vnic2 vnic 1500 up net1