Commit Graph

4447 Commits

Author SHA1 Message Date
Scott Rifenbark
94e71dea32 ref-manual: Updated KBRANCH variable description
The description had gone stale and was referencing a linux
yocto kernel we don't support and BSPs we don't support.  Updated
it.

(From yocto-docs rev: 5041a2a26d703a885437abcedb24c7600d5365cd)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:33 +01:00
Scott Rifenbark
bace1910d9 kernel-dev: Additions to the "Overview" section.
I provided some background on two repositories: yocto-kernel-cache
and yocto-kernel-tools.

(From yocto-docs rev: 1741d6efd4ff8364a55d546897cab5e7cdee6da5)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:33 +01:00
Scott Rifenbark
429719213d kernel-dev: Updates to "Kernel Metadata Syntax" section
Scrubbed this section to bring it up to speed with more modern
BSP examples and better explanation of the types of Metadata
used.

(From yocto-docs rev: ba009de68a3786f83d9c3c9debffa8b811479786)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:33 +01:00
Scott Rifenbark
8dc04d54e0 kernel-dev: Updates to where kernel metadata is found
"cfg" and "features" used to reside in the linux-yocto-x.x repo
under meta.  They are now in a separate repo named
yocto-kernel-cache.  I rewrote a couple spots that incorrectly
referenced the old location.

(From yocto-docs rev: e643fc3df46658b8bcf9cdc12a78b527988b63a6)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:33 +01:00
Scott Rifenbark
946fac468e kernel-dev: Edits to the iteratively modifying source code section
This section has merged into a single topic now.  It still needs
work but it is gathered under one heading for now.

(From yocto-docs rev: 660ed8b64dedbab5400c84ec3759cea77c899c40)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:33 +01:00
Scott Rifenbark
721991dd4f kernel-dev: Removed a comment block
(From yocto-docs rev: d6cf2730a9acc9c5bfd3071794269b4e3e7273b6)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:33 +01:00
Scott Rifenbark
fae276ea09 kernel-dev: Eliminated "Generating Configuration Files" section.
This section was largely redundant now.  The small things that did
add value I placed in other areas of the chapter 2.  One was a new
section on expanding variables using bitbake -e.  Another was a bit
about the defconfig file.  And a small procedure on how to create
config fragments using the "diffconfig" command was retained.

Links from the dev-manual and the ref-manual were adjusted as well.

(From yocto-docs rev: 7059d3eac1fec20089cabf197503f1bec747686d)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:33 +01:00
Scott Rifenbark
2e21a56a8a kernel-dev: Added "Validating Configuration" section
Provided a new section on how to validate the configuration of the
kernel.

(From yocto-docs rev: 25f43d1baeff7d571fc60c7edca957d4ce6d6357)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:33 +01:00
Scott Rifenbark
77a52d0b10 kernel-dev: Edits to "Fine-Tuning the Kernel Configuration File"
This section needed some formatting to conform to the list structure
used throughout the manual.

(From yocto-docs rev: b6e6b66014963c1628c50e09787fdd46a45867b1)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:33 +01:00
Scott Rifenbark
025cbf0168 kernel-dev: Moved "dirty" kernel procedure up a level
This procedure needed to be pulled out of the section that was/is
called "Using an Iterative Development Process".  The section on
how to deal with "dirty" kernel version strings is a procedure
in its own right.  It is now up a level.

(From yocto-docs rev: cd8834fa8d77ac750b06c3367aee577c80dcc64e)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:33 +01:00
Scott Rifenbark
d48af3ed21 kernel-dev: Removed "kernel-dev-examples.xml" file.
File not used.

(From yocto-docs rev: 208bc193b02f4644e12c7d143d20ddafc5169907)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:32 +01:00
Scott Rifenbark
b55b22b4bf kernel-dev: removed old "kernel-dev-examples.xml" chapter.
This chapter is not used and was commented out.  I deleted the
comment block.

