This section shows the syntax usage for the ldm subcommands, defines some output terms, such as flags and utilization statistics, and provides examples that are similar to what appears as output.
If you are creating scripts that use ldm list command output, always use the –p option to produce the machine-readable form of the output.
To view syntax usage for all ldm subcommands, use the following command:
primary# ldm --help
For more information about the ldm subcommands, see the ldm(1M) man page.
The following flags can be shown in the output for a domain (ldm list). If you use the long, parseable options (–l –p) for the command, the flags are spelled out for example, flags=normal,control,vio-service. If not, you see the letter abbreviation, for example -n-cv-. The list flag values are position dependent. The following values can appear in each of the six columns from left to right.
Column 1 – Starting or stopping domains
s – Starting or stopping
Column 2 – Domain status
n – Normal
t – Transition
d – Degraded domain that cannot be started due to missing resources
Column 3 – Reconfiguration status
d – Delayed reconfiguration
r – Memory dynamic reconfiguration
Column 4 – Control domain
c – Control domain
Column 5 – Service domain
v – Virtual I/O service domain
Column 6 – Migration status
s – Source domain in a migration
t – Target domain in a migration
e – Error occurred during a migration
The per virtual CPU utilization statistic (UTIL) is shown through the long (–l) option of the ldm list command. The statistic is the percentage of time that the virtual CPU spent executing on behalf of the guest operating system. A virtual CPU is considered to be executing on behalf of the guest operating system except when it has been yielded to the hypervisor. If the guest operating system does not yield virtual CPUs to the hypervisor, the utilization of CPUs in the guest operating system will always show as 100%.
The utilization statistic reported for a logical domain is the average of the virtual CPU utilizations for the virtual CPUs in the domain. The normalized utilization statistic (NORM) is the percentage of time the virtual CPU spends executing on behalf of the guest OS. This value takes into account such operations as cycle skip. Normalized virtualization is only available when your system runs at least version 8.2.0 of the system firmware.
When PM does not perform cycle skip operations, 100% utilization equals 100% normalized utilization. When PM adjusts the cycle skip to four eighths, 100% utilization equals 50% utilization, which means that the CPU effectively has only half the possible number of cycles available. So, a fully utilized CPU has a 50% normalized utilization. Use the ldm list or ldm list -l command to show normalized utilization for both virtual CPUs and the guest OS.
To view the current software versions installed:
primary# ldm -V
To generate a short list for all domains:
primary# ldm list
To generate a long list for all domains:
primary# ldm list -l
To generate an extended list of all domains:
primary# ldm list -e
To generate a parseable, machine-readable list of all domains:
primary# ldm list -p
You can generate output as a subset of resources by entering one or more of the following format options. If you specify more than one format, delimit the items by a comma with no spaces.
primary# ldm list -o resource[,resource...] domain-name
console – Output contains virtual console (vcons) and virtual console concentrator (vcc) service
core – Output contains information about domains that have whole cores allocated
cpu – Output contains information about the virtual CPU (vcpu), physical CPU (pcpu), and core ID
crypto – Cryptographic unit output contains Modular Arithmetic Unit (mau) and any other supported cryptographic unit, such as the Control Word Queue (CWQ)
disk – Output contains virtual disk (vdisk) and virtual disk server (vds)
domain-name – Output contains variables (var), host ID (hostid), domain state, flags, UUID, and software state
memory – Output contains memory
network – Output contains media access control (mac) address , virtual network switch (vsw), and virtual network (vnet) device
physio – Physical input/output contains peripheral component interconnect (pci) and network interface unit (niu)
resmgmt – Output contains dynamic resource management (DRM) policy information, indicates which policy is currently running, and lists constraints related to whole-core configuration
serial – Output contains virtual logical domain channel (vldc) service, virtual logical domain channel client (vldcc), virtual data plane channel client (vdpcc), and virtual data plane channel service (vdpcs)
stats – Output contains statistics that are related to resource management policies
status – Output contains status about a domain migration in progress
The following examples show various subsets of output that you can specify.
To list CPU information for the control domain:
primary# ldm list -o cpu primary
To list domain information for a guest domain:
primary# ldm list -o domain ldm2
To list memory and network information for a guest domain:
primary# ldm list -o network,memory ldm1
To list DRM policy information for a guest domain:
primary# ldm list -o resmgmt,stats ldm1
To show a variable and its value for a domain:
primary# ldm list-variable variable-name domain-name
For example, the following command shows the value for the boot-device variable on the ldg1 domain:
primary# ldm list-variable boot-device ldg1 boot-device=/virtual-devices@100/channel-devices@200/disk@0:a
To list the resources that are bound to a domain:
primary# ldm list-bindings domain-name
To list logical domain configurations that have been stored on the SP:
The ldm list-config command lists the logical domain configurations that are stored on the service processor. When used with the –r option, this command lists those configurations for which autosave files exist on the control domain.
primary# ldm list-config factory-default 3guests foo [next poweron] primary reconfig-primary
The labels to the right of the configuration name mean the following:
[current] – Last booted configuration, only as long as it matches the currently running configuration; that is, until you initiate a reconfiguration. After the reconfiguration, the annotation changes to [next poweron].
[next poweron] – Configuration to be used at the next power cycle.
[degraded] – Configuration is a degraded version of the previously booted configuration.
To list all server resources, bound and unbound:
primary# ldm list-devices -a
To list the amount of memory available to be allocated:
primary# ldm list-devices mem MEMORY PA SIZE 0x14e000000 2848M
To determine which portions of memory are unavailable for logical domains:
primary# ldm list-devices -a mem MEMORY PA SIZE BOUND 0x0 57M _sys_ 0x3900000 32M _sys_ 0x5900000 94M _sys_ 0xb700000 393M _sys_ 0x24000000 192M _sys_ 0x30000000 255G primary 0x3ff0000000 64M _sys_ 0x3ff4000000 64M _sys_ 0x3ff8000000 128M _sys_ 0x80000000000 2G ldg1 0x80080000000 2G ldg2 0x80100000000 2G ldg3 0x80180000000 2G ldg4 0x80200000000 103G 0x81bc0000000 145G primary
To list the services that are available:
primary# ldm list-services
To the Logical Domains Manager, constraints are one or more resources you want to have assigned to a particular domain. You either receive all the resources you ask to be added to a domain or you get none of them, depending upon the available resources. The list-constraints subcommand lists those resources you requested assigned to the domain.
To list constraints for one domain:
# ldm list-constraints domain-name
To list constraints in XML format for a particular domain:
# ldm list-constraints -x domain-name
To list constraints for all domains in a parseable format:
# ldm list-constraints -p
You can use the ldm list-rsrc-group command to show information about resource groups.
The following command shows information about all the resource groups:
primary# ldm list-rsrc-group NAME CORE MEMORY IO /SYS/CMU4 12 256G 4 /SYS/CMU5 12 256G 4 /SYS/CMU6 12 128G 4 /SYS/CMU7 12 128G 4
Like the other ldm list-* commands, you can specify options to show parseable output, detailed output, and information about particular resource groups and domains. For more information, see the ldm(1M) man page.
The following example uses the –l option to show detailed information about the /SYS/CMU5 resource group.
primary# ldm list-rsrc-group -l /SYS/CMU5 NAME CORE MEMORY IO /SYS/CMU5 12 256G 4 CORE CID BOUND 192, 194, 196, 198, 200, 202, 208, 210 primary 212, 214, 216, 218 primary MEMORY PA SIZE BOUND 0xc0000000000 228M ldg1 0xc0030000000 127G primary 0xc1ffc000000 64M _sys_ 0xd0000000000 130816M primary 0xd1ffc000000 64M _sys_ IO DEVICE PSEUDONYM BOUND pci@900 pci_24 primary pci@940 pci_25 primary pci@980 pci_26 primary pci@9c0 pci_27 primary