LPARSTAT(8)

📦 version 1.3.14, in opensuse-leap 16.0

💅 LPARSTAT(8) — Linux on Power Service Tools

okay so bestie, welcome to lparstat, a.k.a. the Linux on Power Service Tools era of your life 🫶 this is the part where we look at your logical partition and go "hmm, what's the vibe" — and honestly? it ate.

✨ NAME ✨

lparstat — reports logical partition (LPAR) related information and statistics. 🎀

🌸 SYNOPSIS 🌸

/usr/sbin/lparstat [ options ]

/usr/sbin/lparstat <interval> [ count ]

🦋 DESCRIPTION 🦋

k so the lparstat command is literally your little report bestie — it gives you LPAR related info + utilization statistics. it shows current LPAR related parameters and Hypervisor information, plus the utilization statistics for the LPAR. iconic behavior, no notes. ✨

run lparstat with no options and it drops a single report with utilization statistics related to the LPAR since boot time. that's it. that's the whole vibe. 💜

lowkey important: the following info shows up in the system configuration row 👑
  • type — Partition Type. can be either dedicated or shared.
  • mode — tells you whether the partition processor capacity is capped or uncapped, i.e. whether it's allowed to consume idle cycles from the shared pool. a dedicated LPAR is capped or donating.
  • smt — says whether simultaneous multi-threading is enabled or disabled in the partition. if SMT is enabled, the number of SMT threads gets displayed too. slay. 🧵
  • lcpu — number of online logical SMT threads. this one is reported when you're using the --legacy flag.
  • vcpu — number of online virtual processor cores.
  • mem — online Memory Capacity.
  • cpus — number of online physical processor cores in the pool. this attribute is referred to as psize in legacy mode and is only available in a shared LPAR environment. iykyk 💅
  • ent — entitled processing capacity in processor units. this info is displayed only if the partition type is shared.

💖 the utilization row 💖

now for the main character energy — the utilization row:

  • %user — shows the percentage of the entitled processing capacity used while executing at the user level (application). for dedicated partitions, the entitled processing capacity is the number of physical processors. for uncapped partitions with a current physical processor consumption above their entitled capacity, the percentage becomes relative to the number of physical processor consumed (physc). 😭 okay that sentence is a lot but you got it.
  • %sys — shows the percentage of the entitled processing capacity used while executing at the system level (kernel). for dedicated partitions, the entitled processing capacity is the number of physical processors. for uncapped partitions with a current physical processor consumption above their entitled capacity, the percentage becomes relative to the number of physical processor consumed (physc).
  • %wait — shows the percentage of the entitled processing capacity unused while the partition was idle and had outstanding disk I/O requests. for dedicated partitions, the entitled processing capacity is the number of physical processors. for uncapped partitions with a current physical processor consumption above their entitled capacity, the percentage becomes relative to the number of physical processor consumed (physc).
  • %idle — shows the percentage of the entitled processing capacity unused while the partition was idle and did not have any outstanding disk I/O request. for dedicated partitions, the entitled processing capacity is the number of physical processors. for uncapped partitions with a current physical processor consumption above their entitled capacity, the percentage becomes relative to the number of physical processor consumed (physc).

🎀 shared or dedicated-donating stats 🎀

these next ones show up when the partition type is shared or dedicated-donating:

  • physc — shows the number of physical processors consumed. 🔥
  • vcsw — shows the number of virtual context switches that are virtual processor hardware preemptions.

⭐ shared-only stats ⭐

and these babies are displayed only when the partition type is shared:

  • %entc — shows the percentage of the entitled capacity consumed. heads up bestie: because the time base over which this data is computed can vary, the entitled capacity percentage can sometimes exceed 100%. 🙈 this excess is noticeable only with small sampling intervals.
  • lbusy — shows the percentage of logical processor(s) utilization that occurred while executing at the user and system level.
  • app — shows the available physical processors in the shared pool.
  • phint — shows the number of phantom interruptions received (phantom = targeted to another shared partition in this pool). 💀 ghosted, but make it hardware.

✨ OPTIONS ✨

