From patchwork Fri Feb 24 14:24:32 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Schmidt, Adriaan" X-Patchwork-Id: 2698 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3+deb9u2) with LMTPA; Fri, 24 Feb 2023 15:24:42 +0100 X-Sieve: CMU Sieve 2.4 Received: from mail-wm1-f60.google.com (mail-wm1-f60.google.com [209.85.128.60]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPS id 31OEOfjK025830 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 24 Feb 2023 15:24:41 +0100 Received: by mail-wm1-f60.google.com with SMTP id m28-20020a05600c3b1c00b003e7d4662b83sf1307061wms.0; Fri, 24 Feb 2023 06:24:41 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1677248676; cv=pass; d=google.com; s=arc-20160816; b=u6CPN/V0/urmNUfTKfKvxkKtIUuDSqggtT1vCcz02xrKGRG1P0/5FiY0akrIui3+wi CEPq49UPrT22oLeB7N5mxxzJkeetrXVDVkca/N/0PHCjMMj5RMfL3WqTREM/fTFuZZ8r 9E+1oQLgPhYAp3kaTVonvTV75vcYTLKDkLe/L9f3a3nzXVkOEgbJUHZbdkeVt7MpKJQM T6Ziei+OpwbQd06m9AU74aVOOxnVOepepW1/ksHgcpsBmf9IXG1lXj7BH7m0ioZJXk3t uMj9Dmtla74A6Z4EwfU1F0GGQJ8/GShubS5bT3ltZYgJGjMQitqPY0u43TKoexpJlzs6 WACQ== 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=/8qoR94E3iN8ESgpdVMW7NPBRWIM0iNALeaayMSfqz0=; b=skg2XKqcHuSFdTqzR73KDI5OvFCdFSeg272QxTr2OfSXABWmjwy0L65txiAsN8+9qM ZyxqshwZNkTBh+oXDrx/6R09rgqyyxg3aDK1oFpmRMBZJq2/XO//XKYi7BnOMbwvDFuu +Bva0oGtfkz7XjVOO1uk9LZuc/dgloqNkesPgMpGNluDM5mSvZBfGWPebBmQAEpLqm0Q bxdf2dylNVK2AE9tn8nRj6Kz9ePM5DMWLQeiI82aQC86aiOXipWjsQaUdZkSBlyDKPaN 8jEVKwg6PgS2ohXXrVKI7laOJ2rT4aSvSprGet4+k6JldZV+xN6mb+r4DmuBEnnS3kmN y6/g== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm1 header.b="N1KROF/Q"; spf=pass (google.com: domain of fm-526363-20230224142434e6d691484eda22a315-sbnw4b@rts-flowmailer.siemens.com designates 185.136.64.227 as permitted sender) smtp.mailfrom=fm-526363-20230224142434e6d691484eda22a315-SBNw4b@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; 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=/8qoR94E3iN8ESgpdVMW7NPBRWIM0iNALeaayMSfqz0=; b=Egj6WIN21dEfUBnI6Cf/umLYIvjRYXIUrcKmPH2ELSB9f8QvOc+ZpAOSLP/S869cmG Tj+nw4Gv9R1ZWpDJUl4eUj0SzstNuQWgjXS8JXPRoIDEsThjudaN0Fu+BDyMHcX1cfSQ ETeSGmdI0N0nzUKHzuExKqXffRAhciSWXKDcqfqK2zl9oB/cHRsPZs1WynkvClIksCpk S7JuJi4NHyfYN4Xe72CPxiN6kDVUi1murH6igS/EHF6ocGGCgqOtDKJbqFtrvhRY+p+g 0laZvt0spMP8Ghe0anUMuZdtHa+my2sSS4aAvjDEiCt04rtw+FryFaaq4broZNjkilcp RrkQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; 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=/8qoR94E3iN8ESgpdVMW7NPBRWIM0iNALeaayMSfqz0=; b=0NP5PYwNAcjqzN/Q4IrTBvmUbqRLrcXQnF2cGwcS5MlWnVcSts2ualto2unXP2vx1r ZLUvI31KMRUFrdS7syjusw0PQGdgfbLms54xes6dnXqyP3R14cP5IaoLNEDyn63hqBRV BiVxsxnEOQOgEhwOWzLcL6ToojujwneEi0hGEgXHZWahdQX5JbDldh6Bbxfl0UvUXVay ox7VbO7c8mqi8HM/HzoiJ8GqgqlHY0NDF57Me3uH88DOo05F+ESA761BIh1bPsjVeAHH ER1DxKAnmwyjHWUGirX1/7CrHypQ3htM3LBI174W0240kSd9A8TmXnh1R2Rxg1Fag9bF /qiA== Sender: isar-users@googlegroups.com X-Gm-Message-State: AO0yUKWfiusnUPn6lKS0UE+8ao11kXkGIjc7iB3Rh+hkCAd4FRWhsCPJ BYMFOBVtJ6xxOxi7ibLxfRA= X-Google-Smtp-Source: AK7set9lwLiiO+Sj/oDIAp5KCUy+IaV7mh5/4YrtdNkx8uLdrgFLEOEkicYBfbCWNwxqIMwlGhYrRA== X-Received: by 2002:a05:600c:500a:b0:3df:97c0:1b5 with SMTP id n10-20020a05600c500a00b003df97c001b5mr1231723wmr.5.1677248676254; Fri, 24 Feb 2023 06:24:36 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:600c:1d09:b0:3e1:e754:51ac with SMTP id l9-20020a05600c1d0900b003e1e75451acls1473890wms.1.-pod-control-gmail; Fri, 24 Feb 2023 06:24:34 -0800 (PST) X-Received: by 2002:a05:600c:1e20:b0:3ea:f6c4:5f25 with SMTP id ay32-20020a05600c1e2000b003eaf6c45f25mr2518278wmb.36.1677248674913; Fri, 24 Feb 2023 06:24:34 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1677248674; cv=none; d=google.com; s=arc-20160816; b=QH4e9drAdESlszQtkl3DTKc1y0B1U2aFTYMtCVj4NKkFiZM8FcciAvvvS/rs68fIty rYCQJA/Dhy+4FlMCjznfP+BMmCTjHN3HCpXjHDbpcwdaLis11dsi+YnOqWWR+6slC9Yb nbVbEBBN708PUtNFg5vyx8va8ug8Pn+J77qRdYsl9nh87rVJTOKEBz3FmgSmm/L/sskb S5DlEjydv5a+Fku4lkeYAOcURAKaMUGdG1LdpasgDkRz5IaIY+JVvytwJxVVATkC2RUP pYPIuDwSJiG5VukaYhIu7cKI0ZQAO9VmZlRypsRsr4lez7cBWtNka2c9xcfzGIcyaXWy NrzA== 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=YwI19RncXg9xWkO8V+F5VWDLl4yTQYRFJawKvbdt+HU=; b=U6ngCSFAPv+n0306B3XVcdsQZTkK3b5gpQG+isbqIobk4BJrmP7a8ufQytVgknO/0N 1KLW5leST30Cb/gEXuy0r12f9TZnr6teO07gelhfG12lCwtQpA6z4sN1PgTxe4E3eIBp fANXtTRKikHM5i/9AlfIwRxMAj6B8U6J4jgnzl1IpF4mXRCULAdD4/86mL5UbFkMaKNJ 3/dLrTXnf4cTPBmndYjbonIhPXb9CFxQ6rphbdHR5nxzB2rxAmppx393Dk8hY0lVViiY 79wIJarX13M8PKOP24IUxmqqeGpYrGkVJir/6g8v7uSVs7sNqfUHwZ+Kwo612ofeaKLF /ZiA== ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm1 header.b="N1KROF/Q"; spf=pass (google.com: domain of fm-526363-20230224142434e6d691484eda22a315-sbnw4b@rts-flowmailer.siemens.com designates 185.136.64.227 as permitted sender) smtp.mailfrom=fm-526363-20230224142434e6d691484eda22a315-SBNw4b@rts-flowmailer.siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Received: from mta-64-227.siemens.flowmailer.net (mta-64-227.siemens.flowmailer.net. [185.136.64.227]) by gmr-mx.google.com with ESMTPS id cc13-20020a5d5c0d000000b002c6eaaaac82si524674wrb.7.2023.02.24.06.24.34 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Fri, 24 Feb 2023 06:24:34 -0800 (PST) Received-SPF: pass (google.com: domain of fm-526363-20230224142434e6d691484eda22a315-sbnw4b@rts-flowmailer.siemens.com designates 185.136.64.227 as permitted sender) client-ip=185.136.64.227; Received: by mta-64-227.siemens.flowmailer.net with ESMTPSA id 20230224142434e6d691484eda22a315 for ; Fri, 24 Feb 2023 15:24:34 +0100 From: Adriaan Schmidt To: isar-users@googlegroups.com Cc: Adriaan Schmidt Subject: [PATCH v3 4/4] doc: add compat/native targets to user manual Date: Fri, 24 Feb 2023 15:24:32 +0100 Message-Id: <20230224142432.3767746-5-adriaan.schmidt@siemens.com> In-Reply-To: <20230224142432.3767746-1-adriaan.schmidt@siemens.com> References: <20230224142432.3767746-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="N1KROF/Q"; spf=pass (google.com: domain of fm-526363-20230224142434e6d691484eda22a315-sbnw4b@rts-flowmailer.siemens.com designates 185.136.64.227 as permitted sender) smtp.mailfrom=fm-526363-20230224142434e6d691484eda22a315-SBNw4b@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 --- doc/user_manual.md | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) 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