documentation enhancements on ssh usage

hello polipo developers,

i'd like to suggest a minor but imo useful enhancements for the
documentation:


the documentation on http and socks proxies lists examples, especially
on ssh usage, which is i appreciate for practicality, but doesn't take
into consideration recent features of ssh.

currently, the http example describes using ssh to secure a connection
to a proxy running on the very machine the ssh connection is established
to. the current socks example focuses on tor, claiming it to be the
"main application" of socks forwarding.

openssh since 4.3 supports socks proxying by itself, so an additional
section under the tor example in doc/SOCKS-parent-proxies.html could
look like this:

----------

SOCKS can also be used directly in connection with SSH. Requests will be
tunnelled through SSH and further originate from the SSH server:

$ ssh -f -N -C -D 1080 login.myuniversity.edu
$ polipo socksParentProxy=localhost:1080

----------

as this obsoletes the use of two chained polipo instances in the html
page, i suggest that the http example in doc/HTTP-parent-proxies.html be
changed to this:

----------

$ ssh -f -N -C -L 8124:gateway.myuniversity.edu:8080 login.myuniversity.edu
$ polipo parentProxy=localhost:8124

If it is sufficient to just cross the firewall with the SSH connection,
an HTTP parent proxy is not required, as SSH can also [act as a SOCKS
proxy by itself](link to socks page).

----------

i think these modifications would make the documentation reflect
realistic cases better, keep people from setting up unnecessarily
complex systems and generally be more useful.


please keep me in cc in responses, as i'm not subscribed to the
polipo-users list.

regards
chrysn

-- 
To use raw power is to make yourself infinitely vulnerable to greater powers.
  -- Bene Gesserit axiom

------------------------------------------------------------------------------
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/

_______________________________________________
Polipo-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/polipo-users

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)

iQIcBAEBAgAGBQJPuYpKAAoJEDmNERLTpL3h2/8QANK/3pok7OpFXIk0epmS/Fra
UZCiManH1EWEvL1sYUjd9IPXeSOvo4o9rULtsrS1Q7iGdZFC2g9vam5v6SaRfR1V
L4WH7861HOVtAU9dGoCImjQlyaHWw1Xtqt6eGfSWaYht9sFBsDTlLUaN+3NIa84Y
cNfD/FIHhr8Dn1z9+5JiGI8IgqVX/SSb6h9qyzCQo43ef5KBSAehu9P3b+PJTpcr
1VxL0h8MdyV95iRiW/qmZZFrl5/Te6fdeZzs2YsG68X6eXuNPDwqD/PN2LCGJxi6
nY1AcvwDIXlCo6fSDSF1GOlI670XOMqnY2+Rtbn7rA/n9jfnezlsUG5iCF8tuXpD
mTHXI5zzPg4FOLJc8ib/uH3QxoXzLAe3gh6j58qb6zC2YOZsEBOPRm5DwOuI7hiv
rsHKFXYoZOIeA7VwfKwbPTmxqeqoC2zwaiWckIw6QvvifC7OjX0CVDGluVrJYsP4
3q3HOVKLcH/5mpfhXwyuJl2ETG0IRONNxXP2Au8NsGQwRsE6XS0V3nvKXNpeXK3o
5reuEEuEmPJ0lNfqFKOW08znIQbZN8FyEOzMD6Pj1/wFL2lKo7qi3UhCVEuPCKTv
/hdu63MC5NGaDYGN+j94YxWjQ0XQqjVjtTIFiPClLO9gMjZavvVdWWjLwnklR1LB
+wUZMPfR5tyo6sC8ls+O
=o4Ve
-----END PGP SIGNATURE-----