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.
|
||||
</para>
|
||||
</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>
|
||||
|
||||
|
|
Loading…
Reference in New Issue