diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 5ac8dbf737..893ef7ba07 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -6346,24 +6346,24 @@ (DL_DIR). You start with an empty downloads directory by either removing the files in the existing directory or by - setting DL_DIR to point to either - an empty location or one that does not yet exist. + setting + DL_DIR to point to either an + empty location or one that does not yet exist. - Create Your "own-mirror" From Your Downloads Directory: + Generate Tarballs of the Source Git Repositories: Edit your local.conf configuration file as follows: - SOURCE_MIRROR_URL ?= "file:///home/your-download-dir/" - INHERIT += "own-mirrors" + DL_DIR = "/home/your-download-dir/" BB_GENERATE_MIRROR_TARBALLS = "1" During the fetch process in the next step, BitBake - looks in your mirror for source files. - The + gathers the source files and creates tarballs in + the directory pointed to by DL_DIR. + See the BB_GENERATE_MIRROR_TARBALLS - variable causes the build process to create source - tarballs in the downloads directory. + variable for more information. Populate Your Downloads Directory Without Building: @@ -6372,9 +6372,10 @@ $ bitbake target --runonly=fetch - The downloads directory now has a "snapshot" of the - source files used for the build. - The directory also has the tarballs. + The downloads directory (i.e. + ${DL_DIR}) now has a "snapshot" of + the source files in the form of tarballs, which can + be used for the build. Optionally Remove Any Git or other SCM Subdirectories From the Downloads Directory: @@ -6389,7 +6390,8 @@ Once your downloads directory has everything it needs regarding - source files, you can build your target. + source files, you can create your "own-mirror" and build + your target. Understand that you can use the files to build the target offline from any machine and at any time. @@ -6400,12 +6402,22 @@ Using Local Files Only: - Add the + Inside your local.conf file, add + the + SOURCE_MIRROR_URL + variable, + inherit the own-mirrors + class, and use the BB_NO_NETWORK - variables to your local.conf. + variable to your local.conf. + SOURCE_MIRROR_URL ?= "file:///home/your-download-dir/" + INHERIT += "own-mirrors" BB_NO_NETWORK = "1" + The SOURCE_MIRROR_URL and + own-mirror class set up the system + to use the downloads directory as your "own mirror". Using the BB_NO_NETWORK variable makes sure that BitBake's fetching process in step 3 stays local, which means files from