From patchwork Wed Feb 26 11:30:32 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Paolo Bonzini X-Patchwork-Id: 183910 Delivered-To: patch@linaro.org Received: by 2002:ac9:7758:0:0:0:0:0 with SMTP id d24csp2964576ocu; Wed, 26 Feb 2020 03:35:22 -0800 (PST) X-Google-Smtp-Source: APXvYqznOgepyFzTz5DW/0Sg5R46LP4vNU4bjf0wEMzOd2AzUxg/5LJZ0BWlM0nX7omwHNV9o4R/ X-Received: by 2002:a05:620a:141a:: with SMTP id d26mr5069643qkj.312.1582716922795; Wed, 26 Feb 2020 03:35:22 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1582716922; cv=none; d=google.com; s=arc-20160816; b=uQ0T8rEnjrmteUsM0tqxlHW4PPO4Z5aCI7d72QMV8aTsXy4DcBvaBTJUm+jTTUxtMK LLMKixBuyFieKuDkotSdiMGZiGiS/dFtBh3ydEnlBDxCVYUMb3wXBvRRqPGWMsB//sKP wARzKRo4Pio7i2jfYeU5odTyDg8UpDxYol0IuGxiJk1DweTUiwxgNikFOV0jKlIjKE4w qCMJ2uTTlFwn1+FcJOZjQEnZ+w5kVqcS0TT/5VZncMLQyW5MUEjnmUE/dZjWz8iDsz0R fF+dVZRWm0cSKvqylDwj0gbcmB9p+PiIhyjI74QEyd0oUl008qFMzvas3sk1e1ojPnHh jwtQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:cc:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:to:from :dkim-signature; bh=IOCp7//xuJ1gvtqmOaoBWn6mtaBnhkwhAqap6W0CKnQ=; b=Ty/WmKcetw2V96f1BmIwvPh+JkCDMHSu7epe5CA8XXOUXo+mWJlXiNkFvuFuouF2Z3 hLdR2Qc1UoB5QcPlJnsa5wY68ncR4fnz/IRQNKXVo8+xdhWGlcBLwWmsEAWrOsudtf1S I+KhqlGTgJke3i3RyC8xAc2NHLxWXreEQwK7Ph6RuchRZU716OP3sVYwcJYmxkHudG2F jsqNQSEA4fdjGk2Au/2cJNpSXgshlSHWVU0lsX/BDFQnrSEglQWZCkNLvlJ9UI9FkESD OrV+oVLMkGNqNaVhOK/KWlukEuq9psVIyMnjsv0/mpCjcSh16CB0YFRrWkYIl07QR4FO lHmQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@gmail.com header.s=20161025 header.b=IQwhrNJA; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=redhat.com Return-Path: Received: from lists.gnu.org (lists.gnu.org. [209.51.188.17]) by mx.google.com with ESMTPS id c10si964566qtn.192.2020.02.26.03.35.22 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 26 Feb 2020 03:35:22 -0800 (PST) Received-SPF: pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; Authentication-Results: mx.google.com; dkim=fail header.i=@gmail.com header.s=20161025 header.b=IQwhrNJA; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=redhat.com Received: from localhost ([::1]:42770 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j6uyI-0007Qa-8q for patch@linaro.org; Wed, 26 Feb 2020 06:35:22 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:52851) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j6uty-00010T-Bg for qemu-devel@nongnu.org; Wed, 26 Feb 2020 06:30:55 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j6utx-0006v6-2s for qemu-devel@nongnu.org; Wed, 26 Feb 2020 06:30:54 -0500 Received: from mail-wr1-x441.google.com ([2a00:1450:4864:20::441]:42301) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1j6utw-0006qU-PY for qemu-devel@nongnu.org; Wed, 26 Feb 2020 06:30:52 -0500 Received: by mail-wr1-x441.google.com with SMTP id p18so2525129wre.9 for ; Wed, 26 Feb 2020 03:30:52 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=IOCp7//xuJ1gvtqmOaoBWn6mtaBnhkwhAqap6W0CKnQ=; b=IQwhrNJA9jW8yckfcw7zuVAMlRzmkUobteW8Gw7OeYAtg4gV+dI6P7awspIcAT7WWD K9T/KjOQ9/HtwH1Au+qFlJ1BM9BTjkGaeYMzGn/3Nd/Hb6FTk0cHCJjTP6KRqw8ZwluQ 2DmPoT7WGEUkhGzCdjFSjxE3yblPnyWfGBP74/nHfB8UCENVy32J8qqnQAzSKkXUxmYU eYjbAQUudXbey6/hjpMjQrbPS8pDlQtJsRpHb3I3Nx8Ncbxxz96g+M7QQi2MeIEZ2+6S PYGjzn8M2NPomHZej2dYCABy5ifXw+sAYGIFjazLYf2Rr5SWp5FvukWHpi70k59ZP0D2 4TcQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:content-transfer-encoding; bh=IOCp7//xuJ1gvtqmOaoBWn6mtaBnhkwhAqap6W0CKnQ=; b=qhhSBHriUB5MQtIwXz7VlD32Q5xfDSz7nhO0tf8pVWM/X3+HaKq2UYQKKxY8LFucBP btKgwUYVPhSvaYtkoDWJ2LwTRgaNunKTg6UF82mqG+Nt/EcI7PNP8LsLoD7V9u4YFvbv wP4DPiKDhzyGFr8Ym5SUpbqVcP1lYuNra8HLd3IX5B3h8Yby1QdaRjf7KMiTuPwKtYZK ekfHphbtkoTFcBxtJZkM+X1rFYjWyCIj887GiI02/9Z8YT3lYkOJHz84tRo1+JauWxmV LvxBJjx8CKJotdnf/8cYNbC/RjpjUytdgTR/x7f68C5zECFS4D8pLr6I6uxNaIfZQLD0 yC9A== X-Gm-Message-State: APjAAAXqkO7tGCCn5l5fmy4wSjsffIjlIlb+rhW5nD7xq/fpDtGrKj3j YOjWY72J+SW+nIpq3oyUBhC4V6N6 X-Received: by 2002:adf:de12:: with SMTP id b18mr2290618wrm.268.1582716651381; Wed, 26 Feb 2020 03:30:51 -0800 (PST) Received: from donizetti.lan ([2001:b07:6468:f312:d0d9:ea10:9775:f33f]) by smtp.gmail.com with ESMTPSA id h128sm2628154wmh.33.2020.02.26.03.30.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 26 Feb 2020 03:30:50 -0800 (PST) From: Paolo Bonzini To: qemu-devel@nongnu.org Subject: [PATCH 16/18] docs/system: convert managed startup to rST. Date: Wed, 26 Feb 2020 12:30:32 +0100 Message-Id: <20200226113034.6741-17-pbonzini@redhat.com> X-Mailer: git-send-email 2.21.1 In-Reply-To: <20200226113034.6741-1-pbonzini@redhat.com> References: <20200226113034.6741-1-pbonzini@redhat.com> MIME-Version: 1.0 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:4864:20::441 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: , Cc: peter.maydell@linaro.org Errors-To: qemu-devel-bounces+patch=linaro.org@nongnu.org Sender: "Qemu-devel" From: Peter Maydell Fix one typo in the process and format more option and command names as literal text, but make no significant changes to the content. Signed-off-by: Peter Maydell Signed-off-by: Paolo Bonzini --- docs/system/index.rst | 1 + docs/system/managed-startup.rst | 35 +++++++++++++++++++++++++++++++++ 2 files changed, 36 insertions(+) create mode 100644 docs/system/managed-startup.rst -- 2.21.1 diff --git a/docs/system/index.rst b/docs/system/index.rst index d38addb2a0..b2263b70d8 100644 --- a/docs/system/index.rst +++ b/docs/system/index.rst @@ -13,4 +13,5 @@ Contents: .. toctree:: :maxdepth: 2 + managed-startup security diff --git a/docs/system/managed-startup.rst b/docs/system/managed-startup.rst new file mode 100644 index 0000000000..9bcf98ea79 --- /dev/null +++ b/docs/system/managed-startup.rst @@ -0,0 +1,35 @@ +Managed start up options +======================== + +In system mode emulation, it's possible to create a VM in a paused +state using the ``-S`` command line option. In this state the machine +is completely initialized according to command line options and ready +to execute VM code but VCPU threads are not executing any code. The VM +state in this paused state depends on the way QEMU was started. It +could be in: + +- initial state (after reset/power on state) +- with direct kernel loading, the initial state could be amended to execute + code loaded by QEMU in the VM's RAM and with incoming migration +- with incoming migration, initial state will be amended with the migrated + machine state after migration completes + +This paused state is typically used by users to query machine state and/or +additionally configure the machine (by hotplugging devices) in runtime before +allowing VM code to run. + +However, at the ``-S`` pause point, it's impossible to configure options +that affect initial VM creation (like: ``-smp``/``-m``/``-numa`` ...) or +cold plug devices. The experimental ``--preconfig`` command line option +allows pausing QEMU before the initial VM creation, in a "preconfig" state, +where additional queries and configuration can be performed via QMP +before moving on to the resulting configuration startup. In the +preconfig state, QEMU only allows a limited set of commands over the +QMP monitor, where the commands do not depend on an initialized +machine, including but not limited to: + +- ``qmp_capabilities`` +- ``query-qmp-schema`` +- ``query-commands`` +- ``query-status`` +- ``x-exit-preconfig``