From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3+deb9u2) with LMTPA; Thu, 30 Apr 2026 15:11:09 +0200 X-Sieve: CMU Sieve 2.4 Received: from mail-ed1-f58.google.com (mail-ed1-f58.google.com [209.85.208.58]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPS id 63UDB8mU025066 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Thu, 30 Apr 2026 15:11:08 +0200 Received: by mail-ed1-f58.google.com with SMTP id 4fb4d7f45d1cf-67483b33fd6sf912506a12.0 for ; Thu, 30 Apr 2026 06:11:08 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1777554663; cv=pass; d=google.com; s=arc-20240605; b=VxjZEZS/leOpCE+6cm5Pe2wcfitDaTOBg9GyVY80uXhnqx2xsGtbTfUtAVjmSu8qqt 5Obo46VhO24biZ74sUOZ5/NVZBfWhTuyrZpOex8HyAzle7l4SfHVuDdKl+3Q7hoRiTil Rua3OclcDUxw+4hJsNB8t0pglQuWNUknLeT/YxS+9/ofZijbI9GgS/QMYWmp29SvtHq6 zlSY9UbZW67C8UPBzfEGjgRgBSgVH09juT7YKPtQ1XjrHWlo1z8EdYA95AkPe7t7LkNB MiqGqdVa7YhUUqs256fLMPFH3bW/QFTt+7oCmBljs9YhEwLUTh28Fju2rmHKYMc2A9u2 qi4w== 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=h8k0rUQIblxDuVlSeX6XkdDMdd39cpugg1J7zRDrvWA=; fh=YmwZ7yA3o3dCwHQvDGtzMtdXv8HpNNTjudIY4jZio+M=; b=frEPgzBLAr7vztoMx5/AgsDjU0W8Lw1SXS2luNlLwRsO+sNHMXhGOhmoVcfz3W3dxr heVYumHtA9qiL5Mtz9GaIy2r/S07oD85ztrMzjAWC9qvc61eue75WOVxog2h95Z27yn3 KwhsMJtLwr7BwGXFe3kggayl/pDEIbMkFJyGkIxx97DW9TpvAm0iczXa+VhU+lX1eV1+ i3/YW4MJoEfWg9/E0fReMdvwPryzQx2RV+sOT3p5z5AknPFLgfG5Jizyd7oGA9p7Pchl qyAMnkrXHL+xvIVypxH2p4h3/tuScg2t2TPLgkIRZMzHpcONn3J0ni9Rj7qIzbph7OqB WINQ==; darn=ilbers.de 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=1777554663; x=1778159463; darn=ilbers.de; 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=h8k0rUQIblxDuVlSeX6XkdDMdd39cpugg1J7zRDrvWA=; b=uAWqyjL2T/yNGtN5SgI+WrEGMcNH0F4osrtP7EA382p6chmeNpJ00b9zPEEWw7Ytca MdEHQCvfTPizAAO1e10Yd6sLtxZwc54GYVXORxd5oKbNUtbVWFAe/3ib/EN8vSIZWlnD 4WIEk/61P8Lu3DR+vlTmDBNFb7ESc/VetqUZpmyCcSdXyMQ0bXZ54DP3QCt/GOC9DV5A Wb6FB21iXZti98u/ai9wjFqckFihQmb+D27bhcTRlkou8PkWIWqGpTPVFW+6DjldBOIV Vp8nE6pDaIcTFQtoZ2XA8kUbgHuYFpfLdc0uXxbRyuS4JwBwDJQ0Lou9+vTGTxC08mo+ NRIQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1777554663; x=1778159463; 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=h8k0rUQIblxDuVlSeX6XkdDMdd39cpugg1J7zRDrvWA=; b=P/W8kK5ekOunVUh6BFvHLnPmosvm6wlpFvPBJ6uEbz9axTEl3p4D6b5kBWvpP9NrG8 11DUFNtg6b/y8wen/GSGMec5sKhraSERR3Hgx7oVUKg9iEaz4DSLd1w86nXdqgU0/lug u6Gdh8IQ/HnpsRj2RmCp+Q0VSA++/vzroIOK3LqgTM7tdl3RwfjTGLuB6hsO2kCVB/7b C58YIDqsK9HeOx1ue2ZRWxzyNJ76BlSVmFNH58w9+UARYiFUPsoul10bJkt+YHBHXUZW BTB4lt4ccK7M5vMV2+AiiWauW0K1weYSgggxTI6hlefky6Lo/+raOG1wNcX7Lp+Wjidi HRRw== Sender: isar-users@googlegroups.com X-Forwarded-Encrypted: i=2; AFNElJ+/qwCCx06Hn8vJYGil/1TLX94r+9iQ0iXCTnA9Z5+Kgr1DASCMdGGJ4bTCgaaaUfKysgaz@ilbers.de X-Gm-Message-State: AOJu0YxP7W8aeqycygW0p45V2YRkhl67QHHC7P9eAZ9LAsJdjBP18N1g jNHCAhkB889hpvptVARUf91j18qr7vuIpu4tlRG5R1GWIq3V5IbnLRZH X-Received: by 2002:a05:6402:1e94:b0:676:2118:fb1d with SMTP id 4fb4d7f45d1cf-67b5d7f1d1emr1811472a12.1.1777554662983; Thu, 30 Apr 2026 06:11:02 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com; h="AUV6zMPtTPBvCfu5z15quA/BfmBOvV2XZ7sqah+Eqh3FUGMSog==" Received: by 2002:a05:6402:4610:10b0:66e:7b5f:f75f with SMTP id 4fb4d7f45d1cf-67b4eba7b86ls918724a12.0.-pod-prod-03-eu; Thu, 30 Apr 2026 06:10:59 -0700 (PDT) X-Received: by 2002:a05:6402:26c4:b0:670:e9ce:203c with SMTP id 4fb4d7f45d1cf-67b5d800455mr1367299a12.10.1777554659656; Thu, 30 Apr 2026 06:10:59 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1777554659; cv=none; d=google.com; s=arc-20240605; b=ctQ3gT2SX0uzkDcQnKv3r52EKWsYxAglynWeBbjux6PMC746xfWxaZg6GuccI2TJlB FL31PFNWZnQfvdPfyJuJt8Sk1S/084LGhYTaz6TiZiefjl/VepZfqDAFDxtyYPn9ay9i XzXajhZix/ejGW+z+yUJGOO5qxNRpK9WviMbNCh7NroQJb70BWKkHjMF5WvUhwAmsy36 v14t78b8t2wv8RaoDQdDmYUHIxiTwYuA5TnROqo/1esJlVk0D6xO195Aumf6JiYkOXag qKkJJJoq6AM4g3fVaK1270FTEX66Z3DxKxcUSCHutGF8MJnwJzh37fuWpR0nwPWAZMnp 2hfg== 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=iebyCudENp7dcFnJQUp2hpJN9YtmYf/L7KbNgQqZJEl2tm6QpqRtJnDQ7+GZhsx/Ak Q6thRhnmIqeddVCT6hC0I67zAyzBs7n7VMdP61omzwUUhtbeEsJ8bulufmNfzJfIsbVa kWP2/vzQA+mkl9a5z83w9PqVse4AbajfcCr1STUcm134p2M82MeauZ6PJ4D1u68kiRxP 6KQSaNkvYbwDyGS9b55TVLYAUVOxgwXnxuh726Ox3+IMH9SxG96DOWJ87tROHWt8BwlC WcDA/bYt/iVqBXNkcGK8mbTroyV9W0V+14sj4Rlxk1/QL/2XfwV8rFQdLUf37kGS50ZF eiSQ==; 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 4fb4d7f45d1cf-67b21e4bedbsi130460a12.0.2026.04.30.06.10.59 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Thu, 30 Apr 2026 06:10:59 -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 63UDAv3G025033 for ; Thu, 30 Apr 2026 15:10:58 +0200 From: Zhihang Wei To: isar-users@googlegroups.com Subject: [PATCH v2 3/3] doc: Restore API-CHANGELOG entry for artifacts naming and path changes Date: Thu, 30 Apr 2026 15:10:57 +0200 Message-Id: <20260430131057.2960671-4-wzh@ilbers.de> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20260430131057.2960671-1-wzh@ilbers.de> References: <20260430131057.2960671-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 Content-Type: text/plain; charset="UTF-8" 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-TUID: z/cvFKUHwmro 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. -- 2.39.5 -- You received this message because you are subscribed to the Google Groups "isar-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com. To view this discussion visit https://groups.google.com/d/msgid/isar-users/20260430131057.2960671-4-wzh%40ilbers.de.