diff options
Diffstat (limited to 'documentation/dev-manual/debugging.rst')
-rw-r--r-- | documentation/dev-manual/debugging.rst | 13 |
1 files changed, 10 insertions, 3 deletions
diff --git a/documentation/dev-manual/debugging.rst b/documentation/dev-manual/debugging.rst index ce29815e9f..e20637e1c6 100644 --- a/documentation/dev-manual/debugging.rst +++ b/documentation/dev-manual/debugging.rst | |||
@@ -339,7 +339,10 @@ BitBake has determined by doing the following: | |||
339 | :term:`BB_BASEHASH_IGNORE_VARS` | 339 | :term:`BB_BASEHASH_IGNORE_VARS` |
340 | information. | 340 | information. |
341 | 341 | ||
342 | There is also a ``bitbake-diffsigs`` command for comparing two | 342 | Debugging signature construction and unexpected task executions |
343 | =============================================================== | ||
344 | |||
345 | There is a ``bitbake-diffsigs`` command for comparing two | ||
343 | ``siginfo`` or ``sigdata`` files. This command can be helpful when | 346 | ``siginfo`` or ``sigdata`` files. This command can be helpful when |
344 | trying to figure out what changed between two versions of a task. If you | 347 | trying to figure out what changed between two versions of a task. If you |
345 | call ``bitbake-diffsigs`` with just one file, the command behaves like | 348 | call ``bitbake-diffsigs`` with just one file, the command behaves like |
@@ -356,8 +359,12 @@ BitBake command-line options:: | |||
356 | .. note:: | 359 | .. note:: |
357 | 360 | ||
358 | Two common values for `SIGNATURE_HANDLER` are "none" and "printdiff", which | 361 | Two common values for `SIGNATURE_HANDLER` are "none" and "printdiff", which |
359 | dump only the signature or compare the dumped signature with the cached one, | 362 | dump only the signature or compare the dumped signature with the most recent one, |
360 | respectively. | 363 | respectively. "printdiff" will try to establish the most recent |
364 | signature match (e.g. in the sstate cache) and then | ||
365 | compare the matched signatures to determine the stamps and delta | ||
366 | where these two stamp trees diverge. This can be used to determine why | ||
367 | tasks need to be re-run in situations where that is not expected. | ||
361 | 368 | ||
362 | Using BitBake with either of these options causes BitBake to dump out | 369 | Using BitBake with either of these options causes BitBake to dump out |
363 | ``sigdata`` files in the ``stamps`` directory for every task it would | 370 | ``sigdata`` files in the ``stamps`` directory for every task it would |