summaryrefslogtreecommitdiffstats
path: root/documentation/bsp-guide/bsp.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/bsp-guide/bsp.xml')
-rw-r--r--documentation/bsp-guide/bsp.xml25
1 files changed, 21 insertions, 4 deletions
diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
index e2262a41f8..3cda0f6b70 100644
--- a/documentation/bsp-guide/bsp.xml
+++ b/documentation/bsp-guide/bsp.xml
@@ -902,8 +902,15 @@
902 <filename>recipes-bsp</filename>, <filename>recipes-graphics</filename>, 902 <filename>recipes-bsp</filename>, <filename>recipes-graphics</filename>,
903 <filename>recipes-core</filename>, and so forth). 903 <filename>recipes-core</filename>, and so forth).
904 </para></listitem> 904 </para></listitem>
905 <listitem><para>Place the BSP-specific files in the directory named for 905 <listitem><para>Place the BSP-specific files in the proper directory
906 your machine inside the BSP layer. 906 inside the BSP layer.
907 How expansive the layer is affects where you must place these files.
908 For example, if your layer supports several different machine types,
909 you need to be sure your layer's directory structure includes hierarchy
910 that separates the files out according to machine.
911 If your layer does not support multiple machines, the layer would not
912 have that additional hierarchy and the files would obviously not be
913 able to reside in a machine-specific directory.
907 </para></listitem> 914 </para></listitem>
908 </itemizedlist> 915 </itemizedlist>
909 </para> 916 </para>
@@ -912,7 +919,8 @@
912 Following is a specific example to help you better understand the process. 919 Following is a specific example to help you better understand the process.
913 Consider an example that customizes a recipe by adding 920 Consider an example that customizes a recipe by adding
914 a BSP-specific configuration file named <filename>interfaces</filename> to the 921 a BSP-specific configuration file named <filename>interfaces</filename> to the
915 <filename>init-ifupdown_1.0.bb</filename> recipe for machine "xyz". 922 <filename>init-ifupdown_1.0.bb</filename> recipe for machine "xyz" where the
923 BSP layer also supports several other machines.
916 Do the following: 924 Do the following:
917 <orderedlist> 925 <orderedlist>
918 <listitem><para>Edit the <filename>init-ifupdown_1.0.bbappend</filename> file so that it 926 <listitem><para>Edit the <filename>init-ifupdown_1.0.bbappend</filename> file so that it
@@ -926,8 +934,17 @@
926 <listitem><para>Create and place the new <filename>interfaces</filename> 934 <listitem><para>Create and place the new <filename>interfaces</filename>
927 configuration file in the BSP's layer here: 935 configuration file in the BSP's layer here:
928 <literallayout class='monospaced'> 936 <literallayout class='monospaced'>
929 meta-xyz/recipes-core/init-ifupdown/files/xyz/interfaces 937 meta-xyz/recipes-core/init-ifupdown/files/xyz-machine-one/interfaces
930 </literallayout> 938 </literallayout>
939 <note>
940 If the <filename>meta-xyz</filename> layer did not support
941 multiple machines, you would place the
942 <filename>interfaces</filename> configuration file in the
943 layer here:
944 <literallayout class='monospaced'>
945 meta-xyz/recipes-core/init-ifupdown/files/interfaces
946 </literallayout>
947 </note>
931 The 948 The
932 <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></ulink> 949 <ulink url='&YOCTO_DOCS_REF_URL;#var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></ulink>
933 variable in the append files extends the search path 950 variable in the append files extends the search path