generic-poky/documentation/ref-manual/eclipse/html/poky-ref-manual/enabling-and-disabling-buil...

63 lines
3.1 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>2.4.1. Enabling and Disabling Build History</title>
<link rel="stylesheet" type="text/css" href="../book.css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="The Yocto Project Reference Manual">
<link rel="up" href="maintaining-build-output-quality.html" title="2.4. Maintaining Build Output Quality">
<link rel="prev" href="maintaining-build-output-quality.html" title="2.4. Maintaining Build Output Quality">
<link rel="next" href="understanding-what-the-build-history-contains.html" title="2.4.2. Understanding What the Build History Contains">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="section" title="2.4.1. Enabling and Disabling Build History">
<div class="titlepage"><div><div><h3 class="title">
<a name="enabling-and-disabling-build-history"></a>2.4.1. Enabling and Disabling Build History</h3></div></div></div>
<p>
Build history is disabled by default.
To enable it, add the following statements to the end of your
<code class="filename">conf/local.conf</code> file found in the
<a class="link" href="../dev-manual/build-directory.html" target="_self">Build Directory</a>:
</p>
<pre class="literallayout">
INHERIT += "buildhistory"
BUILDHISTORY_COMMIT = "1"
</pre>
<p>
Enabling build history as previously described
causes the build process to collect build
output information and commit it to a local
<a class="link" href="../dev-manual/git.html" target="_self">Git</a> repository.
</p>
<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
Enabling build history increases your build times slightly,
particularly for images, and increases the amount of disk
space used during the build.
</div>
<p>
</p>
<p>
You can disable build history by removing the previous statements
from your <code class="filename">conf/local.conf</code> file.
However, you should realize that enabling and disabling
build history in this manner can change the
<code class="filename">do_package</code> task checksums, which if you
are using the OEBasicHash signature generator (the default
for many current distro configurations including
<code class="filename">DISTRO = "poky"</code> and
<code class="filename">DISTRO = ""</code>) will result in the packaging
tasks being re-run during the subsequent build.
</p>
<p>
To disable the build history functionality without causing the
packaging tasks to be re-run, add just this statement to your
<code class="filename">conf/local.conf</code> file:
</p>
<pre class="literallayout">
BUILDHISTORY_FEATURES = ""
</pre>
<p>
</p>
</div></body>
</html>