From nobody Mon Feb 9 01:48:29 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1605192380; cv=none; d=zohomail.com; s=zohoarc; b=hCzHPJJ1GnSyJxu36u4HeD7vgfqKvb3FD+7vO8vDFBbFrGqpDvBdR2H+KOgu6KofKB3zkuuTDltXZS9UgQYHsbMNzOSFCo5dDGO0X6jQoDVCAKL/qR8BRr8nGYZTeWDIurJpOoAYWcAywuwJywlzySQJc5F554OFuPXU7yWBvLk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1605192380; h=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=V+stoGXl5pH8LG31JpJmltTs9u1xWs1fd+r4U8owOUA=; b=aXgzy7rYY7q1oG+fd5y/If68ESJ9N8mBHxMBsInXaZ0y9EfjkjkM+CYd/8UbSbSpLsKr3GXvUtRiMvBdrwwuEjYhU2fZipfM8Y5XONlU9X/YMuX48xIWTkmTcP899tjbNEYDRlCJQv88FpYnzE37OZiNunoN9ex2cF9pbq7O7hI= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1605192380765745.1903111249162; Thu, 12 Nov 2020 06:46:20 -0800 (PST) Received: from localhost ([::1]:43008 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kdDrf-000621-4r for importer@patchew.org; Thu, 12 Nov 2020 09:46:19 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:39452) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kdDmL-0000Yo-Dc for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:49 -0500 Received: from mail-wr1-x432.google.com ([2a00:1450:4864:20::432]:38291) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kdDmJ-0003jr-25 for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:49 -0500 Received: by mail-wr1-x432.google.com with SMTP id p8so6257160wrx.5 for ; Thu, 12 Nov 2020 06:40:46 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id k16sm7410907wrl.65.2020.11.12.06.40.43 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 06:40:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=V+stoGXl5pH8LG31JpJmltTs9u1xWs1fd+r4U8owOUA=; b=tx4DOkCb4f/Bn0M5xiQFW/e5NcncNJldDC3nJTuhPyu9BlKNBI4nWTwsomEiGlL20a uwAOKAqIyVKiXkMSXh084K5kJptPsPRqEu5Of4yJYhhaIURf7sa+u/gIj07NfQH4riZe RMSz7rHQrn2/zKm9EdAx6Jm3rqJrj3zU+9Nl6pB78geqc4nUK/wBS/VWLebI4vIcUBXK l0N2Q2PjLeRKr/NAq8MQFfDtVFNYw+9F4M479ToAGqWsXkCR6i/RGeB3JzVp6XFvTuJx HuB54rLXv7590HLQ9SwowVISLcPF8EhKeA0YPBcDVnwksKHfexMu9PUdeb0tLcyEc/VD WVew== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=V+stoGXl5pH8LG31JpJmltTs9u1xWs1fd+r4U8owOUA=; b=VZbG7qfotKSTVmorKPp7AE/o+w2xxT1H70AHf4v4kc2SAPxV1xQbLRMOZlFK1d33gf wGFsFZaj3hfNIWgszTqrNXcI4hU6dqzS1aHM4DGRLGv/8AqoI0L8i+FMLpLuxpc7ERaN HkS5qrGbe+gPBeEC5olmiJ8QNsKWaplG07ubO9M6dJD+xvDjKtzbMYZ0wcDGsNKB5z70 lkEaGS45+j6+2k8HBfvGQ2uCoqBWtnJH1+aRaEQi+piMilVk2Axk2Hh469NS+RKoAEIm ydSwoHgT2bwUeI0VbakgL/4cLlJBcsyW+3UkXbbP4cT+Mx0zjJSKQiHNh5tnV3JcL6db 2Nlw== X-Gm-Message-State: AOAM5300bLQ1E9IStrKaEm5zmXUpxXu4K5iHL7pl+A4NWfxV22X1jZbF KRCHAJde6asOEF10wfPebo4N2oSkpMJ1gQ== X-Google-Smtp-Source: ABdhPJyPHzhK094hfLh23NtpDwVyZ2tKQWff+MrrVP0c7f4bh7LsI++hyipVm9JznAcTpBChT+sYlg== X-Received: by 2002:adf:e544:: with SMTP id z4mr2248617wrm.83.1605192045075; Thu, 12 Nov 2020 06:40:45 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [for-5.2 1/9] docs: Move virtio-net-failover.rst into the system manual Date: Thu, 12 Nov 2020 14:40:33 +0000 Message-Id: <20201112144041.32278-2-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20201112144041.32278-1-peter.maydell@linaro.org> References: <20201112144041.32278-1-peter.maydell@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::432; envelope-from=peter.maydell@linaro.org; helo=mail-wr1-x432.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @linaro.org) Content-Type: text/plain; charset="utf-8" The virtio-net-failover documentation is currently orphan and not included in any manual; move it into the system manual, immediately following the general network emulation section. Signed-off-by: Peter Maydell Reviewed-by: Alex Benn=C3=A9e --- docs/system/index.rst | 1 + docs/{ =3D> system}/virtio-net-failover.rst | 0 2 files changed, 1 insertion(+) rename docs/{ =3D> system}/virtio-net-failover.rst (100%) diff --git a/docs/system/index.rst b/docs/system/index.rst index c0f685b818e..d0613cd5f72 100644 --- a/docs/system/index.rst +++ b/docs/system/index.rst @@ -21,6 +21,7 @@ Contents: monitor images net + virtio-net-failover usb ivshmem linuxboot diff --git a/docs/virtio-net-failover.rst b/docs/system/virtio-net-failover= .rst similarity index 100% rename from docs/virtio-net-failover.rst rename to docs/system/virtio-net-failover.rst --=20 2.20.1 From nobody Mon Feb 9 01:48:29 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1605192382; cv=none; d=zohomail.com; s=zohoarc; b=nqtV7hOE2Ki2He/4S9kBoCPwmU4XwptBHI3cA0lqMBKE8kTxFuCI32nihG3Wmn0qz2DQOfGsw2Z3RVaeKo53i7ok7NzJTWATrTn/Zsp87oJetylUlCxurAkql3sh9nXQtOEaEzZMojVX4f7otEDi2E2cSjKITP6NPR1Nzi2PXaI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1605192382; h=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=IgyBRSdkiFG9Ecsso5QqbbzLRg/ym4sdq7093XNdiVY=; b=T1n6I4ABPIry1tEPyGDjruNbTN8Jtd+/Jv6KBfbKYPaDH4UxbwZtg3ycPrpZAkm/8Tb0/BnN2I8qgr34Ph+/0gXGWquRd6vGstzGJIjIyvWHecTa9d2ELDr9FJjEQs4M/apmHN9bxshwejYjSEcebGrNC9Ecd1BeMGp8Qtr7EWU= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1605192382480122.04721546997996; Thu, 12 Nov 2020 06:46:22 -0800 (PST) Received: from localhost ([::1]:43172 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kdDrg-000665-Uv for importer@patchew.org; Thu, 12 Nov 2020 09:46:20 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:39476) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kdDmN-0000ci-90 for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:51 -0500 Received: from mail-wm1-x335.google.com ([2a00:1450:4864:20::335]:53210) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kdDmK-0003kQ-1R for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:50 -0500 Received: by mail-wm1-x335.google.com with SMTP id 10so5483570wml.2 for ; Thu, 12 Nov 2020 06:40:47 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id k16sm7410907wrl.65.2020.11.12.06.40.45 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 06:40:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=IgyBRSdkiFG9Ecsso5QqbbzLRg/ym4sdq7093XNdiVY=; b=O31HsXlMzvd3BqVdh+gqX/ImH8vHauNhSMvDYOCz8UZkYVLuRTEDaLJg2qaYY7tUrF BX0uowVHyBrBxHcl3qc7m7QVx7jWy6PY4AHQtgluDPHbzve9xoIYxoflqWUpTOTm80n6 RodVXZZnpUaDPOlE6Nq5mNlMyT4eg0XSjxEyXHEawO0G6fxHvp8ivvzNiPNForiOkBbp 8ejaEZJBAU1M2TiV1AN6PYpDQWXfIrNRYoXMxJBjCNpjfhpJfe/3gciV0RVaIgpJMrCw OLo2afwslmfE3UweeNi4EjM5SGUsCQd2j31TunvE9cfQrV6h3urxa2Uux8q7djJLGXVh qSlw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=IgyBRSdkiFG9Ecsso5QqbbzLRg/ym4sdq7093XNdiVY=; b=YK+cvTkjAX+RGKH0IOhfcJw1g7aW8Svw6gLb+Oz+JmfVy6V/NDwHNvARbu6eAwT0KZ 0kroUtxqqy3b/UStQji60ArJQZiqKOIyrkAZx3un/y9SCG1XTPgtp9AwCkC+SiPJgC2W 5nKLRKrV3Yc4poYRMBabSvblAqdAAAulVHewYzzS8n73aRYOnYyKVG09rUD+NOhdah8P k6i1y4GYlNWrckrFDsElsaFY9QwLQnSCJPJnV/I0od9NwSk18rFfj8S42rL+6AgA8aS1 4/xGUWZPrwY436pvWATEGXkLKK7BxWhgyEE+sy5ik3cz8m8PMoeU1l+bjT+2FsWiXnwM eYPw== X-Gm-Message-State: AOAM530o7l+nZc6eict1r8Knw4naHgL6EtUiRANJXKruy6bcxv8DUuHy QeCJwbww2P1J4jK/uq9CFPSXJ+HQ/oiNgA== X-Google-Smtp-Source: ABdhPJxhFL1vXf9z3Y8IKGyoB10IKCYcojtE7pTdU+NL5LUc7U+7BfouRswWrurNtYKV2Q74hfAsDQ== X-Received: by 2002:a1c:9ad3:: with SMTP id c202mr19786wme.43.1605192046246; Thu, 12 Nov 2020 06:40:46 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [for-5.2 2/9] docs: Move cpu-hotplug.rst into the system manual Date: Thu, 12 Nov 2020 14:40:34 +0000 Message-Id: <20201112144041.32278-3-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20201112144041.32278-1-peter.maydell@linaro.org> References: <20201112144041.32278-1-peter.maydell@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::335; envelope-from=peter.maydell@linaro.org; helo=mail-wm1-x335.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @linaro.org) Content-Type: text/plain; charset="utf-8" The cpu-hotplug.rst documentation is currently orphan and not included in any manual; move it into the system manual. Signed-off-by: Peter Maydell Reviewed-by: Alex Benn=C3=A9e --- docs/{ =3D> system}/cpu-hotplug.rst | 0 docs/system/index.rst | 1 + 2 files changed, 1 insertion(+) rename docs/{ =3D> system}/cpu-hotplug.rst (100%) diff --git a/docs/cpu-hotplug.rst b/docs/system/cpu-hotplug.rst similarity index 100% rename from docs/cpu-hotplug.rst rename to docs/system/cpu-hotplug.rst diff --git a/docs/system/index.rst b/docs/system/index.rst index d0613cd5f72..0f0f6d2e99d 100644 --- a/docs/system/index.rst +++ b/docs/system/index.rst @@ -29,6 +29,7 @@ Contents: tls gdb managed-startup + cpu-hotplug targets security deprecated --=20 2.20.1 From nobody Mon Feb 9 01:48:29 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1605192155; cv=none; d=zohomail.com; s=zohoarc; b=ZZeba8UaR1m2LNc93cvLPdKvF5Khea9MMBrrqg0O14UUJyLNK0TGYrhdnLofggkvrwqJq7yloSI63LAtw3fc8kU3rqz6edj8BBsRstm3kDV8Yh4cuXzT8rC4HLwbHQZo3mpBzzr2TQGrOXru4V/KhKqjbTg2Qmd8NlyCMlm8YOA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1605192155; h=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=WO2TnVWc1Q9F5TmaPlTFZN+oBdLDREUOz0RVU/FUiHk=; b=K1XmuyXwIazN/NUGliRaZIL+O5sEUUrNRn641rRcjZc0cJObYA3b0guKWl2VViy/nsmVrqkCqqToDt1P1zXIzBbYKPBM6g3Di27ntHIX5h30kDGvK9Q0npktfmEJMME1OLTdoxwWY5/XUlTYp+0pZmsAd3jO3w+GpJexFq7Ap+0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1605192155525762.4141913442115; Thu, 12 Nov 2020 06:42:35 -0800 (PST) Received: from localhost ([::1]:34694 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kdDo2-0002Ke-Da for importer@patchew.org; Thu, 12 Nov 2020 09:42:34 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:39470) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kdDmM-0000bk-Or for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:50 -0500 Received: from mail-wr1-x433.google.com ([2a00:1450:4864:20::433]:40660) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kdDmL-0003kt-3H for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:50 -0500 Received: by mail-wr1-x433.google.com with SMTP id 33so6241584wrl.7 for ; Thu, 12 Nov 2020 06:40:48 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id k16sm7410907wrl.65.2020.11.12.06.40.46 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 06:40:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=WO2TnVWc1Q9F5TmaPlTFZN+oBdLDREUOz0RVU/FUiHk=; b=Q7dUax8o74RPpb8q1tnkm9aQ9AlQAy7ESYpat2SoZ81RlLOVaTw6Rt93hbAdzHagR7 /VTQx9r73tYIirIvuc+vt2/ZF30rk1Bm53V0s8ZilYYggd0rWll6JTam5gTAutJVxghU JXk8n5VZw7j+me92993h/o5GCQG1v9K5gme84SFF+NG+cAxBT5lLwkTNWe+Sr1+u4Yio lUk18h6smcCrT0YZY8pj+/ThF9SVxKTo5pwa8nDWjfZCyN9y+9MzkdSeCCa6+5NdhbJh Gl/8a4xcKB3lnBoZvi4Ib7t3opKSb8D7wS8j6v77K2x/jISxu63YJm8wqSkil9Eg+2+z LF5A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=WO2TnVWc1Q9F5TmaPlTFZN+oBdLDREUOz0RVU/FUiHk=; b=MX3hemWEOvqWSz40Q8+ZcJsHINRJGzAImPMonbR6igkMRNybiJNe9mByK/2O2ibLOZ JePZ2UA89vo7s8MYrlyAONVR78XZ5kYGLl73ceSpn+tPW4OrxkiqkViI7Xle4ergkJLe O1KzJ4SJvMicHEkMHm+w+FNCc9+VR4TFQfk/r/2jwF/q3AW57znCpYsXDlzJqdJOxMrz ryel2KB4l01vB2bR/Ly4Wu9mi6JRH5DuudJUCYX/7wSYD6jqlR9SFV5zTXMhMS1BNtZ/ W8d8RS+Ewx3QjmtUGlmq/HELY4HiZThbQCkYEZ1I0jdjNhkTbITTTV3O+AcpjHWyU1S+ +UuA== X-Gm-Message-State: AOAM531MB7Gp28G50z3f6qFG4aLC/1zAhgehBXbV6HsLcLqlwiJIuKC3 RwZKp3gORlZo4fsN1mMMeexcvyGRDFBqwA== X-Google-Smtp-Source: ABdhPJyMAlOAZzEVnxKVKO8aztdhYMM9Y2g7qEpj7xlXwU27WPEBIW+Fl8tAlP3yXJI6HRJPxKl5xg== X-Received: by 2002:adf:a3d1:: with SMTP id m17mr25434272wrb.289.1605192047221; Thu, 12 Nov 2020 06:40:47 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [for-5.2 3/9] docs: Move virtio-pmem.rst into the system manual Date: Thu, 12 Nov 2020 14:40:35 +0000 Message-Id: <20201112144041.32278-4-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20201112144041.32278-1-peter.maydell@linaro.org> References: <20201112144041.32278-1-peter.maydell@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::433; envelope-from=peter.maydell@linaro.org; helo=mail-wr1-x433.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @linaro.org) Content-Type: text/plain; charset="utf-8" Signed-off-by: Peter Maydell Reviewed-by: Alex Benn=C3=A9e --- docs/system/index.rst | 1 + docs/{ =3D> system}/virtio-pmem.rst | 0 2 files changed, 1 insertion(+) rename docs/{ =3D> system}/virtio-pmem.rst (100%) diff --git a/docs/system/index.rst b/docs/system/index.rst index 0f0f6d2e99d..2a5155c67dc 100644 --- a/docs/system/index.rst +++ b/docs/system/index.rst @@ -30,6 +30,7 @@ Contents: gdb managed-startup cpu-hotplug + virtio-pmem targets security deprecated diff --git a/docs/virtio-pmem.rst b/docs/system/virtio-pmem.rst similarity index 100% rename from docs/virtio-pmem.rst rename to docs/system/virtio-pmem.rst --=20 2.20.1 From nobody Mon Feb 9 01:48:29 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1605192286; cv=none; d=zohomail.com; s=zohoarc; b=D5gwMpKAYwju93WSQCxaBt7gmcyTWojQuqYCb8i2BvKe/JL0fKEcUnWir1SQH8733geiujO4pE4yNaCVZO3rpfMVw9I0g7L2McqKRbO4/ofVP4n1UKoQjz5gjXUlNq3hcz9a4Dg2Bf+HhYmsOA/7weJDQm2+VrnxxdebjiGn7Bw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1605192286; h=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=xpY+qBYQS+fcNHN03IyJvcvU2rXnoyuOeph6fIF4tkE=; b=TSkwyoHlA2IL1L/F7+fpkrYN4c6NzWgh+FxMrAu/xjyXMw5RvHvX3uBmugNsbopfcA47Ce27uxh0nYcFmwsF3WQPnbYoNeHzaBJVpFCUhbpaYUfibhw1lHvupoHqFBD73iHQCb9SnKxRblV2lpNo/hofiMPOYJXZ+lfbqtmcxMU= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1605192286400360.38955239067377; Thu, 12 Nov 2020 06:44:46 -0800 (PST) Received: from localhost ([::1]:39848 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kdDq5-0004XV-88 for importer@patchew.org; Thu, 12 Nov 2020 09:44:42 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:39490) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kdDmO-0000fF-Ap for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:52 -0500 Received: from mail-wr1-x436.google.com ([2a00:1450:4864:20::436]:40663) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kdDmM-0003l8-BB for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:51 -0500 Received: by mail-wr1-x436.google.com with SMTP id 33so6241693wrl.7 for ; Thu, 12 Nov 2020 06:40:49 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id k16sm7410907wrl.65.2020.11.12.06.40.47 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 06:40:47 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=xpY+qBYQS+fcNHN03IyJvcvU2rXnoyuOeph6fIF4tkE=; b=oYLG76D8TuYx8P5ql94dGcvhjIjB+EttMYdJaUPPWg6MCjVMs92U5B8sJDwG24A8Ib OVvmoKnPFnK5SeWa3vFaxY9t11o2RYWyACOsRiipWZW9SOt0IHDqPKaxzhSPibS66zmR Oar+sjZjNciJRp1oFc4hYgpCOnBVA00arvYqXJhehLt5c+GahQbk6zFWqbYIVrpMuaV5 EvSmmFmVkGeQ+AA5Tm+qeJOGFxkQWr//eBDIiA0p3ii0DbomtoKUendMEuW1t5xX0w+t Qpl8aPRut80upgQuF2z8adbCIuwBG4qddVBhbZp6djrJboocdJyat6T1EgWaSKTwCdFG DMnQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=xpY+qBYQS+fcNHN03IyJvcvU2rXnoyuOeph6fIF4tkE=; b=SLvTt9lPcyJRi52/1YWQvhEpfRjwo70UrqG2OK2RMoLCxkTLc2LKUBykR7Pl+bVSEt uYlTF25zNL+GusEVK+bW3lynC7rTLdKC8zw5Ct2fmawS75x5BjKAMG4CiJ2ALvt2PFl3 s+XZRHXtnAt9fHETRZKd84eorFrVXiZi19S2xMoUY9/mFgUDFkd+2NTZMo1XKRSnKPyj dBlt6E2PZsu35nx0JiBlMIu9iRgy83lmbuRZaBG1EKN2jtyPSq7p80g8e56RCURkgl0K 9W+1o1M3GbsOorTGJ23dTnVN14xQuKr1J/7Le0Hv2+FOXQwzKBQAln8q5gtBq+WCEffo IPrw== X-Gm-Message-State: AOAM532l+SeFclcuD63TlfAGpTkcxrbu6q1dAvj87E1E3YOEh2aVEz0S IAIYuKYFEr7ABWuGEQwu6JgzOZMjFTShPA== X-Google-Smtp-Source: ABdhPJzw72F9P56oVIjJLkaLAibI9hSYm7oB/NsFZ2ITZe55GLv3+a0epvdPjxfReNgROpLFcEw/nA== X-Received: by 2002:adf:ee12:: with SMTP id y18mr29041126wrn.231.1605192048552; Thu, 12 Nov 2020 06:40:48 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [for-5.2 4/9] docs/system/virtio-pmem.rst: Fix minor style issues Date: Thu, 12 Nov 2020 14:40:36 +0000 Message-Id: <20201112144041.32278-5-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20201112144041.32278-1-peter.maydell@linaro.org> References: <20201112144041.32278-1-peter.maydell@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::436; envelope-from=peter.maydell@linaro.org; helo=mail-wr1-x436.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @linaro.org) Content-Type: text/plain; charset="utf-8" The virtio-pmem documentation has some minor style issues we hadn't noticed since we weren't rendering it in our docs: * Sphinx doesn't complain about overlong title-underlining the way it complains about too-short underlining, but it looks odd; make the underlines of the top level title the right length * Indent of paragraphs makes them render as blockquotes; remove the indent so they just render as normal text * Leading 'o' isn't rst markup, so it just renders as a literal "o"; reformat as a subsection heading instead * "QEMU" in the document title and section headings are a bit odd and unnecessary since this is the QEMU manual; delete or rephrase them * There's no need to specify what QEMU version the device first appeared in. Signed-off-by: Peter Maydell Reviewed-by: Alex Benn=C3=A9e Reviewed-by: Pankaj Gupta --- docs/system/virtio-pmem.rst | 55 ++++++++++++++++++------------------- 1 file changed, 27 insertions(+), 28 deletions(-) diff --git a/docs/system/virtio-pmem.rst b/docs/system/virtio-pmem.rst index 4bf5d004432..e5f91eff1c2 100644 --- a/docs/system/virtio-pmem.rst +++ b/docs/system/virtio-pmem.rst @@ -1,38 +1,37 @@ =20 -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -QEMU virtio pmem -=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 +virtio pmem +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 - This document explains the setup and usage of the virtio pmem device - which is available since QEMU v4.1.0. - - The virtio pmem device is a paravirtualized persistent memory device - on regular (i.e non-NVDIMM) storage. +This document explains the setup and usage of the virtio pmem device. +The virtio pmem device is a paravirtualized persistent memory device +on regular (i.e non-NVDIMM) storage. =20 Usecase -------- =20 - Virtio pmem allows to bypass the guest page cache and directly use - host page cache. This reduces guest memory footprint as the host can - make efficient memory reclaim decisions under memory pressure. +Virtio pmem allows to bypass the guest page cache and directly use +host page cache. This reduces guest memory footprint as the host can +make efficient memory reclaim decisions under memory pressure. =20 -o How does virtio-pmem compare to the nvdimm emulation supported by QEMU? +How does virtio-pmem compare to the nvdimm emulation? +----------------------------------------------------- =20 - NVDIMM emulation on regular (i.e. non-NVDIMM) host storage does not - persist the guest writes as there are no defined semantics in the device - specification. The virtio pmem device provides guest write persistence - on non-NVDIMM host storage. +NVDIMM emulation on regular (i.e. non-NVDIMM) host storage does not +persist the guest writes as there are no defined semantics in the device +specification. The virtio pmem device provides guest write persistence +on non-NVDIMM host storage. =20 virtio pmem usage ----------------- =20 - A virtio pmem device backed by a memory-backend-file can be created on - the QEMU command line as in the following example:: +A virtio pmem device backed by a memory-backend-file can be created on +the QEMU command line as in the following example:: =20 -object memory-backend-file,id=3Dmem1,share,mem-path=3D./virtio_pmem.i= mg,size=3D4G -device virtio-pmem-pci,memdev=3Dmem1,id=3Dnv1 =20 - where: +where: =20 - "object memory-backend-file,id=3Dmem1,share,mem-path=3D, size= =3D" creates a backend file with the specified size. @@ -40,8 +39,8 @@ virtio pmem usage - "device virtio-pmem-pci,id=3Dnvdimm1,memdev=3Dmem1" creates a virtio p= mem pci device whose storage is provided by above memory backend device. =20 - Multiple virtio pmem devices can be created if multiple pairs of "-objec= t" - and "-device" are provided. +Multiple virtio pmem devices can be created if multiple pairs of "-object" +and "-device" are provided. =20 Hotplug ------- @@ -59,14 +58,14 @@ the guest:: Guest Data Persistence ---------------------- =20 - Guest data persistence on non-NVDIMM requires guest userspace applications - to perform fsync/msync. This is different from a real nvdimm backend where - no additional fsync/msync is required. This is to persist guest writes in - host backing file which otherwise remains in host page cache and there is - risk of losing the data in case of power failure. +Guest data persistence on non-NVDIMM requires guest userspace applications +to perform fsync/msync. This is different from a real nvdimm backend where +no additional fsync/msync is required. This is to persist guest writes in +host backing file which otherwise remains in host page cache and there is +risk of losing the data in case of power failure. =20 - With virtio pmem device, MAP_SYNC mmap flag is not supported. This provid= es - a hint to application to perform fsync for write persistence. +With virtio pmem device, MAP_SYNC mmap flag is not supported. This provides +a hint to application to perform fsync for write persistence. =20 Limitations ------------ --=20 2.20.1 From nobody Mon Feb 9 01:48:29 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1605192214; cv=none; d=zohomail.com; s=zohoarc; b=QknUVhZghRM+tXs1D+GgSYPaP2zlurg6eQ/9VK2MzsqlDHbwWzH+W6mesLykbVGJ2U7KOD3QHl5nLfpvYgtpVXSL43I63b3yBhR1mn22kNqBVQx59VcGSQJqQX8diDTEHkNo6yURJ8Wk/emqno9DSGm61HbskuCUs2iVfRPc4JA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1605192214; h=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=HTkXZpa//4S3/tOAaPxnmr1m6zG2tRZdpuS79qs0LsA=; b=UTvC1YnHDxWSIDzrZLWx+189m+KowoSQoP8SOvov/7hm7OeCoLi+Sx0JCKoTlL0AfyCKxhzfqZqaMEn8L5g8XIw/RjksBcw3u8MflUcW9LZZmCo9SOlnxrRjToP18dOlWqxg/Fz0nWIz/ao5/fS+jHNCNgxzUvKW+hOfZ4b0Kgc= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1605192214870706.2973308794167; Thu, 12 Nov 2020 06:43:34 -0800 (PST) Received: from localhost ([::1]:37728 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kdDoz-0003eV-PG for importer@patchew.org; Thu, 12 Nov 2020 09:43:33 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:39500) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kdDmP-0000hp-Bd for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:53 -0500 Received: from mail-wm1-x32c.google.com ([2a00:1450:4864:20::32c]:40440) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kdDmN-0003lM-JI for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:52 -0500 Received: by mail-wm1-x32c.google.com with SMTP id a3so5712224wmb.5 for ; Thu, 12 Nov 2020 06:40:51 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id k16sm7410907wrl.65.2020.11.12.06.40.48 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 06:40:48 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=HTkXZpa//4S3/tOAaPxnmr1m6zG2tRZdpuS79qs0LsA=; b=D1mqkC1k1vrl03AzPXC/HXdb7kKIIZ8gNRuY4qQHc3GBpmbUfLgL2b8HvliFVocj37 ywHsE2okSQB5399DtV0wFVqfrlIHGoBQnTFZKE73LrJObgIw7FiXPDgHVJAkUNS/Eze5 /23V4SoWc718scz8uinmHXpFCd28pzkdvswDKFcAbdhPByx2SbXShMWpRTe1YHOd/mEU +ChdVXecUoU3kx+eHnz7xGK46mp6CyOBGdGmR8eEDFQdkxmr+RXvOusBP2R38iwDZ4EE N7k+BuW+SN7HLMo/+NkKPGlPE7J17QyFc/0A8D7FXHNWwu3aiKlLZgSFZ0CJohzbiRHP etBg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=HTkXZpa//4S3/tOAaPxnmr1m6zG2tRZdpuS79qs0LsA=; b=lVzdYQtanpAhbOgwnbdkVaxRrOSHibQZ+N7gd5yt0HtwtI9D7h8taXLPvxo7rlQ0vw jPJy7QckgNOFYp3nDo28KHx7ILnYkyVPk3gW1VcH7kYgXKZKvuHX408d2nnPW3ljABiT LBq6lPJar/EUyeW5XPJ0d34I4tJja3EhQD5PEEKjEihQnFXun2/bOzIpYjmBZ7iyFEfP jkNzNjk/4RtK9XZUuN/nTfEL8jrT2WaVDLMlaWSIxxtDhio1zNe0DieReAV2A5pZXuF4 f77I+L5f2p3+nJeFhsB6DLOWFym57sFlYrOiIEKDDQx3WGNicS9xQoT10I9BqjnPa44k ebNg== X-Gm-Message-State: AOAM531Z0oJ64wzOmvQCmjA0g8dcNyrvwPfWUKZuoiE/meEUZ3mMuLO8 MgvEJn31eVqwGX+3Tm8cpsfjOZnoEuQEWw== X-Google-Smtp-Source: ABdhPJzXVjdt+ZwJeMOdSoVfOBcpT0LtBrWHo6MjVzx16U4q5WBeVM5183I4GK0rzC7Bm0BoxaJCMQ== X-Received: by 2002:a7b:c391:: with SMTP id s17mr65810wmj.66.1605192049810; Thu, 12 Nov 2020 06:40:49 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [for-5.2 5/9] docs: Split out 'pc' machine model docs into their own file Date: Thu, 12 Nov 2020 14:40:37 +0000 Message-Id: <20201112144041.32278-6-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20201112144041.32278-1-peter.maydell@linaro.org> References: <20201112144041.32278-1-peter.maydell@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::32c; envelope-from=peter.maydell@linaro.org; helo=mail-wm1-x32c.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @linaro.org) Content-Type: text/plain; charset="utf-8" Currently target-i386.rst includes the documentation of the 'pc' machine model inline. Split it out into its own file, in a similar way to target-i386.rst; this gives us a place to put documentation of other i386 machine models, such as 'microvm'. Signed-off-by: Peter Maydell Reviewed-by: Alex Benn=C3=A9e --- docs/system/i386/pc.rst | 7 +++++++ docs/system/target-i386.rst | 18 +++++++++++++----- 2 files changed, 20 insertions(+), 5 deletions(-) create mode 100644 docs/system/i386/pc.rst diff --git a/docs/system/i386/pc.rst b/docs/system/i386/pc.rst new file mode 100644 index 00000000000..d543c11a5cd --- /dev/null +++ b/docs/system/i386/pc.rst @@ -0,0 +1,7 @@ +i440fx PC (``pc-i440fx``, ``pc``) +=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 + +Peripherals +~~~~~~~~~~~ + +.. include:: ../target-i386-desc.rst.inc diff --git a/docs/system/target-i386.rst b/docs/system/target-i386.rst index 51be03d881f..1612ddba907 100644 --- a/docs/system/target-i386.rst +++ b/docs/system/target-i386.rst @@ -1,14 +1,22 @@ .. _QEMU-PC-System-emulator: =20 -x86 (PC) System emulator ------------------------- +x86 System emulator +------------------- =20 .. _pcsys_005fdevices: =20 -Peripherals -~~~~~~~~~~~ +Board-specific documentation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =20 -.. include:: target-i386-desc.rst.inc +.. + This table of contents should be kept sorted alphabetically + by the title text of each file, which isn't the same ordering + as an alphabetical sort by filename. + +.. toctree:: + :maxdepth: 1 + + i386/pc =20 .. include:: cpu-models-x86.rst.inc =20 --=20 2.20.1 From nobody Mon Feb 9 01:48:29 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1605192411; cv=none; d=zohomail.com; s=zohoarc; b=B52jljJAl/Q3AiofS+nL15trrYRagVxqmJJm2fi5ciCK6/nQVL67wZSlPnqerGZk03C5+ztymIKrMRBt30gENJ/J9Bz2nz+TtaZAMXki9Abj4kKuX9UNXOaak8wIqrgXiqZwU1DYfwRshOvF0N2HZupC5drqzQk/0t5+vm9vRvk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1605192411; h=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=CLXLkaYqg0DCYCi9CWDIZl935r9PPF+JVFlXeVjwHwU=; b=kINy2Ha2O/ebguX0T11iEpAx9+oFopyRVIoVu0uiUv///NJafs5vq0JVXoHLS/Q+yHl8eTwPSc2DyyZBd5JLYvIV6PjQ5Tko1ssMkl6y10ZWehFOwkyLHLgPszEq3jXV3flkB1sFV3d3oyXw+HT8aBH+x1seL7Zvo+CuVZxNvCA= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1605192411389935.9989779393652; Thu, 12 Nov 2020 06:46:51 -0800 (PST) Received: from localhost ([::1]:46082 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kdDsA-0007GA-Aj for importer@patchew.org; Thu, 12 Nov 2020 09:46:50 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:39518) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kdDmQ-0000lB-Jn for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:54 -0500 Received: from mail-wm1-x32f.google.com ([2a00:1450:4864:20::32f]:35759) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kdDmO-0003mG-Pf for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:54 -0500 Received: by mail-wm1-x32f.google.com with SMTP id w24so5765543wmi.0 for ; Thu, 12 Nov 2020 06:40:52 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id k16sm7410907wrl.65.2020.11.12.06.40.49 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 06:40:50 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=CLXLkaYqg0DCYCi9CWDIZl935r9PPF+JVFlXeVjwHwU=; b=cA0dX8gu+p9NwjbzGNLHtdfRp2J006l6FUDBrUEbf5sqvpSUQN2wj/vgB31ueCH1tF Acwcve2ut3x63uk8NX76xUXieELFXrZQtMbMZYEE8KM3rLzVu+ZRLV9GlQ1ULzqi3RiW FSVcWFiTLKZxJuBPkuLJHHXnEFujpX6+kg1dDEp+/HB9Z+5mIe5r0CV0GoLKlQMf1TUa s3qNXuKwzXL5wcwppykTNbu1OvnUQ8lTFt+0GkBbtYhnUt3FlXPuRtrxSXXjk0ZF3eoN dbpY+hMnyBaWnaJn8vat36OtEooxhNXiEH1y20dpZC9/IgOe+UBs8VPTdlL+Ltj2xvw/ q/sA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=CLXLkaYqg0DCYCi9CWDIZl935r9PPF+JVFlXeVjwHwU=; b=iJD2Q1an9Dczb9Z+Z+NpycxBl7sfVQLRvVn+1HVrOk/k4oue8CuM4hRoR+zaODoEML 2IdkVsc+Zlr8Zf9uhHdnT+xmoFdl76hODq/hvrfFYBBjj/55ZfAV0+76qwAl8f2deE1u ybzXG7UK8Eo9K+sUwNM02pgQ5HsGp3Jh+qkxZin7lMuPN7l/NEanuJtwQeC23tTPFUH/ 0/gH1tznNekG1dsyHB5CznS2CIV8xNWg5ZSv6Gf0SeVekBu/S9j71Xt88Xa9Usy3fA8J 1QHCHWDR6WVZNHYDS+Ajw7PA9vg1r5nhbvnKTLIupzSUnuvcYw49i3VyV90A9dSBQsTJ 3m7A== X-Gm-Message-State: AOAM531ngh3gz6sIoZggVQlP68F/pE8XigZ18bv1AxB62WiZVHeIYVWk qOIowVSnRze7avrvsfqa7IWf3XJ9p98Yrw== X-Google-Smtp-Source: ABdhPJwxhPoKfKpjiRYHhiM1HJ+8YDEyjEUxAGK0AAmVqFJIMnt6bXrRBHXfliG8EldASrofTddDSQ== X-Received: by 2002:a1c:1906:: with SMTP id 6mr11455wmz.87.1605192051153; Thu, 12 Nov 2020 06:40:51 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [for-5.2 6/9] docs: Move microvm.rst into the system manual Date: Thu, 12 Nov 2020 14:40:38 +0000 Message-Id: <20201112144041.32278-7-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20201112144041.32278-1-peter.maydell@linaro.org> References: <20201112144041.32278-1-peter.maydell@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::32f; envelope-from=peter.maydell@linaro.org; helo=mail-wm1-x32f.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @linaro.org) Content-Type: text/plain; charset="utf-8" Now that target-i386.rst has a place to list documentation of machines other than the 'pc' machine, we have a place we can move the microvm documentation to. Signed-off-by: Peter Maydell Reviewed-by: Alex Benn=C3=A9e --- docs/{ =3D> system/i386}/microvm.rst | 5 ++--- docs/system/target-i386.rst | 1 + 2 files changed, 3 insertions(+), 3 deletions(-) rename docs/{ =3D> system/i386}/microvm.rst (98%) diff --git a/docs/microvm.rst b/docs/system/i386/microvm.rst similarity index 98% rename from docs/microvm.rst rename to docs/system/i386/microvm.rst index fcf41fc1f6f..1675e37d3e7 100644 --- a/docs/microvm.rst +++ b/docs/system/i386/microvm.rst @@ -1,6 +1,5 @@ -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -microvm Machine Type -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +'microvm' virtual platform (``microvm``) +=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 =20 ``microvm`` is a machine type inspired by ``Firecracker`` and constructed after its machine model. diff --git a/docs/system/target-i386.rst b/docs/system/target-i386.rst index 1612ddba907..22ba5ce2c0f 100644 --- a/docs/system/target-i386.rst +++ b/docs/system/target-i386.rst @@ -16,6 +16,7 @@ Board-specific documentation .. toctree:: :maxdepth: 1 =20 + i386/microvm i386/pc =20 .. include:: cpu-models-x86.rst.inc --=20 2.20.1 From nobody Mon Feb 9 01:48:29 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1605192448; cv=none; d=zohomail.com; s=zohoarc; b=eRhmgKwL5C9u0h581iqzVEp9V/bPtdqGV8BtHAPeCoTEqd96fSVJe4aS7z3lCdTLaQ7HKUmpZZV+3oQ2kIgob4BTmaRixEqYi0Peb/RYEb7GvCEKMkaalogmchnAyz/bDXZTgaLfYWuYlbqD6t1+7whXEwRBQNSsYVZ53SdshrU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1605192448; h=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=EuoKVmiBbj6jZKyCWdSBhhtmz1pu6yZkNGkryXfbOD8=; b=QtPyOl6Zlg81NAq/KfFR8UMjR1KAa9rsBGd0MblyjDD53VC2CArocJxGjorgXbNxQ0ejqYGjGeXhnFecVHQVWooBOv0qyQTSFRD9kS5oPCJbQV4aMKCzAPfbFFFU4fJlKmR+tIFgaovFEeQsvZ/2aWxgkCqAuBHem7Dl6fJ+nr0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 160519244868570.76014538265372; Thu, 12 Nov 2020 06:47:28 -0800 (PST) Received: from localhost ([::1]:48294 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kdDsl-0008AF-Ez for importer@patchew.org; Thu, 12 Nov 2020 09:47:27 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:39526) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kdDmR-0000nQ-GN for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:55 -0500 Received: from mail-wm1-x32f.google.com ([2a00:1450:4864:20::32f]:37438) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kdDmP-0003mO-QS for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:55 -0500 Received: by mail-wm1-x32f.google.com with SMTP id c16so5727477wmd.2 for ; Thu, 12 Nov 2020 06:40:53 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id k16sm7410907wrl.65.2020.11.12.06.40.51 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 06:40:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=EuoKVmiBbj6jZKyCWdSBhhtmz1pu6yZkNGkryXfbOD8=; b=pLY07iMfK45PHJ03ekWN9S7GeR9s9gIPiLydYcB82jvt+UcXMqBDcHD1JSYi62NJiW Nydi5iU/zcdMwxYKMR2q4tWgzjR+114bpnQwAucCctMdpd/8HvQ/BFIolKBTd3mAU8T0 4n0GJbzr7rOvLsmUMA62T4tqX5mnJwPOC70bt2HOG+WFUxbJfIMcYdYCqfi9Kx09zz7F X8/T/epOlbMmgR6SBJJkvujUenny2E/McSTgoBIRjLIEuliIIydyp6t0kQ722YZSZ01r BV/ib9Zk3INSX3hZpdpkzSp2SgygAkgb+XdiTPW09roCwxVoMcTYovgd7m1qsEyGvC2r ptgA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=EuoKVmiBbj6jZKyCWdSBhhtmz1pu6yZkNGkryXfbOD8=; b=aOJbP8HPcQrl8n9IN+iZCjNIYtaW2wSc1gNo4dmdaJTOxhjZ1M8r9LkX63oN4gRBoH Z6liaWvUDdMRhut0MplW3vbGQDblCo0UCzB7njFyNCTdueD38kvzpPPy9pJagppfA88E qnYL1Gr9JPRQEVJl2ptG5SBrT+mZQVT7Xqp1mnwSY3/L83C9PC0CMTZxGkDhAJ+2c8oI MR93nXIbefCDQtWejt2KdQfTuNCXn58bGlUxMPUI/Vv8Gf2Y0qlHsCo7AYjGQjV6c1H5 qH3VN8UBmUsicqfLCqd7dFlajrYdi7fRnzXYzJtHYxokUBSqkPfn0tgpMU1+Jx4LChI1 9e3A== X-Gm-Message-State: AOAM531yFcYBzcRukBvSfXaVJwMsAqxGb1cenBs0CwnSeLmoZRdnBcxp q9PRC3gZDXrI7spTlnMN8DaONAK1rpCM6A== X-Google-Smtp-Source: ABdhPJy4DzZChTh2tBmpxXqWRgO0UOb+na6+q1jTOYTu2yedrx1mWClJ3CoKdusLjMaA1xuRPrlWhg== X-Received: by 2002:a05:600c:2119:: with SMTP id u25mr9810665wml.53.1605192052179; Thu, 12 Nov 2020 06:40:52 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [for-5.2 7/9] docs: Move pr-manager.rst into the system manual Date: Thu, 12 Nov 2020 14:40:39 +0000 Message-Id: <20201112144041.32278-8-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20201112144041.32278-1-peter.maydell@linaro.org> References: <20201112144041.32278-1-peter.maydell@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::32f; envelope-from=peter.maydell@linaro.org; helo=mail-wm1-x32f.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @linaro.org) Content-Type: text/plain; charset="utf-8" Move the pr-manager documentation into the system manual. Some of it (the documentation of the pr-manager-helper tool) should be in tools, but we will split it up after moving it. Signed-off-by: Peter Maydell Reviewed-by: Alex Benn=C3=A9e --- docs/system/index.rst | 1 + docs/{ =3D> system}/pr-manager.rst | 0 2 files changed, 1 insertion(+) rename docs/{ =3D> system}/pr-manager.rst (100%) diff --git a/docs/system/index.rst b/docs/system/index.rst index 2a5155c67dc..e5a35817a24 100644 --- a/docs/system/index.rst +++ b/docs/system/index.rst @@ -31,6 +31,7 @@ Contents: managed-startup cpu-hotplug virtio-pmem + pr-manager targets security deprecated diff --git a/docs/pr-manager.rst b/docs/system/pr-manager.rst similarity index 100% rename from docs/pr-manager.rst rename to docs/system/pr-manager.rst --=20 2.20.1 From nobody Mon Feb 9 01:48:29 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1605192543; cv=none; d=zohomail.com; s=zohoarc; b=QeBsnbTav/MUHCa0QHyOgQooBF4RijUeOekM+dauSUVjj2WDWDSSLV0+GDIHBc0QTjstajBxt9tXCPUYec+dc5Ja/cf9rWVP5yDxoSn1Knnhyog4WhHY1bDOZHwISixuTf6CFbjoy5SrnrXrVTQX7vgEMO/+jABooIcUtLseNNg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1605192543; h=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=pziHaU0zIsxgQQdqAtH9ftid9QZXJBnOnlOur0LxnCY=; b=iPJV1MPKGYKwmoHr2p431oZSH8MajnszjLVM1n6QExBjhFWEAMTdln5gAA3lHTnvTz88lqVMAChTl54eEK+kvCipfbK7VBCoG3sbCkPMNoWo26F63obfgqm29hRz3rkjqpgPNVLU4skZ+44UNKONRSg03tb0+8fLSrST+yzpCGk= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 160519254341367.4704825084417; Thu, 12 Nov 2020 06:49:03 -0800 (PST) Received: from localhost ([::1]:54246 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kdDuI-0002Ea-75 for importer@patchew.org; Thu, 12 Nov 2020 09:49:02 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:39586) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kdDmU-0000uu-JL for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:58 -0500 Received: from mail-wm1-x32b.google.com ([2a00:1450:4864:20::32b]:55684) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kdDmR-0003n2-Dm for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:58 -0500 Received: by mail-wm1-x32b.google.com with SMTP id c9so5464965wml.5 for ; Thu, 12 Nov 2020 06:40:54 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id k16sm7410907wrl.65.2020.11.12.06.40.52 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 06:40:52 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=pziHaU0zIsxgQQdqAtH9ftid9QZXJBnOnlOur0LxnCY=; b=RYTnSZGtm6x8XACL9dIJJCjfONMp5Sdrq3aBXVO1V6K7x3+stdYrWT4BKwkic37D2b gGno6l3clSafRF4C1YfOwANoWCxWSYZB7kTL2o81dzIRtMFBtkUaoXMND/8nw05HRp0u UcXYKGlRfok9NwqqcFU8xneMsPkE8FVFFcdPvHbpkgaekyR6oTJk9/Bb9sy5L5gBkKra 16QFFhLilNyCGDFDFKEWUccI/r7ngrEIen+m2Rn3FOhci8P2KMoYxcSju1A82Wt4XbsW kOnnY2rb8lv+7YHjX/N5TjgvVasmTz0HqMTUAe4jYpSLZX0FPvu9GRkiIp+ldcEgULEA 6gUg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=pziHaU0zIsxgQQdqAtH9ftid9QZXJBnOnlOur0LxnCY=; b=Cl/N25qcnObw7l39rclqfpgTE3PtanlM6w+MIsQkmHZ+L+DRYhZv/hzHOBurUNjivY PDZsSqAA3Qh1jW/CahL4CjxiUvOqWHZu/BkaSoWDegRcbwbiicaB95TIUXqYV+hKwlhP 8oE36v2X/lGK6Z4iqBqrbL7IcKVt54oxTxanxxgxbLiJk1STNjUvQ6lGzfqhU2njgIXs j+WMHE+oAemRJl9E5kTQwgM1j32aZ6WAgTTIrcVSKemo/+aoQIFM/i+cCMjwpce3wEzJ yu/FXPE+P60ifYFoweh4O1xqeCaHHIvyiUgpmdOnxQc5ltGVZdN0OtJAVjenJQ334PZd Bnyg== X-Gm-Message-State: AOAM533TWBGpHEQISt78UbSlrEykhO/AtC3RkFoi3yLLsVyyNrgXZQKS 25eUnIA6XUvt5t6Y3ldDDXCH1VivxmkrPA== X-Google-Smtp-Source: ABdhPJzhk4g5q7GZg02nSbeLHg7CNkJvOUpJI4IIbHnhH07rdHQdsyrQKI2ynwtB3baV9BWCW39W/Q== X-Received: by 2002:a1c:3502:: with SMTP id c2mr13570wma.79.1605192053276; Thu, 12 Nov 2020 06:40:53 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [for-5.2 8/9] docs: Split qemu-pr-helper documentation into tools manual Date: Thu, 12 Nov 2020 14:40:40 +0000 Message-Id: <20201112144041.32278-9-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20201112144041.32278-1-peter.maydell@linaro.org> References: <20201112144041.32278-1-peter.maydell@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::32b; envelope-from=peter.maydell@linaro.org; helo=mail-wm1-x32b.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @linaro.org) Content-Type: text/plain; charset="utf-8" Split the documentation of the qemu-pr-helper binary into the tools manual, and give it a manpage like our other standalone executables. Signed-off-by: Peter Maydell Reviewed-by: Alex Benn=C3=A9e --- docs/meson.build | 1 + docs/system/pr-manager.rst | 38 ++------------- docs/tools/conf.py | 2 + docs/tools/index.rst | 1 + docs/tools/qemu-pr-helper.rst | 90 +++++++++++++++++++++++++++++++++++ 5 files changed, 99 insertions(+), 33 deletions(-) create mode 100644 docs/tools/qemu-pr-helper.rst diff --git a/docs/meson.build b/docs/meson.build index bf8204a08fa..ebd85d59f98 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -60,6 +60,7 @@ if build_docs 'tools': { 'qemu-img.1': (have_tools ? 'man1' : ''), 'qemu-nbd.8': (have_tools ? 'man8' : ''), + 'qemu-pr-helper.8': (have_tools ? 'man8' : ''), 'qemu-trace-stap.1': (config_host.has_key('CONFIG_TRACE_SYSTEMTAP'= ) ? 'man1' : ''), 'virtfs-proxy-helper.1': (have_virtfs_proxy_helper ? 'man1' : ''), 'virtiofsd.1': (have_virtiofsd ? 'man1' : ''), diff --git a/docs/system/pr-manager.rst b/docs/system/pr-manager.rst index 9b1de198b1b..3f5b9f94dcd 100644 --- a/docs/system/pr-manager.rst +++ b/docs/system/pr-manager.rst @@ -50,39 +50,11 @@ Alternatively, using ``-blockdev``:: -blockdev node-name=3Dhd,driver=3Draw,file.driver=3Dhost_device,= file.filename=3D/dev/sdb,file.pr-manager=3Dhelper0 -device scsi-block,drive=3Dhd =20 ----------------------------------- -Invoking :program:`qemu-pr-helper` ----------------------------------- - -QEMU provides an implementation of the persistent reservation helper, -called :program:`qemu-pr-helper`. The helper should be started as a -system service and supports the following option: - --d, --daemon run in the background --q, --quiet decrease verbosity --v, --verbose increase verbosity --f, --pidfile=3Dpath PID file when running as a daemon --k, --socket=3Dpath path to the socket --T, --trace=3Dtrace-opts tracing options - -By default, the socket and PID file are placed in the runtime state -directory, for example :file:`/var/run/qemu-pr-helper.sock` and -:file:`/var/run/qemu-pr-helper.pid`. The PID file is not created -unless :option:`-d` is passed too. - -:program:`qemu-pr-helper` can also use the systemd socket activation -protocol. In this case, the systemd socket unit should specify a -Unix stream socket, like this:: - - [Socket] - ListenStream=3D/var/run/qemu-pr-helper.sock - -After connecting to the socket, :program:`qemu-pr-helper`` can optionally = drop -root privileges, except for those capabilities that are needed for -its operation. To do this, add the following options: - --u, --user=3Duser user to drop privileges to --g, --group=3Dgroup group to drop privileges to +You will also need to ensure that the helper program +:command:`qemu-pr-helper` is running, and that it has been +set up to use the same socket filename as your QEMU commandline +specifies. See the qemu-pr-helper documentation or manpage for +further details. =20 --------------------------------------------- Multipath devices and persistent reservations diff --git a/docs/tools/conf.py b/docs/tools/conf.py index 9052d17d6d4..4760d36ff2a 100644 --- a/docs/tools/conf.py +++ b/docs/tools/conf.py @@ -22,6 +22,8 @@ man_pages =3D [ ['Fabrice Bellard'], 1), ('qemu-nbd', 'qemu-nbd', u'QEMU Disk Network Block Device Server', ['Anthony Liguori '], 8), + ('qemu-pr-helper', 'qemu-pr-helper', 'QEMU persistent reservation help= er', + [], 8), ('qemu-trace-stap', 'qemu-trace-stap', u'QEMU SystemTap trace tool', [], 1), ('virtfs-proxy-helper', 'virtfs-proxy-helper', diff --git a/docs/tools/index.rst b/docs/tools/index.rst index 232ce9f3e46..b99f86c7c66 100644 --- a/docs/tools/index.rst +++ b/docs/tools/index.rst @@ -12,6 +12,7 @@ Contents: =20 qemu-img qemu-nbd + qemu-pr-helper qemu-trace-stap virtfs-proxy-helper virtiofsd diff --git a/docs/tools/qemu-pr-helper.rst b/docs/tools/qemu-pr-helper.rst new file mode 100644 index 00000000000..ac036180ac1 --- /dev/null +++ b/docs/tools/qemu-pr-helper.rst @@ -0,0 +1,90 @@ +QEMU persistent reservation helper +=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 + +Synopsis +-------- + +**qemu-pr-helper** [*OPTION*] + +Description +----------- + +Implements the persistent reservation helper for QEMU. + +SCSI persistent reservations allow restricting access to block devices +to specific initiators in a shared storage setup. When implementing +clustering of virtual machines, it is a common requirement for virtual +machines to send persistent reservation SCSI commands. However, +the operating system restricts sending these commands to unprivileged +programs because incorrect usage can disrupt regular operation of the +storage fabric. QEMU's SCSI passthrough devices ``scsi-block`` +and ``scsi-generic`` support passing guest persistent reservation +requests to a privileged external helper program. :program:`qemu-pr-helper` +is that external helper; it creates a socket which QEMU can +connect to to communicate with it. + +If you want to run VMs in a setup like this, this helper should be +started as a system service, and you should read the QEMU manual +section on "persistent reservation managers" to find out how to +configure QEMU to connect to the socket created by +:program:`qemu-pr-helper`. + +After connecting to the socket, :program:`qemu-pr-helper` can +optionally drop root privileges, except for those capabilities that +are needed for its operation. + +:program:`qemu-pr-helper` can also use the systemd socket activation +protocol. In this case, the systemd socket unit should specify a +Unix stream socket, like this:: + + [Socket] + ListenStream=3D/var/run/qemu-pr-helper.sock + +Options +------- + +.. program:: qemu-pr-helper + +.. option:: -d, --daemon + + run in the background (and create a PID file) + +.. option:: -q, --quiet + + decrease verbosity + +.. option:: -v, --verbose + + increase verbosity + +.. option:: -f, --pidfile=3DPATH + + PID file when running as a daemon. By default the PID file + is created in the system runtime state directory, for example + :file:`/var/run/qemu-pr-helper.pid`. + +.. option:: -k, --socket=3DPATH + + path to the socket. By default the socket is created in + the system runtime state directory, for example + :file:`/var/run/qemu-pr-helper.sock`. + +.. option:: -T, --trace [[enable=3D]PATTERN][,events=3DFILE][,file=3DFILE] + + .. include:: ../qemu-option-trace.rst.inc + +.. option:: -u, --user=3DUSER + + user to drop privileges to + +.. option:: -g, --group=3DGROUP + + group to drop privileges to + +.. option:: -h, --help + + Display a help message and exit. + +.. option:: -V, --version + + Display version information and exit. --=20 2.20.1 From nobody Mon Feb 9 01:48:29 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1605192511; cv=none; d=zohomail.com; s=zohoarc; b=dnl/IlUJZqRukLWRp+qGaAFXPgHDtJNr703grzn5gzZXfpOhFOUNdapyIE43QA/UCFidFYKOVRk0QNSY0Wf2zoNNszy9kPqQ5bJIgKUhDdvHibegrIRve9kqgXeRLqsJlqORoz8HLa4D+D19V26oGnu1cES++LDusAnFjtC22kM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1605192511; h=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=j9ihxds/2HDlaiV5N2nhzW+drU76gxcV4Dtdhkb6rXg=; b=OCpL1OiUS5hwjN1LkOWecy1xXH1MUqPWYIsF5JUJF5bItEYGimHMyfHA41l1dP8LAvy1pawOEiBa1Gfmb9PGOiAdjsLLsXyy6kRT/TSfj0ZYSQWoY6XIxWUcwyn75t91zPGTdUSZSFXUHs3izBJHo3jMJjUTSHDXx4KDqTNzQzs= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1605192511042776.449497947327; Thu, 12 Nov 2020 06:48:31 -0800 (PST) Received: from localhost ([::1]:51554 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kdDtl-00016S-S2 for importer@patchew.org; Thu, 12 Nov 2020 09:48:29 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:39564) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kdDmT-0000sM-IH for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:57 -0500 Received: from mail-wr1-x432.google.com ([2a00:1450:4864:20::432]:33232) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kdDmR-0003nW-Pw for qemu-devel@nongnu.org; Thu, 12 Nov 2020 09:40:57 -0500 Received: by mail-wr1-x432.google.com with SMTP id b8so6277424wrn.0 for ; Thu, 12 Nov 2020 06:40:55 -0800 (PST) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id k16sm7410907wrl.65.2020.11.12.06.40.53 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Nov 2020 06:40:53 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=j9ihxds/2HDlaiV5N2nhzW+drU76gxcV4Dtdhkb6rXg=; b=qyHIIIw8fy5CfBzhfHH61KPTh+uhQYh43cql4FPjhVmIGvhGgXxJPJQRSwy6/XDt3s seCaeWUEKCyJPvqqKz/t6PNNMIEQHy56JdkPp6pPvdJTDze0zjCDWEDtcyT0GMwMhn1u jN87zRXIMfTYnj3MygdC/HSb2fiKJrSaM3HPXtmOiZt3eR0nYn+AfTVIObcBvyQHkPIi xKa41L8fRn6ZUBwSVrL3C+nFT+bhuV7OeooLDVjLTbRp/2kkFsFLy2mJ1x57aKE5vU6Y whr2SUf7Op3HgErkUuZ5eFbp3JXZjp3vd/wRr0uBbJ6r4tS/xYAmTAH1BlrA2fVZMy1O 0gmQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=j9ihxds/2HDlaiV5N2nhzW+drU76gxcV4Dtdhkb6rXg=; b=h9he8TWFh4v5hcFVxpe0Uu3iBNeFWY4TC9qZwPd4LkBS6NAEFTdWXMdcNY+OR2M999 QXjJkDpV8kv/8JwW4aIjn9up3wFbz7pT1woxBVyHzDhmp3T1//uHOEKEbxDSFT2zlAAC YpS/88o4fUnVcdAaYypnOi5Styh/Wb3J91xq1Jux3slX/aEWlo5Q9oSftMJ7ddxyYnOw ksK9Ue4llOUP0RNd5i2ZokUNlZaOrZD54KDawRn0AotCR2wMksDI4v0uL5gr3y7RRrox eVi+QmQ4s/VjjBOaLSZTSFu6Gj2VWVe4fpGmGzJHw7epy3kzQT4/odAw/I2iqFVuPEyr b0kg== X-Gm-Message-State: AOAM5330eeYWt3kvelSUU7L2lQ5na/xFxaGrGQDC1MLGU/+OrIcON3T8 mzbWrm92JQn20LlcB1eScC9xG5y2ytFwPw== X-Google-Smtp-Source: ABdhPJxpF0ldTJb7kfMnGihbjee/nJV/AGvdQjv8hA1ORLzjZx4J9lToOq3SyaWrVgzrpW6kKYfxaw== X-Received: by 2002:adf:e992:: with SMTP id h18mr26732791wrm.356.1605192054150; Thu, 12 Nov 2020 06:40:54 -0800 (PST) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [for-5.2 9/9] docs/system/pr-manager.rst: Fix minor docs nits Date: Thu, 12 Nov 2020 14:40:41 +0000 Message-Id: <20201112144041.32278-10-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20201112144041.32278-1-peter.maydell@linaro.org> References: <20201112144041.32278-1-peter.maydell@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::432; envelope-from=peter.maydell@linaro.org; helo=mail-wr1-x432.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @linaro.org) Content-Type: text/plain; charset="utf-8" Fix a couple of nits in pr-manager.rst: * the title marker for the top level heading is overlength * stray capital 'R' in the middle of a sentence Signed-off-by: Peter Maydell Reviewed-by: Alex Benn=C3=A9e --- docs/system/pr-manager.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/system/pr-manager.rst b/docs/system/pr-manager.rst index 3f5b9f94dcd..b19a0c15e66 100644 --- a/docs/system/pr-manager.rst +++ b/docs/system/pr-manager.rst @@ -1,8 +1,8 @@ -=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 Persistent reservation managers -=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 =20 -SCSI persistent Reservations allow restricting access to block devices +SCSI persistent reservations allow restricting access to block devices to specific initiators in a shared storage setup. When implementing clustering of virtual machines, it is a common requirement for virtual machines to send persistent reservation SCSI commands. However, --=20 2.20.1