dest-unreach / socat

socat - Multipurpose relay

Abstract

what: "netcat++" (extended design, new implementation)
OS:   AIX, BSD, Linux, Solaris e.a. (UNIX)
lic:  GPL2
inst: tar x...; ./configure; make; make install
doc:  README; socat.html, socat.1
ui:   command line
exa:  socat TCP6-LISTEN:8080,reuseaddr,fork PROXY:proxy:www.domain.com:80
keyw: tcp, udp, ipv6, raw ip, unix-socket, pty, pipe, listen, socks4, socks4a,
      proxy-connect, ssl-client, 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, sctp, generic, ioctl

What's new?

Recent Releases

2024-08-24: Socat version 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 file CHANGES

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:

These issues will be addressed by version 1.8.0.1, planned for August; possible workarounds are:

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

Notes to distribution maintainers and packagers:

History

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

2022-01-08: Socat version 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: Socat version 1.7.4.2 fixes a lot of bugs, e.g., for options -r and -R.

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

2021-01-04: Socat version 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 file CHANGES and Release Notes.
Thanks to all contributors for their invaluable patches!

Get it!

You can download socat 1.8.0.0 in source form (.gz, .bz2). Feel free to check the md5 or sha256 hashes.

Git repository is git://repo.or.cz/socat.git
(Project page is https://repo.or.cz/socat.git)

Documentation

Classical documentation:

Mini tutorials:

Contact

If you have more questions, please contact socat@dest-unreach.org