From nobody Sun Dec 22 02:15:01 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) client-ip=8.43.85.245; envelope-from=devel-bounces@lists.libvirt.org; helo=lists.libvirt.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=fail(p=none dis=none) header.from=gmail.com Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1734424148362643.0730003269516; Tue, 17 Dec 2024 00:29:08 -0800 (PST) Received: by lists.libvirt.org (Postfix, from userid 996) id 4FB791488; Tue, 17 Dec 2024 03:29:07 -0500 (EST) Received: from lists.libvirt.org (localhost [IPv6:::1]) by lists.libvirt.org (Postfix) with ESMTP id C895F1520; Tue, 17 Dec 2024 03:28:50 -0500 (EST) Received: by lists.libvirt.org (Postfix, from userid 996) id A615D14AC; Mon, 16 Dec 2024 17:08:23 -0500 (EST) Received: from mail-pf1-f176.google.com (mail-pf1-f176.google.com [209.85.210.176]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id BC3C7B0E for ; Mon, 16 Dec 2024 17:08:22 -0500 (EST) Received: by mail-pf1-f176.google.com with SMTP id d2e1a72fcca58-728e729562fso3928147b3a.0 for ; Mon, 16 Dec 2024 14:08:22 -0800 (PST) Received: from ubuntu-XPS-13-9300.. ([2804:14d:baa2:49b1:fb51:2919:3c87:91a0]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-801d5c33f49sm4524910a12.69.2024.12.16.14.08.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 16 Dec 2024 14:08:20 -0800 (PST) X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-1.7 required=5.0 tests=DKIM_ADSP_CUSTOM_MED, DKIM_INVALID,DKIM_SIGNED,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2,RCVD_IN_VALIDITY_RPBL_BLOCKED, RCVD_IN_VALIDITY_SAFE_BLOCKED,SPF_HELO_NONE autolearn=unavailable autolearn_force=no version=3.4.4 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1734386901; x=1734991701; darn=lists.libvirt.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=RBwH9GzBRZxf54pSa8BZSEpOsRYyEgbhHXGuzFBN8WM=; b=MEbQHbeJ8YBRlC7fUb7thu3NUQ/DhNddz2WnguCXc5qyFDOi31NysMZE3eboBClrMN U+K6HoygtpalAW9FpAuM4wHsAnyS3dcc7+6xG6SR5gHDnI5FgTSPawNiEjmGhY+Yt08Y o10gc5DrNsodyzpVlq3G81vhICL7bb8xz0V3R5qvZVe02Vw3BydfH6WYyOSrQK7pVtWF IZT1MFmSv6j+kijfIyEuMajLhCHK4vTuH6SxiDpSSvmaBg7WwiYGlnkCXPAyT2DsiaHh mI11iOaEW5e0quEnmgXN+08da2M6+zqddn7vfBD8L/o8hGu6xJWhBjBCxEziaqpbPmWQ lqUQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1734386901; x=1734991701; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=RBwH9GzBRZxf54pSa8BZSEpOsRYyEgbhHXGuzFBN8WM=; b=rN+kzYNrMWU8dCgbh4pCXLFDERFb3afDuCYl6NFJxN5pXj8L7lXBlnM5016qgB+MdE UfXnXnxcTR4Y3+da/2aM85H0mOnsgkFSusAGXec7y4HQiUiO8WcF6vt5ncvUDkk4ru/2 /vPP0CoXlDIQ9/q5mld/VD3iHnd0mJ8efLooaGdsQXr2BGTmrdff0pInuiLcb8e7AxAG YC8NklGtC0lZTlMwgKQKua/YagTYXUVEhCFSQbVzzebZrd2EWsDresKIwiSYRDzKSzN2 eaXS/9H6ctb2Te3PM19/46rXWiyTXWUfhV+sAeXhXqP17n3PeiaXO3+hAsqO6qW2f2GZ rIIA== X-Gm-Message-State: AOJu0Yy23iUt0cwXL/OxFhwSV3aFqOAWdmmclPpsmL21L3SasrCukKVl exF7PP2wDqlJUgvY3oJvzoib1+nU/cnPDUXadSkc06M9T7ZOzE2JUGXXBA== X-Gm-Gg: ASbGncu7o6vZy/IJmVSOj+x+SIZh5MPa5dtVCxqaNbxKVbi/STQN4KsdyXK5E6sJh6z M3A2Ped3AyymMt3Uk5U5goiyiZ2qZp3DnRsssNLF1lzgXfv6oum+GsTheESml3HueSk9wVspHmB laCsbnbg2+moDZuZIkue69AtyzAtDiK/2aje8U16h04N+tUSiUhMyvDq9nSOy/YXkCnlDLrEt9d Zu1YluwC33tQ7+ZskwstAI4awv6VlBvrQdTnn4De/M9Z/eK345pGn5Fmt4funf36Gikwu7Nnb/A C+bcK5k= X-Google-Smtp-Source: AGHT+IEYCQXPmIjQpbaDirIhmDxioDPEHIkntfgrt+CuNQDdwvc9TrjAJVZrExcTYKR6EVQzMv8Aag== X-Received: by 2002:a05:6a00:1891:b0:725:e721:1a41 with SMTP id d2e1a72fcca58-7290c27490fmr14544957b3a.26.1734386901091; Mon, 16 Dec 2024 14:08:21 -0800 (PST) From: Fabricio Duarte To: devel@lists.libvirt.org Subject: [PATCH] docs: fix 'virsh domstats --vcpu' measure units and descriptions Date: Mon, 16 Dec 2024 19:02:44 -0300 Message-Id: <20241216220244.434090-1-fabricio.duarte.jr@gmail.com> X-Mailer: git-send-email 2.39.2 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-MailFrom: fabricio.duarte.jr@gmail.com X-Mailman-Rule-Hits: nonmember-moderation X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1; header-match-config-2; header-match-config-3; header-match-devel.lists.libvirt.org-0 Message-ID-Hash: RV5PZZTAWCERPNEYL653GQ3HKQXJYMUV X-Message-ID-Hash: RV5PZZTAWCERPNEYL653GQ3HKQXJYMUV X-Mailman-Approved-At: Tue, 17 Dec 2024 08:28:47 -0500 CC: Fabricio Duarte X-Mailman-Version: 3.2.2 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1734424150031116600 Content-Type: text/plain; charset="utf-8" The fields are in nanoseconds, not microseconds. Also fixes the description= of `vcpu..wait`, as it does not actually represent the time waiting o= n I/O. Signed-off-by: Fabricio Duarte --- docs/manpages/virsh.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/manpages/virsh.rst b/docs/manpages/virsh.rst index 2e525d3fac..b0a21e019a 100644 --- a/docs/manpages/virsh.rst +++ b/docs/manpages/virsh.rst @@ -2428,14 +2428,14 @@ When selecting the *--state* group the following fi= elds are returned: * ``vcpu..state`` - state of the virtual CPU , as number from virVcpuState enum * ``vcpu..time`` - virtual cpu time spent by virtual - CPU (in microseconds) -* ``vcpu..wait`` - virtual cpu time spent by virtual - CPU waiting on I/O (in microseconds) + CPU (in nanoseconds) +* ``vcpu..wait`` - time the vCPU wants to run, but the host + scheduler has something else running ahead of it (in nanoseconds) * ``vcpu..halted`` - virtual CPU is halted: yes or no (may indicate the processor is idle or even disabled, depending on the architecture) * ``vcpu..delay`` - time the vCPU thread was enqueued by the - host scheduler, but was waiting in the queue instead of running. + host scheduler, but was waiting in the queue instead of running (in nano= seconds). Exposed to the VM as a steal time. =20 This group of statistics also reports additional hypervisor-originating pe= r-vCPU --=20 2.39.2