From nobody Tue Sep 22 02:45:52 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=pass(p=reject dis=none) header.from=lists.libvirt.org ARC-Seal: i=1; a=rsa-sha256; t=1783707274; cv=none; d=zohomail.com; s=zohoarc; b=dVd/KTGcrv2zyZR0PIky3fADsb2DwdZ0JJE0rZ1f5/zHqXiz8M8cHobZ6hkkLhC8mNYxAJBEKQ9Pcd7wQX2EhNswLW/yqkk5q+rNgp6IN+WIb+P2+N69SC05oU5LOrRiI++zAeiMfm+ZiXqqG4szJTd92/rd5kjJvg2s5eaYw4Y= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1783707274; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Owner:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:Reply-To:References:Subject:Subject:To:To:Message-Id; bh=7l4xh5KGOQLUAkUYhrvxUdzpOpkeJqRVExIjGWZZDCY=; b=KMFCGBBmcjv8ZdWSvY1Z1fVencxrYwRTnXxVl0ojGF7Xx99Fro4wxAbImNzo8iqX0V64o0pD+FmPnTCiJmBPWO4WoAbc0uHJt6JUIOlaOmhE2T+5dqPXXpsJTirCEJ934vxhn20gG6oP6AW9RNBtWUsv/ZRlpA6UfBclu1lcIiY= ARC-Authentication-Results: i=1; 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=pass header.from= (p=reject dis=none) Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [38.145.34.151]) by mx.zohomail.com with SMTPS id 1783707274537633.7889698465017; Fri, 10 Jul 2026 11:14:34 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 993) id 2E74D41D63; Fri, 10 Jul 2026 14:14:33 -0400 (EDT) Received: from [172.19.199.10] (unknown [10.16.107.18]) by lists.libvirt.org (Postfix) with ESMTP id 9AD7E41C62; Fri, 10 Jul 2026 14:13:37 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 993) id 7E26F41C34; Fri, 10 Jul 2026 14:13:26 -0400 (EDT) Received: from smtp-relay-internal-0.canonical.com (smtp-relay-internal-0.canonical.com [185.125.188.122]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (3072 bits)) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id 8C19841BB4 for ; Fri, 10 Jul 2026 14:13:24 -0400 (EDT) Received: from mail-wr1-f70.google.com (mail-wr1-f70.google.com [209.85.221.70]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by smtp-relay-internal-0.canonical.com (Postfix) with ESMTPS id 9178F3FA70 for ; Fri, 10 Jul 2026 18:05:43 +0000 (UTC) Received: by mail-wr1-f70.google.com with SMTP id ffacd0b85a97d-47416fc1674so1277032f8f.3 for ; Fri, 10 Jul 2026 11:05:43 -0700 (PDT) Received: from workstation5 ([2a02:3035:621:9ef:5b82:e6cb:d339:9973]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-47a9e4d6e4csm58675604f8f.10.2026.07.10.11.05.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 10 Jul 2026 11:05:42 -0700 (PDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-26) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-5.0 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,SPF_HELO_NONE autolearn=unavailable autolearn_force=no version=4.0.1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=canonical.com; s=20251003; t=1783706743; bh=7l4xh5KGOQLUAkUYhrvxUdzpOpkeJqRVExIjGWZZDCY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=VQ4EUUwQATqPilOOiww8MYaedVOO0u2h8PFN9raBN8EV9J9i7vkX761J0EMA/bs0K YqVdcBPrJYOEO930zWDP/w6BxvRKIUwSmswYk524MN6dK0lwJ4TQyGiIbIyTVy4+wA YliReAC8kRfpgm6mzFjv92tBfEmlYPig/9KFP+R57tpKFUhcJrYFF/bbdR2gQE2N3l TWdX6OR+WjSPsx3DG/XoG7AAWL70F9j+rhPs/6q5YmHKQx3i0ifg4NgoordIc+r27f QgGy/cj11+XDP5EAmCINLwe99usBrKIIvt3UZSKg+6s1wIRcjAgtFnatP8NZRHvooe RSkw70QvVCgjyVKLrQOI1n2M63Cd6jQZn6AZbmV1n166B5T+g4p4yHwnBKtWQIC3e9 st8US5MEojf3uRgfCmydPu1VaFwydisnaj/HkvkLSr/ylTvLfGHKHqkWwgiawHyX9O 88PX+xXd2GjARZ0GJUG+4ZZlNSFQS5PTO340a0UgdLSNRwGw6hJo8COE4sdd9q5GJv iID/FWGiNalNKbgIX+94BCBfc+tw3Yie0giuhwREg4pvJWS1Gz1V8GqUJ8hLPTR3dT EW/Wiwm4VRWgrjFEgqSE5Fg7xlC6tkjI77KH0VWU9Bvgtc8oDTaQvVbbK8hVF4ZZaJ n4jeNwBXNp/N5cuG170gl+Kc= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1783706743; x=1784311543; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to:content-type; bh=7l4xh5KGOQLUAkUYhrvxUdzpOpkeJqRVExIjGWZZDCY=; b=srZ2c0iErSCO9nVndlf6B7a0np+2zMkZDVDN6iVqGfUHrccwVLI0VmyIOrJWCrSFZW f5993TdqTiY5+nVw09CLdIJlxBlOVB49tKAzLSheboCFz2EQ4k3+v05S+Ci3/DmEI75b NZDsJCFI41TvWx2EnLZUDk3aC24/wMvhW7kG9XpUuSHCN/+Q9Mn79cta1B00JQCJ7z/4 pRkxJs2ebxrkafLgxWOY2T8Gbcfu3QzmoDPVBT0cOtngFIA7hivV/UgCSMl1ruMtEEl8 ZT53eFaNuatOqFO3QBTzwYCIoy182upXnEJT7HeinXO4x2VRbDXCJpiouPniloXGZ0Yd n+ng== X-Gm-Message-State: AOJu0YyI/n8/jd8ido6MN6WAnqmhjclP0M5aQwpnxYd5lWIGIXsJrI2a lxhx9V69iz3334AG7eiQ5iDXIS4DCst7ZaVAOU6sCqaz8osbAFEbLyJErKc26m2BWnT6kkOokiL CfAu1u8aLq4LeqKq6M6xidNWaUs+tb5K7sSEflilhJbWOf74If47fXar4G11fQja2v8wRh5zLgZ 4vM5fEvgg= X-Gm-Gg: AfdE7clpSUUPeTcx1Ysf7Txm/T56frU1o/ZxaoljicHGObE3aPSg/zGlHe/7eJFiWOe fw0XG3AQRObx5sdq1SMwwQ+6MCP39KvK2+xuNjgEsNKvNdSFuDDaKl0ynJ428jd8otjjxRMQmAz dh6OHaIwN4ZZeADzUis58g6crFmb+5IRym0jEsuuEEX7jM3YUxBufDzzfgF/ut0iJAk14ePUjYj jfDcp/yjgL845BWEQtEPbIIe6JOPLrv//BJYTF3/2K49MGpGK0Y6hKV/3CxTLrrvp8w+Ve6ExKy v6f/EP+OG7VlSwS5QYnzmndarlzSMwmMtDJCCt0+JqPk/rXt9lyN+LPe4bllLvRbv1n9Qy9sOwO znHsk6gBOk4PpDpQFN9yk1pBJuAnr5LFwGnz5b9G7pDMk2rgr8OCwD1Bs4bj8Onn5 X-Received: by 2002:a5d:5f46:0:b0:45e:f439:9def with SMTP id ffacd0b85a97d-47df0748abcmr14672171f8f.15.1783706743196; Fri, 10 Jul 2026 11:05:43 -0700 (PDT) X-Received: by 2002:a5d:5f46:0:b0:45e:f439:9def with SMTP id ffacd0b85a97d-47df0748abcmr14672143f8f.15.1783706742779; Fri, 10 Jul 2026 11:05:42 -0700 (PDT) To: devel@lists.libvirt.org Subject: [PATCH 6/6] docs: add vlen to formatdomain documentation Date: Fri, 10 Jul 2026 20:05:23 +0200 Message-ID: <20260710180523.54387-7-heinrich.schuchardt@canonical.com> X-Mailer: git-send-email 2.53.0 In-Reply-To: <20260710180523.54387-1-heinrich.schuchardt@canonical.com> References: <20260710180523.54387-1-heinrich.schuchardt@canonical.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Message-ID-Hash: 64VJSQ37JKHQLBS5KNVP3BDISKRIK6I2 X-Message-ID-Hash: 64VJSQ37JKHQLBS5KNVP3BDISKRIK6I2 X-MailFrom: heinrich.schuchardt@canonical.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: Heinrich Schuchardt 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: From: Heinrich Schuchardt via Devel Reply-To: Heinrich Schuchardt X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1783707279582158500 Content-Type: text/plain; charset="utf-8" Describe the usage of the vlen attribute for RISC-V CPUs. Signed-off-by: Heinrich Schuchardt --- docs/formatdomain.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index a861f9f177..3856bc8921 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -1810,7 +1810,20 @@ In case no restrictions need to be put on CPU model = and its features, a simpler address bits for ``passthrough`` mode, i.e. in case the host CPU repo= rts more bits than that, ``limit`` is used. :since:`Since 9.3.0` =20 +``vlen`` + :since:`Since 12.6.0` the ``vlen`` element describes the length, in bit= s, + of the vector registers exposed to the guest CPU. This is currently only + supported for RISC-V guests with the ``V`` vector extension enabled, and + corresponds to the QEMU ``vlen`` CPU property, e.g. + ``-cpu rva23s64,vlen=3D256``. The element is omitted if the vector regi= ster + length is not configured, in which case the hypervisor default is used. + + ``value`` + This mandatory attribute specifies the vector register length in bit= s. + The value must be a power of two in the range [8, 65536]. + Guest NUMA topology can be specified using the ``numa`` element. + :since:`Since 0.9.8` =20 :: --=20 2.53.0