Movatterモバイル変換

dest-unreach /socat

socat - Multipurpose relay

Abstract

what: "netcat++" (extended design, new implementation)OS:   AIX, BSD, Linux, Solaris e.a. (UNIX)lic:GPL2inst: tar x...; ./configure; make; make installdoc:  README; socat.html, socat.1ui:   command lineexa:  socat TCP6-LISTEN:8080,reuseaddr,fork PROXY:proxy:www.domain.com:80keyw: tcp, udp, ipv6, raw ip, unix-socket, pty, pipe, listen, socks4, socks5,      proxy-connect, ssl-client, ssl-server, filedescriptor, readline, stdio,      exec, system, file, open, tail -f, termios, setsockopt, chroot,      fork, perm, owner, trace, dump, dgram, ext3, resolver, datagram,      multicast, broadcast, interface, socket, udplite, dccp, sctp, generic, ioctl

What's new?

Recent Releases

2025-02-21: Socatversion 1.8.0.3 has been released. It fixes a lot of minor issues and provides some minor improvements, see fileCHANGES. The experimental POSIXMQ feature has been improved, got a few new options, and is now considered stable.

2024-12-11: Socatversion 1.8.0.2 has been released. It fixes an arbitrary file overwrite vulnerability inreadline.sh (Socat security advisory 9, CVE-2024-54661)

2024-08-24: Socatversion 1.8.0.1 has been released. It fixes a couple of regressions in version 1.8.0.0 (see below), and a few other minor issues, see fileCHANGES

Failures report for 1.8.0.0

A group of failures in Socat version 1.8.0.0 have been reported for commands that worked fine in previous versions (regression). They affect addresses using IP protocols without explicit IP version, with options bind and/or range.Examples are TCP-LISTEN, UDP, UDP-RECV, OPENSSL.The error messages are:

• Use Socat up to version 1.7.4.4 (or 1.7.4.5 from git)
• Apply option -4 (does not help in some cases)
• Use explicit IP version in address key word like TCP4-LISTEN, UDP4 etc;
• Add address option pf=ip4 (esp.with OPENSSL)

2023-11-13: Socatversion 1.8.0.0 has been released. It adds a couple of new features:

• Support fornetwork namespaces (option netns)
• TCP client now automaticallytries all addresses (IPv4 and IPv6) provided by nameserver until success
• Implementation ofPOSIX message queue (mq) control and access on Linux (addresses POSIXMQ-READ and following)
• New wrapper scriptsocat-chain.sh allows tostack two addresses, e.g.HTTP proxy connect over SSL
• New scriptsocat-mux.sh allowsn-to-1 / 1-to-n communications
• New scriptsocat-broker.sh allowsgroup communications
• Experimentalsocks5 client feature
• AddressACCEPT-FD forsystemd "inetd" mode
• UDP-Lite andDCCP address types
• AddressesSOCKETPAIR andSHELL
• Newoption bind-tmpname allows forked off children tobind UNIX domain client sockets to randomunique pathes
• Newoption retrieve-vlan (with INTERFACE addresses) now makes kernelkeep VLAN tags in incoming packets
• Simplestatistics output withSocat option --statistics and with SIGUSR1
• A couple of new options, many fixes and corrections, see fileCHANGES

• Socat now installs assocat1, and a symlinksocat points to it, same with man page
• test.sh now provides option "--expect-fail 123,216" to gain rc=0 even with some failures

History

2022-10-30: Socatversion 1.7.4.4 is another bug fix release. It fixes UDP-RECVFROM failures and a couple of other bugs.

2022-01-08: Socatversion 1.7.4.3 fixes the TCP_INFO issue that broke building on non-Linux platforms. Furthermore, building on AIX works again. A few more corrections and improvements have been added.

2021-10-31: Socatversion 1.7.4.2 fixes a lot of bugs, e.g., for options -r and -R.

2021-01-10: Socatversion 1.7.4.1 fixes compilation on 32 bit systems and file transfer with OpenSSL.

2021-01-04: Socatversion 1.7.4.0 fixes a couple of bugs including a very theoretical security issue, restauration of DTLS using UDP, some porting issues, and last but not least several new features: VSOCK support, OpenSSL SNI, raw data dump, and more. See fileCHANGES andRelease Notes.
Thanks to all contributors for their invaluable patches!

Get it!

You can downloadsocat 1.8.0.0 in source form(.gz,.bz2).Feel free to check themd5 orsha256 hashes.

Git repository isgit://repo.or.cz/socat.git
(Project page ishttps://repo.or.cz/socat.git)

Documentation

Classical documentation:

• README file
• socat man page in HTML format.
• examples section of the man page

Mini tutorials:

• Securing traffic between two socat instances using SSL
• IP multicasting with socat
• Building TUN based virtual networks with socat
• socat-gender.txt contains a simple TCP`gender changer´ example.
• Generic sockets with socat

Contact