From patchwork Sat Feb 25 16:36:06 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Richard Elberger X-Patchwork-Id: 20139 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 23E2DC6FA8E for ; Sat, 25 Feb 2023 16:36:09 +0000 (UTC) Received: from a8-18.smtp-out.amazonses.com (a8-18.smtp-out.amazonses.com [54.240.8.18]) by mx.groups.io with SMTP id smtpd.web11.47256.1677342967968167333 for ; Sat, 25 Feb 2023 08:36:08 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@richelberger.com header.s=5u2mht5g5nbgnd5xxu4iibla5zobc5bd header.b=iTGNEoyy; spf=pass (domain: amazonses.com, ip: 54.240.8.18, mailfrom: 01000186896e845c-37272abb-a04f-4c1e-87ef-c0007b322ca0-000000@amazonses.com) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=5u2mht5g5nbgnd5xxu4iibla5zobc5bd; d=richelberger.com; t=1677342967; h=Subject:From:To:Cc:Date:Mime-Version:Content-Type:Content-Transfer-Encoding:References:Message-Id; bh=nWAxN80icACbBKqKGZdCqNq37bH69WjmNodOp54erRs=; b=iTGNEoyy23DuLzye6jJufeEiPHPfZwYG8aWV3kuT8NtumDq2ExpV2TdJ3uE2nnRu dvmqCEYmdurjZUDJSk+4RY6hhtzwjPztmVJe8tWPd1m8eEZ2WY/BeFtLCuxBuKzOC1Y cQWtovlFLSYWarClVcbBX9LbQxK1LGebCFMXfj68= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=6gbrjpgwjskckoa6a5zn6fwqkn67xbtw; d=amazonses.com; t=1677342967; h=Subject:From:To:Cc:Date:Mime-Version:Content-Type:Content-Transfer-Encoding:References:Message-Id:Feedback-ID; bh=nWAxN80icACbBKqKGZdCqNq37bH69WjmNodOp54erRs=; b=iWp+/OwLmYjoIYTF0vbEv3HLQJBsEwy0K2c66YFMt7rFWNo9GnJdcKEnl6s5OauK 2co9dXBvdwTGT2IyfgbzYwTQq6i7sRX1/4iaXAt7klQbX1afrjPUcsG6mLCFBAd6WYY owBNipDRiZsMmFB63LP7VsaI7EdKaSRqinoCumlQ= Subject: [PATCH] documentation: bitbake: add file-checksums to varflags section From: =?utf-8?q?Richard_Elberger?= To: =?utf-8?q?bitbake-devel=40lists=2Eopenembedded=2Eorg?= Cc: =?utf-8?q?docs=40lists=2Eyoctoproject=2Eorg?= , =?utf-8?q?Richard_Elberger?= Date: Sat, 25 Feb 2023 16:36:06 +0000 Mime-Version: 1.0 References: <20230225163601.377422-1-rich@richelberger.com> X-Mailer: Amazon WorkMail Thread-Index: AQHZSTdAIrouy/VPT9qxy+VNpMFPdw== Thread-Topic: [PATCH] documentation: bitbake: add file-checksums to varflags section X-Original-Mailer: git-send-email 2.34.1 X-Wm-Sent-Timestamp: 1677342965 Message-ID: <01000186896e845c-37272abb-a04f-4c1e-87ef-c0007b322ca0-000000@email.amazonses.com> Feedback-ID: 1.us-east-1.LF00NED762KFuBsfzrtoqw+Brn/qlF9OYdxWukAhsl8=:AmazonSES X-SES-Outgoing: 2023.02.25-54.240.8.18 List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Sat, 25 Feb 2023 16:36:09 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/3742 Fixes [YOCTO #11605] by: - Adding definition of file-checksums to Variable Flags section. - Describe data to add to list which adds external file dependencies. - Write example on usage to prepend a value to file-checksums list. Signed-off-by: Richard Elberger --- .../bitbake-user-manual-metadata.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) -- 2.34.1 diff --git a/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst b/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst index deb7afad..ba8129af 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst @@ -1496,6 +1496,23 @@ functionality of the task: directory listed is used as the current working directory for the task. +- ``[file-checksums]``: Controls the file dependencies for a task. The + baseline file list is the set of files associated with + :term:`SRC_URI`. May be used to set additional dependencies on + files not associated with :term:`SRC_URI`. + + The value set to the list is a file-boolean pair where the first + value is the file name and the second is whether or not it + physically exists on the filesystem. :: + + do_configure[file-checksums] += "${MY_DIRPATH}/my-file.txt:True" + + It is important to record any paths which the task looked at and + which didn't exist. This means that if these do exist at a later + time, the task can be rerun with the new additional files. The + "exists" True or False value after the path allows this to be + handled. + - ``[lockfiles]``: Specifies one or more lockfiles to lock while the task executes. Only one task may hold a lockfile, and any task that attempts to lock an already locked file will block until the lock is