usocks/usocks.1



    1 .\"@ usocks - detour network traffic through SOCKS5 proxy.
    2 .\"
    3 .\" Public Domain
    4 .
    5 .Dd September 17, 2020
    6 .Dt USOCKS 1
    7 .Os
    8 .
    9 .
   10 .Sh NAME
   11 .Nm usocks
   12 .Nd detour network traffic through SOCKS5 proxy
   13 .
   14 .
   15 .Sh SYNOPSIS
   16 .Nm
   17 .Ar proxy-address
   18 .Ar proxy-port
   19 .Ar command
   20 .Op Pf : Ar argument Ns \&:
   21 .
   22 .
   23 .Sh DESCRIPTION
   24 .
   25 .Nm
   26 can be used to detour stream-based network traffic of
   27 .Ar command
   28 through the specified SOCKS5 proxy.
   29 This is realized by preloading a shared library which overwrites the
   30 .Xr connect 2
   31 system call.
   32 Because of this simple approach the SOCKS5 provided DNS (name) lookup
   33 mechanism is not used.
   34 .Ar proxy-address
   35 must be an IPv4 internet address (like
   36 .Ql 127.0.0.1 ) .
   37 For example
   38 .
   39 .Bd -literal -offset indent
   40 # Login as USER on HOST, create a local SOCKS proxy on port 10000
   41 $ ssh -D 10000 USER@HOST
   42 
   43 # Thereafter use usocks(1) to proxy any command over it
   44 $ usocks 127.0.0.1 10000 irssi
   45 .Ed
   46 .
   47 .\" s-ts-mode