blob: 887ff836f123453eca0460c54fe1f9e0946309e5 [file] [log] [blame]
Patrick Williamsc124f4f2015-09-15 14:41:29 -05001<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
2"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
3[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
Andrew Geisslerd25ed322020-06-27 00:28:28 -05004<!--SPDX-License-Identifier: CC-BY-2.0-UK-->
Patrick Williamsc124f4f2015-09-15 14:41:29 -05005
6<book id='kernel-dev' lang='en'
7 xmlns:xi="http://www.w3.org/2003/XInclude"
8 xmlns="http://docbook.org/ns/docbook"
9 >
10 <bookinfo>
11
12 <mediaobject>
13 <imageobject>
14 <imagedata fileref='figures/kernel-dev-title.png'
15 format='SVG'
16 align='left' scalefit='1' width='100%'/>
17 </imageobject>
18 </mediaobject>
19
20 <title>
21 Yocto Project Linux Kernel Development Manual
22 </title>
23
24 <authorgroup>
25 <author>
Patrick Williamsc124f4f2015-09-15 14:41:29 -050026 <affiliation>
Andrew Geissler82c905d2020-04-13 13:39:40 -050027 <orgname>&ORGNAME;</orgname>
Patrick Williamsc124f4f2015-09-15 14:41:29 -050028 </affiliation>
Andrew Geissler82c905d2020-04-13 13:39:40 -050029 <email>&ORGEMAIL;</email>
Patrick Williamsc124f4f2015-09-15 14:41:29 -050030 </author>
31 </authorgroup>
32
33 <revhistory>
34 <revision>
35 <revnumber>1.4</revnumber>
36 <date>April 2013</date>
Andrew Geissler82c905d2020-04-13 13:39:40 -050037 <revremark>The initial document released with the Yocto Project 1.4 Release.</revremark>
Patrick Williamsc124f4f2015-09-15 14:41:29 -050038 </revision>
39 <revision>
40 <revnumber>1.5</revnumber>
41 <date>October 2013</date>
42 <revremark>Released with the Yocto Project 1.5 Release.</revremark>
43 </revision>
44 <revision>
Patrick Williamsc124f4f2015-09-15 14:41:29 -050045 <revnumber>1.6</revnumber>
46 <date>April 2014</date>
47 <revremark>Released with the Yocto Project 1.6 Release.</revremark>
48 </revision>
49 <revision>
50 <revnumber>1.7</revnumber>
51 <date>October 2014</date>
52 <revremark>Released with the Yocto Project 1.7 Release.</revremark>
53 </revision>
54 <revision>
55 <revnumber>1.8</revnumber>
56 <date>April 2015</date>
57 <revremark>Released with the Yocto Project 1.8 Release.</revremark>
58 </revision>
59 <revision>
Patrick Williamsf1e5d692016-03-30 15:21:19 -050060 <revnumber>2.0</revnumber>
Patrick Williamsc124f4f2015-09-15 14:41:29 -050061 <date>October 2015</date>
Patrick Williamsf1e5d692016-03-30 15:21:19 -050062 <revremark>Released with the Yocto Project 2.0 Release.</revremark>
Patrick Williamsc124f4f2015-09-15 14:41:29 -050063 </revision>
Patrick Williamsd8c66bc2016-06-20 12:57:21 -050064 <revision>
65 <revnumber>2.1</revnumber>
66 <date>April 2016</date>
67 <revremark>Released with the Yocto Project 2.1 Release.</revremark>
68 </revision>
Patrick Williamsc0f7c042017-02-23 20:41:17 -060069 <revision>
70 <revnumber>2.2</revnumber>
71 <date>October 2016</date>
72 <revremark>Released with the Yocto Project 2.2 Release.</revremark>
73 </revision>
Brad Bishop37a0e4d2017-12-04 01:01:44 -050074 <revision>
Brad Bishop6e60e8b2018-02-01 10:27:11 -050075 <revnumber>2.3</revnumber>
76 <date>May 2017</date>
77 <revremark>Released with the Yocto Project 2.3 Release.</revremark>
Brad Bishop37a0e4d2017-12-04 01:01:44 -050078 </revision>
79 <revision>
Brad Bishopd7bf8c12018-02-25 22:55:05 -050080 <revnumber>2.4</revnumber>
81 <date>October 2017</date>
82 <revremark>Released with the Yocto Project 2.4 Release.</revremark>
Brad Bishop6e60e8b2018-02-01 10:27:11 -050083 </revision>
84 <revision>
Brad Bishop316dfdd2018-06-25 12:45:53 -040085 <revnumber>2.5</revnumber>
86 <date>May 2018</date>
87 <revremark>Released with the Yocto Project 2.5 Release.</revremark>
Brad Bishop37a0e4d2017-12-04 01:01:44 -050088 </revision>
Brad Bishopd5ae7d92018-06-14 09:52:03 -070089 <revision>
Brad Bishop1a4b7ee2018-12-16 17:11:34 -080090 <revnumber>2.6</revnumber>
91 <date>November 2018</date>
92 <revremark>Released with the Yocto Project 2.6 Release.</revremark>
Brad Bishopd5ae7d92018-06-14 09:52:03 -070093 </revision>
Brad Bishopf86d0552018-12-04 14:18:15 -080094 <revision>
Brad Bishop19323692019-04-05 15:28:33 -040095 <revnumber>2.7</revnumber>
Brad Bishopc342db32019-05-15 21:57:59 -040096 <date>May 2019</date>
Brad Bishop19323692019-04-05 15:28:33 -040097 <revremark>Released with the Yocto Project 2.7 Release.</revremark>
Brad Bishopf86d0552018-12-04 14:18:15 -080098 </revision>
Brad Bishopc342db32019-05-15 21:57:59 -040099 <revision>
Brad Bishop64c979e2019-11-04 13:55:29 -0500100 <revnumber>3.0</revnumber>
Andrew Geissler82c905d2020-04-13 13:39:40 -0500101 <date>October 2019</date>
Brad Bishop64c979e2019-11-04 13:55:29 -0500102 <revremark>Released with the Yocto Project 3.0 Release.</revremark>
Brad Bishopc342db32019-05-15 21:57:59 -0400103 </revision>
Andrew Geissler82c905d2020-04-13 13:39:40 -0500104 <revision>
105 <revnumber>3.1</revnumber>
106 <date>&REL_MONTH_YEAR;</date>
107 <revremark>Released with the Yocto Project 3.1 Release.</revremark>
108 </revision>
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500109 </revhistory>
110
111 <copyright>
112 <year>&COPYRIGHT_YEAR;</year>
113 <holder>Linux Foundation</holder>
114 </copyright>
115
116 <legalnotice>
117 <para>
118 Permission is granted to copy, distribute and/or modify this document under
119 the terms of the <ulink type="http" url="http://creativecommons.org/licenses/by-sa/2.0/uk/">Creative Commons Attribution-Share Alike 2.0 UK: England &amp; Wales</ulink> as published by Creative Commons.
120 </para>
Brad Bishop6e60e8b2018-02-01 10:27:11 -0500121 <note><title>Manual Notes</title>
122 <itemizedlist>
123 <listitem><para>
Brad Bishopd7bf8c12018-02-25 22:55:05 -0500124 This version of the
125 <emphasis>Yocto Project Linux Kernel Development Manual</emphasis>
126 is for the &YOCTO_DOC_VERSION; release of the
127 Yocto Project.
128 To be sure you have the latest version of the manual
Brad Bishop316dfdd2018-06-25 12:45:53 -0400129 for this release, go to the
Andrew Geissler82c905d2020-04-13 13:39:40 -0500130 <ulink url='&YOCTO_DOCS_URL;'>Yocto Project documentation page</ulink>
Brad Bishop316dfdd2018-06-25 12:45:53 -0400131 and select the manual from that site.
132 Manuals from the site are more up-to-date than manuals
133 derived from the Yocto Project released TAR files.
Brad Bishop6e60e8b2018-02-01 10:27:11 -0500134 </para></listitem>
135 <listitem><para>
Brad Bishop316dfdd2018-06-25 12:45:53 -0400136 If you located this manual through a web search, the
137 version of the manual might not be the one you want
138 (e.g. the search might have returned a manual much
139 older than the Yocto Project version with which you
140 are working).
141 You can see all Yocto Project major releases by
142 visiting the
143 <ulink url='&YOCTO_WIKI_URL;/wiki/Releases'>Releases</ulink>
144 page.
145 If you need a version of this manual for a different
146 Yocto Project release, visit the
Andrew Geissler82c905d2020-04-13 13:39:40 -0500147 <ulink url='&YOCTO_DOCS_URL;'>Yocto Project documentation page</ulink>
Brad Bishop316dfdd2018-06-25 12:45:53 -0400148 and select the manual set by using the
149 "ACTIVE RELEASES DOCUMENTATION" or "DOCUMENTS ARCHIVE"
150 pull-down menus.
151 </para></listitem>
Andrew Geissler82c905d2020-04-13 13:39:40 -0500152 <listitem>
153 <para>
Brad Bishop316dfdd2018-06-25 12:45:53 -0400154 To report any inaccuracies or problems with this
Andrew Geissler82c905d2020-04-13 13:39:40 -0500155 (or any other Yocto Project) manual, send an email to
156 the Yocto Project documentation mailing list at
157 <filename>docs@lists.yoctoproject.org</filename> or
158 log into the freenode <filename>#yocto</filename> channel.
159 </para>
160 </listitem>
Brad Bishopd7bf8c12018-02-25 22:55:05 -0500161 </itemizedlist>
162 </note>
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500163 </legalnotice>
164
165 </bookinfo>
166
167 <xi:include href="kernel-dev-intro.xml"/>
168
169 <xi:include href="kernel-dev-common.xml"/>
170
171 <xi:include href="kernel-dev-advanced.xml"/>
172
173 <xi:include href="kernel-dev-concepts-appx.xml"/>
174
175 <xi:include href="kernel-dev-maint-appx.xml"/>
176
Patrick Williamsc124f4f2015-09-15 14:41:29 -0500177 <xi:include href="kernel-dev-faq.xml"/>
178
179<!-- <index id='index'>
180 <title>Index</title>
181 </index>
182-->
183
184</book>
185<!--
186vim: expandtab tw=80 ts=4
187-->