(From yocto-docs rev: c805d1034b9f9bed5990cd2bcb3a9088e3d0d542)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:32 +01:00
Kristi Rifenbark
ab9f5a5300 ref-manual: Updated Added a New Recipe to Workspace Layer section
Fixes [YOCTO #11392]

Updated the section to document how to specify a branch,
tag, or revision when using devtool add with a remote
URL.

(From yocto-docs rev: 903b4a4e72908572a5f8b8c822869bbd0fe76ec9)

Signed-off-by: Kristi Rifenbark <kristi.rifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:32 +01:00
Kristi Rifenbark
3cc1668534 ref-manual: Updated devtool --help output
Fixes [YOCTO #11392]

(From yocto-docs rev: 30eb6ef13b85f7f5e1784dbdd6a54b1367be212d)

Signed-off-by: Kristi Rifenbark <kristi.rifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:32 +01:00
Kristi Rifenbark
adcb7b7e73 ref-manual: Added NOAUTOPACKAGEDEBUG to variable glossary
Fixes [YOCTO #11800]

(From yocto-docs rev: 789a11aee778f6082134102659b317bc6c155b4c)

Signed-off-by: Kristi Rifenbark <kristi.rifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:32 +01:00
Scott Rifenbark
b8dfb03764 kernel-dev: Updated kernel configuration section
A lot of rewriting here in this section to get it up to speed.
Also, moved that final section on determining hardware and
non-hardware features into an appendix where it belonged.

(From yocto-docs rev: 752e80d6ae8f81a0de7743b11b010d0ef36b314b)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-10-06 12:06:32 +01:00
Scott Rifenbark
3ad1f402d9 ref-manual: Updated kernel example version in PREFERRED_VERSION.
(From yocto-docs rev: bc6960c01cffdc2cef7c9288db9daeed2c3e1a25)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-26 11:18:59 +01:00
Scott Rifenbark
0e7af54763 dev-manual: Updated compatible log program section.
Script name changed to "yocto-check-layer".

(From yocto-docs rev: 545a90dd2816c4e97dc70efc76c7cca49684c2d8)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-26 11:18:59 +01:00
Scott Rifenbark
c801d0425d kernel-dev: Updated "in-tree" defconfig example.
Section "Using an 'In-Tree' defconfig File" updated to use a
more syntactically correct KBUILD_DEFCONFIG_KMACHINE example.

(From yocto-docs rev: 64e6b16703fa3ce9ac8db25de8089d32ac7aeafc)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-26 11:18:59 +01:00
Scott Rifenbark
cc601ade6f ref-manual: Updated link formatting in KBUILD_DEFCONFIG variable.
(From yocto-docs rev: ba2aa642c3c1696a155b07840f84b8b3f0e692b5)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-26 11:18:59 +01:00
Scott Rifenbark
de671802c8 dev-manual: Compatibility program and moving kernel configuration
Should have been two commits but I forgot to do them separately.

1. I updated the YP Compatible Program section.

2. I moved the "Configuring the Kernel" section from the dev-manual
   to the kernel-dev manual.

(From yocto-docs rev: cdb5bbc917db55a2ca987ce9b9ed371f9fca6524)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-26 11:18:59 +01:00
Scott Rifenbark
f94f6e655f dev-manual, ref-manual: Image format implementation changes
Recently a number of changes have happened on the implementation
side of some image formats, and a few have been renamed.
The u-boot image signing code is now always available and no
longer in a stand-alone file.  The vmdk/mdi/qcow2 images have
been removed and are now just a conversion type that is applied
to wic images.

Reported-by: Tom Rini <trini@konsulko.com>
(From yocto-docs rev: ce86da3d48507cee12208e0138c285b4be83d8cd)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-22 17:53:44 +01:00
Scott Rifenbark
8f7df8648a kernel-dev: Edits to the devtool kernel development method.
Changes based on a run through of the procedure.

(From yocto-docs rev: 0a526bb15f597843d1e5da1eeca0a952c6c5016f)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-22 17:53:44 +01:00
Scott Rifenbark
b673c3b990 dev-manual: Replaced release names and numbers with variables
In several examples, hardcoded versions of release names and
versions were being used.  I updated to use variables from
poky.ent so that examples would use most recent release.

(From yocto-docs rev: 53f8e92075cc34538f36d7fba392ea1ac9a6dd1f)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-22 17:53:44 +01:00
Scott Rifenbark
b103ff6ba7 documentation: Purged "oe-init-build-env-memres" from docs
Fixes [YOCTO #11968]

Purged all occurrences of the "oe-init-build-env-memres" script
from the YP documentation set.  Occurrences in a lot of places.
The BBSERVER variable was also impacted and had to have the
definition updated.

(From yocto-docs rev: 274b05108d1bc53df20c11ab2efa15363bce23da)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-22 17:53:44 +01:00
Scott Rifenbark
2efe56a06f kernel-dev: Added note about running a clean build with a patch
Put this note at the end of the traditional kernel development
flow.  A way for the user to verify that the patch was applied
for a subsequent build.

(From yocto-docs rev: 598a518cd92980e1781649a3ed30ac585327dc0f)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-22 17:53:44 +01:00
Scott Rifenbark
2fe228645c ref-manual: Added "N" category to glossary
Discovered this item in the front of the glossary was commented
out and not showing up so the user did not have the option to
click on "N" to quickly get to the "N" entries, which did exist
and show up.  Uncommented it and put the proper beginning "N"
variable in as the start.

(From yocto-docs rev: 6d51dfb9de53db1222f68a6f0325eaad1a12cd6b)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-22 17:53:44 +01:00
Scott Rifenbark
294dddb6d3 kernel-dev: Updates to the traditional kernel development flow section.
(From yocto-docs rev: d81143d6ae27e2e360f923bde8e578e583a969a1)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-22 17:53:44 +01:00
Scott Rifenbark
0767740f32 kernel-dev: Updates to creating a layer section.
(From yocto-docs rev: a57ba3f227831225a544df1ab774422364b91d6f)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-22 17:53:44 +01:00
Scott Rifenbark
0d70911d4e kernel-dev: Updates to layer creation steps for kernel examples.
(From yocto-docs rev: 8044f6e255905f3e4798d20e6e89aaa93d2892fb)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-22 17:53:44 +01:00
Scott Rifenbark
379713e97b kernel-dev: Added some cross-references to layer creation.
(From yocto-docs rev: 67658657d10ae1e243a27ff8b3df60f31ccd9740)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-22 17:53:44 +01:00
Scott Rifenbark
46d9bd0076 kernel-dev: Updated 4.4 to 4.12 for kernel example in layer
(From yocto-docs rev: ba8dd3676e3800b8356b7de948ceeb6e4cba4bbf)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-22 17:53:44 +01:00
Scott Rifenbark
082dcd0163 kernel-dev: Updates to the kernel flow procedures
(From yocto-docs rev: b8baf67ece6e80884fa198ddd51715c329822f28)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:19 +01:00
Scott Rifenbark
b083ac9bad poky.ent: Updated "tbd" to "Rocko" for the 2.4 release.
(From yocto-docs rev: 9726be46bc8c89e03352e0168898db643801bb35)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:19 +01:00
Scott Rifenbark
26975ed662 dev-manual: Added links to branch and tag checkout from overview.
(From yocto-docs rev: 122948411e1121be862caa43d216126c3a01f1fc)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:19 +01:00
Scott Rifenbark
b64872f9ab kernel-dev, mega-manual: kernel dev flow fig update and chapter revs
Updated the kernel development flow diagram to have an arrow from
the repositories to the box that says you need to clone the
kernel repository.  Also, provided some wording changes in the
end of the chapter.

(From yocto-docs rev: c77cff4f7b0795d5429dc47c2ad63aec6d19d513)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:19 +01:00
Scott Rifenbark
0b929b558b kernel-dev: Updated list of kernel repositories to have 4.12 and cache
I added the linux-yocto-4.12 kernel repository and the linux-yocto-cache
repository to the list of Yocto Linux Kernel repositories in the
Source Repositories.

(From yocto-docs rev: 88fedda0fa4a4dfc468f0dc404fa9f04390cbed7)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:19 +01:00
Scott Rifenbark
f2d4f77afb kernel-dev: Updates to the kernel patch examples.
Switching to kernel version 4.12.  Pulled some old commented
stuff out.

(From yocto-docs rev: c0a5c886256d3477ddaf670df4939bec1c73152e)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:19 +01:00
Scott Rifenbark
db3c4c8557 dev-manual: Updated the reader pointers after poky clone
Added in a sentence to point to the kernel-dev manual should
the user be interested in kernel development.

(From yocto-docs rev: cc47606af5b7eb2fdc669aa2c0c4dfbd930b8247)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:19 +01:00
Scott Rifenbark
ccbfdd795e kernel-dev: Added the host prep for kernel dev to the chapter.
(From yocto-docs rev: 7343f1108808bb3be182af58325f9e3195ff4d8e)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:18 +01:00
Scott Rifenbark
d4be6ea72a kernel-dev: Updates to the intro chapter
I moved the flow diagram up higher and completely removed
the procedures to get the build host ready for kernel
development.  Those are now in the common tasks chapter.

Lots of rewriting

Signen-off-by: Scott Rifenbark <srifenbark@gmail.com>

Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:18 +01:00
Scott Rifenbark
2bfabb5539 kernel-dev: Updated the kernel flow diagram
Had to account for devtool and traditional kernel methods
now.

(From yocto-docs rev: 74580d9a61fa012406059ba2a3348d38fdc24d4c)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:18 +01:00
Kristi Rifenbark
574633641a ref-manual: Updated PREFERRED_PROVIDER variable
Fixes [YOCTO #11762]
Added a link from variable to new virtual providers
section.

(From yocto-docs rev: d87726cf4962ca093c63d23d9e04f41d448c9594)

Signed-off-by: Kristi Rifenbark <kristi.rifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:18 +01:00
Kristi Rifenbark
734de503fa ref-manual: Added new section on virtual providers
Fixes [YOCTO #11762]

(From yocto-docs rev: 2633bae48fa08cd3a889d3f205abcc9833b1be2f)

Signed-off-by: Kristi Rifenbark <kristi.rifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:18 +01:00
Kristi Rifenbark
1d42e21db4 ref-manual: Added missing variables to glossary
Fixed [YOCTO #10642]

Added the following variables:
BUILD_CC_ARCH
BUILD_LD_ARCH
BUILD_AS_ARCH
BUILD_FC
BUILD_LD
BUILD_CCLD
BUILD_STRIP

(From yocto-docs rev: eb602d0a5fca67228607710d5d33873f1b0529f1)

Signed-off-by: Kristi Rifenbark <kristi.rifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-13 18:00:18 +01:00
Scott Rifenbark
ee5bce2d11 kernel-dev: Removed bad reference for creating patches.
We do not want to mix traditional kernel development with
kernel development using devtool.  This reference implied that
was okay to do.

(From yocto-docs rev: 38c3a5d3b47e15880ca10ed30ae4a450ecc851cd)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-02 00:52:49 +01:00
Scott Rifenbark
bfe0fba09c kernel-dev: Added output to kernel clone example.
(From yocto-docs rev: d5880262ab74499fbeef620af7907ee6e5d328fd)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-02 00:52:49 +01:00
Scott Rifenbark
cce4bf737e kernel-dev: Removed bare clone stuff for trad. kernel dev.
Bare clone setup is no longer recommended or necessary for
traditional kernel development.  All that is required is to
clone the kernel Git repo locally.

(From yocto-docs rev: cbe6d79da4fc2d5bba530b0fe6abead7783bdfbe)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-02 00:52:49 +01:00
Scott Rifenbark
59764811d0 kernel-dev: Some cleanup of the output for the kernel flow ex.
(From yocto-docs rev: 30bbe308339ad0665d59d8238e9420d1d594332e)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-02 00:52:49 +01:00
Scott Rifenbark
53db731cdc bsp-guide, mega-manual: Updated BSP dev flow figure
Removed spelling warning that was underlining "BSP" in the figure

(From yocto-docs rev: 354fe8c39057ab3aec24474ead65d2d13a5bb3b7)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2017-09-02 00:52:49 +01:00