From patchwork Thu Oct 28 08:17:25 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anton Mikanovich X-Patchwork-Id: 971 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3) with LMTPA; Thu, 28 Oct 2021 19:17:55 +0200 X-Sieve: CMU Sieve 2.4 Received: from mail-lf1-f57.google.com (mail-lf1-f57.google.com [209.85.167.57]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPS id 19SHHqlW018364 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Thu, 28 Oct 2021 19:17:53 +0200 Received: by mail-lf1-f57.google.com with SMTP id i1-20020a056512318100b003ffd4e89eb9sf2490866lfe.19 for ; Thu, 28 Oct 2021 10:17:52 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1635441467; cv=pass; d=google.com; s=arc-20160816; b=GCiIFCqma245NMG0ZJ9+W4cCLs0UBj6lnDksTuDz9EVhYqRcjdPj79gWNBg6jvHAHS ICBIhFSIY5Vc/VKNwKnRWabTsLPos8VG2A9WSQtgVCyyvAFeOeaLP5Xr02aomTRV3XQC rx74mnj6ewTE5lhg5ErTcsglqGp1VH5gW6TJLX1+BzhCsIsoAvhVfOtfEFUnGiXM8/t8 npQxr6HiFOhRzMjKJS2lwGRIRgaROcd7hpA3JSVFdrGJNdqCIzXIlDKBwUYQmtkNuT8D 4famMPAVisdUIvLLLHCy2TmpRr6qnrNlrTKUPf1Mt2MpuH5kI8lJIzsJVBgQqas+iQIG M3gw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:sender:dkim-signature; bh=TmOxTHEv+XiUez3tYj/JYH8yzKmb2OOBc003sYGV8mQ=; b=i/zPxCbMW82/qLI9aNJ2/C99XCNK/KKOaFdjMGsr6QDox8GvxV1esX6AgYsJpsCNd4 Nueojty7x0wDba5PvYcJExSjZybGtXl2JxbNdvJTHpMvtjP/vb2TTEuO/hNzVAIeN4O9 gU7uoez0vj/lHMG3b3zAJ6O82fgYK63ailX3C0csns1C5ILBs1VOtAQpgad8Hev9Ulxu zxXio5ZXOeODBjDn3o+g7ps/x3bVYKriB++tcTxX76eoGwDf3n/JfAtHWgA62ogfLFLj 9dYSWYTkjm6yjTCFdE8A9P0sP722tVjgQTdwkx6BjR+B+ALkeNTC7LBwdJe28NaBD7VR HTJA== ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20210112; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=TmOxTHEv+XiUez3tYj/JYH8yzKmb2OOBc003sYGV8mQ=; b=PMdAMSPWplkKaETfBsznuRkXOT+i2zLNB3+umegtafXfuvieNspKXdxDSzl8i5O7lx ks18VOLl15dSQbfxS48dXjWdIZto9auZ5n4Q7NsPeyEqHWmWjJiJIIaARaxxte3W6703 BsUDP3kxo4nbKqK9WSLEP7vz1BHRnNTd1wh+nv0xW2tHi3bz23M5Bke8W+JZmWNEhM06 tKcVFLQhgs90sgAZlFKv9xuXZVZ+ZzahgHb3Enac3itOA+bERewdDqk8aC6EQBRWxOe0 DWCo8qwA8Ln6kGnv4EgKlg9UT6oWDKjCNywtpPy0mcWf+ufn3InFz4c8PyZqfxqQ/4vg k44w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=sender:x-gm-message-state:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=TmOxTHEv+XiUez3tYj/JYH8yzKmb2OOBc003sYGV8mQ=; b=5f/Yw6MZVDdxFrVOwr4tBGRUXiIWWMJIYCOBoQVQEZcLlpIa09TL7NrRzoyM4yIiUy Mif9SF0/dPQqgKeKRuEz7xw10nftN0/UD3pIJ2nDsfiHx4o6SD5KjbWfXYUV+iV0hywZ 0BODvpg5bY1efVwUcV4duWxSXFnGaMbQd3mgNqm+z7f9tg0GfdsHSuKbEbJopdM1Zw/P s5PEOIukZpyHbC1M1EjybxijL20/vjfiML+C9csEl9autL6cm8OzpjT22xjPoPRO7oy9 LUrmrODs04RvDEKgEQxhWWNkSJPtDroURpw68lpFxiBH/pxLhFyxSg5X6nVhYuiqTgV4 58Cg== Sender: isar-users@googlegroups.com X-Gm-Message-State: AOAM533QIuvOHn10DJW6A4GCoWPP/PdxFrJeeqJjWV/0RjqPVrjsPYuH BQiOk+Li78Bi5QGC5WF5UTc= X-Google-Smtp-Source: ABdhPJzbkn/gOpIZfjofaCGMXkriSfBlcqCQgGUTOIH2SJE3x2x6rfn3JfSFMcK4t+nxgaqAYl1+1w== X-Received: by 2002:a2e:85d0:: with SMTP id h16mr6029883ljj.322.1635441467428; Thu, 28 Oct 2021 10:17:47 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a2e:a794:: with SMTP id c20ls781347ljf.2.gmail; Thu, 28 Oct 2021 10:17:46 -0700 (PDT) X-Received: by 2002:a2e:8041:: with SMTP id p1mr6375014ljg.158.1635441466261; Thu, 28 Oct 2021 10:17:46 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1635441466; cv=none; d=google.com; s=arc-20160816; b=JF5Gop/uRFV7dsTa8RLuUP5y3iOGIrYj56tje4ThkIyeiBOVSZgQgGXJyeCYEDHoqi wGUtGSMEjMt/SDB5Ktv9fX9xowGpCPkZhCvjnS/PzHhfTowAKV0qUdJGcX/V3a7ETe17 Diiigt+cXMPvURPLEyDrvGpfWj6kw/upmjFVM7USovqtSdIMpaCdlwxlohWXvgv+oh03 c3kALLiQn48MOKESzjcY86sPtXhgQH5EHjnxGIyzybco5eFea6+jTIzsvRcOL9m9p2pB R9TVEAW8iRBn0VZQUZOPgyTI9xpME1J78wNldyBuePf22HmtRFmBHbT8PXMsBDNOAfkE IVsA== 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:cc:to:from; bh=nJ3f6zMlN/it+lNdP5/HWEhBCnNoK+c+nyyhJ+jmtO8=; b=Boyh5DHpzFYypE4ntvVAKwhFOV4+25qpZW/LLeRFH+Qy3zjCuZudoqg/juCzB/30eT fIGfP6WwM7MiAc8OxCYOScGe5Ris8B/JG0r7MtTvn7sUZ1guZ6+cnfWSBn7ain/MyPt1 yi2EnQgS13h5PCZv4Umh/G3bIgR5b2Y/rVXcK7ZskdDrgq9j98swI8JfDcxAfXswT5aK T42i94O+UNLIxB1OVUSooO4xw7VKdXTG2QaDiIQ0ImE4u4w4AFhH2qQATQlIcMlrMf7T 0OJVEHpmQZfo+NbcYIfn4psC8gczKFwamRo8sBBioudy8ZwPqwzVMN8hPji9/0oqoJ+4 1VpQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id z1si229898lfu.5.2021.10.28.10.17.46 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Thu, 28 Oct 2021 10:17:46 -0700 (PDT) Received-SPF: pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Received: from localhost.localdomain (mm-42-79-214-37.mgts.dynamic.pppoe.byfly.by [37.214.79.42] (may be forged)) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPSA id 19SHHYs8018353 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 28 Oct 2021 19:17:43 +0200 From: Anton Mikanovich To: isar-users@googlegroups.com Cc: Anton Mikanovich Subject: [PATCH v2 1/3] doc: Add imager dependencies section Date: Thu, 28 Oct 2021 20:17:25 +0300 Message-Id: <20211028171727.246342-2-amikan@ilbers.de> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20211028171727.246342-1-amikan@ilbers.de> References: <20211028171727.246342-1-amikan@ilbers.de> MIME-Version: 1.0 X-Original-Sender: amikan@ilbers.de X-Original-Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de Precedence: list Mailing-list: list isar-users@googlegroups.com; contact isar-users+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: isar-users@googlegroups.com X-Google-Group-Id: 914930254986 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , X-getmail-retrieved-from-mailbox: INBOX Include into user_manual.md explanation of imager dependencies should be added if using wic image type with bootloader-related plugins. Inspired by issue #69 Signed-off-by: Anton Mikanovich --- doc/user_manual.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/doc/user_manual.md b/doc/user_manual.md index 01fe701..1b00a47 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -586,6 +586,22 @@ Isar contains additional image type classes that can be used as reference: - `ubi-img` - `wic-img` +### Imager dependencies and bootloaders + +External tools used for final image prepare inside image type classes should be declared as `IMAGER_INSTALL`. +It will make Isar to install following packages into buildchroot before proceeding. + +If using `wic-img` image type correct bootloader dependecy should be added to target machine config based on selected wic plugin. + +When using legacy BIOS bootloader (amd64/i386 only) dependency on syslinux should be used: +``` +IMAGER_INSTALL += "${SYSLINUX_BOOTLOADER_INSTALL}" +``` +When using EFI bootloader dependency on GRUB should be added: +``` +IMAGER_INSTALL += "${GRUB_BOOTLOADER_INSTALL}" +``` + --- ## Customize and configure image From patchwork Thu Oct 28 08:17:26 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anton Mikanovich X-Patchwork-Id: 972 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3) with LMTPA; Thu, 28 Oct 2021 19:17:58 +0200 X-Sieve: CMU Sieve 2.4 Received: from mail-wr1-f55.google.com (mail-wr1-f55.google.com [209.85.221.55]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPS id 19SHHuRO018376 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Thu, 28 Oct 2021 19:17:56 +0200 Received: by mail-wr1-f55.google.com with SMTP id i2-20020adfefc2000000b001709de9b770sf2359633wrp.16 for ; Thu, 28 Oct 2021 10:17:56 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1635441471; cv=pass; d=google.com; s=arc-20160816; b=DbTABSyPTlaVDMev3YvNvGu0PUUbq8PRj6y16lK+A+2v81ZYGJc6uuAQgrVjLaIh+C ao4CbTeAAK3JZUGsaIRDINFnfJ1mD4Fq+RNTm680/AnhBGIZo+naAhNkco4e+GZNpysN eUqSX4pTOfaIZGPtat5Wnd7KkN29eW9tfMdL3Z/ybVVJ4PonC+jKPdlYt0W7anAl5TEe oza805fDkYHx2HJHEaBDaodUE5BR+wP1NlmMgH7r0z2bLji4IPol1JeY2CtbF1Bd+SGr 4stCU1m1pD6Cgah0/CjAd/HhY8renGwwu3qKhp3PiEQRQyhAcFl/NW2VBnv5gZiHYPjc 6s+w== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:sender:dkim-signature; bh=msED2isw9hLkUdQ8yMF2wvdHOj4cOKu46UbztPRYzjg=; b=QtqbdeqggxAhnMo2Kt2ZA37oFlkpxKJe3GvePhI8gGCe1osU5umQI8UsWLh2x77hYY zJG9xmsVl/ODCqwRb//HP37eHdYYSqNih/NMReHhQBw5KneZBDL9GzOZKXBWFrvEWRIw S6w+uJ9PVrHcMRR0eEdb1JA2Bu169Xat7scFnrk5wwRKNNAj734qx2NDgZNVcYsvMm5Y D/V0Ff7+S0HAHAvuhuGc35SL8YDH+SYatkze2qN/36UyFlmApF2vRcWGpqkz73OYzHAN emWG/t6++CPYVa4mGU0mehUBMvbGq7I/GhOpFFyR4JYN551ClNv0QXumPADl2HlXV61f qvjQ== ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20210112; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=msED2isw9hLkUdQ8yMF2wvdHOj4cOKu46UbztPRYzjg=; b=WZGQqpmPOafE7qOVEgqQqTxLmwGcwZFdDIi2Pm466ZpKh2TLgEmVykWb0tx/wwQLB1 yHWFCBr1swuQJVRWGMTppcQIe5dsEb7Eo6zNOjjlL8j1Wn1QLJC58uuS+xn8TZDUeq9R 9WZ2mZJYoxoOaXkdf4WUucO6gmTgc5xE3UjzLML6pjbmdw3mwBh4JeRK4uxGLmhZAS+Z oF4rkevH3tfQuYnby7dYMDemSv/4kHbLOHa2b41hDIts+WqMfUCBcl1UmSNtZ/T7o+CP aijhX26fH4k8lzOKA2GTN/R9jrMxhbLFd8cxnty4o36UEfA/Ffl79N/jg55CQvct+d6g omHQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=sender:x-gm-message-state:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=msED2isw9hLkUdQ8yMF2wvdHOj4cOKu46UbztPRYzjg=; b=a/eJPPindu2rM8OnAN/oJRybvHEfGCebZt8HlJcKlaZJ5uOlheDP2EPkOKAIIiRf5P sB5Q4ikHTt/NigMrh+M4NUO/o3DweHkRhFTPcLxaMVHFCk7H4fs5m/t98CLnW6d/pxVr sYuF8ZiWPqgDWgJBsRKpgIZ4PpEiQLG/xjed8S/q/Z1JxDVVvJkWx4nPpes+amvV5EdT tXoHH8rbS1hsUTC8rl58HF+3YVDdkhfB+W4f2WtkheIJEMAeQdNcmYVVGdbDdZ9ujCIL ph1X/4geDjxxLTn0hjjzmnEOYS3F3++y1clEuXV8weGPArHWDJvUVrPfRiBDWw0ZOdar aGmw== Sender: isar-users@googlegroups.com X-Gm-Message-State: AOAM533F877LHVeuNj/PuzmJ3HSxjPDc+oCqFtfssgZxJHujn950koAR p4cmHpOyG123MiWkdao8Isg= X-Google-Smtp-Source: ABdhPJy/8QUqUt74ugCJ4dE9mXJ3ADX1mlRsE0KhkmiGz9rR81xIPLy+IeXLnVUMyBePVhCpZqDuaQ== X-Received: by 2002:adf:9dc1:: with SMTP id q1mr7387419wre.13.1635441471342; Thu, 28 Oct 2021 10:17:51 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a5d:4e85:: with SMTP id e5ls4603208wru.1.gmail; Thu, 28 Oct 2021 10:17:50 -0700 (PDT) X-Received: by 2002:adf:ed41:: with SMTP id u1mr7525635wro.346.1635441470452; Thu, 28 Oct 2021 10:17:50 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1635441470; cv=none; d=google.com; s=arc-20160816; b=c0d95wHyHDZJyadXQXPMWCWOCvS94SVuyS4tH6BvCEoGsEBEUPehT8KAd/jH0YlwTt kxI+LL1L7EIYR1wfgnhmbhqHO9atzRgkhBeiSaVyWB2yiyNnvOLC9o0tZjBhzNsMJ9cz 4fhfKFu7X98721k4zG6xqwfgDqtcetH1B98JlO6v5kM/fIQ0BJ8efs3SfAMvs4WyQhuq 68aROIGiQ4cd9wYZ5WSPKYbl7wQK6iZVu0j0V5ZOdhfvux+u3BFPuOHxy9D8+oh9xMc9 aNV8BUTjJ2I41owMidOFQ2XPfB7y3LVw9AUyMlVOOpcoDC3Gc/gbHL/GZiR5nNBKZ3xD YeUw== 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:cc:to:from; bh=6oGOXU+gHHvrTp8eCzQwjVPx3CVCBvn80kxL5+qy4h4=; b=VtNuADCa0349Yrd9Poal4onOnBE6iYtFYSzkqzAQTRBE1ltTbqd9zKO+lVuPerD97C VPeK2z124NuAaoNa7FZAj2BKcgRLINMY+58wETEYk5YGmYe7JhoNXfAjqyTBbNYhGbbU o4aeygpgVUygCkrgIWCdkKRPx+A3wiFZOG/xFAov8fbqtpvnZWQ9daCvEuDk2GPlz260 FqjKQksKkjRPZHn1Bb9W95+E06dOFADcF2wvddrD5BreGkdYRRfgroE0pYgYnTSPAllz 9LmQ/BJ4rnFgjxbYaiA2CEfHUFXr5mNOA7sN4YiRljCHZYeOLvkPtFpi24rbHPCm4fuI +ugQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id a10si322119wmb.0.2021.10.28.10.17.50 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Thu, 28 Oct 2021 10:17:50 -0700 (PDT) Received-SPF: pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Received: from localhost.localdomain (mm-42-79-214-37.mgts.dynamic.pppoe.byfly.by [37.214.79.42] (may be forged)) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPSA id 19SHHYs9018353 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 28 Oct 2021 19:17:47 +0200 From: Anton Mikanovich To: isar-users@googlegroups.com Cc: Anton Mikanovich Subject: [PATCH v2 2/3] doc: Update tasks description Date: Thu, 28 Oct 2021 20:17:26 +0300 Message-Id: <20211028171727.246342-3-amikan@ilbers.de> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20211028171727.246342-1-amikan@ilbers.de> References: <20211028171727.246342-1-amikan@ilbers.de> MIME-Version: 1.0 X-Original-Sender: amikan@ilbers.de X-Original-Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de Precedence: list Mailing-list: list isar-users@googlegroups.com; contact isar-users+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: isar-users@googlegroups.com X-Google-Group-Id: 914930254986 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , X-getmail-retrieved-from-mailbox: INBOX Update task list and description for `dpkg.bbclass` and `dpkg-raw.bbclass` to correspond with the latest state. Signed-off-by: Anton Mikanovich --- doc/technical_overview.md | 56 +++++++++++++++++++++++---------------- 1 file changed, 33 insertions(+), 23 deletions(-) diff --git a/doc/technical_overview.md b/doc/technical_overview.md index bbd22b6..225475e 100644 --- a/doc/technical_overview.md +++ b/doc/technical_overview.md @@ -214,41 +214,51 @@ Both consist of the following steps: 2. Task `do_unpack`: unpack those files to `${WORKDIR}` -3. Task `do_install` _only_ for `dpkg-raw`: copy all you want in your +3. Task `do_transform_template`: process `${TEMPLATE_FILES}` to substitute + variables listed in `${TEMPLATE_VARS}` in template files + +4. Task `do_apt_fetch`: fetch source files from apt repos + +5. Task `do_apt_unpack`: unpack those files to `${WORKDIR}` + +6. Task `do_patch`: process .patch files in the `${SRC_URI}` + +7. Task `do_install` _only_ for `dpkg-raw`: copy all you want in your debian package to `${D}`, install hooks in `${D}/DEBIAN` -4. Task `do_prepare': perform any preparation steps to the unpacked/patched - sources before the build. This task calls the dpkg_prepare shell function - with the buildchroot mounts in place (`dpkg_do_mounts') +8. Task `do_adjust_git`: adjust alternates links inside git repos in the + package workdir to make them valid inside chroot + +9. Task `do_prepare_build`: perform any preparation steps to the unpacked and + patched sources before the build. - 4.1. the `dpkg_prepare` function of `dpkg.bbclass` runs `/isar/deps.sh` in - the buildchroot. That performs the following: + For `dpkg-raw` it perform `deb_debianize` call to translate the recipe + meta-data into a debian/* files suitable for building with dpkg-buildpackage - 1. Go to `/home/build/${PN}` +10. Task `do_install_builddeps`: install build dependencies of the package. + This task calls the `builddeps_install` shell function with the buildchroot + mounts in place (surrounded by `dpkg_do_mounts` and `dpkg_undo_mounts`). - 2. Get list of dependencies from debian/control and install them + The `builddeps_install` function of `dpkg.bbclass` runs `/isar/deps.sh` in + the buildchroot. That performs the following: - 4.2. the `dpkg_prepare` function of `dpkg-raw.bbclass` translate the - recipe meta-data into a debian/control file suitable for packaging - with dpkg-deb + 10.1. Go to `/home/build/${PN}` -5. Task `do_build`: mount folder (`dpkg_do_mounts') with unpacked files to buildchroot, - execute the actual build function `dpkg_runbuild`, and finally umount again - (`dpkg_undo_mounts') + 10.2. Get list of dependencies from debian/control and install them - 5.1. the `dpkg_runbuild` function of `dpkg.bbclass` runs `build.sh` in the - buildchroot. That performs the following: +11. Task `do_dpkg_build`: mount folder (`dpkg_do_mounts`) with unpacked files + to buildchroot, execute the actual build function `dpkg_runbuild`, and + finally umount again (`dpkg_undo_mounts`) - 1. Go to `/home/build/${PN}` + The `dpkg_runbuild` function of `dpkg.bbclass` runs `/isar/build.sh` in + the buildchroot. That performs the following: - 2. Run dpkg-buildpackage + 11.1. Go to `/home/build/${PN}` - 5.2. the `dpkg_runbuild` function of `dpkg-raw.bbclass` basically runs - `dpkg-deb` to construct a Debian package from a folder of files, - without compiling anything + 11.2. Run dpkg-buildpackage -6. Task `do_deploy_deb`: install successfully built packages - `${WORKDIR}/*.deb` to deploy directory `${DEPLOY_DIR_DEB}` +12. Task `do_deploy_deb`: install successfully built packages + `${WORKDIR}/*.deb` to deploy directory `${DEPLOY_DIR_DEB}` ## 3.6 Populate Target Filesystem From patchwork Thu Oct 28 08:17:27 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anton Mikanovich X-Patchwork-Id: 973 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3) with LMTPA; Thu, 28 Oct 2021 19:18:02 +0200 X-Sieve: CMU Sieve 2.4 Received: from mail-wr1-f55.google.com (mail-wr1-f55.google.com [209.85.221.55]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPS id 19SHI0Qm018401 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Thu, 28 Oct 2021 19:18:00 +0200 Received: by mail-wr1-f55.google.com with SMTP id y16-20020a5d4710000000b0017440201e67sf1904941wrq.1 for ; Thu, 28 Oct 2021 10:18:00 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1635441475; cv=pass; d=google.com; s=arc-20160816; b=gRC6z67NWfhAODXwFC8D9K3XZWFNa0kS8HFqESm/xDLYBxjt8mmS2QKOFnGZtQ4o/k iq6Q0vBAsllv97Wk+kCsVo5mbcPR5+YChkjGm7Iyd/5kq0ktVdMPDjVFROidfrU/GRu3 XsYAF60NGAsRaBpmH0OlBgDs8of5QH89cPPO45DDn3LICB5kjyCRkoEyGg9JrROJdjpg SUAaT7VU4YXrH7lfX63I1Cwd2fzYGUkS0CYkwKwk8JnOhZonU0x5Lxxg1O/qzJqCWJAa zLQdb9BARK3NEa1rT3ZSzbYVmMOOoIBzAjTjY3/46AolmvA23NG1/2HufgruCSSFw7wV PvCg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:sender:dkim-signature; bh=kpVB8FQYaRXHuqXMobEyBFXvq5YxKP+mxvSm5gUvz1s=; b=NIA4ZhA38t7sXAB0DeGCjF2q5HWEgt8uSA0wW/CbGv3huDw1sQtf733v2GAvM0Jf0v aL8zeuAOgVLcG+ZlpmH9SF3fmdgqOH30bxHB0Ke11hiMvfJ07Gh+ahYYzHMYq5WtdYE6 vIWpDaPm0DK/PAHSY2aF0VmRIKwBarpZ4+Xlu4ln8IN8S+oA/4tofC0mpwsCTXrQtXM5 WgSGNTml6M9hsEjP3E7mbVwyV7WK3wGvYZFRYxX/5ogmCUIwhcSrpqSXEBpU7g2lM30l v8LoNYxNhIxynv496BFD/wehbDckd6AbxhvaOCwIRUcEeWzDuA8KT65DjuWXpqmOAL7f hqKg== ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20210112; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=kpVB8FQYaRXHuqXMobEyBFXvq5YxKP+mxvSm5gUvz1s=; b=OBRyDfzzt9dGLWmRzRQmgjCcpJHDCXGgDKFlV/jk+1AXgTvFSsgcstVH52E6x/7T3G eTmmchWHHxeyyHnM1ruP71BatyIuANOWecDNSB2n/76MuGwnSzlkxmcYT1OIncMP+hQd PYTuhmofw2FVllUpzm23r5xqIBqi1lkUbwJ4gfhfBsOPyMvHFp9HLzSrYPOQQYNXEP7m Z1wGbBvFNSzSNoQYcWuTxh1Voao9vEDnOshIcf2lP1BbWMYu6Lb9mHewVPoeKSFOAuAM 9E7G2ljtr/GTP+D6wNUtGBHWYHLd8lMzvD5hYQJWhkQC0EgDpg7bl+d5XMF9RYNXuNh3 R51Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=sender:x-gm-message-state:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=kpVB8FQYaRXHuqXMobEyBFXvq5YxKP+mxvSm5gUvz1s=; b=gM/Xluy84cTahaMp7NxwZ56BEEf40rexooCV4Seyc09IfkFotOayYONDvPWRj0vrXo JfqfWc2sRaQeS3+ie1CLyOY/eeS7Lj/zE0p3lv8ROfmYdeJ3NuvLzGWlDyg5UdpsECQK rfGgz1jtBVM3jvfnj4yUqGuwDOSaq6hSoo28jVfmQXad2Ztw48FaOh/rP2yNP5Ui1YQp gygOgvQfNMf1yhmRuQ8nyZTKhCWPGgm2HNbJmGQz9SoXuqCW5d337fGAKnQD8tMYl1JQ 0lPiEWdJ+LlW+KBgt3LROInBKUr7Pkawruo1b6QhoxRTfptD7e9/QP1QqjbG1aJhmPmQ JPHw== Sender: isar-users@googlegroups.com X-Gm-Message-State: AOAM530A5PBcFFPaVt+wf3HTyveMGPyToyevmMQfok62Q3kyVBilcwPj R2StnEbPr0sGSg+R4qwaTLw= X-Google-Smtp-Source: ABdhPJy4udd3cmmZFV+IhDwxbrMXyJdEaAFYNFyyFP1PQHpeYENrvT7biWZ4zHHqvdNhMJfE0vX1nQ== X-Received: by 2002:a05:600c:1990:: with SMTP id t16mr6061775wmq.124.1635441475331; Thu, 28 Oct 2021 10:17:55 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:600c:4f08:: with SMTP id l8ls3846461wmq.0.canary-gmail; Thu, 28 Oct 2021 10:17:54 -0700 (PDT) X-Received: by 2002:a1c:1c1:: with SMTP id 184mr2222001wmb.1.1635441474458; Thu, 28 Oct 2021 10:17:54 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1635441474; cv=none; d=google.com; s=arc-20160816; b=URnGy8WBLN2VVxLRBpUC4sSRne6O3+jjXljxIMvltQ8hylDqZFkPL+56gvn02MLPLj gJyxqfaSsVtwUK9j1bf8DAQ3rArlDGt9XMmr4f97hQhAk7V/UQWzxDu6ED0VbNRHankU BkKaif0EUXV9i036wwZmhCnsY26JKzMh7APg/comKR/YMwHeUc8HgIdTbq0AirTB1C4a df1fVkwSjjIxc1Aqxf+UpeifDNO6ijRrMCzjMGbfJ2R9xgCnqv7+GAV3ZX1YcHrsdv26 3kkSlpprThr1BHdp7ltLUCqmZaUNEvfscdq6jCH15Xvi8cGBstrP/zJP/e6Z5+qdH4A9 tQNw== 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:cc:to:from; bh=AFBd0U7AMvH50Zn3y9TjOt3NAe124ebgNs0QMs2oPks=; b=KBniRSLi05rwFbAV1LfwVTnm2uk/dmaff6nYcU0OzQBLViREagErUKnRyPd9GBkfhm IE//UwdpW40ORR+dsKHi/u4rZavJraFmOREKvIVZHh/q+gSj9/+VKSaZoPsrHb8UZLzk I+JJNIC4x/TJFZOKpQA0wh0IQQYonCO+AsHCQ+5ijfg4l4H1cFOIsc59cBtTiIJcNZBo svfz36HE/MzpE+im+2soNH+HjEfJCbxWiXxF/UMDeYOcmTIyvlwYBL/ReDoPTRzmITNH 4YtmFvrPtb190gTNfJxkPmrlpNNffNFHazu83rJuCG+fBNrIIuMBdpFAHmtyfu4ibV6M icMQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id a10si322133wmb.0.2021.10.28.10.17.54 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Thu, 28 Oct 2021 10:17:54 -0700 (PDT) Received-SPF: pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Received: from localhost.localdomain (mm-42-79-214-37.mgts.dynamic.pppoe.byfly.by [37.214.79.42] (may be forged)) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPSA id 19SHHYsA018353 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 28 Oct 2021 19:17:51 +0200 From: Anton Mikanovich To: isar-users@googlegroups.com Cc: Anton Mikanovich Subject: [PATCH v2 3/3] doc: Update available image types Date: Thu, 28 Oct 2021 20:17:27 +0300 Message-Id: <20211028171727.246342-4-amikan@ilbers.de> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20211028171727.246342-1-amikan@ilbers.de> References: <20211028171727.246342-1-amikan@ilbers.de> MIME-Version: 1.0 X-Original-Sender: amikan@ilbers.de X-Original-Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of amikan@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=amikan@ilbers.de Precedence: list Mailing-list: list isar-users@googlegroups.com; contact isar-users+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: isar-users@googlegroups.com X-Google-Group-Id: 914930254986 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , X-getmail-retrieved-from-mailbox: INBOX Update the list of image types can be used for targets. Signed-off-by: Anton Mikanovich --- doc/user_manual.md | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/doc/user_manual.md b/doc/user_manual.md index 1b00a47..b4dbe85 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -450,10 +450,16 @@ Please refer to `Add a Custom Application` section for more information about wr Isar can generate various images types for specific machine. The type of the image to be generated may be specified through the `IMAGE_TYPE` variable. Currently, the following image types are provided: - - `ext4` - Raw ext4 filesystem image (default option for `qemuarm` machine). + - `ext4-img` - Raw ext4 filesystem image (default option for `qemuarm` machine). - `rpi-sdimg` - A complete, partitioned Raspberry Pi SD card image (default option for the `rpi` machine). - `wic-img` - A full disk image with user-specified partitions created and populated using the wic tool. - - `ubi-img` - A image for use on mtd nand partitions employing UBI + - `targz-img` - Compressed Tar archive with filesystem. + - `fit-img` - Flattened Image Tree filesystem image with user-specified binaries included. + - `ubifs-img` - UBIFS filesystem image to be used with ubiupdatevol. + - `ubi-img` - An image for use on mtd nand partitions employing UBI. + - `ubi-ubifs-img` - An image encapsulates FIT and UBI image types. + - `container-img` - Container image specified by `CONTAINER_FORMAT` value. + - `cpiogz-img` - An initramfs like filesystem. - `vm-img` - A image for use on VirtualBox or VMware --- @@ -582,9 +588,13 @@ Isar contains additional image type classes that can be used as reference: - `ext4-img` - `rpi-sdimg` - `targz-img` + - `fit-img` - `ubifs-img` - `ubi-img` - `wic-img` + - `container-img` + - `cpiogz-img` + - `vm-img` ### Imager dependencies and bootloaders