ref-manual: Updates to the FILESPATH variable.
Added some more clarity about how this variable works and the implications for using the default setting from the base.bbclass file. Namely, if you are going to have the build system look for files in your layer and your layer uses an append file, then you need to also use the FILESEXTRAPATHS variable to extend FILESPATHS. (From yocto-docs rev: 2826fa6f9286efb1d5ca6cf85f65266a35bb8cfc) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
ef04b1da28
commit
eedd602e3b
|
@ -1191,26 +1191,37 @@ Core layer for images cannot be removed
|
||||||
<glossentry id='var-FILESPATH'><glossterm>FILESPATH</glossterm>
|
<glossentry id='var-FILESPATH'><glossterm>FILESPATH</glossterm>
|
||||||
<glossdef>
|
<glossdef>
|
||||||
<para>
|
<para>
|
||||||
The default set of directories the OpenEmbedded build system uses
|
The default set of directories the OpenEmbedded build system
|
||||||
when searching for patches and files.
|
uses when searching for patches and files.
|
||||||
During the build process, BitBake searches each directory in
|
During the build process, BitBake searches each directory in
|
||||||
<filename>FILESPATH</filename> in the specified order when looking for
|
<filename>FILESPATH</filename> in the specified order when
|
||||||
files and patches specified by each <filename>file://</filename> URI in a recipe.
|
looking for files and patches specified by each
|
||||||
|
<filename>file://</filename> URI in a recipe.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
The default value for the <filename>FILESPATH</filename> variable is defined
|
The default value for the <filename>FILESPATH</filename>
|
||||||
in the <filename>base.bbclass</filename> class found in
|
variable is defined in the <filename>base.bbclass</filename>
|
||||||
<filename>meta/classes</filename> in the
|
class found in <filename>meta/classes</filename> in the
|
||||||
<ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>:
|
<ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>:
|
||||||
<literallayout class='monospaced'>
|
<literallayout class='monospaced'>
|
||||||
FILESPATH = "${@base_set_filespath(["${FILE_DIRNAME}/${BP}", \
|
FILESPATH = "${@base_set_filespath(["${FILE_DIRNAME}/${BP}", \
|
||||||
"${FILE_DIRNAME}/${BPN}", "${FILE_DIRNAME}/files"], d)}"
|
"${FILE_DIRNAME}/${BPN}", "${FILE_DIRNAME}/files"], d)}"
|
||||||
</literallayout>
|
</literallayout>
|
||||||
Do not hand-edit the <filename>FILESPATH</filename> variable.
|
<warning>
|
||||||
If you want to extend the set of pathnames that BitBake uses when searching for
|
Do not hand-edit the <filename>FILESPATH</filename>
|
||||||
files and patches, use the
|
variable.
|
||||||
<link linkend='var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></link> variable.
|
</warning>
|
||||||
|
Be aware that the default <filename>FILESPATH</filename>
|
||||||
|
directories do not map to directories in custom layers
|
||||||
|
where append files (<filename>.bbappend</filename>)
|
||||||
|
are used.
|
||||||
|
If you want the build system to find patches or files
|
||||||
|
that reside with your append files, you need to extend
|
||||||
|
the <filename>FILESPATH</filename> variable by using
|
||||||
|
the
|
||||||
|
<link linkend='var-FILESEXTRAPATHS'><filename>FILESEXTRAPATHS</filename></link>
|
||||||
|
variable.
|
||||||
</para>
|
</para>
|
||||||
</glossdef>
|
</glossdef>
|
||||||
</glossentry>
|
</glossentry>
|
||||||
|
|
Loading…
Reference in New Issue