From nobody Fri May 3 08:24:28 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.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 216.205.24.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=1604509347; cv=none; d=zohomail.com; s=zohoarc; b=BTNQD/OPS6k+VTN4gMFICPyUGS5JPQsiCzhxHhkT99PQ8UB9wS6juC4IuTTxX/WznzuFWwhZd7AOi3jr4Kjk1SbEiNFH5nqAzFLYAC6hXQFsWxF7NKq/t6cmdX09R+Eyyh716bzoULROKmLC2BZgqcO1tHcYl3lOx4U8RQ119Hc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604509347; 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=qYiGgq/+O84v1GG87efwIgXGaByNOc75F++HCWYG70I=; b=Y/S/ztV/rVWr3mJqzpiAc3KkwAEs0Hg/wYQiaTfxyw5PZKpL2lJYd7uU3h6TwJmDM+lbrFGZo55jbhpIjeXavITrd2/AxkrCisXjhg/FPTXRa5Z9TrRGzBkQS5DveY0do3AL2Gt9wUrE0dt3/ZRfwNd8IQ1WYnSV14PPfGJcGbE= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 1604509346886142.95409218097336; Wed, 4 Nov 2020 09:02:26 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-387-IE40Fk8XN3WmrntXXH5h6A-1; Wed, 04 Nov 2020 12:02:21 -0500 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id BB63E5F9D2; Wed, 4 Nov 2020 17:02:14 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 92E8A1007600; Wed, 4 Nov 2020 17:02:14 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 23A2F5811E; Wed, 4 Nov 2020 17:02:14 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 0A4H2D2s001136 for ; Wed, 4 Nov 2020 12:02:13 -0500 Received: by smtp.corp.redhat.com (Postfix) id 126216EF78; Wed, 4 Nov 2020 17:02:13 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.55]) by smtp.corp.redhat.com (Postfix) with ESMTP id 56FB26EF73 for ; Wed, 4 Nov 2020 17:02:12 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604509344; 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=qYiGgq/+O84v1GG87efwIgXGaByNOc75F++HCWYG70I=; b=I5pWFka9ayfp8bP+XgdxTIqqx+xwwGy8Y7UKY1GOX7d1sPu5W+FaRucnPmWPfxya2jU3cS duAJv0ylp+65Xa9Q860/TuqKIKR3spIZ8UYZzzQzaIr7G0ajG1Cegp9lYKBry30Oy2MXWt blPtRVqjoaubkdTg0YfYFbJVVIQH+/w= X-MC-Unique: IE40Fk8XN3WmrntXXH5h6A-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 1/9] docs: Fix title of 'docs' page Date: Wed, 4 Nov 2020 18:01:53 +0100 Message-Id: <98c774251abcc08946e0340a4815b6c8fe183fb0.1604509085.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 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) Content-Type: text/plain; charset="utf-8" XSLT transformation generates the page title from the topmost

element which is not present in 'docs.html.in'. Add it and hide it in the CSS. Signed-off-by: Peter Krempa Reviewed-by: Michal Privoznik --- docs/docs.html.in | 1 + docs/libvirt.css | 4 ++++ 2 files changed, 5 insertions(+) diff --git a/docs/docs.html.in b/docs/docs.html.in index 428a2ac974..920a773d79 100644 --- a/docs/docs.html.in +++ b/docs/docs.html.in @@ -2,6 +2,7 @@ +

Documentation

Deployment / operation

