From nobody Sun May 12 17:04:04 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009628; cv=none; d=zohomail.com; s=zohoarc; b=RGtBqToyGXa0KLZxEpRjLvUwvSQ+8QiqbRKb/orWmaLXqbdMDK0V4fuNq9hL2uGFvWTxg9FFpyjR34fzFsOJa0XOmJ7Ci0+meiGpXBWy+fx/GAe+hPlsk+IvXZqcX9azdeIs5fHoXPOJakT/DO1m8LAqZVf4GpwN0XVRdQjD+4E= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009628; 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=hXcq0SZhCaT/zeifbzVH3KNUOZ69R7UmynK/zHiYOZg=; b=RNO2A06AZVCTXo2DsiAS9Qm5p2RFlR9EMsk4HcVMx0Qn0xwcFwf1Jnd9aGTQL856gZdVwnQ59xmFN5LmXTtTZGnV9XXxsU8faxXpbYaKaZBeMB46XzYcubUcuWEKcIapSNXKy7JwucUHQZntSCf95ply1Ih6fVKi+HzIQvyO+0k= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009628172882.5794301597246; Tue, 31 May 2022 08:07:08 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-407-Q0R_1xwgMmSSrNEHtao55g-1; Tue, 31 May 2022 11:06:53 -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 B1AB82809CC3; Tue, 31 May 2022 15:06:47 +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 9C8E42026D64; Tue, 31 May 2022 15:06:47 +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 830B3194706D; Tue, 31 May 2022 15:06:47 +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 2C37F1947064 for ; Tue, 31 May 2022 15:06:45 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 10DE18289E; Tue, 31 May 2022 15:06:45 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 8814310725 for ; Tue, 31 May 2022 15:06:44 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009627; 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=hXcq0SZhCaT/zeifbzVH3KNUOZ69R7UmynK/zHiYOZg=; b=HpLaoL0V1CuwOe8EyXYNkdXi6haYY4MizigPqxF+9/gtJF/uGKoRHOe3MqMXfNKV/PmVN4 9C4hcTVefkyD/EK3B7xPqQu/rfzf83lWXG/Vft0eRrUMKbLvfuTRm/ec9JnSNafW7rpkY3 ayjlLVVfv2ORBJzxLHJEUOgN595I3L4= X-MC-Unique: Q0R_1xwgMmSSrNEHtao55g-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 01/67] docs: formatdomain: Remove 'elements' anchor Date: Tue, 31 May 2022 17:05:36 +0200 Message-Id: <17ff6703f9f2f31d338bbcc7a6061ca70b24af84.1654008136.git.pkrempa@redhat.com> 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: 1654009628762100003 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - docs/formatdomaincaps.rst | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 089a99b4b5..a0e8d69b87 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -13,7 +13,6 @@ variations on the format based on the kind of domains run= and the options used to launch them. For hypervisor specific details consult the `driver docs `__ -:anchor:`` Element and attribute overview =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D diff --git a/docs/formatdomaincaps.rst b/docs/formatdomaincaps.rst index 4de96ea83a..55209e53c2 100644 --- a/docs/formatdomaincaps.rst +++ b/docs/formatdomaincaps.rst @@ -68,7 +68,7 @@ The root element that emulator capability XML document st= arts with has name ``path`` The full path to the emulator binary. ``domain`` - Describes the `virtualization type `__ (or = so + Describes the `virtualization type `__ (or so called domain type). ``machine`` The domain's `machine type `__. Since= not --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 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=1654009630; cv=none; d=zohomail.com; s=zohoarc; b=Iz2lLezSFo3orhv9WE1Bcs5GR0MtXMdVAaUO6R5lh4kvpMUZ1PzLjrhLzfg1cooj5U/uD2Vpce+y4uZQauPpqVJ6CWze+Yr293D2NItT9mLMG9qjpBkEwLYb2pE38JfOIpYSc4yPRLNJu0ssdYMeAHcByzkc0deK2C6kXbB1Z7w= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009630; 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=NcMjP2UZyjraEEWmDf0vHMrSxegZR+ecBwf0wSau5Pg=; b=Fk892PlSKXixRpUFGtnq9Bch5sWJlHdKpwJkW65bnePNqp8tx8tUfRH67PB3MplsDxdctkoYYtNT5wDyI55Wj83D27TqQ0GvUz3DJhzam5Gv7FhGuiIFB1QXlxDOHcF0H8Ypra19xkE9mB1xikmvgznsDC5WJrMRYgINwkEZUD0= 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 1654009630987322.30994140605355; Tue, 31 May 2022 08:07:10 -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-588-08s6qrxtMvKIY8TllEEv_A-1; Tue, 31 May 2022 11:06:54 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.rdu2.redhat.com [10.11.54.3]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 4D6711044561; Tue, 31 May 2022 15:06:48 +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 36CD41121314; Tue, 31 May 2022 15:06:48 +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 199771947062; Tue, 31 May 2022 15:06:48 +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 EA300194705C for ; Tue, 31 May 2022 15:06:45 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id DCDF31131A; Tue, 31 May 2022 15:06:45 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 6697D10725 for ; Tue, 31 May 2022 15:06:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009630; 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=NcMjP2UZyjraEEWmDf0vHMrSxegZR+ecBwf0wSau5Pg=; b=EK5ax0hxXTcECCUEeKwwnqbvI07IVkc+78tetqE7RSaMXbn5EWIb+33iCmoXJGpbHMdJV0 mcws/yJbtpzzitLC/eG1PollU4xsTVdWMxscyaaxOLVE+V0hfmGqQdHa2Ua06UxMqM1x49 /pV1ALVELSlaUxlyjUfKKqlab0H+GrQ= X-MC-Unique: 08s6qrxtMvKIY8TllEEv_A-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 02/67] docs: formatdomain: Remove 'elementsMetadata' anchor Date: Tue, 31 May 2022 17:05:37 +0200 Message-Id: <512034adef6cd03cfe4684b25328cc1ca356fbcd.1654008136.git.pkrempa@redhat.com> 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.3 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: 1654009632752100001 Content-Type: text/plain; charset="utf-8" Reworded the local link so that it retains the sense. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index a0e8d69b87..a8d3e559c9 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -24,7 +24,6 @@ domain. The allowed values are driver specific, but inclu= de "xen", "kvm", and "lxc". The second attribute is ``id`` which is a unique integer identi= fier for the running guest machine. Inactive machines have no id value. -:anchor:`` General metadata ---------------- @@ -500,8 +499,8 @@ layout of sub-elements, with supported values of: Serial number ``uuid`` Universal Unique ID number. If this entry is provided alongside a - top-level `uuid <#elementsMetadata>`__ element, then the two valu= es - must match. + top-level ``uuid`` element (see `General metadata`_), then the two + values must match. ``sku`` SKU number to identify a particular configuration. ``family`` --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009667; cv=none; d=zohomail.com; s=zohoarc; b=auxCVNDJ0cFpOKzS9uGbD0DN6WKh2/vJzTqU8gT6pUkFfxghzm46eSCLsJDeGUgyuduCs1+H9BGk2UervodsPJ7ebUm2MjqrIvgX47dVq5OCKP+cpNFRVFuG4z4x1vb6PSMLe/QmWb+3MBqDwpjEYQF2vhmoB439bWyhaOxe6M8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009667; 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=56K6GbedopkTRdQ/tKIQP2g1pwWsWKtbDZhMwn5PNx0=; b=nNNDWNvOqW9W8v8uZJQP4V4DgwutAKrSLBcdw/j0g4C5u527gTtCQTtsxqycN2LnddkOnCjG/hUFIiXLjHMnv6JsZsVh4bhaupQu7F40zE34tQHL5ToFEKEjTjOOLPahHswK71mZJpU2OGmXSZwJl2EKgYxH+W+5IySvk1G0FIA= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009667025811.813631339427; Tue, 31 May 2022 08:07:47 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-325-tLel8M9hPZCH83h4Rjg2uA-1; Tue, 31 May 2022 11:07:29 -0400 Received: from smtp.corp.redhat.com (int-mx10.intmail.prod.int.rdu2.redhat.com [10.11.54.10]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id EE41F38149D6; Tue, 31 May 2022 15:06:48 +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 D6CF640F06B; Tue, 31 May 2022 15:06:48 +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 A190A194707A; Tue, 31 May 2022 15:06:48 +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 E394F1947072 for ; Tue, 31 May 2022 15:06:46 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id C219F10725; Tue, 31 May 2022 15:06:46 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 41F6F8288C for ; Tue, 31 May 2022 15:06:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009666; 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=56K6GbedopkTRdQ/tKIQP2g1pwWsWKtbDZhMwn5PNx0=; b=ZK5fZj3JhMBf7anQ9IDhGVbIopjzkCo4DZyhFAb0l0nwZP7kAvBNvuRr8ltAN4Tsq1olK3 TKUe9hjE4Q2rn/FBLjjlWJOlMZ41Y838UaA7z7nbbkxKcqoPavtlV2YjGZlb7fMUSwhEbH 4wY/uLGidlKGyJh8mNw3UBBf5tcMb7c= X-MC-Unique: tLel8M9hPZCH83h4Rjg2uA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 03/67] docs: formatdomain: Remove 'elementsOS' anchor Date: Tue, 31 May 2022 17:05:38 +0200 Message-Id: <2db941208e7ad1aa8864f411784d36703d2af9a6.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.10 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: 1654009669018100003 Content-Type: text/plain; charset="utf-8" Reworded the paragraph around the local link. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index a8d3e559c9..381d17370e 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -90,7 +90,6 @@ General metadata application needs structure, they should have sub-elements to their nam= espace element). :since:`Since 0.9.10` -:anchor:`` Operating system booting ------------------------ @@ -465,8 +464,8 @@ layout of sub-elements, with supported values of: ``smbios`` Sub-elements call out specific SMBIOS values, which will affect the gue= st if - used in conjunction with the ``smbios`` sub-element of the - `os <#elementsOS>`__ element. Each sub-element of ``sysinfo`` names a S= MBIOS + used in conjunction with the ``smbios`` sub-element of the ``os`` eleme= nt + (see `Operating system booting`_). Each sub-element of ``sysinfo`` name= s a SMBIOS block, and within those elements can be a list of ``entry`` elements th= at describe a field within the block. The following blocks and entries are recognized: --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009664; cv=none; d=zohomail.com; s=zohoarc; b=i5ZJsCeFflDXcQe3TPDq1Q1zh6nS8CQRkBtrlERWvcCifAi6BACW11j9MvRgBkRSXVva8coxWdh+62WsLU97nGcdUjih6kEWYpy0w27U+NO3STJVctKh25GEiHGGaP/XJ/SExJ3GuPoL2sWuaHEuHgKHwSokeRnGT63QIzKM5i0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009664; 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=poHJ4UvOpwKpsJDPwnwwRUNUdLqXRku6iRD9Fx/IS/s=; b=OYkjrHBdxyg+r5x+ivScry4soPOLjvYGGC8EOtCDsrEFfhXmt/+XtLyURYeOdTQSQrJqqppYkO94vxCirMfSQsjPfd3VTQVg8WRezl5rOqndZeWp2dpfRb+Fxx9aGfshTXHM63hsQmqnX1CzK+rU66vpWhihflBizEEzsT9OGtA= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009664967782.7333246410384; Tue, 31 May 2022 08:07:44 -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-501-2V_bDUtiM16yno1DXgpduw-1; Tue, 31 May 2022 11:07:26 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 76E4780D3F0; Tue, 31 May 2022 15:06:49 +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 62F8C1731B; Tue, 31 May 2022 15:06:49 +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 ED4E21947074; Tue, 31 May 2022 15:06:48 +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 B6197194706C for ; Tue, 31 May 2022 15:06:47 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 98D1D1731B; Tue, 31 May 2022 15:06:47 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 2376F1131A for ; Tue, 31 May 2022 15:06:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009664; 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=poHJ4UvOpwKpsJDPwnwwRUNUdLqXRku6iRD9Fx/IS/s=; b=gr6FPBHxAW/9TI4cderIejZhJInr7T/hWeYJkp5Rxwio9qahVtyXvC1lb6EcumxadVsEn8 s6M5S1gVQJ3qbMyFXPoZ5Rb3Q7J4ZNrS7Y9TGLOhFJ32uFawOjb0K3RBKm56Z2wIuTfigD X/0Mz7K2WQhMhgDug448z53YzxpDcRE= X-MC-Unique: 2V_bDUtiM16yno1DXgpduw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 04/67] docs: formatdomain: Remove 'elementsOSBIOS' anchor Date: Tue, 31 May 2022 17:05:39 +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.79 on 10.11.54.5 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: 1654009667040100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 21 ++++++++++----------- docs/formatdomaincaps.rst | 6 +++--- 2 files changed, 13 insertions(+), 14 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 381d17370e..3936a31155 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -97,7 +97,6 @@ Operating system booting There are a number of different ways to boot virtual machines each with th= eir own pros and cons. -:anchor:`` BIOS bootloader ~~~~~~~~~~~~~~~ @@ -332,11 +331,11 @@ and full virtualized guests. ... ``type`` - This element has the same semantics as described earlier in the `BIOS b= oot - section <#elementsOSBIOS>`__ + This element has the same semantics as described earlier in the + `BIOS bootloader`_ section. ``loader`` - This element has the same semantics as described earlier in the `BIOS b= oot - section <#elementsOSBIOS>`__ + This element has the same semantics as described earlier in the + `BIOS bootloader`_ section. ``kernel`` The contents of this element specify the fully-qualified path to the ke= rnel image in the host OS. @@ -3197,7 +3196,7 @@ paravirtualized driver is specified via the ``disk`` = element. attribute is an 8 character string which can be queried by guests on S3= 90 via sclp or diag 308. Linux guests on S390 can use ``loadparm`` to select a= boot entry. :since:`Since 3.5.0` The per-device ``boot`` elements cannot be = used - together with general boot elements in `BIOS bootloader <#elementsOSBIO= S>`__ + together with general boot elements in `BIOS bootloader`_ section. :since:`Since 0.8.8` ``encryption`` Starting with :since:`libvirt 3.9.0` the ``encryption`` element is pref= erred @@ -4240,8 +4239,8 @@ or: ``boot`` Specifies that the device is bootable. The ``order`` attribute determin= es the order in which devices will be tried during boot sequence. The per-devi= ce - ``boot`` elements cannot be used together with general boot elements in= `BIOS - bootloader <#elementsOSBIOS>`__ section. :since:`Since 0.8.8` for PCI + ``boot`` elements cannot be used together with general boot elements in + `BIOS bootloader`_ section. :since:`Since 0.8.8` for PCI devices, :since:`Since 1.0.1` for USB devices. ``rom`` The ``rom`` element is used to change how a PCI device's ROM is present= ed to @@ -4384,8 +4383,8 @@ after 0.9.5 (KVM only)` : ``boot`` Specifies that the device is bootable. The ``order`` attribute determin= es the order in which devices will be tried during boot sequence. The per-devi= ce - ``boot`` elements cannot be used together with general boot elements in= `BIOS - bootloader <#elementsOSBIOS>`__ section. ( :since:`Since 1.0.1` ) + ``boot`` elements cannot be used together with general boot elements in + `BIOS bootloader`_ section. ( :since:`Since 1.0.1` ) ``redirfilter`` The\ ``redirfilter``\ element is used for creating the filter rule to f= ilter out certain devices from redirection. It uses sub-element ```` = to @@ -5415,7 +5414,7 @@ Specifying boot order For hypervisors which support this, you can set a specific NIC to be used = for network boot. The ``order`` attribute determines the order in which device= s will be tried during boot sequence. The per-device ``boot`` elements cannot be = used -together with general boot elements in `BIOS bootloader <#elementsOSBIOS>`= __ +together with general boot elements in `BIOS bootloader`_ section. :since:`Since 0.8.8` Interface ROM BIOS configuration diff --git a/docs/formatdomaincaps.rst b/docs/formatdomaincaps.rst index 55209e53c2..41a0b78959 100644 --- a/docs/formatdomaincaps.rst +++ b/docs/formatdomaincaps.rst @@ -71,11 +71,11 @@ The root element that emulator capability XML document = starts with has name Describes the `virtualization type `__ (or so called domain type). ``machine`` - The domain's `machine type `__. Since= not + The domain's `machine type `__. Sinc= e not every hypervisor has a sense of machine types this element might be omi= tted in such drivers. ``arch`` - The domain's `architecture `__. + The domain's `architecture `__. CPU Allocation ~~~~~~~~~~~~~~ @@ -98,7 +98,7 @@ BIOS bootloader ~~~~~~~~~~~~~~~ Sometimes users might want to tweak some BIOS knobs or use UEFI. For cases= like -that, `os `__ element exposes what value= s can +that, `os `__ element exposes what valu= es can be passed to its children. :: --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009673; cv=none; d=zohomail.com; s=zohoarc; b=XxToDjIqYSi8q1E4G8kE4hMv41x/hlL8qYwdrqzeUgzXUIA+td+Xn8U5Bsu4IyfIJjxKl23UNcv4aOUJ9UPOefi5oFRZhcuWDOSOxN3QTDvM9zkEnJUDRWNtnECASLwYtZfaSGlchG9MNUHjPBu4Rur64wpSWudfatRJAZ7SLmM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009673; 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=IwPTLMLOjBANFtDJfGXoEIUY+cpXzgkM4MtUZbpt/Xo=; b=jbGI3Udl0fitSomwoTiBv44vL2fPy2Jzt6NNtzbpst0pdt+yvf5amsf2t6WYeNUr7pWg+AjB/liQZwoNthoC8arlPNEVxy2xjkQKzrt1HBpJzhC0QfaXLmSfMK/Y3xMOB5Uqz4QsxuhC6Wg8Nexyy3n5eb/8PUr1ORCsv5IvTbk= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009673688473.6988430787328; Tue, 31 May 2022 08:07:53 -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-479-Yqt_qWLgOCGLyJc9fZOK3w-1; Tue, 31 May 2022 11:07:21 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id C2B5481B90E; Tue, 31 May 2022 15:06:49 +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 AE8BB40CFD0B; Tue, 31 May 2022 15:06:49 +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 815F61947071; Tue, 31 May 2022 15:06:49 +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 9595B1947073 for ; Tue, 31 May 2022 15:06:48 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 6F6C21131A; Tue, 31 May 2022 15:06:48 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id E62B582882 for ; Tue, 31 May 2022 15:06:47 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009672; 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=IwPTLMLOjBANFtDJfGXoEIUY+cpXzgkM4MtUZbpt/Xo=; b=d5C3l6tTb11/k1JmWK3CM45z8XSjYz2I3j8v6wl1SZlgJJSL04lqgL2qWAFrW6A/IOiq05 S7lrQKuMBNVyDAjMoK3IT0+RVAeP+3sygpEkAqTCJ8HyWJGynFo9LQuYuJ/wIZVhxXvx4x yeC0X/8iuJ2tkZR/Bu22Erx5g4P7aAE= X-MC-Unique: Yqt_qWLgOCGLyJc9fZOK3w-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 05/67] docs: formatdomain: Remove 'elementsOSContainer' anchor Date: Tue, 31 May 2022 17:05:40 +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.84 on 10.11.54.1 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: 1654009675063100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/drvlxc.rst | 2 +- docs/formatdomain.rst | 1 - 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/drvlxc.rst b/docs/drvlxc.rst index 24501cae11..8a346907fb 100644 --- a/docs/drvlxc.rst +++ b/docs/drvlxc.rst @@ -37,7 +37,7 @@ In order to separate processes inside a container from th= ose in the primary namespaces are compiled in. Libvirt currently requires the 'mount', 'ipc', 'pid', and 'uts' namespaces to be available. If separate network interface= s are desired, then the 'net' namespace is required. If the guest configuration -declares a `UID or GID mapping `__,= the +declares a `UID or GID mapping `__, the 'user' namespace will be enabled to apply these. **A suitably configured U= ID/GID mapping is a pre-requisite to making containers secure, in the absence of = sVirt confinement.** diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 3936a31155..1346c1ce01 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -355,7 +355,6 @@ and full virtualized guests. ``type`` attribute contains the ACPI table type (currently only ``slic`= ` is supported) :since:`Since 1.3.5 (QEMU)` :since:`Since 5.9.0 (Xen)` -:anchor:`` Container boot ~~~~~~~~~~~~~~ --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009695; cv=none; d=zohomail.com; s=zohoarc; b=Pee/GUO8qSS2i3n7AGK8SO/Eiz/7pQmZjvw8xfB6+IhprOm/ghuaJOlrG6MBTThGWUz9+mW5WVTQxazXbgi9H0dluJcLVx1ecIExI0rOsU/39BgUEzWEbFiyMB6rmKkpKCjCXeRny4PWO4OJFT3M1OLeLz/HTxpIlTGj7/81e7g= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009695; 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=oBxjChbyA+wRkTrHheXmPgP31yx8rojYlWD9alABNwQ=; b=f2HLQOERjsQAnZQ+7z0zRfnSYjhkKVcsjyZcmj2Np1/9Xu5RcsnxsMbZRmKxhqasX9EHF1v6YMdPeUrBfDghyb1lupcpj4uN2NNOzd83n/QFbnuJhX1DzrW+OqL121J1BzGWYtTKlU/fpA2Fhpmprdq8J1p/n0TK++zyKI/eckM= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009695175995.7462404330929; Tue, 31 May 2022 08:08:15 -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-413-oEufPv1yPDC4AGz540NcWg-1; Tue, 31 May 2022 11:07:52 -0400 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 0254E80419F; Tue, 31 May 2022 15:06:53 +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 E43C1C15E72; Tue, 31 May 2022 15:06:52 +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 C55271947064; Tue, 31 May 2022 15:06:52 +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 699A6194706A for ; Tue, 31 May 2022 15:06:49 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 457C01131A; Tue, 31 May 2022 15:06:49 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id C44765F245 for ; Tue, 31 May 2022 15:06:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009694; 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=oBxjChbyA+wRkTrHheXmPgP31yx8rojYlWD9alABNwQ=; b=AIzA2Rs5DiEtfWb8ZiYdntekOG++lL+WHPZTLv7r6Cc0r8Zn9IkQKjGgQU0BkG1J5+MMZY tUQNVBLWfp0Tf0a0f5r2iR0TlDqgCF7rzuVO+ZrXsgr1p7+ey4KzBLRabxl7ruCYMIvbEr LFfe7mckegPOPm7Q19yWPmIXA8AQCOU= X-MC-Unique: oEufPv1yPDC4AGz540NcWg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 06/67] docs: formatdomain: Remove 'elementsSysinfo' anchor Date: Tue, 31 May 2022 17:05:41 +0200 Message-Id: <2694c797a2448762b2cde8752f1187db95054a98.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.8 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: 1654009697234100006 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 1346c1ce01..f0bc9f6995 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -53,7 +53,7 @@ General metadata the virtual machine. The format must be RFC 4122 compliant, eg ``3e3fce45-4f53-4fa7-bb32-11f34168b82b``. If omitted when defining/crea= ting a new machine, a random UUID is generated. It is also possible to provide= the - UUID via a `sysinfo <#elementsSysinfo>`__ specification. :since:`Since = 0.0.1, + UUID via a `SMBIOS System Information`_ specification. :since:`Since 0.= 0.1, sysinfo since 0.8.7` ``genid`` :since:`Since 4.4.0` , the ``genid`` element can be used to add a Virtu= al @@ -251,7 +251,7 @@ harddisk, cdrom, network) determining where to obtain/f= ind the boot image. UUID, from the host's SMBIOS values; the `virConnectGetSysinfo `__ call can be used to see what values are copied), or "sysinfo" (use the = values - in the `sysinfo <#elementsSysinfo>`__ element). If not specified, the + in the `SMBIOS System Information`_ element). If not specified, the hypervisor default is used. :since:`Since 0.8.7` Up till here the BIOS/UEFI configuration knobs are generic enough to be @@ -407,7 +407,6 @@ If you want to enable user namespace, set the ``idmap``= element. The ``uid`` and -:anchor:`` SMBIOS System Information ------------------------- --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 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=1654009738; cv=none; d=zohomail.com; s=zohoarc; b=ICVgBHQ5vo6058VmPCYHo8sVxIhGhfRuFFRgCpWbc+SjVDSIvfWMFxqpPjFSnJUJO0yGJkU2kFnBM8pFYnDaR8WtReE9ik3kRnbaxKQljc/NUlhKgW8Lw0g7DQeJBhl4YguorDaTjXiGAm2a+jFA1Kt8nD22+JQEjGSi/0zwqWg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009738; 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=JHOHgCo3OZEEdrzjtGRYGDIZrm+ioLkneaSObGr2dSU=; b=fT9BTlOAbLVxsBfJeaUgPxpGjKo4/j8xoifNTX7erkGUyDuSqM42eBr4tp9hQiMFWtNPlrM0j7s7rp6n/qLsD//fjFRU21Xtf66eXni7Sb11nyBTOk13GlJcGC6nCQLHcFI8HI1I2CZfa4C4+WWa+W7VSsnzmB8gdPxePzzgqCo= 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 16540097388291018.9759586500138; Tue, 31 May 2022 08:08:58 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-164-7d1tA46LOqG8q0Q6spfjuQ-1; Tue, 31 May 2022 11:08:31 -0400 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.rdu2.redhat.com [10.11.54.7]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 8C0553816859; Tue, 31 May 2022 15:06:53 +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 787AE1415100; Tue, 31 May 2022 15:06:53 +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 18A03194706D; Tue, 31 May 2022 15:06:53 +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 3F4AD1947065 for ; Tue, 31 May 2022 15:06:50 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 208DB10725; Tue, 31 May 2022 15:06:50 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 92D005F245 for ; Tue, 31 May 2022 15:06:49 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009737; 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=JHOHgCo3OZEEdrzjtGRYGDIZrm+ioLkneaSObGr2dSU=; b=FuEmhqfqnkNTmvyvI0u0GO6DbP6A5+/zWTGnU5gVGnagjKVLU8PSP7xqAKY4/kiogm8CyY 7g2ZVjlj76Do+jiiaSsuz5Luiu3ORRUj7EadXjwBfA9YSbngHGdKjalxF1ox/tOdA0BuBa 2HSPgIl5jIYjhUQ60apzyx7EhzexcK4= X-MC-Unique: 7d1tA46LOqG8q0Q6spfjuQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 07/67] docs: formatdomain: Remove 'elementsCPUAllocation' anchor Date: Tue, 31 May 2022 17:05:42 +0200 Message-Id: <33a32772d5ff34b8254ab24779360df301c49748.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.7 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: 1654009739469100002 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - docs/kbase/kvm-realtime.rst | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index f0bc9f6995..564ebbfd69 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -576,7 +576,6 @@ layout of sub-elements, with supported values of: the value (to set the blob value directly), or ``file`` attribute (to s= et the blob value from the file). -:anchor:`` CPU Allocation -------------- diff --git a/docs/kbase/kvm-realtime.rst b/docs/kbase/kvm-realtime.rst index 476e581a2a..f523858143 100644 --- a/docs/kbase/kvm-realtime.rst +++ b/docs/kbase/kvm-realtime.rst @@ -128,7 +128,7 @@ host core that is in the `isolcpus` reserved set. The Q= EMU emulator threads need to be pinned to host CPUs that are not in the `isolcpus` reserved set. The vCPUs need to be given a real time CPU scheduler policy. -When configuring the `guest CPU count <../formatdomain.html#elementsCPUAll= ocation>`_, +When configuring the `guest CPU count <../formatdomain.html#cpu-allocation= >`_, do not include any CPU affinity at this stage: :: --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 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=1654009673; cv=none; d=zohomail.com; s=zohoarc; b=bw1R6vq1snjbHb/cnU9yepMomdJC4T9VooIupFSOmB4mowfgNPxW+W4sfFpLgQv+Fpzq+FoC/4/3bgV3XlWTcr8Qx3d6GrZj9r+nRM6x5wkXoUYs0jYmcsmc1so+3ZdiWq7i0/u5eHjyZOv0XrEQKWbzzfRBG/MGz622nCGs60c= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009673; 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=ST88pIWnvLDOk6hZIT6SWsY/CMDHktyUhdCTt/GnSEQ=; b=a1qxwu1TsTpo4KEjDW3r1b1yyehk+jwgCmGvEsp3sPR+rSW1xfTcvLp0L6cwOSaEzbwBYQMgsZpOlcdgD020WrxwELV/6PDhWaYVXPfvLNqAlPKle5zGSsaxHGP3L2s48RpWyHtdC/bXE3GPDYn4AQGWinpUyCwaZLNsvwoKMNQ= 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 1654009673079308.87259086536915; Tue, 31 May 2022 08:07:53 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-534-L3-3Xa7iPCObKYEBcwb-Fw-1; Tue, 31 May 2022 11:07:44 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 96DFB3C1905F; Tue, 31 May 2022 15:06:54 +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 729B440CFD0A; Tue, 31 May 2022 15:06:54 +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 156861947072; Tue, 31 May 2022 15:06:54 +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 03926194705C for ; Tue, 31 May 2022 15:06:51 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id EB8C61131A; Tue, 31 May 2022 15:06:50 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 775CC10725 for ; Tue, 31 May 2022 15:06:50 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009672; 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=ST88pIWnvLDOk6hZIT6SWsY/CMDHktyUhdCTt/GnSEQ=; b=Va050JIuJjmBj5kJ1iBjK6qqMHZw7hw47UiXtzZVzcCahjSApClwNX6PtlIVyQbvIVdQha IgzR+L577ma3FnkOLG5qZ9VLSKkR9an7n5V5Quqb5wvrU5bw6bvrTSQpudSYJJso0QWyAb vPyJ3deNeBg5+Ft+0aK2ioimIFMG9y4= X-MC-Unique: L3-3Xa7iPCObKYEBcwb-Fw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 08/67] docs: formatdomain: Remove 'elementsIOThreadsAllocation' anchor Date: Tue, 31 May 2022 17:05:43 +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.84 on 10.11.54.1 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: 1654009675083100002 Content-Type: text/plain; charset="utf-8" Reworded documentation around local links. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 18 ++++++++---------- docs/formatdomaincaps.rst | 2 +- 2 files changed, 9 insertions(+), 11 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 564ebbfd69..835dff3596 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -653,7 +653,6 @@ CPU Allocation same core need to be enabled as well. All non-hotpluggable CPUs present= at boot need to be grouped after vCPU 0. :since:`Since 2.2.0 (QEMU only)` -:anchor:`` IOThreads Allocation -------------------- @@ -775,9 +774,8 @@ CPU Tuning of element ``vcpu`` is not specified, the IOThreads are pinned to all t= he physical CPUs by default. There are two required attributes, the attrib= ute ``iothread`` specifies the IOThread ID and the attribute ``cpuset`` - specifying which physical CPUs to pin to. See the ``iothreadids`` - `description <#elementsIOThreadsAllocation>`__ for valid ``iothread`` v= alues. - :since:`Since 1.2.9` + specifying which physical CPUs to pin to. See the `IOThreads Allocation= `_ + section documenting valid values of ``iothread``. :since:`Since 1.2.9` ``shares`` The optional ``shares`` element specifies the proportional weighted sha= re for the domain. If this is omitted, it defaults to the OS provided defaults= . NB, @@ -851,8 +849,8 @@ CPU Tuning vCPUs/IOThreads this setting applies to, leaving them out sets the defa= ult. The element ``emulatorsched`` does not have that attribute. Valid ``vcp= us`` values start at 0 through one less than the number of vCPU's defined fo= r the - domain. Valid ``iothreads`` values are described in the ``iothreadids`` - `description <#elementsIOThreadsAllocation>`__. If no ``iothreadids`` a= re + domain. Valid ``iothreads`` values are described in the `IOThreads Allo= cation`_ + section. If no ``iothreadids`` are defined, then libvirt numbers IOThreads from 1 to the number of ``iothr= eads`` available for the domain. For real-time schedulers (``fifo``, ``rr``), priority must be specified as well (and is ignored for non-real-time on= es). @@ -3131,8 +3129,8 @@ paravirtualized driver is specified via the ``disk`` = element. intensive operation, but can save file space and/or time on slow med= ia. :since:`Since 2.0.0` - The optional ``iothread`` attribute assigns the disk to an IOThread = as - defined by the range for the domain - `iothreads <#elementsIOThreadsAllocation>`__ value. Multiple disks m= ay be + defined by the range for the domain ``iothreads`` value. (See + `IOThreads Allocation`_). Multiple disks may be assigned to the same IOThread and are numbered from 1 to the domain iothreads value. Available for a disk device ``target`` configured t= o use "virtio" ``bus`` and "pci" or "ccw" ``address`` types. :since:`Since= 1.2.8 @@ -3754,8 +3752,8 @@ An optional sub-element ``driver`` can specify the dr= iver specific options: Supported for controller type ``scsi`` using model ``virtio-scsi`` for ``address`` types ``pci`` and ``ccw`` :since:`since 1.3.5 (QEMU 2.4)` .= The optional ``iothread`` attribute assigns the controller to an IOThread as - defined by the range for the domain - `iothreads <#elementsIOThreadsAllocation>`__ value. Each SCSI ``disk`` + defined by the range for the domain ``iothreads`` (See `IOThreads Alloc= ation`_). + Each SCSI ``disk`` assigned to use the specified ``controller`` will utilize the same IOTh= read. If a specific IOThread is desired for a specific SCSI ``disk``, then mu= ltiple controllers must be defined each having a specific ``iothread`` value. = The diff --git a/docs/formatdomaincaps.rst b/docs/formatdomaincaps.rst index 41a0b78959..9ca7cdcc7c 100644 --- a/docs/formatdomaincaps.rst +++ b/docs/formatdomaincaps.rst @@ -232,7 +232,7 @@ I/O Threads ~~~~~~~~~~~ The ``iothread`` elements indicates whether or not `I/O -threads `__ are supported. +threads `__ are supported. :: --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 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=1654009746; cv=none; d=zohomail.com; s=zohoarc; b=WybN/gYuHlWrW6A+ypDFGo92A/JMbp6i0+lTT2Ony/JGgJKaIX5zgrvu7SCYhvbs70L/YcCpPCNUugX34LmP9I8A+qCzKfT4J6IFcIf2nAIdwerfRtR3udkuKUykjmaJD04STOfPWTLHx7DeegjMNlNwJBEpakKcGwvLG2gAmZ4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009746; 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=z3bTOjFCRkArhoydvO7xmPQt1eGZ86v+E7FDm2vxV4c=; b=hPu/vo2gGDjU9LSvboULAuiy7DelIwdFrq0uZfMPDH5dcV5efMNZG8hXUww/IaaiuLH73KmCU+GcjP/9dffjut7vae1iaCiZCkBvag0wu4+hzti5JhDzAZxJqxstX0DS4hetYPIgLG9PhNjiZB5bfMCQ90kPxlpONUvlRrvFnyQ= 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 1654009746081639.5333322433239; Tue, 31 May 2022 08:09:06 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-601-aVkoYCD3MCKDIJ6UvIXxUg-1; Tue, 31 May 2022 11:07:51 -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 EF3742806948; Tue, 31 May 2022 15:06:53 +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 D90262026D64; Tue, 31 May 2022 15:06:53 +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 5AD72194707B; Tue, 31 May 2022 15:06:53 +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 CB2191947064 for ; Tue, 31 May 2022 15:06:51 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id BF7E81731B; Tue, 31 May 2022 15:06:51 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 423A010725 for ; Tue, 31 May 2022 15:06:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009745; 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=z3bTOjFCRkArhoydvO7xmPQt1eGZ86v+E7FDm2vxV4c=; b=L+Ne8RIFTglLV9NwBH1550zb9yOB2MEgAle1yhCqeWXXfeQEFw6KD64ctil4RbsQSZ/s5/ 4pnbxgkNja7m9JcJBSJ8WDUIu/I10TZ63PNOBHfiPNkaS+EtOFgHuKc0lnij/Yt3N2BROZ p3cg0oc1CIZC9nJ1q/VLplC/u8ILYEc= X-MC-Unique: aVkoYCD3MCKDIJ6UvIXxUg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 09/67] docs: formatdomain: Remove 'elementsCPUTuning' anchor Date: Tue, 31 May 2022 17:05:44 +0200 Message-Id: <5c44309ec030e4995582cf64821c223cdfc8e13a.1654008136.git.pkrempa@redhat.com> 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: 1654009747524100008 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - docs/kbase/kvm-realtime.rst | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 835dff3596..27e1e496e9 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -699,7 +699,6 @@ host/guest with many LUNs. :since:`Since 1.2.8 (QEMU on= ly)` ``iothreads`` defined for the domain, then the ``iothreads`` value will= be adjusted accordingly. :since:`Since 1.2.15` -:anchor:`` CPU Tuning ---------- diff --git a/docs/kbase/kvm-realtime.rst b/docs/kbase/kvm-realtime.rst index f523858143..288295b4c7 100644 --- a/docs/kbase/kvm-realtime.rst +++ b/docs/kbase/kvm-realtime.rst @@ -137,7 +137,7 @@ do not include any CPU affinity at this stage: The guest CPUs now need to be placed individually. In this case, they will= all be put within the same host socket, such that they can be exposed as core -siblings. This is achieved using the `CPU tuning config <../formatdomain.h= tml#elementsCPUTuning>`_: +siblings. This is achieved using the `CPU tuning config <../formatdomain.h= tml#cpu-tuning>`_: :: --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009691; cv=none; d=zohomail.com; s=zohoarc; b=HOaSR1Xuau0hIoM6IicHeWAMZbzqL5AB1AgBY37NjfkAEpPcWNJigbOISeLSV2jpobCrzA4N+NXeD20ywf6NqfwIwPhD3U6SUlj/RnuBTgQA9/KQ56q7wGUSZ9okT6yC8ADlYK0hFDDDYFHfT4hGRpWD7zP4dXkbEcGSF8bd1Lo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009691; 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=KvMbojwPdp/ZefS9jN/bsgmNLQi3wjjUZqtc9Sbh/MI=; b=Nsmq7U4V5TQysU1Kebz3HhkYbdfCcm2iW9HNSAPfy9+10itAYeXJ1icagK2BPXrP3UMrFYZjE1Dq+/UxZ/zeIevtB/c1Fl99zTYRpN8Gk26235Ah81iXO/bJ72w+iE6vPb78hApj2f3AD0noVsr6rETk7L3QGH9pTafLi2gaKhc= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009691063567.0032872119768; Tue, 31 May 2022 08:08:11 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-65-sCDkHSQuNeqxGZiSlyQY-A-1; Tue, 31 May 2022 11:07:53 -0400 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.rdu2.redhat.com [10.11.54.7]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 190821C00152; Tue, 31 May 2022 15:06:55 +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 071091400AFB; Tue, 31 May 2022 15:06:55 +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 CBE321947062; Tue, 31 May 2022 15:06:54 +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 D2ACD194706A for ; Tue, 31 May 2022 15:06:52 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 9A2241731B; Tue, 31 May 2022 15:06:52 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 2028E10725 for ; Tue, 31 May 2022 15:06:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009689; 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=KvMbojwPdp/ZefS9jN/bsgmNLQi3wjjUZqtc9Sbh/MI=; b=W6JY786HSjfldcR5bW6xpy7RUYwZG+ZuZ9AqpX1+2t0BqRvzUwRC6bxqPL3zf9IHn/yzyV hGOo9ZlnBMmGgPclA/J9XACYWbxCLUGKPatK+oxROzGF4N7PkfMWFWXeubmGW8UZ2yPC/G xmL6xfoUhZFQGFSWbb/HUIZbhJPlMXU= X-MC-Unique: sCDkHSQuNeqxGZiSlyQY-A-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 10/67] docs: formatdomain: Remove 'elementsMemoryAllocation' anchor Date: Tue, 31 May 2022 17:05:45 +0200 Message-Id: <400722df3c0bed9a5a0b1895507b36cbe929fb96.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.7 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: 1654009693224100001 Content-Type: text/plain; charset="utf-8" Reworded documentation around local links. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 27e1e496e9..8e18151796 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -885,8 +885,7 @@ CPU Tuning but the ``unit`` attribute can be used to scale the value. ``unit`` (optional) If specified it is the unit such as KiB, MiB, GiB, or TiB (descri= bed in - the ``memory`` element for `Memory - Allocation <#elementsMemoryAllocation>`__) in which ``size`` is + the ``memory`` element for `Memory Allocation`_) in which ``size`= ` is specified, defaults to bytes. ``monitor`` :since:`Since 4.10.0` @@ -921,7 +920,6 @@ CPU Tuning The memory bandwidth to allocate from this node. The value by def= ault is in percentage. -:anchor:`` Memory Allocation ----------------- @@ -1565,8 +1563,8 @@ maximum virtual CPUs number declared in ``vcpus``, to= make the domain consistent across qemu and libvirt versions. ``memory`` specifies the node memory in kibibytes (i.e. blocks of 1024 bytes). :since:`Since 6.6.0` the ``cpus`` attribute is optional and if omitted a CPU-less NUMA node is created. -:since:`Since 1.2.11` one can use an additional -`unit <#elementsMemoryAllocation>`__ attribute to define units in which +:since:`Since 1.2.11` one can use an additional ``unit`` attribute +(See `Memory Allocation`_) to define units in which ``memory`` is specified. :since:`Since 1.2.7` all cells should have ``id`` attribute in case referring to some cell is necessary in the code, otherwi= se the cells are assigned ``id``\ s in the increasing order starting from 0. Mixi= ng @@ -2034,7 +2032,7 @@ are: as 48 MiB of unavailable RAM might be too much for small guests (e.g. w= ith 512 MiB of RAM). - See `Memory Allocation <#elementsMemoryAllocation>`__ for more details = about + See `Memory Allocation`_ for more details about the ``unit`` attribute. :since:`Since 4.5.0` (QEMU only) ``ioapic`` @@ -7981,8 +7979,8 @@ Example: usage of the memory devices ``label`` For NVDIMM type devices one can use ``label`` and its subelement ``s= ize`` to configure the size of namespaces label storage within the NVDIMM - module. The ``size`` element has usual meaning described - `here <#elementsMemoryAllocation>`__. ``label`` is mandatory for pSe= ries + module. The ``size`` element has usual meaning described in the + `Memory Allocation`_ section. ``label`` is mandatory for pSeries guests and optional for all other architectures. For QEMU domains the following restrictions apply: --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 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=1654009687; cv=none; d=zohomail.com; s=zohoarc; b=P3EJH/MNPenewjLY4T/YObKpZO5MlrgiVrJb9ioOkkUQHGqeqxZlbiDHTsx69Ifbw8xKYOHCahgihZZlzD12+1jbROGjbO+1/KhU8Ix4ro5WhwI1Q9mo0CwecIihJD4JYCQaxoCECpOYZ1cTXcEUxCMyF+yrg7yCAcJHO9wjukY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009687; 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=6VcHACP+Jz2by/iz7FKqwwcEQcQCri6SjG0EzQcvvjw=; b=gS+qDLqr5xg/xyEAEZF3K9dyX3OQJjECPmMJukSEahsd0LsHS93VApVMXtwGfA9GkOXvTYWaESNYTXk8/9fJKhTomUhnLHEIl49HIY7ltocD4eIs2efCjjbsPP5AfVbuUW5hiWG65Jyaoex51ywyHsNH9a+PcYcZLywFS6oHkCU= 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 1654009687955301.3452787496673; Tue, 31 May 2022 08:08:07 -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-424-OB518HlUPx-CjIwuv4FM7Q-1; Tue, 31 May 2022 11:07:42 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id E536180C8FF; Tue, 31 May 2022 15:06:55 +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 CE13C1731B; Tue, 31 May 2022 15:06:55 +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 554F6194706C; Tue, 31 May 2022 15:06:55 +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 8050419451F1 for ; Tue, 31 May 2022 15:06:53 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 70FCA1731B; Tue, 31 May 2022 15:06:53 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id EF48C82886 for ; Tue, 31 May 2022 15:06:52 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009686; 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=6VcHACP+Jz2by/iz7FKqwwcEQcQCri6SjG0EzQcvvjw=; b=Wo+ZXnAE3w3czFjAmCP5ZltUFoDJGk6SIXJ59BhLRYLuvjDQK2ZdQev0g/qZAyvi1gKFWH fKIkctis874Ltdl6a4N18fPkcTrtWaV6rkqDYlit17J3uV1U31IYd+OjiHLr3OmeAJEdUc 1kVQADxHXQrrFmh0oEZeMjKzKpv+DyY= X-MC-Unique: OB518HlUPx-CjIwuv4FM7Q-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 11/67] docs: formatdomain: Remove 'elementsMemoryBacking' anchor Date: Tue, 31 May 2022 17:05:46 +0200 Message-Id: <6531bc8ab8bf8ab58657abbe7dd769044fa38cdb.1654008136.git.pkrempa@redhat.com> 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.79 on 10.11.54.5 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: 1654009689366100001 Content-Type: text/plain; charset="utf-8" Reworded documentation around one of the local links. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 16 +++++++--------- docs/kbase/kvm-realtime.rst | 2 +- 2 files changed, 8 insertions(+), 10 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 8e18151796..fbebff8650 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -970,7 +970,6 @@ Memory Allocation fly. If this is omitted, it defaults to the same value as the ``memory`` element. The ``unit`` attribute behaves the same as for ``memory``. -:anchor:`` Memory Backing -------------- @@ -1083,7 +1082,7 @@ Memory Tuning killed by the kernel if the guess is too low, and determining the memory needed for a process to run is an `undecidable problem `__; that sa= id, if - you already set ``locked`` in `memory backing <#elementsMemoryBacking>`= __ + you already set ``locked`` in `Memory Backing`_ because your workload demands it, you'll have to take into account the specifics of your deployment and figure out a value for ``hard_limit`` = that is large enough to support the memory requirements of your guest, but s= mall @@ -1573,8 +1572,8 @@ in unwanted behaviour. :since:`Since 1.2.9` the optio= nal attribute ``memAccess`` can control whether the memory is to be mapped as "shared" or "private". T= his is valid only for hugepages-backed memory and nvdimm modules. Each ``cell`` e= lement can have an optional ``discard`` attribute which fine tunes the discard fe= ature -for given numa node as described under `Memory -Backing <#elementsMemoryBacking>`__. Accepted values are ``yes`` and ``no`= `. +for given numa node as described under `Memory Backing`_. +Accepted values are ``yes`` and ``no``. :since:`Since 4.4.0` This guest NUMA specification is currently available only for QEMU/KVM and= Xen. @@ -2715,7 +2714,7 @@ paravirtualized driver is specified via the ``disk`` = element. ``vhostuser`` Enables the hypervisor to connect to another process using vhost-user protocol. Requires shared memory configured for the VM, for more det= ails - see ``access`` mode for `memoryBacking <#elementsMemoryBacking>`__ e= lement. + see ``access`` mode for ``memoryBacking`` element (See `Memory Backi= ng`_). The ``source`` element has following mandatory attributes: @@ -7907,7 +7906,7 @@ Example: usage of the memory devices ``access`` An optional attribute ``access`` ( :since:`since 3.2.0` ) that provides capability to fine tune mapping of the memory on per module basis. Valu= es are - the same as `Memory Backing <#elementsMemoryBacking>`__: ``shared`` and + the same as `Memory Backing`_: ``shared`` and ``private``. For ``nvdimm`` model, if using real NVDIMM DAX device as backend, ``shared`` is required. For ``virtio-pmem`` model ``shared`` is required. @@ -7915,9 +7914,8 @@ Example: usage of the memory devices ``discard`` An optional attribute ``discard`` ( :since:`since 4.4.0` ) that provides capability to fine tune discard of data on per module basis. Accepted v= alues - are ``yes`` and ``no``. The feature is described here: `Memory - Backing <#elementsMemoryBacking>`__. This attribute is allowed only for - ``model=3D'dimm'``. + are ``yes`` and ``no``. The feature is described here: `Memory Backing`= _. + This attribute is allowed only for ``model=3D'dimm'``. ``uuid`` For pSeries guests, an uuid can be set to identify the nvdimm module. If diff --git a/docs/kbase/kvm-realtime.rst b/docs/kbase/kvm-realtime.rst index 288295b4c7..9b38aff0fd 100644 --- a/docs/kbase/kvm-realtime.rst +++ b/docs/kbase/kvm-realtime.rst @@ -178,7 +178,7 @@ Memory configuration The host memory used for guest RAM needs to be allocated from huge pages o= n the second NUMA node, and all other memory allocation needs to be locked into = RAM with memory page sharing disabled. -This is achieved by using the `memory backing config `_: +This is achieved by using the `memory backing config `_: :: --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 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=1654009724; cv=none; d=zohomail.com; s=zohoarc; b=NKQz9+4npOBlNp+0U6A8QL0P1478/Wdcp2V43gpwNaQs/s+XlaLQqaxU6HzgFN76JCevRSF6K9+suDRzWP0QYGdwaJVydVNe2su5b+97vi7fnboV1uBWWnP6uKykN2SuCWCpnnvekAC8hiMKwMJtk/w0EZR75q7GCjMGRYFeXaw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009724; 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=hVsyDELf48lmg7OScxnWK9kle5Ub/9GY/cLYS9JoZzg=; b=f1XUdkgzOUdJZIJBCBJXEzpCFkrnjxIE2Vwfk+lKeBqSTbrF0yhoOE1aTGBAvFT6Qgiyc2wZSr6rM1BQyXvagnaYTgXv0m2vgnXCYLHGO+x+RVtyclbDju+zioNct+UC+RQL+Db+Tku3S4ayJ52T5MStxA6CepjOO5bV+1S/RJo= 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 165400972442467.44498769062159; Tue, 31 May 2022 08:08:44 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-665-gS92HiccN4apRpuqTWMdvQ-1; Tue, 31 May 2022 11:08:14 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id AC81C1C0CE88; Tue, 31 May 2022 15:06:56 +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 98A36400E89B; Tue, 31 May 2022 15:06:56 +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 590771947072; Tue, 31 May 2022 15:06:56 +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 573E1194707C for ; Tue, 31 May 2022 15:06:54 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 4A6838287E; Tue, 31 May 2022 15:06:54 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id BC41F10725 for ; Tue, 31 May 2022 15:06:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009723; 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=hVsyDELf48lmg7OScxnWK9kle5Ub/9GY/cLYS9JoZzg=; b=HS3G9/pxq/lhChVBeVDbaPLk90Fl2suVCgg0GTuZmVBx+2CWhuoE00csvpwKK/FQVQHH+j VAvR0Xv8hHXFdVhbGnAvkO+LRAttfH53dVuLEXRiKE3rRAPCoP5/hKLFTn2P+dHtUXhQrG 9OwDqhoud43fPH5d+0GLcIMgORI9lDk= X-MC-Unique: gS92HiccN4apRpuqTWMdvQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 12/67] docs: formatdomain: Remove 'elementsMemoryTuning' anchor Date: Tue, 31 May 2022 17:05:47 +0200 Message-Id: <0760d1147e9d72143fa42ef441c02940574a3375.1654008136.git.pkrempa@redhat.com> 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.84 on 10.11.54.1 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: 1654009725437100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index fbebff8650..5cf31d9e06 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -1025,7 +1025,7 @@ influence how virtual memory pages are backed by host= pages. amounts of locked memory could cause a denial-of-service attack on the = host. Because of this, using this option is discouraged unless your workload demands it; even then, it's highly recommended to set a ``hard_limit`` = (see - `memory tuning <#elementsMemoryTuning>`__) on memory allocation suitabl= e for + `Memory Tuning`_) on memory allocation suitable for the specific environment at the same time to mitigate the risks describ= ed above. :since:`Since 1.0.6` ``source`` @@ -1046,7 +1046,6 @@ influence how virtual memory pages are backed by host= pages. this is just an optimization and is not guaranteed to work in all cases= (e.g. when hypervisor crashes). :since:`Since 4.4.0` (QEMU/KVM only) -:anchor:`` Memory Tuning ------------- --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009768; cv=none; d=zohomail.com; s=zohoarc; b=RAU3FrXqSbfj79wuAaK7IKMPBPqf68/w04GQEGoBmI/D9cgA5sDO97QYzwbbNlq5MX5vd22NqjxEEudYsMQcheKXZEWQ08g0gJGaILOjqxcHFLmw71fJ945it62GlpGPSWVxs2sE/m2wt04kX7Z1xB3kr9KM7lSPeDTZVcBMX8Y= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009768; 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=U65cqfGSgsLIHouqJaUoAgeGhqdurPhqgNoAn59i3g4=; b=VaVzxkVhOlgKLNeSz3eRQxUC4KrspLOs5PXQLW4ygL5Q2Izib52ymYaXNk0Ns5NQ0Pv0iLBzmxtv0uXEDxZceWmwibwumbKY4A4JTeY4u/6szG2JxtIAd3Be6YESM81vLMF7ZXeLGwTSBOI65T5tOpZMKepMI2Ug3rUL+sAU3a4= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009768584387.7763067878409; Tue, 31 May 2022 08:09:28 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-441-h4u6X8myMg6uFM-pKwu3uw-1; Tue, 31 May 2022 11:08:08 -0400 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 41EE93C222D1; Tue, 31 May 2022 15:06:59 +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 2A3AFC27E98; Tue, 31 May 2022 15:06:59 +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 D92C61947070; Tue, 31 May 2022 15:06:58 +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 62FB9194706D for ; Tue, 31 May 2022 15:06:55 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 1E01A10725; Tue, 31 May 2022 15:06:55 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 9DA1F5F245 for ; Tue, 31 May 2022 15:06:54 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009764; 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=U65cqfGSgsLIHouqJaUoAgeGhqdurPhqgNoAn59i3g4=; b=JBI2t+V4DPNz+FlG/lQhRl1caaRAtVKJygKZjK89tGgMxnvh5+Apmrfdppo6URjOEwsfcp YdmcSyPepFDthhJLKkhqiwb3S4O8ntE89DrH0XcB6CLIi9TL3iDxjZ4fDCc6wPiVJUMFkH UumDvOENdnW3DUlQr9n7/uDWmkylooc= X-MC-Unique: h4u6X8myMg6uFM-pKwu3uw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 13/67] docs: formatdomain: Remove 'elementsNUMATuning' anchor Date: Tue, 31 May 2022 17:05:48 +0200 Message-Id: <2e6462090e1ca177fb1f493d254691aff6706213.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.8 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: 1654009769663100003 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 5cf31d9e06..6637ab409b 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -1008,7 +1008,7 @@ influence how virtual memory pages are backed by host= pages. ``nodeset`` attribute may come handy as it ties given guest's NUMA node= s to certain hugepage sizes. From the example snippet, one gigabyte hugepage= s are used for every NUMA node except node number four. For the correct synta= x see - `this <#elementsNUMATuning>`__. + `NUMA Node Tuning`_. ``nosharepages`` Instructs hypervisor to disable shared pages (memory merge, KSM) for th= is domain. :since:`Since 1.0.6` @@ -1100,7 +1100,6 @@ Memory Tuning of 1024 bytes). This element is only supported by VMware ESX and OpenVZ drivers. -:anchor:`` NUMA Node Tuning ---------------- --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009700; cv=none; d=zohomail.com; s=zohoarc; b=BaxpFzC3C7I4wR53xyI+wMOfINxOOlho/UNnQDGTwTgPfjOukENVr32VTjr3t9rY4KamwF7dzubKiWpBWx7HGW99JTYVtk/sSSyMHUBvR0yheGjatSUrShHIRUq+XXUCUyPR59OjagN9ZuF1SXoiidQ5cBcgCa3Vu0Y49mQ+hkQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009700; 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=x2dlG0hlThD6uN7VlwtjyF7qZMfEzCUCfiGgpH/HETY=; b=YEyYke02wDnzex1cq9Jr42p9bV8+uuUtn6tVXPgIvp/QTGcVEMB4g6449s8oWXxKWRyzrir6JKafiLRUfybOmhYvaBafkrF3t35vwdQUHH+EOyEGvqcDnwS7W6jXx/vqfy8ugEf/lAg7gEfPrIUYh6zjX/hZSsxLkhS6Vw0KJKA= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009700021737.1435951677558; Tue, 31 May 2022 08:08:20 -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-659-3OWOvxjDPUiZPUjPDlk6SQ-1; Tue, 31 May 2022 11:08:05 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.rdu2.redhat.com [10.11.54.3]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 44FB310726B3; Tue, 31 May 2022 15:06:57 +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 2D6EC1121314; Tue, 31 May 2022 15:06:57 +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 04C611947067; Tue, 31 May 2022 15:06:57 +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 117621947065 for ; Tue, 31 May 2022 15:06:56 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id F359C1731B; Tue, 31 May 2022 15:06:55 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 7303810725 for ; Tue, 31 May 2022 15:06:55 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009697; 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=x2dlG0hlThD6uN7VlwtjyF7qZMfEzCUCfiGgpH/HETY=; b=RPY1qqNQPfJBCNUhnYpJsxH+IlumGP9JEVHlHsIbtHTkQqicAhU48blNViP3eXBWhJJUF2 DloCJT3xtjmenEhhRn3y4sSfQSStOi3XUl/cxvQr6kWav91+2IvNV7MyHfw33Jq/JtP4iG +w9K7ZsNfIuC+vl4i9jibVIh9OTjz9Y= X-MC-Unique: 3OWOvxjDPUiZPUjPDlk6SQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 14/67] docs: formatdomain: Remove 'elementsBlockTuning' anchor Date: Tue, 31 May 2022 17:05:49 +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.3 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: 1654009701200100002 Content-Type: text/plain; charset="utf-8" Reworded documentation around the local link. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 6637ab409b..45f94e5fa2 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -1149,7 +1149,6 @@ NUMA Node Tuning element. This setting is not compatible with automatic placement. :since:`QEMU Since 1.2.7` -:anchor:`` Block I/O Tuning ---------------- @@ -2970,7 +2969,7 @@ paravirtualized driver is specified via the ``disk`` = element. ``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 - this to the ` <#elementsBlockTuning>`__ element, which appli= es + this to the ``blkiotune`` element (See `Block I/O Tuning`_), which appl= ies globally to the domain). Currently, the only tuning available is Block = I/O throttling for qemu. This element has optional sub-elements; any sub-el= ement not specified or given with a value of 0 implies no limit. :since:`Since --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 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 Reviewed-by: J=C3=A1n Tomko --- 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 From nobody Sun May 12 17:04:04 2024 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=1654009723; cv=none; d=zohomail.com; s=zohoarc; b=DlVNGaA7J4/ixgMV8rLmO5QNjsT80+eAAe2FM2kZfwKcl3WLz4B9VZrJHZS/uiPxtrcjAIaem7ayow+IP5VzcBQ02PC1V4egxBPkmWGhnmTPSP7bNZO+k4a7ZaZSujMLyjUGFxtfvtZA4iB3i4U7/UgWKcADuG0CSY7X+4jdnkc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009723; 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=gH7P3RPwnRIgExQM2rxgTh2Yu5Bv8ZGj2XViGx0Va8Y=; b=Y8sjD3SHGkt6OglRzsDruaRJtklQF3wvaz469lOu9eM/D6r+OLRxX2bULn/Gsjn87jcd7ccCmyPJ4zlPrjGl+vHnlxsv76IM0aul9Uup6IFxTtsX254WyknF0SuxUsFSNqLM3BONAOv+bq2PQh1sWzOoTWqxMqZT/eqYD78Y7Xk= 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 1654009723015408.06813458890406; Tue, 31 May 2022 08:08:43 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-456-vI1rtHCFPDuDYzoskneS0g-1; Tue, 31 May 2022 11:08:12 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id E9C4338332B4; Tue, 31 May 2022 15:07:02 +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 D08C28287E; Tue, 31 May 2022 15:07:02 +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 866821947064; Tue, 31 May 2022 15:07:02 +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 AF38C1947062 for ; Tue, 31 May 2022 15:06:57 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id A24C75F245; Tue, 31 May 2022 15:06:57 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 24DC81731B 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=1654009722; 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=gH7P3RPwnRIgExQM2rxgTh2Yu5Bv8ZGj2XViGx0Va8Y=; b=YL5jJ6SCVIxoNIcemi9tzeoyokU8FlE1hQd+nF+PgHiDEEEZK2Cc3lBPylArPHgcUnM0Vi oDYhGxR9uT/U40eJCNGLI1qPyVF0nvdoKMyAmIXQ2zfTQuutEJEBMF0qlt2dE1arIbhxMY h+K/AhYM1HF/buWRNPViTC9QR5rslic= X-MC-Unique: vI1rtHCFPDuDYzoskneS0g-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 16/67] docs: formatdomain: Remove 'hmat' anchor Date: Tue, 31 May 2022 17:05:51 +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.79 on 10.11.54.5 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: 1654009744677100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index e8431f972f..2851f28251 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -1630,7 +1630,6 @@ QEMU. If no ``distances`` are given to describe the S= LIT data between different cells, it will default to a scheme using 10 for local and 20 for remote distances. -:anchor:`` ACPI Heterogeneous Memory Attribute Table ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 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=1654009734; cv=none; d=zohomail.com; s=zohoarc; b=OWcYLlUUGE0y4ZhRjsveYQ0hCAvof8EPaUFhrv96f1ZEJShLgldW98ZluvQ+T4QLwwB6boP2NZ4wDZL4WjDsFCsp2oMF2eoHKwm0Zq7S5HVfJW+APYgYYNLMGuAsDSkwRDFb2XV8bRWo51lEeGI6lE1fLhwkiY3ce/taBFvrnds= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009734; 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=xKhXw7tPUTjbIo6/Ef6ub24Ypr3RJYu80Q6eDnMaQYE=; b=k4dHTJQkKE6PB8LXVbl4hT0B1WI59YHn/PouMLjgU6lxlPJVxg4VkORNlQ9U0wOwWLbqiCc57g5qQkr5nDKALiFuWsIEkJ7ZJPmopVMq5ZsEEPDfGLQA2oo60+plDwqzzyxhpELJgwUoevajIxuJVt64WFQ4h9mtfOY9wCTaDRU= 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 1654009734726716.0030283904317; Tue, 31 May 2022 08:08:54 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-354-CBHHRRJnMEeaxtq0YrcxJg-1; Tue, 31 May 2022 11:08:22 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 80A491C161D9; Tue, 31 May 2022 15:07:05 +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 6E6FF1731B; Tue, 31 May 2022 15:07:05 +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 2D4D41947067; 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 9EB61194706A for ; Tue, 31 May 2022 15:06:58 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 7176D1731B; Tue, 31 May 2022 15:06:58 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 0156E10725 for ; Tue, 31 May 2022 15:06:57 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009733; 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=xKhXw7tPUTjbIo6/Ef6ub24Ypr3RJYu80Q6eDnMaQYE=; b=UQr/vFvfdc0SWUOVdTy9zbTrIez+uVatrTAqDzKtoY2E/KPXSmejj8KNKtxA6MMBvsoDwd tccSoE9PckkfcAIPe6YiQY+yTtqSoybYNbx6JjmNlBR3uYWzmuyoF1PVuM8UGA3AZFKq9p XsdvuOh09fA7rxvwYkQ33cFbhhBzAns= X-MC-Unique: CBHHRRJnMEeaxtq0YrcxJg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 17/67] docs: formatdomain: Remove 'elementsEvents' anchor Date: Tue, 31 May 2022 17:05:52 +0200 Message-Id: <5e3a84d3ea214edb6fb1802cfd66322f06976512.1654008136.git.pkrempa@redhat.com> 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.79 on 10.11.54.5 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: 1654009735443100015 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - docs/kbase/locking-sanlock.rst | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 2851f28251..acff214cc8 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -1705,7 +1705,6 @@ To describe latency from one NUMA node to a cache of = another NUMA node the For instance, ``target=3D'0' cache=3D'1'`` refers to the first level cache= of NUMA node 0. -:anchor:`` Events configuration -------------------- diff --git a/docs/kbase/locking-sanlock.rst b/docs/kbase/locking-sanlock.rst index 24895b42f4..0b645582f4 100644 --- a/docs/kbase/locking-sanlock.rst +++ b/docs/kbase/locking-sanlock.rst @@ -173,7 +173,7 @@ Domain configuration In case sanlock loses access to disk locks for some reason, it will kill all domains that lost their locks. This default behavior may be changed -using `on_lockfailure element <../formatdomain.html#elementsEvents>`__ in +using `on_lockfailure element <../formatdomain.html#events-configuration>`= __ in domain XML. When this element is present, sanlock will call ``sanlock_helper`` (provided by libvirt) with the specified action. This helper binary will connect to libvirtd and thus it may need to --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 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=1654009805; cv=none; d=zohomail.com; s=zohoarc; b=S2vtDm8eVGViFkmDi9eoDUc1YySrUqRmsHkxEtjPEDzijFTKkW4zSPTlbBrY1jY8N1MdAiB4Vu5iizG7G02y4Bv1+brgxloIlJnQnMr5hY233xWF//2YrlmMJ4fj3TJlyo9EBnpc4ckK2h8uNi1AJJjTrwQYyAuMUJcE4FcqLgo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009805; 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=aPv72m0nPfMzGUIxjfUinRlqtoSQBrJ5StFYsp6YFYY=; b=TrdDSfQ/4t7FZZ+goS8X7+fIj+SiG1pDqMRq+r/Z5SDJfWCysKtG8n2X5962Hh+2eHkKu4ohDHH8ks4uvZvIuH0TWzU3rRRyiFBvD2LueMgxkdT81seg0ASgDUaedpj8gHi2hHCzviGZVMVkWK8xAUt3pgovQuZKIrOm62JFunI= 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 1654009805303310.40054093342724; Tue, 31 May 2022 08:10:05 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-631-jchBi4nMNomamiDjptEuUw-1; Tue, 31 May 2022 11:08:34 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.rdu2.redhat.com [10.11.54.3]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 8DDB42802B2A; Tue, 31 May 2022 15:07:03 +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 767BB1121314; Tue, 31 May 2022 15:07:03 +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 0CBDE194706A; Tue, 31 May 2022 15:07:03 +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 550881947071 for ; Tue, 31 May 2022 15:06:59 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 48F8B5F245; Tue, 31 May 2022 15:06:59 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id BEB771131A for ; Tue, 31 May 2022 15:06:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009804; 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=aPv72m0nPfMzGUIxjfUinRlqtoSQBrJ5StFYsp6YFYY=; b=Q2w92ORvW8Ac8exjCdFQATGwdnHnZj0T9zFll678kVYjxyP4i/+wpC4LaBNGsRsQ0xoxIX lvkjyzxSw3J0n9VcwQ9wZjYqBfapfTmCozbAt38d8lLaBdWtAJKY5pUgIAjJG/NT+PLdKO B79o6z/0A/EUTRAAf0BcMKUkHFrJR6k= X-MC-Unique: jchBi4nMNomamiDjptEuUw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 18/67] docs: formatdomain: Remove 'elementsFeatures' anchor Date: Tue, 31 May 2022 17:05:53 +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.3 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: 1654009805835100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 3 +-- docs/formatdomaincaps.rst | 2 +- docs/kbase/kvm-realtime.rst | 2 +- 3 files changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index acff214cc8..0247132d2b 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -1809,7 +1809,6 @@ advertisements to the guest OS. (NB: Only qemu driver= support) the guest OS itself can choose to circumvent the unavailability of the = sleep states (e.g. S4 by turning off completely). -:anchor:`` Hypervisor features ------------------- @@ -8047,7 +8046,7 @@ Example: ``eim`` The ``eim`` attribute (with possible values ``on`` and ``off``) can = be used to configure Extended Interrupt Mode. A q35 domain with split I= /O - APIC (as described in `hypervisor features <#elementsFeatures>`__), = and + APIC (as described in `Hypervisor features`_), and both interrupt remapping and EIM turned on for the IOMMU, will be ab= le to use more than 255 vCPUs. :since:`Since 3.4.0` (QEMU/KVM only) diff --git a/docs/formatdomaincaps.rst b/docs/formatdomaincaps.rst index d8fcf65450..7aead08d69 100644 --- a/docs/formatdomaincaps.rst +++ b/docs/formatdomaincaps.rst @@ -527,7 +527,7 @@ each of the elements or attributes. For example, the ``= gic`` element has an attribute ``version`` which can support the values ``2`` or ``3``. For information about the purpose of each feature, see the `relevant -section `__ in the domain XML document= ation. +section `__ in the domain XML docum= entation. GIC capabilities ^^^^^^^^^^^^^^^^ diff --git a/docs/kbase/kvm-realtime.rst b/docs/kbase/kvm-realtime.rst index f0a1bb7c95..890155560c 100644 --- a/docs/kbase/kvm-realtime.rst +++ b/docs/kbase/kvm-realtime.rst @@ -162,7 +162,7 @@ placement: The performance monitoring unit virtualization needs to be disabled -via the `hypervisor features <../formatdomain.html#elementsFeatures>`_: +via the `hypervisor features <../formatdomain.html#hypervisor-features>`_: :: --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 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=1654009744; cv=none; d=zohomail.com; s=zohoarc; b=BYtPt0Qi/8o/LLr2/IHhLE4z5kniNanhtaNGFB+WejTsYviSBrXrXlgbFZQZ6Qnbj9iLJRbMMsEKR3EaIk6fp0SMnTbn6+Rdczq0hefHi4qnikZ+6FvTZcCa+t5CzfTH2Bn+LqRUxMhP1oErb653VfnAF6MtnH/sxHZrIOzDpqY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009744; 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=YiwpYAz2qzEjV6myCAsFweUEdrvmgw9LSv/w797jM9Q=; b=hm+bUgStSeQJSWUx+iBLPgvS9Ky6N1sw3uh8fPyGk7ugnq6oj0Ozzy2qWbgnsW/eJg+lSyQZZKq558rWxLWPBRm8zLnLwylVC7syp8jZ/be58+KZFDW3HqDVOJb6AoR1NxNSyOK7tYllJgsEeXZSEJD9JEL7Ypwjg0IrlBifaTI= 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 1654009744446653.422842836513; Tue, 31 May 2022 08:09:04 -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-412-YtWMk3MNPdCas-o1QG_s_g-1; Tue, 31 May 2022 11:07:51 -0400 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.rdu2.redhat.com [10.11.54.2]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 3B29810726A1; 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 2660B40EC001; 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 A0EF91947073; 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 49724194705C for ; Tue, 31 May 2022 15:07:00 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 26E701731B; Tue, 31 May 2022 15:07:00 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id A05B410725 for ; Tue, 31 May 2022 15:06:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009742; 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=YiwpYAz2qzEjV6myCAsFweUEdrvmgw9LSv/w797jM9Q=; b=Gkd7LvsGeZp0lMZfIUrkW1xnyOQ3gs+CcIZWCh/rKMs4aIhujcLAZrUYFJQVtniGrKYVPX Nnely4gRripAdfo4nHUyYwKW1ewY0/I61Zfe9zMTW0W375BiwPlQqqIMUpKG3553aVi3PK SfF3t1K/lDgD6do0jG1wRFPfITFC/QM= X-MC-Unique: YtWMk3MNPdCas-o1QG_s_g-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 19/67] docs: formatdomain: Remove 'elementsDevices' anchor Date: Tue, 31 May 2022 17:05:54 +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.84 on 10.11.54.2 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: 1654009745529100003 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - docs/manpages/virsh.rst | 4 ++-- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 0247132d2b..4f85366c9d 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -2291,7 +2291,6 @@ event name Description ``emulation_faults`` the count of emulation faults, that is when th= e kernel traps on unimplemented instrucions and emulates them for user spac= e, by applications running on the platform ``perf.emula= tion_faults`` =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -:anchor:`` Devices ------- diff --git a/docs/manpages/virsh.rst b/docs/manpages/virsh.rst index 5cb948bb91..965b89c99d 100644 --- a/docs/manpages/virsh.rst +++ b/docs/manpages/virsh.rst @@ -4645,7 +4645,7 @@ attach-device Attach a device to the domain, using a device definition in an XML file using a device definition element such as or as the top-level element. See the documentation at -`https://libvirt.org/formatdomain.html#elementsDevices `__ to learn about +`https://libvirt.org/formatdomain.html#elementsDevices `__ to learn about libvirt XML format for a device. If *--config* is specified the command alters the persistent guest configuration with the device attach taking effect the next time libvirt starts the domain. @@ -5006,7 +5006,7 @@ Update the characteristics of a device associated wit= h *domain*, based on the device definition in an XML *file*. The *--force* option can be used to force device update, e.g., to eject a CD-ROM even if it is locked/mounted in the domain. See the documentation at -`https://libvirt.org/formatdomain.html#elementsDevices `__ to learn about +`https://libvirt.org/formatdomain.html#elementsDevices `__ to learn about libvirt XML format for a device. If *--live* is specified, affect a running domain. --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 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=1654009768; cv=none; d=zohomail.com; s=zohoarc; b=ehwuPhv9+eRYsvk4Z+o5n+ldNEJB1jNvbe3h35CkEKAl7/vMg4foYMs2RWy6Vc/pCK0+Ad21I2v3KhwQ2NbROJ7PpZZp2MKY6mJd9mBACqgCczlHfXjPey11CqZaMhlTo7s6MzYWDODyJk4q0ZIF+y1CYGO9UHWfqfM6oncXldo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009768; 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=hpiwmogNZWaflyBdW3pIH/JUNpH+S4ApERlBNlqfZH4=; b=bwaKQiG8wR3ulIzCugdOh6gDET0+QGpancSGyVkpdMi7vXXKpWlS+kAKbDFA+/YWcGesg808fT1Qht602u/0x/+kNKhU19fE9GPPKwhRBG2rGRGgoUrP0rxKXk1bxoEIudn3BWJvEvH7EBLaRzh7lDBTe2HO2XjNLO7IhoTY/ys= 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 1654009768051656.4384344058088; Tue, 31 May 2022 08:09:28 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-558-MbmWb6vHMT6ZlYu3108fXQ-1; Tue, 31 May 2022 11:07:57 -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 6BA1139796B1; Tue, 31 May 2022 15:07:04 +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 3F9DA2026D07; Tue, 31 May 2022 15:07:04 +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 0EA481947073; Tue, 31 May 2022 15:07:04 +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 097B51947062 for ; Tue, 31 May 2022 15:07:01 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id EF6261731B; Tue, 31 May 2022 15:07:00 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 7D2F610725 for ; Tue, 31 May 2022 15:07:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009767; 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=hpiwmogNZWaflyBdW3pIH/JUNpH+S4ApERlBNlqfZH4=; b=a4f5HpHJM5VrQYGxM/jE+oAZ0jpakWazRcmvyuk6XSPozg2Uc7lfG7gzIcRf5McqnfnPMa ZH7+dFHMSrHJShaca4ksJ5111O2LEiQ+6WCSTAwh0dZN73J83d5jQSNTsXS+DISL5V4WO2 T2BOrXTVgxegJg4hV0Sx9iCViaL13vI= X-MC-Unique: MbmWb6vHMT6ZlYu3108fXQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 20/67] docs: formatdomain: Remove 'elementsDisks' anchor Date: Tue, 31 May 2022 17:05:55 +0200 Message-Id: <74dcc83fb7b0bed2b7d9c8b4ea6e8dd578d6b3c6.1654008136.git.pkrempa@redhat.com> 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: 1654009769711100006 Content-Type: text/plain; charset="utf-8" Two paragraphs containing local links were reformulated and rewrapped. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatbackup.rst | 6 +++--- docs/formatcheckpoint.rst | 2 +- docs/formatdomain.rst | 21 +++++++++++---------- docs/formatsecret.rst | 10 +++++----- docs/formatsnapshot.rst | 6 +++--- docs/storage.rst | 6 +++--- 6 files changed, 26 insertions(+), 25 deletions(-) diff --git a/docs/formatbackup.rst b/docs/formatbackup.rst index c378ad9d9a..02847fd5d4 100644 --- a/docs/formatbackup.rst +++ b/docs/formatbackup.rst @@ -37,7 +37,7 @@ were supplied). The following child elements and attribut= es are supported: ``server`` Present only for a pull mode backup. Contains the same attributes as the - ```protocol`` element of a disk `__ at= tached + ```protocol`` element of a disk `__ attached via NBD in the domain (such as transport, socket, name, port, or tls), necessary to set up an NBD server that exposes the content of each disk= at the time the backup is started. @@ -61,7 +61,7 @@ were supplied). The following child elements and attribut= es are supported: ``name`` A mandatory attribute which must match the ```` of - one of the `disk devices `__ spe= cified + one of the `disk devices `__ specified for the domain at the time of the checkpoint. ``backup`` @@ -122,7 +122,7 @@ were supplied). The following child elements and attrib= utes are supported: file is not deleted after the backup but the contents of the file= don't make sense outside of the backup. The same applies for the block = device which must be formatted appropriately. Similarly to the domain - ```disk`` `__ definition ``scrat= ch`` + ```disk`` `__ = definition ``scratch`` and ``target`` can contain ``seclabel`` and/or ``encryption`` subelements to configure the corresponding properties. diff --git a/docs/formatcheckpoint.rst b/docs/formatcheckpoint.rst index ff3f1e8c00..496de4e1ff 100644 --- a/docs/formatcheckpoint.rst +++ b/docs/formatcheckpoint.rst @@ -69,7 +69,7 @@ The top-level ``domaincheckpoint`` element may contain th= e following elements: ``name`` A mandatory attribute which must match either the ```` or an unambiguous ```` of - one of the `disk devices `__ spe= cified + one of the `disk devices `__ specified for the domain at the time of the checkpoint. ``checkpoint`` diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 4f85366c9d..d1134c523f 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -239,7 +239,7 @@ harddisk, cdrom, network) determining where to obtain/f= ind the boot image. (the sorted list is vda, vdb, hda, hdc). Similar domain with hdc, vda, = vdb, and hda disks will boot from hda (sorted disks are: hda, hdc, vda, vdb)= . It can be tricky to configure in the desired way, which is why per-device = boot - elements (see `disks <#elementsDisks>`__, `network + elements (see `Hard drives, floppy disks, CDROMs`_, `network interfaces <#elementsNICS>`__, and `USB and PCI devices <#elementsHostD= ev>`__ sections below) were introduced and they are the preferred way providin= g full control over booting order. The ``boot`` element and per-device boot el= ements @@ -1186,12 +1186,13 @@ Block I/O Tuning ``device`` The domain may have multiple ``device`` elements that further tune the weights for each host block device in use by the domain. Note that mult= iple - `guest disks <#elementsDisks>`__ can share a single host block device, = if - they are backed by files within the same host file system, which is why= this - tuning parameter is at the global domain level rather than associated w= ith - each guest disk device (contrast this to the ` <#elementsDisks>= `__ - element which can apply to an individual ````). Each ``device`` e= lement - has two mandatory sub-elements, ``path`` describing the absolute path o= f the + disks (See `Hard drives, floppy disks, CDROMs`_) can share a single host + block device, if they are backed by files within the same host file sys= tem, + which is why this tuning parameter is at the global domain level rather= than + associated with each guest disk device (contrast this to the + element of a disk definition (See `Hard drives, floppy disks, CDROMs`_) + which can applies to an individual disk). Each ``device`` element has + two mandatory sub-elements, ``path`` describing the absolute path of the device, and ``weight`` giving the relative weight of that device, in the range [100, 1000]. After kernel 2.6.39, the value could be in the range= [10, 1000]. :since:`Since 0.9.8` @@ -2331,7 +2332,6 @@ following characters: ``[a-zA-Z0-9_-]``. :since:`Sinc= e 3.9.0` ... -:anchor:`` Hard drives, floppy disks, CDROMs ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -4118,7 +4118,7 @@ or: "unfiltered", where the default is "filtered". The optional ``rawio`= ` ( :since:`since 1.2.9` ) attribute indicates whether the lun needs the= rawio capability. Valid settings are "yes" or "no". See the rawio descript= ion - within the `disk <#elementsDisks>`__ section. If a disk lun in the d= omain + within the `Hard drives, floppy disks, CDROMs`_ section. If a disk l= un in the domain already has the rawio capability, then this setting not required. ``scsi_host`` :since:`since 2.5.0` For SCSI devices, user is responsible to make s= ure @@ -4197,7 +4197,8 @@ or: :since:`Since 1.2.8` , the ``source`` element of a SCSI device may c= ontain the ``protocol`` attribute. When the attribute is set to "iscsi", th= e host - device XML follows the network `disk <#elementsDisks>`__ device usin= g the + device XML follows the network disk device + (See `Hard drives, floppy disks, CDROMs`_) using the same ``name`` attribute and optionally using the ``auth`` element to provide the authentication credentials to the iSCSI server. diff --git a/docs/formatsecret.rst b/docs/formatsecret.rst index 03c2836843..0327430078 100644 --- a/docs/formatsecret.rst +++ b/docs/formatsecret.rst @@ -65,7 +65,7 @@ using ``virsh secret-set-value``. The volume type secret can be supplied either in volume XML during creatio= n of a `storage volume `__ in order to pro= vide the passphrase to encrypt the volume or in domain XML -`disk device `__ in order to provide the +`disk device `__ in ord= er to provide the passphrase to decrypt the volume, :since:`since 2.1.0` . An example follow= s: :: @@ -101,7 +101,7 @@ This secret is associated with a Ceph RBD (rados block = device). The ```` element must contain a single ``name`` element t= hat specifies a usage name for the secret. The Ceph secret can then be used by= UUID or by this usage name via the ```` element of a `disk -device `__ or a `storage pool +device `__ or a `storag= e pool (rbd) `__. :since:`Since 0.9.7` . The following is an example of the steps to be taken. First create a ceph-secret.xml file: @@ -132,7 +132,7 @@ See `Setting secret values in virsh`_ on how to set the= value of the secret using ``virsh secret-set-value``. The ceph secret can then be used by UUID or by the usage name via the ```` -element in a domain's ` `__ element= as +element in a domain's ` `__ element as follows: :: @@ -157,7 +157,7 @@ This secret is associated with an iSCSI target for CHAP= authentication. The ```` element must contain a single ``target`` elemen= t that specifies a usage name for the secret. The iSCSI secret can then be used b= y UUID or by this usage name via the ```` element of a `disk -device `__ or a `storage pool +device `__ or a `storag= e pool (iscsi) `__. :since:`Since 1.0.4` . The following is an example of the XML that may be used to generate a secret for iSCSI CHAP authentication. Assume the following sample entry in an iSCSI authenticati= on @@ -207,7 +207,7 @@ See `Setting secret values in virsh`_ on how to set the= value of the secret using ``virsh secret-set-value``. The iSCSI secret can then be used by UUID or by the usage name via the -```` element in a domain's ` = `__ +```` element in a domain's ` `__ element as follows: :: diff --git a/docs/formatsnapshot.rst b/docs/formatsnapshot.rst index dd742a3063..07aa03c0a7 100644 --- a/docs/formatsnapshot.rst +++ b/docs/formatsnapshot.rst @@ -115,11 +115,11 @@ The top-level ``domainsnapshot`` element may contain = the following elements: This sub-element describes the snapshot properties of a specific dis= k. The attribute ``name`` is mandatory, and must match either the ```` (recommended) or an unambiguous ```` - of one of the `disk devices `__ + of one of the `disk devices `__ specified for the domain at the time of the snapshot. The attribute ``snapshot`` is optional, and the possible values are the same as the ``snapshot`` attribute for `disk devices - `__ (``no``, ``internal``, or + `__ (``no``, ``in= ternal``, or ``external``). Some hypervisors like ESX require that if specified, = the snapshot mode must not override any snapshot mode attached to the corresponding domain disk, while others like qemu allow this field to @@ -140,7 +140,7 @@ The top-level ``domainsnapshot`` element may contain th= e following elements: overwrite the default ``file`` type. The ``type`` attribute along wi= th the format of the ``source`` sub-element is identical to the ``sourc= e`` element used in domain disk definitions. See the `disk devices - `__ section documentation for furth= er + `__ section docum= entation for further information. Libvirt currently supports the ``type`` element in the = qemu driver and supported values are ``file``, ``block`` and ``network`` :since:`(since 1.2.2)`. diff --git a/docs/storage.rst b/docs/storage.rst index b860648628..9d5b193e31 100644 --- a/docs/storage.rst +++ b/docs/storage.rst @@ -557,7 +557,7 @@ Example RBD disk attachment RBD images can be attached to QEMU guests when QEMU is built with RBD supp= ort. Information about attaching a RBD image to a guest can be found at `format -domain `__ page. +domain `__ page. Valid RBD pool format types ~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -618,7 +618,7 @@ Example Sheepdog disk attachment Sheepdog images can be attached to QEMU guests. Information about attachin= g a Sheepdog image to a guest can be found at the `format -domain `__ page. +domain `__ page. Valid Sheepdog pool format types ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -698,7 +698,7 @@ Example Gluster disk attachment Files within a gluster volume can be attached to QEMU guests. Information = about attaching a Gluster image to a guest can be found at the `format -domain `__ page. +domain `__ page. Valid Gluster pool format types ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 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=1654009728; cv=none; d=zohomail.com; s=zohoarc; b=kaw4/zEjS9wei5HOHuMBeJj1yIPHdFDTCLHARiR2G0t/mMiupux+2Jw3+vXDZenXHQhJktrSqneWgulSYJwPe3HcXxa301Fno+r+dhNdygsd2acd7zS6zqw3zVikxpDOgUuyJCdqyi0I4pf5nEnXDrG3dJ2sblwZyjOU9dZTAyY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009728; 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=sHfqTePQqetRXFrWOVXptDrlNrxWErMjnPLmgZZXxwI=; b=cVxB8ORzfbcLZa4mGB2fVMF59C17UGUDziFKdUr7FadEMYWAcgxHcxAOg1NsMksmyPdZEg7R436/NuDnRmxN9PPYL+/sjnkHNbYEutb7Q3z9fsQCNe3U7nLlh1kQ4Dq/8pG5ht9lVrpKYJpRWufi/OOWT2BzQDgo5eqR3WP3Pxc= 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 1654009728723231.6492954725819; Tue, 31 May 2022 08:08:48 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-88-Lfom0EmnO8KwWdrPuUpZtw-1; Tue, 31 May 2022 11:08:31 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 3917A3C60551; Tue, 31 May 2022 15:07:04 +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 E0369492C3B; Tue, 31 May 2022 15:07:03 +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 7526C19451EF; Tue, 31 May 2022 15:07:03 +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 D40EF194705C for ; Tue, 31 May 2022 15:07:01 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id C459D5F245; Tue, 31 May 2022 15:07:01 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 471141131A for ; Tue, 31 May 2022 15:07:01 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009727; 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=sHfqTePQqetRXFrWOVXptDrlNrxWErMjnPLmgZZXxwI=; b=bghoVM9f2Xor4KCTXMXYDdfTbIWMCGy0S45Zs/LwKJLryIWBamCIuds4kSwQWzRadHDMN0 ZNd0FiozBIsx715vJS99i+7NBLV0CwK7m4V3AkXK7dF5gd4xjzL/ICEWKvjshHy/9SMdrv 8oM3ktlNIsaWw9qKYlxB9poEqzUe0FM= X-MC-Unique: Lfom0EmnO8KwWdrPuUpZtw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 21/67] docs: formatdomain: Remove 'elementsAddress' anchor Date: Tue, 31 May 2022 17:05:56 +0200 Message-Id: <024d4e6e0a30a105f4aab3f58ba01ed9ac6b2720.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.9 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: 1654009729544100008 Content-Type: text/plain; charset="utf-8" All local links were reformulated to make sense with local references. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 28 +++++++++++++--------------- 1 file changed, 13 insertions(+), 15 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index d1134c523f..9d3960e7ad 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -3473,7 +3473,6 @@ A directory on the host that can be accessed directly= from the guest. permitted to exceed its soft limits for a grace period of time. Afterwa= rds the hard limit is enforced. :since:`Since 0.9.13` -:anchor:`` Device Addresses ~~~~~~~~~~~~~~~~ @@ -3715,7 +3714,7 @@ Note: The PowerPC64 "spapr-vio" addresses do not have= an associated controller. For controllers that are themselves devices on a PCI or USB bus, an option= al sub-element ``
`` can specify the exact relationship of the contro= ller -to its master bus, with semantics `given above <#elementsAddress>`__. +to its master bus, with semantics described in the `Device Addresses`_ sec= tion. An optional sub-element ``driver`` can specify the driver specific options: @@ -4255,7 +4254,7 @@ or: the address type used must conform to the ``model`` attribute of element ``hostdev``, e.g. any address type other than PCI for ``vfio-pci`` devi= ce API or any address type other than CCW for ``vfio-ccw`` device API will res= ult in - an error. `See above <#elementsAddress>`__ for more details on the addr= ess + an error. See the `Device Addresses`_ section for more details on the a= ddress element. ``driver`` PCI devices can have an optional ``driver`` subelement that specifies w= hich @@ -4445,10 +4444,9 @@ behaves like a physical USB CCID (Chip/Smart Card In= terface Device) card. of the character device is the hypervisor itself, rather than a device visible in the guest). -Each mode supports an optional sub-element ``
``, which fine-tunes= the -correlation between the smartcard and a ccid bus controller, `documented -above <#elementsAddress>`__. For now, qemu only supports at most one smart= card, -with an address of bus=3D0 slot=3D0. +Each mode supports an optional sub-element ``
`` (See `Device Addr= esses`_), +which fine-tunes the correlation between the smartcard and a ccid bus cont= roller. +For now, qemu only supports at most one smartcard, with an address of bus= =3D0 slot=3D0. :anchor:`` @@ -4484,7 +4482,7 @@ the host. Each ```` element has an optional ``
`` sub-element tha= t can tie the interface to a particular pci slot, with attribute ``type=3D'pci'`= ` as -`documented above <#elementsAddress>`__. +documented in the `Device Addresses`_ section. :since:`Since 6.6.0` , one can force libvirt to keep the provided MAC addr= ess when it's in the reserved VMware range by adding a ``type=3D"static"`` att= ribute @@ -5808,7 +5806,7 @@ to provide a graphics tablet for absolute cursor move= ment. :since:`since 1.3.0` ) "virtio". The ``input`` element has an optional sub-element ``
`` which can = tie -the device to a particular PCI slot, `documented above <#elementsAddress>`= __. +the device to a particular PCI slot, documented in the `Device Addresses`_= section. On S390, ``address`` can be used to provide a CCW address for an input dev= ice ( :since:`since 4.2.0` ). For types ``passthrough`` and ``evdev``, the manda= tory sub-element ``source`` must have an ``evdev`` (for ``passthrough``) or ``d= ev`` @@ -5848,9 +5846,9 @@ ports available to connect devices to a host system. The ``hub`` element has one mandatory attribute, the ``type`` whose val= ue can only be 'usb'. -The ``hub`` element has an optional sub-element ``
`` with -``type=3D'usb'``\ which can tie the device to a particular controller, `do= cumented -above <#elementsAddress>`__. +The ``hub`` element has an optional sub-element ``
`` +(See `Device Addresses`_) ``type=3D'usb'`` which can tie the device to a +particular controller. :anchor:`` @@ -6419,7 +6417,7 @@ If any of the attributes is not specified by the user= , libvirt will choose a value suitable for most users. Most target types support configuring the guest-visible device address as -`documented above <#elementsAddress>`__; more specifically, acceptable add= ress +documented in the `Device Addresses`_ section; more specifically, acceptab= le address types are ``isa`` (for ``isa-serial``), ``usb`` (for ``usb-serial``), ``pc= i`` (for ``pci-serial``) and ``spapr-vio`` (for ``spapr-vio-serial``). The ``system-serial`` and ``sclp-serial`` target types don't support specifyin= g an @@ -6598,7 +6596,7 @@ types have different ``target`` attributes. /dev/virtio-ports/$name (for more info, please see https://fedoraproject.org/wiki/Features/VirtioSerial). The optional ele= ment ``address`` can tie the channel to a particular ``type=3D'virtio-serial= '`` - controller, `documented above <#elementsAddress>`__. With qemu, if ``na= me`` + controller, as documented in the `Device Addresses`_ section. With qemu= , if ``name`` is "org.qemu.guest_agent.0", then libvirt can interact with a guest age= nt installed in the guest, for actions such as guest shutdown or file syst= em quiescing. :since:`Since 0.7.7, guest agent interaction since 0.9.10` @@ -6985,7 +6983,7 @@ Valid values are: ... Each ``sound`` element has an optional sub-element ``
`` which can= tie -the device to a particular PCI slot, `documented above <#elementsAddress>`= __. +the device to a particular PCI slot. See `Device Addresses`_. A sound device could be optionally mapped to the specific host audio backend using the ``
`` is an invalid address type for all other device types. :since:`Since 6.0.0` -:anchor:`` Virtio-related options ~~~~~~~~~~~~~~~~~~~~~~ @@ -3746,7 +3745,7 @@ An optional sub-element ``driver`` can specify the dr= iver specific options: controllers must be defined each having a specific ``iothread`` value. = The ``iothread`` value must be within the range 1 to the domain iothreads v= alue. virtio options - For virtio controllers, `Virtio-specific options <#elementsVirtio>`__ c= an + For virtio controllers, `Virtio-related options`_ can also be set. ( :since:`Since 3.5.0` ) USB companion controllers have an optional sub-element ```` to spe= cify @@ -5293,7 +5292,7 @@ following attributes are available for the ``"virtio"= `` NIC driver: you know what you are doing. Proper RSS configuration depends from vcpu, tap, and vhost settings.** virtio options - For virtio interfaces, `Virtio-specific options <#elementsVirtio>`__ ca= n also + For virtio interfaces, `Virtio-related options`_ can also be set. ( :since:`Since 3.5.0` ) Offloading options for the host and guest can be configured using the foll= owing @@ -5825,8 +5824,7 @@ change the grab key combination. <#elementsVirtioTransitional>`__ for more details. The subelement ``driver`` can be used to tune the virtio options of the de= vice: -`Virtio-specific options <#elementsVirtio>`__ can also be set. ( :since:`S= ince -3.5.0` ) +`Virtio-related options`_ can also be set. ( :since:`Since 3.5.0` ) Hub devices ~~~~~~~~~~~ @@ -6247,8 +6245,7 @@ A video device. the default QEMU backend. "vhostuser" will use a separate vhost-user process backend (for ``virtio`` device). virtio options - `Virtio-specific options <#elementsVirtio>`__ can also be set ( - :since:`Since 3.5.0` ) + `Virtio-related options`_ can also be set (:since:`Since 3.5.0`) VGA configuration Control how the video devices exposed to the guest using the ``vgaco= nf`` attribute which takes the value "io", "on" or "off". At present, it'= s only @@ -7476,8 +7473,8 @@ Example: manually added device with static PCI slot 2= requested years) might be ignored. :since:`Since 1.1.1, requires QEMU 1.5` ``driver`` - For model ``virtio`` memballoon, `Virtio-specific - options <#elementsVirtio>`__ can also be set. ( :since:`Since 3.5.0` ) + For model ``virtio`` memballoon, `Virtio-related options`_ can also be = set. + ( :since:`Since 3.5.0` ) Random number generator device ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -7551,8 +7548,7 @@ Example: usage of the RNG device: The subelement ``driver`` can be used to tune the device: virtio options - `Virtio-specific options <#elementsVirtio>`__ can also be set. ( - :since:`Since 3.5.0` ) + `Virtio-related options`_ can also be set. ( :since:`Since 3.5.0` ) :anchor:`` @@ -8071,7 +8067,7 @@ attribute ``address`` of the ``cid`` element specifie= s the CID assigned to the guest. If the attribute ``auto`` is set to ``yes``, libvirt will assign a = free CID automatically on domain startup. :since:`Since 4.4.0` The optional ``driver`` element allows to specify virtio options, see -`Virtio-specific options <#elementsVirtio>`__ for more details. :since:`S= ince 7.1.0` +`Virtio-related options`_ for more details. :since:`Since 7.1.0` :: --=20 2.35.3 From nobody Sun May 12 17:04:04 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009728; cv=none; d=zohomail.com; s=zohoarc; b=ffuKMBqQU9dEQDvmeJst64tik5Kdn99p3CkoFUrU2jid2cL8t20jrRk2WiOuvhBS6PU7BnTa9Bq2/QbFQIokw/c9gxvCKPshgBapTQxdMuzZ6+uNdy58xeteq4BSUlVnwKVSEJseMRhxkMpvay0WHTxUp2PannPJQOiRGK2RhgM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009728; 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=e1AAtJs9iRABoiB7iaVX5LJ5xpvxCkQCNzKJZ9cyBy8=; b=R3u9/PDWezbHkbvSj4wwwnEES3aN9nJokBwvQm+zSZbEoqh1Vbx4zWYaxoheiAa4G3oAgF0ZRZiiURukDygW7fxR2Z6lPFf/JVoXHQqo+Krbv7Xq/8g84kToNVER3ZXW1bHVwW3lvqHt1c+BDEGq2CYAygk2O1sjQiNeAVWrPZw= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 165400972858066.02825160936379; Tue, 31 May 2022 08:08:48 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-391-1rsbpLPxNbqaxLV8EuFtpA-1; Tue, 31 May 2022 11:08:32 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 247803C0F728; Tue, 31 May 2022 15:07:08 +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 123BD492CA6; Tue, 31 May 2022 15:07:08 +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 DB135194706D; Tue, 31 May 2022 15:07:07 +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 94D47194705C for ; Tue, 31 May 2022 15:07:03 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 741115F245; Tue, 31 May 2022 15:07:03 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id E74C51131A for ; Tue, 31 May 2022 15:07:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009727; 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=e1AAtJs9iRABoiB7iaVX5LJ5xpvxCkQCNzKJZ9cyBy8=; b=YPeWtxhXnaPGkDQp2EvHWHzMPGSlH3GWwzQnqzgNMQmVdcJDorTkcQeypQIMHO7twyn1DP lRBGYn4Gp9vImS5ZZ/mxOg6idWrLq6r1v3pLM7uhZxiHj8nQ60dBejs+vBm822eUh8mmlX Xu5khqVO5L/LM5xz0Mx/pmxth7A5rCs= X-MC-Unique: 1rsbpLPxNbqaxLV8EuFtpA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 23/67] docs: formatdomain: Remove 'elementsVirtioTransitional' anchor Date: Tue, 31 May 2022 17:05:58 +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.85 on 10.11.54.9 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: 1654009729521100007 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 41 ++++++++++++++++------------------------- 1 file changed, 16 insertions(+), 25 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 91517b069f..13d6e35ca8 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -2571,9 +2571,8 @@ paravirtualized driver is specified via the ``disk`` = element. Indicates the emulated device model of the disk. Typically this is indicated solely by the ``bus`` property but for ``bus`` "virtio" the model can be specified further with "virtio-transitional", - "virtio-non-transitional", or "virtio". See `Virtio transitional - devices <#elementsVirtioTransitional>`__ for more details. :since:`S= ince - 5.2.0` + "virtio-non-transitional", or "virtio". See `Virtio transitional dev= ices`_ + for more details. :since:`Since 5.2.0` ``rawio`` Indicates whether the disk needs rawio capability. Valid settings are "yes" or "no" (default is "no"). If any one disk in a domain has @@ -3385,8 +3384,8 @@ A directory on the host that can be accessed directly= from the guest. :since:`Since 5.2.0` , the filesystem element has an optional attribute ``model`` with supported values "virtio-transitional", - "virtio-non-transitional", or "virtio". See `Virtio transitional - devices <#elementsVirtioTransitional>`__ for more details. + "virtio-non-transitional", or "virtio". See `Virtio transitional device= s`_ + for more details. The filesystem element has optional attributes ``fmode`` and ``dmode``. These two attributes control the creation mode for files and directories @@ -3593,7 +3592,6 @@ granularity. The default is determined by QEMU. :sinc= e:`Since 7.9.0 (QEMU 2.8)` Note: In general you should leave this option alone, unless you are very c= ertain you know what you are doing. -:anchor:`` Virtio transitional devices ~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -3679,15 +3677,13 @@ specific features, such as: ``ports`` and ``vectors``, which control how many devices can be connec= ted through the controller. :since:`Since 5.2.0` , it supports an optional attribute ``model`` which can be 'virtio', 'virtio-transitional', or - 'virtio-non-transitional'. See `Virtio transitional - devices <#elementsVirtioTransitional>`__ for more details. + 'virtio-non-transitional'. See `Virtio transitional devices`_ for more = details. ``scsi`` A ``scsi`` controller has an optional attribute ``model``, which is one= of 'auto', 'buslogic', 'ibmvscsi', 'lsilogic', 'lsisas1068', 'lsisas1078', 'virtio-scsi', 'vmpvscsi', 'virtio-transitional', 'virtio-non-transitio= nal', 'ncr53c90' (as builtin implicit controller only), 'am53c974', 'dc390'. - See `Virtio transitional devices <#elementsVirtioTransitional>`__ for m= ore - details. + See `Virtio transitional devices`_ for more details. ``usb`` A ``usb`` controller has an optional attribute ``model``, which is one = of "piix3-uhci", "piix4-uhci", "ehci", "ich9-ehci1", "ich9-uhci1", "ich9-u= hci2", @@ -4123,8 +4119,8 @@ or: the device is not used by host. This ``type`` passes all LUNs presen= ted by a single HBA to the guest. :since:`Since 5.2.0,` the ``model`` attri= bute can be specified further with "virtio-transitional", - "virtio-non-transitional", or "virtio". See `Virtio transitional - devices <#elementsVirtioTransitional>`__ for more details. + "virtio-non-transitional", or "virtio". `Virtio transitional devices= `_ + for more details. ``mdev`` For mediated devices ( :since:`Since 3.2.0` ) the ``model`` attribute specifies the device API which determines how the host's vfio driver= will @@ -5163,8 +5159,7 @@ supported models with these commands: Typical values for QEMU and KVM include: ne2k_isa i82551 i82557b i82559er ne2k_pci pcnet rtl8139 e1000 virtio. :since:`Since 5.2.0` , ``virtio-transitional`` and ``virtio-non-transitional`` values are support= ed. -See `Virtio transitional devices <#elementsVirtioTransitional>`__ for more -details. +See `Virtio transitional devices`_ for more details. Setting NIC driver-specific options ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -5820,8 +5815,7 @@ change the grab key combination. ``input`` type ``evdev`` is currently supported only on linux devices. (KVM only) :since:`Since 5.2.0` , the ``input`` element accepts a ``model`` attribute which has the values 'virtio', 'virtio-transitional' a= nd -'virtio-non-transitional'. See `Virtio transitional devices -<#elementsVirtioTransitional>`__ for more details. +'virtio-non-transitional'. See `Virtio transitional devices`_ for more det= ails. The subelement ``driver`` can be used to tune the virtio options of the de= vice: `Virtio-related options`_ can also be set. ( :since:`Since 3.5.0` ) @@ -7443,8 +7437,7 @@ Example: manually added device with static PCI slot 2= requested - 'virtio-non-transitional' :since:`Since 5.2.0` - 'xen' - default with Xen - See `Virtio transitional devices <#elementsVirtioTransitional>`__ for m= ore - details. + See `Virtio transitional devices`_ for more details. ``autodeflate`` The optional ``autodeflate`` attribute allows to enable/disable (values @@ -7510,8 +7503,7 @@ Example: usage of the RNG device: - 'virtio-transitional' :since:`Since 5.2.0` - 'virtio-non-transitional' :since:`Since 5.2.0` - See `Virtio transitional devices <#elementsVirtioTransitional>`__ for m= ore - details. + See `Virtio transitional devices`_ for more details. ``rate`` The optional ``rate`` element allows limiting the rate at which entropy= can @@ -8061,11 +8053,10 @@ Vsock A vsock host/guest interface. The ``model`` attribute defaults to ``virtio= ``. :since:`Since 5.2.0` ``model`` can also be 'virtio-transitional' and -'virtio-non-transitional', see `Virtio transitional -devices <#elementsVirtioTransitional>`__ for more details. The optional -attribute ``address`` of the ``cid`` element specifies the CID assigned to= the -guest. If the attribute ``auto`` is set to ``yes``, libvirt will assign a = free -CID automatically on domain startup. :since:`Since 4.4.0` +'virtio-non-transitional', see `Virtio transitional devices`_ for more de= tails. +The optional attribute ``address`` of the ``cid`` element specifies the CID +assigned to the guest. If the attribute ``auto`` is set to ``yes``, libvir= t will +assign a free CID automatically on domain startup. :since:`Since 4.4.0` The optional ``driver`` element allows to specify virtio options, see `Virtio-related options`_ for more details. :since:`Since 7.1.0` --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009695; cv=none; d=zohomail.com; s=zohoarc; b=E5tPkCuW79VZLu2IEHczuPPRq6SdMLG9ajYokyj/q1UxI4XpGgwrEd4nPC0gw8eUAH+tgbmRvR0HhQlhtmyrfmsrxDTbxXIl8xI0PWhE3x2aTZ9ZXSyLA0F2QIpxYWDucYWzbcY+Wei6sW6PC+AJRyhpioRopRpQ4lbBVN4bwR4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009695; 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=3QJmAk1qzNf9Hu326TQXQoSyhXyYNgmvp1rM6zO7kaQ=; b=MVqVCMYTe9zKWCmrBw17CgX3V4wwzGN18MUmAdI+gjih+qqkCDphQkCGytajJEbAEFpsaNy3F3bu25rrbclEQkD0gmQnhsMXSe6Efc7h3s8PF/LLwv/YIjkayYbyPRiE4LsFL0qr2xinTwxynwTbV9htmlS6WcpuVpyF98iSiJs= 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 1654009695989484.5988983648426; Tue, 31 May 2022 08:08:15 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-54-J4iEw17gP92dwkVkEjQM0Q-1; Tue, 31 May 2022 11:08:03 -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 3D3703C92FE2; Tue, 31 May 2022 15:07:07 +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 25BEE2026D07; Tue, 31 May 2022 15:07:07 +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 0B3F51947074; Tue, 31 May 2022 15:07:07 +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 6408E1947067 for ; Tue, 31 May 2022 15:07:04 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 432028288A; Tue, 31 May 2022 15:07:04 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id C7D371131A for ; Tue, 31 May 2022 15:07:03 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009694; 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=3QJmAk1qzNf9Hu326TQXQoSyhXyYNgmvp1rM6zO7kaQ=; b=GdXtQVG2r8jv2DfSkduHrrgHu2q8OXmcUuItXHCnricIUp0S6n/K3BgxQvEfViCN6NzDam WJvLnOM7KsKfgS2mgD7Cjp7p0vTR7TO+r+x9uHCw/S8wG9XwXXlSjUt8QSaHvi3uECL5gZ vIVZAzulBN/z1x3K2ViAa9E+r7FEOZI= X-MC-Unique: J4iEw17gP92dwkVkEjQM0Q-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 24/67] docs: formatdomain: Remove 'elementsControllers' anchor Date: Tue, 31 May 2022 17:05:59 +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: 1654009697229100005 Content-Type: text/plain; charset="utf-8" Local references were reworded. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 13d6e35ca8..403a03edfb 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -3234,7 +3234,7 @@ paravirtualized driver is specified via the ``disk`` = element. ``address`` If present, the ``address`` element ties the disk to a given slot of a controller (the actual ```` device can often be inferred by - libvirt, although it can be `explicitly specified <#elementsControllers= >`__). + libvirt, although it can be be explicitly specified. See `Controllers`_= ). The ``type`` attribute is mandatory, and is typically "pci" or "drive".= For a "pci" controller, additional attributes for ``bus``, ``slot``, and ``function`` must be present, as well as optional ``domain`` and @@ -3633,7 +3633,6 @@ posting `__ and the `virtio-1.0 spec `__. -:anchor:`` Controllers ~~~~~~~~~~~ @@ -6311,8 +6310,7 @@ same values described above. :since:`Since 1.3.3` . ... Each character device element has an optional sub-element ``
`` wh= ich -can tie the device to a particular `controller <#elementsControllers>`__ o= r PCI -slot. +can tie the device to a particular controller (See `Controllers`_) or PCI = slot. For character device with type ``unix`` or ``tcp`` the ``source`` has an optional element ``reconnect`` which configures reconnect timeout if the --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009699; cv=none; d=zohomail.com; s=zohoarc; b=S4S3TNptNVTRwXmltDCy085hqBBz6RkjgNdxlHEvDx0avjFyGukk4ce5GTM1LFaUspMhzlgQUokc/l5gzV/IJEF+v/LSFXJp0LVBJtIcn4GQEBFp2vdXwZuxz02ok5mCod9gnLq2m+6/7p501xIgRDo27D4i92EbTz0JOMLuB1Y= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009699; 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=W7o0DNwociSLRwd2YTZGYRu8KuMw8lEt34S3igSuNUQ=; b=a3exolV86ROzW79CGq+Im3aryUJXo6jn6mwvF7tuOtfOiQ+Crw5yEo8t5vXfj0CQ6bqk9Yv665VnUgrSfUntDiWgrYRjM0kKS2vuxwU4Zyzeywj/VQZ3PNAXuZkjpjUitKX/8gvx4+JGVdn9CgmadPaWIQLcuNdku1WbJBlmmu0= 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 1654009699274413.16756435991135; Tue, 31 May 2022 08:08:19 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-158-ycI7ek-bNZakeY3ETDTpeQ-1; Tue, 31 May 2022 11:08:05 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 213701D32362; Tue, 31 May 2022 15:07:07 +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 0C2515F245; Tue, 31 May 2022 15:07:07 +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 CF97C194706D; Tue, 31 May 2022 15:07:06 +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 244DA194705C for ; Tue, 31 May 2022 15:07:05 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 17A2B1131A; Tue, 31 May 2022 15:07:05 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 8E52C10725 for ; Tue, 31 May 2022 15:07:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009698; 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=W7o0DNwociSLRwd2YTZGYRu8KuMw8lEt34S3igSuNUQ=; b=hntuigY8Ze6+gLjaMoODMBkqbHAqKJ9ImuT8TfLOYD0O93+bhrtiAKc91e76KCp/MU69Tb sVimUygCQA8Ov2jVbUVq9zUCkJlJw357CEYMra+qJAQRfqFOEy6Rb2Dn/dOoC4t9mmropl ETa+hr2lI1gifDUXN2repHRs4p8+FL4= X-MC-Unique: ycI7ek-bNZakeY3ETDTpeQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 25/67] docs: formatdomain: Remove 'elementsHostDev' anchor Date: Tue, 31 May 2022 17:06:00 +0200 Message-Id: <29b54c93800ca41b473a22c1d745b2e70d077734.1654008136.git.pkrempa@redhat.com> 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.79 on 10.11.54.5 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: 1654009701198100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 3 +-- docs/formatnode.rst | 2 +- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 403a03edfb..65197d6e3d 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -240,7 +240,7 @@ harddisk, cdrom, network) determining where to obtain/f= ind the boot image. and hda disks will boot from hda (sorted disks are: hda, hdc, vda, vdb)= . It can be tricky to configure in the desired way, which is why per-device = boot elements (see `Hard drives, floppy disks, CDROMs`_, `network - interfaces <#elementsNICS>`__, and `USB and PCI devices <#elementsHostD= ev>`__ + interfaces <#elementsNICS>`__, and `Host device assignment`_ sections below) were introduced and they are the preferred way providin= g full control over booting order. The ``boot`` element and per-device boot el= ements are mutually exclusive. :since:`Since 0.1.3, per-device boot since 0.8.= 8` @@ -3975,7 +3975,6 @@ acquired. The offset specifies where the lease is stored within the file. If the = lock manager does not require an offset, just pass 0. -:anchor:`` Host device assignment ~~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/formatnode.rst b/docs/formatnode.rst index ec3d529fff..5903cac7fe 100644 --- a/docs/formatnode.rst +++ b/docs/formatnode.rst @@ -12,7 +12,7 @@ Node Device XML There are several libvirt functions, all with the prefix ``virNodeDevice``, which deal with management of host devices that can be handed to guests via passthrough as elements in `the domain -XML `__. These devices are represented = as a +XML `__. These devices are repre= sented as a hierarchy, where a device on a bus has a parent of the bus controller devi= ce; the root of the hierarchy is the node named "computer". --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009705; cv=none; d=zohomail.com; s=zohoarc; b=SZynfX5Jej2XojTVRpbWWXX6IJqis/4FPKNfF8qSTjpQvk+ObU5PsjQ2znNNqn5emhgXR/KKGaoBbozrKfBHCLhmhxlgjFBvoWyOtd1XXXh0iyMPMAfRKEycXMwj5EA+v50DZjrtJioXXIj4urmfTgCRhimZYNvgEZ0R6J4xMMA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009705; 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=aRRvlgP+IhXqbOVAopY7mfzDY5u//4nVhkH7OoV8psA=; b=cSEDr6eBx5ruKOHrh1njQ6DQhGcfh3JL5t1IWi8U2JrbbgDyh+ZDK7TfV3DcnvTWLB2NaokmBZobDiASM/BYcd0HLfeCkhKAdDMCimA1mbGzRNN8iYrTL4lf3FxDErBRvNFlTce4+Aj6HXI2VR/ejsRJOIUUmfDnfY4LE4aM98I= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009705859348.7757555497817; Tue, 31 May 2022 08:08:25 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-645-OwSZrtb4McCE_9LJ_4QTGA-1; Tue, 31 May 2022 11:08:15 -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 0D1F23C60554; Tue, 31 May 2022 15:07:16 +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 DD9892026D07; Tue, 31 May 2022 15:07:15 +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 394F31947B87; Tue, 31 May 2022 15:07:15 +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 F41D8194707E for ; Tue, 31 May 2022 15:07:05 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id E2D7F1131A; Tue, 31 May 2022 15:07:05 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 6F6875F245 for ; Tue, 31 May 2022 15:07:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009704; 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=aRRvlgP+IhXqbOVAopY7mfzDY5u//4nVhkH7OoV8psA=; b=eVnCZ+Cm77xeAvxAB6VRPE3gdCt/NRXgzSS858bw4PXExZ26p6BSYM1Zm5Mj3zJZDUzmFl AInh9EFqDoYc4OMYeei0VS4ITOLileMpka4lG7vsw9EkcPpRKdxdiu2lX+/dqbJJNhKQcf z9aU7zrFuxESvqPegKqwFyCqWsJssfA= X-MC-Unique: OwSZrtb4McCE_9LJ_4QTGA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 26/67] docs: formatdomain: Remove 'elementsNICS' anchor Date: Tue, 31 May 2022 17:06:01 +0200 Message-Id: <2dca974532af3f338ca398522e6df5870726cefd.1654008136.git.pkrempa@redhat.com> 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: 1654009707261100001 Content-Type: text/plain; charset="utf-8" The one local link addition prompted rewrapping of the whole paragraph. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 11 +++++------ docs/formatnetwork.rst | 4 ++-- docs/formatnetworkport.rst | 2 +- 3 files changed, 8 insertions(+), 9 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 65197d6e3d..3618b1212a 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -239,11 +239,11 @@ harddisk, cdrom, network) determining where to obtain= /find the boot image. (the sorted list is vda, vdb, hda, hdc). Similar domain with hdc, vda, = vdb, and hda disks will boot from hda (sorted disks are: hda, hdc, vda, vdb)= . It can be tricky to configure in the desired way, which is why per-device = boot - elements (see `Hard drives, floppy disks, CDROMs`_, `network - interfaces <#elementsNICS>`__, and `Host device assignment`_ - sections below) were introduced and they are the preferred way providin= g full - control over booting order. The ``boot`` element and per-device boot el= ements - are mutually exclusive. :since:`Since 0.1.3, per-device boot since 0.8.= 8` + elements (see `Hard drives, floppy disks, CDROMs`_, `Network interfaces= `_, + and `Host device assignment`_ sections below) were introduced and they = are + the preferred way providing full control over booting order. + The ``boot`` element and per-device boot elements are mutually exclusiv= e. + :since:`Since 0.1.3, per-device boot since 0.8.8` ``smbios`` How to populate SMBIOS information visible in the guest. The ``mode`` attribute must be specified, and is either "emulate" (let the hypervisor @@ -4441,7 +4441,6 @@ Each mode supports an optional sub-element ```` (See `Device Addresses` which fine-tunes the correlation between the smartcard and a ccid bus cont= roller. For now, qemu only supports at most one smartcard, with an address of bus= =3D0 slot=3D0. -:anchor:`` Network interfaces ~~~~~~~~~~~~~~~~~~ diff --git a/docs/formatnetwork.rst b/docs/formatnetwork.rst index d6550f6df9..d956178e56 100644 --- a/docs/formatnetwork.rst +++ b/docs/formatnetwork.rst @@ -61,7 +61,7 @@ The first elements provide basic metadata about the virtu= al network. The optional parameter ``trustGuestRxFilters`` can be used to set that attribute of the same name for each domain interface connected to this network ( :since:`since 1.2.10` ). See the `Network - interfaces `__ section of the domain XML + interfaces `__ section of the dom= ain XML documentation for more details. Note that an explicit setting of this attribute in a portgroup or the individual domain interface will overri= de the setting in the network. @@ -616,7 +616,7 @@ starting. portgroups also support the optional parameter ``trustGuestRxFilters`` whi= ch can be used to set that attribute of the same name for each domain interface u= sing this portgroup ( :since:`since 1.2.10` ). See the `Network -interfaces `__ section of the domain XML +interfaces `__ section of the domain= XML documentation for more details. Note that an explicit setting of this attr= ibute in the portgroup overrides the network-wide setting, and an explicit setti= ng in the individual domain interface will override the setting in the portgroup. diff --git a/docs/formatnetworkport.rst b/docs/formatnetworkport.rst index 6f1a24a52c..394c65c2b7 100644 --- a/docs/formatnetworkport.rst +++ b/docs/formatnetworkport.rst @@ -98,7 +98,7 @@ The following elements are common to one or more of the p= lug types listed later ``virtualport`` The ``virtualport`` element describes metadata that needs to be provide= d to the underlying network subsystem. It is described in the domain XML - `interface documentation `__. + `interface documentation `__. Plugs ~~~~~ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009821; cv=none; d=zohomail.com; s=zohoarc; b=eRU2/IYn3FDlL3XcqrQ3az/dtN6ODPy8Dk+hAEZAa8OFzbbuOexUgM3dOP2aEFhhMySn9+uh2EXafKKT8/KTa3BzzKFxWh5Vv01UO7ddavjZtp7EgKfk1+TmrSUIWfoKBtYuLV8vbjNAj6hbkW+qZe71GIGxA+ER+vSUo1kDxJI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009821; 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=j633Trpmy5Nehxz7xfn1W27COek5IQRk1Z5wCyF9WbU=; b=PsFVno1UCCynVqu6y9tY44mATaRBj5ktdtfva3F1RwWwJj6daGNZO/0cExlCPrYL/viyV1QG1AaFB9+08JoJtVzmiAxljnqQbGYEFNmcxr3U/R6DY1D27shteh9PNQHvnkxpF7I+Wk1Iv/0qFc8ZM3c3tSyHs9q2/JpT8IMGLHk= 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 165400982141863.3073558563226; Tue, 31 May 2022 08:10:21 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-259-x2IPztE1OWKB7wBO7HA6wg-1; Tue, 31 May 2022 11:08:15 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 0C68E3810D5B; Tue, 31 May 2022 15:07:10 +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 EB59A82886; Tue, 31 May 2022 15:07:09 +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 A48071947062; Tue, 31 May 2022 15:07:09 +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 C8B351947067 for ; Tue, 31 May 2022 15:07:06 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id B6B2810725; Tue, 31 May 2022 15:07:06 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 3B6FE82890 for ; Tue, 31 May 2022 15:07:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009820; 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=j633Trpmy5Nehxz7xfn1W27COek5IQRk1Z5wCyF9WbU=; b=GcWDP5xr4iMA/R/pVZj3/G9IC64hOeeKO7wD1xIjyC2rs/LJJyLXVSRr20YjkSlFuFhjg3 MPyC6z/HivSR7+a5je7cRRy/xiUafAO5dV6T3yg+LvpzTFtDT2oA1JJisNBRUdmgmZmloM v7yF0WRZhL0aZSNasUhhmhAJ9L4qLE8= X-MC-Unique: x2IPztE1OWKB7wBO7HA6wg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 27/67] docs: formatdomain: Remove 'elementsNICSDirect' anchor Date: Tue, 31 May 2022 17:06:02 +0200 Message-Id: <7e2403fd4d3795667e96f283e4881d4a676e2bdc.1654008136.git.pkrempa@redhat.com> 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.79 on 10.11.54.5 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: 1654009821921100002 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - docs/formatnetwork.rst | 4 ++-- docs/formatnetworkport.rst | 2 +- 3 files changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 3618b1212a..bbf26edeba 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -4725,7 +4725,6 @@ integration is required. ... -:anchor:`` Direct attachment to physical interface ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/docs/formatnetwork.rst b/docs/formatnetwork.rst index d956178e56..044c239985 100644 --- a/docs/formatnetwork.rst +++ b/docs/formatnetwork.rst @@ -253,7 +253,7 @@ to the physical LAN (if at all). interfaces to be used for a "direct" connection via macvtap using macvtap's "bridge" mode (if the forward element has one or more ```` subelements, :since:`Since 0.9.4` ) (see `Direct - attachment to physical interface `__ + attachment to physical interface `__ for descriptions of the various macvtap modes). libvirt doesn't atte= mpt to manage the bridge interface at all, thus the ```` element's ``stp`` and ``delay`` attributes are not allowed; no iptables rules,= IP @@ -599,7 +599,7 @@ as the 'default' portgroup for the network), and each p= ortgroup has a name, as well as various attributes and subelements associated with it. The current= ly supported subelements are ```` (described in `Quality of servic= e`_) and ```` (documented -`here `__). If a domain interface +`here `__). If = a domain interface definition specifies a portgroup (by adding a ``portgroup`` attribute to t= he ```` subelement), that portgroup's info will be merged into the interface's configuration. If no portgroup is given in the interface defin= ition, diff --git a/docs/formatnetworkport.rst b/docs/formatnetworkport.rst index 394c65c2b7..40a4f0e85b 100644 --- a/docs/formatnetworkport.rst +++ b/docs/formatnetworkport.rst @@ -151,7 +151,7 @@ interface. The ``dev`` attribute provides the name of the physical network interface = to which the port will be connected. The ``mode`` attribute describes how the connection will be setup and takes the same values described in the `domain -XML `__. +XML `__. Host PCI ^^^^^^^^ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009720; cv=none; d=zohomail.com; s=zohoarc; b=Mqkk0l19CfO1K7f3fytLY3RKTlpt5yBIu/x/iiar59YbokOvu+0VGlAcoN+cgwABdxOLs5X3bY51n7VFFSwOUwmKyb8iHJlX7S/Q4IvZb2RKUicv+wzZbZ9tTHMm6xJJ/s1/IX27x+W9afOTKZVjRZYm7z1y5Cyh41ZWe91KVDQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009720; 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=qUuLPdSkHPGXiTT5tbpRLvgWvCFnylyybbfWXJZb6tU=; b=BHg4A9ec8N6GRhXv6HQ0Sldmg9J6dbSswUWdi7yAXhO/EkML3RnKXO7+/8UiBMy+2O7mPhvDyOz8gRcsNvZgRtynUaV8zbgYxJFiAExsf0hwH/LYxLkD+J2zdhkSUZbNL4H42tVLPKi2t40RsO69PvVeyS2ro2CuI6zhHHCiteM= 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 1654009720719120.98134466790464; Tue, 31 May 2022 08:08:40 -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-272-AM5i3LaLNiiEJM2i6Mq3rw-1; Tue, 31 May 2022 11:08:17 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 95F6218E534E; Tue, 31 May 2022 15:07:08 +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 7D77A492CA4; Tue, 31 May 2022 15:07:08 +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 60A0C1947070; Tue, 31 May 2022 15:07:08 +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 9B948194706D for ; Tue, 31 May 2022 15:07:07 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 8FE0A1731B; Tue, 31 May 2022 15:07:07 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 1B5B582894 for ; Tue, 31 May 2022 15:07:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009719; 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=qUuLPdSkHPGXiTT5tbpRLvgWvCFnylyybbfWXJZb6tU=; b=GTj7O/Q0l8FCG6y1UuHwjeU38M2guX5lQo8blUOi2esMtQ+yqK/3+jDCLQ3XQ0O0EfeV6w 4/4tjEujpU4XIoMNxKW4gtLhLedCWTgzOKdQr1DVrJMlG0wekNUv9v4W5xBTcDPlBWaSln xOzgV3dfWqeZ3dOvqE5kRxb4ff1IvBc= X-MC-Unique: AM5i3LaLNiiEJM2i6Mq3rw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 28/67] docs: formatdomain: Remove 'elementsNICSTargetOverride' anchor Date: Tue, 31 May 2022 17:06:03 +0200 Message-Id: <431ffc8fabc9b7244e94ebd1e973ae44a9cf3fe8.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.9 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: 1654009721354100003 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index bbf26edeba..d9d262d959 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -4513,8 +4513,7 @@ can be determined by examining the virtual network co= nfig with 'default' setup out of the box which does NAT'ing to the default route and= has an IP range of ``192.168.122.0/255.255.255.0``. Each guest will have an associated tun device created with a name of vnetN, which can also be over= ridden -with the element (see `overriding the target -element <#elementsNICSTargetOverride>`__). +with the element (see `Overriding the target element`_). When the source of an interface is a network, a ``portgroup`` can be speci= fied along with the name of the network; one network may have multiple portgrou= ps @@ -4580,8 +4579,8 @@ static wired networking configs.** Provides a bridge from the VM directly to the LAN. This assumes there is a bridge device on the host which has one or more of the hosts physical NICs attached. The guest VM will have an associated tun device created with a n= ame of -vnetN, which can also be overridden with the element (see `overri= ding -the target element <#elementsNICSTargetOverride>`__). The tun device will = be +vnetN, which can also be overridden with the element (see +`Overriding the target element`_). The tun device will be attached to the bridge. The IP range / network configuration is whatever i= s used on the LAN. This provides the guest VM full incoming & outgoing net access= just like a physical machine. @@ -5331,7 +5330,6 @@ bridge interfaces. This does not work in session mode= . :since:`Since 1.2.9` For tap devices there is also ``sndbuf`` element which can adjust the size= of send buffer in the host. :since:`Since 0.8.8` -:anchor:`` Overriding the target element ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009751; cv=none; d=zohomail.com; s=zohoarc; b=df5/LSaVym3FQnD8dZCQZz0CHJwiDz/ooSaq0D2aWwMYEdXru8y1tv+hYEg6aL0X27MDVt06/dhqkLS3Vwy5ZcLzbvvceA0tsvK5VMnoToBmor5U7JI7p4ZgH2Haj8Hkg7OiN/5eX8aHeBprp8aXl+1JQXuvD857SqAHqj1wyMo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009751; 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=diGBPf5dfyZjdS2ydEQWe7foP6Wsje2k33dW0mq1tvw=; b=cLd0G7MZqzxdWDcaFPBkiIPR9tJ4xS96kX/jlK/3mq1MpKQqi6jew0jW/1v6Bo3lb6DZucKty7ddsWcU3aJkma8fVviqs/SAzDi2vNVV0pF8SxUyuM43pED9lWufVAFvJwxqv8aQkTFLY7pu/SmkiWDby4YALgueHinMkcxhizo= 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 1654009751537223.66333477045032; Tue, 31 May 2022 08:09:11 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-637-mRNh_O9-PFer2kBKyoQeLg-1; Tue, 31 May 2022 11:08:38 -0400 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.rdu2.redhat.com [10.11.54.2]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id A0F291C09048; Tue, 31 May 2022 15:07:11 +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 8D69E40EC003; Tue, 31 May 2022 15:07:11 +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 4DA63194707B; Tue, 31 May 2022 15:07:11 +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 7DCE41947062 for ; Tue, 31 May 2022 15:07:08 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 603BD5F245; Tue, 31 May 2022 15:07:08 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id D7E8F1131A for ; Tue, 31 May 2022 15:07:07 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009750; 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=diGBPf5dfyZjdS2ydEQWe7foP6Wsje2k33dW0mq1tvw=; b=gW1irxR7Kyb8H3AvmKKaZH7MzDWNaQBtuUfVk5trCvA0CTRwNU3nccyInI9yu19khAnF8i WE3MMUgv+NcNpMurUNsol6+Z63uzfaz7tuPRt1HqqNMBg9lPMhTLolAInPnqwWDkGAyubQ 9qmlq1vXMDb5Uv6BQZW6TWqzdr1YdE0= X-MC-Unique: mRNh_O9-PFer2kBKyoQeLg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 29/67] docs: formatdomain: Remove 'elementQoS' anchor Date: Tue, 31 May 2022 17:06:04 +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.84 on 10.11.54.2 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: 1654009753526100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index d9d262d959..5264d5fbf3 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -5436,7 +5436,6 @@ domains (so data will not go through host system). Us= e with type 'ethernet' to create plain network link, or with type 'bridge' to connect to a bridge in= side the backend domain. :since:`Since 1.2.13 (Xen only)` -:anchor:`` Quality of service ^^^^^^^^^^^^^^^^^^ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009760; cv=none; d=zohomail.com; s=zohoarc; b=bYHzq3f1sOeTZ/+zUFBBg4q4NaFv3rQvzMtxS1d6Vtyxga9/q2WvNIkJYrMuXdwWY6i6A27wwKSLd6/AfslkFOnS55bQpRTdd6so1XM6fqeIJtHYOyqhQElpoVoOZNzNZySKBFRQgVqaogNOym70snkhpao+q4exbVTw5xzGTh0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009760; 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=WR+esew9y17suBrECrPqlMuT/tl9dTGRvsrSZAGila4=; b=Qbn2MZLCfaq1icEU6YRj4ga5xU5HxxdGVl4/0hcpQTZQpz+5nUbgjfYt9nZKePQVit0vCa8bO6egQYApiOeLOuNs/A3uHeCNFEGSgWAcQMYmFJz5whNdHFvD/ieBfAy6qfNlzN//iMf4meiuDUTdn3UroP8O7GSiGOQMBjBG/bI= 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 1654009760557886.4248061595073; Tue, 31 May 2022 08:09:20 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-621-D8anQiHxOG-Tabhlm4eKWA-1; Tue, 31 May 2022 11:08:25 -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 4D2E93C222E0; Tue, 31 May 2022 15:07:15 +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 0158E2026985; Tue, 31 May 2022 15:07:14 +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 93A421947074; Tue, 31 May 2022 15:07:14 +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 41DCF194705C for ; Tue, 31 May 2022 15:07:09 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 36DBC5F245; Tue, 31 May 2022 15:07:09 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id B7BCC10725 for ; Tue, 31 May 2022 15:07:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009759; 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=WR+esew9y17suBrECrPqlMuT/tl9dTGRvsrSZAGila4=; b=g8bQUWTsImyQR6QUbpj/xiR7cae9/ZXzPRJ0gCN0V+Ulfmy/PuzFwh8eQrmNH7gE3nMQND Spn+Jsg3ld3v6MTDM6MF0HI5s0TrqTgjrJ4CABvAxMVGfgKmYjzzZL0eo/2XFQHWMfiLQy A2awjrXXk7Iu8IXAQrRenmc/rF19dTc= X-MC-Unique: D8anQiHxOG-Tabhlm4eKWA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 30/67] docs: formatdomain: Remove 'elementVlanTag' anchor Date: Tue, 31 May 2022 17:06:05 +0200 Message-Id: <460e00cdd9b91bd8a567976e93b11f89b4d3d21c.1654008136.git.pkrempa@redhat.com> 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: 1654009761601100002 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 5264d5fbf3..10503edab6 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -5460,7 +5460,6 @@ outgoing traffic can be shaped independently. The ``b= andwidth`` element and its child elements are described in the `QoS `__ section of the Network XML. -:anchor:`` Setting VLAN tag (on supported network types only) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009807; cv=none; d=zohomail.com; s=zohoarc; b=dSi0K7UgBlMEHTHO15bIJG+3dSSyrcw6BYfw+WMm0uFXYMjCVm9e7t4l/sV3xnpzN9Jm8IHChBITQkHtYlgCxpEv1qCCg1sWPbxvajGqD7W7LYRBpZv7CocwTl6/UORZNMrZ8MQ/eB2D4V4uv0kPxudqb7B34GInQtVZFPmh1Bg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009807; 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=TatVmD4VpYmrHA+F2SYiMlSgr9A4GeJ+C1q9MBjnJEc=; b=lEWu9VZelUijUlW+EBOqkpq6Sd8VaMBwaYvjSREZBwNpF4mJGdE6ykisXt9fgUo2dpzP8UvByKkzBjnbJUKyasM0Srd1RfhyXXv3jYMfpHpwNS/uijZPRSIzPb42SbUYt7k22cpyBpf1mFLWqXyZlMCSUvDPCgaC3rj8gXn4aPM= 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 1654009807053305.2828561512141; Tue, 31 May 2022 08:10:07 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-104-48ExlJr2PKWkei568d4XlA-1; Tue, 31 May 2022 11:08:51 -0400 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 01CF03C1484E; Tue, 31 May 2022 15:07:12 +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 E06C2C27E92; Tue, 31 May 2022 15:07:11 +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 A26DA1947070; Tue, 31 May 2022 15:07:11 +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 22BAB194705C for ; Tue, 31 May 2022 15:07:10 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 1567210725; Tue, 31 May 2022 15:07:10 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 8DF361131A for ; Tue, 31 May 2022 15:07:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009806; 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=TatVmD4VpYmrHA+F2SYiMlSgr9A4GeJ+C1q9MBjnJEc=; b=HAVFCuc2eRsqzQMS26GdPRz9xwKcoq2X9M7OFuCYcoZJ+gVHx/Ozq20NZItuVDk+03PqFW cHJkML0zCL4VCIkzJiabaJXiXG20X8o4ePBIcFkgP4l7ukUhqZU7xowAihEmnrHE0L+oOw MuifXTI2eOQhGD6Rm3WWKZQZ0jdRITY= X-MC-Unique: 48ExlJr2PKWkei568d4XlA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 31/67] docs: formatdomain: Remove 'elementPort' anchor Date: Tue, 31 May 2022 17:06:06 +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.85 on 10.11.54.8 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: 1654009807808100003 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 10503edab6..00d05adfb8 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -5515,7 +5515,6 @@ done with the optional ``nativeMode`` attribute on th= e ```` subelement: be the "native" VLAN for this interface, and the ``nativeMode`` attribute determines whether or not traffic for that VLAN will be tagged. -:anchor:`` Isolating guests's network traffic from each other ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009743; cv=none; d=zohomail.com; s=zohoarc; b=msZ9TWJOkCuVhMKauQjbCeqxKrwclstn4Iy0WFE/Oijz70yhaNZ0zD+5sroZ/JoLcuR7emTK7ZHnzB0cglvJBXxbvzdPAOw0M7T6tA72tAtZ/KeO2b1oqW/zFzjHcycG3T01iq5glsZvdxd5bU7rav3Nv/AQ+qH4ppdj5MNKfT0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009743; 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=bgVZl0hqoEQ9LoXSlwMJdayft8A2pRdtS3fpZOj+v9U=; b=ZqW6QBd7QpIz6EGRQ0G7q7NEZk4WANjFqaf7oKhVSH9P8MZDS22Tg5mktEPL/Bedt4WXLANh0unMNUceR7Oq0MvTXCdYp7l/GiD2fJQ+7gi4JAp5ivfA9eNPEEEdGV7H4dvVCgCdQNSUycoCtYFDMwLHYOwEfPxozpYU4T7L/iY= 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 1654009743811370.7077031208446; Tue, 31 May 2022 08:09:03 -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-396-ToyV9hq1PYW_bHoYNbkkdg-1; Tue, 31 May 2022 11:08:45 -0400 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 3BC6781B5A4; Tue, 31 May 2022 15:07:12 +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 27315C15E72; Tue, 31 May 2022 15:07:12 +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 094361947070; Tue, 31 May 2022 15:07:12 +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 EA650194705C for ; Tue, 31 May 2022 15:07:10 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id DE1871731B; Tue, 31 May 2022 15:07:10 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 6DB2010725 for ; Tue, 31 May 2022 15:07:10 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009742; 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=bgVZl0hqoEQ9LoXSlwMJdayft8A2pRdtS3fpZOj+v9U=; b=VlyAbPOCsXe8BB09inXZbDLNbkbvBKHFPqODge2U5MnSS243Myn47iSbofiV4ivsMPOczq HkXkANnNbOrCa1dk2Q2kBFg/V8ceBEMe0U6qdHoftAdJJuOKAj4wl8pqKMitEMsKtktzqQ BSodC6u3+Z283mlKmlOr0A0BpwfA5u0= X-MC-Unique: ToyV9hq1PYW_bHoYNbkkdg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 32/67] docs: formatdomain: Remove 'mtu' anchor Date: Tue, 31 May 2022 17:06:07 +0200 Message-Id: <2ed25b894fdcb235522b0437d19466080ae6670d.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.8 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: 1654009745533100004 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 00d05adfb8..584cea36af 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -5564,7 +5564,6 @@ specified as the value, the interface behaves as if i= t had the network cable disconnected. Default behavior if this element is unspecified is to have t= he link state ``up``. :since:`Since 0.9.5` -:anchor:`` MTU configuration ^^^^^^^^^^^^^^^^^ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009693; cv=none; d=zohomail.com; s=zohoarc; b=CP+oYdMAUUZJMwXgZkart+MN4WSnMYhi4ZismHKJX91WuiA14hCS6dnzD8ClGyPAog8YgjmpyYvL6PDRUzpVy3kQlGPrUVcE8fLDqlM521RnaWC8Yj1sjbaTXikCQgP3HIZFWF2whChAKBUTkzh/c3XQlVr0RzcVo489uFf6ie0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009693; 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=WzUJBk4VZuRTfh3zvMvJmt5Ol/uhX/+1k3G9RwXcKY8=; b=FDSbMj9F1+YhGuYQTemSxt2t0PxQr8rI2jZb6vILCks+jiKbPsfRyeqw8YkS7ZNPvazeO0+KvKxhl2PfgVfbM2kUgdGRIT5PiZSE/Sx7yMzNGYCDQjvbunXRiJAjfoUdm2jjqqJzPPaB77qaEEU8c94HRUPrcI8fV2Vx4XckNns= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 16540096936371004.030962806751; Tue, 31 May 2022 08:08:13 -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-427-ajIifJLGMNKS2lVKBgW3AQ-1; Tue, 31 May 2022 11:08:01 -0400 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.rdu2.redhat.com [10.11.54.6]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 7F5B2857AA2; Tue, 31 May 2022 15:07:14 +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 6AD772166B26; Tue, 31 May 2022 15:07:14 +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 3FA4C1947062; Tue, 31 May 2022 15:07:14 +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 E0AF6194705C for ; Tue, 31 May 2022 15:07:11 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id C04958288A; Tue, 31 May 2022 15:07:11 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 40B8C10725 for ; Tue, 31 May 2022 15:07:11 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009692; 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=WzUJBk4VZuRTfh3zvMvJmt5Ol/uhX/+1k3G9RwXcKY8=; b=C8vWoftOBtfWYOmp9RMjtS4lX8IzKeTn8EgXsRm864zc4OW7DPiY/QtnIu3tK6LOdnjrVR y98uw/x9lFUYjtwC+NZDSY/JF5qkz3tFW+2UyAJZeefS2u8WgL+u109v18wWJA4/NRyH1W YnYAUuc0JIsnxHxuBf4WWI9SDdcK9f4= X-MC-Unique: ajIifJLGMNKS2lVKBgW3AQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 33/67] docs: formatdomain: Remove 'coalesce' anchor Date: Tue, 31 May 2022 17:06:08 +0200 Message-Id: <1b2cb7508de1dec77f534edfdacda26b0e02bec2.1654008136.git.pkrempa@redhat.com> 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.6 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: 1654009695213100003 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 584cea36af..f7d29e7403 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -5584,7 +5584,6 @@ This element provides means of setting MTU of the vir= tual network link. Currently there is just one attribute ``size`` which accepts a non-negative integer which specifies the MTU size for the interface. :since:`Since 3.1.= 0` -:anchor:`` Coalesce settings ^^^^^^^^^^^^^^^^^ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009729; cv=none; d=zohomail.com; s=zohoarc; b=afR1WDBTW7imA68HwDUMPjerJYyITYzFWOZLjuDdjoLRxTmaNaw3xdbDxqjC+M5SVnw0+mrXdwcy2GuEqcrkryleGW2t6coB/eYS4iYIaUFI+63HxLJfoisLkJHmtOEb5K4+gBrXb4wcSh4MbtTD64IY1WmgVSVGow/AcB885iA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009729; 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=W9wCYRruJBnu6R5tpuqOIGIh5nfag5CHe3tCOi+hacQ=; b=cI5r9rXVdytf7+e62xr2qhTxU9np2dQJzch3kKdODRTi0qaGjrLLqcpcBb7XXBsz3m9jtnk8GrNgBxDTvtrCPWAcFPfO3pGuTglh8ryHWG7v/x+6EHE3oeAG9aQ3TZU3ZA92no4D8BK15hqzweqlah6/6EPV4mPqIjr9bAA6H0s= 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 1654009729664727.3976236674621; Tue, 31 May 2022 08:08:49 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-392-AaBDZM4RMOGZ4tBWsXqb_w-1; Tue, 31 May 2022 11:08:34 -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 55F873C222E5; Tue, 31 May 2022 15:07:15 +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 015CD2026987; Tue, 31 May 2022 15:07:14 +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 944261947076; Tue, 31 May 2022 15:07:14 +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 9DE9D194705C for ; Tue, 31 May 2022 15:07:12 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 90E7E10725; Tue, 31 May 2022 15:07:12 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 222AB82882 for ; Tue, 31 May 2022 15:07:11 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009728; 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=W9wCYRruJBnu6R5tpuqOIGIh5nfag5CHe3tCOi+hacQ=; b=CmEfHnM6y4AJbf9UzsVckJxuAd2oSHRkMrbezFV52wdjPxAbQBqeChSciMRlgm7Yo3cw7z bAwdHntvBqsKxowwn/9DUgCWQwENFt0LwXbxr7Zgv8Couf9VaaX0ETttM58B5VEreADJR7 OZo+1uowugD71fEzYHHYILDRlBp784g= X-MC-Unique: AaBDZM4RMOGZ4tBWsXqb_w-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 34/67] docs: formatdomain: Remove 'elementVhostuser' anchor Date: Tue, 31 May 2022 17:06:09 +0200 Message-Id: <4612aaf1f066366d4d9956028e37c85a1c6b588a.1654008136.git.pkrempa@redhat.com> 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: 1654009731547100011 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index f7d29e7403..4f09df9d48 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -5236,8 +5236,8 @@ following attributes are available for the ``"virtio"= `` NIC driver: ``queues`` The optional ``queues`` attribute controls the number of queues to be u= sed for either `Multiqueue - virtio-net `__ or - `vhost-user <#elementVhostuser>`__ network interfaces. Use of multiple = packet + virtio-net `__ or vhost-user= (See + `vhost-user interface`_) network interfaces. Use of multiple packet processing queues requires the interface having the ```` element. Each queue will potentially be ha= ndled by a different processor, resulting in much higher throughput. @@ -5679,7 +5679,6 @@ side of the network device. These are configured as s= ubelements of the similarly named elements used to configure the guest side of the interface (described above). -:anchor:`` vhost-user interface ^^^^^^^^^^^^^^^^^^^^ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009924; cv=none; d=zohomail.com; s=zohoarc; b=EGPKadq+N+Q2NoLwiL0SkgYZ4dlooufoQPRYXzLJHaU5HZ+utSo0rDXKKXS1VpERKoqAbOOxUtjlOjJ6x+iuH5puMmW7qMRJuewH00P/Q/TSO8wrXu0oPediKt7xG7EmyAGNd89WMLKn/c1EXtS0sTuHEJmvmEhyM3LrDeDlzCc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009924; 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=/iK29Mh2FQ/v6ZLIujTpni3dJ3eLAt5vz5uSAeBBXWY=; b=ZeqBt6hpcyeyo8cpwoDbRObEUsmRCnSuv6kDr1ACETGGkyw9mNXsdFFLwixnQoSf3Pcxnahh1GKeqFfGTBGBQMXuqAFhP3nfd9j+lC+3GWYhZ26wYjMWwCd+gX0tFiyFFv+KqW/0aQ0F9MJmOpE384ncBSAiAh5W3xiJcuz4sO8= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009924644752.7388710769592; Tue, 31 May 2022 08:12:04 -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-31-ZmS4QZ9yN7Kd1WqG8t4l-g-1; Tue, 31 May 2022 11:08:23 -0400 Received: from smtp.corp.redhat.com (int-mx10.intmail.prod.int.rdu2.redhat.com [10.11.54.10]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id F3B53833A22; Tue, 31 May 2022 15:07:15 +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 DCBDD416365; Tue, 31 May 2022 15:07:15 +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 3B9B81947B88; Tue, 31 May 2022 15:07:15 +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 7E7B91947062 for ; Tue, 31 May 2022 15:07:13 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 69BE910725; Tue, 31 May 2022 15:07:13 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id E07421131A for ; Tue, 31 May 2022 15:07:12 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009922; 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=/iK29Mh2FQ/v6ZLIujTpni3dJ3eLAt5vz5uSAeBBXWY=; b=NgZ/dF2t3rJ6ySZKV99Fmm4nF6vrkUUntNSjalbPz5zGNi0wZN175FV8y4vXICxp0H54IA 8ktM2f/lojhYyNuzlALEpfLTJvFINT2JrFOp00JbmZofBvO/+X9QPMak3p+/MNC+7tfHAE kzLbnPL+xhb9CknJ2ZStUschez/HihA= X-MC-Unique: ZmS4QZ9yN7Kd1WqG8t4l-g-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 35/67] docs: formatdomain: Remove 'elementsGraphics' anchor Date: Tue, 31 May 2022 17:06:10 +0200 Message-Id: <77cc06cd010c60e13b900950dd82f4a7abce6861.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.10 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: 1654009926756100001 Content-Type: text/plain; charset="utf-8" Local references needed rewording. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 4f09df9d48..73151c35f0 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -4133,8 +4133,8 @@ or: NVIDIA vGPU or Intel GVT-g) as an alternative to emulated `video devices <#elementsVideo>`__. This attribute is limited to ``model=3D'vfio-pci'`` only. Supported values are either ``on`` or `= `off`` - (default is 'off'). It is required to use a `graphical - framebuffer <#elementsGraphics>`__ in order to use this attribute, + (default is 'off'). It is required to use a graphical framebuffer (S= ee + `Graphical framebuffers`_) in order to use this attribute, currently only supported with VNC, Spice and egl-headless graphics devices. :since:`Since version 5.10.0` , there is an optional ``ramf= b`` attribute for devices with ``model=3D'vfio-pci'``. Supported values = are @@ -4350,7 +4350,7 @@ after 0.9.5 (KVM only)` : ``type`` is required, matching one of the supported `serial device <#elementsConsole>`__ types, to describe the host side of the tu= nnel; ``type=3D'tcp'`` or ``type=3D'spicevmc'`` (which uses the usbredir chan= nel of a - `SPICE graphics device <#elementsGraphics>`__) are typical. The redirdev + SPICE graphics device (See `Graphical framebuffers`_)) are typical. The= redirdev element has an optional sub-element ``
`` which can tie the dev= ice to a particular controller. Further sub-elements, such as ````, ma= y be required according to the given type, although a ```` sub-eleme= nt is @@ -4431,7 +4431,7 @@ behaves like a physical USB CCID (Chip/Smart Card Int= erface Device) card. ``type`` is required, matching one of the supported `serial device <#elementsConsole>`__ types, to describe the host side of the tu= nnel; ``type=3D'tcp'`` or ``type=3D'spicevmc'`` (which uses the smartcard cha= nnel of a - `SPICE graphics device <#elementsGraphics>`__) are typical. Further + SPICE graphics device (See `Graphical framebuffers`_)) are typical. Fur= ther sub-elements, such as ````, may be required according to the gi= ven type, although a ```` sub-element is not required (since the co= nsumer of the character device is the hypervisor itself, rather than a device @@ -5830,7 +5830,6 @@ The ``hub`` element has an optional sub-element ```` (See `Device Addresses`_) ``type=3D'usb'`` which can tie the device to a particular controller. -:anchor:`` Graphical framebuffers ~~~~~~~~~~~~~~~~~~~~~~ @@ -6596,7 +6595,7 @@ types have different ``target`` attributes. the necessary probing mechanism. :since:`Since 2.3.0` ``spicevmc`` Paravirtualized SPICE channel. The domain must also have a SPICE server= as a - `graphics device <#elementsGraphics>`__, at which point the host piggy-= backs + graphics device (See `Graphical framebuffers`_), at which point the hos= t piggy-backs messages across the ``main`` channel. The ``target`` element must be pr= esent, with attribute ``type=3D'virtio'``; an optional attribute ``name`` cont= rols how the guest will have access to the channel, and defaults to @@ -6618,7 +6617,7 @@ types have different ``target`` attributes. disabled by default, and can be enabled by setting the ``copypaste`` property to ``yes``. This allows the guest's clipboard to be synchroniz= ed with the qemu clipboard manager. This can enable copy and paste between= a - guest and a client when using a VNC `graphics device <#elementsGraphics= >`__ + guest and a client when using a VNC graphics device (See `Graphical fra= mebuffers`_) (when using a VNC client that supports the copy/paste feature) or other graphics types that support the qemu clipboard manager. @@ -6879,7 +6878,7 @@ The character device is accessible through spice conn= ection under a channel name specified in the ``channel`` attribute. :since:`Since 1.2.2` Note: depending on the hypervisor, spiceports might (or might not) be enab= led on -domains with or without `spice graphics <#elementsGraphics>`__. +domains with or without spice graphics (See `Graphical framebuffers`_). :: --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009718; cv=none; d=zohomail.com; s=zohoarc; b=QKP1iYSpfwa71ZVnXqCOCQWnxsQ63o+kec/jnvfG++dDz6mQr9bgp5bxSSla/swICR7DFsFEKeH5QcIaRQNVH6eslhLlbcfFrZ1ghjcjOGa+/jnZrgy2ogUgCajZMzQGanfoc1LfimRyKH3ikxiCRal5WEE2YroWknfrT7VF8NY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009718; 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=t+XgRowHrFOWURFoJ1wzIr8lI/CVGicmls1jdM1sGzA=; b=CP4MF+nSN9D7IiSNQ0nhmk775B0ALZQeQ+QOBiSiqHDNUTgc6BqvvVMdOTPx+2XMoR1RbcXHds7f9OdwxnuFLtWsTr8DxaGvZD93JKlUBBioK4ZONQFqvErKjDtaiU0knJHSmU3yedyUmrxEyOJcUNWvh236BdJpdiKJTiXUEns= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009718530717.7747218016091; Tue, 31 May 2022 08:08:38 -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-445-PiARhfSHMqi28QdAJaKsqg-1; Tue, 31 May 2022 11:08:23 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id A3CF71044560; Tue, 31 May 2022 15:07:16 +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 912C140CFD0A; Tue, 31 May 2022 15:07:16 +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 27E0B194706E; Tue, 31 May 2022 15:07:16 +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 53186194706A for ; Tue, 31 May 2022 15:07:14 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 4081C1131A; Tue, 31 May 2022 15:07:14 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id C063D10725 for ; Tue, 31 May 2022 15:07:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009716; 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=t+XgRowHrFOWURFoJ1wzIr8lI/CVGicmls1jdM1sGzA=; b=YdnUamKaQBPMf8klYDKBVbgJzrIjkpAleF2+o8quKB7JnUCuY5wNFmo60gMgJul2ZWyj0Y 9FJo74YIsaNzDgcvtuW/xlTSF16b/loFoCG3jf4ujFWWW5Honoh8sNoQE283p7VuTwR/un L1rJ3m+sHPZM+UlQ+eYY7d6fhecQLyU= X-MC-Unique: PiARhfSHMqi28QdAJaKsqg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 36/67] docs: formatdomain: Remove 'elementsVideo' anchor Date: Tue, 31 May 2022 17:06:11 +0200 Message-Id: <7d0720d5b2512d953103328dafeb9376a02ce986.1654008136.git.pkrempa@redhat.com> 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.84 on 10.11.54.1 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: 1654009719320100001 Content-Type: text/plain; charset="utf-8" The surrounding paragraph around the only fixed use was rewrapped. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 73151c35f0..b3d254520e 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -4130,12 +4130,11 @@ or: create mediated devices on the host. :since:`Since 4.6.0 (QEMU 2.12)= ` an optional ``display`` attribute may be used to enable or disable supp= ort for an accelerated remote desktop backed by a mediated device (such = as - NVIDIA vGPU or Intel GVT-g) as an alternative to emulated `video - devices <#elementsVideo>`__. This attribute is limited to - ``model=3D'vfio-pci'`` only. Supported values are either ``on`` or `= `off`` - (default is 'off'). It is required to use a graphical framebuffer (S= ee - `Graphical framebuffers`_) in order to use this attribute, - currently only supported with VNC, Spice and egl-headless graphics + NVIDIA vGPU or Intel GVT-g) as an alternative to emulated `Video dev= ices`_. + This attribute is limited to ``model=3D'vfio-pci'`` only. Supported = values + are either ``on`` or ``off`` (default is 'off'). It is required to u= se a + graphical framebuffer (See `Graphical framebuffers`_) in order to us= e this + attribute, currently only supported with VNC, Spice and egl-headless= graphics devices. :since:`Since version 5.10.0` , there is an optional ``ramf= b`` attribute for devices with ``model=3D'vfio-pci'``. Supported values = are either ``on`` or ``off`` (default is 'off'). When enabled, this attr= ibute @@ -6125,7 +6124,6 @@ Only ``vnc``, ``spice`` and ``rdp`` supports ```` element. :since:`Since the two APIs to pass a FD to QEMU in order to connect to this graphics device. Supported by graphics type ``vnc`` and ``spice``. -:anchor:`` Video devices ~~~~~~~~~~~~~ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009747; cv=none; d=zohomail.com; s=zohoarc; b=mnFvraw4jgxY6KVoSvdCjt3n3uM0HcB77Kr9YHg7C0ogif+Sra0OACW9VTeiggORSsRHdJj55w47qzjXwFO2JbW9EWemk27vqF2Pp/D2D8/iGlwBz3sbLek94iBK4fBDQl7cEeiUdt9RxOTSDWSAoBuAmg3xXDT7tmYI3BXdY0Q= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009747; 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=fogpIlLmbzJQsXMQak+ErsQTFbttPUv6S8gUvBQjBNI=; b=Atw9IP3N6TiUxFKvD79kH1QufuJshu0HjBfBXMpawUqET5mllYswGZSzXXmVPI2CJ1j/TLUKpO1aqwOuKEZNT1v17BWOU2D7nY9m7jb5bYS1h9YaqmoZ03vYtobQrzvd7EYw9pSLA2GMclU7277BYrJeXibVfxwuaay7+FYote4= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009747597810.5540036374513; Tue, 31 May 2022 08:09:07 -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-31-FrecbBHCMt-XAOKRU5-T5g-1; Tue, 31 May 2022 11:08:38 -0400 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.rdu2.redhat.com [10.11.54.7]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 42E76887426; Tue, 31 May 2022 15:07:23 +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 2BA3F1410F36; Tue, 31 May 2022 15:07:23 +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 0825D194705C; Tue, 31 May 2022 15:07:23 +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 285D519451F1 for ; Tue, 31 May 2022 15:07:15 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 1867882882; Tue, 31 May 2022 15:07:15 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 8D57C1731B for ; Tue, 31 May 2022 15:07:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009742; 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=fogpIlLmbzJQsXMQak+ErsQTFbttPUv6S8gUvBQjBNI=; b=Ndgmk2vHPjVTUpp7SlfbW4sP0vbsiji/tOk/Zzy/mcHPT8OmTzmzFlpZ4+J7eTjf8lhAHX ibQyKdqDPbeIk7dhOjF9dwvT17SKazcUEbycvnQY3IQweEDnHwnjV8vUz4kDv/rx40mYqb Tc3lOk3GcYRKKbWzfh5zRX42JKbDW6U= X-MC-Unique: FrecbBHCMt-XAOKRU5-T5g-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 37/67] docs: formatdomain: Remove 'elementsConsole' anchor Date: Tue, 31 May 2022 17:06:12 +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.85 on 10.11.54.7 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: 1654009749539100012 Content-Type: text/plain; charset="utf-8" Some rewording and rewraping was needed to accomodate the new local references. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 27 +++++++++++++++------------ 1 file changed, 15 insertions(+), 12 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index b3d254520e..5f15c14093 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -4346,15 +4346,18 @@ after 0.9.5 (KVM only)` : ``redirdev`` The ``redirdev`` element is the main container for describing redirected devices. ``bus`` must be "usb" for a USB device. An additional attribute - ``type`` is required, matching one of the supported `serial - device <#elementsConsole>`__ types, to describe the host side of the tu= nnel; - ``type=3D'tcp'`` or ``type=3D'spicevmc'`` (which uses the usbredir chan= nel of a - SPICE graphics device (See `Graphical framebuffers`_)) are typical. The= redirdev - element has an optional sub-element ``
`` which can tie the dev= ice to - a particular controller. Further sub-elements, such as ````, ma= y be - required according to the given type, although a ```` sub-eleme= nt is - not required (since the consumer of the character device is the hypervi= sor - itself, rather than a device visible in the guest). + ``type`` is required, matching one of the supported serial device types + (See `Consoles, serial, parallel & channel devices`_), to describe the = host + side of the tunnel; ``type=3D'tcp'`` or ``type=3D'spicevmc'`` (which us= es the + usbredir channel of a SPICE graphics device (See `Graphical framebuffe= rs`_)) + are typical. + + The redirdev element has an optional sub-element ``
`` which ca= n tie + the device to a particular controller. Further sub-elements, such as + ````, may be required according to the given type, although a + ```` sub-element is not required (since the consumer of the + character device is the hypervisor itself, rather than a device visible= in + the guest). ``boot`` Specifies that the device is bootable. The ``order`` attribute determin= es the order in which devices will be tried during boot sequence. The per-devi= ce @@ -4427,8 +4430,9 @@ behaves like a physical USB CCID (Chip/Smart Card Int= erface Device) card. possible to tunnel all requests through a secondary character device to= a third-party provider (which may in turn be talking to a smartcard or us= ing three certificate files). In this mode of operation, an additional attr= ibute - ``type`` is required, matching one of the supported `serial - device <#elementsConsole>`__ types, to describe the host side of the tu= nnel; + ``type`` is required, matching one of the supported serial device types + (See `Consoles, serial, parallel & channel devices`_), + to describe the host side of the tunnel; ``type=3D'tcp'`` or ``type=3D'spicevmc'`` (which uses the smartcard cha= nnel of a SPICE graphics device (See `Graphical framebuffers`_)) are typical. Fur= ther sub-elements, such as ````, may be required according to the gi= ven @@ -6230,7 +6234,6 @@ A video device. attribute which takes the value "io", "on" or "off". At present, it'= s only applicable to the bhyve's "gop" video model type ( :since:`Since 3.5= .0` ) -:anchor:`` Consoles, serial, parallel & channel devices ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009760; cv=none; d=zohomail.com; s=zohoarc; b=SI08rNqYwJHf5M6scuSoNeLD0ZHIxSv3AHcsl3Mtr5rucoX6hbIsuxkHoGplqPzxKR0SAbIsAdoj2Th1nAkmUaMRztIRI3b2VlNMdXP3v6Urk8CQ2IvNlm1HN1WoVi0SBLVUzW1D5nSZxJfbE2s891mvxHf+7QUVDUOLYENdU34= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009760; 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=6VBFzY5ZMAeIG2Vggt7oPxN0FB9qvgkXmfulU3Orua4=; b=CRRb8vwMdy6bnP6Gw0RurhEhCWLV18bdA6w/8ywFaqwDEgGvEGa8MZ+ad53rOYD4h0zS6WN/wJGMIv+sN6zfjnUZh2J9+wxOqZ7cN8Vey5/YZwaFIs5XxSa/9Cjm9PcAgcVD6xE+18pjjN90mHluAg/6QTw5qW84qnFH+3QWySI= 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 1654009760487245.01233587125273; Tue, 31 May 2022 08:09:20 -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-522--gX-crU5OJmYf09ynwMPDA-1; Tue, 31 May 2022 11:09:07 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id A262310D31C8; Tue, 31 May 2022 15:07:31 +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 8F40340CF8ED; Tue, 31 May 2022 15:07:31 +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 35450194706E; Tue, 31 May 2022 15:07:31 +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 F0F89194707A for ; Tue, 31 May 2022 15:07:15 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id E16568287E; Tue, 31 May 2022 15:07:15 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 729CE82892 for ; Tue, 31 May 2022 15:07:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009759; 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=6VBFzY5ZMAeIG2Vggt7oPxN0FB9qvgkXmfulU3Orua4=; b=eBqaF17QG/TkHAiWrxPfBZyHn7yOtzHwDHT7KiBMt8/LX0r6gs19qeJlbj3nDZ/9IIkkmj NL/O+XJez3kVWBG3BtW0ZD9M6lPW3MQZLHRGsshcKwM+XJaayMwNx4r7HWvjqWJsxBcPcV TVqFI5PbrIH2zm1OSv+xa9ftqM9GU5w= X-MC-Unique: -gX-crU5OJmYf09ynwMPDA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 38/67] docs: formatdomain: Remove 'elementCharSerial' anchor Date: Tue, 31 May 2022 17:06:13 +0200 Message-Id: <4aed16202daa351e51d8e184072eb4e7137865e1.1654008136.git.pkrempa@redhat.com> 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.84 on 10.11.54.1 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: 1654009761605100003 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 5f15c14093..3b9c18f6b4 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -274,8 +274,8 @@ them in production. ``bios`` This element has attribute ``useserial`` with possible values ``yes`` or ``no``. It enables or disables Serial Graphics Adapter which allows use= rs to - see BIOS messages on a serial port. Therefore, one needs to have `serial - port <#elementCharSerial>`__ defined. :since:`Since 0.9.4` . :since:`Si= nce + see BIOS messages on a serial port. Therefore, one needs to have `Seria= l port`_ + defined. :since:`Since 0.9.4` . :since:`Since 0.10.2 (QEMU only)` there is another attribute, ``rebootTimeout`` that controls whether and after how long the guest should start booting agai= n in case the boot fails (according to BIOS). The value is in milliseconds w= ith @@ -6330,7 +6330,6 @@ Parallel port ``target`` can have a ``port`` attribute, which specifies the port number.= Ports are numbered starting from 0. There are usually 0, 1 or 2 parallel ports. -:anchor:`` Serial port ''''''''''' @@ -6437,7 +6436,7 @@ the ``console`` element might represent the same devi= ce as an existing ``serial`` element or a separate device. A ``target`` subelement is supported and works the same way as with the -``serial`` element (`see above <#elementCharSerial>`__ for details). Valid +``serial`` element (See `Serial port`_ for details). Valid values for the ``type`` attribute are: ``serial`` (described below); ``vir= tio`` (usable whenever VirtIO support is available); ``xen``, ``lxc`` and ``open= vz`` (available when the corresponding hypervisor is in use). ``sclp`` and ``sc= lplm`` --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009733; cv=none; d=zohomail.com; s=zohoarc; b=hh9YyoVnT1CLD+kfmpYglxCEFYxv6i3r8Kq7K/bi94PVsq++k+N4IyRvoraKnEgcJw1BZ0xEDKzgJmDnnNbMwFve7K16xDPxNQ29im9niecKTYPsZhWq4iXvSvQicyZyaunnmax5zZvkPmAW5oWauXWl+Y9LafMxiHtjSOFYwEY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009733; 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=h20lZWYEIVUqkqID8IAUeg5gZjjvczTwk0BzsySQjKY=; b=bXUs9W9UEIIn5I1ZzDX4D/MkQWj5mk9aDjjpDV8ISeIEzoZG/WC2nr7azZzejHOO1ELEn8OQ2UE+WkoqzXVEe0KWWYfSrVtCfw1zrSvJbKpXAYNI89xIPC67pHe1RRAvWOwKpjmU2QpE+fVteaq+G1Kpye4CB+FBjD6KA4tf0mc= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009733008611.4645541991611; Tue, 31 May 2022 08:08:53 -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-459-NgrFKPmxMjm0GrMb4TpRgg-1; Tue, 31 May 2022 11:08:38 -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 8D58080C8FB; Tue, 31 May 2022 15:07:19 +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 72E3F2026985; Tue, 31 May 2022 15:07:19 +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 3E516194706A; Tue, 31 May 2022 15:07:19 +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 E27B6194706D for ; Tue, 31 May 2022 15:07:16 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id B9A668287E; Tue, 31 May 2022 15:07:16 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 3EE431731B for ; Tue, 31 May 2022 15:07:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009731; 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=h20lZWYEIVUqkqID8IAUeg5gZjjvczTwk0BzsySQjKY=; b=hWofFpT27crC5VKtH5I/mdB6QzEl+uWm9PqiPEJarGZ1gsJoEuXgj1aD4Ai9+1nYp65mGJ nQwYeDxPCn1Tf/uaCPYyuZXvhBj2+CdgpgdRDIbCvEVFWjU2MEhjY7AyXhnzSJZELK6vGz if2C1PxNgblubi4NL3oTHtE5ZJP3jJQ= X-MC-Unique: NgrFKPmxMjm0GrMb4TpRgg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 39/67] docs: formatdomain: Remove 'elementCharSerialAndConsole' anchor Date: Tue, 31 May 2022 17:06:14 +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: 1654009733441100013 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 3b9c18f6b4..1e279ad72e 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -6400,8 +6400,8 @@ types are ``isa`` (for ``isa-serial``), ``usb`` (for = ``usb-serial``), ``pci`` ``system-serial`` and ``sclp-serial`` target types don't support specifyin= g an address. -For the relationship between serial ports and consoles, `see -below <#elementCharSerialAndConsole>`__. +For the relationship between serial ports and consoles, refer to the +`Relationship between serial ports and consoles`_ section. Console ''''''' @@ -6454,10 +6454,8 @@ Virtio consoles are usually accessible as ``/dev/hvc= [0-7]`` from inside the guest; for more information, see https://fedoraproject.org/wiki/Features/VirtioSerial. :since:`Since 0.8.3` -For the relationship between serial ports and consoles, `see -below <#elementCharSerialAndConsole>`__. - -:anchor:`` +For the relationship between serial ports and consoles, refer to the +`Relationship between serial ports and consoles`_ section. Relationship between serial ports and consoles '''''''''''''''''''''''''''''''''''''''''''''' --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009938; cv=none; d=zohomail.com; s=zohoarc; b=LhODJXMMBjfL54j5nJGUtJY5idTykq93LOYfVHtkmE5enY/ql2o3B/CFErlqm77ntpbW8xI0pEJwe4agUGZd8o1HzHrbWN2IgwtMKOCsprcaQ9XCjIQW3PKNHqOSuxtNQwEdN4o8sMQ7T3LnCaT7SSzM0KNG0caXOIHk81BjhuQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009938; 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=/hvWrz0o3qiMo7BP9jq098Lz/VMzpo7bRrofzBQ5eRM=; b=AKTBWj0yJicgS9gYug88QmWXGwMwEzVVcUd8PveDw0gE3zkxsTCWR8uFO1hx4F9KIx+kZzkRZ5zBDe68LqdgEfMbAHqyZioQ6qMz+DNrvGBb8S0a51jVRTcfF+fOk4TP3Y+FKH3YSn28Nat3he9fHn19yA4QpRMD2KrDN+t4Yw4= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009938220618.2746875555426; Tue, 31 May 2022 08:12:18 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-322-UFgLIa51OCSMHNTKpvpZEQ-1; Tue, 31 May 2022 11:09:04 -0400 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.rdu2.redhat.com [10.11.54.6]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 054DE3C1175A; Tue, 31 May 2022 15:07:22 +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 E07482166B26; Tue, 31 May 2022 15:07:21 +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 984601947062; Tue, 31 May 2022 15:07:21 +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 A208B1947062 for ; Tue, 31 May 2022 15:07:17 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 8EDBF8288A; Tue, 31 May 2022 15:07:17 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 1C38882899 for ; Tue, 31 May 2022 15:07:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009936; 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=/hvWrz0o3qiMo7BP9jq098Lz/VMzpo7bRrofzBQ5eRM=; b=QKheeuUoo6Rhv+qPumfKheG9oWmWT8ea1Ucyf6aMU/Fa7t6s8Idm4c8s1N8Ijyyec6vMpJ g6AiJKyztwqrBwJ+lfifhKNbGA/7CYzIFf6yl/colkIB/fyhPSq1IXCL0UGXpFPbsVHbww ubjWTuoKNkoaC/QXEnuEiDroq2MFLh4= X-MC-Unique: UFgLIa51OCSMHNTKpvpZEQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 40/67] docs: formatdomain: Remove 'elementsCharHostInterface' anchor Date: Tue, 31 May 2022 17:06:15 +0200 Message-Id: <512ce025255ca0205b2559689ebb97af38af9d24.1654008136.git.pkrempa@redhat.com> 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.6 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: 1654009938750100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 1e279ad72e..d8004d4ad0 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -6624,7 +6624,6 @@ types have different ``target`` attributes. default will be used (client mode). :since:`Since 8.4.0` -:anchor:`` Host interface ^^^^^^^^^^^^^^ @@ -7512,8 +7511,8 @@ Example: usage of the RNG device: ``egd`` This backend connects to a source using the EGD protocol. The source= is - specified as a character device. Refer to `character device host - interface <#elementsCharHostInterface>`__ for more information. + specified as a character device. Refer to the `Host interface`_ for = more + information. ``builtin`` This backend uses qemu builtin random generator, which uses --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009945; cv=none; d=zohomail.com; s=zohoarc; b=HBCdMH3Wa/cIcrB3Dypwr4Z9lrVQMEvZPj0/IoI8EivRcyAPZYVr9IfL7L9FJv8l/VML+gRebTIQiGnUbLKPFOC0I6Semy7Wo2GAS4fc+6yrVJdDGn0vlHukrt3udYiLSBy9K3+p9vKFxw6968lHhp6E5m+Z4fkpexyrOTxWr9k= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009945; 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=QYm5FWTUTLLLRdYOwJJd5Oo+RMr64Z+K53XGsnh6deo=; b=kxG+MzAQVqRpQ12C1Op3vM9BQF6Q85sqQIpyI2ItinDpF3UR9H9cZ6pJ6JHTfUH3f5F7fRoABwg3d4gweLpWmffs79uxHJcwq8YduY6ph3hah56Vf54+f51NvHJhMBZCRe5PxIjyyVMKtZ8Bb6WT61HmCXJ+KUHb6SuySMOi3zQ= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009945588202.39624676293704; Tue, 31 May 2022 08:12:25 -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-474-KG8mpIUQMva3h1a6hqXk5Q-1; Tue, 31 May 2022 11:08:27 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 80D711801DA0; Tue, 31 May 2022 15:07:20 +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 695A2492C3B; Tue, 31 May 2022 15:07:20 +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 3A6D71947067; Tue, 31 May 2022 15:07:20 +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 77B50194705C for ; Tue, 31 May 2022 15:07:18 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 6C26810725; Tue, 31 May 2022 15:07:18 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id E5D6B1131A for ; Tue, 31 May 2022 15:07:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009944; 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=QYm5FWTUTLLLRdYOwJJd5Oo+RMr64Z+K53XGsnh6deo=; b=X0UCFLCRrXSJ8PV1kM1/KpqVYeq2v2FCI9YhVOozCpZndykDLrkf33l5HMa8FZJ5V+tEad IOxVtZ0iFK5OzxDpdcjPHMEexeglGcx34RP0ZCzJx3SJ+/GePi/O84K5fE4erW5UqLpr3A W74geqZwZpyKwKJEZr1BjK4nVc+6nY0= X-MC-Unique: KG8mpIUQMva3h1a6hqXk5Q-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 41/67] docs: formatdomain: Remove 'elementsCharHost' anchor Date: Tue, 31 May 2022 17:06:16 +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.85 on 10.11.54.9 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: 1654009946818100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index d8004d4ad0..d63543db0b 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -6716,7 +6716,6 @@ NB special case if , then the T= TY path is also duplicated as an attribute tty=3D'/dev/pts/3' on the top level tag. This provi= des compat with existing syntax for tags. -:anchor:`` Host device proxy ''''''''''''''''' --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009811; cv=none; d=zohomail.com; s=zohoarc; b=fZTNFkWrMA+ZVK4KRGYrExwakxjFnVIEQTjvvwrX1f8kgZOKRX37kf+BJ8uAUUy5RQj6JFk3TiQ7cIzM1nIIUmAn63lJcAM74TRdJfP7heYmw0048nUsIRGPzm1ejsihPC9nY0WYKF8Yl9sIcusTFAkOfcWrFSFtui86UVqO6VQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009811; 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=hk8hpeDS9AGGFUxEfuQi8mAbWfknTKy8AvIMBp9UiH4=; b=XsjcJgzxzuzVM3x6mqW1eR3kFVI5DzCeQIebvYIzOgC1DN6TSMGA1Fu53LLR/JueC87pfajUT9rXX6ucSFs5WMTHCEOMhmxR01dCeM3PcGuoNoJeSh877ZckcPez6jP2q//Qq15wB1YqwicG0CGmafQmD/Vq5AjsR6UrKKoKCFE= 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 1654009811740779.1523597218428; Tue, 31 May 2022 08:10:11 -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-617-g1fqf5OpPtGLDxgnvl7dcg-1; Tue, 31 May 2022 11:08:53 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id EF85E10AF7EC; Tue, 31 May 2022 15:07:30 +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 D8F2240CF8ED; Tue, 31 May 2022 15:07:30 +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 A15CB19451EC; Tue, 31 May 2022 15:07:30 +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 598CB1947064 for ; Tue, 31 May 2022 15:07:19 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 4265C10725; Tue, 31 May 2022 15:07:19 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id C507F1131A for ; Tue, 31 May 2022 15:07:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009810; 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=hk8hpeDS9AGGFUxEfuQi8mAbWfknTKy8AvIMBp9UiH4=; b=dPDU5eVXMX9eL8glvFrY2F9vJ7UvQMKSmWmBLCQeCfEirzTIjqh3pOZq4djjstX0ivGUY7 xN+BMF/+LlAOgt53nGxIGu/iTkPR11U0gffFCyrCECHhCdEJgGCexEKKl24ocCJAyK0WOQ cD/elHyTbSNbEENqyOeHEJqqSvT92fg= X-MC-Unique: g1fqf5OpPtGLDxgnvl7dcg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 42/67] docs: formatdomain: Remove 'elementsAudio' anchor Date: Tue, 31 May 2022 17:06:17 +0200 Message-Id: <37d224da50c890a2ade68020c1e37b9a1d73e69b.1654008136.git.pkrempa@redhat.com> 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.84 on 10.11.54.1 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: 1654009813881100001 Content-Type: text/plain; charset="utf-8" Local references were reworded to match. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index d63543db0b..a6e54246b8 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -5920,7 +5920,7 @@ interaction with the admin. ` Audio backends ~~~~~~~~~~~~~~ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009783; cv=none; d=zohomail.com; s=zohoarc; b=mj8ZYAfLFBEdK03JlegtT/uandH740rNAHsm+BjHuc0lA/6Rx//itUicwZa3RBf7Uvbb0MYPH7fgPDdNNq7ZybUz6ZINpvEGwIwmzd6yrNP0Cps66MbsiEnC4g33Xc5kDr01GLc2L4BA+8+KXkoDo/NX0poLhJ9Uy9o7pDbSwZc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009783; 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=djZDN7No9yD/bj8bTn9H+DTGMaqG93eWm4CIzYBocdk=; b=AzwITwqVar7ZNEjrzoDaEEKVI0mYn/zTAwyjZ4tf8tuowvxCEQsxktnp34ZezPLMTUocyadTAqKl2wwpxTCEhN15a/b0I+sWw6a+/2wCz/CpNs/5shD8dbBI6w2mahJusDhOy3HSZ/STrrdsC8aO6bCbBAytY7Q+oRKDFqLEB10= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 165400978319599.83506524060192; Tue, 31 May 2022 08:09:43 -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-573-4RITzc2VMX6yjNRsctSbUw-1; Tue, 31 May 2022 11:09:00 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 2AAE19595D0; Tue, 31 May 2022 15:07:33 +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 0F2C84047828; Tue, 31 May 2022 15:07:33 +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 69FC21947076; Tue, 31 May 2022 15:07:32 +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 3C7B2194706A for ; Tue, 31 May 2022 15:07:20 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 15A161731B; Tue, 31 May 2022 15:07:20 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 8FC7410725 for ; Tue, 31 May 2022 15:07:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009782; 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=djZDN7No9yD/bj8bTn9H+DTGMaqG93eWm4CIzYBocdk=; b=TLVmwQS2WYaGDsF/pK7Xzn3JXV9vkzgPIrdspbEvLrDbua7zCEUifNgbtzVrYtO41jw55A XrzmZf8wPalqXtZo2D8Mw42cCpUmNqBRp7p8vfe8OubpVBE0P7WTTjOZpYc/ZbDzEr10uM bKlSvUN70UV96HXExzKxFAVCClTQ7Ps= X-MC-Unique: 4RITzc2VMX6yjNRsctSbUw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 43/67] docs: formatdomain: Remove 'elementsTpm' anchor Date: Tue, 31 May 2022 17:06:18 +0200 Message-Id: <8c34e8aed0669ecba1e2e7b39c21cbc8eb0363ba.1654008136.git.pkrempa@redhat.com> 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.84 on 10.11.54.1 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: 1654009783854100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - docs/formatsecret.rst | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index a6e54246b8..efe20e9654 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -7523,7 +7523,6 @@ Example: usage of the RNG device: virtio options `Virtio-related options`_ can also be set. ( :since:`Since 3.5.0` ) -:anchor:`` TPM device ~~~~~~~~~~ diff --git a/docs/formatsecret.rst b/docs/formatsecret.rst index 0327430078..d0c37ff165 100644 --- a/docs/formatsecret.rst +++ b/docs/formatsecret.rst @@ -268,7 +268,7 @@ This secret is associated with a virtualized TPM (vTPM)= and serves as a passphrase for deriving a key from for encrypting the state of the vTPM. T= he ```` element must contain a single ``name`` element t= hat specifies a usage name for the secret. The vTPM secret can then be used by= UUID -via the ```` element of a `tpm = `__ +via the ```` element of a `tpm `= __ when using an emulator. :since:`Since 5.6.0` . The following is an example= of the steps to be taken. First create a vtpm-secret.xml file: --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009737; cv=none; d=zohomail.com; s=zohoarc; b=W1o5CuqyesNGGRf51y0lcqS3gKu8S82X3OqejTfhht3mesx8wVZoB8+MnvTw162eLDKww+8s5ZFTEMUuxJg8iUCpfNuXvVmwIuwPGudI7BCjKh++toVTblMiojXbvHsJVIvCGYFa4i1UEO4O39Kmx7ZqbpZv5hnmqI4La8VIqxc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009737; 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=YSbhzdF3xTHC4824DFdqQuQNWHgMN84GvPjaFPlREzA=; b=M+tsfR1pzWtJ6EL9yvEy7sXK0p7u7R/h+VajJBiSmkFXvboYvJhXYSiOOzRM51DOyGCcFIgsfDN+GjHVd+fNXq2/JImVhP+y5iW6AFLMxz1pMXX7EnZvOEgJIAcPkF7ZqYdxJWgxoz7iH4j4iiMlAU92twkAscJPtNbS5dp5rSI= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009737743760.093976779993; Tue, 31 May 2022 08:08:57 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-119-dqEfiEFdOHa0b5utjbUhmw-1; Tue, 31 May 2022 11:08:41 -0400 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.rdu2.redhat.com [10.11.54.2]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 1FA103C19038; Tue, 31 May 2022 15:07:28 +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 0C97640EC001; Tue, 31 May 2022 15:07:28 +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 DC5B81947064; Tue, 31 May 2022 15:07:27 +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 ECCAB194705C for ; Tue, 31 May 2022 15:07:20 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id E0A4B10725; Tue, 31 May 2022 15:07:20 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 6D4351731B for ; Tue, 31 May 2022 15:07:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009735; 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=YSbhzdF3xTHC4824DFdqQuQNWHgMN84GvPjaFPlREzA=; b=MzKHmirbfXVu3UQD4KO/GqaPZ1RHKV1V2bqEdhlfO2d/08cAa93DcBb6s1cdqSF1l8PM4a tB6r5W//HoDxNgmzhuQWp9z30SHe1AZLOR/a4bFBP8JSDQbdD5Z2uO5NriiOQS5KH8Bp3p Spx0V+7aSRit/uYNjNY9sn/BxRb7mrk= X-MC-Unique: dqEfiEFdOHa0b5utjbUhmw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 44/67] docs: formatdomain: Remove 'elementsMemory' anchor Date: Tue, 31 May 2022 17:06:19 +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.84 on 10.11.54.2 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: 1654009739469100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - docs/kbase/memorydevices.rst | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index efe20e9654..2dec27b0b1 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -7769,7 +7769,6 @@ machines and the host. :since:`Since 1.2.10, QEMU and= KVM only` the number of interrupt vectors. The ``ioeventd`` attribute enables/dis= ables (values "on"/"off", respectively) ioeventfd. -:anchor:`` Memory devices ~~~~~~~~~~~~~~ diff --git a/docs/kbase/memorydevices.rst b/docs/kbase/memorydevices.rst index 7f58a4247b..505b3b3828 100644 --- a/docs/kbase/memorydevices.rst +++ b/docs/kbase/memorydevices.rst @@ -79,7 +79,7 @@ Furthermore, DIMMs can have ```` element which c= onfigures backend for devices. For NVDIMMs the element is mandatory and reflects where the conte= nt is saved. -See `memory devices documentation <../formatdomain.html#elementsMemory>`_. +See `memory devices documentation <../formatdomain.html#memory-devices>`_. ``virtio-mem`` model =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009792; cv=none; d=zohomail.com; s=zohoarc; b=lRdYCaTC23feGLteI203OJw2ARDL9Tu+/dRvBXfOB1+YhpppMQr9Ls9dEr1h9WCkx457Y63VRalt6IuRcS2pOwpjCJ3eg/tyo0dtEcTCdcN3DroNBVxg03XgeaSNh7X5mIwk1WkAyPUizPOvlN3Z2vNs8GLDsLm388ifL6FutUM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009792; 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=+UopCeleOkc5rFNFE78T+tzSZZBG0QSy6/Uvq3colxs=; b=jSMulSwt5XomNXVuCTMN8uzaRarQkW5f/0jdanSD8jFb0ph5ROTl6tadCZsopKgbA0H6+CxBF2HlnLkV+ts/aEiKeLDgalk58bjI3WcsDDmDMg1eImadqiDiGz2Je/URsiu+7Lh5Zh3eoOHWyQkWHHUfBeK9DQno9vUO6UZtyZ0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009792695812.4870544754965; Tue, 31 May 2022 08:09:52 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-607-E5VsZxV9MY2X1n_kQAPSsQ-1; Tue, 31 May 2022 11:08:50 -0400 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.rdu2.redhat.com [10.11.54.7]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id D78D73C14CC4; Tue, 31 May 2022 15:07:23 +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 BBAF7141510E; Tue, 31 May 2022 15:07:23 +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 7BBDA1947073; Tue, 31 May 2022 15:07:23 +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 DA9D31947072 for ; Tue, 31 May 2022 15:07:21 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id C58271131A; Tue, 31 May 2022 15:07:21 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 4493310725 for ; Tue, 31 May 2022 15:07:21 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009791; 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=+UopCeleOkc5rFNFE78T+tzSZZBG0QSy6/Uvq3colxs=; b=Lm/5bnfkaLWbvER8rsrLLK6zqv4jJTHB3xZ1fxA/FmfwnuTojYcMeLVr3bnx9mFUy/UzwW rbA0S6+d9DaI6PEfecGsGlHqNtqlAiRARSur/9Im2/znbMkb4XA4k8azy4EdCaqUjYP2T3 n0eTG1n1izCp4dL2zagbhFOf4oUWPUU= X-MC-Unique: E5VsZxV9MY2X1n_kQAPSsQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 45/67] docs: formatdomain: Remove 'elementsIommu' anchor Date: Tue, 31 May 2022 17:06:20 +0200 Message-Id: <1e0daee4b219c5ebfd541a1c50891cabfa54c551.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.7 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: 1654009793745100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 2dec27b0b1..cd3dcca1cb 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -3572,7 +3572,7 @@ QEMU's virtio devices have some attributes related to= the virtio transport under the ``driver`` element: The ``iommu`` attribute enables the use of emulated IOMMU by the device. The attribute ``ats`` controls the Address Translation Service support for PCIe devices. This is needed to make use of IOTLB supp= ort -(see `IOMMU device <#elementsIommu>`__). Possible values are ``on`` or ``o= ff``. +(see `IOMMU devices`_). Possible values are ``on`` or ``off``. :since:`Since 3.5.0` The attribute ``packed`` controls if QEMU should try to use packed virtque= ues. @@ -7969,7 +7969,6 @@ Example: usage of the memory devices element is formatted into live XML and never parsed, i.e. it is output-only element. -:anchor:`` IOMMU devices ~~~~~~~~~~~~~ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009778; cv=none; d=zohomail.com; s=zohoarc; b=hsOgt42pwivhwLO/D+iE9JJ+gSMG3jHwCHu4AOJKXLjS32WB15OcDHa3y6FtnqCY8zzTwuvCL7UWLyKlkbL1m6Oe52e691Il3a/wgZMwMGbNw79vQad3WbYA67wtCxw/fPRG+IcxDNNcOQkSFj56BKPqOfj3wveCaxg0UxPyBqo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009778; 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=8EkSYJxt6aYG6gzg9dTeqJWK2KhK6VMDQBuCjov/+5Y=; b=MXCtyYkrjxy/Z0/pzlNFdqzrn9icHqwsFA+XS+oYFd8T+pEgx+ehrXSXrpEKQndY9QPYR0Bpmjb9QqpU2RMVNnV3ocBPeH+g7uQy4YG71kz2LCfSDCQvK4atPTFummI/f6qLhx5wN7R+cv9A2tBCFJNNdtYUwShYM93Pm6YIM30= 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 1654009778729354.46551513579095; Tue, 31 May 2022 08:09:38 -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-354-Gag76ePzPpGoEYYD2x2fBw-1; Tue, 31 May 2022 11:09:22 -0400 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 7EB5118812C5; Tue, 31 May 2022 15:07:36 +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 6A9F5C27E92; Tue, 31 May 2022 15:07:36 +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 E5EE61947072; Tue, 31 May 2022 15:07:35 +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 B832F194705C for ; Tue, 31 May 2022 15:07:22 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 9BBBA5F245; Tue, 31 May 2022 15:07:22 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 2B1B082892 for ; Tue, 31 May 2022 15:07:21 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009776; 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=8EkSYJxt6aYG6gzg9dTeqJWK2KhK6VMDQBuCjov/+5Y=; b=iJ5Jif+MU0NLXW1tI0bdx/xugc7DcLE95Nv2t5V9ls7AjeHvKdQBlwmwAfjJXZklBC7gKM Cl4vnnVIv8istSfmTv1I/Q154QyfsCA7QNqt4YXschWfrxzTM6MGwzHmjsLWI6649+8knK DLvqUvVsrO97icD2+6rSPg+6lkWsCOg= X-MC-Unique: Gag76ePzPpGoEYYD2x2fBw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 46/67] docs: formatdomain: Remove 'vsock' anchor Date: Tue, 31 May 2022 17:06:21 +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.85 on 10.11.54.8 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: 1654009779689100011 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index cd3dcca1cb..8e0f254236 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -8024,7 +8024,6 @@ Example: mapping larger iova addresses in the guest. :since:`Since 6.5.0` (QE= MU/KVM only) -:anchor:`` Vsock ~~~~~ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009771; cv=none; d=zohomail.com; s=zohoarc; b=YXIXSJ5OKeV9Yp1PbgEQy0aVeKK3Ue6uYZaRiIfLLITkvJ6JtqtaW1ULlIYSUnVvQ8eHHSjTU8jkOZwCtXZ1S8OzK168ECi+5nDecBDftkRDNQFN8bLYrAHKqtYaUEcnOCG3TQaSyNPQGcVuFHXqBLoKkqbwOWjNaI4Uv+d/Mrs= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009771; 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=dmRp+ODtZo4kN5XS9GQprGvsOm3RqahoqG84tgOhsAY=; b=l4OMKRv9QFc+UATO7ykycGm5HW0CVqE4rqElQxEk2055EYYQoIA5Ka5CAje+UpXWgvD11ShQi2paaQyqK+Vy/19EpizMq+RwiVf8kwbZh+6sv/ZzCBQgxScVA/wLunGNhUYuc7634FsLevzHSopDWaoJz19P4RmeoDnU/foEvxM= 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 1654009771503657.9285212846979; Tue, 31 May 2022 08:09:31 -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-644-uAfVXk4HPZ-4BpIthutZ8w-1; Tue, 31 May 2022 11:09:10 -0400 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id D569B8C195A; Tue, 31 May 2022 15:07:28 +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 C3527C27E92; Tue, 31 May 2022 15:07:28 +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 8F761194706C; Tue, 31 May 2022 15:07:28 +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 9410A1947071 for ; Tue, 31 May 2022 15:07:23 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 79E3A10725; Tue, 31 May 2022 15:07:23 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id F1A3E1131A for ; Tue, 31 May 2022 15:07:22 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009770; 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=dmRp+ODtZo4kN5XS9GQprGvsOm3RqahoqG84tgOhsAY=; b=WpZHetP75d+onvhKVsFYP6AHsNzZwHfjG+vm4+MkKVK8igRnt6zLj8cmF0yogmOTS8wDqa zaETUdssD9n35d/Wa85bXRyvA2IzUllNNBZJ9qHCNJShhdor+gFcxlb4t2h/siTxnQCSJo WPIB0D/ZhEKjF0U93hWOm2/n6SmP/C4= X-MC-Unique: uAfVXk4HPZ-4BpIthutZ8w-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 47/67] docs: formatdomain: Remove 'seclabel' anchor Date: Tue, 31 May 2022 17:06:22 +0200 Message-Id: <1c28769d3de6c826cb7378a0be6e8db4a35adb16.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.8 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: 1654009773779100001 Content-Type: text/plain; charset="utf-8" One local reference required rewording of a whole paragraph to make sense. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 10 +++++----- docs/formatsnapshot.rst | 2 +- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 8e0f254236..cffdab6eb7 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -2720,10 +2720,11 @@ paravirtualized driver is specified via the ``disk`= ` element. incremental backups and snapshots are not supported for this disk ty= pe. With "file", "block", and "volume", one or more optional sub-elements - ``seclabel``, `described below <#seclabel>`__ (and :since:`since 0.9.9`= ), - can be used to override the domain security labeling policy for just th= at - source file. (NB, for "volume" type disk, ``seclabel`` is only valid wh= en the + ``seclabel`` (See `Security label`_) can be used to override the domain + security labeling policy for just that source file. + (NB, for "volume" type disk, ``seclabel`` is only valid when the specified storage volume is of 'file' or 'block' type). + :since:`since 0.9.9` The ``source`` element may also have the ``index`` attribute with same semantics the ``index`` attribute of ``backingStore``. @@ -6280,7 +6281,7 @@ top-level element. The host interface is configured b= y the ``source`` element. The ``source`` element may contain an optional ``seclabel`` to override th= e way that labelling is done on the socket path. If this element is not present,= the -`security label is inherited from the per-domain setting <#seclabel>`__. +`Security label`_ is inherited from the per-domain setting. If the interface ``type`` presented to the host is "file", then the ``sour= ce`` element may contain an optional attribute ``append`` that specifies whethe= r or @@ -8047,7 +8048,6 @@ The optional ``driver`` element allows to specify vir= tio options, see ... -:anchor:`` Security label -------------- diff --git a/docs/formatsnapshot.rst b/docs/formatsnapshot.rst index 07aa03c0a7..085c712053 100644 --- a/docs/formatsnapshot.rst +++ b/docs/formatsnapshot.rst @@ -159,7 +159,7 @@ The top-level ``domainsnapshot`` element may contain th= e following elements: The ``source`` element also may contain the ``seclabel`` element (described in the `domain XML documentation - `__) which can be used to override the + `__) which can be used to overr= ide the domain security labeling policy for ``source``. ``driver`` --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009746; cv=none; d=zohomail.com; s=zohoarc; b=a+pdZrbQa403N7EOpPf5L9hKUj98v2fn9sU5EmKGHvuSF6d5SXQMdmfKjfGeJ/xOF9JyvvljL9tmyLt1NCf5MEcn0BScF6GJNCRVMCQEIsfy0Pw0L4Y4qyLmOcM9zyzAoPd6x9R57wBVyJiRpgyVEH+DlKIIGmCha2sDzYeCOgI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009746; 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=/Wq7u6mrf8WINak35p7iD+UtW4LlGKdFYuPaPRY75XE=; b=Yz/NDBXVIe2Q3p5QGuIdlvzvFAxH4EL2MKoxL8sw81O17RboO92nYObfT9nHXNJtEtMGeqKwjB5KPD1fLo79p99Dwv5y5RihebF2tufmCjdOTIr0yOFtIvcVDeZP+Hwh+sYIXD0MashpmQXCZUng5T0TdqTeqfNaOK0YGeKInA8= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009746238610.0748580236336; Tue, 31 May 2022 08:09:06 -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-277-ifBVURsoNEiuaoVoRKXKOg-1; Tue, 31 May 2022 11:08:43 -0400 Received: from smtp.corp.redhat.com (int-mx10.intmail.prod.int.rdu2.redhat.com [10.11.54.10]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 35D259011A4; Tue, 31 May 2022 15:07:29 +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 20C3C416362; Tue, 31 May 2022 15:07:29 +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 F30A2194706D; Tue, 31 May 2022 15:07:28 +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 6B062194705C for ; Tue, 31 May 2022 15:07:24 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 4EB6C1731B; Tue, 31 May 2022 15:07:24 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id D2FA58287E for ; Tue, 31 May 2022 15:07:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009745; 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=/Wq7u6mrf8WINak35p7iD+UtW4LlGKdFYuPaPRY75XE=; b=Ouq8cEAG3W5d7Spk7ttNMJ1TtKeykaslcHWMuMjYvKT6vvZiyEUPQjgiucWE3PTqvltsnU HB29E7u24BTpzM9qIXnraRslTCXOFOGcLTum5kSf2hi4XbRKFiz02YVkGVMmEW5TIr5ZCh Ulpnesc9QN0tDKxSipmsi0+VZEmHmYw= X-MC-Unique: ifBVURsoNEiuaoVoRKXKOg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 48/67] docs: formatdomain: Remove 'keywrap' anchor Date: Tue, 31 May 2022 17:06:23 +0200 Message-Id: <1e5a272af42d4931e3486e6ef102f8c5e7e010f7.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.10 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: 1654009747519100007 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index cffdab6eb7..97c23f6aa6 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -8142,7 +8142,6 @@ an output-only element ``labelskip`` will be present = for active domains on disks where labeling was skipped due to the image being on a file system that la= cks security labeling. -:anchor:`` Key Wrap -------- --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009815; cv=none; d=zohomail.com; s=zohoarc; b=Wzfmpo6amR8uMeTKYiI4b67ADeKzkBtNBb7E78uTh0T7wt57s9wSUtiDybWIbXWm9qg32uk+ED/6w8RdJd71pv2m7ma40XWEitBc6cHK7L5XJRuKrIkGPyLVYp0/tUDklR8sdz3md3HT4VerpwS3X0lhnKFEqoxC2jYFZFYAqns= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009815; 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=DWBfmXk3hyr4Y3J+YgycgbzHjLzD5ZY/b7OMpnEG0Xg=; b=A14wDJE6mrh/b45KzXr6BdQPbM5P34CevcXmk6HYfJtFe6oUhB+5fjsKxR1sB5bBXNKXuwnuBb9Fqh+wF00hHoO3hAEQCrYqinLZNrZDxYJkOOufC8pAbimZ02cGDrV3BEpktSHCf5Aq1DD4ilcAl7vlKdENJVl+NQoGhHqIuOE= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009815294658.3668160488908; Tue, 31 May 2022 08:10:15 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-441-XYyKyE8RPzKNT7sDDDrrnQ-1; Tue, 31 May 2022 11:08:46 -0400 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 664FF3979692; Tue, 31 May 2022 15:07:29 +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 52D9CC27E92; Tue, 31 May 2022 15:07:29 +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 1B15F1947071; Tue, 31 May 2022 15:07:29 +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 4CDA3194705C for ; Tue, 31 May 2022 15:07:25 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 2EB961731B; Tue, 31 May 2022 15:07:25 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id A537610725 for ; Tue, 31 May 2022 15:07:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009814; 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=DWBfmXk3hyr4Y3J+YgycgbzHjLzD5ZY/b7OMpnEG0Xg=; b=bR2ZEbcZiXLMobF35cxryc9/0VW2incuHG7iEM9RdcOZf5wBdXa8K82RY9vvx2xRfInxNE 7I+zmJUJGRo6BUo/cnDc+g0b7I8F7VfcYb4ToCfAmpCuICqljAprxmdeLjWwJhoGo5ysUC FMfP4afl2bXaXkt0lg0Z9X9NQBE2kUU= X-MC-Unique: XYyKyE8RPzKNT7sDDDrrnQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 49/67] docs: formatdomain: Remove 'launchSecurity' anchor Date: Tue, 31 May 2022 17:06:24 +0200 Message-Id: <2449c2538d08759a54b562ed8a3939e0a0011e23.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.8 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: 1654009815899100005 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 1 - docs/formatdomaincaps.rst | 4 ++-- docs/kbase/launch_security_sev.rst | 2 +- docs/kbase/s390_protected_virt.rst | 2 +- 4 files changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 97c23f6aa6..4868d3c397 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -8177,7 +8177,6 @@ At least one ``cipher`` element must be nested within= the ``keywrap`` element. Note: DEA/TDEA is synonymous with DES/TDES. -:anchor:`` Launch Security --------------- diff --git a/docs/formatdomaincaps.rst b/docs/formatdomaincaps.rst index 7aead08d69..1ff45da6f0 100644 --- a/docs/formatdomaincaps.rst +++ b/docs/formatdomaincaps.rst @@ -568,7 +568,7 @@ s390-pv capability Reports whether the hypervisor supports the Protected Virtualization. In o= rder to use Protected Virtualization with libvirt have a look at the `launchSec= urity -element in the domain XML `__. For more +element in the domain XML `__. For more details on the Protected Virtualization feature please see `Protected Virtualization on s390 `__. @@ -583,7 +583,7 @@ transparently encrypted with a key unique to that VM. For more details on the SEV feature, please follow resources in the AMD developer's document store. In order to use SEV with libvirt have a look a= t `SEV -in domain XML `__ +in domain XML `__ ``cbitpos`` When memory encryption is enabled, one of the physical address bits (ak= a the diff --git a/docs/kbase/launch_security_sev.rst b/docs/kbase/launch_securit= y_sev.rst index 06d1f2dad0..3ebb01ad80 100644 --- a/docs/kbase/launch_security_sev.rst +++ b/docs/kbase/launch_security_sev.rst @@ -154,7 +154,7 @@ VM Configuration =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D SEV is enabled in the XML by specifying the -` `__ +` `= __ element. However, specifying ``launchSecurity`` isn't enough to boot an SEV VM. Further configuration requirements are discussed below. diff --git a/docs/kbase/s390_protected_virt.rst b/docs/kbase/s390_protected= _virt.rst index 4cbdeea7ed..a8c627931b 100644 --- a/docs/kbase/s390_protected_virt.rst +++ b/docs/kbase/s390_protected_virt.rst @@ -128,7 +128,7 @@ As the virtio data structures of secure guests are not = accessible by the host, it is necessary to use shared memory ('bounce buffers'). Since libvirt 7.6.0 the -` `__ +` `= __ element with type ``s390-pv`` should be used on protected virtualization g= uests. Without ``launchSecurity`` you must enable all virtio devices to use shared buffers by configuring them with platform_iommu enabled. --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009774; cv=none; d=zohomail.com; s=zohoarc; b=c9IgJEtwKg/nM6o9YAom3dzWzx/3BzQJaiw25tG9Dl1WvVHTT9MHND++j+lFUA2e6dg9ZpvHhrXNe2BrM1dnMqmZkmemJeLdZC7gbNvwuj3LasXAusfqiDrZHL2nwaS+mZayRbl3yW0yBxde/zyAk8+2qdvhVN4NByxmBlSBBaY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009774; 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=UawlvuqyBKCHo7Acu3VKNIoAFYPhqlo7QG6wvxYBTLE=; b=N4VWj8fk2xeQ56sJSf+DelHh6OJrzsM1AA+k3XfUoSdphwY2Zg5lTNTQreECMWZq5hjUVWDode3qyxZimhuquZykcKTXnG6vuSf8QnKLlMRP9q7vIQAB6pZu2OcZnxRq16uwkgNElUom07u9aEwTBj0ZhPCh4QwIm1GFPGbncTc= 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 1654009774360919.0033839992658; Tue, 31 May 2022 08:09:34 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-516-r7LA3Wg3N-Grce41qYGcrQ-1; Tue, 31 May 2022 11:09:03 -0400 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.rdu2.redhat.com [10.11.54.2]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 0C79B3C0E383; Tue, 31 May 2022 15:07:40 +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 EAC5640EC001; Tue, 31 May 2022 15:07:39 +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 BCF581947062; Tue, 31 May 2022 15:07:39 +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 20486194705C for ; Tue, 31 May 2022 15:07:26 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 0420B1131A; Tue, 31 May 2022 15:07:26 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 84EB21731B for ; Tue, 31 May 2022 15:07:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009772; 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=UawlvuqyBKCHo7Acu3VKNIoAFYPhqlo7QG6wvxYBTLE=; b=JugxQnwmR2GdcY5S70F4m+luTrzB1PnvlDMAIHevKpKrR9LOHzQCqre2jg1Lbz1x+9lJYk n3q5axtFr3oozZwmmhk2/yMgtNpPPRZbXOmTYr9KHJe+P130aOEhenz6UdgAvcTxbwYI4j t1758u/hbTcYsXxj6F2yUrMRQwomoO4= X-MC-Unique: r7LA3Wg3N-Grce41qYGcrQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 50/67] docs: formatdomain: Remove the 'anchor' role Date: Tue, 31 May 2022 17:06:25 +0200 Message-Id: <2febb144ae28aeabb91d9c93b88b8df7c952a3e2.1654008136.git.pkrempa@redhat.com> 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.84 on 10.11.54.2 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: 1654009775666100003 Content-Type: text/plain; charset="utf-8" The role was used to pass through raw HTML to define custom anchor names. Since all of the document was now converted to use the anchors generated from headers we can remove it. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 4868d3c397..d27a295329 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -1,6 +1,4 @@ .. role:: since -.. role:: anchor(raw) - :format: html =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Domain XML format --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009787; cv=none; d=zohomail.com; s=zohoarc; b=ijkN2hxA5AR9yTAnT7jDzHbPWZptBYp2p/V6F2v4cWm6G8MjnOFmR7/sXchZ17in8349frUYthx33qQiUu2n3StyLvS5Qvs6FrPDXkLOHTNwOECHOV3VIk8ZmuL8H0Rk2C7nPNSdtAuDJTpW/xEmwhbaJkDy0a4VgY020jmD82c= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009787; 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=7Zrk7OUIqbl9Z+ACXifqQSJoECcivBE3CJ68Gn51Zeo=; b=UPDRwCfr3TWCcp/HPkpTdMvO2x406fe8KOcv2zSGEV1m8jTeeK0d5lgPZ18uiHRob0W2c58MhqNHaGHhTM9QnHz/CkUlcMoaN5bT1OcGTccHuzE1Ideowau5krj/HkwXTVC8XVXaJUxzH1wM/3KrGWAms4h2wmf6/3vSPaUoU44= 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 1654009787707504.23238209689146; Tue, 31 May 2022 08:09:47 -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-402-gy-LkAlbNP2DnlRgj0kdcQ-1; Tue, 31 May 2022 11:09:17 -0400 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 93DC28E314E; Tue, 31 May 2022 15:07:32 +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 6F437C27E9D; Tue, 31 May 2022 15:07:32 +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 EBCAF1947B89; Tue, 31 May 2022 15:07:31 +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 0B7D5194705C for ; Tue, 31 May 2022 15:07:27 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id E098610725; Tue, 31 May 2022 15:07:26 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 5A1BC82890 for ; Tue, 31 May 2022 15:07:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009786; 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=7Zrk7OUIqbl9Z+ACXifqQSJoECcivBE3CJ68Gn51Zeo=; b=FFg8HDmHar8FYPh4yapeIdYS3ZRuP7Re0BG0B+J8qXIWmhLbq0Y0Vr2wkMd1QHhhZif7En 3nc4CUoj7kNeueHg5OpUfX9IcyboqOiXbStl/RL+eD8qbWi+SI6S9x0vdsFMLSyP8jIMFE N58yiwaHLdqPgy7Nnd0VjTdnHyrLN7Q= X-MC-Unique: gy-LkAlbNP2DnlRgj0kdcQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 51/67] docs: formatdomain: Use local reference directly Date: Tue, 31 May 2022 17:06:26 +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.85 on 10.11.54.8 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: 1654009789740100001 Content-Type: text/plain; charset="utf-8" Once we are already using the new anchor format we can create the link via a local reference. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index d27a295329..1c446da9ca 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -6171,9 +6171,8 @@ A video device. above), since such behaviour is inconvenient in cases where GPU mediated devices are meant to be the only rendering device within a guest. If th= is is your use case specify a ``none`` type ``video`` device in the XML to= stop - the default behaviour. Refer to `Host device assignment - <#host-device-assignment>`__ to see how to add a mediated device into a - guest. + the default behaviour. Refer to `Host device assignment`_ to see how to= add + a mediated device into a guest. You can provide the amount of video memory in kibibytes (blocks of 1024 bytes) using ``vram``. This is supported only for guest type of "vz", "= qemu", --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009777; cv=none; d=zohomail.com; s=zohoarc; b=jiypdegkA3yc1kORvPRiachGyyY9zOFJME7fpvY4YBPkim2GjaILBXLVXAAG3ZSN1b4KWhqB+izn9nu0NK18kiG2aAvJU8Sjgv4x7d9cy8n+U8JRDMIZqRGsgolZQqBsfJeT54ugcCYgGY2NiFNbqUj4rH6VYw1avRGGOu77zko= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009777; 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=1jFHieklMEUGcAGwXwZZTWW+H9I5tR5EshJLckyo89E=; b=lg/v9lShI/mwvAFFthBbNUNcjLq6c8CWfR51ypV4mF9XwXlU9DL3rqcG1m5UOY5E69goP9VwTML8W7Pdzr1eKl1Hh/lKhVLP/2rp2nAjvqn3bDjkO5IUX0QL7bZ2wXevQlUAOLtLsJNWAGUm95lV7+CE8I+Bp52G8NHPout2arM= 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 1654009776998359.05846976831754; Tue, 31 May 2022 08:09:36 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-594-DeXHqMH4POWgZGV5w07Phw-1; Tue, 31 May 2022 11:09:17 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id F02583C7B151; Tue, 31 May 2022 15:07:32 +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 BBC23492CA4; Tue, 31 May 2022 15:07:32 +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 263301947B8D; Tue, 31 May 2022 15:07:32 +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 C5A99194705C for ; Tue, 31 May 2022 15:07:27 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id B981E1731B; Tue, 31 May 2022 15:07:27 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 40A6D10725 for ; Tue, 31 May 2022 15:07:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009775; 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=1jFHieklMEUGcAGwXwZZTWW+H9I5tR5EshJLckyo89E=; b=SmMxxQf4Mi1RmZREiuc6LaaO4A2s2n0myP91OE5vPNLmk+XQS64r3E41UjjH6WbCL3Ce9/ SLECS92DSRRjyhqeiNWCZwZAVWocya3jH053I6nNsIBE2WLjbrBv88otkcTB69NQP4Yklf v/EZy12iaPHvgkTxFfMSvfrfyCQUaxo= X-MC-Unique: DeXHqMH4POWgZGV5w07Phw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 52/67] docs: uri: Fix link to libvirtd configuration section Date: Tue, 31 May 2022 17:06:27 +0200 Message-Id: <5565028e5f25f356bfe467bb778a13fcfd094b54.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.9 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: 1654009777672100007 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/uri.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/uri.rst b/docs/uri.rst index 3ca3fb12c3..bfc9542260 100644 --- a/docs/uri.rst +++ b/docs/uri.rst @@ -291,7 +291,7 @@ Supported extra parameters: If set to a non-zero value, this disables client checks of the server's certificate. Note that to disable server checks of the client's certif= icate or IP address you must `change the libvirtd configuration - <#Remote_libvirtd_configuration>`__ + `__ **Example:** ``no_verify=3D1`` --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009767; cv=none; d=zohomail.com; s=zohoarc; b=SfCbp4S5nLVlZhUoZGTeDoUv5pV7MTgOypiGEGh93Zs0eRr4izLWXd23HtkjjWThEJg75ioIMDGWX0q5gY0A8HQhU9fZZjT7egpxW/PhCsTcVroMG8Ejdytjeryxpl7ClfGPy1vWj4d/UFmg1JDppNNbcHDOgEUAUO2TGobasNU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009767; 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=/vyapFC/4B1Ue5pay+wiXJRs/E0gqt/rPfbEYU9Svdo=; b=dUslhFuhVa3sx3esshBNKwJs0KanTPiYO1+58Cyz5pt+mLjIyr/e/SCG9VprOkqVwJ2NjuzD9frxFAFyIW18kP4tUZWna9W2T3GTQdLddR8xdANTsr04tOacyMjdvlulLyRHB2w6pebQboTOtwPdBG0fS5cJqEVLTpAUf6T0AsY= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009767869797.6359387244029; Tue, 31 May 2022 08:09:27 -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-407-4422wo1vNkukUZTqP5M3-A-1; Tue, 31 May 2022 11:09:05 -0400 Received: from smtp.corp.redhat.com (int-mx10.intmail.prod.int.rdu2.redhat.com [10.11.54.10]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 099F98E71FB; Tue, 31 May 2022 15:07:36 +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 E98EE492C3B; Tue, 31 May 2022 15:07:35 +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 ACD891947062; Tue, 31 May 2022 15:07:35 +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 A28061947067 for ; Tue, 31 May 2022 15:07:28 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 9703D1731B; Tue, 31 May 2022 15:07:28 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 1A3E71131A for ; Tue, 31 May 2022 15:07:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009766; 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=/vyapFC/4B1Ue5pay+wiXJRs/E0gqt/rPfbEYU9Svdo=; b=ISDdxrRlgGpxuOFfuDu8L3pyNUMh5xmrNMyE02HqrtO3dcT79xAuH4Gh2qSUXVcO5Bcs8C xy7QisCkT2VEsAuyU6DkQGK4zAxAQKvGvIGfaeJ073bIwI4IxQA8V+rRhafa2LLQpAsJy3 /E5d7go985KO6rLUdeeXR0kQC9DN3Do= X-MC-Unique: 4422wo1vNkukUZTqP5M3-A-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 53/67] syntax-check: Add check prohibiting remote reference to local file Date: Tue, 31 May 2022 17:06:28 +0200 Message-Id: <3bca7bfb20a0804ed99d552b7b959e5049e5df6c.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.10 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: 1654009769669100004 Content-Type: text/plain; charset="utf-8" Within a file we should use the internal reference syntax. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- build-aux/syntax-check.mk | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/build-aux/syntax-check.mk b/build-aux/syntax-check.mk index e8f9a91cee..649eb91acb 100644 --- a/build-aux/syntax-check.mk +++ b/build-aux/syntax-check.mk @@ -1087,6 +1087,13 @@ sc_prohibit_backup_files: { echo 'found version controlled backup file' 1>&2; \ exit 1; } || : +# prohibit remote references to local file in RST files +sc_avoid_remote_reference_to_local_file: + @prohibit=3D'<#' \ + in_vc_files=3D'\.rst$$' \ + halt=3D'use local reference within a file' \ + $(_sc_search_regexp) + # This Perl code is slightly obfuscated. Not only is each "$" doubled # because it's in a Makefile, but the $$c's are comments; we cannot # use "#" due to the way the script ends up concatenated onto one line. --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009753; cv=none; d=zohomail.com; s=zohoarc; b=hmsdZvCqmx+0aN+73IP+sPGBLQY8lXPX6cvOkQUA1hlSrDHiTEtLy0+lS9eTwZoVgsop45jrlhIlB+02x6rnI0Lq54uG7vkbqiULYIQvFWyeMcMcsvuy7otnr97l2RYqo+8I7nFgxAADi6PwYHjuwUQAs++ATq+RlPpUDBPFb90= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009753; 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=NSZDJvminr8zKXl4iga7XhxZseTnmTkjAxu9TMZ0Jgk=; b=JgLXq5gzebgzqrKakL/TU7zPbxCm4TqF1hUxtbXcOYIuiKbVkJLyWa4J+Ibzt9zwoqvuRXI+pXmVStmUjvBOhattIen5JiifGMd793d04nKF7IgAFEB9D7uNp/XUAvrB0eG01wnZZnSvtBPWKM8UjF31TjwH9WW+7KzHWncC1Go= 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 1654009752999704.0053626431127; Tue, 31 May 2022 08:09:12 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-454-tN3MU67TNTy2E2D1qFbJkw-1; Tue, 31 May 2022 11:09:01 -0400 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.rdu2.redhat.com [10.11.54.6]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id A4E873C60547; Tue, 31 May 2022 15:07:31 +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 8EFD52166B2B; Tue, 31 May 2022 15:07:31 +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 37BCB1947071; Tue, 31 May 2022 15:07:31 +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 85A421947067 for ; Tue, 31 May 2022 15:07:29 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 762AE5F245; Tue, 31 May 2022 15:07:29 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id EEC0683B90 for ; Tue, 31 May 2022 15:07:28 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009750; 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=NSZDJvminr8zKXl4iga7XhxZseTnmTkjAxu9TMZ0Jgk=; b=Oo3Fbtvx633moYFI40rshDtvPq9Rf1pOw4rGUgyHmTikyNVfsdXCRpyvGLhCThGMAjMWrU 9BZ+vlbAH5tZnQnZelUnr0cxRNmswCcsocNgyX+MZr8wFsf1DVzKl3ZT/UZkVh1CR0wOo/ v5Q+KoYFUk8t3CygWiU6OuNxd4Z3KhE= X-MC-Unique: tN3MU67TNTy2E2D1qFbJkw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 54/67] docs: page.xsl: Fix link to 'mailing-lists' section Date: Tue, 31 May 2022 17:06:29 +0200 Message-Id: <89563c8a9aa54de9720fdbd77133612e6dcde7b5.1654008136.git.pkrempa@redhat.com> 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.6 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: 1654009755560100003 Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/page.xsl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/page.xsl b/docs/page.xsl index 0a0b017482..1414d90b89 100644 --- a/docs/page.xsl +++ b/docs/page.xsl @@ -172,7 +172,7 @@ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009873; cv=none; d=zohomail.com; s=zohoarc; b=dv/q3KhI0WJqSOR10N7MwrpJK7SJEi+69KBG9Qh9L9jKoN8bhTdvrZZrN2t/i7wI4FAdIgdo1QNnrC28x2p9wAEtjW49GfHs6lJHs/2YQ3Liz39z99x6sucdjc31nmdVBRp08gvZbQC86G82gu1GaSJKLkO+IriXUBTrc4aRUYU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009873; 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=HibVxaQ3Ahi2uEun93Pv5pxRljMrgydRtQhap7FiM3w=; b=UHEiW13+GkWYnQsHAZzdIqsNkRWbZQbltFac5uwHuRPEnKpsb2CInl54e5/aSPuXZ/EGe0DKtOin6zfVTflP+75OcWeFYWxxQmZLhuxBcHSPah8WXO3gj1kBTVEjQVeR5c3gm3K34ZgAF6BfWU+3tCN9kw45GBSgbOBEjrrDhuY= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009873438396.3273116243064; Tue, 31 May 2022 08:11:13 -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-250-h-Ba5BsrPnGRGKHooVJkmA-1; Tue, 31 May 2022 11:08:40 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 68103857D56; Tue, 31 May 2022 15:07:32 +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 4EA8B492CA2; Tue, 31 May 2022 15:07:32 +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 BEA2319451EC; Tue, 31 May 2022 15:07:31 +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 6405D1947065 for ; Tue, 31 May 2022 15:07:30 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 4ADBA8287E; Tue, 31 May 2022 15:07:30 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id CB78810725 for ; Tue, 31 May 2022 15:07:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009870; 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=HibVxaQ3Ahi2uEun93Pv5pxRljMrgydRtQhap7FiM3w=; b=b5j76Fc/kvetrBlAoQH9TV9jQYXpBUlwefCFnsRAOSVESk4LZ2iEvHb0YH3lgrSUoH1pn5 CB0xZK6nrfqYxUZEvzIIocVytKgDhM7PmdeNsCQvHUbarATgEBRUzIuU7ExAB8cMM+IVTq T11mTuR6iQO0kBRp+MrLC2vtuJPKGeQ= X-MC-Unique: h-Ba5BsrPnGRGKHooVJkmA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 55/67] docs: domainstatecapture: Fix broken links Date: Tue, 31 May 2022 17:06:30 +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.85 on 10.11.54.9 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: 1654009874327100001 Content-Type: text/plain; charset="utf-8" Some links didn't exit the 'kbase/' directory and 'virDomainBackupEnd' API never existed. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/kbase/domainstatecapture.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/kbase/domainstatecapture.rst b/docs/kbase/domainstatecapt= ure.rst index cefc381d2e..204e74c18f 100644 --- a/docs/kbase/domainstatecapture.rst +++ b/docs/kbase/domainstatecapture.rst @@ -176,12 +176,12 @@ capture have these properties: contents are not also saved. Since creating an external snapshot changes which disk image resource is in use by the guest, this API can be coupled with - `virDomainBlockCommit() `__ + `virDomainBlockCommit() <../html/libvirt-libvirt-domain.html#virDomainB= lockCommit>`__ to restore things back to the guest using its original disk image, where a third-party tool can read the backing file prior to the live - commit. See also the `XML details `__ used with + commit. See also the `XML details <../formatsnapshot.html>`__ used with this command. -`virDomainFSFreeze `__= , `virDomainFSThaw `__ +`virDomainFSFreeze <../html/libvirt-libvirt-domain.html#virDomainFSFreeze>= `__, `virDomainFSThaw <../html/libvirt-libvirt-domain.html#virDomainFSThaw>= `__ This pair of APIs does not directly capture guest state, but can be used to coordinate with a trusted live guest that state capture is about to happen, and therefore guest I/O should be quiesced so that @@ -191,7 +191,7 @@ capture have these properties: to these functions. Also, note that freezing guest I/O is only possible with trusted guests running a guest agent, and that some guests place maximum time limits on how long I/O can be frozen. -`virDomainCheckpointCreateXML `__ +`virDomainCheckpointCreateXML <../html/libvirt-libvirt-domain-checkpoint.h= tml#virDomainCheckpointCreateXML>`__ This API does not actually capture guest state, rather it makes it possible to track which portions of guest disks have changed between a checkpoint and the current live execution of the guest. However, @@ -201,9 +201,9 @@ capture have these properties: at the creation of an external snapshot with ``virDomainSnapshotCreateXML2()``, since a second incremental backup is most useful when using the checkpoint created during the first. - See also the `XML details `__ used with this + See also the `XML details <../formatcheckpoint.html>`__ used with this command. -`virDomainBackupBegin `__, `virDomainBackupEnd `__ +`virDomainBackupBegin <../html/libvirt-libvirt-domain.html#virDomainBackup= Begin>`__ This API wraps approaches for capturing the state of disks of a running guest, but does not track accompanying guest memory state. The capture is consistent to the start of the operation, where the --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009871; cv=none; d=zohomail.com; s=zohoarc; b=QTqYoDyuE9vI5hYT2gvz4v0UAM8yfnexkYYW82zJYJUlmrDprKAdZ+1SBfIxUbn2mb9spXToTysSSDwpjVfczoM2PhXmEym/QZAGfc2ppGuecxyheKHgtcuKG1ylK6pQ6GVayS2oINWJteizIZgX4fUkphQm5OWLD0RETADt3g4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009871; 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=nm0Lxsp8NdUOOayVtgQBXxM8Udw3ZhkOxf0upGu2EQE=; b=NwpHRA1i7VjjyFpgqlN6SngZNK7d1GuioqszCy/R0WatEg0GUTiC0QGWJvPtFV87C9v3y9jQyTGm2rqetLyFg9C/sUAzykVR6PL+EXfNIpP5qWCCOTSb4nntMEceAMEFQJ7Y/gPSNl4PZZWPgnaGLOcR3iPIAwwXXNGRaSogArk= 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 1654009871278671.4325007987209; Tue, 31 May 2022 08:11:11 -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-307-3XVnkZHXPpa2LT3kOZAPzg-1; Tue, 31 May 2022 11:08:56 -0400 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.rdu2.redhat.com [10.11.54.7]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id DF12588B784; Tue, 31 May 2022 15:07:36 +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 CACB81410F36; Tue, 31 May 2022 15:07:36 +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 2E915194707B; Tue, 31 May 2022 15:07:36 +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 2AD8F1947065 for ; Tue, 31 May 2022 15:07:31 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 1BD051731B; Tue, 31 May 2022 15:07:31 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 960FE1131A for ; Tue, 31 May 2022 15:07:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009870; 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=nm0Lxsp8NdUOOayVtgQBXxM8Udw3ZhkOxf0upGu2EQE=; b=Cw18o+5A1PuvQXjrGnU0jlKCPZkw0+rb6MqiJFwEHBGvM/6rzw5pwJFHACbrJmzau1SeJs rAF2fGMQku1joQ7svMmFlhdKFJbjEbPD/Gdtpmg5Tr+o1mWx6ZVkcZvuxaQ5RN5o6sSC+q 5cqX1pit+2QPNnttq6kpS+VBa5MNEGE= X-MC-Unique: 3XVnkZHXPpa2LT3kOZAPzg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 56/67] docs: rpc: Fix broken headings Date: Tue, 31 May 2022 17:06:31 +0200 Message-Id: <96e71a90488bf635f54ba164c440cc0bc058b1a6.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.7 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: 1654009872235100001 Content-Type: text/plain; charset="utf-8" Remove what seems like links from some headings. This error predates the conversion to RST where an ' Reviewed-by: J=C3=A1n Tomko --- docs/kbase/internals/rpc.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/kbase/internals/rpc.rst b/docs/kbase/internals/rpc.rst index 02bc880044..d38db1410d 100644 --- a/docs/kbase/internals/rpc.rst +++ b/docs/kbase/internals/rpc.rst @@ -27,8 +27,8 @@ outstanding method. The protocol was loosely inspired by = the design of SunRPC. The definition of the RPC protocol is in the file ``src/rpc/virnetprotocol= .x`` in the libvirt source tree. -`Packet framing `__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Packet framing +~~~~~~~~~~~~~~ On the wire, there is no explicit packet framing marker. Instead each pack= et is preceded by an unsigned 32-bit integer giving the total length of the pack= et in @@ -45,8 +45,8 @@ the framing looks like this: |~ Len ~|~ Data ~|~ Len ~|~ Data ~|~ Len ~|~ Data ~|~ -`Packet data `__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Packet data +~~~~~~~~~~~ The data in each packet is split into two parts, a short fixed length head= er, followed by a variable length payload. So a packet from the illustration a= bove @@ -61,8 +61,8 @@ is more correctly shown as |~ Len ~|~ Header ~|~ Payload .... ~| -`Packet header `__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Packet header +~~~~~~~~~~~~~ The header contains 6 fields, encoded as signed/unsigned 32-bit integers. @@ -119,8 +119,8 @@ The header contains 6 fields, encoded as signed/unsigne= d 32-bit integers. #. continue: for streams this indicates that further data packets will = be following -`Packet payload `__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Packet payload +~~~~~~~~~~~~~~ The payload of a packet will vary depending on the ``type`` and ``status`` fields from the header. --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009820; cv=none; d=zohomail.com; s=zohoarc; b=hbrXOfYQjkqaSHgq02YcI3hDiRT374gkLwNSRB4QtOIAIIz2HD671hUDxHAWgtUXphSgkyDu2q1UjLish5ABXMFbBoTzq4mBtSR/itHlfhOy1PpapFdhsiQnY5p2yBvn3xg3Vq7I8B+UXWQdeufGZQUzAme9HMOjeMn+Ge1aUg0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009820; 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=y1x4Fk5mTnwRcfskmWoJSxvlHdxjlPSDPyFJjvatirA=; b=V8CxoI9htTlY2PRvXimAU7X6QocpGolpOO0W9Be2DTH7Bya2JCP9aPML7kqmfRjVB0/6TQPUlX3SjNgh6druk4nSuprdbDnOSomoq+KTXIJstcQIFpXXrnkqtfD9Np9bAtNZwTmKN5figYhoSbZQirOk1D6+ES77eZi+ByeXGsM= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009820485509.4112274864242; Tue, 31 May 2022 08:10:20 -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-650-Z_1QMQasOueKjymicGV_Ng-1; Tue, 31 May 2022 11:09:31 -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 CAB91857DEE; Tue, 31 May 2022 15:07:53 +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 B3F4F2026D64; Tue, 31 May 2022 15:07:53 +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 691751947062; Tue, 31 May 2022 15:07:53 +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 098CA1947B8D for ; Tue, 31 May 2022 15:07:32 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id E9F421131A; Tue, 31 May 2022 15:07:31 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 6BF1210725 for ; Tue, 31 May 2022 15:07:31 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009818; 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=y1x4Fk5mTnwRcfskmWoJSxvlHdxjlPSDPyFJjvatirA=; b=CI9RZDEJ7mZP6CfdJ4dXp1qCaZC+YeYn6C8HqQwIrGbm4FKOqQCHWxgDUvpdRB6ENyaY31 WJT9MBVns8Is/PrkpwXFsLqGLh8OjSNRi9nfbkZZY5Y9JtuQ21GIQFDijr9wgMA/lJXvDV koZEpH1/IKCoMbhpS/QgJHrs8nlcx64= X-MC-Unique: Z_1QMQasOueKjymicGV_Ng-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 57/67] docs: formatcaps: Fix anchors of links into formatdomain.rst Date: Tue, 31 May 2022 17:06:32 +0200 Message-Id: <9809e7a7f908367ceefa67c4a376782102d2e3ab.1654008136.git.pkrempa@redhat.com> 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: 1654009821920100001 Content-Type: text/plain; charset="utf-8" The links were broken on the initial conversion of formatdomain.html to RST which didn't faithfully forward port some of the manually added anchors. Fix it by pointing to the closest possible heading. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatcaps.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/formatcaps.rst b/docs/formatcaps.rst index abd36692e4..9d7932a6a8 100644 --- a/docs/formatcaps.rst +++ b/docs/formatcaps.rst @@ -84,20 +84,20 @@ The ```` element will typically wrap up the fol= lowing elements: Size of CPU word in bits, for example 64. ``emulator`` Emulator (device model) path, for use in - `emulator `__ element of domain X= ML. + `emulator `__ element of domain XML. ``loader`` - Loader path, for use in `loader `__ + Loader path, for use in `loader `= __ element of domain XML. ``machine`` Machine type, for use in - `machine `__ attribute of + `machine `__ attribute of os/type element in domain XML. For example Xen supports ``xenfv`` fo= r HVM, ``xenpv`` for PV, or ``xenpvh`` for PVH. ``domain`` The ``type`` attribute of this element specifies the type of hypervi= sor required to run the domain. Use in - `type `__ attribute of the do= main - root element. + `type `__ attribut= e of + the domain root element. ``features`` This optional element encases possible features that can be used with a= guest of described type. Possible subelements are: --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009767; cv=none; d=zohomail.com; s=zohoarc; b=HT1OyFDjlP2e9PCBZ6uzH02rLuC06DxZdhUnwbiCPzUjOx8iD80lI2wRIeT6sb9JCTVktkfQxN/msAHATfJJ6sO0jHl5x0bQSUzaORYyzwZxiqahS8mdVvVfhgy/TWbKYIJdB2TsmlaHUP3VLdHsXOBhwSv1A6i68C8uuHvu52o= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009767; 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=FdVbG0e6XyWjQKk8s95gpqeYeDhGns6Ipde5Qh6zrk8=; b=dDB+UQMUIbMNNQJdi7I/dPvFhOF4+Fkt8JpFNVzNYgE7wL02hDUy6zacSgNq4IvuljFSbKKXblXiPOJL7shZUE83+Gu4lFBnBxxs3lw+tXwIJYPJX9F/Ria1PC8jB71yoOYTPl3MPNGjpvuQkpPu8jrMSWy6ARm+5ZPVzv80j0k= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009767065629.2498484684633; Tue, 31 May 2022 08:09:27 -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-163-SLwb4GAzOIq21QJhTY7kSg-1; Tue, 31 May 2022 11:09:09 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 84067107B019; Tue, 31 May 2022 15:07:37 +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 6EA13492C3B; Tue, 31 May 2022 15:07:37 +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 D3DFD1947073; Tue, 31 May 2022 15:07:36 +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 CC52F1947079 for ; Tue, 31 May 2022 15:07:32 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id BAAEA10725; Tue, 31 May 2022 15:07:32 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 467461131A for ; Tue, 31 May 2022 15:07:32 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009766; 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=FdVbG0e6XyWjQKk8s95gpqeYeDhGns6Ipde5Qh6zrk8=; b=RoFb5LqSFYCYTYXxYqnnFYyylGt4+2D20m22y8/m4gjQDWlBR7NzejVSnbvTZA6NNIUPUx 8gbe+4ddDHVEjfCI1Fn0BA5z/L1bX+GyRFAZXd8WgZcBHdc3fNO/LHCrQOJ1w5xwsSn0R8 tWUrUSKfNc7DeMcG0mTkI7Z2G2WbYjg= X-MC-Unique: SLwb4GAzOIq21QJhTY7kSg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 58/67] scripts: hvsupport: Remove link into the 'html' directory Date: Tue, 31 May 2022 17:06:33 +0200 Message-Id: <0ffb2671a73be8f03a025e01fcda53f38b9a66e3.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.9 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: 1654009767645100001 Content-Type: text/plain; charset="utf-8" Linking to a list of files is not helpful. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- scripts/hvsupport.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/hvsupport.py b/scripts/hvsupport.py index 50ba25c78f..89fd0d1d94 100755 --- a/scripts/hvsupport.py +++ b/scripts/hvsupport.py @@ -426,7 +426,7 @@ print('''

    -This page documents which libvirt calls work on +This page documents which libvirt calls work on which libvirt drivers / hypervisors, and which version the API appeared in. If a hypervisor driver later dropped support for the API, the version when it was removed is also mentioned (highlighted in --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009760; cv=none; d=zohomail.com; s=zohoarc; b=NMaZi0d433Egd8Tkf2fm61JHkEF0CGnSTRYdYcmG0YciveQ8vY+Ra1AW7HubLevgh36BYY8EUuREIqxnK4mv2bDGEm9WPr0AKPsp7tHU57onwCfRZ4/HBVSADBR4UtpmFwr1pWy6gRKpKbk/lGqFTvlEx6fvWf8hIdvhXAMO3kw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009760; 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=46mjmy+I9rhZW2HaB9XgQiSLxnDbhoquRkyCcYiulJ8=; b=Psn51MWuW2LvTM77mG+/eWvn8Ep04kRIz+7GpJeYr2FQsJSCy7TVg8/p215wHDPV3ntLuKPf7PN7ymKNZ5EUYy1O1zqzn/nvBLAqlEpJAgdImNL+6IYNeAFKMow1UqA8suXfwJqre2Cx4z5Qkg0vvWWCV/GD+VQ9a9PItvj2SyQ= 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 1654009760351784.967919292401; Tue, 31 May 2022 08:09:20 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-583-giilvFmsMpqtvl_InBtJ3w-1; Tue, 31 May 2022 11:08:59 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 49E7F3C92FF0; Tue, 31 May 2022 15:07:37 +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 31F3310725; Tue, 31 May 2022 15:07:37 +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 B15521947B87; Tue, 31 May 2022 15:07:36 +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 A90EB1947064 for ; Tue, 31 May 2022 15:07:33 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 9C3855F245; Tue, 31 May 2022 15:07:33 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 1BA6B1731B for ; Tue, 31 May 2022 15:07:32 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009759; 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=46mjmy+I9rhZW2HaB9XgQiSLxnDbhoquRkyCcYiulJ8=; b=Xs1X+RMXuiLwJTr3Y9xQI7i7TiCdSOcZn01SFXtY5p4y1TNyv+lXe428wma7hZX7WlFiej MAa6tC1AO7XwZ0wAnhFcFeBI+d6nMezn6O2H4rvoVgXSdrwdDtcS+wqGk5BRxJkTI1vFXP QjrBWY6SNHVr5t5X5Xfv8cGSBTurihc= X-MC-Unique: giilvFmsMpqtvl_InBtJ3w-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 59/67] docs: Fix link to 'tlscerts' article Date: Tue, 31 May 2022 17:06:34 +0200 Message-Id: <955375b5a5e405f0928b8f57569acf1c3e7592b3.1654008136.git.pkrempa@redhat.com> 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.79 on 10.11.54.5 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: 1654009761600100001 Content-Type: text/plain; charset="utf-8" The link was not fixed when the page was moved into 'kbase/' Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/docs.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docs.rst b/docs/docs.rst index 0a698913be..9fd8b7c37e 100644 --- a/docs/docs.rst +++ b/docs/docs.rst @@ -26,7 +26,7 @@ Deployment / operation `Remote access `__ Enable remote access over TCP -`TLS certs `__ +`TLS certs `__ Generate and deploy x509 certificates for TLS `Authentication `__ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009774; cv=none; d=zohomail.com; s=zohoarc; b=kCFJTsZNk2alwagiSdE3HZdALjTVNmShVpiXbt6gNWEFxvGO1WkGrE6S7s43a1kU6UH/EGJMEhbyQUEIEG64nE2uYBnoq2N5G8hplXEHv3IFLiyn1LcPk2XUD1AV9S5/WCLBZCvLJAljvZ1hh8UwFQxozh7dtlXUnn9AuvWBd+o= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009774; 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=Xjl5oMRaep+RXAex3NwiMm8z4XorKGiidWwkuhxwcyk=; b=RMLZI8CrE6clszvGMtc+FZiUiaogNmgKV5Lztau6y3vMYcaVmQURfhFhS8jfxg8vHUvZMxn9efDvDgThT094ozh4OxfRYINc6AEcNbI6umtnGJgacabFJ2ZoeySq7Yj6WrfhL3EXGhKPKoA9XJADmBCYDUj2056TDhX3HcBlD/I= 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 1654009774605270.86290814234917; Tue, 31 May 2022 08:09:34 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-54-y7zN-6vGN1OU4TUe87gDVA-1; Tue, 31 May 2022 11:09:05 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 4D0C73815B4E; Tue, 31 May 2022 15:07:40 +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 3837F492C3B; Tue, 31 May 2022 15:07:40 +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 D2113194706A; Tue, 31 May 2022 15:07:39 +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 A47DF1947062 for ; Tue, 31 May 2022 15:07:34 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 7708E1131A; Tue, 31 May 2022 15:07:34 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id F3BFA82882 for ; Tue, 31 May 2022 15:07:33 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009773; 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=Xjl5oMRaep+RXAex3NwiMm8z4XorKGiidWwkuhxwcyk=; b=a6HpQOZLi6rYbX2wqEhp1CWMAwk0SuBZhc7PQRVAvDG3YvzItll3sgvhAEFukmfb/ciWVb QoRJZEME8jFN0Nt4tjwhM2LBA2IK8QnzqmrmpWmL8Je2Ujl+MR6Q0+cBZ3VO8ihXV/4AfT 2/UsJypHNesdVXNyopJuXXORNOLmay0= X-MC-Unique: y7zN-6vGN1OU4TUe87gDVA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 60/67] docs: Remove extra leading slash in 'api' and 'formatdomaincaps' pages Date: Tue, 31 May 2022 17:06:35 +0200 Message-Id: <19629b146a3bf80260b9367f6a5b9599846d9e25.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.9 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: 1654009775683100004 Content-Type: text/plain; charset="utf-8" While the links work they'd trip up the link validator script which will be added later. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/api.rst | 2 +- docs/formatdomaincaps.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/api.rst b/docs/api.rst index 08e5a0eed9..cdba642967 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -27,7 +27,7 @@ wise thing to do in most cases. See the `connection URI <= uri.html>`__ page for a full descriptions of the values allowed. OnDevice the application obtains a -`virConnectPtr `__ +`virConnectPtr `__ connection to the hypervisor it can then use it to manage the hypervisor's available domains and related virtualization resources, such as storage and networking. All those are exposed as first class diff --git a/docs/formatdomaincaps.rst b/docs/formatdomaincaps.rst index 1ff45da6f0..933469b2a2 100644 --- a/docs/formatdomaincaps.rst +++ b/docs/formatdomaincaps.rst @@ -18,7 +18,7 @@ more recent to support VFIO, while legacy KVM is achievab= le just fine with older qemus. The main difference between -`virConnectGetCapabilities `__ +`virConnectGetCapabilities `__ and the emulator capabilities API is, the former one aims more on the host capabilities (e.g. NUMA topology, security models in effect, etc.) while t= he latter one specializes on the hypervisor capabilities. --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009939; cv=none; d=zohomail.com; s=zohoarc; b=KLhBvjX5qHTbj0fuYTBQNyfrKdwpzjZJsw1yaRqcMM0o8FLDrSXlrFqyWSfMtsQvM3QHxKqu8O5ok6Kz/5nnRAEdipkEeRt46AKNhzeAXcO4RGQB8IIJManOfy8uEwhIOMIuuaidIdFH/p2yZDJEhgKtD1J6qS+4mBR9y+tzg+k= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009939; 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=pcdkgFypvGTuEmplQTvU5/oiiIQuJZ9fpIS6k5hvk3c=; b=Z+oBzYhtSkAKT/Ar95PleN3OAWIdKgeRuOSHTuZRrQ/J+PJh7J0cHyWqzWo8sxQgCTxBDReq3HE4+hLSKq8KVgLdAeWpyJO10DCbxxnu11g8VEUuZX7j63iukPPI/k2VeU17U+UO14AWegUhoG7Up5Bf64eKGrFKlVCQQYakoYc= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009939418972.4931726228326; Tue, 31 May 2022 08:12:19 -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-608-xo6jeihGP9WnijQK2JCYRA-1; Tue, 31 May 2022 11:09:30 -0400 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.rdu2.redhat.com [10.11.54.7]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 8FDDE18A6533; Tue, 31 May 2022 15:07:44 +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 7D0A31410F36; Tue, 31 May 2022 15:07:44 +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 4392D1947062; Tue, 31 May 2022 15:07:44 +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 707511947062 for ; Tue, 31 May 2022 15:07:35 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 4F9FA1131A; Tue, 31 May 2022 15:07:35 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id C4C9A10725 for ; Tue, 31 May 2022 15:07:34 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009937; 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=pcdkgFypvGTuEmplQTvU5/oiiIQuJZ9fpIS6k5hvk3c=; b=grG1Pf3PRwksaOIbA5/pkdJrr5Wt3UMu4G4Nch0q3ShXsjpdkghYIlSGxpZg4hAoAeedDh t7TBvN+7jUMXMWH00mto2mFI5rWd0gJN6z4N1Kws3uM1ry2cVflQu92sFqO0CYMM8WMmGy ka5OizrcSTCKQY2ULkr/ZcXgCA6Qxv8= X-MC-Unique: xo6jeihGP9WnijQK2JCYRA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 61/67] docs: Fix links in kbase/internals Date: Tue, 31 May 2022 17:06:36 +0200 Message-Id: <38824af5a80da18507e09004ea7ad46e4d51031e.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.7 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: 1654009940767100003 Content-Type: text/plain; charset="utf-8" The links were broken when the documentation was moved into the 'internals' subdirectory. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/kbase/internals/eventloop.rst | 2 +- docs/kbase/internals/migration.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/kbase/internals/eventloop.rst b/docs/kbase/internals/even= tloop.rst index f25e97ab14..856cabc85f 100644 --- a/docs/kbase/internals/eventloop.rst +++ b/docs/kbase/internals/eventloop.rst @@ -47,7 +47,7 @@ To work with event loop from our code we have plenty of A= PIs. - ``virEventRemoveTimeout``: Unregisters a timer. For more information on these APIs continue reading -`here <../html/libvirt-libvirt-event.html>`__. +`here <../../html/libvirt-libvirt-event.html>`__. Worker pool ----------- diff --git a/docs/kbase/internals/migration.rst b/docs/kbase/internals/migr= ation.rst index f7b4b5a10e..ad9d9426b2 100644 --- a/docs/kbase/internals/migration.rst +++ b/docs/kbase/internals/migration.rst @@ -7,7 +7,7 @@ Libvirt migration internals Migration is a multi-step operation with at least two distinct actors, the source and the destination libvirtd daemons, and a lot of failure points. This document describes the basic migration workflow in the -code level, as a way to complement `the base migration docs <../migration.= html>`_ +code level, as a way to complement `the base migration docs <../../migrati= on.html>`_ and help developers to get up to speed quicker with the code. In this document, unless stated otherwise, these conventions are followed: --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009785; cv=none; d=zohomail.com; s=zohoarc; b=kqMo7POmtNyzp6YdN8AbWBqJ2F6ypNk197lLoQ+ushRJG0qIANMr2bvOGeHF0ggsXOABo+DgOaZeyjzkd4vj1MnAs4eRXUemJOXuL2bTaJ/rK7sQXKm/UrnLS9AlqLfnqjlc1aaYmfCS7z6y/78lEXWkqu7HY6wfJsEwJOAe4CA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009785; 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=VktkEzvZivlC2Edw1EYPJHcLWV0jh/9bBGszUsHRujA=; b=M1r4F3vtQnYxJO40XaddUQanTCp9gVXd5i16bQxZQBxD6l8cHbJK45Zde7ysdXpwpJEMan/BLQzZR9XFIuMSZxLlfP7ioGf1ZjbvnzhCna7QWmc0QAoIlx+E8xI9q8vA14aKYHcoO5bcJlp0GfoTeFMwpn4SzToeIk8vE9yF83o= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009784994749.4863827241231; Tue, 31 May 2022 08:09:44 -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-251-KDazQgUtO2avX0NMEmg_Yg-1; Tue, 31 May 2022 11:09:27 -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 5D35D88436D; Tue, 31 May 2022 15:07:51 +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 4215B2026D64; Tue, 31 May 2022 15:07:51 +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 9E9491947070; Tue, 31 May 2022 15:07:50 +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 486E419452D2 for ; Tue, 31 May 2022 15:07:36 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 2530582882; Tue, 31 May 2022 15:07:36 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id A610710725 for ; Tue, 31 May 2022 15:07:35 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009780; 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=VktkEzvZivlC2Edw1EYPJHcLWV0jh/9bBGszUsHRujA=; b=WeWoXEt//+yf7K2iulRpd857Quwz5o4EdbHBx6E6Q5s/Qz7B4kHtM1FfF9cvJ2bEVi+pks +aMLPvqRK2XBnKpEFCHchp+l3mcTT2LAj8L98oGe90H2xGekh9xYuTpsySM/W4HbvRSUKi pTqm5LOLA2XDjcHVybV785LbTPHG5nY= X-MC-Unique: KDazQgUtO2avX0NMEmg_Yg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 62/67] docs: kbase/kvm-realtime: Fix few links Date: Tue, 31 May 2022 17:06:37 +0200 Message-Id: <0c6731176ef9961590a3e528f9a6e6c3c24f01c9.1654008136.git.pkrempa@redhat.com> 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: 1654009785887100003 Content-Type: text/plain; charset="utf-8" Certain links were missing the '../' prefix to reach files in the parent directory from the time the page was introduced. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/kbase/kvm-realtime.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/kbase/kvm-realtime.rst b/docs/kbase/kvm-realtime.rst index 890155560c..87ab314bcb 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 need= s to be +The `guest CPU model <../formatdomain.html#cpu-model-and-topology>`_ now n= eeds to be configured to pass through the host model unchanged, with topology matchin= g the placement: @@ -178,7 +178,7 @@ Memory configuration The host memory used for guest RAM needs to be allocated from huge pages o= n the second NUMA node, and all other memory allocation needs to be locked into = RAM with memory page sharing disabled. -This is achieved by using the `memory backing config `_: +This is achieved by using the `memory backing config <../formatdomain.html= #memory-backing>`_: :: --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009767; cv=none; d=zohomail.com; s=zohoarc; b=DhpCkt2pz/WLoWBDLWXLnV/VlSCl4Z5YLPlhGA8Vk1CeO08IZpQsbbE8XRknAkJmQd2F3DYbSceOYKHqCxQ91MM7doc3UvyrGpaLwXAZwFbPbGjgkYFGx2J47ccZeRVrV5XCDRcSxV+dkuTo19sdq6j81aHanaYfKTZGSG++hMA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009767; 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=jz9BDBh+3t7zt+94F/JM2VKZzQhmbFP79+lxuGT8jo4=; b=HiEzrk09caYnnP+j1r4CzxnhV65TiruZcS6i7dSK/6/5APFw1lcjHYTcFDcoLxWymnUb7JkCTf43Qa4XKsXAyfKEHvjG1wHv1CJVmSH1HeshOIwL2xzxSL5BBsYcPDaTu9+yPEzO96HrJYn1wLDyOhoEG5QIer/OgnvifxF6Dk8= 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 1654009767963921.375558453712; Tue, 31 May 2022 08:09:27 -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-358-0T5jHrplOE-vgjQ4BnK5Mg-1; Tue, 31 May 2022 11:09:06 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id EFA2F8630C0; Tue, 31 May 2022 15:07:42 +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 CF802492CA4; Tue, 31 May 2022 15:07:42 +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 8D07D1947065; Tue, 31 May 2022 15:07:42 +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 26FAD194707F for ; Tue, 31 May 2022 15:07:37 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 0479E10725; Tue, 31 May 2022 15:07:37 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 755611131A for ; Tue, 31 May 2022 15:07:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009766; 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=jz9BDBh+3t7zt+94F/JM2VKZzQhmbFP79+lxuGT8jo4=; b=ZEyV1Y0+VHVCenQuf9Oyrd9/IV65xZydbPJvc8xrkmH2pSHqOXloDyPSi81LerTOzufWdH ouj9G+7xLta7KSOSodd039KvGg4lDdkoAEsGZKhvHvbpKnLilEeqAJLfkSACXSWFLKNHX7 sv1t41NZ8mBdV7lmSICjxhTq6WDbXWQ= X-MC-Unique: 0T5jHrplOE-vgjQ4BnK5Mg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 63/67] docs: kbase/tlscerts: Fix links Date: Tue, 31 May 2022 17:06:38 +0200 Message-Id: <0604cafc2a749b737f6f92128ad287d19848ae26.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.9 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: 1654009769678100005 Content-Type: text/plain; charset="utf-8" Most of the links were broken by moving the article into kbase, but in this case we need to also fix the anchor names. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/kbase/tlscerts.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/kbase/tlscerts.rst b/docs/kbase/tlscerts.rst index 962253e853..e4aa5bb3c9 100644 --- a/docs/kbase/tlscerts.rst +++ b/docs/kbase/tlscerts.rst @@ -84,12 +84,12 @@ clients. There are two distinct checks involved: - The client should know that it is connecting to the right server. Check= ing done by client by matching the certificate that the server sends to the server's hostname. May be disabled by adding ``?no_verify=3D1`` to the = `remote - URI `__. + URI <../uri.html#tls-transport>`__. - The server should know that only permitted clients are connecting. This= can be done based on client's IP address, or on client's IP address and cli= ent's certificate. Checking done by the server. May be enabled and disabled i= n the - `libvirtd.conf file `__. + `libvirtd.conf file <../remote.html#libvirtd-configuration-file>`__. For full certificate checking you will need to have certificates issued by= a recognised `Certificate Authority @@ -99,7 +99,7 @@ CA, you can set up your own CA and tell your server(s) an= d clients to trust certificates issues by your own CA. Follow the instructions in the next se= ction. Be aware that the `default configuration for -libvirtd `__ allows any client to +libvirtd <../remote.html#libvirtd-configuration-file>`__ allows any client= to connect provided they have a valid certificate issued by the CA for their = own IP address. You may want to change this to make it less (or more) permissive, depending on your needs. @@ -180,7 +180,7 @@ for validation may be discontinued entirely, so it is s= trongly recommended to include the SAN fields. In the example below, clients will be connecting to the server using a -`URI `__ of ``qemu://compute1.libvirt.org/system``, s= o the +`URI <../uri.html#remote-uris>`__ of ``qemu://compute1.libvirt.org/system`= `, so the CN must be "``compute1.libvirt.org``". Make a private key for the server: --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009926; cv=none; d=zohomail.com; s=zohoarc; b=nuiImI+I6SlUFSC3DXbKC0JzwPbDhShaCkuQ+VFhlBIfL5dcLJLk/HhTtyv2o6sagWdVYpsJ5icL7p2inx+5J3kz9nHEt3os5ZI6EHq17579Na9mLgxAYicIBD8nc4UF2LUFjDgODJTCluynJObihbZm85yN816Cc+04FWd2q6Q= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009926; 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=OhFp+u+ZagAfGzUPhYTJqo02BvqmCvH3mPqiLycZjPQ=; b=Skm3taRRb5Y67LVZ5D8ZkfEQQowgLZFLkj/eeF5nHe+C4LyY47PukCIY5xMJa2THVMsFBFZY77FvTQYJO/Qyc/aFj24yfVu/LepxAy5aF1dYkU5N5jAGUUJXEK+xj+BO5eimMuddnvaS6YNK/DqYz0NX+w4jvkfo2CGzwv3RBPI= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009926836940.2416010555878; Tue, 31 May 2022 08:12:06 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-390-lZEJHMp2OkegSXSdXRaafw-1; Tue, 31 May 2022 11:08:48 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 06D82280186D; Tue, 31 May 2022 15:07:41 +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 E552C1731B; Tue, 31 May 2022 15:07:40 +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 A1723194707B; Tue, 31 May 2022 15:07:40 +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 EC19C194705C for ; Tue, 31 May 2022 15:07:37 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id DDC9D82892; Tue, 31 May 2022 15:07:37 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 631781131A for ; Tue, 31 May 2022 15:07:37 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009924; 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=OhFp+u+ZagAfGzUPhYTJqo02BvqmCvH3mPqiLycZjPQ=; b=FhrWwWDFtIpnM9zy2oqp7mztJt9gIo8R6pcZYXKQEAvNnBq1VLfrHgihaOkqLVcRxlNvJG zG3YZctfZIh+H+KQBWbCNdTdbX8QH98Hqh8UFZeZ8E5JM07gqdK6PB0nOCr0v+QpA+MmZ7 OB6kqT5/zeLd6GGUFTr8duBSEPWDr7o= X-MC-Unique: lZEJHMp2OkegSXSdXRaafw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 64/67] docs: remote: Fix anchor names in links to uri.html Date: Tue, 31 May 2022 17:06:39 +0200 Message-Id: <0aea5962a63173e6daf86116692ba51100b09558.1654008136.git.pkrempa@redhat.com> 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.79 on 10.11.54.5 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: 1654009928718100003 Content-Type: text/plain; charset="utf-8" When uri.html was converted to RST the 'URI remote' anchor was not fixed in remote.rst. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/remote.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/remote.rst b/docs/remote.rst index bcc394e083..ab11405d56 100644 --- a/docs/remote.rst +++ b/docs/remote.rst @@ -24,7 +24,7 @@ access the system-wide QEMU daemon, then to access the sy= stem-wide QEMU daemon on a remote machine called ``compute1.libvirt.org`` you would use ``qemu://compute1.libvirt.org/system``. -The `section on remote URIs `__ describes in more det= ail +The `section on remote URIs `__ describes in more de= tail these remote URIs. From an API point of view, apart from the change in URI, the API should be= have @@ -82,7 +82,7 @@ Remote libvirt supports a range of transports: remote side. The choice of transport is determined by the `URI -scheme `__, with ``tls`` as the default if no explicit +scheme `__, with ``tls`` as the default if no explic= it transport is requested. libvirtd configuration file --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009748; cv=none; d=zohomail.com; s=zohoarc; b=DsFDxRzHpHvZWm//gGKqodoOS8EbwsWhCdGF5yPtWffgDO8QaSl3AGwuO35lR/8d91THgGm7Hu4vWCKLNFeNtsv9swFFymPOfvafMDeNioTitaYrewlw7QJoIIbQ6jEbPIsYX2Xx0iR/EaPNW/WRhKMvg2BVVvrWWJQvGgPX+H4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009748; 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=gW7TDRHd7lGax9gbohLOunQcwPbzkRe/aqq6ymxdASs=; b=ncPpGQt1kO/uInSCYbik+0aVtil2VIo+IAJVYS/RTv2tXbRIjqljNwhqXXBIRdgyTjQ+CRH0QZBPBKingBRhMA/UzztRYtyMFQuoxZTqdQYtZxH+CizAvCHP7waSnT/HXtwI1oUepEKh4VyqzQYGRSe+KcS4dqpUhkXBPp7mpRA= 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 1654009748041520.4859784137436; Tue, 31 May 2022 08:09:08 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-272-cJLWszzYNdOJ9Blx0BfRhQ-1; Tue, 31 May 2022 11:08:56 -0400 Received: from smtp.corp.redhat.com (int-mx10.intmail.prod.int.rdu2.redhat.com [10.11.54.10]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 5F8632802B30; Tue, 31 May 2022 15:07:43 +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 478174538A4; Tue, 31 May 2022 15:07:43 +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 DB31D1947074; Tue, 31 May 2022 15:07:42 +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 E137F1947064 for ; Tue, 31 May 2022 15:07:38 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id C068110725; Tue, 31 May 2022 15:07:38 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 4257A1131A for ; Tue, 31 May 2022 15:07:38 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009746; 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=gW7TDRHd7lGax9gbohLOunQcwPbzkRe/aqq6ymxdASs=; b=HQ8835GZeGMljiiJFMWOli45zLR8h3DcWtG+w4mhtoEjHgFYx2qNeYR1nn3mOYxDVjDp4s ra7TSAiU6iwuckpfXZ1KJInH/k1CRiMwpBQfSvS7fvLpIUtaGpXIE5BOWVttFLBHuXALSj FdYnfBgm+QehJHqo9aJiD0gmd79eLlM= X-MC-Unique: cJLWszzYNdOJ9Blx0BfRhQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 65/67] uri: Fix link to qemu KVM example config Date: Tue, 31 May 2022 17:06:40 +0200 Message-Id: <1946f688c6a0fdf2b950eb92261a3b483bc132e1.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.10 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: 1654009749532100011 Content-Type: text/plain; charset="utf-8" Link into the examples of the qemu driver. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/uri.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/uri.rst b/docs/uri.rst index bfc9542260..1d2c68f5b8 100644 --- a/docs/uri.rst +++ b/docs/uri.rst @@ -121,7 +121,7 @@ So to connect to the daemon, one of two different URIs = is used: domain socket(s) that it listens on in the various different modes). KVM URIs are identical. You select between qemu, qemu accelerated and KVM = guests -in the `guest XML as described here `__. +in the `guest XML as described here `__. test:///... Test URIs ~~~~~~~~~~~~~~~~~~~~~ --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1654009991; cv=none; d=zohomail.com; s=zohoarc; b=CsUK1x/94hqe56G/jvrgNDSSWI2LC8pXFD399NxKHON+as0v0nPxnwOwfByl3dEr6tGUyGoq+FAxrljUoQWb4sfwJ8gYkP3lJ4qmuQcSZsRQCL58aWoKHVoOvYPO1Id6I98e5eSaDbQJ4XF9ipd3JKylCyKGXymzp3oJ1jsmuhU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009991; 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=8Bz38R2ptdFEZqvrFZdGGkgm5RceGqJ14fZXS5wWDqQ=; b=PeFaITj8kSWJmhE2n8NarMbcku4QYNfy3nBjSwrZskKHC0+5xmcxO9mbA1J0aYfLMXbROdm/gpG8kmF4nSjAn9r2Zw/e7jOl6ezX/L8Q5rdTEgY7YHspr6Xc2i+MIy/2tPWcBV6NdnfXGeKPlhQi/dF3MUHt7/Tt+m1HtvFlH44= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 1654009991661666.7128367594793; Tue, 31 May 2022 08:13:11 -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-340-qhroO3OZPwq9gO9mnizPug-1; Tue, 31 May 2022 11:09:17 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id F0B5D89C964; Tue, 31 May 2022 15:07:50 +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 D8020492C3B; Tue, 31 May 2022 15:07:50 +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 76AFB1947062; Tue, 31 May 2022 15:07:50 +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 A0A66194705C for ; Tue, 31 May 2022 15:07:39 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 96A511131A; Tue, 31 May 2022 15:07:39 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id 231E010725 for ; Tue, 31 May 2022 15:07:38 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009990; 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=8Bz38R2ptdFEZqvrFZdGGkgm5RceGqJ14fZXS5wWDqQ=; b=UTi4ZtEncfX9CpDEporOw39RU4qQ0xkBzUXXSJPcIKKPgFAOmP/ykbp51OE2HlWKUaht4S Ul5l68wO8daluuM4JoGtdRtvXpBwPxkx9yeW9gCkA/x+73seqpeU7kEyqrfh+uQBbOXJRv avzPXiZtbv+97r/nyJysxwbfHPHsncM= X-MC-Unique: qhroO3OZPwq9gO9mnizPug-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 66/67] docs: formatstorageencryption: Use correct anchor into formatsecret page Date: Tue, 31 May 2022 17:06:41 +0200 Message-Id: <7399061f18dd48a505bc0f520669ae7936fc13ba.1654008136.git.pkrempa@redhat.com> 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.85 on 10.11.54.9 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: 1654009993011100001 Content-Type: text/plain; charset="utf-8" The link was most likely broken when 'formatsecret' was converted to RST. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/formatstorageencryption.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/formatstorageencryption.rst b/docs/formatstorageencryptio= n.rst index 11bea53cb8..2c19473d6b 100644 --- a/docs/formatstorageencryption.rst +++ b/docs/formatstorageencryption.rst @@ -107,7 +107,7 @@ to a qemu VM using the qemu VM driver. A single Examples -------- -Assuming a `luks volume type secret `__= is +Assuming a `luks volume type secret `= __ is already defined, a simple example specifying use of the ``luks`` format for either volume creation without a specific cipher being defined or as part = of a domain volume definition: --=20 2.35.3 From nobody Sun May 12 17:04:05 2024 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=1654009775; cv=none; d=zohomail.com; s=zohoarc; b=TwhOle1Jh4wr/v3naifjABQdNBtviwzYA5r2JhMUzJVUT0bmIaxk3X3QKRzIcVeAWCA8fdT586/0+tzFVdAzKryCwb7P1BqG1Qaudu7PBTnnb2YBw5AxDbnBh7A2KaW1BUrKcfVa3Hoh6IoiVlBIE4v8NMqcM0ryiq34g3F3IhY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1654009775; 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=h9kIA8OGQ3fS/gtfAJ9n+SZo8TukTKXoqOLlbsaoIUw=; b=XNhJbcft3ghvsJP60+CPYW5NWQYd9Ero5r5kU9G3qepmQlzpzxMzl5i9wxs5d2bq43XhbV7CADumw0afO+E0sr+94WMeGLThYdoq+odpHmN7v+/hVqT9Cau27QIzscSOkbIyEmZYn4b1wrVSggin9axr8HdO2r6k1Saqskau03A= 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 1654009775860890.2396309798154; Tue, 31 May 2022 08:09:35 -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-546-i4aosXWDOruu9trMH6EAAQ-1; Tue, 31 May 2022 11:09:16 -0400 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.rdu2.redhat.com [10.11.54.6]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 60A971801398; Tue, 31 May 2022 15:07:45 +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 400A12166B26; Tue, 31 May 2022 15:07:45 +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 E8C0F194706D; Tue, 31 May 2022 15:07:44 +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 8EE99194707A for ; Tue, 31 May 2022 15:07:40 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 81BF71731B; Tue, 31 May 2022 15:07:40 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.21]) by smtp.corp.redhat.com (Postfix) with ESMTP id F10CD1131A for ; Tue, 31 May 2022 15:07:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1654009774; 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=h9kIA8OGQ3fS/gtfAJ9n+SZo8TukTKXoqOLlbsaoIUw=; b=Rx9dWnny5OhcXCFkaxf/eEyUsNPavdmCc+AUkrdZLe4YQJV5zS3NH2hutUjjXnOSSrB+Jj 6D5XdgoLwKs9g/G79FwpLDEi9YsO2Aybn5lgGIIPBHTSsenNyc9TKOgFWXF1ce/bEXKAeB 5toi5I9HOr6yO1ybPcbto7xDrE48CKw= X-MC-Unique: i4aosXWDOruu9trMH6EAAQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 67/67] docs: Add HTML reference checker Date: Tue, 31 May 2022 17:06:42 +0200 Message-Id: <46ad7f3ff1b34975a71302af5f162e6744f10573.1654008136.git.pkrempa@redhat.com> 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.6 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: 1654009777702100008 Content-Type: text/plain; charset="utf-8" In many cases we move around or rename internal anchors which may break links leading to the content. docutils handle the case of links inside a document, but we are lacking the same form of checking between documents. Introduce a script which cross-checks all the anchors and links in HTML output files and prints problems and use it as a test case for the 'docs' directory. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/meson.build | 11 +++ scripts/check-html-references.py | 153 +++++++++++++++++++++++++++++++ scripts/meson.build | 1 + 3 files changed, 165 insertions(+) create mode 100755 scripts/check-html-references.py diff --git a/docs/meson.build b/docs/meson.build index d71f6006dd..cb70ef6084 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -350,3 +350,14 @@ run_target( ], depends: install_web_deps, ) + +test( + 'check-html-references', + python3_prog, + args: [ + check_html_references_prog.path(), + '--prefix', + meson.build_root() / 'docs' + ], + env: runutf8, +) diff --git a/scripts/check-html-references.py b/scripts/check-html-referenc= es.py new file mode 100755 index 0000000000..95a61a6bb4 --- /dev/null +++ b/scripts/check-html-references.py @@ -0,0 +1,153 @@ +#!/usr/bin/env python3 +# +# This library is free software; you can redistribute it and/or +# modify it under the terms of the GNU Lesser General Public +# License as published by the Free Software Foundation; either +# version 2.1 of the License, or (at your option) any later version. +# +# This library is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public +# License along with this library. If not, see +# . +# +# Check that external references between documentation HTML files are not = broken. + +import sys +import os +import argparse +import re +import xml.etree.ElementTree as ET + +ns =3D {'html': 'http://www.w3.org/1999/xhtml'} +externallinks =3D [] + + +def get_file_list(prefix): + filelist =3D [] + + for root, dir, files in os.walk(prefix): + prefixbase =3D os.path.dirname(prefix) + + if root.startswith(prefixbase): + relroot =3D root[len(prefixbase):] + else: + relroot =3D root + + for file in files: + if not re.search('\\.html$', file): + continue + + # the 404 page doesn't play well + if '404.html' in file: + continue + + fullfilename =3D os.path.join(root, file) + relfilename =3D os.path.join(relroot, file) + filelist.append((fullfilename, relfilename)) + + return filelist + + +# loads an XHTML and extracts all anchors, local and remote links for the = one file +def process_file(filetuple): + filename, relfilename =3D filetuple + tree =3D ET.parse(filename) + root =3D tree.getroot() + + anchors =3D [relfilename] + targets =3D [] + + for elem in root.findall('.//html:a', ns): + target =3D elem.get('href') + an =3D elem.get('id') + + if an: + anchors.append(relfilename + '#' + an) + + if target: + if re.search('://', target): + externallinks.append(target) + elif target[0] !=3D '#' and 'mailto:' not in target: + dirname =3D os.path.dirname(relfilename) + targetname =3D os.path.normpath(os.path.join(dirname, targ= et)) + + targets.append((targetname, filename, target)) + + # older docutils generate "