aboutsummaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/faq.xml
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual/faq.xml')
-rw-r--r--documentation/ref-manual/faq.xml42
1 files changed, 26 insertions, 16 deletions
diff --git a/documentation/ref-manual/faq.xml b/documentation/ref-manual/faq.xml
index 3137639d9a..d2e4e8eb1b 100644
--- a/documentation/ref-manual/faq.xml
+++ b/documentation/ref-manual/faq.xml
@@ -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:
+ 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>
+
+ <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'>
- Http/FTP proxy:
- https_proxy = http://proxy.yoyodyne.com:18023/
- http_proxy = http://proxy.yoyodyne.com:18023/
- ftp_proxy = http://proxy.yoyodyne.com:18023/
-
- socks proxy:
- export SOCKS_SERVER=`<replaceable>server</replaceable>:<replaceable>port</replaceable>`
- unset http_proxy
- unset https_proxy
- unset ftp_proxy
+ # 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>