From nobody Sun Dec 7 13:31:46 2025 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 1739984606777569.9440365642116; Wed, 19 Feb 2025 09:03:26 -0800 (PST) Received: by lists.libvirt.org (Postfix, from userid 996) id B67BF1C93; Wed, 19 Feb 2025 12:03:25 -0500 (EST) Received: from lists.libvirt.org (localhost [IPv6:::1]) by lists.libvirt.org (Postfix) with ESMTP id A73A11D89; Wed, 19 Feb 2025 12:01:55 -0500 (EST) Received: by lists.libvirt.org (Postfix, from userid 996) id 0E4F81C9B; Wed, 19 Feb 2025 12:01:50 -0500 (EST) Received: from mail-pl1-f170.google.com (mail-pl1-f170.google.com [209.85.214.170]) (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 A58481CA0 for ; Wed, 19 Feb 2025 12:01:41 -0500 (EST) Received: by mail-pl1-f170.google.com with SMTP id d9443c01a7336-220c665ef4cso106022995ad.3 for ; Wed, 19 Feb 2025 09:01:41 -0800 (PST) Received: from localhost.localdomain ([2001:4490:4ea9:8374:8512:e327:fdaf:a56e]) by smtp.googlemail.com with ESMTPSA id d9443c01a7336-220d558fe3asm106651545ad.234.2025.02.19.09.01.37 (version=TLS1_3 cipher=TLS_CHACHA20_POLY1305_SHA256 bits=256/256); Wed, 19 Feb 2025 09:01:39 -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=-0.8 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_H3,RCVD_IN_MSPIKE_WL,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=1739984500; x=1740589300; darn=lists.libvirt.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=6p2QohHfoWseISjeQwGUwOfrm6ElJZf/Wu6ayCjLCAY=; b=FJ1YrL2VG7mX9hIImZvkx1vddxIUiujGin7pl+GPbSZXl0SysbS2y3qNAtsqacsLQr 9OtROO+juUvEWGBVPWf2IZaS9hxLHV/tqd82ntOMBfymWfXRxvhxWtwmJaxvQJEBJ3Mv V5c7mRelG0SB3rEWdMDer6iggzmOZN/wcy6l5ZjyBR+bOvfrI2POLPA8GdMH9GzD5yYu hpYahhEmSN88XaKWbEpu/jEZMw9UHa+JtxE1AMc9xbkTQm6AiKWIBGP8x+3m6BucX555 q3ny6YrlPhtMmj7uPAPgNBUsbIb63yDFYYiMX4/ALQ2Qv+9yWwJd/O+9h18NNcjPfkoX HnXg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1739984500; x=1740589300; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=6p2QohHfoWseISjeQwGUwOfrm6ElJZf/Wu6ayCjLCAY=; b=MmiKeohMJJNz895km2cavJY+ms1WMowzTylL3LFSXXtFsbX7IMCzwoCxc3uMgVCITs /i5C/54FuS+Tg61Nr3kvv+m2bgNWnFcZCGOSf23Gn5qm6Q2C+LHETAJ29afb+MGz+KVB vQzjt6fgkGqAkb08jUSEuJWTGw/2KcJzSRvch/q7T444MDkBUBuOIcmNHr3+NtUW17KZ AdQecmkXO9yL93a0VAv6s+lQZM7jMBZvst3fEIWmHNmSInKDqH2JKo59jwXWFIGE6Owz O1K+1s4FOl75CRM5Sji8DwiAbVwY8d0kdHwiu9CiJ9nM6E0Jm9CjQAPWb1wktZrmMBZ7 hVZg== X-Gm-Message-State: AOJu0YwxfWQSHrWFnqpz8fVzwSWgtv+VyzhD/DHk/h/Ey5bGSvF2MKsx lsmZFfVq8IAtWwWmXzSNiBi/YUX/MdrVueeRTQ9H6KKoGfyYANF9iBqdnokj X-Gm-Gg: ASbGncvTKmWUPbBELNapI4XJbh/8ctfS9mIO0Z9/sKdkO2HVogU2zd8IjQnRiDXklnC /6pDYSIQy0JsUYJx9mwGSA8GKmu6pfKBaPwMZ3yeeLu4hDcfZeHH5T+BazR7ncRnVWSSYtY18MY 5V3Teb2IqpeGcPbEZTXFnfvh5i5PqslElKPThABn2ZlxxYMXFisZlEM9vQDUSBWVE0AhlgJ//U8 /v8wloSiKrUi5/a9CyYihCC+dsQbx3ap94MqbfLwBiU1db7Z9QXkpTk6qFkhN0tct5AC+nrNcM2 kx5jlvN2EBLJ94mT+1IPDegNc5ANoM+R3Zp1ys5J4sXSgbuPSXYawiDUDQ== X-Google-Smtp-Source: AGHT+IE9kyTnADWkv6IiJoVH5VSL00V/OAqJFkmYAitBHo8lI0v0k4lzioe2shaqzRVZlo6Qv9tejg== X-Received: by 2002:a17:903:1cc:b0:216:60a3:b3fd with SMTP id d9443c01a7336-22103efa54amr279703155ad.3.1739984499731; Wed, 19 Feb 2025 09:01:39 -0800 (PST) From: Harikumar Rajkumar To: devel@lists.libvirt.org Subject: [PATCH v8 02/18] schema: Add new domain elements to support multiple throttle filters Date: Wed, 19 Feb 2025 22:27:06 +0530 Message-Id: <20250219165722.26348-3-harirajkumar230@gmail.com> X-Mailer: git-send-email 2.39.5 (Apple Git-154) In-Reply-To: <20250219165722.26348-1-harirajkumar230@gmail.com> References: <20250219165722.26348-1-harirajkumar230@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Message-ID-Hash: B3NQIBCGKGESQ5GZZKSYLBVGJO5X3OIW X-Message-ID-Hash: B3NQIBCGKGESQ5GZZKSYLBVGJO5X3OIW X-MailFrom: harirajkumar230@gmail.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 CC: sanjeev.ranjan@ibm.com, harikumar.rajkumar@ibm.com, earulana@in.ibm.com, Chun Feng Wu , Harikumar Rajkumar 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: 1739984608563019100 Content-Type: text/plain; charset="utf-8" From: Chun Feng Wu Introduce schema for defining '' element which references throttling groups to form filter chain in qemu for specific disk * Add new elements '' * can include multiple throttlegroup references to form filter chain in qemu * Chained throttle filters feature in qemu is described at https://gitlab.com/qemu-project/qemu/blob/master/docs/throttle.txt Signed-off-by: Chun Feng Wu * Update the version to 11.1.0. * Update the commit message URI. Signed-off-by: Harikumar Rajkumar Reviewed-by: Peter Krempa --- docs/formatdomain.rst | 21 +++++++++++++++++++++ src/conf/schemas/domaincommon.rng | 19 ++++++++++++++++++- 2 files changed, 39 insertions(+), 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index f8df50ff4a..df25d8f36d 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -2791,6 +2791,15 @@ paravirtualized driver is specified via the ``disk``= element. + + + + + + + + + ... =20 @@ -3293,6 +3302,18 @@ paravirtualized driver is specified via the ``disk``= element. :since:`since after 0.4.4`; "sata" attribute value :since:`since 0.9.7`; "removable" attribute value :since:`since 1.1.3`; "rotation_rate" attribute value :since:`since 7.3.0` +``throttlefilters`` + The optional ``throttlefilters`` element provides the ability to provid= e additional + per-device throttle chain :since:`Since 11.1.0` + For example, if we have four different disks and we want to limit I/O f= or each one + and we also want to limit combined I/O of all four disks, we can levera= ge + ``throttlefilters`` to achieve this goal by setting two ``throttlefilte= r`` for + each disk: disk's own filter(e.g. limit2) and combined filter(e.g. limi= t012). + The order of such ``throttlefilter`` doesn't matter within ``throttlefi= lters``. + ``throttlefilters`` and ``iotune`` should be used exclusively. + + ``throttlefilter`` + The optional ``throttlefilter`` element is to reference defined thro= ttle group. ``iotune`` The optional ``iotune`` element provides the ability to provide additio= nal per-device I/O tuning, with values that can vary for each device (contr= ast diff --git a/src/conf/schemas/domaincommon.rng b/src/conf/schemas/domaincom= mon.rng index a675746311..7bb89bff7a 100644 --- a/src/conf/schemas/domaincommon.rng +++ b/src/conf/schemas/domaincommon.rng @@ -1636,7 +1636,10 @@ - + + + + @@ -6881,6 +6884,20 @@ + + + + + + + + + + + +