From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6979549302261547008 X-Received: by 2002:a19:f505:: with SMTP id j5mr27670900lfb.126.1625052959672; Wed, 30 Jun 2021 04:35:59 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:ac2:508b:: with SMTP id f11ls1371430lfm.2.gmail; Wed, 30 Jun 2021 04:35:58 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxGmpkpq+nHaEOdpR9H+HooIV5P/Wjwh4eC2vvIYvmnHKmhVX+QXJRbkG3NLdNWYaIEM4ON X-Received: by 2002:ac2:4832:: with SMTP id 18mr16942159lft.129.1625052958767; Wed, 30 Jun 2021 04:35:58 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1625052958; cv=none; d=google.com; s=arc-20160816; b=BPAEPwC3YdZKAsYKHQ1c5qrTrnK6XRuCQae8BrQzphgvDlttaPRkfUvtm/d3r5YZpu HGwZrxN0qXnRXlOvvwt3AAMX+1kG2rGQawbGjEgbD1afTwhygYZKGom+1+Qy90ffBZez ilELQQx+eVnDjOp61oW0DC/lSkrM/h9yG6Y0lLiwyVxKJZSShGe6O4VDEYb3zUfnZeKa w/50nADaEjiLEWUvcTyAnb8qBcky++36gsIEU3uJ+c/+IZDbN0kaRg5U5KfJ4D40kGdj P4yAglhpjGSha7HG3dXv84flm2McKjr2Zga+i7ac720U5bmokos3HJo2KPyDkAilUM3X ZGlQ== 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=Yf4qxVwDwakLXzNPnRQYOE1e8R1OwgaeS3qXJzyG6tM=; b=GFS6NoB6UEeGuvtFBmOaQX/GS69h43DKVpTO7fbAKVdEj+H6ayRIqJZlrXQYmcoGKV /rjmn7FYrIszPF/E5MDFOyjDTP5maZNmRbtxMo8TdGK69aO6HrqEU9o1N6nu28EqyHaO E/HXtTTT1Ncq+oRboZcww0f22qKv7f5Kr9GJABvGu7kE0R7pergEih0bt0B+QG0GiWph ePigc56RhQ645seO0H2B5KEsboir+D/BqIxNiSgJQv/ExwHiv4aqTxZg/i928DyaTPS7 eFTqkr6YO/CMrh8u90HyT7W1EZLCi3MtbFgEWwtmvgD/8gAMqrJamcDSmYxi5mpa6LYH qKGw== 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 b35si738620lfv.5.2021.06.30.04.35.58 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Wed, 30 Jun 2021 04:35:58 -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-249-65-214-37.mgts.dynamic.pppoe.byfly.by [37.214.65.249] (may be forged)) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPSA id 15UBZsVl007661 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Wed, 30 Jun 2021 13:35:57 +0200 From: Anton Mikanovich To: isar-users@googlegroups.com Cc: Anton Mikanovich Subject: [PATCH 2/3] doc: Update tasks description Date: Wed, 30 Jun 2021 14:35:46 +0300 Message-Id: <20210630113547.87295-3-amikan@ilbers.de> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210630113547.87295-1-amikan@ilbers.de> References: <20210630113547.87295-1-amikan@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: 8aoSJAvSIXYo 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..a0e7ac8 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