mirror of
https://git.yoctoproject.org/poky
synced 2026-06-01 13:09:50 +00:00
ref-manual: Applied Paul Eggleton's buildhistory patch 2 of 5.
Additional information added to the end of the "Build History Package Information" section." Buildhistory now collects information on SRCREV values for recipes fetched from a version control system e.g. Git; additionally a buildhistory-collect-srcrevs tool is provided to gather this and convert it to a format suitable for inclusion in global configuration. Add information on these new features to the appropriate section. (From yocto-docs rev: 8c38bcbe8e737d7dfb41a763c87a3a6269e6f980) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
committed by
Richard Purdie
parent
67f4fd4ffa
commit
ea8e60842d
@@ -545,6 +545,58 @@
|
|||||||
busybox-staticdev busybox-locale
|
busybox-staticdev busybox-locale
|
||||||
</literallayout>
|
</literallayout>
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Finally, for those recipes that are fetched from a version control
|
||||||
|
system (such as Git) there is a file that lists the source revision(s)
|
||||||
|
specified in the recipe and the actual revision used when building
|
||||||
|
(which may be different when <filename>SRCREV</filename> is set to
|
||||||
|
<filename>${AUTOREV}</filename> for example). Here is an example
|
||||||
|
of one of these files:
|
||||||
|
<filename>buildhistory/packages/emenlow-poky-linux/linux-yocto/latest_srcrev</filename>):
|
||||||
|
<literallayout class='monospaced'>
|
||||||
|
# SRCREV_machine = "b5c37fe6e24eec194bb29d22fdd55d73bcc709bf"
|
||||||
|
SRCREV_machine = "b5c37fe6e24eec194bb29d22fdd55d73bcc709bf"
|
||||||
|
# SRCREV_emgd = "caea08c988e0f41103bbe18eafca20348f95da02"
|
||||||
|
SRCREV_emgd = "caea08c988e0f41103bbe18eafca20348f95da02"
|
||||||
|
# SRCREV_meta = "c2ed0f16fdec628242a682897d5d86df4547cf24"
|
||||||
|
SRCREV_meta = "c2ed0f16fdec628242a682897d5d86df4547cf24"
|
||||||
|
</literallayout>
|
||||||
|
You can use the <filename>buildhistory-collect-srcrevs</filename>
|
||||||
|
command to collect the stored <filename>SRCREV</filename> values
|
||||||
|
from build history and report them in a format suitable for use in
|
||||||
|
global configuration (for example, local.conf or a distro include
|
||||||
|
file) to override floating AUTOREV values to a fixed set of revisions.
|
||||||
|
Here is some example output from this command:
|
||||||
|
<literallayout class='monospaced'>
|
||||||
|
# emenlow-poky-linux
|
||||||
|
SRCREV_machine_pn-linux-yocto = "b5c37fe6e24eec194bb29d22fdd55d73bcc709bf"
|
||||||
|
SRCREV_emgd_pn-linux-yocto = "caea08c988e0f41103bbe18eafca20348f95da02"
|
||||||
|
SRCREV_meta_pn-linux-yocto = "c2ed0f16fdec628242a682897d5d86df4547cf24"
|
||||||
|
# core2-poky-linux
|
||||||
|
SRCREV_pn-kmod = "62081c0f68905b22f375156d4532fd37fa5c8d33"
|
||||||
|
SRCREV_pn-blktrace = "d6918c8832793b4205ed3bfede78c2f915c23385"
|
||||||
|
SRCREV_pn-opkg = "649"
|
||||||
|
</literallayout>
|
||||||
|
Some notes on using the <filename>buildhistory-collect-srcrevs</filename>
|
||||||
|
command:
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem><para>By default only values where the SRCREV was
|
||||||
|
not hardcoded (usually when AUTOREV was used) are reported
|
||||||
|
- use the <filename>-a</filename> option to see all SRCREV
|
||||||
|
values.</para></listitem>
|
||||||
|
<listitem><para>The output statements may not have any effect
|
||||||
|
in the face of overrides applied elsewhere in the build system
|
||||||
|
configuration; use the <filename>-f</filename> option to add the
|
||||||
|
<filename>forcevariable</filename> override to each output line
|
||||||
|
if you need to work around this.</para></listitem>
|
||||||
|
<listitem><para>The script does not do any special handling for
|
||||||
|
building for multiple machines; however it does place a
|
||||||
|
comment before each set of values specifying which triplet
|
||||||
|
(for example <filename>emenlow-poky-linux</filename>) that they
|
||||||
|
belong to as shown above.</para></listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</para>
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
<section id='build-history-image-information'>
|
<section id='build-history-image-information'>
|
||||||
|
|||||||
Reference in New Issue
Block a user