package adastra.stagezero.config

Get desktop application:
View/edit binary Protocol Buffers messages

Cgroups are supported only on Linux. https://docs.kernel.org/admin-guide/cgroup-v2.html This implements almost all of the V2 cgroup controllers in Linux. The only one missing is the hugetlb controller which I don't understand how to configure. TODO: add hugetlb controller.

Used in: Compute, control.AddCgroupRequest

• Cgroup.Type type = 1

• string name = 2

• optional Cgroup.CpusetController cpuset = 3

• optional Cgroup.CpuController cpu = 4

• optional Cgroup.MemoryController memory = 5

• optional Cgroup.IOController io = 6

• optional Cgroup.PIDController pid = 7

• optional Cgroup.RDMAController rdma = 8

Used in: Cgroup

• optional int32 weight = 1

• optional int32 weight_nice = 2

• optional int32 max = 3

• optional int32 max_burst = 4

• optional float uclamp_min = 5

• optional float uclamp_max = 6

• optional int32 idle = 7

Used in: Cgroup

• optional string cpus = 1

• optional string mems = 2

• optional string cpus_exclusive = 3

• optional CpusetController.Partition partition = 4

Used in: CpusetController

• P_MEMBER = 0

• P_ROOT = 1

• P_ISOLATED = 2

Used in: Cgroup

• optional int32 weight = 1

• optional string max = 2

Used in: Cgroup

• optional int64 min = 1

• optional int64 low = 2

• optional int64 high = 3

• optional int64 max = 4

• optional int32 oom_group = 5

• optional int64 swap_high = 6

• optional int64 swap_max = 7

• optional int64 zswap_max = 9

• optional int32 zswap_writeback = 10

Used in: Cgroup

• optional int32 max = 1

  Omitted means "max"

Used in: Cgroup

• repeated RDMAController.Device device = 1

Used in: RDMAController

• string name = 1

• int64 hca_handle = 2

• optional int64 hca_object = 3

Used in: Cgroup

• CG_DOMAIN = 0

• CG_DOMAIN_THREADED = 1

• CG_THREADED = 2

Used in: capcom.proto.AddComputeRequest, flight.proto.SubsystemGraph

• string name = 1

• bytes ip_addr = 2

  Host byte order.

• int32 port = 3

  Host byte order.

• bool disabled = 4

• repeated Cgroup cgroups = 5

Used in: ProcessOptions, control.SpawnRequest

• Namespace.Type type = 1

  Some Linux manuals say that a pidfd can be used to clone the namespaces from another process. I'm not sure about how widespread the support for this is, so it's not supported for now.

These should be combined into the 'type' by ORing them together (except for NS_ANY of course).

Used in: Namespace

• NS_ANY = 0

• NS_NEWCGROUP = 1

• NS_NEWIPC = 2

• NS_NEWNET = 4

• NS_NEWPID = 8

• NS_NEWUSER = 16

• NS_NEWUTS = 32

Used in: capcom.proto.Process, control.LaunchStaticProcessRequest, control.LaunchVirtualProcessRequest

• string name = 1

• string description = 2

• repeated Variable vars = 3

  Local variables and environment.

• repeated string args = 4

  Use $var in expressions.

• int32 telemetry_shutdown_timeout_secs = 20

  Timeouts for shutdown. The sigint timeout is the number of seconds beteen sending SIGINT and SIGTERM. -1 means no SIGINT is sent. Likewise, sigterm timeout is the number of seconds between SIGTERM and SIGKILL. A value of 0 means use reasonable defaults. If 'telemetry' is true, the telemetry_shutdown_timeout_secs is used to the timeout after sending a shutdown command and before escalating to signals.

• int32 sigint_shutdown_timeout_secs = 5

• int32 sigterm_shutdown_timeout_secs = 6

• bool notify = 7

  Notify of startup via pipe.

• int32 startup_timeout_secs = 8

  If the process will notify us, we wait this long for it to do so.

• string user = 9

  User and group for owner of the process.

• string group = 10

• bool interactive = 11

  Interactive only makes sense for static processes.

• optional proto.Terminal interactive_terminal = 12

  Interactive terminal parameters.

• bool critical = 13

  A critical process is one that is needed for the system to work at all. They are not subject to restart or abort processing. If they crash, the whole system is brought down.

• bool oneshot = 14

  A oneshot process is expected to run once and exit. If it exits with a non-zero status or receives a signal it is considered to be a process failure.

• string cgroup = 15

  Cgroup name (if supported by OS). Must be present on the compute instance.

• bool detached = 16

  Process is detached from client.

• optional Namespace ns = 17

  Namespaces to assign to (only on Linux).

• repeated proto.parameters.Parameter parameters = 18

  Local parameters for the process.

• bool telemetry = 19

  The telemetry API allows the process to accept commands and send telemetry data through a pipe connected to StageZero.

  Use telemetry API.

Used in: capcom.proto.Process, control.LaunchStaticProcessRequest

• string executable = 1

Used in: capcom.proto.AddGlobalVariableRequest, capcom.proto.AddSubsystemRequest, flight.proto.AddGlobalVariableRequest, flight.proto.ModuleOptions, flight.proto.ProcessOptions, flight.proto.Subsystem, flight.proto.SubsystemGraph, ProcessOptions, control.SpawnRequest

• string name = 1

  Varible name

• string value = 2

  Expression for value (use $ for var names)

• bool exported = 3

  Export to environment.

• bool disabled = 4

Used in: capcom.proto.Process, control.LaunchVirtualProcessRequest

• string zygote = 1

  Zygote to use.

• string dso = 2

  Dynamic shared object to load (empty for none)

• string main_func = 3

  Main function to call.