From patchwork Thu Apr 30 13:10:57 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Zhihang Wei X-Patchwork-Id: 5062 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:10 +0200 X-Sieve: CMU Sieve 2.4 Received: from mail-ed1-f63.google.com (mail-ed1-f63.google.com [209.85.208.63]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8+deb9u1) with ESMTPS id 63UDB9Oo025068 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Thu, 30 Apr 2026 15:11:09 +0200 Received: by mail-ed1-f63.google.com with SMTP id 4fb4d7f45d1cf-66c165a7a8csf905951a12.1 for ; Thu, 30 Apr 2026 06:11:09 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1777554663; cv=pass; d=google.com; s=arc-20240605; b=aEtQZfamRghVXnf4VQZ6TFRooWx+avY7wyTKywAiEK5gBb6APdhKRIKFf40JONFzvA qzZVLqIzFhopaivG+RiNVvVmvPeSIzQndhovAQqmtsUJDAKpBy0h0LXe4wBENqMwEEeA GNuDfa0AVoEX4sUSCefLFkC5frv/1/fJK6xl92DGBP3ahpfN7n4v6SSQ1VUQOCp5kAJ4 q8PVVzi/lLZbkwq+dSOcARt/cSRbKJx9nBiUpnDEJ1o+IGVxqXtQlHCMHDqsNImbjtTK aojn4tApzfOjK+cZAQJyELIWW6aSZHE4zo+3YHjIUQ9PqpIy8AC1mf46Frb5kbWnqRhk OBQQ== 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=sgHMl4GvLjjepcwN7xRSKESvDdBOb4oehk0s09BBIhc=; b=D2lsEN3FlZfWS9UmhULNaV2MFzn18adtIbboLVRlMiEzg/PJA08PEmJPXDklnPZ3pJ yn0V2UhrlX8BubMcBFn8OHeQQLzzNs+ew/xudlGWObJpJ20hfFLFa4SiN9Xiqy2vgo1M 4MzTcN5tU8emFscfwTV5EPmaqqmjf2x+tcusRKvpqu6KYgTAVOx9ohRaPWz80s+EqA/t BIso0PPQ4SoCi4P4TTToppFd95H5SzDfHYE/YGJDY9dmXRn/OcqSSbG3/3gaJbr70Ebe MF/GLmD3l9Bk+D2W4Lxy4o7KLKX6YE1fzlTy5a8/882lukeR2zVNZaL3LQ25IECBckUn DmVA==; 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=1777554663; x=1778159463; 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=h8k0rUQIblxDuVlSeX6XkdDMdd39cpugg1J7zRDrvWA=; b=alohjn4uekDJwz6Vej4QVNOPOpHPhxMc7HuXcz/Uvb3281S6a02TiF9Gr7vTgUaN9I 7opERlvGIVxUtHhw2evww6x4M30Px/LzbEUdYSvrT51LojC6tMRcAnjyaq+ReB8aXJNP CTiABcP2RXWmMY67vGmooU40HkWV8ryJOa+LcpqqTHC1hqDJ69ENY2bQ4Cf1LPlH/jOI GQsCczG5iEUuG7bLTrhcVlzcMILuMIsSqknQaLjG7zN3wuo8gLx7HaIgzE+A/teu0F1B 85xzlxhE56zC0Jra78U/sNlpAjKyS2aNz6Aymg2SrWMOgRbxNVFS1fAVNQYNvK4TgF62 94gQ== 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=DsXPaOXttwEZ+4/qJthC0x8WWwkk6l4bKab8tPjTq/TAL1JUC+6C/hb1lVbeLBvDWF 6A64Qo0Y0B4lNlEmrDPnIr7boesXHvL7o+8vN27pZjl6sps9LA7Kcz219eUenqkHiC+g J4ARXPtNRU7ovWQfLKgVPyhcxVG4aWHu1iHVhn4oUiVH1BvijmXjRD0Ruad3ANwTDZrI a7F+MwFbESSL/MKDmqtHmmitAvxklthokKOERgj5qKOWdAlBnUc8xvSYLxxFh1HOq1vn hE6pbPM6RD68Fk1UqNo1dfypKnh5orFfS1l3sw3sHUy5joY/fVxKfUIx6qORq96HpcF/ 49Ag== Sender: isar-users@googlegroups.com X-Forwarded-Encrypted: i=2; AFNElJ922Fh+D+isJQn8Xw4GyXrZkIO9LAvrFTJuyPMtQjJamzjU7jnEHEi0BFFEFeVvabbs7SY4iwM=@isar-build.org X-Gm-Message-State: AOJu0YxQGj5c57Xto3Tg4G0Hs1TcAHPxc1Q0BA8pujCqwjmMhtXcaF7w Wh5bcj3uSYshaUyBGn0BcuSHZKqTewZliSkITqElYQDbeRL6nxz2mn6l 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 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.