cgroup

Documentation

Overview

Package cgroup provides cgroup utilities to handle nested cgroups.

When Talos runs in a container, it might either share or not share the host cgroup namespace. If the cgroup namespace is not shared, PID 1 will appear in cgroup '/', otherwise it will be part of some pre-existing cgroup hierarchy.

When Talos is running in a non-container mode, it is always at the root of the cgroup hierarchy.

This package provides a transparent way to handle nested cgroups by providing a Path() function which returns the correct cgroup path based on the cgroup hierarchy available.

Index

• func InitRoot() error
• func Path(cgroupPath string) string
• func Root() string

Functions

func InitRoot

func InitRoot() error

InitRoot initializes the root cgroup path.

This function should be called once at the beginning of the program, after the cgroup filesystem is mounted.

This function only supports cgroupv2 nesting.

func Path

func Path(cgroupPath string) string

Path returns the path to the cgroup.

This function handles the case when the cgroups are nested.

func Root

func Root() string

Root returns the root cgroup path.