How darma-tasking/vt works
vt is a C++ active-messaging runtime for scientific applications, built on MPI. An application uses virtualized endpoints and messages; vt routes work independently of physical rank, manages distributed objects and collections, and can migrate work through automatic load balancing. The map includes communication, collectives, RDMA handles, and runtime coordination as major capabilities. Relationships are limited to README-documented behavior and sampled source references; several subsystems are represented by their exact enclosing directory because their implementation was not sampled.
Main entry points: active.h Active messaging · lb_manager.cc Load balancing · migrate Collection migration · manager.h Object groups
Components 19
Runtime foundation
- Execution context
src/vt/context/context.h - Runtime components
src/vt/runtime/component/component_pack.h - Task scheduler
src/vt/scheduler
Messaging and callbacks
- Active messaging
src/vt/messaging/active.h - Handler registry
src/vt/handler/handler.h - Callback pipes
src/vt/pipe
Virtual entities
- Object groups
src/vt/objgroup/manager.h - Virtual collections
src/vt/vrt/collection/manager.impl.h - Location management
src/vt/topos/location - Collection migration
src/vt/vrt/collection/migrate
Distributed coordination
- Collective operations
src/vt/collective - Distributed groups
src/vt/group/group_manager.cc - RDMA handles
src/vt/rdmahandle/manager.h - Phase tracking
src/vt/phase/phase_manager.cc
Load balancing
- Load balancing
src/vt/vrt/collection/balance/lb_invoke/lb_manager.cc - Load data
src/vt/vrt/collection/balance - Workload replay
tools/workload_replay/simulate_replay.cc
Other components
- Scientific application
- MPI runtime
Connections 17
- Scientific application → Active messaging: sends work
- MPI runtime → Active messaging: underlies transport
- Execution context → MPI runtime: uses rank context
src/vt/context/context.h - Runtime components → Execution context: coordinates runtime
src/vt/context/context.h - Active messaging → Handler registry: dispatches handlers
- Active messaging → Task scheduler: schedules work
- Callback pipes → Handler registry: registers callbacks
src/vt/pipe/pipe_manager_tl.impl.h - Object groups → Active messaging: sends object messages
src/vt/objgroup/manager.h - Virtual collections → Location management: routes virtual work
src/vt/vrt/collection/manager.impl.h - Virtual collections → Collection migration: supports migration
src/vt/vrt/collection/manager.impl.h - Location management → Collection migration: updates placement
- Collective operations → Distributed groups: operates across groups
src/vt/group/group_manager.cc - Object groups → RDMA handles: creates handles
- Phase tracking → Load balancing: hooks balancing
- Load balancing → Load data: uses load data
src/vt/vrt/collection/balance/lb_invoke/lb_manager.cc - Load balancing → Collection migration: balances placement
- Workload replay → Load balancing: replays workloads