diff --git a/docs/libvirt.css b/docs/libvirt.css index 4dc9d3ac76..d323b6ec0f 100644 --- a/docs/libvirt.css +++ b/docs/libvirt.css @@ -427,6 +427,10 @@ body.index h1 { height: 300px; } +body.docs h1 { + visibility: hidden; +} + br.clear { clear: both; border: 0px; --=20 2.26.2 From nobody Fri May 3 08:24:28 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 63.128.21.124 as permitted sender) client-ip=63.128.21.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 63.128.21.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=1604509353; cv=none; d=zohomail.com; s=zohoarc; b=mv5hQhaRhaQparMv9r6qJe6DGm/b7iChJr3sdx2PvYDTvlFiXCPhdbOQ3qXjczzU7GTIZqe2j4cd+svQ0DI8MAe5WKPXi0OkgNbw1L80FjKFYVpGWYnwhy86pJoUNarkz2MKcK7CoO3ueieaJNwes3TqPxGIKIQlt9rDK2Z0j3U= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604509353; 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=MAhWWxJvGWKtsNX6ewY1qM8WsGOj+PLQ1MeoeiL1bJ4=; b=TCLKFvBy7VjGynbOtFXwprcw2ejO5LHOUFBHEwjJPKJM6rVNQDIecsCBQv1PP1bz6P6hviMaLX1vkPIETCcViVAt7VttQ7oMufMhMW1E8N2o7cpzxFJ9bl4lGAASNEog1MTdi+FIgZwP7QO7+YgXY/KfWh5UMuqhUglepPdF+5k= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 63.128.21.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [63.128.21.124]) by mx.zohomail.com with SMTPS id 1604509353040572.3317172618575; Wed, 4 Nov 2020 09:02:33 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-434-N9QbiM9fNuGXpgQRD6d3Zg-1; Wed, 04 Nov 2020 12:02:25 -0500 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 5E174804749; Wed, 4 Nov 2020 17:02:20 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 3D967702E7; Wed, 4 Nov 2020 17:02:20 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 025DD8C7AE; Wed, 4 Nov 2020 17:02:20 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 0A4H2EsM001163 for ; Wed, 4 Nov 2020 12:02:14 -0500 Received: by smtp.corp.redhat.com (Postfix) id 4A8C46EF78; Wed, 4 Nov 2020 17:02:14 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.55]) by smtp.corp.redhat.com (Postfix) with ESMTP id 81EF46EF73 for ; Wed, 4 Nov 2020 17:02:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604509350; 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=MAhWWxJvGWKtsNX6ewY1qM8WsGOj+PLQ1MeoeiL1bJ4=; b=Zbu09WXQnKHZvnveOnAPJAaSzCKLn+iR38J0KcwNkOiVcfXXVBSiJSaxA07PkUyc3PRvVC GkyPamIDe8E4xCB8vf9UzEqh7bdLQtOkh4ElRDPli0TRQ//D08euJ8dXl/7S/q+YcAa7vt R+VztBs7MQiZBfdG0V/RHDsxA1Rq8UU= X-MC-Unique: N9QbiM9fNuGXpgQRD6d3Zg-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 2/9] docs: xslt: Use 'Link' rather than 'Permalink' in header links Date: Wed, 4 Nov 2020 18:01:54 +0100 Message-Id: <8e6956c8794b629bdca4add0a6d79df559d437de.1604509085.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 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) Content-Type: text/plain; charset="utf-8" The anchors are based on the article or chapter headers, thus they are not 100% permanent. Especially with pages generated from RST. Signed-off-by: Peter Krempa Reviewed-by: Michal Privoznik --- docs/page.xsl | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/page.xsl b/docs/page.xsl index 07bfc52a4c..9e0d4e0954 100644 --- a/docs/page.xsl +++ b/docs/page.xsl @@ -194,10 +194,10 @@ - + - + --=20 2.26.2 From nobody Fri May 3 08:24:28 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.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 216.205.24.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=1604509362; cv=none; d=zohomail.com; s=zohoarc; b=U5BNh1A0SVaEQ1BzkLMOUO7w7IwXir8jQ1KgBdqCyWwdRQFb3meDr8A6y1biWBPk6MODbsg6PEDU9hP+/sZRGjGLfjppay4jYWFGOkB3AX46TrCSh6gD8Qgdp5aDYc8K5vEy8EwTd8nIcHMF3rTwXVnwBCgtIiDMPOJ2xSbsP4k= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604509362; 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=ji/Azv1KSOYWvxm/YkT9/vnTxFeoT0wWCXFlRowZZ0g=; b=j5QrxvOhl3RmFEsITLeAXqTHmc0eX7XM3WF7xgstbzMA8S8VmZwj2bl8fAc7UbaTaxTS7u7MHBTf7USX/WwUNF28y79t0jMSsz1oxLC/3mJVI5zHZfiHXujgdXCY0kSR09HApZCKx4A0MNu6Z+Rq4GJFTeyQJgqN/Va75cZw7Yw= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 1604509362349636.6290538193506; Wed, 4 Nov 2020 09:02:42 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-209-hDeO7SJ_N5WOJJiEAutL8A-1; Wed, 04 Nov 2020 12:02:37 -0500 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id EB9A1108E1B4; Wed, 4 Nov 2020 17:02:27 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id C55931007517; Wed, 4 Nov 2020 17:02:27 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 8F101181A07D; Wed, 4 Nov 2020 17:02:27 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 0A4H2Fnx001171 for ; Wed, 4 Nov 2020 12:02:15 -0500 Received: by smtp.corp.redhat.com (Postfix) id 6B18673671; Wed, 4 Nov 2020 17:02:15 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.55]) by smtp.corp.redhat.com (Postfix) with ESMTP id BA58F6EF73 for ; Wed, 4 Nov 2020 17:02:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604509359; 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=ji/Azv1KSOYWvxm/YkT9/vnTxFeoT0wWCXFlRowZZ0g=; b=WLrNs1jK32OOCWYFFSNLvzqPB2R3lhLOK4Fl08K1GZ1G4qP4ELToTIJDWlOGyELC6gl+uV 7I6OhRnY+5in5h7mq5RPW7BbD8nPCO+HDQzyiYyi1N0WYUV/BungIkOz1xv3L/3BjmJC0g ViLPJ8bETADFeqUOAhJnCIEsJlWD+Jc= X-MC-Unique: hDeO7SJ_N5WOJJiEAutL8A-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 3/9] docs: css: Add a gray box around table of contents of RST based docs Date: Wed, 4 Nov 2020 18:01:55 +0100 Message-Id: <484e180dfb3992e152d4290007aef2ccc6352760.1604509085.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 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) Content-Type: text/plain; charset="utf-8" Emphasise the table of contents visually. Signed-off-by: Peter Krempa Reviewed-by: Michal Privoznik --- docs/libvirt.css | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/libvirt.css b/docs/libvirt.css index d323b6ec0f..227b9ebed6 100644 --- a/docs/libvirt.css +++ b/docs/libvirt.css @@ -598,8 +598,13 @@ th p, td p { /* Elements with id 'contents' contain the table of contents generated by = docutils */ #contents { - margin-top: 2em; - margin-bottom: 2em; + margin-top: 1em; + margin-bottom: 1em; + background: rgb(230, 230, 230); + padding: 0.5em; + padding-left: 0px; + display: inline-block; + border: 1px solid #999999; } #contents p.topic-title { --=20 2.26.2 From nobody Fri May 3 08:24:28 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.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 216.205.24.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=1604509359; cv=none; d=zohomail.com; s=zohoarc; b=KV6LODeYnvmetGQbAAaPrFlh0gSoiVyTvt6dFPK/lLS3vJRP0v7/yhs6QsflUdtNz15hlgSzXDLx3MF3ZiKylzRPyTKnE4Mn1iGeB9YvOiwP/yVGYfTIAN42HpcUT31g2N4GROZye8ht+TpRJ5b7nRGUfmaeB1omIvcCOLKyx2A= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604509359; 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=H1Xer4WshyIaOxa9J6AF10yeM4PbT4fZ5YyO3ce7Cxk=; b=JjJOiZ2BFUvSq7FuFYW8Ae0QcV+K07s4eVMZsgdNXfHBG6vt4eICR4s49IVDYr+sNVcL/krwT3w/F0GOlY1h4t3502q4VGJPUyEO/ng7HCZ+SAv5dusCSRgFIKg2kuP3cyrQL4WnVCV0Zv7nYnFiDWFCvS/rnZHka4EL0zQjDEI= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 1604509359770763.359751609388; Wed, 4 Nov 2020 09:02:39 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-59-jNs1ZTeXOe68I4McRWbVjw-1; Wed, 04 Nov 2020 12:02:32 -0500 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 7F107108E1AF; Wed, 4 Nov 2020 17:02:23 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 563091007518; Wed, 4 Nov 2020 17:02:23 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 1D8A98C7D8; Wed, 4 Nov 2020 17:02:23 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 0A4H2GsQ001189 for ; Wed, 4 Nov 2020 12:02:16 -0500 Received: by smtp.corp.redhat.com (Postfix) id B542A73671; Wed, 4 Nov 2020 17:02:16 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.55]) by smtp.corp.redhat.com (Postfix) with ESMTP id E3BA66EF73 for ; Wed, 4 Nov 2020 17:02:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604509356; 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=H1Xer4WshyIaOxa9J6AF10yeM4PbT4fZ5YyO3ce7Cxk=; b=PzasFlJ1SjDcudv5ZvNGesIXLd4h9xnB1Q+oaKQ/8wKMcMByScJZMBpcZ1RQ0TG6QwLECo EbQ8DEhY1M6UJjJaYlMVM4ud0Ekr/nqS4f6lZWZsYi7LTSMHQZbBzg7Tz9NR2kzdmiWlm4 D/r/9hNwEpYjn3fmS9OOFBAxPTA9mcc= X-MC-Unique: jNs1ZTeXOe68I4McRWbVjw-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 4/9] docs: kbase: Move index page to docs/kbase Date: Wed, 4 Nov 2020 18:01:56 +0100 Message-Id: <8f21049c56bd7901baf1ff2c9fd778a484a25f19.1604509085.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 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) Content-Type: text/plain; charset="utf-8" Move docs/kbase.rst to docs/kbase/index.rst so that the directory itself shows our index page rather than the autogenerated list of files by the webserver. Signed-off-by: Peter Krempa Reviewed-by: Michal Privoznik --- docs/docs.html.in | 2 +- docs/index.html.in | 2 +- docs/{kbase.rst =3D> kbase/index.rst} | 32 ++++++++++++++--------------- docs/kbase/meson.build | 1 + docs/meson.build | 1 - 5 files changed, 19 insertions(+), 19 deletions(-) rename docs/{kbase.rst =3D> kbase/index.rst} (57%) diff --git a/docs/docs.html.in b/docs/docs.html.in index 920a773d79..77d5c78b30 100644 --- a/docs/docs.html.in +++ b/docs/docs.html.in @@ -126,7 +126,7 @@
Driver support
matrix of API support per hypervisor per release
-
Knowledge Base
+
Knowledge Base
Task oriented guides to key features
diff --git a/docs/index.html.in b/docs/index.html.in index 97421c5e7b..3057a052dd 100644 --- a/docs/index.html.in +++ b/docs/index.html.in @@ -64,7 +64,7 @@
Wiki
Read further community contributed content
-
Knowledge base<= /dt> +
Knowledge bas= e
Learn more about libvirt through knowledge base
diff --git a/docs/kbase.rst b/docs/kbase/index.rst similarity index 57% rename from docs/kbase.rst rename to docs/kbase/index.rst index a6de4b1a1a..cf424bd099 100644 --- a/docs/kbase.rst +++ b/docs/kbase/index.rst @@ -4,50 +4,50 @@ Knowledge base .. container:: panel widepanel - `Debug logs `__ + `Debug logs `__ Configuration of logging and tips on how to file a good bug report. - `Disk locking `__ + `Disk locking `__ Ensuring exclusive guest access to disks with - `virtlockd `__ or - `Sanlock `__ + `virtlockd `__ or + `Sanlock `__ - `Secure usage `__ + `Secure usage `__ Secure usage of the libvirt APIs - `Protected virtualization on s390 `__ + `Protected virtualization on s390 `__ Running secure s390 guests with IBM Secure Execution - `Launch security `__ + `Launch security `__ Securely launching VMs with AMD SEV - `Domain state capture `__ + `Domain state capture `__ Comparison between different methods of capturing domain state - `RPM deployment `__ + `RPM deployment `__ Explanation of the different RPM packages and illustration of which = to pick for installation - `Backing chain management `__ + `Backing chain management `__ Explanation of how disk backing chain specification impacts libvirt's behaviour and basic troubleshooting steps of disk problems. - `Security with QEMU passthrough `= __ + `Security with QEMU passthrough `__ Examination of the security protections used for QEMU and how they n= eed configuring to allow use of QEMU passthrough with host files/devices. - `Systemtap `__ + `Systemtap `__ Explanation of how to use systemtap for libvirt tracing. - `Virtio-FS `__ + `Virtio-FS `__ Share a filesystem between the guest and the host - `KVM real time `__ + `KVM real time `__ Run real time workloads in guests on a KVM hypervisor - `Incremental backup internals `__ + `Incremental backup internals `__ Incremental backup implementation details relevant for users - `VM migration internals `__ + `VM migration internals `__ VM migration implementation details, complementing the info in `migration `__ diff --git a/docs/kbase/meson.build b/docs/kbase/meson.build index c0fa72ff35..7b4e7abbd3 100644 --- a/docs/kbase/meson.build +++ b/docs/kbase/meson.build @@ -3,6 +3,7 @@ docs_kbase_files =3D [ 'debuglogs', 'domainstatecapture', 'incrementalbackupinternals', + 'index', 'kvm-realtime', 'launch_security_sev', 'locking-lockd', diff --git a/docs/meson.build b/docs/meson.build index a915d6252a..0e96123797 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -118,7 +118,6 @@ docs_rst_files =3D [ 'formatdomain', 'glib-adoption', 'hacking', - 'kbase', 'libvirt-go', 'libvirt-go-xml', 'newreposetup', --=20 2.26.2 From nobody Fri May 3 08:24:28 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 63.128.21.124 as permitted sender) client-ip=63.128.21.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 63.128.21.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=1604509359; cv=none; d=zohomail.com; s=zohoarc; b=DFlQE2mOFFwNmFPFGq4xYuq6ZA6kcYFnjyICERAmdmZ+U9QPfNObaML7UypMbrMVEG86SNQxLsfV0EaZpFaA5ly8eG79fyruIId0NDtglUTLEnodpu9qPd6CQF1AwMh82SpI3SsAzTVSm91rmqbKw+AY0zabfI5gv+yO4UpLxSE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604509359; 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=j2duBDp7lBV+bpvALdhrfwjNiccN4B1UCFYKcJfp9SA=; b=FFo6ilVgl7S8lb9sof9CfpZyq/mnwBPbBrkqObFNOlW1qwVTJOtCbJoJclPNQZOf3Vq/QtP1TGNREZXh7gAiw/fvl1lbLCNkc8al1alJ5D20DcF+OXAd5NrWCfy6QUvYRMN0mkKf5sp7y6SmoW9Kh9fdx1hLAky+bkQidyx7EYw= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 63.128.21.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [63.128.21.124]) by mx.zohomail.com with SMTPS id 1604509359197503.0372641336412; Wed, 4 Nov 2020 09:02:39 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-182-9PvACGodMNqyi7RoJoDW0Q-1; Wed, 04 Nov 2020 12:02:33 -0500 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 4C3A81868426; Wed, 4 Nov 2020 17:02:26 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id F0BFB73675; Wed, 4 Nov 2020 17:02:25 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id BEB05181A06E; Wed, 4 Nov 2020 17:02:25 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 0A4H2HB6001205 for ; Wed, 4 Nov 2020 12:02:17 -0500 Received: by smtp.corp.redhat.com (Postfix) id E8A5A73671; Wed, 4 Nov 2020 17:02:17 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.55]) by smtp.corp.redhat.com (Postfix) with ESMTP id 2B39E6EF73 for ; Wed, 4 Nov 2020 17:02:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604509356; 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=j2duBDp7lBV+bpvALdhrfwjNiccN4B1UCFYKcJfp9SA=; b=H6MlTjOb/zxvBaUPA4Kjkr4LFD5CR8n+ahjJ4vk/1GX6AM60DBOIv0c0flSL0P4caDRswL 0J1bekHZSdsFkU26Md3V+5eGe+9CPgMtO3Rfh378reXqG7EWHWoKjJPylX2eIjHxa8sJp4 BnvUvxgopwI07svFSWEnLYgCCS7S8wU= X-MC-Unique: 9PvACGodMNqyi7RoJoDW0Q-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 5/9] docs: kbase: Remove extra container from index page Date: Wed, 4 Nov 2020 18:01:57 +0100 Message-Id: <268b4b6643db363ae5d114f6bdf83e2b251d97de.1604509085.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 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) Content-Type: text/plain; charset="utf-8" The container was used to apply CSS classes to the content, so the looks are degraded. The idea is to have a similar layout to the 'docs.html' page with multiple columns, which will be added later. Signed-off-by: Peter Krempa Reviewed-by: Michal Privoznik --- docs/kbase/index.rst | 70 +++++++++++++++++++++----------------------- docs/libvirt.css | 8 ----- 2 files changed, 34 insertions(+), 44 deletions(-) diff --git a/docs/kbase/index.rst b/docs/kbase/index.rst index cf424bd099..b3e6e5461b 100644 --- a/docs/kbase/index.rst +++ b/docs/kbase/index.rst @@ -2,52 +2,50 @@ Knowledge base =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -.. container:: panel widepanel +`Debug logs `__ + Configuration of logging and tips on how to file a good bug report. - `Debug logs `__ - Configuration of logging and tips on how to file a good bug report. +`Disk locking `__ + Ensuring exclusive guest access to disks with + `virtlockd `__ or + `Sanlock `__ - `Disk locking `__ - Ensuring exclusive guest access to disks with - `virtlockd `__ or - `Sanlock `__ +`Secure usage `__ + Secure usage of the libvirt APIs - `Secure usage `__ - Secure usage of the libvirt APIs +`Protected virtualization on s390 `__ + Running secure s390 guests with IBM Secure Execution - `Protected virtualization on s390 `__ - Running secure s390 guests with IBM Secure Execution +`Launch security `__ + Securely launching VMs with AMD SEV - `Launch security `__ - Securely launching VMs with AMD SEV +`Domain state capture `__ + Comparison between different methods of capturing domain state - `Domain state capture `__ - Comparison between different methods of capturing domain state +`RPM deployment `__ + Explanation of the different RPM packages and illustration of which to + pick for installation - `RPM deployment `__ - Explanation of the different RPM packages and illustration of which = to - pick for installation +`Backing chain management `__ + Explanation of how disk backing chain specification impacts libvirt's + behaviour and basic troubleshooting steps of disk problems. - `Backing chain management `__ - Explanation of how disk backing chain specification impacts libvirt's - behaviour and basic troubleshooting steps of disk problems. +`Security with QEMU passthrough `__ + Examination of the security protections used for QEMU and how they need + configuring to allow use of QEMU passthrough with host files/devices. - `Security with QEMU passthrough `__ - Examination of the security protections used for QEMU and how they n= eed - configuring to allow use of QEMU passthrough with host files/devices. +`Systemtap `__ + Explanation of how to use systemtap for libvirt tracing. - `Systemtap `__ - Explanation of how to use systemtap for libvirt tracing. +`Virtio-FS `__ + Share a filesystem between the guest and the host - `Virtio-FS `__ - Share a filesystem between the guest and the host +`KVM real time `__ + Run real time workloads in guests on a KVM hypervisor - `KVM real time `__ - Run real time workloads in guests on a KVM hypervisor +`Incremental backup internals `__ + Incremental backup implementation details relevant for users - `Incremental backup internals `__ - Incremental backup implementation details relevant for users - - `VM migration internals `__ - VM migration implementation details, complementing the info in - `migration `__ +`VM migration internals `__ + VM migration implementation details, complementing the info in + `migration `__ diff --git a/docs/libvirt.css b/docs/libvirt.css index 227b9ebed6..1511ccf9e9 100644 --- a/docs/libvirt.css +++ b/docs/libvirt.css @@ -402,14 +402,6 @@ div.panel { background: rgb(230, 230, 230); } -div.widepanel { - width: 70em; - max-width: 95%; - margin-left: 0px; - float: left; - background: rgb(230, 230, 230); -} - div.panel h2 { margin-top: 0px; padding: 0.5em; --=20 2.26.2 From nobody Fri May 3 08:24:28 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.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 216.205.24.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=1604509393; cv=none; d=zohomail.com; s=zohoarc; b=LFR2DgO2BLRIBlGqu06DqwlaI/uRAGk0RS6JcD0uD4PJ76YQg2k2W4VEMaEzfAwfMW8QCCA69nWwKihyH1Un1Xk//WKxKtTNjWEeOE1Plo7zhD9A7QxHwmkAfMtfMalhJNIOg0EXf/kPGi5/31/tnEBkqg4Jp7pjoO+SJYzZqCo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604509393; 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=nL1peQOnDqOPKouZlVlI7RtqEPqNJAl0HkANMi9jngE=; b=dqrJE5cUO85OJq43UcYvenLZ/Cgwh0xsY5sjfKjeUl/GG1+r0C9CMQrP44+2KpjS93TA53ebXaLkwGeirLTU5Ehy99Z6UT3W+ouUIOBQ9FyvSGTOvOpyQ3FmZXoDY4JxQ1UCzjXeQTtLmsr7+TPhXdsczONQeehQn6m9fzqPT1k= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 160450939378912.216414550401396; Wed, 4 Nov 2020 09:03:13 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-456-pBRhviGuOWC664Pz03rK2Q-1; Wed, 04 Nov 2020 12:02:37 -0500 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 03145100746B; Wed, 4 Nov 2020 17:02:29 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id D636376640; Wed, 4 Nov 2020 17:02:28 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id A09838C7DE; Wed, 4 Nov 2020 17:02:28 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 0A4H2J52001223 for ; Wed, 4 Nov 2020 12:02:19 -0500 Received: by smtp.corp.redhat.com (Postfix) id 356896EF73; Wed, 4 Nov 2020 17:02:19 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.55]) by smtp.corp.redhat.com (Postfix) with ESMTP id 8795873661 for ; Wed, 4 Nov 2020 17:02:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604509390; 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=nL1peQOnDqOPKouZlVlI7RtqEPqNJAl0HkANMi9jngE=; b=jEYtJXmmmzgsz9Vdz2vK32/2fe93f0vkbgleMfSGlLBnM1oyCoFDFPzpB5om7W+RljSvKk l2lXiyLpCMCE+oMx6RiMKeCn/dfm4kvKDpoBfub3AA4VIF/pic5kPTchxUPF+nXpXbDJDO kEr/v0KZzZvwoHzlGZQ9MWGrTkUvPYk= X-MC-Unique: pBRhviGuOWC664Pz03rK2Q-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 6/9] docs: kbase: Split articles into sections Date: Wed, 4 Nov 2020 18:01:58 +0100 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 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) Content-Type: text/plain; charset="utf-8" Split the existing list of kbase articles into a 'Usage' category and into 'Internals/Debugging'. This will later represent the two columns on the web page. Signed-off-by: Peter Krempa Reviewed-by: Michal Privoznik --- docs/kbase/index.rst | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/docs/kbase/index.rst b/docs/kbase/index.rst index b3e6e5461b..f9e42f211f 100644 --- a/docs/kbase/index.rst +++ b/docs/kbase/index.rst @@ -2,8 +2,8 @@ Knowledge base =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -`Debug logs `__ - Configuration of logging and tips on how to file a good bug report. +Usage +----- `Disk locking `__ Ensuring exclusive guest access to disks with @@ -34,15 +34,21 @@ Knowledge base Examination of the security protections used for QEMU and how they need configuring to allow use of QEMU passthrough with host files/devices. -`Systemtap `__ - Explanation of how to use systemtap for libvirt tracing. - `Virtio-FS `__ Share a filesystem between the guest and the host `KVM real time `__ Run real time workloads in guests on a KVM hypervisor +Internals / Debugging +--------------------- + +`Debug logs `__ + Configuration of logging and tips on how to file a good bug report. + +`Systemtap `__ + Explanation of how to use systemtap for libvirt tracing. + `Incremental backup internals `__ Incremental backup implementation details relevant for users --=20 2.26.2 From nobody Fri May 3 08:24:28 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.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 216.205.24.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=1604509355; cv=none; d=zohomail.com; s=zohoarc; b=Jy183WF+0Ej+AxxcAxUWkItOsun0qIEBrochZCFxnz8jMAVDNFkCAXxKxlqzSdjmWJqDHOj/6GAv/VNx5jfG542skLIhaSesy49VkELMpiKXQVtEb7f0R2KimRSJUFr44rCpN1e28AwZeDAmeruVPI8i3uxu5ctdS0NQy1jXYh0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604509355; 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=sE8lKu8MJ2whzBK21jySW7BeeLZpRZDwvU9NMLEYx3Y=; b=jU1f38dA4K/75dJMIhFiNdq+nofSq9BWahxGp5JxXaUSBH2jLQ/p4+/YE1UScUd/bZOjkteROcdFt3UrMan04XkoLdEfF0H531QW8pqdp87dLtfyxTEi4gcPBarPQ3U7iIXjuPqdFNpW8gquonKnwOfgpnA9rDQW38AO7ZS3tfA= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 1604509355923691.3874935966076; Wed, 4 Nov 2020 09:02:35 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-473-FM-_qNhVNLKtiHqB8ExygQ-1; Wed, 04 Nov 2020 12:02:30 -0500 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 67E571868409; Wed, 4 Nov 2020 17:02:22 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 3FA3A6CE4F; Wed, 4 Nov 2020 17:02:22 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 04C508C7B0; Wed, 4 Nov 2020 17:02:22 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 0A4H2KJF001234 for ; Wed, 4 Nov 2020 12:02:20 -0500 Received: by smtp.corp.redhat.com (Postfix) id 577C86EF73; Wed, 4 Nov 2020 17:02:20 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.55]) by smtp.corp.redhat.com (Postfix) with ESMTP id B411073664 for ; Wed, 4 Nov 2020 17:02:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604509353; 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=sE8lKu8MJ2whzBK21jySW7BeeLZpRZDwvU9NMLEYx3Y=; b=YoFF0TmXIXrFM2HMKzXd8ZDdj0txAXk4zkDfk4TnQ6P+8BVypfaUmx4a4jY5ge92d5YX2W lwFYnGS0IoEEUw7JPghiovYlE9FuHoC0SbuuKA78MzwRYMtiudyi2+Pk1zJmFSsK0PPkkM qFWz4oSVIUjuxw0qoy0E+205luN2NBU= X-MC-Unique: FM-_qNhVNLKtiHqB8ExygQ-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 7/9] docs: xsl: Unify stylability of main container element Date: Wed, 4 Nov 2020 18:01:59 +0100 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 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) Content-Type: text/plain; charset="utf-8" page.xsl was adding '
' wrapper for the content picked up from the element from the original input file. Optionally class=3D"$DOCNAME" was added for some documents taken from . Since docs generated from RST by docutils have a '
' we actually don't need an extra wrapper for them. Additionally if we standardize on one of them we can use the same styles for both. I've picked the latter because it makes more sense to use the document name as 'id'. This patch: 1) Modifies the XSL trasformation to add the wrapper only if it's not present. 2) Modifies the XSL transformation to use 'id' for document name and class=3D'document' for the wrapper element. 3) Changes docs.html/index.html/hvsupport.html to use 'id' instead of 'class' for document name. 4) Modifies the main stylesheet to keep styling the elements properly Signed-off-by: Peter Krempa Reviewed-by: Michal Privoznik --- docs/docs.html.in | 2 +- docs/index.html.in | 2 +- docs/libvirt.css | 12 ++++++------ docs/page.xsl | 23 +++++++++++++++-------- scripts/hvsupport.py | 2 +- 5 files changed, 24 insertions(+), 17 deletions(-) diff --git a/docs/docs.html.in b/docs/docs.html.in index 77d5c78b30..22a43517ed 100644 --- a/docs/docs.html.in +++ b/docs/docs.html.in @@ -1,7 +1,7 @@ - +

