IVM lshwres Command

Purpose

Lists the hardware resources of a managed system. This command is valid only in an Integrated Virtualization Manager environment.

Syntax

To list attributes for physical I/O buses

lshwres -r io --rsubtype bus [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list attributes for I/O pools

lshwres -r io --rsubtype iopool --level pool [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list system attributes for I/O pools

lshwres -r io --rsubtype iopool --level sys [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list attributes for physical I/O slots

lshwres -r io --rsubtype slot [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list attributes for physical I/O units

lshwres -r io --rsubtype unit [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list partition attributes for memory

lshwres -r mem --level lpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list system attributes for memory

lshwres -r mem --level sys [ --maxmem ] [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list partition attributes for processors

lshwres -r proc --level lpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list shared processor pool attributes

lshwres -r proc --level pool [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list system attributes for processors

lshwres -r proc --level sys [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list virtual ethernet adapter attributes

lshwres -r virtualio --rsubtype eth --level lpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list system attributes for virtual ethernet adapters

lshwres -r virtualio --rsubtype eth --level sys [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list virtual SCSI adapter attributes

lshwres -r virtualio --rsubtype scsi [ --level lpar ] [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list virtual serial adapter attributes

lshwres -r virtualio --rsubtype serial --level lpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list partition attributes for virtual I/O slots

lshwres -r virtualio --rsubtype slot --level lpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list virtual I/O slot attributes

lshwres -r virtualio --rsubtype slot --level slot [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

Description

The lshwres command lists the hardware resources of the managed-system, including physical I/O, virtual I/O, memory, and processing.

Flags

-r ResourceType --rsubtype ResourceSubtype --level ResourceLevel The combination of -r, --rsubtype, and --level indicates which type of attributes and objects to list. The valid combinations are enumerated below.
  • -r io --rsubtype bus: List attributes for physical I/O buses
    • Attributes: unit_phys_loc,bus_id,backplane_phys_loc,bus_drc_index,bus_drc_name
    • Filters: units, buses
  • -r io --rsubtype slot: List attributes for physical I/O slots
    • Attributes: unit_phys_loc, bus_id, phys_loc, drc_index, lpar_name, lpar_id, slot_io_pool_id, description, feature_codes, adapter_feature_codes, pci_vendor_id, pci_device_id, pci_subs_vendor_id, pci_subs_device_id, pci_class, pci_revision_id, bus_grouping, iop, iop_info_stale, vpd_stale, vpd_type, vpd_model, vpd_serial_num, parent_slot_drc_index, drc_name
    • Filters: {lpar_ids | lpar_names}, units, buses, slots, pools
  • -r io --rsubtype unit: List attributes for physical I/O units
    • Attributes: unit_phys_loc
    • Filters: units
  • -r mem --level lpar: List partition attributes for memory
    • Attributes: lpar_name, lpar_id, curr_min_mem, curr_mem, curr_max_mem, pend_min_mem, pend_mem, pend_max_mem, run_min_mem, run_mem
    • Filters: {lpar_ids | lpar_names}
  • -r mem --level sys [--maxmem]: List system attributes for memory
    • Attributes: configurable_sys_mem, curr_avail_sys_mem, pend_avail_sys_mem, installed_sys_mem, deconfig_sys_mem, sys_firmware_mem, mem_region_size
    • Additional attributes with --maxmem: required_min_mem_aix_linux
    • Filters: None
  • -r proc --level lpar: List partition attributes for processors
    • Attributes: lpar_name, lpar_id, curr_shared_proc_pool_id, curr_proc_mode, curr_min_proc_units, curr_proc_units, curr_max_proc_units, curr_min_procs, curr_procs, curr_max_procs, curr_sharing_mode, curr_uncap_weight, pend_shared_proc_pool_id, pend_proc_mode, pend_min_proc_units, pend_proc_units, pend_max_proc_units, pend_min_procs, pend_procs, pend_max_procs, pend_sharing_mode, pend_uncap_weight, run_proc_units, run_procs, run_uncap_weight
    • Filters: {lpar_ids | lpar_names}
  • -r proc --level pool: List shared processor pool attributes
    • Attributes: shared_proc_pool_id, configurable_pool_proc_units, curr_avail_pool_proc_units, pend_avail_pool_proc_units
    • Filters: None
  • -r proc --level sys: List system attributes for processors
    • Attributes: configurable_sys_proc_units, curr_avail_sys_proc_units, pend_avail_sys_proc_units, installed_sys_proc_units, deconfig_sys_proc_units, min_proc_units_per_virtual_proc, max_shared_proc_pools
    • Filters: None
  • -r virtualio --rsubtype eth --level lpar: List virtual Ethernet adapter attributes
    • Attributes: lpar_name, lpar_id, slot_num, state, ieee_virtual_eth, port_vlan_id, addl_vlan_ids, is_trunk, is_required, mac_addr
    • Filters: {lpar_ids | lpar_names}, vlans, slots
  • -r virtualio --rsubtype eth --level sys: List system attributes for virtual ethernet adapters
    • Attributes: max_vlans_per_port, mac_prefix
    • Filters: None
  • -r virtualio --rsubtype scsi --level lpar: List virtual SCSI adapter attributes
    • Attributes: lpar_name, lpar_id, slot_num, state, adapter_type, remote_lpar_id, remote_lpar_name, remote_slot_num, is_required
    • Filters: {lpar_ids | lpar_names}, slots
  • -r virtualio --rsubtype serial --level lpar: List virtual serial adapter attributes
    • Attributes: lpar_name, lpar_id, slot_num, state, adapter_type, supports_hmc, remote_lpar_id, remote_lpar_name, remote_slot_num, is_required
    • Filters: {lpar_ids | lpar_names}, slots
  • -r virtualio --rsubtype slot --level lpar: List partition attributes for virtual I/O slots
    • Attributes: lpar_name, lpar_id, curr_max_virtual_slots, pend_max_virtual_slots
    • Filters: {lpar_ids | lpar_names}
  • -r virtualio --rsubtype slot --level slot: List virtual I/O slot attributes
    • Attributes: slot_num, lpar_name, lpar_id, config, state, drc_name
    • Filters: {lpar_ids | lpar_names}, slots
--maxmem MaximumMemory When this option is specified, the required minimum memory amount needed for partitions to support the maximum memory quantity specified is listed. All memory quantities are in megabytes, and are a multiple of the memory region size for the managed- system.

This information is useful for specifying memory amounts in partition profiles.

This option is only valid when listing system level memory resources.

-m ManagedSystem The name of the managed system. This attribute is optional because there is only one system to manage. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system.
--filter FilterData The filters to apply to the resources to be listed. Filters are used to select which resources of the specified resource type are to be listed. If no filters are used, then all of the resources of the specified resource type will be listed. For example, specific partitions can be listed by using a filter to specify the names or IDs of the partitions to list. Otherwise, if no filter is used, then all the partitions in the managed system will be listed.

The filter data consists of filter name/value pairs, which are in comma separated value (CSV) format. The filter data must be enclosed in double quotes.

The format of the filter data is as follows:

"filter-name=value,filter-name=value,..."

Note that certain filters accept a comma separated list of values, as follows:

""filter-name=value,value,...",..."

When a list of values is specified, the filter name/value pair must be enclosed in double quotes. Depending on the shell being used, nested double quote characters may need to be preceded by an escape character, which is usually a '\' character.

Unless otherwise indicated, multiple values can be specified for each filter.

Valid filter names:

buses
The bus ID of the I/O bus to view
lpar_ids | lpar_names
Name or ID of the partition to view
pools
The pool ID of the I/O pool to view
slots
For physical I/O slots, the DRC index of the slot to view. For virtual I/O slots, the virtual slot number of the slot to view
units
The the physical location code of the unit to view
vlans
The virtual LAN of the virtual Ethernet adapters to view
-F AttributeNames A delimiter separated list of attribute names for the desired attribute values to be displayed for each resource. If no attribute names are specified, then values for all of the attributes for the resource will be displayed.

When this option is specified, only attribute values will be displayed. No attribute names will be displayed. The attribute values displayed will be separated by the delimiter which was specified with this option.

This option is useful when only attribute values are desired to be displayed, or when the values of only selected attributes are desired to be displayed.

Attribute names:

adapter_type
Indicates whether the virtual SCSI or serial adapter is a client or server. Valid values are client and server.
backplane_phys_loc
Physical location code of the backplane on which the bus resides.
bus_drc_index
DRC index, in hex, of the bus.
bus_drc_name
DRC name of the bus.
bus_grouping
Indicates whether bus grouping is required. Possible values:
  • 0 - not required
  • 1 - required
bus_id
I/O bus unique ID
config
Virtual slot configuration state. Possible values:
  • empty - no adapter
  • ethernet - virtual ethernet adapter
  • scsi - virtual scsi adapter
  • serial - virtual serial adapter
  • vmc - virtual management channel adapter
configurable_pool_proc_units
Total number of configurable processing units in the shared processing pool
configurable_sys_mem
Total amount, in megabytes, of configurable memory on the managed system
configurable_sys_proc_units
Total number of configurable processing units on the managed system
curr_avail_pool_proc_units
Current number of configurable processing units in the shared processing pool that are not assigned to partitions
curr_avail_sys_mem
Current amount, in megabytes, of configurable memory on the managed system that is not assigned to partitions
curr_avail_sys_proc_units
Current number of configurable processing units on the managed system that are not assigned to partitions
curr_max_mem
Maximum amount of memory, in megabytes, that can be dynamically assigned to the partition
curr_max_proc_units
Maximum number of processing units that can be dynamically assigned to the partition. This attribute is only valid for partitions using shared processors.
curr_max_procs
Maximum number of processors or virtual processors that can be dynamically assigned to the partition
curr_max_virtual_slots
Maximum number of virtual slots that can be dynamically configured for the partition
curr_mem
Current amount of memory, in megabytes, assigned to the partition
curr_min_mem
Minimum amount of memory, in megabytes, that can be dynamically assigned to the partition
curr_min_proc_units
Minimum number of processing units that can be dynamically assigned to the partition. This attribute is only valid for partitions using shared processors.
curr_min_procs
Minimum number of processors or virtual processors that can be dynamically assigned to the partition
curr_proc_mode
Indicates whether the partition is using dedicated or shared processors. The mode cannot change dynamically. Valid values:
  • ded - dedicated
  • shared - shared
curr_proc_units
Current number of processing units assigned to the partition. This attribute is only valid for partitions using shared processors.
curr_procs
Current number of processors or virtual processors assigned to the partition
curr_shared_proc_pool_id
The shared processor pool that this partition is currently participating in. This attribute is only valid for partitions using shared processors.
curr_sharing_mode
The current sharing mode for a partition. Valid values:
  • keep_idle_procs - valid with dedicated processor mode
  • share_idle_procs - valid with dedicated processor mode
  • cap - capped mode. valid with shared processor mode
  • uncap - uncapped mode. valid with shared processor mode
curr_uncap_weight
The current weighted average of processing priority when in uncapped sharing mode Valid values are 0 - 255
deconfig_sys_mem
Amount of memory, in megabytes, on the managed system that has been unconfigured. This includes memory that has been unconfigured by the system due to hardware failure, and memory that has been manually unconfigured
deconfig_sys_proc_units
Number of processing units on the managed system that have been unconfigured. This includes processing units that have been unconfigured by the system due to hardware failure, and processing units that have been manually unconfigured
description
A description of the I/O adapter which is in the slot.
drc_index
The DRC index, in hexadecimal, of the I/O slot.
drc_name
The DRC name of the I/O slot.
feature_codes
The most likely feature code for the I/O adapter. The feature code may be different for each operating system. The adapter_feature_codes attribute should be used to distinguish the feature code specific to each operating system.
adapter_feature_codes
List of possible feature codes for the I/O adapter sorted by likely match. Each element in the list consists of two feature codes - one for each operating system. This list follows the following format:
aix_feature_code1/linux_feature_code1,aix_feature_code2/linux_feature_code2,...
installed_sys_mem
Total amount, in megabytes, of memory installed on the managed system
installed_sys_proc_units
Total number of processing units installed on the managed system
io_pool_id
A unique identifier for an I/O pool. I/O pools are used in some I/O clustering environments.
iop
Indicates whether the I/O adapter is an I/O processor. Valid values:
  • 0 - no
  • 1 - yes
iop_info_stale
Indicates whether the information about the I/O processor is stale. Valid values:
  • 0 - no
  • 1 - yes
is_required
Indicates whether the I/O slot or virtual I/O adapter is required for the partition. Valid values:
  • 0 - no
  • 1 - yes
is_trunk
Indicates whether the virtual ethernet adapter is the trunk or uplink adapter for the virtual LAN. Valid values:
  • 0 - no
  • 1 - yes
lpar_ids
Partition ID. Valid values are 1 through the maximum number of partitions supported on the managed system (max_lpars).
lpar_name
User defined name for the partition.
mac_addr
MAC address for the virtual Ethernet adapter
mac_prefix
The first 3 bytes of the MAC address to be assigned to all virtual Ethernet adapters for this managed system. This must be specified as a 3 byte hexadecimal value (e.g. 32ab10) and can only be configured in the mkgencfg command.
max_io_pools
Maximum number of I/O pools supported on the managed system
max_shared_proc_pools
Maximum number of shared processing pools which are supported on the managed system
mem_region_size
The memory region size, in megabytes, for the managed system. The memory regions size represents the granularity of memory allocation to partitions.
min_proc_units_per_virtual_proc
Minimum number of processing units that are required for each virtual processor assigned to a partition
parent_slot_drc_index
DRC index, in hex, of the parent slot. A value of none indicates there is no parent slot
pci_class
PCI class code for the I/O adapter. This value is displayed in hex.
pci_revision_id
Vendor-assigned code indicating the revision number of the I/O adapter. This value is displayed in hexadecimal.
pci_subs_device_id
Vendor-assigned code identifying the type of driver that is installed for the I/O adapter. This value is displayed in hexadecimal.
pci_subs_vendor_id
ID of the vendor that made the driver for the I/O adapter. This value is displayed in hexadecimal.
pci_vendor_id
ID of the vendor that made this I/O adapter. This value is displayed in hexadecimal.
pend_avail_pool_proc_units
After system restart, the number of configurable processing units in the shared processing pool that are not assigned to partitions
pend_avail_sys_mem
After system restart, the amount, in megabytes, of configurable memory on the managed system that is not assigned to partitions
pend_avail_sys_proc_units
After system restart, the number of configurable processing units on the managed system that are not assigned to partitions
pend_max_mem
After partition restart, the maximum amount of memory, in megabytes, that can be dynamically assigned to the partition
pend_max_proc_units
After partition restart, the maximum number of processing units that can be dynamically assigned to the partition. This attribute is only valid for partitions using shared processors.
pend_max_procs
After partition restart, the maximum number of processors or virtual processors that can be dynamically assigned to the partition.
pend_max_virtual_slots
After partition restart, the maximum number of virtual slots that can be dynamically created for the partiton.
pend_mem
The target amount of memory, in megabytes, assigned to the partition.
pend_min_mem
After partition restart, the minimum amount of memory, in megabytes, that can be dynamically assigned to the partition.
pend_min_proc_units
After partition restart, the minimum number of processing units that can be dynamically assigned to the partition. This attribute is only valid for partitions using shared processors.
pend_min_procs
After partition restart, the minimum number of processors or virtual processors that can be dynamically assigned to the partition.
pend_proc_mode
Indicates whether the partition will be using dedicated or shared processors after restart. Valid values:
  • ded - dedicated
  • shared - shared
pend_proc_units
The target number of processing units assigned to the partition. This attribute is only valid for partitions using shared processors.
pend_procs
The target number of processors or virtual processors assigned to the partition
pend_shared_proc_pool_id
The shared processor pool that a partition is will participate in after restart. This attribute is only valid for partitions using shared processors.
pend_sharing_mode
The target sharing mode for a partition. Valid values:
  • keep_idle_procs - valid with pending dedicated processor mode
  • share_idle_procs - valid with pending dedicated processor mode
  • cap - capped mode. valid with pending shared processor mode
  • uncap - uncapped mode. valid with pending shared processor mode
pend_uncap_weight
The target weighted average of processing priority when in uncapped sharing mode Valid values are: 0 - 255
phys_loc
Physical location code of the slot.
port_vlan_id
Port virtual LAN ID for the virtual ethernet adapter.
remote_lpar_id
For client adapters, this specifies the ID of the partition which has the virtual serial/SCSI server adapter for this adapter. For server adapters, this specifies the ID of the partition which has the only client virtual serial/SCSI adapter allowed to connect to this adapter. A value of any indicates that any client virtual serial/SCSI adapter should be allowed to connect to this adapter
remote_lpar_name
The partition name which corresponds to the remote_lpar_id.
remote_slot_num
For client adapters, this specifies the virtual slot number of the virtual serial/SCSI server adapter for this adapter. For server adapters, this specifies the virtual slot number of the only client virtual serial/SCSI adapter allowed to connect to this adapter. A value of any indicates that any client virtual serial/SCSI adapter should be allowed to connect to this adapter.
required_min_mem_aix_linux
For an AIX® or Linux® partition, this is the required minimum memory amount, in megabytes, for the maximum memory amount specified with the --maxmem parameter.
run_mem
Current amount of memory, in megabytes, that the partition has varied on.
run_min_mem
The amount of memory, in megabytes, returned by a running partition's operating system to represent the smallest memory assignment which is currently supported by the operating system. If the operating system does not support this feature, then the value will be 0.
run_proc_units
Number of processing units that are varied on for the partition.
run_procs
Number of processors or virtual processors that are varied on for the partition.
run_uncap_weight
The operating system's current setting for the weighted average of processing priority when in uncapped sharing mode. Valid values are: 0 - 255
shared_proc_pool_id
A unique decimal identifier for a shared processing pool.
slot_io_pool_id
A unique decimal identifier of the I/O pool to which the slot is assigned. A value of none indicates that the slot is not assigned to any I/O pools.
slot_num
Virtual slot number.
slots
A list of slot DRC indices.
state
The state of a virtual slot. A virtual slot must be able to transition into the off state before a dynamic reconfiguration of the slot can succeed. Valid states:
  • off - the virtual slot is ready for dynamic reconfiguration
  • on - the virtual slot is not yet ready for dynamic reconfiguration
supports_hmc
Indicates whether or not the virtual serial adapter is enabled for HMC client support. Valid values:
  • 0 - no
  • 1 - yes
sys_firmware_mem
Amount of memory, in megabytes, on the managed system that is being used by system firmware.
unit_phys_loc
Physical location code of the I/O unit.
vpd_model
Model of the I/O adapter.
vpd_serial_num
Serial number of the I/O adapter.
vpd_stale
Indicates whether or not type, model, and serial number of the adapter is not current. Valid values:
  • 0 - not current
  • 1 - current
vpd_type
Type of the I/O adapter.
--header Display a header record, which is a delimiter separated list of attribute names for the attribute values that will be displayed. This header record will be the first record displayed. This option is only valid when used with the -F option.

Exit Status

This command has a return code of zero on success.

Security

This command is accessible by all users.

Examples

  1. List system level memory information and include the minimum memory required to support a maximum of 1024 MB:
    lshwres -r mem --level sys --maxmem 1024
  2. List all memory information for partitions lpar1 and lpar2, and only display attribute values, following a header of attribute names:
    lshwres -r mem --level lpar --filter "\"lpar_names=lpar1,lpar2\"" -F --header
  3. List all I/O units on the system:
    lshwres -r io --rsubtype unit
  4. List all virtual Ethernet adapters on the managed system:
    lshwres -r virtualio --rsubtype eth --level lpar
  5. List all virtual slots for partition lpar1:
    lshwres -r virtualio --rsubtype slot --level slot --filter "lpar_names=lpar1"
  6. List only the installed and configurable processors on the system:
    lshwres -r proc --level sys -F installed_sys_proc_units,configurable_sys_proc_units

Related Information

The lssyscfg command.


Send feedback |  Rate this page