From nobody Tue Sep 22 11:04:57 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.libvirt.org designates 38.145.34.151 as permitted sender) client-ip=38.145.34.151; 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 38.145.34.151 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=fail(p=reject dis=none) header.from=linux.ibm.com Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [38.145.34.151]) by mx.zohomail.com with SMTPS id 1784746992902575.4215632628777; Wed, 22 Jul 2026 12:03:12 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 993) id BD1DD417DA; Wed, 22 Jul 2026 15:03:11 -0400 (EDT) Received: from [172.19.199.10] (unknown [10.16.107.18]) by lists.libvirt.org (Postfix) with ESMTP id DD25D43E90; Wed, 22 Jul 2026 14:53:12 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 993) id 0F70A41BDC; Wed, 22 Jul 2026 14:52:39 -0400 (EDT) Received: from mx0b-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (3072 bits) server-digest SHA256) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id C424241B95 for ; Wed, 22 Jul 2026 14:52:27 -0400 (EDT) Received: from pps.filterd (m0360072.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 66MIBkAc712858 for ; Wed, 22 Jul 2026 18:52:27 GMT Received: from ppma12.dal12v.mail.ibm.com (dc.9e.1632.ip4.static.sl-reverse.com [50.22.158.220]) by mx0a-001b2d01.pphosted.com (PPS) with ESMTPS id 4fg7ahbbex-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 22 Jul 2026 18:52:26 +0000 (GMT) Received: from pps.filterd (ppma12.dal12v.mail.ibm.com [127.0.0.1]) by ppma12.dal12v.mail.ibm.com (8.18.1.7/8.18.1.7) with ESMTP id 66MInd59030527 for ; Wed, 22 Jul 2026 18:52:26 GMT Received: from smtprelay02.wdc07v.mail.ibm.com ([172.16.1.69]) by ppma12.dal12v.mail.ibm.com (PPS) with ESMTPS id 4fgktq8w7v-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 22 Jul 2026 18:52:26 +0000 (GMT) Received: from smtpav02.wdc07v.mail.ibm.com (smtpav02.wdc07v.mail.ibm.com [10.39.53.229]) by smtprelay02.wdc07v.mail.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id 66MIqOCt31392394 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 22 Jul 2026 18:52:24 GMT Received: from smtpav02.wdc07v.mail.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 5E7C75805B; Wed, 22 Jul 2026 18:52:24 +0000 (GMT) Received: from smtpav02.wdc07v.mail.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 075C75805C; Wed, 22 Jul 2026 18:52:24 +0000 (GMT) Received: from IBM-GLTZVH3.atx-us.ibm.com (unknown [9.16.36.179]) by smtpav02.wdc07v.mail.ibm.com (Postfix) with ESMTP; Wed, 22 Jul 2026 18:52:23 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-26) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-3.2 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, RCVD_IN_DNSWL_LOW,RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE autolearn=unavailable autolearn_force=no version=4.0.1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ibm.com; h=cc :content-transfer-encoding:date:from:in-reply-to:message-id :mime-version:references:subject:to; s=pp1; bh=iCfbEiH+MxIBopMyr EMaekeN2H4EmDjoIkyaOsh3RK0=; b=P5cXIPZt8YlZTpttMndcgWm2joP4RNpTS MYRs/+NPM00kaex+t3LCWkQ56tjUfcRPERCKKQXL0Lq3AvFPpuDhPxMbd6EpRDxb dK9X46yM/7xiEIWT6Suw0mOJUdSqG3jpTirFl0fO7tRXKkPT4LFkYleJIdIhsX03 nh1OZS97xCCHLFUKkaFhQJNwNo9fLAPXQ0l51JKMpCeVwwDtaaz7KxokMkaxwwMz omGnUxDcVUKRKoW8LyMrt93E9ZCiPSZd11CLfTnmzklwp39/K2j16+yXfZ/yUHrF v6hKn8EMFVexviiC9Af551bdj8z9sItT5LVj/9pAEUhxYYZ3uNgpg== From: Jaehoon Kim To: devel@lists.libvirt.org Subject: [PATCH 6/6] docs: formatdomain: document iothread poll-weight Date: Wed, 22 Jul 2026 13:52:15 -0500 Message-ID: <20260722185215.743245-7-jhkim@linux.ibm.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260722185215.743245-1-jhkim@linux.ibm.com> References: <20260722185215.743245-1-jhkim@linux.ibm.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-TM-AS-GCONF: 00 X-Proofpoint-ORIG-GUID: YVt_Iq90ONLK9dWEdcR924z4igsn1W0H X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwNzIyMDE4NCBTYWx0ZWRfX5l3cEgt10xEo ijQJZjEsdtEPuupKLwMTKNjbMAMK1Tz1TvmLUQSX8N6pyqf+aA4n7KzfkWG//Ak8PQ5MmBNS1WX K+DmEkwRWQCAYehDA9GT/3bsRIBnNhXiVXJLVq/7hAe9hTdB2vDHwupl3FVfC3Mj7Ab/RDYe62/ IdhfZHD0Xvq983pL+ku/IierkFQ1PuqkKrfZ0wVHpElgtxPg/Y59qaw8jKn7CvgvE2UJ7XaBKtD rUlKrROQma4Hub/9SUpIQ5xKYS24P5e9vDO1jp+leA1sTHKVfdx2+847wz/cOFXufJfHxVxw9UI qTsRw9LEgWZY1V70zJT1Tc/uzk09Pxw9bBfZIfQtXmByD2EXaUgcMlxSW8AjCsPGXk/+wmFghs0 qSmMGuEtY9htVwFbOk4zA+WQaafTUbuahycqxOZ4IDApXwi4u/VxQuEnTajwZjiJI4cL5+fuUu4 qUbcYVIzSPZ/H0RgYqQ== X-Proofpoint-Spam-Info: AW1haW4tMjYwNzIyMDE4NCBTYWx0ZWRfX9FT9U4BEkunS NX0FfZfBGdTssqtjobK9IGxapu6g1FUFQbTpOMiHbbbXbpgvWGTHIzj68a2eFL72y8iN+0cN0g2 Kh2AwcycuYbHFcwo6dTmwG7N413FYdg= X-Proofpoint-GUID: YVt_Iq90ONLK9dWEdcR924z4igsn1W0H X-Authority-Analysis: v=2.4 cv=SM5ykuvH c=1 sm=1 tr=0 ts=6a61116a cx=c_pps a=bLidbwmWQ0KltjZqbj+ezA==:117 a=bLidbwmWQ0KltjZqbj+ezA==:17 a=RAioF0-LDSMA:10 a=VkNPw1HP01LnGYTKEx00:22 a=RnoormkPH1_aCDwRdu11:22 a=RzCfie-kr_QcCd8fBx8p:22 a=VnNF1IyMAAAA:8 a=q6ly3UnAus1M01P6xgYA:9 a=O8hF6Hzn-FEA:10 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.134,FMLib:17.12.100.49 definitions=2026-07-22_05,2026-07-22_02,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 clxscore=1015 lowpriorityscore=0 bulkscore=0 suspectscore=0 adultscore=0 spamscore=0 malwarescore=0 priorityscore=1501 phishscore=0 impostorscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2606150000 definitions=main-2607220184 Message-ID-Hash: WY7GYH25365FKUIJGVBWPQTRNSMU5XFU X-Message-ID-Hash: WY7GYH25365FKUIJGVBWPQTRNSMU5XFU X-MailFrom: jhkim@linux.ibm.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; header-match-devel.lists.libvirt.org-0; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: fiuczy@linux.ibm.com, shalini@linux.ibm.com, Jaehoon Kim X-Mailman-Version: 3.3.10 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1784746994771158500 Content-Type: text/plain; charset="utf-8" Document the iothread poll-weight XML attribute in formatdomain. Extend the description of iothread polling controls to cover the new poll-weight attribute and how it relates to the existing poll-max, poll-grow, and poll-shrink settings. Also document the accepted range and the meaning of zero as a request for the hypervisor default. Signed-off-by: Jaehoon Kim --- docs/formatdomain.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 3ba981422f..b173fc897b 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -815,7 +815,7 @@ host/guest with many LUNs. :since:`Since 1.2.8 (QEMU on= ly)` - + @@ -849,6 +849,12 @@ host/guest with many LUNs. :since:`Since 1.2.8 (QEMU o= nly)` polling. Attributes ``grow`` and ``shrink`` override (or disable when s= et to ``0``) the default steps for increasing/decreasing the polling interval= if the set interval is deemed insufficient or excessive. + :since:`Since 12.6.0` the optional attribute ``weight`` sets the shift = value + for the adaptive polling algorithm, controlling how much the most recent + event interval affects the next polling duration calculation. Larger va= lues + decrease the weight of recent events, producing more gradual adjustment= s. + Valid range is ``[0, 63]``. Setting ``weight`` to ``0`` lets the hyperv= isor + select its default value. ``defaultiothread`` This element represents the default event loop within hypervisor, where= I/O requests from devices not assigned to a specific IOThread are processed. --=20 2.54.0