How uber-go/automaxprocs works
automaxprocs is a small Go library that adjusts Go’s GOMAXPROCS to match a Linux container CPU quota. The documented workflow is to blank-import the top-level package, which invokes the configurable maxprocs API; that API obtains a quota-derived value and applies it to the Go runtime. Linux quota discovery supports both cgroups v1 and v2. The excerpts show the key dispatch and parsing relationships; unsampled cgroup internals are represented without inferred calls.
Main entry points: cpu_quota_linux.go Quota conversion · cgroups.go Cgroups v1 quota · maxprocs.go Configure GOMAXPROCS · cgroups2.go Cgroups v2 quota
Components 12
Entry and API
- Auto initialization
automaxprocs.go - Configure GOMAXPROCS
maxprocs/maxprocs.go
Quota resolution
- Quota conversion
internal/runtime/cpu_quota_linux.go - Quota status and rounding
internal/runtime/runtime.go - Non-Linux fallback
internal/runtime/cpu_quota_unsupported.go
Cgroup discovery
- Cgroups v1 quota
internal/cgroups/cgroups.go - Cgroups v2 quota
internal/cgroups/cgroups2.go - Proc cgroup parser
internal/cgroups/subsys.go - Mountinfo parser
internal/cgroups/mountpoint.go - Cgroup file access
internal/cgroups/cgroup.go
Other components
- Go application
- Go runtime
Connections 12
- Go application → Auto initialization: blank imports
README.md - Auto initialization → Configure GOMAXPROCS: invokes
automaxprocs.go - Configure GOMAXPROCS → Quota conversion: requests quota
maxprocs/maxprocs.go - Configure GOMAXPROCS → Go runtime: sets GOMAXPROCS
maxprocs/maxprocs.go - Quota conversion → Cgroups v2 quota: tries first
internal/runtime/cpu_quota_linux.go - Quota conversion → Cgroups v1 quota: falls back
internal/runtime/cpu_quota_linux.go - Quota conversion → Quota status and rounding: uses status types
internal/runtime/cpu_quota_linux.go - Cgroups v1 quota → Proc cgroup parser: parses proc entries
internal/cgroups/cgroups.go - Cgroups v1 quota → Mountinfo parser: parses mountinfo
internal/cgroups/cgroups.go - Cgroups v1 quota → Cgroup file access: creates accessors
internal/cgroups/cgroups.go - Cgroups v2 quota → Proc cgroup parser: parses proc entries
internal/cgroups/cgroups2.go - Cgroups v2 quota → Mountinfo parser: checks mountinfo
internal/cgroups/cgroups2.go