diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-03-27 15:35:43 +0000 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-03-30 10:19:30 +0100 |
commit | 4093fa6c96eebe0bbafb93dc27d8a978cca436c4 (patch) | |
tree | 76762a016f27e4c4ebfeb81a1167df269c0e7989 /doc/user-manual/user-manual-execution.xml | |
parent | 5a406a69c14b6ddf179fea2c4bc68cddf9eddeea (diff) | |
download | bitbake-4093fa6c96eebe0bbafb93dc27d8a978cca436c4.tar.gz |
user-manual-execution.xml: Updated "Checksum (Signatures) section.
Fixes [YOCTO #5357]
Added a paragraph at the end of this section to address the fact
that the user can now debug Bitbake's processing of signatures.
This introduces the -S bitbake option and the fact that the
user can provide a couple parameters with it: "none" and
"printdiff".
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'doc/user-manual/user-manual-execution.xml')
-rw-r--r-- | doc/user-manual/user-manual-execution.xml | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/doc/user-manual/user-manual-execution.xml b/doc/user-manual/user-manual-execution.xml index a67516e85..d5a288c03 100644 --- a/doc/user-manual/user-manual-execution.xml +++ b/doc/user-manual/user-manual-execution.xml @@ -751,6 +751,30 @@ </para> <para> + It is worth noting that BitBake's "-S" option lets you + debug Bitbake's processing of signatures. + The options passed to -S allow different debugging modes + to be used, either using BitBake's own debug functions + or possibly those defined in the metadata/signature handler + itself. + The simplest parameter to pass is "none", which causes a + set of signature information to be written out into + <filename>STAMP_DIR</filename> + corresponding to the targets specified. + The other currently available parameter is "printdiff", + which causes BitBake to try to establish the closest + signature match it can (e.g. in the sstate cache) and then + run <filename>bitbake-diffsigs</filename> over the matches + to determine the stamps and delta where these two + stamp trees diverge. + <note> + It is likely that future versions of BitBake with + provide other signature handlers triggered through + additional "-S" paramters. + </note> + </para> + + <para> You can find more information on checksum metadata in the "<link linkend='task-checksums-and-setscene'>Task Checksums and Setscene</link>" section. |