From patchwork Wed Jul 10 05:18:23 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Viktor Mitin X-Patchwork-Id: 11037867 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id E08FF13BD for ; Wed, 10 Jul 2019 05:21:07 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id CFCC028885 for ; Wed, 10 Jul 2019 05:21:07 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id BEB4C28837; Wed, 10 Jul 2019 05:21:07 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-5.0 required=2.0 tests=BAYES_00,DKIM_ADSP_CUSTOM_MED, DKIM_INVALID,DKIM_SIGNED,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 47EC928837 for ; Wed, 10 Jul 2019 05:21:07 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hl51D-0004jC-Eu; Wed, 10 Jul 2019 05:19:51 +0000 Received: from us1-rack-dfw2.inumbo.com ([104.130.134.6]) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hl51C-0004j4-AK for xen-devel@lists.xenproject.org; Wed, 10 Jul 2019 05:19:50 +0000 X-Inumbo-ID: 560138f2-a2d2-11e9-8980-bc764e045a96 Received: from mail-lf1-x142.google.com (unknown [2a00:1450:4864:20::142]) by us1-rack-dfw2.inumbo.com (Halon) with ESMTPS id 560138f2-a2d2-11e9-8980-bc764e045a96; Wed, 10 Jul 2019 05:19:49 +0000 (UTC) Received: by mail-lf1-x142.google.com with SMTP id x3so658463lfc.0 for ; Tue, 09 Jul 2019 22:19:48 -0700 (PDT) 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=HoEdBsNacU169ghkSAZ5UAjhcAjRwMgms47JX7xy4yQ=; b=uG8GpdpNccn8aq5suRC/6K2zkWnAYx1FrV5pJ3tA/nybSCvAON+B7p814HxrlNcJtq AH7fTmOeX5ZGINOvYkSWDLh3HblozNy5yzWQ81RVZMypA75ZoikzVxrWyCvUS6nSejhr itlrxaRYaBBP958c5KwDQEedMj5yhM4woccezqFBXLs3CJaOZaABLx1d1KKl47tPKhS7 QPLwwbmd++MuGDw8z3Mangr1/eKqB4yDDQIhkpcPXGvmJ/nmM88kU2zhnUS6f09+IHMd APpWnN0eIAaW3EaFK8jtfQY0BvN2jRk2R8JDx4k2+uuBlw/BcJeRGxZNK9JmU9X3KFrr Hw/Q== 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=HoEdBsNacU169ghkSAZ5UAjhcAjRwMgms47JX7xy4yQ=; b=mOAWbVtWh/A0gfrnbVREGp4cox5dH3PAsEB6MvnefPwoAgaXHk6SEuDOsVUouAnWOB R10CKtSnspG2VAstt8Z6O3o8JeX/SI/F9+6jPaCjNDsNmfjYgxaQjygpIunEsBCLLjJH GKYyHibREgTK7tpOULPTtVgF7zjWP2PCn3NkOUwMeW3s9N7siBkpyBeNa/vt89AZT8dv w+OfmJaDaYfTa4grqSqwDmmZLwviTNcjezPY7E3MgjTzPSBNQQ6owBrmzjczHb4064ra eL4/b26eUS7BILhYebiRfZiYx2VyXj86vzO903TN0e24sPMKd6Qkf8ydEr8GjVQ/6AAM J+Gw== X-Gm-Message-State: APjAAAUd0mCRS89KSoZ9RP65ZvMLhEP2B5/qVtiqPfkE76Cfuj/NZ96d JcJFZ8JNlQaoQjp3zADJ9/J3CH/yxdw= X-Google-Smtp-Source: APXvYqxDtFeulCZNVf2qcbPfWc1qvZ+mDVaVlpmy1iARqB1eX69UtM7VUSRIF0s16Qhz7ajCH8tHyg== X-Received: by 2002:ac2:518d:: with SMTP id u13mr1096275lfi.40.1562735987289; Tue, 09 Jul 2019 22:19:47 -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 m9sm186022lfo.45.2019.07.09.22.19.46 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Tue, 09 Jul 2019 22:19:46 -0700 (PDT) From: Viktor Mitin To: xen-devel@lists.xenproject.org Date: Wed, 10 Jul 2019 08:18:23 +0300 Message-Id: <20190710051823.29155-1-viktor.mitin.19@gmail.com> X-Mailer: git-send-email 2.17.1 MIME-Version: 1.0 Subject: [Xen-devel] [PATCH v3] 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 Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" X-Virus-Scanned: ClamAV using ClamSMTP - 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. - Added extra 0x0 to memory property in configuration example. This matches the binding docs/misc/arm/device-tree/booting.txt which requires a 64-bit value. Signed-off-by: Viktor Mitin --- v3: - Added extra 0x0 to memory property in configuration example. This matches the binding docs/misc/arm/device-tree/booting.txt which requires a 64-bit value. --- docs/features/dom0less.pandoc | 58 +++++++++++++++++++++++------------ 1 file changed, 39 insertions(+), 19 deletions(-) -- 2.17.1 diff --git a/docs/features/dom0less.pandoc b/docs/features/dom0less.pandoc index e076e3739e..d4f44b5502 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 Dom0: bootm 0x1400000 0x9000000 0x1280000 -If we want to add one DomU with Image-DomU as the DomU kernel -and ramdisk-DomU as 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,25 +61,27 @@ the presence of the additional VM and its configuration. It is done via device tree adding a node under /chosen as follows: domU1 { -     compatible = "xen,domain"; -     memory = <0x20000>; -    cpus = 1; -     vpl011; - -     module@2000000 { -         compatible = "multiboot,kernel", "multiboot,module"; -         reg = <0x2000000 0xffffff>; -         bootargs = "console=ttyAMA0"; -     }; - -     module@30000000 { -         compatible = "multiboot,ramdisk", "multiboot,module"; -         reg = <0x3000000 0xffffff>; -     }; + #address-cells = <0x00000001>; + #size-cells = <0x00000001>; + compatible = "xen,domain"; + memory = <0x0 0x20000>; + cpus = 1; + vpl011; + + module@2000000 { + compatible = "multiboot,kernel", "multiboot,module"; + reg = <0x2000000 0xffffff>; + bootargs = "console=ttyAMA0"; + }; + + module@30000000 { + compatible = "multiboot,ramdisk", "multiboot,module"; + reg = <0x3000000 0xffffff>; + }; }; -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 +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. See docs/misc/arm/device-tree/booting.txt for more information. @@ -111,3 +113,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 work. + + 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. +