sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

ref-manual: Updated verbiage on proxy handling 

Fixes [YOCTO #9313]

Update the DL_DIR variable description to add a cross-reference
to the wiki page that talks about working behind a firewall.

Updated the 14.12 FAQ entry with new information about working
behind the firewall.

(From yocto-docs rev: 056e6881951023e62a7363ba60fe73cd6d2932b6)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2016-04-01 11:15:28 -07:00 committed by Richard Purdie
parent a1295ed80f
commit 763ae4e191
2 changed files with 29 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
documentation/ref-manual/faq.xml
View File

@ -280,7 +280,7 @@
<qandaentry>
<question>
<para>
<para id='i-am-behind-a-firewall-and-need-to-use-a-proxy-server'>
I'm behind a firewall and need to use a proxy server. How do I do that?
</para>
</question>
@ -288,24 +288,34 @@
<para>
Most source fetching by the OpenEmbedded build system is done
by <filename>wget</filename> and you therefore need to specify
the proxy settings in a <filename>.wgetrc</filename> file
in your home directory.
Following are some example settings for different proxy types:
<literallayout class='monospaced'>
Http/FTP proxy:
https_proxy = http://proxy.yoyodyne.com:18023/
http_proxy = http://proxy.yoyodyne.com:18023/
ftp_proxy = http://proxy.yoyodyne.com:18023/
the proxy settings in a <filename>.wgetrc</filename> file,
which can be in your home directory if you are a single user
or can be in <filename>/usr/local/etc/wgetrc</filename> as
a global user file.
</para>
socks proxy:
export SOCKS_SERVER=`<replaceable>server</replaceable>:<replaceable>port</replaceable>`
unset http_proxy
unset https_proxy
unset ftp_proxy
<para>
Following is the applicable code for setting various proxy
types in the <filename>.wgetrc</filename> file.
By default, these settings are disabled with comments.
To use them, remove the comments:
<literallayout class='monospaced'>
# You can set the default proxies for Wget to use for http, https, and ftp.
# They will override the value in the environment.
#https_proxy = http://proxy.yoyodyne.com:18023/
#http_proxy = http://proxy.yoyodyne.com:18023/
#ftp_proxy = http://proxy.yoyodyne.com:18023/
# If you do not want to use proxy at all, set this to off.
#use_proxy = on
</literallayout>
The Yocto Project also includes a
<filename>site.conf.sample</filename> file that shows how to
configure CVS and Git proxy servers if needed.
<filename>meta-poky/conf/site.conf.sample</filename> file that
shows how to configure CVS and Git proxy servers if needed.
For more information on setting up various proxy types and
configuring proxy servers, see the
"<ulink url='&YOCTO_WIKI_URL;/wiki/Working_Behind_a_Network_Proxy'>Working Behind a Network Proxy</ulink>"
Wiki page.
</para>
</answer>
</qandaentry>

3
documentation/ref-manual/ref-variables.xml
View File

@ -3415,6 +3415,9 @@
see this specific question in the
"<link linkend='how-does-the-yocto-project-obtain-source-code-and-will-it-work-behind-my-firewall-or-proxy-server'>FAQ</link>"
chapter.
You can also refer to the
"<ulink url='&YOCTO_WIKI_URL;/wiki/Working_Behind_a_Network_Proxy'>Working Behind a Network Proxy</ulink>"
Wiki page.
</para>
</glossdef>
</glossentry>