From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7032205572624613376 X-Received: by 2002:a05:600c:4f0f:: with SMTP id l15mr4775661wmq.25.1637312950514; Fri, 19 Nov 2021 01:09:10 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:adf:fe0b:: with SMTP id n11ls2183770wrr.0.gmail; Fri, 19 Nov 2021 01:09:09 -0800 (PST) X-Google-Smtp-Source: ABdhPJzqLl5M8ZyrHXd4vyZTJ6m+dooB4EBbt0FutVY/RhIPIxIqKnpXyXjEkeCAYQCVg9w+44kG X-Received: by 2002:adf:e9c5:: with SMTP id l5mr5254852wrn.218.1637312949356; Fri, 19 Nov 2021 01:09:09 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1637312949; cv=none; d=google.com; s=arc-20160816; b=F7z4WaIieEgOn5p9f0YsE95PLLLC1fik7neQx4rtVSqbhJDYmu4Ba2lBteeH2F7J/X QA5+ODlP7AGGuGOJnqjoia5jtoBHqJMj8/FD2ysvdH2SOQ4uJ/4UuPn2LcliXKHl7yAF VjcS+sC5bAafKAKI/KRjMRNb0dbj9E7Wq14o55cgU3HaZG9+VOPh8ws/ePtqmIFUu+7Y qnU2RWNe7jMfcf6GXq/eWJIfmCDvJ+e5f1b6jeHoM9W4FxiuAjBscILdf+cVI4DcdQU5 DjHLVbEiPdanKBp+aeJVSG+Sjn7rCi63bPXrI+VreHs5Kf0b18vQVW2Cwl7soFyHju8z hHqw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from; bh=XvjIwcL1+oV3aHzkPU2ZS8V56wXeepNbkG/xNo75w6M=; b=Mg53+oWWBRp3Qy6XQElJR4lxetZs8IBMyMlYI6FEieVhqdh8fK/uNArktglRto8Du1 2Y9A+A9fjys3ys3c47uh2V2Dg5Y8RVuSk7l+DbLlTEgKMVfSPBg7S0RgYNf/IZnPmykp mgx+IX7xgJGxFPjI7fLhChDfYsn4LPp62atY9VAQ9Q09PgUt61EHdyP67H0GZsiWLNX7 mSg33n+xwniRGF2+EDcn48bSJ11w60mNvnOPvyURwiaCvQcZszj1/retTMZsZu1JKkhE zvbPCht+eFhuO+rFGHFkKWKlL4YWfhGTOeZzS5KHmhIwLooBCpzgjwreP4r0VmX5ewsV R4oA== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Return-Path: Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id z3si681503wmi.2.2021.11.19.01.09.09 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Fri, 19 Nov 2021 01:09:09 -0800 (PST) Received-SPF: pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Received: from baighyz.m.ilbers.de (host-80-81-17-52.static.customer.m-online.net [80.81.17.52]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPSA id 1AJ996ZH020180 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 19 Nov 2021 10:09:08 +0100 From: Uladzimir Bely To: isar-users@googlegroups.com Subject: [PATCH v3 5/6] doc: Update docs to fit new IMAGE_TYPE meaning Date: Fri, 19 Nov 2021 10:09:05 +0100 Message-Id: <20211119090906.31305-6-ubely@ilbers.de> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20211119090906.31305-1-ubely@ilbers.de> References: <20211119090906.31305-1-ubely@ilbers.de> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on shymkent.ilbers.de X-TUID: 9A/bF3bfwSNr While now IMAGE_TYPE allows to specify several image types, separated by space, this needs to be mentioned in manuals. Signed-off-by: Uladzimir Bely --- doc/user_manual.md | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/doc/user_manual.md b/doc/user_manual.md index 535d456a..f8f58a5c 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -210,7 +210,10 @@ tmp/deploy/images/rpi/isar-image-base.rpi-sdimg ### Generate full disk image -A bootable disk image is generated if you set IMAGE_TYPE to 'wic-img'. Behind the scenes a tool called `wic` is used to assemble the images. It is controlled by a `.wks` file which you can choose with changing WKS_FILE. Some examples in the tree use that feature already. +A bootable disk image is generated if `wic-img` is listed in IMAGE_TYPE. +Behind the scenes a tool called `wic` is used to assemble the images. +It is controlled by a `.wks` file which you can choose with changing WKS_FILE. +Some examples in the tree use that feature already. ``` # Generate an image for the `i386` target architecture $ bitbake mc:qemui386-buster:isar-image-base @@ -246,7 +249,7 @@ https://github.com/intel/bmap-tools ### Generate container image with root filesystem -A runnable container image is generated if you set IMAGE_TYPE to +A runnable container image is generated if IMAGE_TYPE variable includes 'container-img'. Getting a container image can be the main purpose of an Isar configuration, but not only. @@ -457,6 +460,14 @@ Isar can generate various images types for specific machine. The type of the ima - `ubi-img` - A image for use on mtd nand partitions employing UBI - `vm-img` - A image for use on VirtualBox or VMware +There are several image types can be listed in `IMAGE_TYPE` divided by space. + +Instead of setting multiple image types in one target, user can also use +[multiconfig](#building-target-images-for-multiple-configurations) feature and specify +different image types in different multiconfigs (use qemuamd64-buster-cpiogz.conf +and qemuamd64-buster-tgz.conf as examples). The only requirement is that image types +from different multiconfigs for the same machine/distros should not overlap. + --- ## Add a New Distro @@ -508,7 +519,7 @@ Every machine is described in its configuration file. The file defines the follo - `KERNEL_IMAGE` - The name of kernel binary that it installed to `/boot` folder in target filesystem. This variable is used by Isar to extract the kernel binary and put it into the deploy folder. This makes sense for embedded devices, where kernel and root filesystem are written to different flash partitions. This variable is optional. - `INITRD_IMAGE` - The name of `ramdisk` binary. The meaning of this variable is similar to `KERNEL_IMAGE`. This variable is optional. - `MACHINE_SERIAL` - The name of serial device that will be used for console output. - - `IMAGE_TYPE` - The type of images to be generated for this machine. + - `IMAGE_TYPE` - The types of images to be generated for this machine. Below is an example of machine configuration file for `Raspberry Pi` board: ``` -- 2.20.1