diff options
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r-- | documentation/ref-manual/figures/configuration-compile-autoreconf.png | bin | 0 -> 48116 bytes | |||
-rw-r--r-- | documentation/ref-manual/technical-details.xml | 59 |
2 files changed, 59 insertions, 0 deletions
diff --git a/documentation/ref-manual/figures/configuration-compile-autoreconf.png b/documentation/ref-manual/figures/configuration-compile-autoreconf.png new file mode 100644 index 0000000000..596a8941b2 --- /dev/null +++ b/documentation/ref-manual/figures/configuration-compile-autoreconf.png | |||
Binary files differ | |||
diff --git a/documentation/ref-manual/technical-details.xml b/documentation/ref-manual/technical-details.xml index 5ee2615e5c..260766191a 100644 --- a/documentation/ref-manual/technical-details.xml +++ b/documentation/ref-manual/technical-details.xml | |||
@@ -1066,6 +1066,65 @@ | |||
1066 | section. | 1066 | section. |
1067 | </para> | 1067 | </para> |
1068 | </section> | 1068 | </section> |
1069 | |||
1070 | <section id='configuration-and-compilation-dev-environment'> | ||
1071 | <title>Configuration and Compilation</title> | ||
1072 | |||
1073 | <para> | ||
1074 | After source code is patched, BitBake executes tasks that | ||
1075 | configure and compile the source code: | ||
1076 | <imagedata fileref="figures/configuration-compile-autoreconf.png" align="center" width="7in" depth="5in" /> | ||
1077 | </para> | ||
1078 | |||
1079 | <para> | ||
1080 | This step in the build process consists of three tasks: | ||
1081 | <itemizedlist> | ||
1082 | <listitem><para><emphasis><filename>do_configure</filename>:</emphasis> | ||
1083 | This task configures the source by enabling and | ||
1084 | disabling any build-time and configuration options for | ||
1085 | the software being built. | ||
1086 | Configurations can come from the recipe itself as well | ||
1087 | as from an inherited class. | ||
1088 | Additionally, the software itself might configure itself | ||
1089 | depending on the target for which it is being built. | ||
1090 | </para> | ||
1091 | |||
1092 | <para>The configurations handled by the | ||
1093 | <filename>do_configure</filename> task are specific | ||
1094 | to source code configuration for the source code | ||
1095 | being built by the recipe.</para> | ||
1096 | |||
1097 | <para>If you are using | ||
1098 | <link linkend='ref-classes-autotools'><filename>autotools.bbclass</filename></link>, | ||
1099 | you can add additional configuration options by using | ||
1100 | the <link linkend='var-EXTRA_OECONF'><filename>EXTRA_OECONF</filename></link> | ||
1101 | variable. | ||
1102 | For information on how this variable works within | ||
1103 | that class, see the | ||
1104 | <filename>meta/classes/autotools.bbclass</filename>. | ||
1105 | </para></listitem> | ||
1106 | <listitem><para><emphasis><filename>do_compile</filename>:</emphasis> | ||
1107 | Once a configuration task has been satisfied, BitBake | ||
1108 | compiles the source using the | ||
1109 | <filename>do_compile</filename> task. | ||
1110 | Compilation occurs in the directory pointed to by the | ||
1111 | <link linkend='var-B'><filename>B</filename></link> | ||
1112 | variable. | ||
1113 | Realize that the <filename>B</filename> directory, by | ||
1114 | default, is the same as the | ||
1115 | <link linkend='var-S'><filename>S</filename></link> | ||
1116 | directory.</para></listitem> | ||
1117 | <listitem><para><emphasis><filename>do_install</filename>:</emphasis> | ||
1118 | Once compilation is done, BitBake executes the | ||
1119 | <filename>do_install</filename> task. | ||
1120 | This task copies files from the <filename>B</filename> | ||
1121 | directory and places them in a holding area pointed to | ||
1122 | by the | ||
1123 | <link linkend='var-D'><filename>D</filename></link> | ||
1124 | variable.</para></listitem> | ||
1125 | </itemizedlist> | ||
1126 | </para> | ||
1127 | </section> | ||
1069 | </section> | 1128 | </section> |
1070 | </section> | 1129 | </section> |
1071 | 1130 | ||