summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual/dev-manual-common-tasks.xml
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-08-01 15:28:03 +0300
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-08-02 10:00:26 +0100
commit4a226369b7bb37a971c77d4abc88df81033f56c5 (patch)
tree534656b22f0d9b9ec71b163191da21b03f839716 /documentation/dev-manual/dev-manual-common-tasks.xml
parentd283686dc3f785888c334594f4be0fd35c452def (diff)
downloadpoky-4a226369b7bb37a971c77d4abc88df81033f56c5.tar.gz
dev-manual: Updates for checksums and wic
Accidentally put in a couple different things in this one commit. Oh well. 1. New wording for how the user needs to figure out some checksums for a recipe. 2. Fixed up some note placement in the wic reference section. (From yocto-docs rev: 6c13f49c265c99ddd6dcd4ec3c3c8e66b78824e0) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual/dev-manual-common-tasks.xml')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml47
1 files changed, 29 insertions, 18 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 4174d94527..5f8da23611 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -1789,13 +1789,25 @@
1789 </para> 1789 </para>
1790 1790
1791 <para> 1791 <para>
1792 Ideally, you should locate these checksums from the upstream 1792 Finding proper values for <filename>md5</filename> and
1793 website and use them in your recipe. 1793 <filename>sha256</filename> checksums can involve some work.
1794 However, many websites do not provide the checksums. 1794 Initially, you should locate any available signatures from
1795 If such is the case, you can use a "build-fail" method that 1795 the upstream source (i.e. <filename>md5</filename>,
1796 retrieves the exact strings you need. 1796 <filename>sha1</filename>, <filename>sha256</filename>,
1797 To use the "build-fail" method, comment the statements out 1797 <filename>GPG</filename>, and so forth).
1798 and then attempt to build the software. 1798 Because the OpenEmbedded build system only deals with
1799 <filename>sha256sum</filename> and <filename>md5sum</filename>,
1800 you should verify all the signatures you find by hand.
1801 </para>
1802
1803 <para>
1804 After you have verified as many signatures as you can,
1805 you can use a "build-fail" method that retrieves the exact
1806 <filename>sha256sum</filename> and <filename>md5sum</filename>
1807 checksums you need.
1808 To use the "build-fail" method, comment the
1809 <filename>SRC_URI</filename> statements out that provide the
1810 checksums and then attempt to build the software.
1799 The build will produce an error for each missing checksum 1811 The build will produce an error for each missing checksum
1800 and as part of the error message provide the correct checksum 1812 and as part of the error message provide the correct checksum
1801 string. 1813 string.
@@ -4206,18 +4218,9 @@
4206 <filename>partition</filename> (or <filename>part</filename> 4218 <filename>partition</filename> (or <filename>part</filename>
4207 for short) and <filename>bootloader</filename>. 4219 for short) and <filename>bootloader</filename>.
4208 <note> 4220 <note>
4209 <para>
4210 Bootloader functionality and boot partitions are
4211 implemented by the various
4212 <filename>&dash;&dash;source</filename>
4213 plugins that implement bootloader functionality.
4214 The bootloader command essentially provides a means of
4215 modifying bootloader configuration.
4216 </para>
4217 <para>
4218 Future updates will implement more commands and options. 4221 Future updates will implement more commands and options.
4219 If you use anything that is not specifically 4222 If you use anything that is not specifically
4220 supported, results can be unpredictable.</para> 4223 supported, results can be unpredictable.
4221 </note> 4224 </note>
4222 </para> 4225 </para>
4223 4226
@@ -4364,7 +4367,15 @@
4364 4367
4365 <para> 4368 <para>
4366 This command specifies how the boot loader should be 4369 This command specifies how the boot loader should be
4367 and supports the following options: 4370 configured and supports the following options:
4371 <note>
4372 Bootloader functionality and boot partitions are
4373 implemented by the various
4374 <filename>&dash;&dash;source</filename>
4375 plugins that implement bootloader functionality.
4376 The bootloader command essentially provides a means of
4377 modifying bootloader configuration.
4378 </note>
4368 <itemizedlist> 4379 <itemizedlist>
4369 <listitem><para><emphasis><filename>&dash;&dash;timeout</filename>:</emphasis> 4380 <listitem><para><emphasis><filename>&dash;&dash;timeout</filename>:</emphasis>
4370 Specifies the number of seconds before the 4381 Specifies the number of seconds before the