From nobody Fri May 3 09:51:36 2024 Delivered-To: importer@patchew.org Received-SPF: none (zoho.com: 192.237.175.120 is neither permitted nor denied by domain of lists.xenproject.org) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=none (zoho.com: 192.237.175.120 is neither permitted nor denied by domain of lists.xenproject.org) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=fail(p=none dis=none) header.from=gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1564560753; cv=none; d=zoho.com; s=zohoarc; b=M/4Jj091KKi/lvYAcV6ROPckqPYcY5kMmdriQXWxdXKFOK3Zb+0pCdHfmIbrycK1cxYYNn9VIenY1pM7eCS7lNJAmu7XbwJAdcQcNx6HaGFoS6H9GjQr3xjzuyKjsWp0hoVo7K59hdWK891KsPulRTPRcOrCqXUG8d6o2UnZH90= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1564560753; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To:ARC-Authentication-Results; bh=mVk1MUUYD3xk+vMIYy1Usv+TwYUJ+naxhigA4HeqI/Q=; b=N6Tc9nQlv1o/+hFVtAQnNJy07GDhJn8JHldfLutPv60gi/kyXp/62XxPbuGdCcgNpPHneSHllfnMRZCp2kb07zYBOGprtNOsdAKO9tVs+hdaWGBnZxVHZQ9BhurA23JHeKPt9eoR2GpVeZfeusd/Eim1dzd906aywpUpnpGVjTM= ARC-Authentication-Results: i=1; mx.zoho.com; dkim=fail; spf=none (zoho.com: 192.237.175.120 is neither permitted nor denied by domain of lists.xenproject.org) 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 1564560753505606.7678366924414; Wed, 31 Jul 2019 01:12:33 -0700 (PDT) Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hsjhP-0003Aw-K9; Wed, 31 Jul 2019 08:11:03 +0000 Received: from us1-rack-dfw2.inumbo.com ([104.130.134.6]) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hsjhN-0003Ar-UX for xen-devel@lists.xenproject.org; Wed, 31 Jul 2019 08:11:02 +0000 Received: from mail-lj1-x242.google.com (unknown [2a00:1450:4864:20::242]) by us1-rack-dfw2.inumbo.com (Halon) with ESMTPS id ba8fa511-b36a-11e9-8980-bc764e045a96; Wed, 31 Jul 2019 08:10:59 +0000 (UTC) Received: by mail-lj1-x242.google.com with SMTP id m23so64620679lje.12 for ; Wed, 31 Jul 2019 01:10:59 -0700 (PDT) Received: from 3489.kyiv.epam.com (ll-22.209.223.85.sovam.net.ua. [85.223.209.22]) by smtp.gmail.com with ESMTPSA id w21sm11720548lfl.84.2019.07.31.01.10.56 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Wed, 31 Jul 2019 01:10:57 -0700 (PDT) X-Inumbo-ID: ba8fa511-b36a-11e9-8980-bc764e045a96 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=xsINnE21/z12OwlHqK0OoKpO3sGIVxy04XBcQbkMZ60=; b=LywT52jhGYQ+Un9le1tytfl0DY8mJKyD+qqoAV4bZ5I3MaqOi86emtoS0GPRCLzf6b 7arlwrLZlblI84UFHW7wKuvXMMffFWc9RnQHlZ71rx+Ss045yFkXb8iv9JYjC13QMslE +tQWMd6YnvXCKDk5fMh66nGM3PtyDlkXMRXvuq01VhLG8qIhrm0Y33XVwsemSlebWev8 O6XH7jLmBqzPV/vtb1EKC/qyxHvCLKoI8qcUYBH3FcnCkxl+kaAQ0TRGwN16PUVoLWJT GhAh1w2Ndb2yS2ZSsJsMD/S/7MHlOvT+/AqS+4iU1vBKfRKIoSRYz2+IYa1vLI90UHOs Ir4A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=xsINnE21/z12OwlHqK0OoKpO3sGIVxy04XBcQbkMZ60=; b=DthcgI9O3IW9V4zmP/RbptRXxDG9kYSdUpI8XNvA/pc0RWtwHEuv2Vp4Ez3e7z6pJu Y2rOjbY2Wq0OXzFEMLSkuTu9ZmWJtN/RxV93dca/0D2DH+jrt8konl5Kx+yDxRs2fywd c9pXnB9rgp7B79w2UhX7tdFS0bDw4TpOQm8v6rCwP2ipaY0iv+9o+uSs1PcLOdBwdYA3 BdH6rghJO0KilYgKPtWN0lCpnQSVT9zjFJ5fi1nkkzRqwdADNVpYpDqoqLNfgAbC/19L X7N+/qS8shyezFQcfhn3KlphQ0l7W9xiF1AwtK+0LX3K7+7LsfNsoBNgVErI8JbYxLNY e+Ug== X-Gm-Message-State: APjAAAUJVWH4x3EZc6UF7Yixm6I2NuYhCqTS0vLKFw3O4sHx1OViN8AO ZrHfuwFgYoZmniWI/GRk6BhveCE2gwU= X-Google-Smtp-Source: APXvYqw9M5AiEPuzLLcYbAMrDeiLAcPaMDuwaYWE9Do5YmOA7j7kPHUyG6775OmQdjh9wPr3ievsyw== X-Received: by 2002:a2e:7c15:: with SMTP id x21mr18951ljc.55.1564560658133; Wed, 31 Jul 2019 01:10:58 -0700 (PDT) From: Viktor Mitin To: xen-devel@lists.xenproject.org Date: Wed, 31 Jul 2019 11:10:41 +0300 Message-Id: <20190731081041.25256-1-viktor.mitin.19@gmail.com> X-Mailer: git-send-email 2.17.1 MIME-Version: 1.0 Subject: [Xen-devel] [PATCH v4] xen/doc: Improve Dom0-less documentation X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Cc: Stefano Stabellini , Viktor Mitin , Wei Liu , Konrad Rzeszutek Wilk , George Dunlap , Andrew Cooper , Ian Jackson , Tim Deegan , Julien Grall , Jan Beulich , Viktor Mitin Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) - Changed unprintable characters with %s/\%xA0/ /g So all the spaces are 0x20 now. - Added address-cells and size-cells to configuration example. This resolves the dom0less boot issue in case of arm64. - Added some notes about xl tools usage in case of dom0less. Signed-off-by: Viktor Mitin Acked-by: Julien Grall --- v4 updates: - fixed cpus <1>; - added memory size note; - changed some numbers to decimal; --- docs/features/dom0less.pandoc | 61 ++++++++++++++++++++++++----------- 1 file changed, 42 insertions(+), 19 deletions(-) diff --git a/docs/features/dom0less.pandoc b/docs/features/dom0less.pandoc index e076e3739e..a2c95d1fd4 100644 --- a/docs/features/dom0less.pandoc +++ b/docs/features/dom0less.pandoc @@ -40,8 +40,8 @@ to boot. For example if this is the bootcmd for Xen and D= om0: bootm 0x1400000 0x9000000 0x1280000 -If we want to add one DomU with Image-DomU=C2=A0as the DomU kernel -and=C2=A0ramdisk-DomU=C2=A0as DomU ramdisk: +If we want to add one DomU with Image-DomU as the DomU kernel +and ramdisk-DomU as DomU ramdisk: tftpb 0x1280000 xen.dtb tftpb 0x80000 xen-Image @@ -61,27 +61,32 @@ the presence of the additional VM and its configuration= . It is done via device tree adding a node under /chosen as follows: domU1 { - =C2=A0 =C2=A0 compatible =3D "xen,domain"; - =C2=A0 =C2=A0 memory =3D <0x20000>; - =C2=A0 =C2=A0cpus =3D 1; - =C2=A0=C2=A0 =C2=A0vpl011; - - =C2=A0 =C2=A0 module@2000000 { - =C2=A0 =C2=A0 =C2=A0 =C2=A0 compatible =3D "multiboot,kernel", "multib= oot,module"; - =C2=A0 =C2=A0 =C2=A0 =C2=A0 reg =3D <0x2000000 0xffffff>; - =C2=A0 =C2=A0 =C2=A0 =C2=A0 bootargs =3D "console=3DttyAMA0"; - =C2=A0 =C2=A0 }; - - =C2=A0 =C2=A0 module@30000000 { - =C2=A0 =C2=A0 =C2=A0 =C2=A0 compatible =3D "multiboot,ramdisk", "multi= boot,module"; - =C2=A0 =C2=A0 =C2=A0 =C2=A0 reg =3D <0x3000000 0xffffff>; - =C2=A0 =C2=A0 }; + #address-cells =3D <1>; + #size-cells =3D <1>; + compatible =3D "xen,domain"; + memory =3D <0 524288>; + cpus =3D <1>; + vpl011; + + module@2000000 { + compatible =3D "multiboot,kernel", "multiboot,module"; + reg =3D <0x2000000 0xffffff>; + bootargs =3D "console=3DttyAMA0"; + }; + + module@30000000 { + compatible =3D "multiboot,ramdisk", "multiboot,module"; + reg =3D <0x3000000 0xffffff>; + }; }; -Where memory is the memory of the VM in KBs, cpus=C2=A0is the number of -cpus.=C2=A0module@2000000 and=C2=A0module@3000000 advertise where the kern= el and +Where memory is the memory of the VM in KBs, cpus is the number of +cpus. module@2000000 and module@3000000 advertise where the kernel and ramdisk are in memory. +Note: the size specified should exactly match the size of the Kernel/initr= amfs. +Otherwise, they may be unusable in Xen (for instance if they are compresse= d). + See docs/misc/arm/device-tree/booting.txt for more information. Limitations @@ -111,3 +116,21 @@ limitations: the Xen command line. The NULL scheduler automatically assigns and pins vCPUs to pCPUs, but the vCPU-pCPU assignments cannot be configured. + +Notes +----- + +- 'xl console' command will not attach to the domain's console in case + of dom0less. DomU are domains created by Xen (similar to Dom0) and + therefore they are all managed by Xen and some of the commands may not w= ork. + + A user is allowed to configure the key sequence to switch input. + Pressing the Xen "conswitch" (Ctrl-A by default) three times + switches input in case of dom0less mode. + +- Domains created by Xen will have no name at boot. Domain-0 has a name + thanks to the helper xen-init-dom0 called at boot by the initscript. + If you want to setup DomU name, then you will have to create the xenstore + node associated. By default DomU names are shown as '(null)' in the + xl domains list. + -- 2.17.1 _______________________________________________ Xen-devel mailing list Xen-devel@lists.xenproject.org https://lists.xenproject.org/mailman/listinfo/xen-devel