Bug 8637

Hi, 

I don't update the wiki so we need someone to do that.  I could update it if needed but I don't understand what changes specifically need to be made.  I would need help from someone relating the information from Liam into the actual wiki page.  

In the ref-manual, there are two FAQ entries that deal with proxy: 14.12 and 14.22.  You can see these in the FAQ section (http://www.yoctoproject.org/docs/2.1/ref-manual/ref-manual.html#faq)

Regarding 14.12, it says:

  Most source fetching by the OpenEmbedded build system is done by wget 
  and you therefore need to specify the proxy settings in a .wgetrc file 
  in your home directory. Here are some example settings:

     http_proxy = http://proxy.yoyodyne.com:18023/
     ftp_proxy = http://proxy.yoyodyne.com:18023/
                
  The Yocto Project also includes a site.conf.sample file that shows how to 
  configure CVS and Git proxy servers if needed. 

Would we just replace the two example settings with:

  export SOCKS_SERVER=`server:port`
  unset http_proxy
  unset https_proxy
  unset ftp_proxy

Regarding FAQ 14.22.  It looks to me like that would not change?  Again, I am no expert on this stuff so I need some guidance.  

These are the only two areas in the YP doc set I believe would be impacted for this issue.  Comments?

Thanks,
Scott

No, we should not just replace the example.  These are two different types of proxies.

We should leave what is there but add another topic about the socks type of proxy.

Perhaps something like:

  Most source fetching by the OpenEmbedded build system is done by wget 
  and you therefore need to specify the proxy settings in a .wgetrc file 
  in your home directory. Below are some example settings for different
  proxy types.

  Http/FTP proxy:
     http_proxy = http://proxy.yoyodyne.com:18023/
     ftp_proxy = http://proxy.yoyodyne.com:18023/

  socks proxy:
     export SOCKS_SERVER=`server:port`
     unset http_proxy
     unset https_proxy
     unset ftp_proxy
                
  The Yocto Project also includes a site.conf.sample file that shows how to 
  configure CVS and Git proxy servers if needed. 

===============

Should the site.conf.sample be updated as well?

Scott, is this enough information to unblock your work on the bug?

Thanks, 

I will see where I can work that into the docs... I could add a new FAQ entry specifically to address it.  I will send a review link when I get something in.

Scott

Liam,

After looking more closely at your suggestion, I see that you meant to add another example to the existing 14.12 FAQ entry.  Take a look at 14.12 in http://www.yoctoproject.org/docs/temp/ref-manual/ref-manual.html#faq and let me know.  It is basically verbatim to what you suggested.  I did assume that the line:

export SOCKS_SERVER=`server:port`

should have "server" and "port" as user-input values so you will see that they are both formatted in italics, which indicate real values must be provided.

Let me know if this works.

Thanks,
Scott

Hello Scott,

This looks good with one caviate:

/etc/wgetrc has an entry that is not in the wiki for HTTPS.  I noticed this since the socks example has an unset for https_proxy

See below (from /etc/wgetrc):

# 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/


I think this should be added to the non-socks configuration example.

Liam, 

Ok - I have added that to the example.  You can see it at http://www.yoctoproject.org/docs/temp/ref-manual/ref-manual.html#faq for 4.12.  I will mark this as RESOLVED now and set the doc flag to "done."  

Thanks for you help!

Scott

Verified on http://www.yoctoproject.org/docs/temp/ref-manual/ref-manual.html#idm45853935249216