summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2015-06-15 09:22:35 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2015-06-16 23:58:16 +0100
commit7a98387e29e3bb64971ac44655f6cf853d167d42 (patch)
tree53d67f97a7a7e24a0dcac0b7a3ea066fec0a664c
parent5efbaaf74b8f5ba7472f7e871fce2561bd67f571 (diff)
downloadpoky-7a98387e29e3bb64971ac44655f6cf853d167d42.tar.gz
bitbake: bitbake-user-manual-ref-variables.xml: Added BB_ALLOWED_NETWORKS desc.
Added a new variable description for the BB_ALLOWED_NETWORKS variable. (Bitbake rev: 1408654e6d8f5ae962744c6cc2d8a49df34c5101) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml50
1 files changed, 50 insertions, 0 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml
index 86bf30bb77..688edc92c2 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml
@@ -102,6 +102,56 @@
102 </glossdef> 102 </glossdef>
103 </glossentry> 103 </glossentry>
104 104
105 <glossentry id='var-BB_ALLOWED_NETWORKS'><glossterm>BB_ALLOWED_NETWORKS</glossterm>
106 <glossdef>
107 <para>
108 Specifies a space-delimited list of hosts that the fetcher
109 is allowed to use to obtain the required source code.
110 Following are considerations surrounding this variable:
111 <itemizedlist>
112 <listitem><para>
113 This host list is only used if
114 <link linkend='var-BB_NO_NETWORK'><filename>BB_NO_NETWORK</filename></link>
115 is either not set or set to "0".
116 </para></listitem>
117 <listitem><para>
118 Limited support for wildcard matching against the
119 beginning of host names exists.
120 For example, the following setting matches
121 <filename>git.gnu.org</filename>,
122 <filename>ftp.gnu.org</filename>, and
123 <filename>foo.git.gnu.org</filename>.
124 <literallayout class='monospaced'>
125 BB_ALLOWED_NETWORKS = "*.gnu.org"
126 </literallayout>
127 </para></listitem>
128 <listitem><para>
129 Mirrors not in the host list are skipped and
130 logged in debug.
131 </para></listitem>
132 <listitem><para>
133 Attempts to access networks not in the host list
134 cause a failure.
135 </para></listitem>
136 </itemizedlist>
137 Using <filename>BB_ALLOWED_NETWORKS</filename> in
138 conjunction with
139 <link linkend='var-PREMIRRORS'><filename>PREMIRRORS</filename></link>
140 is very useful.
141 Adding the host you want to use to
142 <filename>PREMIRRORS</filename> results in the source code
143 being fetched from an allowed location and avoids raising
144 an error when a host that is not allowed is in a
145 <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link>
146 statement.
147 This is because the fetcher does not attempt to use the
148 host listed in <filename>SRC_URI</filename> after a
149 successful fetch from the
150 <filename>PREMIRRORS</filename> occurs.
151 </para>
152 </glossdef>
153 </glossentry>
154
105 <glossentry id='var-BB_CONSOLELOG'><glossterm>BB_CONSOLELOG</glossterm> 155 <glossentry id='var-BB_CONSOLELOG'><glossterm>BB_CONSOLELOG</glossterm>
106 <glossdef> 156 <glossdef>
107 <para> 157 <para>