Bug 9313 - Proxy documentation incorrect
Summary: Proxy documentation incorrect
Status: VERIFIED FIXED
Alias: None
Product: Reference
Classification: Documentation
Component: handbook (show other bugs)
Version: unspecified
Hardware: All Multiple
: High normal
Target Milestone: 2.1 M4
Assignee: Scott Rifenbark
QA Contact: Valentin Hangan
URL:
Whiteboard: 01 April 2016: IN PROGRESS REVIEW
Depends on:
Blocks:
 
Reported: 2016-03-21 02:00 UTC by Paul Eggleton
Modified: 2016-04-19 13:48 UTC (History)
7 users (show)

See Also:
OS type for building Yocto: ---
Type of Regression: ---
Verified:
Documentation change: Yes (doc changes required)


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Paul Eggleton 2016-03-21 02:00:44 UTC
Surprisingly our proxy documentation is still quite poor. The FAQ section of the ref manual talks about setting SOCKS_SERVER, but none of our current scripts actually read that.

We have provided scripts/oe-git-proxy for git proxying for a while now, so our documentation should describe how to use it. I have updated the following wiki page (which was also out-of-date) to cover it:

https://wiki.yoctoproject.org/wiki/Working_Behind_a_Network_Proxy
Comment 1 Scott Rifenbark 2016-03-22 18:19:40 UTC
Waiting for Henry's resolution to the wiki page on this... then I will adapt for the YP doc set.

Scott
Comment 2 Scott Rifenbark 2016-04-01 18:00:11 UTC
Hi, 

Here are some areas that have been updated.  Please look these changes over and comment.

 * http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#var-DL_DIR - I added a cross-reference to this variable description so the reader can get to the wiki page easily.

* I updated the FAQ entry that talks about being behind a firewall and things are not working, which is section 14.12 titled "I'm behind a firewall and need to use a proxy server. How do I do that?"  (see http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#i-am-behind-a-firewall-and-need-to-use-a-proxy-server).  Please look these changes over.  

* The only other real reference to working behind a firewall is another FAQ entry in section 14.22 titled "How does the OpenEmbedded build system obtain source code and will it work behind my firewall or proxy server?"  (see http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#how-does-the-yocto-project-obtain-source-code-and-will-it-work-behind-my-firewall-or-proxy-server).  I did not make changes to this section.  You might want to read it over.

Thanks, 
Scott
Comment 3 Ross Burton 2016-04-14 19:57:14 UTC
Merged in yocto-docs 056e6881951023e62a7363ba60fe73cd6d2932b6.
Comment 4 Valentin Hangan 2016-04-19 13:48:22 UTC
Verified links and proxy documentation is correct.