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