vicfg-scsidevs - display information about available LUNs.


vicfg-scsidevs [<connection_options>] 
   [--compact-list |
    --device <device> |
    --hba-device-list |
    --hbas |
    --help |
    --list |
    --query |
    --uids |
    --vihost <esx_host> |


The vicfg-scsidevs command displays information about available LUNs on ESX/ESXi 4.x hosts. You can run vicfg-scsidevs --query and vicfg-scsidevs --vmfs against ESX/ESXi version 3.5. The other options are supported only against ESX/ESXi version 4.0 and later.

In previous releases of this command-line interface, the corresponding command is vicfg-vmhbadevs.



Specifies the target server and authentication information if required. Run vicfg-scsidevs --help for a list of all connection options.

--compact-list | -c

Lists all logical devices, each on a single line, with limited information. The information includes the device ID, device type, size, and plugin and device display name. You can specify the --device option to list information about a specific device.

--device | -d

Used with other options to specify the device for which you want information.

--hba-device-list | -A

For each HBA, prints a mapping between the HBA and the devices for which it provides paths.

--hbas | -a

Prints HBA devices with identifying information. This includes the adapter ID, driver ID, adapter UID, PCI, vendor, and model.


Prints a help message for each command-specific and each connection option. Calling the script with no arguments or with --help has the same effect.

--list | -l

Lists device information for all logical devices on this system. The information includes the name (UUID), device type, display name, and multipathing plugin. You can specify the --device option to list information about a specific device.

--query | -q

Prints mappings in 2.5 compatibility mode to mimic a call to vmkpcidivy -q vmhba_devs.

--uids | -u

Lists the primary UID for each device and any other UIDs (aliases) for each UID. You can specify the --device option to list information about a specific device.

--vihost | -h

When you run a vCLI command with the --server option pointing to a vCenter Server system, use --vihost to specify the ESX/ESXi host to run the command against.

--vmfs | -m

Prints mappings for each VMFS volume to its corresponding partition, path to that partition, VMFS UUID, extent number, and volume names.


The following examples assume you are specifying connection options, either explicitly or, for example, by specifying the server, user name, and password. Run vicfg-scsidevs --help for a list of common options including connection options.

List all logical devices known on this system with detailed information:

     vicfg-scsidevs <conn_options> -l

List all logical devices with abbreviated information:

     vicfg-scsidevs <conn_options> -c

List all device unique identifiers with their primary name:

     vicfg-scsidevs <conn_options> -u

List a specific logical device with its detailed information:

     vicfg-scsidevs <conn_options -l -d mpx.vmhba32:C0:T1:L0

Print mappings for VMFS volumes to the corresponding partition, path to that partition, VMFS uuid, extent number and volume names:

     vicfg-scsidevs <conn_options> -m

Print HBA devices with identifying information:

     vicfg-scsidevs <conn_options> -a

Print a mapping between HBAs and the devices it provides paths to:

     vicfg-scsidevs <conn_options> -A