From nobody Sun Nov 24 00:07:24 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 1731939117065623.2827479535047; Mon, 18 Nov 2024 06:11:57 -0800 (PST) Received: by lists.libvirt.org (Postfix, from userid 996) id 052DC1B82; Mon, 18 Nov 2024 09:11:55 -0500 (EST) Received: from lists.libvirt.org (localhost [IPv6:::1]) by lists.libvirt.org (Postfix) with ESMTP id A6D241B4B; Mon, 18 Nov 2024 09:10:21 -0500 (EST) Received: by lists.libvirt.org (Postfix, from userid 996) id 70CD419FF; Mon, 18 Nov 2024 08:54:52 -0500 (EST) Received: from mail-pg1-f172.google.com (mail-pg1-f172.google.com [209.85.215.172]) (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 B8DC71A06 for ; Mon, 18 Nov 2024 08:54:51 -0500 (EST) Received: by mail-pg1-f172.google.com with SMTP id 41be03b00d2f7-7f8b37edeb7so3129872a12.0 for ; Mon, 18 Nov 2024 05:54:51 -0800 (PST) Received: from localhost.localdomain ([2409:40f4:9:7d39:e991:fcfb:15ab:ce58]) by smtp.googlemail.com with ESMTPSA id d2e1a72fcca58-72477135ecbsm6113482b3a.84.2024.11.18.05.54.47 (version=TLS1_3 cipher=TLS_CHACHA20_POLY1305_SHA256 bits=256/256); Mon, 18 Nov 2024 05:54:49 -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.5 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=1731938090; x=1732542890; 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=xJAKvmxHR7nTRyL8/2bKa4tHeE/ZtpqtrhAD08gn9oE=; b=bP/JKx3LbWIq3AX6JvxBrLhsEG++3Kn19Pmfap1ZeiOLQDtHKgkGUJRZcx9wCHC4gh BOwri7SM3MLDVeHuWySyGG/5LOZIjlg6hajEx0SA0Ocb3/PvQLJNQZVvz1Ewws6ZiPKx lLBBVfEMOzb8+lSyFSug10z9YNN2jSx9cL6lj0xk+ySrw+l1qpuhMIVwlG82bX7m3jv7 GtqikiwFCj4iBm91rOKXPr40lbZtqHkA5KAGNSdw1FXP49GGXg4WmePpa+6Cs174hgA4 TE24D7Ca34fCXTNsGsVfsj6Ri4esOFZ2Emf5WJV5xPt8E+ITlflml4FK6Jf4VY/I0XWr w+ZQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1731938090; x=1732542890; 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=xJAKvmxHR7nTRyL8/2bKa4tHeE/ZtpqtrhAD08gn9oE=; b=Sj53YHrzQQcWWEMNGbXYcwekz6ny+lP9uHJk0UYVoLJTOATBRpIALE7sW69S+hY+gc OJIZx0+DKynEDZ7a+Pc5Y1n/a2tGcPbVO8YkmxVl5Gml4xvl+subk90BKau+653hB+td h9N18Q4EMl5n2w+TG1fqx2/TJMXgOyDJWkOpsDgs8ktATZlDonGJGeFjRJ+ks3CyLZqw L5bP3tPWEwf5LfEOKwMzhWdO72jQsworGa4e8hvBCrLWq7EHNI4fd/m+vuN/WEBUV/hy iyX4eHKMxPRBENbHOgAUu8/ReNJOI6FVWUCVT6BXoxhN00ETvBO8RR9NpEgiyBlGDMmj Mh4Q== X-Gm-Message-State: AOJu0Yyfn9VhUs+KKic3gl3RBoWXlnBwFjZ0KlY5pum5HCU6V40p3f2u cXN7JYG7iYsPd0QBZOUeoS39GT+iSutz1mrWnNjEbVIVMKiWiy6Z//A2k9dM X-Google-Smtp-Source: AGHT+IF6gGsKIXn/nrpjQQH6qVjLuGol2O4ItQCaj/+p7OZpUl8OCR6FEaMmMAJJ1MezGOK1mVEZhw== X-Received: by 2002:a05:6a21:7881:b0:1db:dbad:ce3b with SMTP id adf61e73a8af0-1dc90b60450mr17959178637.23.1731938090201; Mon, 18 Nov 2024 05:54:50 -0800 (PST) From: Harikumar R To: devel@lists.libvirt.org Subject: [PATCH v5 02/18] schema: Add new domain elements to support multiple throttle filters Date: Mon, 18 Nov 2024 19:24:10 +0530 Message-Id: <20241118135426.37643-3-harirajkumar230@gmail.com> X-Mailer: git-send-email 2.39.5 (Apple Git-154) In-Reply-To: <20241118135426.37643-1-harirajkumar230@gmail.com> References: <20241118135426.37643-1-harirajkumar230@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-MailFrom: harirajkumar230@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: JS5GTAKXQZOUQVJDX7K4S6QZICS57SFO X-Message-ID-Hash: JS5GTAKXQZOUQVJDX7K4S6QZICS57SFO X-Mailman-Approved-At: Mon, 18 Nov 2024 14:10:14 -0500 CC: harikumar.rajkumar@ibm.com, sanjeev.ranjan@ibm.com, earulana@in.ibm.com, Chun Feng Wu 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: 1731939120348116600 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://github.com/qemu/qemu/blob/master/docs/throttle.txt Signed-off-by: Chun Feng Wu --- 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 5b7f18b2f0..0c41b47a77 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -2753,6 +2753,15 @@ paravirtualized driver is specified via the ``disk``= element. + + + + + + + + + ... =20 @@ -3233,6 +3242,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 10.7.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 6f08ac4da5..131fd396a4 100644 --- a/src/conf/schemas/domaincommon.rng +++ b/src/conf/schemas/domaincommon.rng @@ -1636,7 +1636,10 @@ - + + + + @@ -6840,6 +6843,20 @@ + + + + + + + + + + + +