diff options
Diffstat (limited to 'documentation/kernel-dev/kernel-dev-advanced.xml')
-rw-r--r-- | documentation/kernel-dev/kernel-dev-advanced.xml | 70 |
1 files changed, 35 insertions, 35 deletions
diff --git a/documentation/kernel-dev/kernel-dev-advanced.xml b/documentation/kernel-dev/kernel-dev-advanced.xml index b754cb9791..8b626e5ec9 100644 --- a/documentation/kernel-dev/kernel-dev-advanced.xml +++ b/documentation/kernel-dev/kernel-dev-advanced.xml | |||
@@ -7,14 +7,14 @@ | |||
7 | <title>Working with Advanced Metadata</title> | 7 | <title>Working with Advanced Metadata</title> |
8 | 8 | ||
9 | <para> | 9 | <para> |
10 | In addition to configuration fragments and patches, the | 10 | In addition to supporting configuration fragments and patches, the |
11 | Yocto Project kernel tools support rich metadata that you can | 11 | Yocto Project kernel tools also support rich |
12 | use to define complex policies and BSP support. | 12 | <ulink url='&YOCTO_DOCS_DEV_URL;#metadata'>Metadata</ulink> that you can |
13 | The purpose of the metadata and the tools to manage it, known as | 13 | use to define complex policies and Board Support Package (BSP) support. |
14 | The purpose of the Metadata and the tools that manage it, known as | ||
14 | the kern-tools (<filename>kern-tools-native_git.bb</filename>), is | 15 | the kern-tools (<filename>kern-tools-native_git.bb</filename>), is |
15 | to assist in managing the complexity of the configuration and sources | 16 | to help you manage the complexity of the configuration and sources |
16 | in support of multiple Board Support Packages (BSPs) and Linux kernel | 17 | used to support multiple BSPs and Linux kernel types. |
17 | types. | ||
18 | </para> | 18 | </para> |
19 | 19 | ||
20 | <para> | 20 | <para> |
@@ -602,7 +602,7 @@ git repository: | |||
602 | or <filename>meta/cfg/kernel-cache/</filename> if you are creating | 602 | or <filename>meta/cfg/kernel-cache/</filename> if you are creating |
603 | metadata in-tree as described in | 603 | metadata in-tree as described in |
604 | the "<link linkend='in-tree-metadata'>In-Tree Metadata</link>" section. | 604 | the "<link linkend='in-tree-metadata'>In-Tree Metadata</link>" section. |
605 | </para> | 605 | </para> |
606 | 606 | ||
607 | <para> | 607 | <para> |
608 | Original text: | 608 | Original text: |
@@ -920,12 +920,12 @@ will want to specify in the KERNEL_FEATURES variable of the Linux kernel recipe | |||
920 | <literallayout class='monospaced'> | 920 | <literallayout class='monospaced'> |
921 | # Include this kernel type fragment to get the standard features and | 921 | # Include this kernel type fragment to get the standard features and |
922 | # configuration values. | 922 | # configuration values. |
923 | 923 | ||
924 | # Include all standard features | 924 | # Include all standard features |
925 | include standard-nocfg.scc | 925 | include standard-nocfg.scc |
926 | 926 | ||
927 | kconf non-hardware standard.cfg | 927 | kconf non-hardware standard.cfg |
928 | 928 | ||
929 | # individual cfg block section | 929 | # individual cfg block section |
930 | include cfg/fs/devtmpfs.scc | 930 | include cfg/fs/devtmpfs.scc |
931 | include cfg/fs/debugfs.scc | 931 | include cfg/fs/debugfs.scc |
@@ -933,7 +933,7 @@ will want to specify in the KERNEL_FEATURES variable of the Linux kernel recipe | |||
933 | include cfg/fs/ext2.scc | 933 | include cfg/fs/ext2.scc |
934 | include cfg/fs/ext3.scc | 934 | include cfg/fs/ext3.scc |
935 | include cfg/fs/ext4.scc | 935 | include cfg/fs/ext4.scc |
936 | 936 | ||
937 | include cfg/net/ipv6.scc | 937 | include cfg/net/ipv6.scc |
938 | include cfg/net/ip_nf.scc | 938 | include cfg/net/ip_nf.scc |
939 | include cfg/net/ip6_nf.scc | 939 | include cfg/net/ip6_nf.scc |
@@ -967,7 +967,7 @@ fragments together with any patches you want to use for all Linux kernel builds | |||
967 | of the specified ktype. In short, ktypes are where you define a high-level | 967 | of the specified ktype. In short, ktypes are where you define a high-level |
968 | kernel policy. Syntactically, however, they are no different than features (see | 968 | kernel policy. Syntactically, however, they are no different than features (see |
969 | 3.3.3). preempt-rt, and tiny. The ktype is selected by the LINUX_KERNEL_TYPE | 969 | 3.3.3). preempt-rt, and tiny. The ktype is selected by the LINUX_KERNEL_TYPE |
970 | variable in the recipe (see 3.1). | 970 | variable in the recipe (see 3.1). |
971 | 971 | ||
972 | By way of example, the linux-yocto-3.4 tree defines three ktypes: standard, | 972 | By way of example, the linux-yocto-3.4 tree defines three ktypes: standard, |
973 | tiny, and preempt-rt. The standard kernel type includes the generic Linux kernel | 973 | tiny, and preempt-rt. The standard kernel type includes the generic Linux kernel |
@@ -983,12 +983,12 @@ not currently include any source changes, but it may in the future. | |||
983 | The standard ktype is defined by standard.scc: | 983 | The standard ktype is defined by standard.scc: |
984 | # Include this kernel type fragment to get the standard features and | 984 | # Include this kernel type fragment to get the standard features and |
985 | # configuration values. | 985 | # configuration values. |
986 | 986 | ||
987 | # Include all standard features | 987 | # Include all standard features |
988 | include standard-nocfg.scc | 988 | include standard-nocfg.scc |
989 | 989 | ||
990 | kconf non-hardware standard.cfg | 990 | kconf non-hardware standard.cfg |
991 | 991 | ||
992 | # individual cfg block section | 992 | # individual cfg block section |
993 | include cfg/fs/devtmpfs.scc | 993 | include cfg/fs/devtmpfs.scc |
994 | include cfg/fs/debugfs.scc | 994 | include cfg/fs/debugfs.scc |
@@ -996,7 +996,7 @@ The standard ktype is defined by standard.scc: | |||
996 | include cfg/fs/ext2.scc | 996 | include cfg/fs/ext2.scc |
997 | include cfg/fs/ext3.scc | 997 | include cfg/fs/ext3.scc |
998 | include cfg/fs/ext4.scc | 998 | include cfg/fs/ext4.scc |
999 | 999 | ||
1000 | include cfg/net/ipv6.scc | 1000 | include cfg/net/ipv6.scc |
1001 | include cfg/net/ip_nf.scc | 1001 | include cfg/net/ip_nf.scc |
1002 | include cfg/net/ip6_nf.scc | 1002 | include cfg/net/ip6_nf.scc |
@@ -1092,7 +1092,7 @@ Note: It is not strictly necessary to create a ktype scc file. The BSP file can | |||
1092 | <literallayout class='monospaced'> | 1092 | <literallayout class='monospaced'> |
1093 | fri2.scc: | 1093 | fri2.scc: |
1094 | kconf hardware fri2.cfg | 1094 | kconf hardware fri2.cfg |
1095 | 1095 | ||
1096 | include cfg/x86.scc | 1096 | include cfg/x86.scc |
1097 | include features/eg20t/eg20t.scc | 1097 | include features/eg20t/eg20t.scc |
1098 | include cfg/dmaengine.scc | 1098 | include cfg/dmaengine.scc |
@@ -1119,19 +1119,19 @@ Note: It is not strictly necessary to create a ktype scc file. The BSP file can | |||
1119 | define KMACHINE fri2 | 1119 | define KMACHINE fri2 |
1120 | define KTYPE standard | 1120 | define KTYPE standard |
1121 | define KARCH i386 | 1121 | define KARCH i386 |
1122 | 1122 | ||
1123 | include ktypes/standard/standard.scc | 1123 | include ktypes/standard/standard.scc |
1124 | branch fri2 | 1124 | branch fri2 |
1125 | 1125 | ||
1126 | git merge emgd-1.14 | 1126 | git merge emgd-1.14 |
1127 | 1127 | ||
1128 | include fri2.scc | 1128 | include fri2.scc |
1129 | 1129 | ||
1130 | # Extra fri2 configs above the minimal defined in fri2.scc | 1130 | # Extra fri2 configs above the minimal defined in fri2.scc |
1131 | include cfg/efi-ext.scc | 1131 | include cfg/efi-ext.scc |
1132 | include features/drm-emgd/drm-emgd.scc | 1132 | include features/drm-emgd/drm-emgd.scc |
1133 | include cfg/vesafb.scc | 1133 | include cfg/vesafb.scc |
1134 | 1134 | ||
1135 | # default policy for standard kernels | 1135 | # default policy for standard kernels |
1136 | include cfg/usb-mass-storage.scc | 1136 | include cfg/usb-mass-storage.scc |
1137 | </literallayout> | 1137 | </literallayout> |
@@ -1162,10 +1162,10 @@ Note: It is not strictly necessary to create a ktype scc file. The BSP file can | |||
1162 | define KMACHINE fri2 | 1162 | define KMACHINE fri2 |
1163 | define KTYPE tiny | 1163 | define KTYPE tiny |
1164 | define KARCH i386 | 1164 | define KARCH i386 |
1165 | 1165 | ||
1166 | include ktypes/tiny/tiny.scc | 1166 | include ktypes/tiny/tiny.scc |
1167 | branch fri2 | 1167 | branch fri2 |
1168 | 1168 | ||
1169 | include fri2.scc | 1169 | include fri2.scc |
1170 | </literallayout> | 1170 | </literallayout> |
1171 | As you might expect, the tiny description includes quite a bit less. | 1171 | As you might expect, the tiny description includes quite a bit less. |
@@ -1236,7 +1236,7 @@ BSP definitions from the linux-yocto-3.4 repository: | |||
1236 | 1236 | ||
1237 | fri2.scc: | 1237 | fri2.scc: |
1238 | kconf hardware fri2.cfg | 1238 | kconf hardware fri2.cfg |
1239 | 1239 | ||
1240 | include cfg/x86.scc | 1240 | include cfg/x86.scc |
1241 | include features/eg20t/eg20t.scc | 1241 | include features/eg20t/eg20t.scc |
1242 | include cfg/dmaengine.scc | 1242 | include cfg/dmaengine.scc |
@@ -1257,19 +1257,19 @@ fri2-standard.scc: | |||
1257 | define KMACHINE fri2 | 1257 | define KMACHINE fri2 |
1258 | define KTYPE standard | 1258 | define KTYPE standard |
1259 | define KARCH i386 | 1259 | define KARCH i386 |
1260 | 1260 | ||
1261 | include ktypes/standard/standard.scc | 1261 | include ktypes/standard/standard.scc |
1262 | branch fri2 | 1262 | branch fri2 |
1263 | 1263 | ||
1264 | git merge emgd-1.14 | 1264 | git merge emgd-1.14 |
1265 | 1265 | ||
1266 | include fri2.scc | 1266 | include fri2.scc |
1267 | 1267 | ||
1268 | # Extra fri2 configs above the minimal defined in fri2.scc | 1268 | # Extra fri2 configs above the minimal defined in fri2.scc |
1269 | include cfg/efi-ext.scc | 1269 | include cfg/efi-ext.scc |
1270 | include features/drm-emgd/drm-emgd.scc | 1270 | include features/drm-emgd/drm-emgd.scc |
1271 | include cfg/vesafb.scc | 1271 | include cfg/vesafb.scc |
1272 | 1272 | ||
1273 | # default policy for standard kernels | 1273 | # default policy for standard kernels |
1274 | include cfg/usb-mass-storage.scc | 1274 | include cfg/usb-mass-storage.scc |
1275 | 1275 | ||
@@ -1291,10 +1291,10 @@ fri2-tiny.scc: | |||
1291 | define KMACHINE fri2 | 1291 | define KMACHINE fri2 |
1292 | define KTYPE tiny | 1292 | define KTYPE tiny |
1293 | define KARCH i386 | 1293 | define KARCH i386 |
1294 | 1294 | ||
1295 | include ktypes/tiny/tiny.scc | 1295 | include ktypes/tiny/tiny.scc |
1296 | branch fri2 | 1296 | branch fri2 |
1297 | 1297 | ||
1298 | include fri2.scc | 1298 | include fri2.scc |
1299 | 1299 | ||
1300 | As you might expect, the tiny description includes quite a bit less. In fact, | 1300 | As you might expect, the tiny description includes quite a bit less. In fact, |
@@ -1435,9 +1435,9 @@ include them in the BSP description for the board(s) that require them (see | |||
1435 | Alternatively, you can create a branch in your Linux kernel sources and apply | 1435 | Alternatively, you can create a branch in your Linux kernel sources and apply |
1436 | the patches there. You can then specify this new branch as the KBRANCH to use | 1436 | the patches there. You can then specify this new branch as the KBRANCH to use |
1437 | for this board. You can do this in the recipe with the KBRANCH variable: | 1437 | for this board. You can do this in the recipe with the KBRANCH variable: |
1438 | 1438 | ||
1439 | KBRANCH = "mynewbranch" | 1439 | KBRANCH = "mynewbranch" |
1440 | 1440 | ||
1441 | or in the BSP description using the "branch" command: | 1441 | or in the BSP description using the "branch" command: |
1442 | 1442 | ||
1443 | mybsp.scc: | 1443 | mybsp.scc: |