Margo is a C library that helps develop distributed services based on RPC and RDMA.
Margo provides Argobots-aware wrappers to Mercury functions. It simplifies service development by expressing Mercury operations as conventional blocking functions so that the caller does not need to manage progress loops or callback functions. Internally, Margo suspends callers after issuing a Mercury operation, and automatically resumes them when the operation completes. This allows other concurrent user-level threads to make progress while Mercury operations are in flight without consuming operating system threads. The goal of this design is to combine the performance advantages of Mercury’s native event-driven execution model with the progamming simplicity of a multi-threaded execution model.
This section will walk you through a series of tutorials on how to use Margo. We highly recommend to read all the tutorials before diving into the implementation of any Margo-based service, in order to understand how we envision designing such a service. This will also help you greatly in understanding other Margo-based services.
- Initializing Margo
- Simple Hello World RPC with Margo
- Sending arguments, returning values
- Transferring data over RDMA
- Non-blocking RPC
- Working in terms of providers
- Using Argobots pools with Margo RPCs
- Serializing complex data structures
- Using Margo’s JSON configuration
- Customizing Margo logging
- Working with Margo timers
- Profiling and monitoring
- API Documentation