MIRRORS/poky
1
0
Fork 0
mirror of git://git.yoctoproject.org/poky.git synced 2025-07-19 12:59:02 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity

dev-manual: improve descriptions of 'bitbake -S printdiff'

Browse Source 
Try to particularly emphasize that it can be used to find
out why something rebuilds when it shouldn't.

(From yocto-docs rev: 05d08b0bbaef760157c8d35a78d7405bc5ffce55)

Signed-off-by: Alexander Kanavin <alex@linutronix.de>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
This commit is contained in:
Alexander Kanavin 2024-03-18 16:02:09 +01:00 committed by Steve Sakoman
parent 2708ce2801
commit 8730750b33
2 changed files with 13 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
documentation/dev-manual/building.rst
View File

@ -775,10 +775,9 @@ your tunings to best consider build times and package feed maintenance.
in the script for information on how to use the tool. in the script for information on how to use the tool.
- *BitBake's "-S printdiff" Option:* Using this option causes - *BitBake's "-S printdiff" Option:* Using this option causes
BitBake to try to establish the closest signature match it can BitBake to try to establish the most recent signature match
(e.g. in the shared state cache) and then run ``bitbake-diffsigs`` (e.g. in the shared state cache) and then compare matched signatures
over the matches to determine the stamps and delta where these two to determine the stamps and delta where these two stamp trees diverge.
stamp trees diverge.
Building Software from an External Source Building Software from an External Source
========================================= =========================================

13
documentation/dev-manual/debugging.rst
View File

@ -339,7 +339,10 @@ BitBake has determined by doing the following:
:term:`BB_BASEHASH_IGNORE_VARS` :term:`BB_BASEHASH_IGNORE_VARS`
information. information.
There is also a ``bitbake-diffsigs`` command for comparing two Debugging signature construction and unexpected task executions
===============================================================
There is a ``bitbake-diffsigs`` command for comparing two
``siginfo`` or ``sigdata`` files. This command can be helpful when ``siginfo`` or ``sigdata`` files. This command can be helpful when
trying to figure out what changed between two versions of a task. If you trying to figure out what changed between two versions of a task. If you
call ``bitbake-diffsigs`` with just one file, the command behaves like call ``bitbake-diffsigs`` with just one file, the command behaves like
@ -356,8 +359,12 @@ BitBake command-line options::
.. note:: .. note::
Two common values for `SIGNATURE_HANDLER` are "none" and "printdiff", which Two common values for `SIGNATURE_HANDLER` are "none" and "printdiff", which
dump only the signature or compare the dumped signature with the cached one, dump only the signature or compare the dumped signature with the most recent one,
respectively. respectively. "printdiff" will try to establish the most recent
signature match (e.g. in the sstate cache) and then
compare the matched signatures to determine the stamps and delta
where these two stamp trees diverge. This can be used to determine why
tasks need to be re-run in situations where that is not expected.
Using BitBake with either of these options causes BitBake to dump out Using BitBake with either of these options causes BitBake to dump out
``sigdata`` files in the ``stamps`` directory for every task it would ``sigdata`` files in the ``stamps`` directory for every task it would