From patchwork Fri Mar 3 10:20:45 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Schmidt, Adriaan" X-Patchwork-Id: 2712 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3+deb9u2) with LMTPA; Fri, 03 Mar 2023 11:20:56 +0100 X-Sieve: CMU Sieve 2.4 Received: from mail-ed1-f64.google.com (mail-ed1-f64.google.com [209.85.208.64]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPS id 323AKtMA028307 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 3 Mar 2023 11:20:55 +0100 Received: by mail-ed1-f64.google.com with SMTP id m8-20020a056402430800b004cdaaa4f428sf457362edc.20; Fri, 03 Mar 2023 02:20:55 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1677838850; cv=pass; d=google.com; s=arc-20160816; b=jVMjYJqbN2gfboimvolQFLL8yydw8jAsUN+m8DpIeDK+eo4KJBS5yaleqcrPsQFboQ NZQ8ZsE4c870JuAqzwoDCSxgQHFQoK/TINsjIK0npzasBwS4Rb/hkXVzhplbbD52Slh7 5a0QJWPHOLiTIzPyASuX2GhRMUn6meuI54hXurxxiFsyQjzlZDNqBl27uAjt1yr8FHCT QtEPIJlzFyIR+fQuXfyNlJdQbCLYnKQSyLoCgEiebMuSb63gcIPuAkgWIJ91LBghWupQ sDGVarOJ3A75IzimUbzaphDv2r2BgqFuz99uZZyMXktGmKcA6jGDsY6YmsuimtLWAOmz a41g== 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:feedback-id:mime-version:references :in-reply-to:message-id:date:subject:cc:to:from:sender :dkim-signature; bh=04qgN9vEPpd1fXTiMp5XW9OTOydLi++lzdvOfb5WB4E=; b=ELYyiar7NPSabSgDt/sAKNna18tDrRNKauQnjuE/aOjRzWOZPN5DnpltQGdlFlsocb ypGA78Pf+uPRVGIChTb7uNJCsqEJB2pD9U3LZpPNc52123WvMXCmgCPbSMeYOsVOVRe6 T8gnEFe13S+UYmInxaW7imkMnc5gKq5qwnTlTDtgGcIti+ZboZx1R11ezfHRA2CcCVTT Ko/Sp105W9RSZEI7ub0aq/o03zisOBRRmT9PqwmTsfLVjGyK8kD8nb/5paRicnAtWCCu /kgi0dUzbh0kZS83KQglsGYSE9ordz3p11YJVrxYh3qLJmm6wZKqil/GB8NuJY5Zsf8j Wetg== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm1 header.b="mzLPll/n"; spf=pass (google.com: domain of fm-526363-20230303102048bc37d55b8ef8b3c311-7iqslm@rts-flowmailer.siemens.com designates 185.136.65.225 as permitted sender) smtp.mailfrom=fm-526363-20230303102048bc37d55b8ef8b3c311-7IQSlm@rts-flowmailer.siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20210112; t=1677838850; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:x-original-authentication-results :x-original-sender:feedback-id:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:sender:from:to:cc:subject:date :message-id:reply-to; bh=04qgN9vEPpd1fXTiMp5XW9OTOydLi++lzdvOfb5WB4E=; b=rDrK+GLgRcL6GsaZj7Szw58qLib7DVQ5ZMn70wMmpjwDAlTmahFZryDiTTSuSIV+Hm jHT+PpanzaTBpQOpSb4pWBdkVM+jrJ1nEVDgLallZ6/xTpCXORg/fU5PH/yV6f5Tp9OW ezYMFSwapYy0NhflN2vQ1yAYLhfncum4yLGJdC55vkT9cxsqHWIB8eolMuOeaH8zCrlj hpilMaNKXY5jGmRD46FfHsM/h7wXdYt1djQnsmcmFf6HHg38JcKnO0K50gjhoPpGowXa 0f2mFPpsIgIcdXE0YLDp4/0aOg18UZ6AqbVeeIjEiczM8/x8klE4qXlhQs6bCkwcGMDL rJqw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1677838850; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :x-spam-checked-in-group:list-id:mailing-list:precedence :x-original-authentication-results:x-original-sender:feedback-id :mime-version:references:in-reply-to:message-id:date:subject:cc:to :from:x-gm-message-state:sender:from:to:cc:subject:date:message-id :reply-to; bh=04qgN9vEPpd1fXTiMp5XW9OTOydLi++lzdvOfb5WB4E=; b=d9jEpKSyk3kgyV6zGKqrDHBKiCKnOoeNq5y6ci/uAPxswTJW2Wb2sGp7uWbtaljWkz JJFdMLd01rQY6ZHl/wTS5mVTJKXhQeuWMhUDtG1sQlV8+VPL/SBdwbwq4HXOv5vfICU7 Kz5QKXy1zSUAUscxmIBFX+de9vajaxOdj/z5Oy183XPcqxr0QOVHNa66Z/Q1IYiXPdrv CjO/9otHL/iCJb8v+GXflNUo3FH1eV5hJSLKuf+6nQPEqCX7KZDiOtYi4qrvVtrtw0Wg SbvLe67TnEYmgEubojKcuviLKbwRODLGIPG/hUmYZkbJ/S7Rv4P+w36f0ibvp1thSBUC YuuA== Sender: isar-users@googlegroups.com X-Gm-Message-State: AO0yUKUERmROXAqtRUg1BolNfUjrbDVnV01mifjDUX2E3av1k9CnTVsO ZsRyo+9QXxtSmq55tELtFPM= X-Google-Smtp-Source: AK7set/zbWX1fDBlc5UmP+kgDwDAnlm3EFJhCFu6gjXaBMzPFdkeFgiR3AX/5DvaJ/7Ms3oWwjueQA== X-Received: by 2002:a17:906:399a:b0:87f:e5af:416e with SMTP id h26-20020a170906399a00b0087fe5af416emr569949eje.7.1677838850275; Fri, 03 Mar 2023 02:20:50 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a17:906:784:b0:8b1:49bd:b751 with SMTP id l4-20020a170906078400b008b149bdb751ls1586427ejc.11.-pod-prod-gmail; Fri, 03 Mar 2023 02:20:48 -0800 (PST) X-Received: by 2002:a17:906:11c6:b0:8b1:3191:286f with SMTP id o6-20020a17090611c600b008b13191286fmr1126877eja.25.1677838848942; Fri, 03 Mar 2023 02:20:48 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1677838848; cv=none; d=google.com; s=arc-20160816; b=B7vg6R67/8CacRwxQoXttYTwIV8pbocZ3iLvJ9kPITTpzkwl5BGnMBWO1QtZa/JTHb DcPxgRdYjp1tvazMexfuWzAbEngAvJqqEqDQ/vrQ6OEth9RBVdyBMgVMrwBL0G1NR70n 1Z92CkUd66bRgWOPoRsP/s5+EdT9Kv5ph00lAS+KRTp2nTopJherlqywIoE1Sh8Bkv+L CAh0gd1Q1EARQ/o7GCXr7HwMuNplINvhMzMn18d6J96O3uZSMpEDS7Oovtf8HKhl6Ayd dwLZ+/LXDex344bJk0GHy0BqUJMVdTzcKo2VLta96WNpEJpPgAWvyk4i0x//wN7SmR6R XLBA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=feedback-id:content-transfer-encoding:mime-version:references :in-reply-to:message-id:date:subject:cc:to:from:dkim-signature; bh=Gppn0vhnxlE96SD0hWM2NEmiCXfDe9v47NqAHKHlobY=; b=zP/a9cq6Skf3qzj75dCaEjuxXbZroQd0WXCScBR/ZJ35uxg/tHCPSIRNx/daUIDvLX JK+nQ/dJQTS77yj2EcOp03kLRTGcRrWMVUvE27nHyQ+zy0jVYueXGHSLPHUam1R+3ocg tZJoygpJAjulYSWjriKpV90AiTyoK0GOm93jd1tUb9sLpivNzoFt8OLAoi5/0SXOW3XX 7f7nezveHJzIvO23KUZWiwoQvBRjscLSfkiAHgekexNuPZzhCWtHLIeFZTXwRZNKb63Y I5Dw0W+IHy1VVLTUCQg6h5Ba/uIjtz/DYTvXWQlvJnYZkTwFSKnGVmbCkPUPbfuYCzxF FdQw== ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm1 header.b="mzLPll/n"; spf=pass (google.com: domain of fm-526363-20230303102048bc37d55b8ef8b3c311-7iqslm@rts-flowmailer.siemens.com designates 185.136.65.225 as permitted sender) smtp.mailfrom=fm-526363-20230303102048bc37d55b8ef8b3c311-7IQSlm@rts-flowmailer.siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Received: from mta-65-225.siemens.flowmailer.net (mta-65-225.siemens.flowmailer.net. [185.136.65.225]) by gmr-mx.google.com with ESMTPS id mm11-20020a170906cc4b00b008b14694acaesi77242ejb.2.2023.03.03.02.20.48 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Fri, 03 Mar 2023 02:20:48 -0800 (PST) Received-SPF: pass (google.com: domain of fm-526363-20230303102048bc37d55b8ef8b3c311-7iqslm@rts-flowmailer.siemens.com designates 185.136.65.225 as permitted sender) client-ip=185.136.65.225; Received: by mta-65-225.siemens.flowmailer.net with ESMTPSA id 20230303102048bc37d55b8ef8b3c311 for ; Fri, 03 Mar 2023 11:20:48 +0100 From: Adriaan Schmidt To: isar-users@googlegroups.com Cc: Adriaan Schmidt Subject: [PATCH v4 4/4] doc: add compat/native targets to user manual Date: Fri, 3 Mar 2023 11:20:45 +0100 Message-Id: <20230303102045.4140027-5-adriaan.schmidt@siemens.com> In-Reply-To: <20230303102045.4140027-1-adriaan.schmidt@siemens.com> References: <20230303102045.4140027-1-adriaan.schmidt@siemens.com> MIME-Version: 1.0 X-Flowmailer-Platform: Siemens Feedback-ID: 519:519-526363:519-21489:flowmailer X-Original-Sender: adriaan.schmidt@siemens.com X-Original-Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm1 header.b="mzLPll/n"; spf=pass (google.com: domain of fm-526363-20230303102048bc37d55b8ef8b3c311-7iqslm@rts-flowmailer.siemens.com designates 185.136.65.225 as permitted sender) smtp.mailfrom=fm-526363-20230303102048bc37d55b8ef8b3c311-7IQSlm@rts-flowmailer.siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com 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-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_EF,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_MSPIKE_H2,SPF_PASS 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-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= Signed-off-by: Adriaan Schmidt --- RECIPE-API-CHANGELOG.md | 8 ++++++++ doc/user_manual.md | 19 ++++++++++++------- 2 files changed, 20 insertions(+), 7 deletions(-) diff --git a/RECIPE-API-CHANGELOG.md b/RECIPE-API-CHANGELOG.md index e48c98c7..b7fc710e 100644 --- a/RECIPE-API-CHANGELOG.md +++ b/RECIPE-API-CHANGELOG.md @@ -476,3 +476,11 @@ Bitbake 2.0 for better performance. It also requires isar-sstate script to be migrated to zstd. Mixing old Gzip-based and new ZStandatd-based sstate cache is not recommended and should be avoid for correct compatibility. + +### The `compat-arch` override was removed + +Recipes inheriting dpkg-base now automatically have a bitbake target +`-compat`, if `ISAR_ENABLE_COMPAT_ARCH == "1"`, and if a compat architecture +exists for the current `DISTRO_ARCH`. +In that case the compat package can be built by adding `-compat` +to `DEPENDS` or `IMAGE_INSTALL`. diff --git a/doc/user_manual.md b/doc/user_manual.md index b9a0bb64..3db5eb26 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -963,18 +963,24 @@ Debian cross-compilation works out of the box. Currently the following build con Experimental support for riscv64 is available as well. -### Cross-building for a compat architecture +### Building for a compat and/or native architecture Some architectures, under Isar amd64 and arm64 so far, support running 32-bit legacy applications on 64-bit kernels. Debian supports this via the multiarch concept. Isar can build 32-bit packages as part of a 64-bit image build and also enable -the image with the necessary packages. To activate the compat mode of a build, -set `ISAR_ENABLE_COMPAT_ARCH = "1"` in `local.conf`. Packages that shall be -built for the compat arch need to be tagged individually by setting -`PACKAGE_ARCH = "${COMPAT_DISTRO_ARCH}"` in the package recipe. Non-tagged -packages will continue to be built for the primary target architecture. +the image with the necessary packages. To activate compat support, +set `ISAR_ENABLE_COMPAT_ARCH = "1"` in `local.conf`. This will install neccessary +build dependencies in the buildchroot. + +For all dpkg package recipes, Isar automatically provides a `-compat` +target that builds the package for the `COMPAT_DISTRO_ARCH`. This can be +referenced using the `DEPENDS` and `IMAGE_INSTALL` variables. + +To explicitly build a package for the build host architecture (in cross build +scenarios, or when generating an SDK), Isar automatically provides a +`-native` target for all dpkg package recipes. ### Cross Support for Imagers @@ -987,7 +993,6 @@ In case your setup does not support cross-imaging, you can disable this just for the particular image by adding `ISAR_CROSS_COMPILE = "0"` to your image recipe. - ## Examining and debugging package generation inside their buildchroot Just like OpenEmbedded, Isar supports a devshell target for all dpkg package