General remarks

Please tend to always use the latest version.

The existing API should always be backwards compatible between minor releases (e.g., 2.4.0 -> 2.5.1) unless explicitly mentioned in the changelog below (e.g., dropping Java 7 support in 2.5.0)

When upgrading from versions older than 2.4.0, please note that junixsocket-core is now a POM-only artifact (<type>pom</type>); see Add junixsocket to your project for details.

(2022-10-26) junixsocket 2.6.1

• Add AFSocket.checkConnectionClosed to probe connection status
• Fix connection status checks and error handling
• Fix bind behavior on Windows, support re-bind with reuseAddress
• Fix and improve unit tests/selftests, remove several false-positive errors found in the wild (Azure Cloudshell/Microsoft CBL-Mariner 2.0, Amazon EC2, OpenBSD, etc.)
• Fix SimpleTestServer demo, actually counting now to 5, not 6.
• Make builds reproducible, align timestamps with git commit

(2022-10-14) junixsocket 2.6.0

• Add support for GraalVM native-image
• Add support for native-image selftest
• Add support for AF_VSOCK (on Linux, and some macOS VMs)
• Reintroduce deprecated legacy constructors for AFUNIXSocketAddress that were removed in 2.5.0.
• Parent POM has been renamed from junixsocket-parent to junixsocket

(2022-10-06) junixsocket 2.5.2

• Fix address handling in the Abstract Namespace
• Fix support for very large datagrams (> 1MB)
• Fix InetAddress-wrapping of long addresses
• Update Xcode support script, crossclang
• Bump postgresql version in demo code
• Fix dependency for custom architecture artifact

(2022-07-01) junixsocket 2.5.1

• Add support for IBM z/OS (experimental, binary not included)
• Add support for building from source on arm64-Linux
• Add junixsocket support for jetty via junixsocket-jetty
• Fix Selector logic (more bug fixes)
• Documentation updates

(2022-06-06) junixsocket 2.5.0

• New supported platforms: AIX 7 Power64, IBM i Power64, Windows ARM64, Windows Server 2019 & 2022
• Generic rework to support more than just Unix Domain sockets
• Add support for AF_TIPC (on Linux)
• Add support for using sockets passed as standard input
• Add support for address-specific, non-standard URIs (for example unix:// and tipc://), as well as socat addresses
• Add support for using FileDescriptor for ProcessBuilder Redirects (Java 9+)
• Add support for peer credentials (PID) on Windows
• Fix Selector logic
• Fix cross-compilation on Apple Silicon
• Fix a file descriptor leak (regression in 2.4.0)
• Improve behavior on partially unsupported platforms and allow loading of Windows 10 native library on other Windows versions (e.g., Windows Server 2022, Windows 8.1).
• Javadoc improvements, Code cleanup
• Deprecate AFUNIXSocketCapability in favor of AFSocketCapability
• Drop support for Java 7

Backwards-incompatible change: new AFUNIXSocketAddress(File) constructor has been dropped; use 2.6.0 or newer if you can't change the source code.

(2021-07-30) junixsocket 2.4.0

• New supported platforms: NetBSD, OpenBSD, DragonFlyBSD (AMD64-builds included by default)
• Add support for Datagram sockets
• Add support for non-blocking I/O, Java NIO SocketChannel, DatagramChannel, ByteBuffer, Selector, Pipe, etc.
• Add support for socketpair (with IP-based emulation on Windows)
• Add support for casting FileDescriptors to Socket, etc.
• Add support for Peer Credentials on Solaris/Illumos
• Improved creation and reuse of AFUNIXSocketAddress instances
• Add basic support to wrap an AFUNIXSocketAddress as an InetAddress
• Add fast-path for single-byte read/write
• Significant internal code refactoring and cleanup (both Java and native C code)
• AFUNIXRegistry lookup can now take a timeout parameter (to coordinate between starting processes)
• Replaced the “finalize” logic with a custom Cleaner for Java 9 and above
• Fixed compatibility issue with OkHttpClient, add demo code
• Fixed a race condition when connecting to a registry that's just starting up.
• More test cases, increased unit test code coverage
• Simplified local compilation on non-macOS/Linux systems.
• Improved selftest
• Maven Dependency: junixsocket-core is now a POM-only artifact (<type>pom</type>).

(2021-05-30) junixsocket 2.3.4

• Fix bind/stat on glibc-based Linux on aarch64 and RISC-V (regression from 2.3.2)

(2021-04-15) junixsocket 2.3.3

• Add support for aarch64 on Apple Silicon Macs
• Improved throughput by up to 40% by removing some JNI overhead (now on par with JEP380)
• Fix “undefined symbol: stat” error on older Linux machines
• Fix self-test on Windows; add more system information to selftest
• Fix LICENSE/NOTICE files (no license change, just reorganization)
• Fix build issues with RISC-V (use LLVM 9)
• Fix build issues on macOS
• Improve handling of ancillary receive buffers
• Add a new system property to control what happens when the library override fails to load
• Add an Xcode project to simplify cross-compilation; improved crossclang

(2020-03-08) junixsocket 2.3.2

• Add support for FreeBSD (Intel 64-bit)
• Fix an NPE when junixsocket is on the bootstrap classloader
• Fix AcceptTimeoutTest#testCatchTimeout (selftest would sometimes erroneously fail)

(2020-01-16) junixsocket 2.3.1

• Add support for Java 15
• Increase minimum version requirement for macOS to 10.9 to comply with notarization requirements
• Improved error reporting upon trying to connect an already closed socket
• Improved error reporting when a compiler binary is missing for cross-compilation

(2019-12-26) junixsocket 2.3.0

• Add support for Java 14
• Add support for Java 7 (core/server package only)
• Add support for ppc64le (POWER) Linux
• Add support for RISC-V 64-bit Linux
• Add support for s390x Linux
• Add support for Solaris x86/OpenIndiana (Intel 64-bit)
• Add support to send FileDescriptors (FileInputStream, FileOutputStream) via RMI
• Add support to retrieve peer credentials for RMI connections
• Add new self-test functionality to verify that junixsocket works on a given platform
• New demo code: HTTP Server over Unix sockets (using NanoHTTPD)
• macOS: Use poll for read; fix read timeout not being honored
• musl-libc: Workaround for segmentation fault in CMSG_NXTHDR (ancillary messages).
• Several other bug fixes and improvements

(2019-11-14) junixsocket 2.2.1

• Add support for Java 13

(2019-02-17) junixsocket 2.2.0

• New supported platform: Linux ARM 32-bit and 64-bit (e.g., Raspberry Pi)
• New supported platform: Windows 10 AMD64
• Add support for receiving peer credentials
• Add support for sending and receiving file descriptors
• Add support for the abstract namespace on Linux and Windows
• Add AFUNIXSocketServer, a multi-threaded UNIX domain server implementation
• Introduced AFUNIXSocketCapabilities to check which capabilities are supported on your platform
• AFUNIXServerSocket#setReuseAddress can now control whether reusing an existing socket is permitted
• Exception handling: No longer wrap SocketExceptions, throw SocketTimeoutException upon EAGAIN for read
• Improve handling of closed sockets
• Improved native library loader code, better error handling
• Improved handling of libc alternatives, such as musl (we now build two different libraries, one that's linked against glibc, and one that isn't)
• JNI: Fix some missing return-after-throw, use-after-free in bind
• Properly close file descriptors upon errors in native code; unlink before bind
• Ask to not raise SIGPIPE
• Introduced “crossclang”: junixsocket can now be cross-compiled with clang/LLVM
• Improved demo code, new demo client