Skip to content

Secure, Fast, and Extensible Sandbox runtime for AI agents.

3.9 KB
Raw Blame
// Copyright 2026 The OpenSandbox Authors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package resources

import (
	"math"
	"strconv"
	"strings"
)

// parseMemoryStatField extracts one "<field> <value>" line from a cgroup
// memory.stat file (v2 and v1 share the format).
func parseMemoryStatField(data []byte, field string) (int64, bool) {
	for _, line := range strings.Split(string(data), "\n") {
		if fields := strings.Fields(line); len(fields) == 2 && fields[0] == field {
			value, err := strconv.ParseInt(fields[1], 10, 64)
			if err != nil {
				return 0, false
			}
			return value, true
		}
	}
	return 0, false
}

// parseCPUStatUsageUSec extracts usage_usec from a cgroup v2 cpu.stat.
func parseCPUStatUsageUSec(data []byte) (uint64, bool) {
	for _, line := range strings.Split(string(data), "\n") {
		if fields := strings.Fields(line); len(fields) == 2 && fields[0] == "usage_usec" {
			value, err := strconv.ParseUint(fields[1], 10, 64)
			if err != nil {
				return 0, false
			}
			return value, true
		}
	}
	return 0, false
}

// parseSingleUint parses a file holding one unsigned integer, e.g. the
// nanoseconds counter of cgroup v1 cpuacct.usage.
func parseSingleUint(data []byte) (uint64, bool) {
	value, err := strconv.ParseUint(strings.TrimSpace(string(data)), 10, 64)
	if err != nil {
		return 0, false
	}
	return value, true
}

// parseSingleInt parses a file holding one signed integer.
func parseSingleInt(data []byte) (int64, bool) {
	value, err := strconv.ParseInt(strings.TrimSpace(string(data)), 10, 64)
	if err != nil {
		return 0, false
	}
	return value, true
}

// parseCPUMax parses cgroup v2 cpu.max: "<quota|max> <period>".
func parseCPUMax(data []byte) (quotaUSec, periodUSec int64, limited bool, ok bool) {
	fields := strings.Fields(string(data))
	if len(fields) != 2 {
		return 0, 0, false, false
	}
	period, err := strconv.ParseInt(fields[1], 10, 64)
	if err != nil || period <= 0 {
		return 0, 0, false, false
	}
	if fields[0] == "max" {
		return 0, period, false, true
	}
	quota, err := strconv.ParseInt(fields[0], 10, 64)
	if err != nil || quota <= 0 {
		return 0, 0, false, false
	}
	return quota, period, true, true
}

// quotaCores converts a CPU quota (quota/period microseconds) into a core
// count, rounding up to whole cores.
func quotaCores(quotaUSec, periodUSec int64) float64 {
	if quotaUSec <= 0 || periodUSec <= 0 {
		return 0
	}
	return math.Ceil(float64(quotaUSec) / float64(periodUSec))
}

// parseMemoryMax parses cgroup v2 memory.max: a byte count or "max"
// (unlimited).
func parseMemoryMax(data []byte) (limit int64, limited bool, ok bool) {
	if strings.TrimSpace(string(data)) == "max" {
		return 0, false, true
	}
	value, ok := parseSingleInt(data)
	if !ok {
		return 0, false, false
	}
	return value, true, true
}

// v1UnlimitedBytes: cgroup v1 encodes "no limit" as a huge byte count
// instead of a marker word.
const v1UnlimitedBytes = 1 << 50

// parseV1MemoryLimit parses cgroup v1 memory.limit_in_bytes.
func parseV1MemoryLimit(data []byte) (limit int64, limited bool, ok bool) {
	value, ok := parseSingleInt(data)
	if !ok {
		return 0, false, false
	}
	if value >= v1UnlimitedBytes {
		return 0, false, true
	}
	return value, true, true
}

// parseV1QuotaUS parses cgroup v1 cpu.cfs_quota_us (<= 0 means unlimited).
func parseV1QuotaUS(data []byte) (quotaUSec int64, limited bool, ok bool) {
	value, ok := parseSingleInt(data)
	if !ok {
		return 0, false, false
	}
	if value <= 0 {
		return 0, false, true
	}
	return value, true, true
}