lsmap Command

Purpose

Displays the mapping between physical, logical, and virtual devices.

Syntax

lsmap { -vadapter ServerVirtualAdapter | -plc PhysicalLocationCode | -all }

lsmap [ -type BackingDeviceType | -net ]

lsmap [ -fmt Delimiter ] [ -field FieldNames ]

Description

The lsmap command displays the mapping between virtual host adapters and the physical devices they are backed to. Given a device name (ServerVirtualAdapter) or physical location code (PhysicalLocationCode) of a server virtual adapter, the device name of each connected virtual target device (child devices), its logical unit number, backing device(s) and the backing devices physical location code is displayed. If the -net flag is specified the supplied device must be a virtual server Ethernet adapter.

The -fmt flag divides the output by a user-specified delimiter/character (delimiter). The delimiter can be any non-white space character. This format is provided to facilitate scripting.

The -type flag limits the types of backing devices displayed to the user-specified list, BackingDeviceType. With the exception of the net type, any combination of device types may be specified. The net type can not be combined with any other type.

Flags

-all	Specifies lsmap output should be displayed for all virtual SCSI devices. If used with the -net flag, virtual Ethernet adapters will be displayed.
-field FieldName	Specifies the list of fields to display. The following fields are supported: svsa Server virtual adapter. physloc Server virtual adapter Physical location code clientid Client partition ID vtd Virtual target device. Not valid if the -net flag is specified. lun Logical unit number. Not valid if the -net flag is specified. backing Backing device bdphysloc Backing device physical location code svea Shared Ethernet adapter. Only valid if the -net flag is specified.
-fmt delimiter	Specifies a delimiter character to separate output fields.
-net	Specifies the supplied device is a server virtual Ethernet adapter or if used with the -all flag all virtual Ethernet adapters and backing devices are displayed.
-plc PhysicalLocatoinCode	Specifies the device physical location code of a server virtual adapter. This flag cannot be used with the -vadapter flag.
-type	Specifies the type of devices to display. The following fields are supported: disk List physical backing devices. lv List logical volume backing devices. optical List optical backing devices. net List network devices. (This option can not be used in combination with disk, lv, or optical)
-vadapter VirtualServerAdapter	Specifies the device name of a server virtual adapter. This flag cannot be used with the -plc flag.

Output Field Definitions

Field	Description
SVSA	Server Virtual SCSI Adaper
Physloc	Physical Location Code
VTD	Virtual Target Device
LUN	Logical Unit Number
SVEA	Server Virtual Ethernet Adapter
SEA	Shared Ethernet Adapter

Exit Status

Return code	Description
11	No VTDs associated with device
12	No SEAs associated with device
15	Specified device is not a server virtual SCSI adapter
16	Specified device is not a server virtual Ethernet adapter
17	Specified device in not in the AVAILABLE state

Examples

To list all virtual target devices and backing devices mapped to the server virtual SCSI adapter vnode2, type:

lsmap –vadapter vhost2

The system displays a message similar to the following:

 SVSA         Physloc                                     Client Partition ID
------------ -------------------------------------------- ------------------
vhost0       U9111.520.10004BA-V1-C2                      0x00000004

VTD                   vtscsi0
LUN                   0x8100000000000000
Backing device        vtd0-1
Physloc

VTD                   vtscsi1
LUN                   0x8200000000000000
Backing device        vtd0-2
Physloc

VTD                   vtscsi2
LUN                   0x8300000000000000
Backing device        hdisk2
Physloc               U787A.001.0397658-P1-T16-L5-L0

To list the shared Ethernet adapter and backing device mapped to the virtual server Ethernet adapter ent4, type:

lsmap -vadapter ent4 –net

The system displays a message similar to the following:

SVEA   Physloc
------ --------------------------------------------
ent4   P2-I1/E1

SEA                   ent5
Backing device        ent1
Physloc               P2-I4/E1

To list the shared Ethernet adapter and backing device mapped to the virtual server Ethernet adapter ent5 in script format separated by a : (colon), type:
```
lsmap –vadapter ent5 –fmt ":"
```
The system displays a message similar to the following:
```
ent5:ent8:ent2
```

To list all virtual target devices and backing devices, where the backing devices are of type disk or lv, type:

lsmap -all -type disk lv

The system displays a message similar to the following:

SVSA            Physloc                                      Client Partition ID
--------------- -------------------------------------------- ------------------
vhost0          U9117.570.10D1B0E-V4-C3                      0x00000000

VTD                   vtscsi0
LUN                   0x8100000000000000
Backing device        hdisk0
Physloc               U7879.001.DQD0KN7-P1-T12-L3-L0

VTD                   vtscsi2
LUN                   0x8200000000000000
Backing device        lv04
Physloc                

SVSA            Physloc                                      Client Partition ID
--------------- -------------------------------------------- ------------------
vhost1          U9117.570.10D1B0E-V4-C4                      0x00000000

VTD                   vtscsi1
LUN                   0x8100000000000000
Backing device        lv03
Physloc

Related Information

The cfgdev command, the chdev command, the chpath command, the lsdev command, the lspath command, the mkpath command, the mkvdev command, the rmdev command, the rmpath command.

Send feedback | Rate this page