From nobody Mon Feb 9 10:33:21 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1654009812; cv=none; d=zohomail.com; s=zohoarc; b=ClHQlmskv3cxN5oR9qvt/WCt90mE08uAQd0FmO4KQe/G2VXzK3A/52TT6uO/c7tsJFUqNu6QsYDxa8etx/HOGXF6r3eaB2RUE4WJWfjh9lr0sPRXN/AWhtQNmvjmKfptLk8sWp7j3MbjGatogra+t/Vcv8GbrnlYbyhj3S0ECE4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009812; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=bKwSdKIFl3EvDa0WTIxauDnWq2+83lStY9/sHtS04w0=; b=Gtcaiy1vXt7p357OivcyDxMfaaypEO3sGTSI2wKFqKDK2mQ3Y2slOxt2SyUL7LTINb/JvqPjnjBgnA36zZj+pFAUQtOz2E0UrPaWY/eCnkXIyAxbPEKJvTU36H/jwvMdKBtxfgfgIagK4+HQ5nLrVeZ57jlsv6U0juTUp5K/ETE= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mx.zohomail.com with SMTPS id 1654009812039296.2249229791803; Tue, 31 May 2022 08:10:12 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-574-N2Z455cMOCCmemscqSoX_w-1; Tue, 31 May 2022 11:08:14 -0400 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.rdu2.redhat.com [10.11.54.4]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 91B611801229; Tue, 31 May 2022 15:07:06 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (unknown [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 346762026D64; Tue, 31 May 2022 15:07:06 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id DB608194707A; Tue, 31 May 2022 15:07:05 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id DD08B194706A for ; Tue, 31 May 2022 15:06:56 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id CCD0C1731B; Tue, 31 May 2022 15:06:56 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 555301131A for ; Tue, 31 May 2022 15:06:56 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009811; h=from:from:sender:sender: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:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=bKwSdKIFl3EvDa0WTIxauDnWq2+83lStY9/sHtS04w0=; b=U/Hc0KRE/c/xMvnrvVZHEVSV0sy7zmO1zN7874zI8ic5ifS6Hdybe09/5lUKJTAuP1VAem Yw4uZgsyqeNZWpFgflEQTmQY8uivHDzQ6TZuSwpf6m2Dk8zraKSm6dSUAg/DZ4qHqGJ3of XZUamWyk+ZaNwSLq+NtmstP4fkBlZXg= X-MC-Unique: N2Z455cMOCCmemscqSoX_w-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 15/67] docs: formatdomain: Remove 'elementsCPU' anchor Date: Tue, 31 May 2022 17:05:50 +0200 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.11.54.5 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 2.78 on 10.11.54.4 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1654009813889100002 Content-Type: text/plain; charset="utf-8" Reworded documentation around the local link. Signed-off-by: Peter Krempa --- docs/formatdomain.rst | 5 ++--- docs/formatdomaincaps.rst | 2 +- docs/kbase/kvm-realtime.rst | 2 +- docs/manpages/virsh.rst | 4 ++-- 4 files changed, 6 insertions(+), 7 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 45f94e5fa2..e8431f972f 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -948,8 +948,8 @@ Memory Allocation or "TiB" for tebibytes (2\ :sup:`40` or 1,099,511,627,776 bytes). Howev= er, the value will be rounded up to the nearest kibibyte by libvirt, and may be further rounded to the granularity supported by the hypervisor. Some - hypervisors also enforce a minimum, such as 4000KiB. In case - `NUMA <#elementsCPU>`__ is configured for the guest the ``memory`` elem= ent + hypervisors also enforce a minimum, such as 4000KiB. In case NUMA is + configured for the guest (See `CPU model and topology`_) the ``memory``= element can be omitted. In the case of crash, optional attribute ``dumpCore`` c= an be used to control whether the guest memory should be included in the gene= rated coredump or not (values "on", "off"). ``unit`` :since:`since 0.9.11` , @@ -1252,7 +1252,6 @@ Using this feature requires Fibre Channel capable HW,= kernel compiled with option ``CONFIG_BLK_CGROUP_FC_APPID`` and ``nvme_fc`` kernel module loaded. :since:`Since 7.7.0` -:anchor:`` CPU model and topology ---------------------- diff --git a/docs/formatdomaincaps.rst b/docs/formatdomaincaps.rst index 9ca7cdcc7c..d8fcf65450 100644 --- a/docs/formatdomaincaps.rst +++ b/docs/formatdomaincaps.rst @@ -165,7 +165,7 @@ CPU configuration ~~~~~~~~~~~~~~~~~ The ``cpu`` element exposes options usable for configuring `guest -CPUs `__. +CPUs `__. :: diff --git a/docs/kbase/kvm-realtime.rst b/docs/kbase/kvm-realtime.rst index 9b38aff0fd..f0a1bb7c95 100644 --- a/docs/kbase/kvm-realtime.rst +++ b/docs/kbase/kvm-realtime.rst @@ -150,7 +150,7 @@ siblings. This is achieved using the `CPU tuning config= <../formatdomain.html#cp -The `guest CPU model `_ now needs to be +The `guest CPU model `_ now need= s to be configured to pass through the host model unchanged, with topology matchin= g the placement: diff --git a/docs/manpages/virsh.rst b/docs/manpages/virsh.rst index e73e590754..5cb948bb91 100644 --- a/docs/manpages/virsh.rst +++ b/docs/manpages/virsh.rst @@ -895,7 +895,7 @@ domain capabilities XML (printed by ``domcapabilities``= command). In addition to the element itself, this command accepts full domain XML, capabilities XML, or domain capabilities XML containing the CPU definition. For more information on guest CPU definition see: -`https://libvirt.org/formatdomain.html#elementsCPU `__. If *--error* is +`https://libvirt.org/formatdomain.html#elementsCPU `__. If *--error* is specified, the command will return an error when the given CPU is incompatible with host CPU and a message providing more details about the incompatibility will be printed out. If *--validate* is specified, validat= es @@ -943,7 +943,7 @@ host CPU model found in the domain capabilities XML (pr= inted by the ``domcapabilities`` command). In addition to the element itself, this command accepts full domain XML, capabilities XML, or domain capabilities = XML containing the CPU definition. For more information on guest CPU definition -see: `https://libvirt.org/formatdomain.html#elementsCPU `__. +see: `https://libvirt.org/formatdomain.html#elementsCPU `__. The *virttype* option specifies the virtualization type (usable in the 'ty= pe' attribute of the top level element from the domain XML). *emulato= r* --=20 2.35.3