DragonFly On-Line Manual Pages
CSOCKS(1) DragonFly General Commands Manual CSOCKS(1)
NAME
csocks - Script that LD_PRELOAD a socks v4/v5 library for socksify
applications
SYNOPSYS
csocks [BinaryApplication]
DESCRIPTION
csocks
Csocks (csocks is abbreviation for "Client Socks") is a Unix/Posix
Socks4/5 client that supports many features. SOCKS is an Internet
protocol that allows client-server applications to transparently use
the services of a network firewall. SOCKS is an abbreviation for
"SOCKetS". Clients behind a firewall, needing to access exterior
servers, may connect to a SOCKS proxy server instead. Such proxy server
controls the eligibility of the client to access the external server
and passes the request on to the server. SOCKS can also be used in the
opposite way, allowing the clients outside the firewall ("exterior
clients") to connect to servers inside the firewall (internal servers).
Coscks is not a binary program, csocks is a simple shared library that
"maskerades" the socket system calls used by the programs which you
want socksify. The force of csocks is the stability, the optimization
speed and the affidability (for example csocks socksify fine Firefox
and applet Java..) compared with other famouse socks client like DANTE
socks client, RUNSOCKS socks client, TSOCKS socks client. Moreover
CSOCKS work fine with a big number of applications that i tested it,
like Mozilla Firefox, Java, Javascript, Safari etc. Csocks is easy to
use and soon will support a new security features implemented with ss5
(See http://ss5.sourceforge.net). You can configure the user-name and
password for socks5 connections (see ENVIRONMENT). The features
implemented are:
SOCKS4 (all functions): CONNECT, BIND
SOCKS5 : CONNECT, BIND, UDP ASSOCIATE, USER AUTHENTICATION
ENVIRONMENT
In the "csocks.conf" configuration file you can indicate the username
(socks4 and 5) and password (only socks5) used globally. In alternative
you can set CSOCKS_USER and CSOCKS_PASSWD environment (in this case the
global declarations in csocks.conf are ignored).
EXAMPLE
CSOCKS is easy to use: if you want to socksify your favorite
application (f.e. ssh), simple you must write the command:
csocks ssh 152.33.28.56
Starting from version 1.5 csocks support IPv6 rules (sperimental) and
socksify IPv6 connections
csocks ssh fe80::242:3hff:fe54:e7e6%bge0
Before this, you must configure the CSOCKS configuration file (usually
is /usr/local/etc/csocks.conf in FreeBSD and /etc/csocks.conf in
Linux). See manpage csocks.conf (5)
EXIT STATUS
0 If status is done negative other
CONFORMING TO
RFC1928 - RFC1929 - RFC1961
NOTE
The SOCKS5/GSSAPI aren't implemented in the current version.
COPYRIGHT
Raffaele De Lorenzo (raffaele.delorenzo@libero.it)
(http://csocks.altervista.org)
SEE ALSO
csocks.conf(5)
Version 1.5 - January 5 2008 CSOCKS(1)