See the Change Log for what has gone into each release.
How do I use Aeron?
- Java Programming Guide
- C++11 Programming Guide
- Best Practices Guide
- Monitoring and Debugging
- Configuration Options
- Channel Specific Configuration
- Client Concurrency Model
- Thread Utilisation
- Message Delivery Assurances
- Aeron Archive (Persistent Streams)
- Multiple Destination Publications & Subscriptions
How does Aeron work?
- Protocol Specification
- Design Overview
- Data Structures
- Design Principles
- Flow and Congestion Control
- Media Driver Operation
- C Media Driver Operation
How do I hack on Aeron?
Q: What does the name, Aeron, mean?
Q: Why? Isn't TCP enough for anyone?
A: There is a need for low latency transport protocols for capital markets use cases. TCP is not suitable for low latency due to the tradeoff between bandwidth usage after loss and responsiveness. In addition, modifying TCP congestion control to make a different tradeoff is fraught with peril. The API provided by TCP in the form of BSD sockets is not suited well to applications that require message boundaries to be preserved as is most non-file transfer use cases, which is, well, pretty much everything in a low latency environment. Also, TCP does not support reliable multicast communication. All these combine to make TCP a very very poor choice as a transport protocol for low latency applications.
Q: Isn't this a brokered architecture? Isn't that bad for latency?
A: Yes, it is a brokered architecture. However, it is unlike traditional brokered architectures in a number of ways. First, the driver only communicates via shared memory with clients. Secondly, the driver uses dedicated threads on lock-free & wait-free data structures for sending and receiving. Third, the use case primarily is one of those threads being pinned to dedicated CPUs to avoid cache pollution and scheduling jitter. And Fourth, the driver can be embedded into an application if desired. Fundamentally, the difference is that whether isolated by threads or processes, the application is separated from the protocol driver logic via core-to-core communication over lock-free & wait-free data structures.
Q: The protocol specification says that Little Endian is used for byte order of fields. Network order is always Big Endian. Why doesn't Aeron use Big Endian?
A: The primary latency sensitive systems in use today are Little Endian. Adding unnecessary byte reversal would be wasteful. Adding conditional checks for byte ordering to frames would be wasteful. If the need arises in the future, highly doubtful, to be conditionally Big Endian, then the Version field would be used to hold a Big Endian field bit flag.
Q: Why aren't streams identified with Strings instead of numbers?
A: This is pure efficiency. Handling of strings in some languages is prohibitively expensive. Aeron tries to be as efficient as possible and provide the basic functionality that more complex systems can be composed with. If desired, the application, or a library, could provide String to Stream ID lookup.
Q: When using the built in fragmentation support, is there a maximum limit to the message length?
A: Messages need to be contiguous when stored in the log/term buffers. Therefore message length must be less than the term length. We have chosen a limit of 1/8th the term buffer length for maximum message length. This is a compromise to limit fragmentation under concurrent publication. Messages larger than this should be chunked before publication to Aeron.
Q: Why only support for Java 8?
A: Some of the core algorithms for the log and broadcast buffers require access to the Fences API and the new Unsafe intrinsics for
getAndAdd()that are implemented as LOCK XADD on x86.
Q: How does release numbering work?
A: Aeron will follow a
<Major>.<Minor>.<Point>release numbering scheme, starting at
Major Release: Major API change that can possibly be breaking.
Minor Release: Significant new features that are API extending and preserving.
Point Release: Bugfixes and feature refinement.
Q: My build is failing, what can be wrong?
A: Early versions of Java 8 have bugs that can generate incorrect code. Please use the latest version of Java 8 with an absolute minimum of 1.8.0_65.