enabling-and-disabling-build-history.html 3.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  4. <title>2.4.1. Enabling and Disabling Build History</title>
  5. <link rel="stylesheet" type="text/css" href="../book.css">
  6. <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
  7. <link rel="home" href="index.html" title="The Yocto Project Reference Manual">
  8. <link rel="up" href="maintaining-build-output-quality.html" title="2.4. Maintaining Build Output Quality">
  9. <link rel="prev" href="maintaining-build-output-quality.html" title="2.4. Maintaining Build Output Quality">
  10. <link rel="next" href="understanding-what-the-build-history-contains.html" title="2.4.2. Understanding What the Build History Contains">
  11. </head>
  12. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="section" title="2.4.1. Enabling and Disabling Build History">
  13. <div class="titlepage"><div><div><h3 class="title">
  14. <a name="enabling-and-disabling-build-history"></a>2.4.1. Enabling and Disabling Build History</h3></div></div></div>
  15. <p>
  16. Build history is disabled by default.
  17. To enable it, add the following statements to the end of your
  18. <code class="filename">conf/local.conf</code> file found in the
  19. <a class="link" href="../dev-manual/build-directory.html" target="_self">Build Directory</a>:
  20. </p>
  21. <pre class="literallayout">
  22. INHERIT += "buildhistory"
  23. BUILDHISTORY_COMMIT = "1"
  24. </pre>
  25. <p>
  26. Enabling build history as previously described
  27. causes the build process to collect build
  28. output information and commit it to a local
  29. <a class="link" href="../dev-manual/git.html" target="_self">Git</a> repository.
  30. </p>
  31. <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
  32. <h3 class="title">Note</h3>
  33. Enabling build history increases your build times slightly,
  34. particularly for images, and increases the amount of disk
  35. space used during the build.
  36. </div>
  37. <p>
  38. </p>
  39. <p>
  40. You can disable build history by removing the previous statements
  41. from your <code class="filename">conf/local.conf</code> file.
  42. However, you should realize that enabling and disabling
  43. build history in this manner can change the
  44. <code class="filename">do_package</code> task checksums, which if you
  45. are using the OEBasicHash signature generator (the default
  46. for many current distro configurations including
  47. <code class="filename">DISTRO = "poky"</code> and
  48. <code class="filename">DISTRO = ""</code>) will result in the packaging
  49. tasks being re-run during the subsequent build.
  50. </p>
  51. <p>
  52. To disable the build history functionality without causing the
  53. packaging tasks to be re-run, add just this statement to your
  54. <code class="filename">conf/local.conf</code> file:
  55. </p>
  56. <pre class="literallayout">
  57. BUILDHISTORY_FEATURES = ""
  58. </pre>
  59. <p>
  60. </p>
  61. </div></body>
  62. </html>