How tokio-rs/tokio works
Tokio is a Rust asynchronous runtime and a family of companion crates. An application enters through a runtime (often via #[tokio::main]), schedules async work, and uses nonblocking I/O; the runtime combines task scheduling with an OS-backed I/O driver. The repository also supplies synchronization, timers, filesystem and process APIs, and companion stream and utility crates. Relationships among the runtime’s core parts are supported by the README and indexed excerpts; unsampled feature implementations are represented only at their existing subsystem paths.
Main entry points: runtime/mod.rs Runtime API · worker.rs Worker execution · scheduler/mod.rs Task scheduler · task/mod.rs Task lifecycle
Components 21
Runtime core
- Runtime API
tokio/src/runtime/mod.rs - Runtime builder
tokio/src/runtime/builder.rs - Task context
tokio/src/runtime/context.rs - Task scheduler
tokio/src/runtime/scheduler/mod.rs - Worker execution
tokio/src/runtime/scheduler/multi_thread/worker.rs - Task lifecycle
tokio/src/runtime/task/mod.rs - Runtime metrics
tokio/src/runtime/metrics/runtime.rs
I/O and resources
- I/O driver
tokio/src/runtime/driver.rs - TCP and UDP
tokio/src/net/mod.rs - Async I/O
tokio/src/io/mod.rs - Filesystem
tokio/src/fs/mod.rs - Process management
tokio/src/process/mod.rs - OS signals
tokio/src/signal/mod.rs
Async coordination
- Timers
tokio/src/time/mod.rs - Synchronization
tokio/src/sync/mod.rs - Async macros
tokio-macros/src/entry.rs
Companion crates
- Stream adapters
tokio-stream/src/stream_ext.rs - Framed codecs
tokio-util/src/codec/mod.rs - Future utilities
tokio-util/src/future.rs - Delay queue
tokio-util/src/time/delay_queue.rs
Other components
- Application
Connections 23
- Application → Runtime API: runs on
- Runtime API → Runtime builder: configures
tokio/src/runtime/mod.rs - Runtime API → Task scheduler: drives tasks
tokio/src/runtime/mod.rs - Runtime API → I/O driver: uses driver
tokio/src/runtime/mod.rs - Task context → Task scheduler: tracks scheduler
tokio/src/runtime/context.rs - Task scheduler → Task lifecycle: spawns tasks
tokio/src/runtime/scheduler/mod.rs - Worker execution → Task lifecycle: polls tasks
tokio/src/runtime/scheduler/multi_thread/worker.rs - Worker execution → I/O driver: checks events
tokio/src/runtime/scheduler/multi_thread/worker.rs - Runtime API → TCP and UDP: hosts networking
- Application → TCP and UDP: accepts sockets
- Application → Task lifecycle: spawns work
- Application → Async I/O: reads and writes
- Runtime API → Filesystem: provides async FS
tokio/src/lib.rs - Runtime API → Process management: provides processes
tokio/src/lib.rs - Runtime API → OS signals: provides signals
tokio/src/lib.rs - Runtime API → Timers: provides timers
tokio/src/lib.rs - Runtime API → Synchronization: provides sync
tokio/src/lib.rs - Application → Async macros: uses entry macro
- Application → Stream adapters: adapts streams
- Async I/O → Framed codecs: frames I/O
tokio-util/src/codec/mod.rs - Stream adapters → Future utilities: uses utilities
- Future utilities → Delay queue: schedules delays
- Worker execution → Runtime metrics: records runtime data