From nobody Mon Feb 9 06:52:44 2026 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=redhat.com Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1726152538515637.035535805065; Thu, 12 Sep 2024 07:48:58 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 996) id 70C6915C7; Thu, 12 Sep 2024 10:48:57 -0400 (EDT) Received: from lists.libvirt.org (localhost [IPv6:::1]) by lists.libvirt.org (Postfix) with ESMTP id AEFD515E0; Thu, 12 Sep 2024 10:48:15 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 996) id 94467144E; Thu, 12 Sep 2024 10:48:11 -0400 (EDT) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) (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 228DE1439 for ; Thu, 12 Sep 2024 10:48:11 -0400 (EDT) Received: from mail-wr1-f70.google.com (mail-wr1-f70.google.com [209.85.221.70]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-385-2fcWZmosN9OXLqOoT68eVQ-1; Thu, 12 Sep 2024 10:48:09 -0400 Received: by mail-wr1-f70.google.com with SMTP id ffacd0b85a97d-374b981dd62so571866f8f.3 for ; Thu, 12 Sep 2024 07:48:09 -0700 (PDT) Received: from wheatley.localdomain (nat-pool-brq-t.redhat.com. [213.175.37.10]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-378956dd9dcsm14575616f8f.92.2024.09.12.07.48.06 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Sep 2024 07:48:06 -0700 (PDT) Received: from wheatley.redhat.com (wheatley.k8r.cz [127.0.0.1]) by wheatley.localdomain (Postfix) with ESMTP id 8616824680FA for ; Thu, 12 Sep 2024 16:48:06 +0200 (CEST) X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-0.5 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE autolearn=unavailable autolearn_force=no version=3.4.4 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1726152490; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=giTi1vr8H16jdCeUyj4sYwZ5LcbXaoEQALvyp7LNxrg=; b=R5sNknYAsAVaK9+m8jAPqThhfMBjGI+1LOXRrXiTYjkTbDd4qvD5hg0hY7yog+n6ieZLmx SEf+VunbxwjmeuJv9unM1Rgk77g/AS/TkDDjYPB1Ru2VwR6LHjA/5/qtg9B2XtoOpsnHQI 2RRNwK6xeVsDHc3+kqsY6BVD+oztHog= X-MC-Unique: 2fcWZmosN9OXLqOoT68eVQ-1 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1726152488; x=1726757288; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=giTi1vr8H16jdCeUyj4sYwZ5LcbXaoEQALvyp7LNxrg=; b=rEIW+DYNCLLBm3XLir9pEhbLfVbNwkZKm3s4xfjzkvSMhldMq9v9HZnAnQUp7aWgMU YH6ltWa5gmse27BqBQZ69RL01RWh28bQgTl2ZFwsR6ZFD53IKh+7zbmL2pMKjIzDRXvw YxOV9NcnsjiYDqjReF6YFL8S5fNPYBEMF1aP4y+CeGEIqd2z5ZGDvEsnvz75XyXHmQgV uEaeM87ze/42XVzXrUxe6L564T+G47pi1OBwSb686rmr+h15a3UUud2OznKh8HgazTMh fCEsTDKi9TfMBgQip/tsdSeO2mJJI3u7Rl1gKliC3HwL4YevemfpqlBTbOSZrXJnZHSB Z77Q== X-Gm-Message-State: AOJu0YzW3OTpTDw/S5Jdt4yFvjmkLttTI+5XB31mB9qdKyOaNd25p8bb 0XzHY8TpTcsFPgC5o40Dwe7hHBu33E1qztRh4P9CR5H+Vc2spFGVbGJefwSz7zzAH/0NxjAsWuf ki1AY+Fcoo+8keoTvAljjvbm6lRbIV6/U9NRbYcFb0HmpLIHYbJ/rL4wQs/mk2DHx5mWiHcdaDu zuwUXWG2mrZ9yPqGvGBPd2Dx0UR2zuv9JGzfs3mLU= X-Received: by 2002:a5d:4535:0:b0:371:93eb:78a4 with SMTP id ffacd0b85a97d-378c2cd3de9mr1796585f8f.9.1726152488523; Thu, 12 Sep 2024 07:48:08 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHN4zwcPH2cItcfA84IkmORpsXT5v5yt4/V0joRgmXJ5JlI9U2wW0qtC03Fjv5k4kOd2/zqlg== X-Received: by 2002:a5d:4535:0:b0:371:93eb:78a4 with SMTP id ffacd0b85a97d-378c2cd3de9mr1796543f8f.9.1726152487408; Thu, 12 Sep 2024 07:48:07 -0700 (PDT) From: Martin Kletzander To: devel@lists.libvirt.org Subject: [PATCH 02/10] docs: Document memory bandwidth allocation limits more clearly Date: Thu, 12 Sep 2024 16:47:51 +0200 Message-ID: <5e594ad1ff9668ba68d30c20042ad2c7bc3a0d5e.1726152457.git.mkletzan@redhat.com> X-Mailer: git-send-email 2.46.0 In-Reply-To: References: MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Message-ID-Hash: IHPL5NEJ6AIU6QZ2KPJ5RXYQZ55MRUYA X-Message-ID-Hash: IHPL5NEJ6AIU6QZ2KPJ5RXYQZ55MRUYA X-MailFrom: mkletzan@redhat.com 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; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; suspicious-header 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: 1726152538770116600 Content-Type: text/plain; charset="utf-8"; x-default="true" The meaning of the values as well as their maximums are hard to predict and accounting for all the possibilities (which by the way might change during daemon's execution) is borderline hallucinatory. There is already a way we represent them, which is the same as the Linux kernel. We do not interpret them at all, just blindly use them. In order to make this more apparent for the users change the documentation for the (not ) element more boldly. Signed-off-by: Martin Kletzander --- docs/formatdomain.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 47d3e2125e45..5eb7f918b4b5 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -1018,8 +1018,11 @@ CPU Tuning ``id`` Host node id from which to allocate memory bandwidth. ``bandwidth`` - The memory bandwidth to allocate from this node. The value by def= ault - is in percentage. + The memory bandwidth to allocate from this node. The value is usu= ally + in percent (Intel) but can also be in MB/s (if resctrl is mounted= with + the ``mba_MBps`` option) or in 1/8 GB/s increments (AMD). The us= er is + responsible for making sure the value makes sense on their system= and + configuration. =20 =20 Memory Allocation --=20 2.46.0