How wrr/drop works
Drop is a Linux sandbox manager for local command-line work. Its main workflow is to initialize an environment and config, then resolve that config and launch a command in isolated namespaces, with a filesystem assembled for the sandbox and optional gVisor execution. The run path also configures pasta networking and coordinates parent and child processes over IPC, with PTY forwarding for interactive sessions. The README documents additional environment management and config editing commands. Some subsystem links are grounded in README capability descriptions because their implementations were not excerpted.
Main entry points: run.go Run coordinator · main.go Drop entry · init.go Environment init · cli.go Command router
Components 25
CLI and environments
- Drop entry
cmd/drop/main.go - Command router
internal/cli/cli.go - Environment init
internal/command/init.go - Config editor
internal/command/edit.go - Environment store
internal/jailfs/paths.go - Config loading
internal/config/config.go - Default config
internal/config/default.go
Sandbox runtime
- Run coordinator
internal/command/run.go - Environment vars
internal/env/env.go - Root filesystem
internal/jailfs/mount.go - Sandbox paths
internal/jailfs/paths.go - Sandbox /etc
internal/jailfs/etc.go - Working directory
internal/jailfs/cwd.go
Isolation services
- Linux namespaces
internal/command/run.go - Pasta networking
internal/netns/netns.go - gVisor runtime
internal/gvisor/gvisor.go
Runtime support
- Parent-child IPC
internal/ipc/ipc.go - PTY handling
internal/pty/pty.go - PTY socket
internal/ipc/ptysocket.go - Update check
internal/updater/updater.go
Other components
- User
- pasta service
- runsc
- Host command
- Release service
Connections 30
- User → Drop entry: runs
README.md - Drop entry → Command router: routes
cmd/drop/main.go - Drop entry → Environment init: dispatches init
cmd/drop/main.go - Drop entry → Run coordinator: dispatches run
cmd/drop/main.go - Command router → Environment init: dispatches init
internal/cli/cli.go - Command router → Run coordinator: dispatches run
internal/cli/cli.go - Drop entry → Config editor: dispatches edit
cmd/drop/main.go - Drop entry → Environment store: lists or removes
cmd/drop/main.go - Environment init → Environment store: creates environment
internal/command/init.go - Environment init → Default config: writes defaults
internal/command/init.go - Environment init → Config loading: writes base config
internal/command/init.go - Run coordinator → Config loading: loads config
internal/command/run.go - Run coordinator → Sandbox paths: creates paths
- Run coordinator → Linux namespaces: sets up
README.md - Run coordinator → Root filesystem: assembles root
internal/command/run.go - Run coordinator → Sandbox /etc: writes files
internal/command/run.go - Run coordinator → Pasta networking: starts networking
internal/command/run.go - Pasta networking → pasta service: starts
internal/netns/netns.go - Run coordinator → Parent-child IPC: sends child args
internal/command/run.go - Run coordinator → PTY handling: forwards terminal
internal/command/run.go - Run coordinator → PTY socket: passes PTY
- Run coordinator → Environment vars: prepares variables
- Run coordinator → gVisor runtime: executes optionally
internal/command/run.go - gVisor runtime → runsc: execs
internal/gvisor/gvisor.go - Run coordinator → Host command: executes natively
- Drop entry → Update check: checks version
cmd/drop/main.go - Update check → Release service: checks releases
- Config editor → Config loading: edits config
- Root filesystem → Sandbox paths: uses locations
- Run coordinator → Working directory: sets sandbox cwd