From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7024167601088495616 X-Received: by 2002:a5d:6d81:: with SMTP id l1mr7328890wrs.110.1635441471382; 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-Google-Smtp-Source: ABdhPJxBu18da6QaK1FDySIswXxz+l7EdMsD+Q4nN/fE9vsq0g2llKmQqUFCrr9jCyMEB6ZilhTq 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 Return-Path: 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; 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 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 Content-Transfer-Encoding: 8bit X-TUID: lDggRBg4VltQ 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 -- 2.25.1