Commit Graph

4558 Commits

Author SHA1 Message Date
Scott Rifenbark
d57b5e5149 ref-manual: Updated the do_fetch closer look for checksum behavior.
Fixes [YOCTO #5521]

I created a brief note in the do_fetch subsection of the
"Taking a Closer Look" section to deal with how the build
system uses checksums during do_fetch to re-execute stuff
if a file:// listed in the SRC_URI has had its contents
modified.

(From yocto-docs rev: 7b857635f2663af7c1d5e8aa87239472a5b47919)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:44 +01:00
Scott Rifenbark
a456afa06c dev-manual: Updates to the "Understanding Recipe Syntax" section.
Paul Eggleton sent me some feedback on this section.  I implemented
his suggestions.  Changes were minor.  One included a cross-link
to the BitBake User Manual.

(From yocto-docs rev: e9b5f252a1368b8c231dd659428a18eacf9757af)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:44 +01:00
Scott Rifenbark
84ee8c653a ref-manual, dev-manual: Updates for custom template configuration directory.
Fixes [YOCTO #5895]

I created a new section in the dev-manual titles
"Creating a Custom Template Configuration Directory" that describes
how the build system uses the template local.conf and bblayers.conf
and conf-notes.txt files as a basis when creating the real
deals in the build directory's conf folder.  The context of this
is so that the user can create their own directory with their own
template files for repeated configurations and to create a custom
conf-notes.txt file should they want the setup scripts to display
some custom list of targets.

I also modified the two script references in the ref-manual for
oe-init-build-env and oe-init-build-env-memres.  I needed to
link to the "how-to" section and added a bit in there about how
the scripts go about forming the conf files in the build directory.

(From yocto-docs rev: c07fb7082fe08387bbc546b2a23620dedc7127b8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:43 +01:00
Scott Rifenbark
fae1d7d567 dev-manual: Added reference to QA checks in the "Packaging" section.
The "Writing a New Recipe" section has a subsection named
"Packaging."  We needed a cross-reference here to the QA checks
performed for packaging.

(From yocto-docs rev: 34952ee1b56a84e0ee0edd142c7c8c68b122a3e3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:43 +01:00
Scott Rifenbark
1b68137d0f ref-manual: Reorded LSB image types to be together.
(From yocto-docs rev: e73c913b43ac39fd7a0d717c5b120b1676d8b506)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:43 +01:00
Scott Rifenbark
f1dc91c0f1 ref-manual: Edits to the IMAGE_DEVICE_TABLES variable.
Added "meta" as part of a path.

(From yocto-docs rev: 14cda136d1f8690f5ea15b218f2ab4fb49c0afa9)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:43 +01:00
Scott Rifenbark
a3b8282d25 dev-manual: Edits to the "Making Images More Secure" section.
Fixes [YOCTO #5482]

I applied some review edits as directed by Paul Eggleton. The
main feature was to merge the information on setting root
and extra user's passwords.  Also, permanently removed the
reference to the wiki that showed the less optimal way of
setting a root password.

(From yocto-docs rev: fef0e17cd3835580abed175ef4a7baf22b9b7673)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:43 +01:00
Scott Rifenbark
e891596f93 ref-manual: Edits to the "Images" section.
Added detailed requirements for the three LSB type images
in order for the build to create an LSB-compliant image.
Massaged the weston image a bit.

(From yocto-docs rev: 01fee2bebe76512ab5707212fc8d78df20d83126)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:43 +01:00
Scott Rifenbark
2aba525b98 ref-manual: Updates to several variables.
I implemented some review feedback from Paul Eggleton on these
variables:

  TARGET_CFLAGS
  BUILD_OPTIMIZATION
  SDKMACHINE
  IMAGE_ROOTFS_ALIGNMENT
  IMAGE_DEVICE_TABLES
  EXTRA_IMAGECMD
  SSTATE_MIRROR_ALLOW_NETWORK
  PACKAGE_ARCHS
  SDK_PACKAGE_ARCHS

(From yocto-docs rev: 6fd804376367449494d5a5cfeb7e9bb2f4c04de1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-06-18 10:30:43 +01:00
Scott Rifenbark
5d14f3c03a dev-manual: Updates to the "Making Images More Secure" section.
Fixes [YOCTO #5482]

Applied extensive review edist from Paul Eggleton throughout
this section.

(From yocto-docs rev: aa0bcd9199c83b43bad2390ff2292a8c2abe7455)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:19 +01:00
Scott Rifenbark
8beca348c1 ref-manual: Updated example in extrausers.bbclass.
I added a couple of examples to show how to set passwords.
This is the -P option for adduser.

(From yocto-docs rev: 2726fcd3b3c2a5144b23af6ab342832c242f85c1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:19 +01:00
Scott Rifenbark
74cd14cfe5 ref-manual: Fixed a link to the PACKAGE_ARCHS variable.
(From yocto-docs rev: 9723030d04b34794555aa7a864c39950001e005b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:19 +01:00
Scott Rifenbark
d4f1951f9a ref-manual: Edits to the PACKAGE_ARCHS variable.
(From yocto-docs rev: d29b25cdefa61017e832b7f52162bf8004bcedd4)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:19 +01:00
Scott Rifenbark
a6db9e71f8 ref-manual: Edits to the SDK_PACKAGE_ARCHS variable.
(From yocto-docs rev: bc66fbc0b6888b71258429abf808e10c22c5d3cb)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:19 +01:00
Scott Rifenbark
d9727abef5 ref-manual: Added the SDK_PACKAGE_ARCHS variable.
(From yocto-docs rev: 7a0abc52a4b85e98b383a6ac9ed46179a2662f7f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:19 +01:00
Scott Rifenbark
78a88eaabe ref-manual: Further corrections to the PACKAGE_ARCH variable.
(From yocto-docs rev: db48ae6f5720b3bc8ba6ae4caf565f1891dec5d5)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:18 +01:00
Scott Rifenbark
870b84633c ref-manual: Edits to PACKAGE_ARCH variable.
(From yocto-docs rev: 73ac04daf74bdca069e427b1069fa6075e5c30bd)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:18 +01:00
Scott Rifenbark
98b42bca0d ref-manual: Added the PACKAGE_ARCHS variable.
(From yocto-docs rev: 436758c094db7fc51aa14ee7870d7dac678b416e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:18 +01:00
Scott Rifenbark
cb5cf01aae ref-manual: Added the MACHINE_ARCH variable.
(From yocto-docs rev: 5f1523857d9c96753c40e1678354d641109b9130)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:18 +01:00
Scott Rifenbark
0b3adff2b7 ref-manual: Added the SSTATE_MIRROR_ALLOW_NETWORK variable.
(From yocto-docs rev: c16d4783ee5289fe6696f6ac056b63c4855b9c9e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:18 +01:00
Scott Rifenbark
1ddf03c1b7 ref-manual: Added EXTRA_IMAGECMD variable.
(From yocto-docs rev: cacffe510bf626d0806c323c248fc2cc2fbd11f0)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:18 +01:00
Scott Rifenbark
e07d2edabd ref-manual: Added IMAGE_CMD variable.
(From yocto-docs rev: 2050839776033fcd25ed4f9f376b9f2c44c3d235)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:18 +01:00
Scott Rifenbark
888daaa147 ref-manual: Added the IMAGE_DEVICE_TABLES variable.
(From yocto-docs rev: 65a27a0be63d6f0c4ac1c19440ef27c3ab6a4fa8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:18 +01:00
Scott Rifenbark
6d7e85a1b2 ref-manual: Added the IMAGE_ROOTFS_ALIGNMENT variable.
(From yocto-docs rev: 823434a08e77e71b63d08ee129b84ffd2f49d6bc)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:17 +01:00
Scott Rifenbark
87280e0b43 ref-manual: Edits to the PACKAGE_PREPROCESS_FUNCS variable.
I had the wrong description in here.

(From yocto-docs rev: eafe3fb2324d6361ee799177ffbb3de05795a2e2)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:17 +01:00
Scott Rifenbark
c0e41a1f9e ref-manual: Added the PACKAGESPLITFUNCS variable.
(From yocto-docs rev: 3d0a40cb47b117631fd3eebf7e2ef43f668390e7)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:17 +01:00
Scott Rifenbark
13afa786bf ref-manual: Added the PACKAGE_PREPROCESS_FUNCS variable.
(From yocto-docs rev: c2827351b70a51ef0f0703ab9014b9c03dd62b17)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:17 +01:00
Scott Rifenbark
bcd59abbeb ref-manual: Edits to the SDKMACHINE variable.
(From yocto-docs rev: 49192e94a6e3f6cc86f99801de4d62ffdd8e035e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:17 +01:00
Scott Rifenbark
9cb506b514 ref-manual: Edits to the UBOOT_MACHINE variable.
(From yocto-docs rev: 4db47e2571ba393d4d7ad2b21c7049d7094594af)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:17 +01:00
Scott Rifenbark
4fac0dd096 ref-manual: Edits to the LDFLAGS variable.
(From yocto-docs rev: c9aed9429902ecdedfdfc0241e94d10b145af859)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:17 +01:00
Scott Rifenbark
3cf5feeadf ref-manual: Edits to the TARGET_CXXFLAGS variable.
(From yocto-docs rev: fbe969ff13173b9be0bda72c15b11bbc1fb29e6d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:17 +01:00
Scott Rifenbark
d234817eea ref-manual: Edits to the CFLAGS and CPPFLAGS variables.
(From yocto-docs rev: 0a87848e5039e7c6fb17a1d082f75f28148c3b78)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:17 +01:00
Scott Rifenbark
0b69f06d76 ref-manual: Added BUILD_OPTIMIZATION variable to glossary.
(From yocto-docs rev: 9fbeed1e440909a9d624a1268107294c1f88c63f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:16 +01:00
Scott Rifenbark
1532bfdcf0 ref-manual: Edits to the SELECTED_OPTIMIZATION variable.
(From yocto-docs rev: d780744287fec32093dc1bf30cdfe6238c7aca27)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:16 +01:00
Scott Rifenbark
57bd61eabb ref-manual: Edits to the "Making Images More Secure" section.
Fixes [YOCTO #5482]

I added some key references to the section on considerations
specific to the OpenEmbedded build system.  In particular, I
provided some cross-linking back to the extrausers.bbclass
section to reference an example of adding a user account.  I
also split out the topics of adding an extra user and setting
a password on the image in the bulleted list.

(From yocto-docs rev: 19dcd70b9b5aba1bd5e7ce090d5449afcef726bf)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:16 +01:00
Scott Rifenbark
bd5973e787 ref-manual: Edits to the ROOTFS_POSTPROCESS_COMMAND variable.
Added a link to IMAGE_ROOTFS.

(From yocto-docs rev: b87975da8f99926f220d11a02b1655245d00f8e1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:16 +01:00
Scott Rifenbark
3de0d39f1d ref-manual: Removed some extra space beyond the literal example.
(From yocto-docs rev: 66bb31c9b59e5eaf4e35ade932a3d0f9083c4c47)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:16 +01:00
Scott Rifenbark
28d5925bdf dev-manual: Updated the "Making Images More Secure" section.
Fixes [YOCTO #5482]

I did some significant re-writing and re-organization of this
section.  It now includes a bit about securing an image in general,
provides general considerations, considerations specific to the
OpenEmbedded build system, pointers to some tools in meta-security
layer, and some other items.

(From yocto-docs rev: a900286992e781f451b3c180726965f5c7172bb9)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:16 +01:00
Scott Rifenbark
8e9bfa5210 ref-manual: another minor fix to the CPPFLAGS variable.
(From yocto-docs rev: 203d09cfe5f926b14a260886a5d213cf15f33442)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:16 +01:00
Scott Rifenbark
92e80f2cbc ref-manual: Took out the links to the "Making Images Secure" section.
Updated the following variables:

  CFLAGS
  CPPFLAGS
  CXXFLAGS

(From yocto-docs rev: 58d82513ef70287717e7e208742aa72196708fc1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:16 +01:00
Scott Rifenbark
74e21f3ea5 ref-manual: More edits to some compiler passing variables.
(From yocto-docs rev: 39a6ade52082b4c82a91ac985f7312496a1e837b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:15 +01:00
Scott Rifenbark
1a8718c7cd ref-manual: Edits to a few variables in the glossary.
I updated the following variables with minor changes:

  TARGET_CC_ARCH
  BUILD_CPPFLAGS
  BUILDSDK_CPPFLAGS
  CPPFLAGS
  TARGET_CPPFLAGS

(From yocto-docs rev: f7d48ed379778a8568c7e5f812cdb1cbc5339f39)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:15 +01:00
Scott Rifenbark
acdafd5ff7 ref-manual: Edits to the QA checks message section and insane.bbclass.
Fixes [YOCTO #6159]

I applied some review edits to various parts of the QA chapter
as derived by Paul Eggleton.  Also, updated two areas of the
insane.bbclass list.

(From yocto-docs rev: 6529a261961339b747bb3b89b3080ef794244809)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:15 +01:00
Scott Rifenbark
3dd477c469 ref-manual: Applied review edits to QA messages and insane.bbclass.
Fixes [YOCTO #6159]

Edits from Paul Eggleton included some reformatting, some minor
wording tweaks, and edits to a couple tests as described in the
insane.bbclass.

(From yocto-docs rev: b42ef1bd51cb20f6bbb6bf812999e3a35b332339)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:15 +01:00
Scott Rifenbark
594833891d ref-manual: Added PRIVATE_LIBS variable and supporting links.
(From yocto-docs rev: f4e8652581fe99a0d833242a8483ed637e55e3a5)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:15 +01:00
Scott Rifenbark
566b9bc5b2 ref-manual: Added HOST_CC_ARCH variable.
(From yocto-docs rev: 6b241b6a7538796b9a0259fb01ff006d40b60cb1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:15 +01:00
Scott Rifenbark
6b8dc790c1 ref-manual: Added TUNE_CCARGS variable and supporting links.
(From yocto-docs rev: c06a389bb447ea35314f7545d19ef12fb8812fb9)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:15 +01:00
Scott Rifenbark
40a17324ce ref-manual: Added TARGET_CC_ARCH variable and supporting links.
(From yocto-docs rev: d0887f66e3bc9d420d7ce626d5467bbc6d259b90)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:15 +01:00
Scott Rifenbark
76e6f654cd ref-manual: Added variables that pass compilers and their supporting links.
Updated the CFLAGS and TARGET_CFLAGS variables.

Created these new variables:

 BUILD_CFLAGS
 BUILDSDK_CFLAGS
 CXXFLAGS
 TARGET_CXXFLAGS
 BUILD_CXXFLAGS
 BUILD_SDKFLAGS
 CPPFLAGS
 TARGET_CPPFLAGS
 BUILD_CPPFLAGS
 BUILDSDK_CPPFLAGS

(From yocto-docs rev: 00d1895f56f8d65944549ab216d1e0ccdceea674)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:15 +01:00
Scott Rifenbark
1071980635 ref-manual: Added BUILDSDK_LDFLAGS variable and supporting links.
(From yocto-docs rev: a63cb14dbd33187daa54d3953b464636f19c211a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2014-05-30 16:32:14 +01:00