diff options
Diffstat (limited to 'bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml | 48 |
1 files changed, 24 insertions, 24 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml index 92b2c3d1be..3acd7c403e 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml | |||
@@ -44,7 +44,7 @@ | |||
44 | </literallayout> | 44 | </literallayout> |
45 | This code sets up an instance of the fetch class. | 45 | This code sets up an instance of the fetch class. |
46 | The instance uses a space-separated list of URLs from the | 46 | The instance uses a space-separated list of URLs from the |
47 | <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link> | 47 | <link linkend='var-bb-SRC_URI'><filename>SRC_URI</filename></link> |
48 | variable and then calls the <filename>download</filename> | 48 | variable and then calls the <filename>download</filename> |
49 | method to download the files. | 49 | method to download the files. |
50 | </para> | 50 | </para> |
@@ -78,7 +78,7 @@ | |||
78 | <listitem><para><emphasis>Pre-mirror Sites:</emphasis> | 78 | <listitem><para><emphasis>Pre-mirror Sites:</emphasis> |
79 | BitBake first uses pre-mirrors to try and find source files. | 79 | BitBake first uses pre-mirrors to try and find source files. |
80 | These locations are defined using the | 80 | These locations are defined using the |
81 | <link linkend='var-PREMIRRORS'><filename>PREMIRRORS</filename></link> | 81 | <link linkend='var-bb-PREMIRRORS'><filename>PREMIRRORS</filename></link> |
82 | variable. | 82 | variable. |
83 | </para></listitem> | 83 | </para></listitem> |
84 | <listitem><para><emphasis>Source URI:</emphasis> | 84 | <listitem><para><emphasis>Source URI:</emphasis> |
@@ -88,7 +88,7 @@ | |||
88 | <listitem><para><emphasis>Mirror Sites:</emphasis> | 88 | <listitem><para><emphasis>Mirror Sites:</emphasis> |
89 | If fetch failures occur, BitBake next uses mirror locations as | 89 | If fetch failures occur, BitBake next uses mirror locations as |
90 | defined by the | 90 | defined by the |
91 | <link linkend='var-MIRRORS'><filename>MIRRORS</filename></link> | 91 | <link linkend='var-bb-MIRRORS'><filename>MIRRORS</filename></link> |
92 | variable. | 92 | variable. |
93 | </para></listitem> | 93 | </para></listitem> |
94 | </itemizedlist> | 94 | </itemizedlist> |
@@ -144,7 +144,7 @@ | |||
144 | Any source files that are not local (i.e. | 144 | Any source files that are not local (i.e. |
145 | downloaded from the Internet) are placed into the download | 145 | downloaded from the Internet) are placed into the download |
146 | directory, which is specified by the | 146 | directory, which is specified by the |
147 | <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link> | 147 | <link linkend='var-bb-DL_DIR'><filename>DL_DIR</filename></link> |
148 | variable. | 148 | variable. |
149 | </para> | 149 | </para> |
150 | 150 | ||
@@ -184,11 +184,11 @@ | |||
184 | 184 | ||
185 | <para> | 185 | <para> |
186 | If | 186 | If |
187 | <link linkend='var-BB_STRICT_CHECKSUM'><filename>BB_STRICT_CHECKSUM</filename></link> | 187 | <link linkend='var-bb-BB_STRICT_CHECKSUM'><filename>BB_STRICT_CHECKSUM</filename></link> |
188 | is set, any download without a checksum triggers an | 188 | is set, any download without a checksum triggers an |
189 | error message. | 189 | error message. |
190 | The | 190 | The |
191 | <link linkend='var-BB_NO_NETWORK'><filename>BB_NO_NETWORK</filename></link> | 191 | <link linkend='var-bb-BB_NO_NETWORK'><filename>BB_NO_NETWORK</filename></link> |
192 | variable can be used to make any attempted network access a fatal | 192 | variable can be used to make any attempted network access a fatal |
193 | error, which is useful for checking that mirrors are complete | 193 | error, which is useful for checking that mirrors are complete |
194 | as well as other things. | 194 | as well as other things. |
@@ -265,11 +265,11 @@ | |||
265 | The filename you specify within the URL can be | 265 | The filename you specify within the URL can be |
266 | either an absolute or relative path to a file. | 266 | either an absolute or relative path to a file. |
267 | If the filename is relative, the contents of the | 267 | If the filename is relative, the contents of the |
268 | <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link> | 268 | <link linkend='var-bb-FILESPATH'><filename>FILESPATH</filename></link> |
269 | variable is used in the same way | 269 | variable is used in the same way |
270 | <filename>PATH</filename> is used to find executables. | 270 | <filename>PATH</filename> is used to find executables. |
271 | If the file cannot be found, it is assumed that it is available in | 271 | If the file cannot be found, it is assumed that it is available in |
272 | <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link> | 272 | <link linkend='var-bb-DL_DIR'><filename>DL_DIR</filename></link> |
273 | by the time the <filename>download()</filename> method is called. | 273 | by the time the <filename>download()</filename> method is called. |
274 | </para> | 274 | </para> |
275 | 275 | ||
@@ -304,7 +304,7 @@ | |||
304 | allows the name of the downloaded file to be specified. | 304 | allows the name of the downloaded file to be specified. |
305 | Specifying the name of the downloaded file is useful | 305 | Specifying the name of the downloaded file is useful |
306 | for avoiding collisions in | 306 | for avoiding collisions in |
307 | <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link> | 307 | <link linkend='var-bb-DL_DIR'><filename>DL_DIR</filename></link> |
308 | when dealing with multiple files that have the same name. | 308 | when dealing with multiple files that have the same name. |
309 | </para> | 309 | </para> |
310 | 310 | ||
@@ -355,7 +355,7 @@ | |||
355 | A special value of "now" causes the checkout to | 355 | A special value of "now" causes the checkout to |
356 | be updated on every build. | 356 | be updated on every build. |
357 | </para></listitem> | 357 | </para></listitem> |
358 | <listitem><para><emphasis><link linkend='var-CVSDIR'><filename>CVSDIR</filename></link>:</emphasis> | 358 | <listitem><para><emphasis><link linkend='var-bb-CVSDIR'><filename>CVSDIR</filename></link>:</emphasis> |
359 | Specifies where a temporary checkout is saved. | 359 | Specifies where a temporary checkout is saved. |
360 | The location is often <filename>DL_DIR/cvs</filename>. | 360 | The location is often <filename>DL_DIR/cvs</filename>. |
361 | </para></listitem> | 361 | </para></listitem> |
@@ -395,7 +395,7 @@ | |||
395 | <listitem><para><emphasis>"date":</emphasis> | 395 | <listitem><para><emphasis>"date":</emphasis> |
396 | Specifies a date. | 396 | Specifies a date. |
397 | If no "date" is specified, the | 397 | If no "date" is specified, the |
398 | <link linkend='var-SRCDATE'><filename>SRCDATE</filename></link> | 398 | <link linkend='var-bb-SRCDATE'><filename>SRCDATE</filename></link> |
399 | of the configuration is used to checkout a specific date. | 399 | of the configuration is used to checkout a specific date. |
400 | The special value of "now" causes the checkout to be | 400 | The special value of "now" causes the checkout to be |
401 | updated on every build. | 401 | updated on every build. |
@@ -406,7 +406,7 @@ | |||
406 | to which the module is unpacked. | 406 | to which the module is unpacked. |
407 | You are forcing the module into a special | 407 | You are forcing the module into a special |
408 | directory relative to | 408 | directory relative to |
409 | <link linkend='var-CVSDIR'><filename>CVSDIR</filename></link>. | 409 | <link linkend='var-bb-CVSDIR'><filename>CVSDIR</filename></link>. |
410 | </para></listitem> | 410 | </para></listitem> |
411 | <listitem><para><emphasis>"rsh"</emphasis> | 411 | <listitem><para><emphasis>"rsh"</emphasis> |
412 | Used in conjunction with the "method" parameter. | 412 | Used in conjunction with the "method" parameter. |
@@ -448,7 +448,7 @@ | |||
448 | <filename>FETCHCMD_svn</filename>, which defaults | 448 | <filename>FETCHCMD_svn</filename>, which defaults |
449 | to "svn". | 449 | to "svn". |
450 | The fetcher's temporary working directory is set by | 450 | The fetcher's temporary working directory is set by |
451 | <link linkend='var-SVNDIR'><filename>SVNDIR</filename></link>, | 451 | <link linkend='var-bb-SVNDIR'><filename>SVNDIR</filename></link>, |
452 | which is usually <filename>DL_DIR/svn</filename>. | 452 | which is usually <filename>DL_DIR/svn</filename>. |
453 | </para> | 453 | </para> |
454 | 454 | ||
@@ -509,7 +509,7 @@ | |||
509 | source control system. | 509 | source control system. |
510 | The fetcher works by creating a bare clone of the | 510 | The fetcher works by creating a bare clone of the |
511 | remote into | 511 | remote into |
512 | <link linkend='var-GITDIR'><filename>GITDIR</filename></link>, | 512 | <link linkend='var-bb-GITDIR'><filename>GITDIR</filename></link>, |
513 | which is usually <filename>DL_DIR/git2</filename>. | 513 | which is usually <filename>DL_DIR/git2</filename>. |
514 | This bare clone is then cloned into the work directory during the | 514 | This bare clone is then cloned into the work directory during the |
515 | unpack stage when a specific tree is checked out. | 515 | unpack stage when a specific tree is checked out. |
@@ -612,7 +612,7 @@ | |||
612 | This fetcher submodule inherits from the | 612 | This fetcher submodule inherits from the |
613 | <link linkend='git-fetcher'>Git fetcher</link> and extends | 613 | <link linkend='git-fetcher'>Git fetcher</link> and extends |
614 | that fetcher's behavior by fetching a repository's submodules. | 614 | that fetcher's behavior by fetching a repository's submodules. |
615 | <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link> | 615 | <link linkend='var-bb-SRC_URI'><filename>SRC_URI</filename></link> |
616 | is passed to the Git fetcher as described in the | 616 | is passed to the Git fetcher as described in the |
617 | "<link linkend='git-fetcher'>Git Fetcher (<filename>git://</filename>)</link>" | 617 | "<link linkend='git-fetcher'>Git Fetcher (<filename>git://</filename>)</link>" |
618 | section. | 618 | section. |
@@ -647,9 +647,9 @@ | |||
647 | 647 | ||
648 | <para> | 648 | <para> |
649 | To use this fetcher, make sure your recipe has proper | 649 | To use this fetcher, make sure your recipe has proper |
650 | <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>, | 650 | <link linkend='var-bb-SRC_URI'><filename>SRC_URI</filename></link>, |
651 | <link linkend='var-SRCREV'><filename>SRCREV</filename></link>, and | 651 | <link linkend='var-bb-SRCREV'><filename>SRCREV</filename></link>, and |
652 | <link linkend='var-PV'><filename>PV</filename></link> settings. | 652 | <link linkend='var-bb-PV'><filename>PV</filename></link> settings. |
653 | Here is an example: | 653 | Here is an example: |
654 | <literallayout class='monospaced'> | 654 | <literallayout class='monospaced'> |
655 | SRC_URI = "ccrc://cc.example.org/ccrc;vob=/example_vob;module=/example_module" | 655 | SRC_URI = "ccrc://cc.example.org/ccrc;vob=/example_vob;module=/example_module" |
@@ -734,15 +734,15 @@ | |||
734 | <filename>FETCHCMD_p4</filename>, which defaults | 734 | <filename>FETCHCMD_p4</filename>, which defaults |
735 | to "p4". | 735 | to "p4". |
736 | The fetcher's temporary working directory is set by | 736 | The fetcher's temporary working directory is set by |
737 | <link linkend='var-P4DIR'><filename>P4DIR</filename></link>, | 737 | <link linkend='var-bb-P4DIR'><filename>P4DIR</filename></link>, |
738 | which defaults to "DL_DIR/p4". | 738 | which defaults to "DL_DIR/p4". |
739 | </para> | 739 | </para> |
740 | 740 | ||
741 | <para> | 741 | <para> |
742 | To use this fetcher, make sure your recipe has proper | 742 | To use this fetcher, make sure your recipe has proper |
743 | <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>, | 743 | <link linkend='var-bb-SRC_URI'><filename>SRC_URI</filename></link>, |
744 | <link linkend='var-SRCREV'><filename>SRCREV</filename></link>, and | 744 | <link linkend='var-bb-SRCREV'><filename>SRCREV</filename></link>, and |
745 | <link linkend='var-PV'><filename>PV</filename></link> values. | 745 | <link linkend='var-bb-PV'><filename>PV</filename></link> values. |
746 | The p4 executable is able to use the config file defined by your | 746 | The p4 executable is able to use the config file defined by your |
747 | system's <filename>P4CONFIG</filename> environment variable in | 747 | system's <filename>P4CONFIG</filename> environment variable in |
748 | order to define the Perforce server URL and port, username, and | 748 | order to define the Perforce server URL and port, username, and |
@@ -793,9 +793,9 @@ | |||
793 | <filename>google-repo</filename> source control system. | 793 | <filename>google-repo</filename> source control system. |
794 | The fetcher works by initiating and syncing sources of the | 794 | The fetcher works by initiating and syncing sources of the |
795 | repository into | 795 | repository into |
796 | <link linkend='var-REPODIR'><filename>REPODIR</filename></link>, | 796 | <link linkend='var-bb-REPODIR'><filename>REPODIR</filename></link>, |
797 | which is usually | 797 | which is usually |
798 | <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link><filename>/repo</filename>. | 798 | <link linkend='var-bb-DL_DIR'><filename>DL_DIR</filename></link><filename>/repo</filename>. |
799 | </para> | 799 | </para> |
800 | 800 | ||
801 | <para> | 801 | <para> |