dev-manual: details about using firewalls and limiting fetch threads
PATCH 1/1 dev-manual: details about using firewalls and limiting fetch threads
Fixes [YOCTO #13235]
--- documentation/dev-manual/common-tasks.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+)
documentation/dev-manual/common-tasks.rst +18 -0
@@ -1481,6 +1481,24 @@ compressed suffixes such as ``diff.gz`` and ``patch.bz2``, for example. The build system automatically applies patches as described in the ":ref:`dev-manual/common-tasks:patching code`" section. +Fetching Code Through Firewalls +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Some users are behind firewalls and need to fetch code through a proxy. +See the ":doc:`/ref-manual/faq`" chapter for advice. + +Limiting the Number of Parallel Connections +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Some users are behind firewalls or use servers where the number of parallel connections +is limited. In such cases, you can limit the number of fetch tasks which run in parallel by +setting the below option in your ``local.conf`` file. + +The :yocto_git:`meta-poky/conf/local.conf.sample.extended </poky/tree/meta-poky/conf/local.conf.sample.extended>` +file shows how to set a maximum of four fetch tasks in parallel:: + + do_fetch[number_threads] = "4" + Unpacking Code --------------
Signature · 1 line
2.25.1
Hi Michael,
Quoted 21 lines · Michael Opdenacker via lists.yoctoproject.org
Fixes [YOCTO #13235]
Signed-off-by Michael Opdenacker <[email protected]>--- documentation/dev-manual/common-tasks.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+)documentation/dev-manual/common-tasks.rst +6
-0@@ -1481,6 +1481,24 @@ compressed suffixes such as ``diff.gz`` and ``patch.bz2``, for example. The build system automatically applies patches as described in the ":ref:`dev-manual/common-tasks:patching code`" section. +Fetching Code Through Firewalls +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Some users are behind firewalls and need to fetch code through a proxy. +See the ":doc:`/ref-manual/faq`" chapter for advice. +
documentation/dev-manual/common-tasks.rst compressed suffixes such as ``diff.gz`` and ``patch.bz2``, for example. · line 1499
Quoted 10 lines
documentation/dev-manual/common-tasks.rst +10
-0+Limiting the Number of Parallel Connections +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Some users are behind firewalls or use servers where the number of parallel connections +is limited. In such cases, you can limit the number of fetch tasks which run in parallel by +setting the below option in your ``local.conf`` file. + +The :yocto_git:`meta-poky/conf/local.conf.sample.extended </poky/tree/meta-poky/conf/local.conf.sample.extended>` +file shows how to set a maximum of four fetch tasks in parallel:: +
Can suggest:
Some users are behind firewalls or use servers where the number of parallel connections is limited. In such cases, you can limit the number of fetch tasks being run in parallel by adding the following
to your ``local.conf`` file::
documentation/dev-manual/common-tasks.rst compressed suffixes such as ``diff.gz`` and ``patch.bz2``, for example. · line 1501
Quoted 2 lines
documentation/dev-manual/common-tasks.rst +2
-0+ do_fetch[number_threads] = "4" +
Basically, I don't like "the below option" followed by another sentence.
But I'm more concerned about pointing to a file whose content I'm sure we won't actively monitor. I'm not sure it's an important piece of information to know if a sample configuration file has such an example?
What do you think?
Cheers,
Quentin