odyssey/INTERNALS.md

957 B

Odissey architecture and internals

Odissey heavily depends on two libraries, which were originally created during its development: Machinarium and Shapito.

Machinarium

Machinarium extensively used for organization of multi-thread processing and networking IO. All Odissey threads are run in context of machinarium machines - pthreads with coroutine schedulers placed on top of epoll(2).

Odissey does not directly use or create multi-tasking primitives such as mutexes. All synchronization is done using message passing and transparently implemented by machinarium.

Repository: github/machinarium

Shapito

Shapito provides resizable buffers (streams) and methods for constructing, reading and validating PostgreSQL protocol requests. All PostgreSQL specific details should be provided by Shapito library.

Repository: github/shapito.