Documentation

Deployment / operation

diff --git a/docs/index.html.in b/docs/index.html.in index 3057a052dd..df182c27b6 100644 --- a/docs/index.html.in +++ b/docs/index.html.in @@ -8,7 +8,7 @@ // --> - +

The virtualization API

diff --git a/docs/libvirt.css b/docs/libvirt.css index 1511ccf9e9..bb71244a7e 100644 --- a/docs/libvirt.css +++ b/docs/libvirt.css @@ -95,7 +95,7 @@ margin-right: 1em; } -#content { +.document { margin-left: auto; margin-right: auto; padding: 0px; @@ -104,9 +104,9 @@ width: 70em; } -body.index #content, -body.docs #content, -body.hvsupport #content +#index.document, +#docs.document, +#hvsupport.document { width: inherit; } @@ -412,14 +412,14 @@ div.panel h2 { text-align: center; } -body.index h1 { +#index.document h1 { border: 0px; text-indent: 100%; white-space: nowrap; overflow: hidden; background: url(logos/logo-banner-dark-800.png) no-repeat center cente= r; height: 300px; } -body.docs h1 { +#docs.document h1 { visibility: hidden; } diff --git a/docs/page.xsl b/docs/page.xsl index 9e0d4e0954..5cb4322fdc 100644 --- a/docs/page.xsl +++ b/docs/page.xsl @@ -112,15 +112,22 @@ - - - - -
-
- -
+ + + + + +
+ + + + + + +
+ +
diff --git a/scripts/hvsupport.py b/scripts/hvsupport.py index e2aab8feff..50ba25c78f 100755 --- a/scripts/hvsupport.py +++ b/scripts/hvsupport.py @@ -420,7 +420,7 @@ for drv in drivers.keys(): print(''' - +

libvirt API support matrix

    --=20 2.26.2 From nobody Fri May 3 08:24:28 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.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 216.205.24.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=1604509360; cv=none; d=zohomail.com; s=zohoarc; b=K9pT+nLBz9cxCrwuLtVPWZkjzz8nw2ucUTeLXx00Q4P27mnnSBmL82uqJkPh5wcAduRrQoY7lwBfnsjHw3Z/Ll686nVaruHefWLH5eoB49da0naBRz02SAi7AcPn0T6FGHh9sfnCNQHGouQnUjt8f5VnAMEaeXcs8dTxQ4/h0zc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604509360; 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=laNowPSTSCaQphNybeExLEJZT0ocyXglMFNIg51UgbA=; b=BiN52jbr1i+KxDWNERO0kPPYMCHPutemQVwy4RvB7VL7nsXad0G670Dx6VbQUZWoE7s3fk4la73e5r8tDFkRQhWA9gXJIFluEL5rJUNBNxKX38dmFgsdEZFKf/WE5Yf4HBe3bF6tMKiZoKnuNkFm7D8jk8ealRTeXKE5u7QFriI= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 1604509360255733.0470125694144; Wed, 4 Nov 2020 09:02:40 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-335-Zhj8aT8cO3uDkzJc2Aly5w-1; Wed, 04 Nov 2020 12:02:34 -0500 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 125EA80474C; Wed, 4 Nov 2020 17:02:28 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id E51545577D; Wed, 4 Nov 2020 17:02:27 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id AB22C181A07B; Wed, 4 Nov 2020 17:02:27 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 0A4H2QY1001264 for ; Wed, 4 Nov 2020 12:02:26 -0500 Received: by smtp.corp.redhat.com (Postfix) id E937C73664; Wed, 4 Nov 2020 17:02:26 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.55]) by smtp.corp.redhat.com (Postfix) with ESMTP id 46A9973676 for ; Wed, 4 Nov 2020 17:02:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604509357; 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=laNowPSTSCaQphNybeExLEJZT0ocyXglMFNIg51UgbA=; b=PqLeMXdeUPW9Ux3GY2lK/wKJHvxOuB40vvNf46D/h8tf+Lr+ENDEvGnx2Q09lyKMHqnuzW XAbNzCT+NASRxUtbH1Dc9uz5z5lumee8KVuaegTM78MEaml2HtaKtFtxtgbLhu3R8xOL25 5Q+ZO53wmo3GHNYvFo4sIizJf5ECj0Y= X-MC-Unique: Zhj8aT8cO3uDkzJc2Aly5w-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 8/9] docs: css: Modify appearance of the kbase directory page Date: Wed, 4 Nov 2020 18:02:00 +0100 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 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) Content-Type: text/plain; charset="utf-8" Re-style the knowledge base to look like the 'docs.html' page. We still have room to add one more column. Signed-off-by: Peter Krempa Reviewed-by: Michal Privoznik --- docs/libvirt.css | 38 ++++++++++++++++++++++++++++---------- 1 file changed, 28 insertions(+), 10 deletions(-) diff --git a/docs/libvirt.css b/docs/libvirt.css index bb71244a7e..5195588a8f 100644 --- a/docs/libvirt.css +++ b/docs/libvirt.css @@ -106,7 +106,8 @@ #index.document, #docs.document, -#hvsupport.document +#hvsupport.document, +#knowledge-base.document { width: inherit; } @@ -395,14 +396,17 @@ h6:hover > a.headerlink { visibility: visible; } -div.panel { +div.panel, +#knowledge-base .section +{ width: 24%; margin-left: 7%; float: left; background: rgb(230, 230, 230); } -div.panel h2 { +div.panel h2, +#knowledge-base .section h1 { margin-top: 0px; padding: 0.5em; padding-left: 1em; @@ -419,6 +423,11 @@ div.panel h2 { height: 300px; } +#knowledge-base.document > h1 { + text-align: center; + padding: 1em; +} + #docs.document h1 { visibility: hidden; } @@ -475,29 +484,38 @@ br.clear { font-size: smaller; } -div.panel dd { +div.panel dd, +#knowledge-base dd { font-size: smaller; } -div.panel a { +div.panel a, +#knowledge-base a { text-decoration: none; } div.panel ul, div.panel p, -div.panel dl { +div.panel dl, +#knowledge-base ul, +#knowledge-base p, +#knowledge-base dl { padding: 0.5em; margin: 0px; } - -div.panel ul { +div.panel ul, +#knowledge-base ul { margin-left: 1em; } -div.panel dt { + +div.panel dt, +#knowledge-base dt { margin: 0px; } -div.panel dd { + +div.panel dd, +#knowledge-base dd { margin: 0px; margin-bottom: 1em; } --=20 2.26.2 From nobody Fri May 3 08:24:28 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 63.128.21.124 as permitted sender) client-ip=63.128.21.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 63.128.21.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=1604509389; cv=none; d=zohomail.com; s=zohoarc; b=jmr9109/RKgLNq5kJqRfsptleozVl/cvosYJgg7nBOxtpf4GYwimwIlF8siY/3Ik/YK71RRfuG4PJRjTI+fV3TggFCszk8ImsEx6vYyRS0Nk+xVnpA+8qk0+IQs7/Mo6ZcXvWfLLRekCbsWzVXAzRW0VutLlokYCnz+gLJgILnc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604509389; 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=SBy4hM5tJeh4vPPexLGiP2sLkLIRELFOmxn9Ohl6fYc=; b=Wnz3h9K3/uNaPy7M0NEEU0oQ201xf1sHdXRGNxD58BW34AH29C7x7G+D1xJlyqGEuxBo/5Z5dUOqt7bLyuYwv/jxdiaQ8Pq+QBX9LgACFaj5u2UiO8hv8AC55X8tpT5GKHCMA5YctFq82lXs1aFTn5iwBSAmfCB1cO+hasZeba0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 63.128.21.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [63.128.21.124]) by mx.zohomail.com with SMTPS id 1604509389187935.2370939377947; Wed, 4 Nov 2020 09:03:09 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-582-6LzMMdTzO1aXlVsrtMmtrg-1; Wed, 04 Nov 2020 12:02:44 -0500 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id DAC901882FAB; Wed, 4 Nov 2020 17:02:38 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id B9DE276649; Wed, 4 Nov 2020 17:02:38 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 81E04922E1; Wed, 4 Nov 2020 17:02:38 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 0A4H2aqi001316 for ; Wed, 4 Nov 2020 12:02:36 -0500 Received: by smtp.corp.redhat.com (Postfix) id 7F4EE73675; Wed, 4 Nov 2020 17:02:36 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.55]) by smtp.corp.redhat.com (Postfix) with ESMTP id C93FD7366D for ; Wed, 4 Nov 2020 17:02:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1604509386; 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=SBy4hM5tJeh4vPPexLGiP2sLkLIRELFOmxn9Ohl6fYc=; b=hbyHJ8hAkCSjhFh660jK0wBkzZyZaB/K5QcQNLGYXY3wDn72ACPPqchtSHLY6RXdu4IoVU R86cEtCHUbLohsJRvSCGSiOg1ALMk8Y5rJaJuUltyjfx26V15c7VivMCRlN2MCuNi8s+7R uaF+dpA6ph/+VLCREVIl1LxMRO6BTA4= X-MC-Unique: 6LzMMdTzO1aXlVsrtMmtrg-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 9/9] docs: kbase: Reorder some articles in the 'Usage' section Date: Wed, 4 Nov 2020 18:02:01 +0100 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 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) Content-Type: text/plain; charset="utf-8" Historically we've added them in chronological order, but certain articles are more likely to be needed and thus are easier to find when placed earlier. Signed-off-by: Peter Krempa Reviewed-by: Michal Privoznik --- docs/kbase/index.rst | 38 +++++++++++++++++++------------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/kbase/index.rst b/docs/kbase/index.rst index f9e42f211f..1494be1e77 100644 --- a/docs/kbase/index.rst +++ b/docs/kbase/index.rst @@ -5,37 +5,37 @@ Knowledge base Usage ----- -`Disk locking `__ - Ensuring exclusive guest access to disks with - `virtlockd `__ or - `Sanlock `__ - `Secure usage `__ Secure usage of the libvirt APIs -`Protected virtualization on s390 `__ - Running secure s390 guests with IBM Secure Execution +`Backing chain management `__ + Explanation of how disk backing chain specification impacts libvirt's + behaviour and basic troubleshooting steps of disk problems. -`Launch security `__ - Securely launching VMs with AMD SEV +`Virtio-FS `__ + Share a filesystem between the guest and the host -`Domain state capture `__ - Comparison between different methods of capturing domain state +`Security with QEMU passthrough `__ + Examination of the security protections used for QEMU and how they need + configuring to allow use of QEMU passthrough with host files/devices. `RPM deployment `__ Explanation of the different RPM packages and illustration of which to pick for installation -`Backing chain management `__ - Explanation of how disk backing chain specification impacts libvirt's - behaviour and basic troubleshooting steps of disk problems. +`Domain state capture `__ + Comparison between different methods of capturing domain state -`Security with QEMU passthrough `__ - Examination of the security protections used for QEMU and how they need - configuring to allow use of QEMU passthrough with host files/devices. +`Disk locking `__ + Ensuring exclusive guest access to disks with + `virtlockd `__ or + `Sanlock `__ -`Virtio-FS `__ - Share a filesystem between the guest and the host +`Protected virtualization on s390 `__ + Running secure s390 guests with IBM Secure Execution + +`Launch security `__ + Securely launching VMs with AMD SEV `KVM real time `__ Run real time workloads in guests on a KVM hypervisor --=20 2.26.2