From patchwork Mon Feb 20 09:05:11 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Schmidt, Adriaan" X-Patchwork-Id: 2667 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3+deb9u2) with LMTPA; Mon, 20 Feb 2023 10:05:27 +0100 X-Sieve: CMU Sieve 2.4 Received: from mail-wr1-f56.google.com (mail-wr1-f56.google.com [209.85.221.56]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPS id 31K95QZX001958 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 20 Feb 2023 10:05:27 +0100 Received: by mail-wr1-f56.google.com with SMTP id c2-20020a056000184200b002c54a27803csf235665wri.22; Mon, 20 Feb 2023 01:05:27 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1676883921; cv=pass; d=google.com; s=arc-20160816; b=LiymY4wdhrgvZ+Sd12vro2YfQeKVSjH4lGLhX7JWP4W1ujUOXf8AIdb77qiAnqSQMy 4SrgqeAUxyz1QCDFjH7M3uk/YVflVfSrxPqU84eWYoSIORMfPPSISYKC+MHxOSZ58Xoz IME6tFpzQ4wJ8q3qFhb9q2S8+dIRed5lDkwLLTV2EAITi2ukiEWpdtMhcuVt4ZREW5gf MBrcuuqJoSq/6x6qfdAI1754il/ED40qVhf31U9re+JOl5mkgACjge8sAU4vpbWW18YX JZqEzLh0PjoBF3OkIhu4WI4hqjUNWxFrynp3QHuUahNJ85oJPZ3otZxwjmcvBbCLiGnc gN9Q== 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=d2w0jStXUi29l2zpwrm3xxtYSzPShUlrPG02S/7uH9w=; b=Y7o79EDGksKDMNrfCzmGvXRjLNQYYoadNhiKlRedkEIWaxdAqDJVtoeZjokKa+TuQa rfm3qO48+3cMN0GeTQAqAqWfoxbTmDUOhilbnmkm/luRTeoaWQANRxIL5n+F758R1NA7 wqZSwT9qgJimoGGL3sogkcjQkcvtiTNfcSpTmwyou5YCQJrBiGE+9GUBOw0JllEXvASk z0xMGvFzbHSdfgbM+YWIyzRaq8eyw8TRseTRfsVPWjWOxWNeRJ1SEVt5LHGLIm4mFQ+t AjnrXWx+u3Fu4Brt6ohU7qqOP+RRw39mtV8/vfpcXNFo3MHTHQA1bZRPA/crKLMYXn5Y 6azA== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm1 header.b=Pix58nFf; spf=pass (google.com: domain of fm-526363-202302200905199b0142f4ff80a515f3-tsry7h@rts-flowmailer.siemens.com designates 185.136.64.225 as permitted sender) smtp.mailfrom=fm-526363-202302200905199b0142f4ff80a515f3-tsrY7h@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=d2w0jStXUi29l2zpwrm3xxtYSzPShUlrPG02S/7uH9w=; b=A4ChUe+mfrl2X3uz2DzlRuM6IcPRUe+q+0LitvamPABFgDto146EPxN04yQDA1ubbb psh6KyLUpRVDYfv6LZEpgrFsBTm2NFzYWtC6QgyJ2ADYjr1WD2xicOQdFp8FXXdT+shv 982uWjMYLc3vlHTO//2n/pOMDSweTHVA+e1zEZr3yGQG+dpvjQO31L2zUZuYJ46X4gSN TlRkKOFt3txvtB3ZCK9fBujopSeSeQcmBP7CYhxd7jdKvWVJczd4OXH+5cZqTMfDelOr ZxsZsvXtPIo2G/71mE0UC4DKPgDSVRmXiXakHr98Z3rXr0nUE2W9Phcj9VYzprXsuI3o hDgQ== 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=d2w0jStXUi29l2zpwrm3xxtYSzPShUlrPG02S/7uH9w=; b=s2fytjzdtonB//OKeO/K4eisLpusTlT5jpSoPFn1t3LUSD8XuvTFrDMkwvURanK02D q79ibuFHxxoJ9PyBHlMvkZCvzCmNyud9Nl5tIOfY29Ohi698ycH0LMG+CCWI7i3OmJD5 wb+ADi8eOpYkk28IzJz8lTg4UUlFajUK5wh8pcQr6VfcKOZrtHK7noycd7OXiK3/IJo6 kBKsI1FPgOhiKMeciR/ZH2U2ZfLtwcP5PuvNNWxYcmfh+74FglajMqJj1LSgfjjhofhT T3u+/s9c5Xs46bb6cC1hbp1spTPT4NIMv+LPqCxcwjNvkOJcgzKptlq7T9MPpvfGTyS0 K1mw== Sender: isar-users@googlegroups.com X-Gm-Message-State: AO0yUKVKPVJ0oXxH9qVRxasYcBfRhUIek2PoAoOB+JZs9tAqC4rbDuBD Dtevsc9cPzALnESq3axFh+w= X-Google-Smtp-Source: AK7set90/9oH85wkTrt7xV76vM80NCBtrdJIUqBouIF8xLyLJRtVV3Kpijcji2HIBkve2AWEdVGT8w== X-Received: by 2002:a05:600c:1da8:b0:3e2:559:69ea with SMTP id p40-20020a05600c1da800b003e2055969eamr476386wms.134.1676883921552; Mon, 20 Feb 2023 01:05:21 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:adf:aa9b:0:b0:2c5:5262:2e24 with SMTP id h27-20020adfaa9b000000b002c552622e24ls3063893wrc.2.-pod-prod-gmail; Mon, 20 Feb 2023 01:05:20 -0800 (PST) X-Received: by 2002:a5d:5607:0:b0:2c3:dc42:525d with SMTP id l7-20020a5d5607000000b002c3dc42525dmr1815862wrv.36.1676883919969; Mon, 20 Feb 2023 01:05:19 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1676883919; cv=none; d=google.com; s=arc-20160816; b=x8Os6HdCZwp/q5+vGwlBhPjNpgQ5K76hz4njWHiGfMzVtshLdkhtFrHAiD8R0lfSX2 5wIGQlm+U7STNky3PgnueU+5H53uck6UCpZluX7CWgQxJWuEgfzlVkaGp4DyEfeSutEU 3s5ZOTEv7G3xcaZZiLxj+XSjxv5IcqBqfXGzTkDkOsKNBLrgSVxQm6E488rFFLzn3Z7e PbvTcu0eO7DgDupr7Ol9ej9xR8cUO19gzyycLKoLO8gN5ugiPXHRoyHDTT70dPE3F9zz kq+FaEM+cWQyf5RvA8+pCiZSQwGG1DzlkmiezYkkrf8ZKBPwSjmm3eU8gAnT1VhyfIMo CXGg== 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=oYYdbnDet7cEDTbcHJFHOtTyhbofQRbebPlVgrtl9e7KgT9U3GCrufqRUQ0Kt/0Q2N CYpgfWAP3WDghIFiijqcRmwGmKnCQz+jm2l06PzBgp5M7/1jh6zsfTdC4MkKADPbeBT3 7+tmmt/G9OP2k5CMbvlg7IpiG9e8KPWWObxo3lJG1ckVyE9ER5BnN3atyAmQK5NRZR0u 7EmSUJMmFu8ZDViE2fLSbegZKc5vutABoc/TMbNfdECBf7OLSqfGS4W1tcZDGiIj/DuW LpXyC0TmsBTR+C8451B0qAJvJbr7UsIT8ypREK+Ky3UI6P9IvkEAT9bsugiMH2Scnmi9 RkZw== ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=fm1 header.b=Pix58nFf; spf=pass (google.com: domain of fm-526363-202302200905199b0142f4ff80a515f3-tsry7h@rts-flowmailer.siemens.com designates 185.136.64.225 as permitted sender) smtp.mailfrom=fm-526363-202302200905199b0142f4ff80a515f3-tsrY7h@rts-flowmailer.siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Received: from mta-64-225.siemens.flowmailer.net (mta-64-225.siemens.flowmailer.net. [185.136.64.225]) by gmr-mx.google.com with ESMTPS id bu26-20020a056000079a00b002c56aba93edsi14071wrb.4.2023.02.20.01.05.19 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Mon, 20 Feb 2023 01:05:19 -0800 (PST) Received-SPF: pass (google.com: domain of fm-526363-202302200905199b0142f4ff80a515f3-tsry7h@rts-flowmailer.siemens.com designates 185.136.64.225 as permitted sender) client-ip=185.136.64.225; Received: by mta-64-225.siemens.flowmailer.net with ESMTPSA id 202302200905199b0142f4ff80a515f3 for ; Mon, 20 Feb 2023 10:05:19 +0100 From: Adriaan Schmidt To: isar-users@googlegroups.com Cc: Adriaan Schmidt Subject: [PATCH v2 4/4] doc: add compat/native targets to user manual Date: Mon, 20 Feb 2023 10:05:11 +0100 Message-Id: <20230220090511.2524881-5-adriaan.schmidt@siemens.com> In-Reply-To: <20230220090511.2524881-1-adriaan.schmidt@siemens.com> References: <20230220090511.2524881-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=Pix58nFf; spf=pass (google.com: domain of fm-526363-202302200905199b0142f4ff80a515f3-tsry7h@rts-flowmailer.siemens.com designates 185.136.64.225 as permitted sender) smtp.mailfrom=fm-526363-202302200905199b0142f4ff80a515f3-tsrY7h@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