From nobody Mon Feb 9 11:07:20 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1591017777; cv=none; d=zohomail.com; s=zohoarc; b=bkTOqlKaEZjLcBP5OouuoPNTvG/05u7aG13LXb63/S8xFmznlz1aFPi6T2lEIodYe0ZUmBn/jBlKaR8RiJyqajnwTCXXF/gAxyk+kxlUV7f83FvNiuuIUDuWnqTvraKPRXR+aeIu9Aol7LsHlOMeEINFHsKToxnid7acxsLihSQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1591017777; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=sdd1mMFPbsQmtXgXFWsrkSoE/ehcloopbpulSqzewUY=; b=WhbP4ou9i175dU3n/sS0PrgEHkSuLBjQwgQJuHCPofOFjq/S+Dv6PR7CjWzoA6HmSfGn9uSNogMg8vLtkNagem0bPgaSvUEN7DUEue3mlXq8YeKH77LcXl2ixhstgD1EG3M6a1JCHo6qz2u+zxRk1V/SxczQ38E/XMrAG2SdkaM= ARC-Authentication-Results: i=1; mx.zohomail.com; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=fail header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 1591017777461654.6525117531816; Mon, 1 Jun 2020 06:22:57 -0700 (PDT) Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1jfkOg-00071P-Vc; Mon, 01 Jun 2020 13:22:34 +0000 Received: from us1-rack-iad1.inumbo.com ([172.99.69.81]) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1jfkOg-00070X-3m for xen-devel@lists.xenproject.org; Mon, 01 Jun 2020 13:22:34 +0000 Received: from mga12.intel.com (unknown [192.55.52.136]) by us1-rack-iad1.inumbo.com (Halon) with ESMTPS id e14aa228-a40a-11ea-8993-bc764e2007e4; Mon, 01 Jun 2020 13:22:02 +0000 (UTC) Received: from orsmga008.jf.intel.com ([10.7.209.65]) by fmsmga106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 01 Jun 2020 06:22:01 -0700 Received: from alayek-mobl.amr.corp.intel.com (HELO ubuntu.localdomain) ([10.209.11.99]) by orsmga008.jf.intel.com with ESMTP; 01 Jun 2020 06:22:00 -0700 X-Inumbo-ID: e14aa228-a40a-11ea-8993-bc764e2007e4 IronPort-SDR: k2VvIlGHeuF5FHzawTp51swC4PNEusRm4BONrgxIy4XUSIsaVdm4B5QWKqUU3dwKOQqQwiyGkW OKZxsiPGsWJA== X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False IronPort-SDR: H1aV+v7D8iqBCn+kOObTwwAklxRSIFRI2v89rHm0OiToMY/GQuN4Op2Uk9MAHvIs6P9uNmgRXf XwA23kt8+UuA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.73,460,1583222400"; d="scan'208";a="303887330" From: Tamas K Lengyel To: xen-devel@lists.xenproject.org Subject: [PATCH v19 for-4.14 13/13] tools/xl: document fork-vm command Date: Mon, 1 Jun 2020 06:21:47 -0700 Message-Id: X-Mailer: git-send-email 2.25.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Cc: Ian Jackson , Tamas K Lengyel , Wei Liu Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" Content-Type: text/plain; charset="utf-8" Signed-off-by: Tamas K Lengyel --- docs/man/xl.1.pod.in | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/docs/man/xl.1.pod.in b/docs/man/xl.1.pod.in index 09339282e6..9e87b0314f 100644 --- a/docs/man/xl.1.pod.in +++ b/docs/man/xl.1.pod.in @@ -708,6 +708,45 @@ above). =20 =3Dback =20 +=3Ditem B [I] I + +Create a fork of a running VM. The domain will be paused after the operat= ion +and remains paused while forks of it exist. Experimental and x86 only. +Forks can only be made of domains with HAP enabled and on Intel hardware. = The +parent domain must be created with the xl toolstack and its configuration = must +not manually define max_grant_frames, max_maptrack_frames or max_event_cha= nnels. + +B + +=3Dover 4 + +=3Ditem B<-p> + +Leave the forked VM paused after creating it. The parent always remains p= aused +while there are forks active from it and that's enforced by the hypervisor. + +=3Ditem B<--launch-dm> + +Specify whether the device model (QEMU) should be launched for the fork. = Late +launch allows to start the device model for an already running fork previo= usly +created with "--launch-dm no". + +=3Ditem B<-C> + +The config file to use when launching the device model. Currently require= d when +launching the device model. Most config settings MUST match the parent do= main +exactly, only change VM name, disk path and network configurations. + +=3Ditem B<-Q> + +The path to the QEMU save file to use when launching the device model. Cu= rrently +required when launching the device model. Generate it by connecting to th= e parent +domain's QMP socket and issuing: + { "execute": "qmp_capabilities" } + { "execute": "xen-save-devices-state", "arguments": { "filename": "/path/= to/qemu.save", "live": false} } + +=3Dback + =3Ditem B [I] =20 Display the number of shared pages for a specified domain. If no domain is --=20 2.25.1