Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   16655 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

SSH-SOCKS5-PROXY-CONNECT(1)			   SSH-SOCKS5-PROXY-CONNECT(1)

NAME
       ssh-socks5-proxy-connect - Secure Shell proxy for SOCKS5

SYNOPSIS
       /usr/lib/ssh/ssh-socks5-proxy-connect
	    [-h socks5_proxy_host]
	    [-p socks5_proxy_port] connect_host connect_port

DESCRIPTION
       A  proxy command for ssh(1) that uses SOCKS5 (RFC 1928). Typical use is
       where connections external to a network are only allowed	 via  a	 socks
       gateway server.

       This  proxy  command  does not provide any of the SOCKS5 authentication
       mechanisms defined in RFC 1928. Only anonymous connections  are	possi‐
       ble.

OPTIONS
       The following options are supported:

       -h socks5_proxy_host
			       Specifies the proxy web server through which to
			       connect. Overrides the  SOCKS5_SERVER  environ‐
			       ment variable.

       -p socks5_proxy_port
			       Specifies  the  port  on	 which	the  proxy web
			       server runs.  If	 not  specified,  port	80  is
			       assumed.	 Overrides the SOCKS5_PORT environment
			       variable.

OPERANDS
       The following operands are supported:

       socks5_proxy_host
			    The host name or IP address (IPv4 or IPv6) of  the
			    proxy.

       socks5_proxy_port
			    The	  numeric   port   number  to  connect	to  on
			    socks5_proxy_host.

       connect_host
			    The name of the remote host	 to  which  the	 socks
			    gateway is to connect you.

       connect_port
			    The	 numeric  port	number of the socks gateway to
			    connect you to on connect_host.

EXAMPLES
       The recommended way to use a proxy connection command is	 to  configure
       the ProxyCommand in ssh_config(4) (see Example 1 and Example 2).	 Exam‐
       ple 3 shows how the proxy command can be specified on the command  line
       when running ssh(1).

       Example 1 Setting the proxy from the environment

       The  following  example	uses ssh-socks5-proxy-connect in ssh_config(4)
       when the proxy is set from the environment:

	 Host playtime.foo.com
	     ProxyCommand /usr/lib/ssh/ssh-socks5-proxy-connect \
		 playtime.foo.com 22

       Example 2 Overriding proxy environment variables

       The following example uses ssh-socks5-proxy-connect in ssh_config(4) to
       override (or if not set) proxy environment variables:

	 Host playtime.foo.com
	     ProxyCommand /usr/lib/ssh/ssh-socks5-proxy-connect -h socks-gw \
		 -p 1080 playtime.foo.com 22

       Example 3 Using the command line

       The  following  example	uses  ssh-socks5-proxy-connect from the ssh(1)
       command line:

	 example$ ssh -o'ProxyCommand=/usr/lib/ssh/ssh-socks5-proxy-connect \
	     -h socks-gw -p 1080 playtime.foo.com 22' playtime.foo.com

ENVIRONMENT VARIABLES
       SOCKS5_SERVER
			Takes socks5_proxy_host operand to specify the default
			proxy host.

       SOCKS5_PORT
			Takes	socks5_proxy_port    operand  to  specify  the
			default proxy port.

EXIT STATUS
       The following exit values are returned:

       0
	     Successful completion.

       1
	     An error occurred.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │Interface Stability │ Stable	      │
       └────────────────────┴─────────────────┘

SEE ALSO
       ssh(1), ssh-http-proxy-connect(1), ssh_config(4), attributes(5)

				 Oct 30, 2002	   SSH-SOCKS5-PROXY-CONNECT(1)

Vote for polarhome