ref-manual, mega-manual: new section on config/compile for expanded build
Fixes [YOCTO #2808] Added a new section on configuration and compilation for the expanded discussion for the build process. This involved a new figure that had to be added to both the ref-manual and mega-manual figures directories. (From yocto-docs rev: 9ba90c79990b79226d6e95e4a01ddedeccb94b35) 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
8870546272
commit
bf91da6c0a
Binary file not shown.
After Width: | Height: | Size: 47 KiB |
Binary file not shown.
After Width: | Height: | Size: 47 KiB |
|
@ -1066,6 +1066,65 @@
|
||||||
section.
|
section.
|
||||||
</para>
|
</para>
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
|
<section id='configuration-and-compilation-dev-environment'>
|
||||||
|
<title>Configuration and Compilation</title>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
After source code is patched, BitBake executes tasks that
|
||||||
|
configure and compile the source code:
|
||||||
|
<imagedata fileref="figures/configuration-compile-autoreconf.png" align="center" width="7in" depth="5in" />
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
This step in the build process consists of three tasks:
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem><para><emphasis><filename>do_configure</filename>:</emphasis>
|
||||||
|
This task configures the source by enabling and
|
||||||
|
disabling any build-time and configuration options for
|
||||||
|
the software being built.
|
||||||
|
Configurations can come from the recipe itself as well
|
||||||
|
as from an inherited class.
|
||||||
|
Additionally, the software itself might configure itself
|
||||||
|
depending on the target for which it is being built.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>The configurations handled by the
|
||||||
|
<filename>do_configure</filename> task are specific
|
||||||
|
to source code configuration for the source code
|
||||||
|
being built by the recipe.</para>
|
||||||
|
|
||||||
|
<para>If you are using
|
||||||
|
<link linkend='ref-classes-autotools'><filename>autotools.bbclass</filename></link>,
|
||||||
|
you can add additional configuration options by using
|
||||||
|
the <link linkend='var-EXTRA_OECONF'><filename>EXTRA_OECONF</filename></link>
|
||||||
|
variable.
|
||||||
|
For information on how this variable works within
|
||||||
|
that class, see the
|
||||||
|
<filename>meta/classes/autotools.bbclass</filename>.
|
||||||
|
</para></listitem>
|
||||||
|
<listitem><para><emphasis><filename>do_compile</filename>:</emphasis>
|
||||||
|
Once a configuration task has been satisfied, BitBake
|
||||||
|
compiles the source using the
|
||||||
|
<filename>do_compile</filename> task.
|
||||||
|
Compilation occurs in the directory pointed to by the
|
||||||
|
<link linkend='var-B'><filename>B</filename></link>
|
||||||
|
variable.
|
||||||
|
Realize that the <filename>B</filename> directory, by
|
||||||
|
default, is the same as the
|
||||||
|
<link linkend='var-S'><filename>S</filename></link>
|
||||||
|
directory.</para></listitem>
|
||||||
|
<listitem><para><emphasis><filename>do_install</filename>:</emphasis>
|
||||||
|
Once compilation is done, BitBake executes the
|
||||||
|
<filename>do_install</filename> task.
|
||||||
|
This task copies files from the <filename>B</filename>
|
||||||
|
directory and places them in a holding area pointed to
|
||||||
|
by the
|
||||||
|
<link linkend='var-D'><filename>D</filename></link>
|
||||||
|
variable.</para></listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</para>
|
||||||
|
</section>
|
||||||
</section>
|
</section>
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue