Listing Logical Domains Resources
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 you actually see as output.
Machine-Readable 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. See Generate a Parseable, Machine-Readable List (-p) for more information.
Show Syntax Usage for ldm Subcommands
-
Look at syntax usage for all ldm subcommands.
primary# ldm --help
For more information about the ldm subcommands, see the ldm(1M) man page.
Flag Definitions
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. Following are the values that can appear in each of the six columns from left to right.
Column 1
-
s starting or stopping
-
- placeholder
Column 2
-
n normal
-
t transition
Column 3
-
d delayed reconfiguration
-
- placeholder
Column 4
-
c control domain
-
- placeholder
Column 5
-
v virtual I/O service domain
-
- placeholder
Column 6
-
s source domain in a migration
-
t target domain in a migration
-
e error occurred during a migration
-
- placeholder
Utilization Statistic Definition
The per virtual CPU utilization statistic (UTIL) is shown on 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. A dash (---) in the UTIL column means that the strand is power-managed.
Examples of Various Lists
Note –
The actual output might vary slightly from what is shown here.
Show Software Versions (-V)
Example 9–1 Software Versions Installed
primary# ldm -V Logical Domain Manager (v 1.2) Hypervisor control protocol v 1.3 Using Hypervisor MD v 0.1 System PROM: Hypervisor v. 1.7.0. @(#)Hypervisor 1.7.0. 2008/11/19 10:20 OpenBoot v. 4.30.0. @(#)OBP 4.30.0. 2008/11/18 13:44 |
Generate a Short List
Example 9–2 Short List for All Domains
primary# ldm list NAME STATE FLAGS CONS VCPU MEMORY UTIL UPTIME primary active -t-cv 4 1G 0.5% 3d 21h 7m ldg1 active -t--- 5000 8 1G 23% 2m |
Generate a Long List (-l)
Example 9–3 Long List for All Domains
primary# ldm list -l NAME STATE FLAGS CONS VCPU MEMORY UTIL UPTIME primary active -t-cv 1 768M 0.0% 0s VCPU VID PID UTIL STRAND 0 0 0.0% 100% MEMORY RA PA SIZE 0x4000000 0x4000000 768M IO DEVICE PSEUDONYM OPTIONS pci@780 bus_a pci@7c0 bus_b bypass=on VCC NAME PORT-RANGE vcc0 5000-5100 VSW NAME MAC NET-DEV DEVICE MODE vsw0 08:00:20:aa:bb:e0 e1000g0 switch@0 prog,promisc vsw1 08:00:20:aa:bb:e1 routed VDS NAME VOLUME OPTIONS DEVICE vds0 myvol-a slice /disk/a myvol-b /disk/b myvol-c ro,slice,excl /disk/c vds1 myvol-d /disk/d VDPCS NAME vdpcs0 vdpcs1 ------------------------------------------------------------------------------ NAME STATE FLAGS CONS VCPU MEMORY UTIL UPTIME ldg1 bound ----- 5000 1 512M VCPU VID PID UTIL STRAND 0 1 100% MEMORY RA PA SIZE 0x4000000 0x34000000 512M NETWORK NAME SERVICE DEVICE MAC mynet-b vsw0@primary network@0 08:00:20:ab:9a:12 mynet-a vsw0@primary network@1 08:00:20:ab:9a:11 DISK NAME VOLUME DEVICE SERVER mydisk-a myvol-a@vds0 disk@0 primary mydisk-b myvol-b@vds0 disk@1 primary VDPCC NAME SERVICE myvdpcc-a vdpcs0@primary myvdpcc-b vdpcs0@primary VCONS NAME SERVICE PORT mygroup vcc0@primary 5000 |
Generate an Extended List (-e)
Example 9–4 Extended List for all Domains
primary# ldm list -e NAME STATE FLAGS CONS VCPU MEMORY UTIL UPTIME primary active -t-cv 1 768M 0.0% 0s SOFTSTATE Solaris running MAC 00:14:4f:fa:ed:88 HOSTID 0x84faed88 CONTROL failure-policy=ignore DEPENDENCY master= VCPU VID PID UTIL STRAND 0 0 0.0% 100% MEMORY RA PA SIZE 0x4000000 0x4000000 768M IO DEVICE PSEUDONYM OPTIONS pci@780 bus_a pci@7c0 bus_b bypass=on VLDC NAME primary VCC NAME PORT-RANGE vcc0 5000-5100 VSW NAME MAC NET-DEV DEVICE MODE vsw0 08:00:20:aa:bb:e0 e1000g0 switch@0 prog,promisc vsw1 08:00:20:aa:bb:e1 routed VDS NAME VOLUME OPTIONS DEVICE vds0 myvol-a slice /disk/a myvol-b /disk/b myvol-c ro,slice,excl /disk/c vds1 myvol-d /disk/d VDPCS NAME vdpcs0 vdpcs1 VLDCC NAME SERVICE DESC hvctl primary@primary hvctl vldcc0 primary@primary ds ------------------------------------------------------------------------------ NAME STATE FLAGS CONS VCPU MEMORY UTIL UPTIME ldg1 bound ----- 5000 1 512M VCPU VID PID UTIL STRAND 0 1 100% MEMORY RA PA SIZE 0x4000000 0x34000000 512M VLDCC NAME SERVICE DESC vldcc0 primary@primary ds NETWORK NAME SERVICE DEVICE MAC mynet-b vsw0@primary network@0 08:00:20:ab:9a:12 mynet-a vsw0@primary network@1 08:00:20:ab:9a:11 DISK NAME VOLUME DEVICE SERVER mydisk-a myvol-a@vds0 disk@0 primary mydisk-b myvol-b@vds0 disk@1 primary VDPCC NAME SERVICE myvdpcc-a vdpcs0@primary myvdpcc-b vdpcs0@primary VCONS NAME SERVICE PORT mygroup vcc0@primary 5000 |
Generate a Parseable, Machine-Readable List (-p)
Example 9–5 Machine-Readable List
primary# ldm list -p VERSION 1.0 DOMAIN|name=primary|state=active|flags=-t-cv|cons=|ncpu=1|mem=805306368|util=0.0|uptime=0 DOMAIN|name=ldg1|state=bound|flags=-----|cons=5000|ncpu=1|mem=536870912|util=|uptime= |
Generate a Subset of a Long List (-o format)
-
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.
-
console - output contains virtual console (vcons) and virtual console concentrator (vcc) service
-
cpu - output contains virtual CPU (vcpu) and physical CPU (pcpu)
-
crypto - cryptographic unit output contains Modular Arithmetic Unit (mau) and any other LDoms-supported cryptographic unit, such as the Control Word Queue (CWQ)
-
disk - output contains virtual disk (vdisk) and virtual disk server (vds)
-
domain - output contains variables (var), host ID (hostid), domain state, flags, 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)
-
serial - output contains virtual logical domain channel (vldc) service, virtual logical domain channel client (vldcc), virtual data plane channel client (vdpcc), virtual data plane channel service (vdpcs)
-
status - output contains status about a domain migration in progress.
The following examples show various subsets of output that you can specify.
-
Example 9–6 List CPU Information for the Control Domain
# ldm list -o cpu primary NAME primary VCPU VID PID UTIL STRAND 0 0 1.0% 100% 1 1 0.6% 100% 2 2 0.2% 100% 3 3 0.5% 100% |
Example 9–7 List Domain Information for a Guest Domain
# ldm list -o domain ldm2 NAME STATE FLAGS ldm2 active -t--- SOFTSTATE Openboot initializing VARIABLES auto-boot?=false boot-device=/virtual-devices@100/channel-devices@200/disk@0 |
Example 9–8 Lists Memory and Network Information for a Guest Domain
# ldm list -o network,memory ldm1 NAME ldm1 MAC 00:14:4f:f9:dd:ae MEMORY RA PA SIZE 0x6800000 0x46800000 1500M NETWORK NAME SERVICE DEVICE MAC MODE PVID VID ldm1-network0 primary-vsw0@primary network@0 00:14:4f:fb:21:0f 1 |
List a Variable
Example 9–9 Variable List for a Domain
primary# ldm list-variable boot-device ldg1 boot-device=/virtual-devices@100/channel-devices@200/disk@0:a |
List Bindings
Example 9–10 Bindings List for a Domain
primary# ldm list-bindings ldg1 NAME STATE FLAGS CONS VCPU MEMORY UTIL UPTIME ldg1 bound ----- 5000 1 512M VCPU VID PID UTIL STRAND 0 1 100% MEMORY RA PA SIZE 0x4000000 0x34000000 512M NETWORK NAME SERVICE DEVICE MAC mynet-b vsw0@primary network@0 08:00:20:ab:9a:12 PEER MAC vsw0@primary 08:00:20:aa:bb:e0 mynet-a@ldg1 08:00:20:ab:9a:11 mynet-c@ldg2 08:00:20:ab:9a:22 NAME SERVICE DEVICE MAC mynet-a vsw0@primary network@1 08:00:20:ab:9a:11 PEER MAC vsw0@primary 08:00:20:aa:bb:e0 mynet-b@ldg1 08:00:20:ab:9a:12 mynet-c@ldg2 08:00:20:ab:9a:22 DISK NAME VOLUME DEVICE SERVER mydisk-a myvol-a@vds0 disk@0 primary mydisk-b myvol-b@vds0 disk@1 primary VDPCC NAME SERVICE myvdpcc-a vdpcs0@primary myvdpcc-b vdpcs0@primary VCONS NAME SERVICE PORT mygroup vcc0@primary 5000 |
List Configurations
Example 9–11 Configurations List
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.
For more information about configurations, see Managing Logical Domains Configurations. For more examples, see the ldm(1M) man page.
primary# ldm list-config factory-default 3guests foo [next poweron] primary reconfig-primary |
Meaning of Labels
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 powercycle.
List Devices
Example 9–12 List of All Server Resources
primary# ldm list-devices -a VCPU PID %FREE PM 0 0 NO 1 0 YES 2 0 YES 3 0 YES 4 100 --- 5 100 --- 6 100 --- 7 100 --- 8 100 --- 9 100 --- 10 100 --- 11 100 --- 12 100 --- 13 100 --- 14 100 --- 15 100 --- 16 100 --- 17 100 --- 18 100 --- 19 100 --- 20 100 --- 21 100 --- 22 100 --- 23 100 --- 24 100 --- 25 100 --- 26 100 --- 27 100 --- 28 100 --- 29 100 --- 30 100 --- 31 100 --- MAU CPUSET BOUND (0, 1, 2, 3) ldg2 (4, 5, 6, 7) (8, 9, 10, 11) (12, 13, 14, 15) (16, 17, 18, 19) (20, 21, 22, 23) (24, 25, 26, 27) (28, 29, 30, 31) MEMORY PA SIZE BOUND 0x0 512K _sys_ 0x80000 1536K _sys_ 0x200000 62M _sys_ 0x4000000 768M primary 0x34000000 512M ldg1 0x54000000 8M _sys_ 0x54800000 2G ldg2 0xd4800000 29368M IO DEVICE PSEUDONYM BOUND OPTIONS pci@780 bus_a yes pci@7c0 bus_b yes bypass=on |
List Available Memory
-
List the amount of memory available to be allocated.
primary# ldm list-devices mem MEMORY PA SIZE 0x14e000000 2848M
List Services
Example 9–13 Services List
primary# ldm list-services VDS NAME VOLUME OPTIONS DEVICE primary-vds0 VCC NAME PORT-RANGE primary-vcc0 5000-5100 VSW NAME MAC NET-DEV DEVICE MODE primary-vsw0 00:14:4f:f9:68:d0 e1000g0 switch@0 prog,promisc |
Listing Constraints
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.
List Constraints for One Domain
Example 9–14 Constraints List for One Domain
primary# ldm list-constraints ldg1 DOMAIN ldg1 VCPU COUNT 1 MEMORY SIZE 512M NETWORK NAME SERVICE DEVICE MAC mynet-b vsw0 network@0 08:00:20:ab:9a:12 mynet-b vsw0 network@0 08:00:20:ab:9a:12 DISK NAME VOLUME mydisk-a myvol-a@vds0 mydisk-b myvol-b@vds0 VDPCC NAME SERVICE myvdpcc-a vdpcs0@primary myvdpcc-b vdpcs0@primary VCONS NAME SERVICE mygroup vcc0 |
List Constraints in XML Format
Example 9–15 Constraints for a Domain in XML Format
primary# ldm list-constraints -x ldg1 <?xml version="1.0"?> <LDM_interface version="1.0"> <data version="2.0"> <ldom> <ldom_info> <ldom_name>ldg1</ldom_name> </ldom_info> <cpu> <number>8</number> </cpu> <memory> <size>1G</size> </memory> <network> <vnet_name>vnet0</vnet_name> <service_name>primary-vsw0</service_name> <mac_address>01:14:4f:fa:0f:55</mac_address> </network> <disk> <vdisk_name>vdisk0</vdisk_name> <service_name>primary-vds0</service_name> <vol_name>vol0</vol_name> </disk> <var> <name>boot-device</name> <value>/virtual-devices@100/channel-devices@200/disk@0:a</value> </var> <var> <name>nvramrc</name> <value>devalias vnet0 /virtual-devices@100/channel-devices@200/network@0</value> </var> <var> <name>use-nvramrc?</name> <value>true</value> </var> </ldom> </data> </LDM_interface> |
List Constraints in a Machine-Readable Format
Example 9–16 Constraints for All Domains in a Machine-Readable Format
primary# ldm list-constraints -p VERSION 1.0 DOMAIN|name=primary MAC|mac-addr=00:03:ba:d8:b1:46 VCPU|count=4 MEMORY|size=805306368 IO |dev=pci@780|alias= |dev=pci@7c0|alias= VDS|name=primary-vds0 |vol=disk-ldg2|opts=|dev=/ldoms/nv72-ldg2/disk |vol=vol0|opts=|dev=/ldoms/nv72-ldg1/disk VCC|name=primary-vcc0|port-range=5000-5100 VSW|name=primary-vsw0|mac-addr=|net-dev=e1000g0|dev=switch@0 DOMAIN|name=ldg1 VCPU|count=8 MEMORY|size=1073741824 VARIABLES |boot-device=/virtual-devices@100/channel-devices@200/disk@0:a |nvramrc=devalias vnet0 /virtual-devices@100/channel-devices@200/network@0 |use-nvramrc?=true VNET|name=vnet0|dev=network@0|service=primary-vsw0|mac-addr=01:14:4f:fa:0f:55 VDISK|name=vdisk0|vol=vol0@primary-vds0 |
- © 2010, Oracle Corporation and/or its affiliates