diff options
Diffstat (limited to 'bitbake')
-rw-r--r-- | bitbake/doc/user-manual/user-manual-ref-variables.xml | 95 |
1 files changed, 92 insertions, 3 deletions
diff --git a/bitbake/doc/user-manual/user-manual-ref-variables.xml b/bitbake/doc/user-manual/user-manual-ref-variables.xml index 9cf42fd0a4..05fbd5df87 100644 --- a/bitbake/doc/user-manual/user-manual-ref-variables.xml +++ b/bitbake/doc/user-manual/user-manual-ref-variables.xml | |||
@@ -17,7 +17,7 @@ | |||
17 | <para> | 17 | <para> |
18 | <link linkend='var-ASSUME_PROVIDED'>A</link> | 18 | <link linkend='var-ASSUME_PROVIDED'>A</link> |
19 | <link linkend='var-B'>B</link> | 19 | <link linkend='var-B'>B</link> |
20 | <!-- <link linkend='var-CFLAGS'>C</link> --> | 20 | <link linkend='var-CACHE'>C</link> |
21 | <link linkend='var-DEFAULT_PREFERENCE'>D</link> | 21 | <link linkend='var-DEFAULT_PREFERENCE'>D</link> |
22 | <link linkend='var-EXCLUDE_FROM_WORLD'>E</link> | 22 | <link linkend='var-EXCLUDE_FROM_WORLD'>E</link> |
23 | <link linkend='var-FAKEROOT'>F</link> | 23 | <link linkend='var-FAKEROOT'>F</link> |
@@ -930,10 +930,19 @@ | |||
930 | 930 | ||
931 | </glossdiv> | 931 | </glossdiv> |
932 | 932 | ||
933 | <!-- | ||
934 | <glossdiv id='var-glossary-c'><title>C</title> | 933 | <glossdiv id='var-glossary-c'><title>C</title> |
934 | |||
935 | <glossentry id='var-CACHE'><glossterm>CACHE</glossterm> | ||
936 | <glossdef> | ||
937 | <para> | ||
938 | Specifies the directory BitBake uses to store a cache | ||
939 | of the metadata so it does not need to be parsed every | ||
940 | time BitBake is started. | ||
941 | </para> | ||
942 | </glossdef> | ||
943 | </glossentry> | ||
944 | |||
935 | </glossdiv> | 945 | </glossdiv> |
936 | --> | ||
937 | 946 | ||
938 | <glossdiv id='var-glossary-d'><title>D</title> | 947 | <glossdiv id='var-glossary-d'><title>D</title> |
939 | 948 | ||
@@ -1118,6 +1127,48 @@ | |||
1118 | </glossdef> | 1127 | </glossdef> |
1119 | </glossentry> | 1128 | </glossentry> |
1120 | 1129 | ||
1130 | <glossentry id='var-FETCHCMD'><glossterm>FETCHCMD</glossterm> | ||
1131 | <glossdef> | ||
1132 | <para> | ||
1133 | Defines the command the BitBake fetcher module | ||
1134 | executes when running fetch operations. | ||
1135 | You need to use an override suffix when you use the | ||
1136 | variable (e.g. <filename>FETCHCMD_git</filename> | ||
1137 | or <filename>FETCHCMD_svn</filename>). | ||
1138 | </para> | ||
1139 | </glossdef> | ||
1140 | </glossentry> | ||
1141 | |||
1142 | <glossentry id='var-FILE'><glossterm>FILE</glossterm> | ||
1143 | <glossdef> | ||
1144 | <para> | ||
1145 | Points at the current file. | ||
1146 | BitBake sets this variable during the parsing process | ||
1147 | to identify the file being parsed. | ||
1148 | BitBake also sets this variable when a recipe is being | ||
1149 | executed to identify the recipe file. | ||
1150 | </para> | ||
1151 | </glossdef> | ||
1152 | </glossentry> | ||
1153 | |||
1154 | <glossentry id='var-FILESDIR'><glossterm>FILESDIR</glossterm> | ||
1155 | <glossdef> | ||
1156 | <para> | ||
1157 | Specifies directories BitBake uses when searching for | ||
1158 | patches and files. | ||
1159 | The "local" fetcher module uses these directories when | ||
1160 | handling <filename>file://</filename> URLs if the file | ||
1161 | was not found using | ||
1162 | <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link>. | ||
1163 | <note> | ||
1164 | The <filename>FILESDIR</filename> variable is | ||
1165 | deprecated and you should use | ||
1166 | <filename>FILESPATH</filename> in all new code. | ||
1167 | </note> | ||
1168 | </para> | ||
1169 | </glossdef> | ||
1170 | </glossentry> | ||
1171 | |||
1121 | <glossentry id='var-FILESPATH'><glossterm>FILESPATH</glossterm> | 1172 | <glossentry id='var-FILESPATH'><glossterm>FILESPATH</glossterm> |
1122 | <glossdef> | 1173 | <glossdef> |
1123 | <para> | 1174 | <para> |
@@ -1248,6 +1299,32 @@ | |||
1248 | </glossdef> | 1299 | </glossdef> |
1249 | </glossentry> | 1300 | </glossentry> |
1250 | 1301 | ||
1302 | <glossentry id='var-MULTI_PROVIDER_WHITELIST'><glossterm>MULTI_PROVIDER_WHITELIST</glossterm> | ||
1303 | <glossdef> | ||
1304 | <para> | ||
1305 | Allows you to suppress BitBake warnings caused when | ||
1306 | building two separate recipes that provide the same | ||
1307 | output. | ||
1308 | </para> | ||
1309 | |||
1310 | <para> | ||
1311 | Bitbake normally issues a warning when building two | ||
1312 | different recipes where each provides the same output. | ||
1313 | This scenario is usually something the user does not | ||
1314 | want. | ||
1315 | However, cases do exist where it makes sense, particularly | ||
1316 | in the <filename>virtual/*</filename> namespace. | ||
1317 | You can use this variable to suppress BitBake's warnings. | ||
1318 | </para> | ||
1319 | |||
1320 | <para> | ||
1321 | To use the variable, list provider names (e.g. | ||
1322 | recipe names, <filename>virtual/kernel</filename>, | ||
1323 | and so forth). | ||
1324 | </para> | ||
1325 | </glossdef> | ||
1326 | </glossentry> | ||
1327 | |||
1251 | </glossdiv> | 1328 | </glossdiv> |
1252 | 1329 | ||
1253 | <!-- | 1330 | <!-- |
@@ -1314,6 +1391,18 @@ | |||
1314 | </glossdef> | 1391 | </glossdef> |
1315 | </glossentry> | 1392 | </glossentry> |
1316 | 1393 | ||
1394 | <glossentry id='var-PERSISTENT_DIR'><glossterm>PERSISTENT_DIR</glossterm> | ||
1395 | <glossdef> | ||
1396 | <para> | ||
1397 | Specifies the directory BitBake uses to store data that | ||
1398 | should be preserved between builds. | ||
1399 | In particular, the data stored is the data that uses | ||
1400 | BitBake's persistent data API and the data used by the | ||
1401 | PR Server and PR Service. | ||
1402 | </para> | ||
1403 | </glossdef> | ||
1404 | </glossentry> | ||
1405 | |||
1317 | <glossentry id='var-PF'><glossterm>PF</glossterm> | 1406 | <glossentry id='var-PF'><glossterm>PF</glossterm> |
1318 | <glossdef> | 1407 | <glossdef> |
1319 | <para> | 1408 | <para> |