Bug 9313

Summary: Proxy documentation incorrect
Product: [Documentation] Reference Reporter: Paul Eggleton <bluelightning>
Component: handbookAssignee: Scott Rifenbark <srifenbark>
Status: VERIFIED FIXED QA Contact: Valentin Hangan <valentinx.hangan>
Severity: normal    
Priority: High CC: bluelightning, henry.bruce, poky.doc.watcher, poky.watcher, ross.burton, srifenbark, valentinx.hangan
Version: unspecified   
Target Milestone: 2.1 M4   
Hardware: All   
OS: Multiple   
Whiteboard: 01 April 2016: IN PROGRESS REVIEW
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: Yes (doc changes required)

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.