From nobody Mon Feb 9 20:34:49 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) client-ip=208.118.235.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org Return-Path: Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) by mx.zohomail.com with SMTPS id 1501604653031279.63115817530695; Tue, 1 Aug 2017 09:24:13 -0700 (PDT) Received: from localhost ([::1]:43612 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dcZxr-0001Wv-KW for importer@patchew.org; Tue, 01 Aug 2017 12:24:11 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:59612) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dcZrc-0004QD-8L for qemu-devel@nongnu.org; Tue, 01 Aug 2017 12:17:45 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dcZrb-0007GU-Bg for qemu-devel@nongnu.org; Tue, 01 Aug 2017 12:17:44 -0400 Received: from mail-wr0-x242.google.com ([2a00:1450:400c:c0c::242]:37804) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dcZrb-0007Fs-4b for qemu-devel@nongnu.org; Tue, 01 Aug 2017 12:17:43 -0400 Received: by mail-wr0-x242.google.com with SMTP id 12so1794868wrb.4 for ; Tue, 01 Aug 2017 09:17:43 -0700 (PDT) Received: from 640k.lan (94-39-192-75.adsl-ull.clienti.tiscali.it. [94.39.192.75]) by smtp.gmail.com with ESMTPSA id u187sm1724160wmd.26.2017.08.01.09.17.40 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 01 Aug 2017 09:17:41 -0700 (PDT) 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; bh=MtdHiU8geOQFxOZLkHrDQLXBVvsr1uAhLZzYJdNDTSE=; b=HCB00QA75mWqxhQsI84rA4Gy6OMiNE9U2HVTBSn96cuNRA3aJaFTmgaAeIjUm7ZlWk p4YZRCiteesi1l8rjrlKiZItp1F+c+qBaMnpeftgkpR3IU4ge95nlSQTmxFU515+TFSz xiDDuBCFZ2hJU3dm3j2M/zc8RIWc+bX6LH/0aN+bvXn3zXfl+8SM4QKJdedFjlwgOH5V 6wIJxdENbESi++FO82JwO8fkPaJ5Y1tcVrKd2JxeFX+0MJiEha89SlW84cRurMbErSrk RSqJjPBUeZdu0If5Fzsp5js86c13BxWagHoAgFHn4NpkQ+DPorQx8jNRiY6tMAY2VPOp Qg2g== 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; bh=MtdHiU8geOQFxOZLkHrDQLXBVvsr1uAhLZzYJdNDTSE=; b=b5ERTzSS2g6aW/HXvNMFMXpuOQo7kQYf1TRoHxJtuZWF5OmAHSaMpW7tmE3LLzyWIg HzTdUpkJDldLmxiSWszeIgFP3pnFn7PWNCC+V86RFUWNTvDsrj19jqkZ/xcTWenTbrnG HMME7NdtqkuTeoLzNqZW7lhFuHIUfzWLzbEBHxmk0TgEOllyJ8hAKALcil0GW/ILIcLl 4WI9TZ9a2bXWbghFGaES5P/dYNcQQruFWY00JbaA76Fiex8ZQWL4/8bch0W5+/e2FWLQ NZWb8Zmocc/xIwhiUb9OvLgys9Ay8YtLSkHs0qjeTbXNE1e6NBPHHGwzLKXNVy/zKyAY u5FA== X-Gm-Message-State: AIVw110brEyZKthkmGdJVI3FS30rPbHnyUQiDXOeLvPAb7wnl27sb9Yq 4XTRis/1159TYgcGjWY= X-Received: by 10.223.150.200 with SMTP id u66mr18148607wrb.216.1501604261929; Tue, 01 Aug 2017 09:17:41 -0700 (PDT) From: Paolo Bonzini To: qemu-devel@nongnu.org Date: Tue, 1 Aug 2017 18:17:18 +0200 Message-Id: <1501604245-33460-11-git-send-email-pbonzini@redhat.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1501604245-33460-1-git-send-email-pbonzini@redhat.com> References: <1501604245-33460-1-git-send-email-pbonzini@redhat.com> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:400c:c0c::242 Subject: [Qemu-devel] [PULL 10/17] qemu-options: document existance of versioned machine types X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 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: fail (Header signature does not verify) X-ZohoMail: RDKM_2 RSF_0 Z_629925259 SPT_0 Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" From: "Daniel P. Berrange" The -machine docs did not explain what the versioned machine types are for, nor that they'll be maintained across releases. Signed-off-by: Daniel P. Berrange Message-Id: <20170725141041.1195-1-berrange@redhat.com> Signed-off-by: Paolo Bonzini --- qemu-options.hx | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/qemu-options.hx b/qemu-options.hx index 746b5fa..9f6e2ad 100644 --- a/qemu-options.hx +++ b/qemu-options.hx @@ -49,7 +49,20 @@ STEXI @item -machine [type=3D]@var{name}[,prop=3D@var{value}[,...]] @findex -machine Select the emulated machine by @var{name}. Use @code{-machine help} to list -available machines. Supported machine properties are: +available machines. + +For architectures which aim to support live migration compatibility +across releases, each release will introduce a new versioned machine +type. For example, the 2.8.0 release introduced machine types +``pc-i440fx-2.8'' and ``pc-q35-2.8'' for the x86_64/i686 architectures. + +To allow live migration of guests from QEMU version 2.8.0, to QEMU +version 2.9.0, the 2.9.0 version must support the ``pc-i440fx-2.8'' +and ``pc-q35-2.8'' machines too. To allow users live migrating VMs +to skip multiple intermediate releases when upgrading, new releases +of QEMU will support machine types from many previous versions. + +Supported machine properties are: @table @option @item accel=3D@var{accels1}[:@var{accels2}[:...]] This is used to enable an accelerator. Depending on the target architectur= e, --=20 1.8.3.1