The option menu is giving full detail, no cap. Every flag, every field, every little default-ish fact — all here. 💅

  • -i — Lists details on the LPAR configuration. The various details displayed by the -i option are listed below (the field list is headed Node Name / Description):
    • Partition Name — Logical partition name as assigned at the HMC.
    • Partition Number — Number of this Logical Partition.
    • Type — Indicates whether the LPAR is using dedicated or shared CPU resource and if the SMT is turned ON. The Type is displayed in the format [Shared | Dedicated] [ -SMT ] [ -# ]. The following list explains the different Type formats:
      • Shared — Indicates that the LPAR is running in the Shared processor mode.
      • Dedicated — Indicates that the LPAR is running in the dedicated processor mode.
      • SMT[-#] — Indicates that the LPAR has SMT mode turned ON and the number of SMT threads is 2. If the number of threads is greater than 2, then the number of threads is also displayed.
    • Mode — Indicates whether the LPAR processor capacity is capped, or if it is uncapped and allowed to consume idle cycles from the shared pool. Dedicated LPAR is capped or donating.
    • Entitled Capacity — The number of processing units this LPAR is entitled to receive.
    • Partition Group-ID — LPAR group that this LPAR is a member of.
    • Shared Pool ID — Identifier of Shared Pool of Physical processors that this LPAR is a member.
    • Online Virtual CPUs — Number of CPUs (virtual engines) currently online.
    • Maximum Virtual CPUs — Maximum possible number of CPUs (virtual engines).
    • Minimum Virtual CPUs — Minimum number of virtual CPUs this LPAR was defined to ever have.
    • Online Memory — Amount of memory currently online.
    • Minimum Memory — Minimum memory this LPAR was defined to ever have.
    • Desired Memory — Indicates the desired amount of memory.
    • Maximum Memory — Maximum possible amount of memory.
    • Variable Capacity Weight — The priority weight assigned to this LPAR which controls how extra (idle) capacity is allocated to it. A weight of -1 indicates a soft cap is in place.
    • Minimum Capacity — The minimum number of processing units this LPAR was defined to ever have. Entitled capacity can be reduced down to this value.
    • Maximum Capacity — The maximum number of processing units this LPAR was defined to ever have. Entitled capacity can be increased up to this value.
    • Capacity Increment — The granule at which changes to Entitled Capacity can be made. A value in whole multiples indicates a Dedicated LPAR.
    • Active Physical CPUs in System — The current number of active physical CPUs in the system containing this LPAR.
    • Active CPUs in Pool — The maximum number of CPUs available to this LPAR's shared processor pool.
    • Maximum Capacity of Pool — The maximum number of processing units available to this LPAR's shared processor pool.
    • Entitled Capacity of Pool — The number of processing units that this LPAR's shared processor pool is entitled to receive.
    • Unallocated Capacity — The sum of the number of processor units unallocated from shared LPARs in an LPAR group. This sum does not include the processor units unallocated from a dedicated LPAR, which can also belong to the group. The unallocated processor units can be allocated to any dedicated LPAR (if it is greater than or equal to 1.0 ) or shared LPAR of the group.
    • Physical CPU Percentage — Fractional representation relative to whole physical CPUs that these LPARs virtual CPUs equate to. This is a function of Entitled Capacity / Online CPUs. Dedicated LPARs would have 100% Physical CPU Percentage. A 4-way virtual with Entitled Capacity of 2 processor units would have a 50% physical CPU Percentage.
    • Unallocated Weight — Number of variable processor capacity weight units currently unallocated within the LPAR group.
    • Memory Mode — Indicates whether the memory mode is shared or dedicated. If Active Memory Expansion is enabled, the memory mode also includes a new mode called Expanded.
    • Total I/O Memory Entitlement — The I/O memory entitlement of the LPAR.
    • Variable Memory Capacity Weight — This one is listed with no description in this manpage. It is literally just the field name sitting there, iconic and mysterious. 🫠
    • Memory Pool ID — The memory pool ID of the pool that the LPAR belongs to.
    • Physical Memory in the Pool — The physical memory present in the pool that the LPAR belongs to.
    • Unallocated Variable Memory Capacity Weight — The unallocated variable memory-capacity weight of the LPAR.
    • Unallocated I/O Memory Entitlement — The unallocated I/O memory entitlement of the LPAR.
    • Memory Group ID of LPAR — The memory group ID of the Workload Manager group that the LPAR belongs to.
    • Desired Variable Capacity Weight — The variable memory capacity weight of the LPAR.
    • Resource Group Number — Identifier of Resource Group of Physical processors that this LPAR is a member of.
    • Active Processors in Resource Group — Current number of active physical Processors in resource Group containing this LPAR.
  • -x — Display the LPAR security flavor mode:
    • 0 — Speculative execution fully enabled
    • 1 — Speculative execution controls to mitigate user-to-kernel side-channel attacks
    • 2 — Speculative execution controls to mitigate user-to-kernel and user-to-user side-channel attacks
  • -E — Display Scaled Processor Utilization Resource Register(SPURR) based CPU utilization.
    • Actual CPU utilization is based on Processor Utilization Resource Register(PURR).
    • Normalized CPU utilization is based on Scaled Processor Utilization Resource Register(SPURR).
  • -l, --legacy — Display the report in legacy format.
    • Memory attribute in MB instead of KB.
    • cpus attribute is referred as psize and only available for shared LPAR.
    • lcpu attribute calculation: lcpu = smt * number of online processors.
  • -h, --help — Display the usage of lparstat.
  • -V, --version — Display the lparstat version information.
  • interval — The interval parameter specifies the amount of time between each report.
  • count — The count parameter specifies how many reports will be displayed.

That's the whole thing, bestie — source/version Linux, dated 2011-05-01, and this page is LPARSTAT(8). Go off, queen. 💖✨👑

📦 where this page comes from