diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2015-06-16 16:18:58 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2015-07-28 18:02:32 +0100 |
commit | cb19478b0bd5efc58042bce20150d0ec095b0933 (patch) | |
tree | 7040404798d8e1dd93521337877976e8cbff1e0a | |
parent | ab23dd967e5a59de3cffe48762b4956edba5d478 (diff) | |
download | poky-cb19478b0bd5efc58042bce20150d0ec095b0933.tar.gz |
ref-manual: Added glossary description for BB_ALLOWED_NETWORKS.
Added a new description.
(From yocto-docs rev: e17fe8da8a9d2cbca54dd45451b35103d7d89fa0)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r-- | documentation/ref-manual/ref-variables.xml | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index d950a88211..88539ae5ec 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml | |||
@@ -646,6 +646,59 @@ | |||
646 | </glossdef> | 646 | </glossdef> |
647 | </glossentry> | 647 | </glossentry> |
648 | 648 | ||
649 | <glossentry id='var-BB_ALLOWED_NETWORKS'><glossterm>BB_ALLOWED_NETWORKS</glossterm> | ||
650 | <info> | ||
651 | BB_ALLOWED_NETWORKS[doc] = "A list of hosts that the fetcher is allowed to use to obtain the required source code." | ||
652 | </info> | ||
653 | <glossdef> | ||
654 | <para> | ||
655 | Specifies a space-delimited list of hosts that the fetcher | ||
656 | is allowed to use to obtain the required source code. | ||
657 | Following are considerations surrounding this variable: | ||
658 | <itemizedlist> | ||
659 | <listitem><para> | ||
660 | This host list is only used if | ||
661 | <filename>BB_NO_NETWORK</filename> is either not | ||
662 | set or set to "0". | ||
663 | </para></listitem> | ||
664 | <listitem><para> | ||
665 | Limited support for wildcard matching against the | ||
666 | beginning of host names exists. | ||
667 | For example, the following setting matches | ||
668 | <filename>git.gnu.org</filename>, | ||
669 | <filename>ftp.gnu.org</filename>, and | ||
670 | <filename>foo.git.gnu.org</filename>. | ||
671 | <literallayout class='monospaced'> | ||
672 | BB_ALLOWED_NETWORKS = "*.gnu.org" | ||
673 | </literallayout> | ||
674 | </para></listitem> | ||
675 | <listitem><para> | ||
676 | Mirrors not in the host list are skipped and | ||
677 | logged in debug. | ||
678 | </para></listitem> | ||
679 | <listitem><para> | ||
680 | Attempts to access networks not in the host list | ||
681 | cause a failure. | ||
682 | </para></listitem> | ||
683 | </itemizedlist> | ||
684 | Using <filename>BB_ALLOWED_NETWORKS</filename> in | ||
685 | conjunction with | ||
686 | <link linkend='var-PREMIRRORS'><filename>PREMIRRORS</filename></link> | ||
687 | is very useful. | ||
688 | Adding the host you want to use to | ||
689 | <filename>PREMIRRORS</filename> results in the source code | ||
690 | being fetched from an allowed location and avoids raising | ||
691 | an error when a host that is not allowed is in a | ||
692 | <link linkend='var-SRC_URI'><filename>SRC_URI</filename></link> | ||
693 | statement. | ||
694 | This is because the fetcher does not attempt to use the | ||
695 | host listed in <filename>SRC_URI</filename> after a | ||
696 | successful fetch from the | ||
697 | <filename>PREMIRRORS</filename> occurs. | ||
698 | </para> | ||
699 | </glossdef> | ||
700 | </glossentry> | ||
701 | |||
649 | <glossentry id='var-BB_DANGLINGAPPENDS_WARNONLY'><glossterm>BB_DANGLINGAPPENDS_WARNONLY</glossterm> | 702 | <glossentry id='var-BB_DANGLINGAPPENDS_WARNONLY'><glossterm>BB_DANGLINGAPPENDS_WARNONLY</glossterm> |
650 | <info> | 703 | <info> |
651 | BB_DANGLINGAPPENDS_WARNONLY[doc] = "Defines how BitBake handles situations where an append file (.bbappend) has no corresponding recipe file (.bb)." | 704 | BB_DANGLINGAPPENDS_WARNONLY[doc] = "Defines how BitBake handles situations where an append file (.bbappend) has no corresponding recipe file (.bb)." |