From patchwork Thu Apr 23 12:19:40 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Zhihang Wei X-Patchwork-Id: 5046 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3+deb9u2) with LMTPA; Thu, 23 Apr 2026 14:20:07 +0200 X-Sieve: CMU Sieve 2.4 Received: from mail-lf1-f58.google.com (mail-lf1-f58.google.com [209.85.167.58]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPS id 63NCJq7Z009222 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Thu, 23 Apr 2026 14:19:52 +0200 Received: by mail-lf1-f58.google.com with SMTP id 2adb3069b0e04-5a3ff732c58sf5576194e87.1 for ; Thu, 23 Apr 2026 05:19:52 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1776946787; cv=pass; d=google.com; s=arc-20240605; b=MEK9awJUSOL9+mShS3aQdNw7MfxoJ0Du7ezivV5rsBTzEcw1SNfo7z8onkwjw7pEg8 xbj1sepw1dQPn4MJJ2BZMGVlUdF1WeFLgT3xWsDKLjWPZljOx9G7o+ax8vVSdCw8CYEy 1JbszgnvPIXQ0EZ0f/TnWfeZ7f9EVHNPNrKTeUPYzDDJ657EPZeELlHAWXpbe7c8/zcz EwkDFTfQToryC6+EZef6sBwTknkW6rhWTgrhBfT8K0KNbKuJYQsSL671V+vEFKXZPtc9 RXwRzxd0huV7fAb90wsiB6OxRIgcV9+NgpEv6n5bPnkgo8l+LPb+rJY+620XX+c8lhjH s8Ng== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; 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:to:from:sender:dkim-signature; bh=dsP6WYpLQzN3TJRAnQo+qjYLDGJyedbrzfBnzV5+YYI=; fh=VVevfv6bAwGXcRdtL/vcBOMjaQwcPe6uKP2pGyyfsrI=; b=hi1oNvV25J7YXrBmqFAqgG4o+J1ZrdNli6b+nbiEw8o0mI4YpvtCYS/fhmoeKPZQcQ fvkqFHbaP7IpUKPA5sBgElXee+eH/1krxMSHjIdtIuXY7arSVcTr+wLznQ0lEsEtBXhB wiGslKGYt9oUf1Ojbj3bItvurPYa0UR+bae8Uh35fwZpp/Yf/afcVEY9UewL+I6XnWwV XR4L0V8lIl6rwkS/HnERJq2k+/y6galeCT64xFx0/ghSTq/+OBUK2mQuHS6+Mu3Zh9C6 YxBZABCfeHFhSo5mPsMRAO8yWLq7PEKqWYL+bSGMu03MVd5suxAp9BNlLO38KMebEPzY OhuQ==; darn=isar-build.org ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=pass (google.com: domain of wzh@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=wzh@ilbers.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20251104; t=1776946787; x=1777551587; darn=isar-build.org; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:x-original-authentication-results :x-original-sender:mime-version:references:in-reply-to:message-id :date:subject:to:from:sender:from:to:cc:subject:date:message-id :reply-to; bh=dsP6WYpLQzN3TJRAnQo+qjYLDGJyedbrzfBnzV5+YYI=; b=CLQ4Zn0ZFHWfSKBfRT1kcamzxVe5DxWD7cW3efqlcj+7O9cTqZLV6kLN3j5Mf7djvB JnFMSoC2ZZzpsoV9b/uhyxAcns4uYXN0Ux50HZdrGmze7hiTFx7nbODHbm5XJ+x8S59V h1Tvk2jYYBBqDYDKK9K3/jc3yE0XnuEvbVPBYRNh513p/lN3A29XOUBjIqnBSkvbCRBk AtziF3QHcwzAUOegCx5oKXkcvXyG1Dky+l8LynH4MFnEwXnlzIeTgyEieSkh9iGSwGhQ VSao6TUYQod/J4QYCPa794LCQzAGvsrfyzQnW+7HYlZZDBNtaZFjjGi26L6+hAn0uSXV kZpg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1776946787; x=1777551587; 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:mime-version :references:in-reply-to:message-id:date:subject:to:from:x-beenthere :x-gm-message-state:sender:from:to:cc:subject:date:message-id :reply-to; bh=dsP6WYpLQzN3TJRAnQo+qjYLDGJyedbrzfBnzV5+YYI=; b=aExUsHHFmB6YTUqXRnVVqNtoJNmm6OcmtufFvKBpwAAVOhAFWeBRVLESNn49VUHfxg aZE3hUsYBIHeBKIbT5foHDNEr0nEH0pADpmmFOTGDNb1VHm1WVoGHc11V0xPDZnh9yiF I4YNr2x1iDgmxfeMhdZOZeda4ZIsbdUhDvGfznHmv4iadA+ZCi5M1z9pFi1+YZvbONVT Ru883HUXZ4g7YzNu750GMfAH+50gK437P4dpK8ZHQeiplVcR4dvqRispvQ1y/Beju2L8 3c8b5HRJTV6/uzWhD8bCsof9QdyXzZPW4ufE9qKIYW1dVDwFwQaARmGgF5Ln0k88aQQ/ S/uw== Sender: isar-users@googlegroups.com X-Forwarded-Encrypted: i=2; AFNElJ98UuLkgXfLcZFD/rA90NWTNv7UAmbPcRH4Q4nls7blEBv9PU4D4ikw/T4ULj4epVuxUd2+NT8=@isar-build.org X-Gm-Message-State: AOJu0Yxd+pzH0fIneEVjRHDwXIbdj7tU+4WI1TNEsyeUBY7KnlQkR5UG ciq0FQpVHgO86dSE8jSKLxBmxPLrXnGMg665PGf0Csil/zQLxUPJDFn/ X-Received: by 2002:a05:6512:31d6:b0:5a3:f309:47e4 with SMTP id 2adb3069b0e04-5a4172eeb12mr10136127e87.32.1776946786336; Thu, 23 Apr 2026 05:19:46 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com; h="AYAyTiLqFMWLN8MDmg+fif0/5m+NnXjc1QE0xzIsmXkvTf3tCA==" Received: by 2002:a05:6512:3690:b0:5a3:ffe8:61e3 with SMTP id 2adb3069b0e04-5a40e451beels73424e87.1.-pod-prod-07-eu; Thu, 23 Apr 2026 05:19:43 -0700 (PDT) X-Received: by 2002:a05:6512:2204:b0:5a3:f305:a50f with SMTP id 2adb3069b0e04-5a4172ee620mr7321848e87.30.1776946782837; Thu, 23 Apr 2026 05:19:42 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1776946782; cv=none; d=google.com; s=arc-20240605; b=GITRGno++iAdZWoik88ayjsVe2F3lrAkXSVTcrRtvEBsS6lb0oU2e8oOtdq30frfSY TflwvhEZRpFA7Qwyw0pR47K4p/v/TVxK89P9oQfv87QppTXWWDKONPJutMXnmC6LZcj9 etNGVu4kfA5aB8cIosaNXJueevicfkpiW8ZWvnFAAYoO7tMPFniN0tqvDICdMAA/2JbI dhg+lnxUT6o1ML51aMFZzNlUOoHYMQ4qSEbep8HCMPAQ+73Ei/apmjx9oBap27OvFpKa VHyyGBaezhQPzLXhelLZqQUtsSNMZRq/C98KHfR5jT2CpntVexgrt09O0jsvJqPNresJ 9fmw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from; bh=4Ehn7oaaRO2V5buLBZNZBp/kdeVCEW+zLiHaoh8YRpY=; fh=7tclEdh7YbwSQowgJ6LNq720O7H5HTEaqj22NJWRE2E=; b=dLGLC3sCRjaGiPzPnmnlXdpF4Qi7NBebytSjBqjE7uj0IvVWi7uSfR/F666kQZqVTH VKEPfTMZ6rrnWuMZX+b9AfSwrwmSNrA5W9JBhEs23QzIVzblN34M9cYZDNLzRVXTwlbb 1ahgHFf5OQtILE+ConS+L1DUjA77ghMqNwjSWzxJTFzzi1iM0mUEMgvGK3JtXdFPau2m a5jpcd3rlaJ9jS4Jy/cBS3FEy2ISNLIfRSdw4BXZSuCYsf1OZyNji9d0bS7Qjm2nVBuO YP9idW0bHVM7hIi+uLoAdslKaRZUeAAjhKGpNdSkrfGCOLUT40JNYkQMC8CYsfm6fD+0 Q2RA==; dara=google.com ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of wzh@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=wzh@ilbers.de Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id 2adb3069b0e04-5a4187d7a5esi301816e87.6.2026.04.23.05.19.42 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Thu, 23 Apr 2026 05:19:42 -0700 (PDT) Received-SPF: pass (google.com: domain of wzh@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Received: from debian-zwei.m.ilbers.de ([88.130.203.42]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPA id 63NCJfs1009189 for ; Thu, 23 Apr 2026 14:19:42 +0200 From: Zhihang Wei To: isar-users@googlegroups.com Subject: [PATCH 2/3] doc: Restore API-CHANGELOG entry for artifacts naming and path changes Date: Thu, 23 Apr 2026 14:19:40 +0200 Message-Id: <20260423121941.1704827-2-wzh@ilbers.de> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20260423121941.1704827-1-wzh@ilbers.de> References: <20260423121941.1704827-1-wzh@ilbers.de> MIME-Version: 1.0 X-Spam-Status: No, score=-4.6 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_EF,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_BLOCKED,RCVD_IN_MSPIKE_H2, RCVD_IN_RP_CERTIFIED,RCVD_IN_RP_RNBL,RCVD_IN_RP_SAFE,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-Original-Sender: wzh@ilbers.de X-Original-Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of wzh@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=wzh@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: =?utf-8?q?INBOX?= To keep it clear for users what API changes (13cb77dd) were introduced in Isar v1.0 and subsequently reverted (79e10791), the API-CHANGELOG is restored and updated. Signed-off-by: Zhihang Wei --- RECIPE-API-CHANGELOG.md | 86 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 86 insertions(+) diff --git a/RECIPE-API-CHANGELOG.md b/RECIPE-API-CHANGELOG.md index 0e6a3172..659a03b0 100644 --- a/RECIPE-API-CHANGELOG.md +++ b/RECIPE-API-CHANGELOG.md @@ -981,3 +981,89 @@ fragment, this can be specified via adding `${S}/path/to/fragment.cfg` to `KERNEL_CONFIG_FRAGMENTS`. If a fragment was checked out into ${WORKDIR} as part of a repository, a tarball, or some other directory structure, just specify it relative to ${WORKDIR} in `KERNEL_CONFIG_FRAGMENTS`. + +### Change DEPLOY_DIR_IMAGE path and artifacts naming + +Change DEPLOY_DIR_IMAGE from ${DEPLOY_DIR}/images/${MACHINE} to +${DEPLOY_DIR}/images/${MACHINE}/${DISTRO}-${IMAGE_PN}. + +When building different distros with the same machine the following +error occurs: + +do_copy_boot_files: The recipe isar-image-base is trying to install +files into a shared area when those files already exists. It happens +when some files have the same names (e.g., dtb files) for different +distros. + +To prevent such collisions, image artifacts are now deployed into a +distro- and image-specific subdirectory. + +Additionally, artifact filenames have been shortened by removing the +${DISTRO} and ${IMAGE_PN} prefix, since this information is now +encoded in the directory path. + +Example 1: Build isar-image-base (phyboard-mira, debian-bookworm) +Under "build/tmp/deploy/images/": +Before: +phyboard-mira/imx6q-phytec-mira-rdk-nand.dtb +phyboard-mira/isar-image-base-debian-bookworm-phyboard-mira-initrd.img +phyboard-mira/isar-image-base-debian-bookworm-phyboard-mira-vmlinuz +phyboard-mira/isar-image-base-debian-bookworm-phyboard-mira.dpkg_status +phyboard-mira/isar-image-base-debian-bookworm-phyboard-mira.ubi + +After: +phyboard-mira/debian-bookworm-isar-image-base/imx6q-phytec-mira-rdk-nand.dtb +phyboard-mira/debian-bookworm-isar-image-base/initrd.img +phyboard-mira/debian-bookworm-isar-image-base/vmlinuz +phyboard-mira/debian-bookworm-isar-image-base/phyboard-mira.dpkg_status +phyboard-mira/debian-bookworm-isar-image-base/phyboard-mira.ubi + +Example 2: Build isar-image-ci (qemuamd64, debian-bookworm) +Under "build/tmp/deploy/images/": +Before: +qemuamd64/isar-image-ci-debian-bookworm-qemuamd64-initrd.img +qemuamd64/isar-image-ci-debian-bookworm-qemuamd64-vmlinuz +qemuamd64/isar-image-ci-debian-bookworm-qemuamd64.dpkg_status +qemuamd64/isar-image-ci-debian-bookworm-qemuamd64.manifest +qemuamd64/isar-image-ci-debian-bookworm-qemuamd64.wic +qemuamd64/isar-image-ci-debian-bookworm-qemuamd64.wic.bmap +qemuamd64/isar-image-ci-debian-bookworm-qemuamd64.wic.manifest + +After: +qemuamd64/debian-bookworm-isar-image-ci/initrd.img +qemuamd64/debian-bookworm-isar-image-ci/vmlinuz +qemuamd64/debian-bookworm-isar-image-ci/qemuamd64.dpkg_status +qemuamd64/debian-bookworm-isar-image-ci/qemuamd64.manifest +qemuamd64/debian-bookworm-isar-image-ci/qemuamd64.wic +qemuamd64/debian-bookworm-isar-image-ci/qemuamd64.wic.bmap +qemuamd64/debian-bookworm-isar-image-ci/qemuamd64.wic.manifest + +Artifacts that do not belong to a full image (e.g. isar-image-base, +isar-image-ci) remain unchanged. For example, a customized initramfs +built independently is not affected. + +This change affects the location and naming of build artifacts and must +be taken into account by downstream users. + +Note that this approach differs from OpenEmbedded. + +OpenEmbedded typically avoids artifact collisions in multiconfig builds +by using separate TMPDIRs per configuration, resulting in multiple +build directories such as tmp-qemuarm64 and tmp-qemuarm64customized. In +this model, artifacts with identical names but different contents do +not cause conflicts because they reside in their own isolated build +directories. + +If multiple configurations are intentionally configured to share the +same TMPDIR in OpenEmbedded, conflicts may occur and are not handled by +OE. Artifacts with the same name overwrite each other, leading to +incorrect build results. + +Changes in next +--------------- + +### Revert "Change DEPLOY_DIR_IMAGE path and artifacts naming" + +The DEPLOY_DIR_IMAGE path and artifacts naming changes introduced in +13cb77dd (included in Isar v1.0) have been reverted. Deployment paths +and artifact names are the same as pre-v1.0.