From patchwork Fri Feb 24 20:14:32 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Richard Elberger X-Patchwork-Id: 20129 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 B2286C64ED8 for ; Fri, 24 Feb 2023 20:14:42 +0000 (UTC) Received: from a10-70.smtp-out.amazonses.com (a10-70.smtp-out.amazonses.com [54.240.10.70]) by mx.groups.io with SMTP id smtpd.web10.29125.1677269673981837374 for ; Fri, 24 Feb 2023 12:14:34 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@richelberger.com header.s=5u2mht5g5nbgnd5xxu4iibla5zobc5bd header.b=L/MYW8Kx; spf=pass (domain: amazonses.com, ip: 54.240.10.70, mailfrom: 010001868510232c-5929cc94-ce2e-4817-b311-3ea6f58a267c-000000@amazonses.com) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=5u2mht5g5nbgnd5xxu4iibla5zobc5bd; d=richelberger.com; t=1677269672; h=Subject:From:To:Cc:Date:Mime-Version:Content-Type:Content-Transfer-Encoding:References:Message-Id; bh=CdjYGt1eNld1sLRoglEvcjIDsxTm3+suAXgwDwxA2K0=; b=L/MYW8KxbjXIEcPX77LOBmY9unsVZuuacPRREUOt4Y3vt4DhMeONt8bhF0Co4qsQ xRzPjVwtndMauZAFKDlkA4FZVnqsMHAKszNTLYtvcAPB8jL6os0ObgqzqPdVcTP40Yr MkFy5rLv0i0kelRVxQRUnr2cI3DCJCcfAxjHMDJc= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=6gbrjpgwjskckoa6a5zn6fwqkn67xbtw; d=amazonses.com; t=1677269672; h=Subject:From:To:Cc:Date:Mime-Version:Content-Type:Content-Transfer-Encoding:References:Message-Id:Feedback-ID; bh=CdjYGt1eNld1sLRoglEvcjIDsxTm3+suAXgwDwxA2K0=; b=abuEIi2Cf2K/cWJsx5BGpSuESkGEafEMR5fV+9VbFhRmfMSBL7vb37E4TYvproWc TL6YIMLU6EoB9M3y3bpbLosWD8PGncP4az6c+gYviekcO017ZJIIqDeH4HyOJWTrIna toftfJ4whytXxB1n2a4h/4wob07ziPV8mQtJZqyg= 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: Fri, 24 Feb 2023 20:14:32 +0000 Mime-Version: 1.0 References: <20230224201426.357606-1-rich@richelberger.com> X-Mailer: Amazon WorkMail Thread-Index: AQHZSIyaIxX+jF56Q0uWGR6i9QqucA== Thread-Topic: [PATCH] documentation: bitbake: add file-checksums to varflags section X-Original-Mailer: git-send-email 2.34.1 X-Wm-Sent-Timestamp: 1677269671 Message-ID: <010001868510232c-5929cc94-ce2e-4817-b311-3ea6f58a267c-000000@email.amazonses.com> Feedback-ID: 1.us-east-1.LF00NED762KFuBsfzrtoqw+Brn/qlF9OYdxWukAhsl8=:AmazonSES X-SES-Outgoing: 2023.02.24-54.240.10.70 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 ; Fri, 24 Feb 2023 20:14:42 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/3740 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 | 11 +++++++++++ 1 file changed, 11 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..c2f0cad2 100644 --- a/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst +++ b/doc/bitbake-user-manual/bitbake-user-manual-metadata.rst @@ -1496,6 +1496,17 @@ 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 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" + - ``[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