---
name: "cgxset"
section: "1"
platform: "linux"
package: "cgroup-tools"
version: "3.1.0-2+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cgxset"
---

# cgxset(1)

set the parameters of given cgroup(s)

## NAME

cgxset - set the parameters of given cgroup(s)

## SYNOPSIS

**cgxset** \[**-1**\] \[**-2**\] \[**-i**\] \[**-b**\] \[**-r** \<*name=value*\>\] \<**cgroup\_path**\> ...\
 **cgxset** \[**-b**\] **--copy-from** \<*source\_cgroup\_path*\> \<**cgroup\_path**\> ...

## DESCRIPTION

Set the parameters of input cgroups. When the request's cgroup version differs from the system's cgroup version, **cgxset** will attempt to translate from one version to the other. If the request version and the system's version are the same, no translation is done and **cgxset** will behave like **cgset**. If no version is specified by the user (either \[**-1**\] or \[**-2**\]) and the \[**-r**\] flag is specified, the behavior is undefined. **--copy-from** does not require the cgroup version to be specified.

- **\<path\>**

  is the name of the cgroup which should be changed. This parameter can be used multiple times.

- **-1, --v1**

  data in/out of **cgxset** is in cgroup v1 format. In this mode, the user will provide values in cgroup v1 format and receive values in v1 format. format. If the system is running in cgroup v2 mode, libcgroup will convert the data as necessary

- **-2, --v2**

  data in/out of **cgxset** is in cgroup v2 format. In this mode, the user will provide values in cgroup v2 format and receive values in v2 format. If the system is running in cgroup v1 mode, libcgroup will convert the data as necessary

- **-b**

  ignores the default systemd delegated hierarchy path and constructs the path of the control groups relative to the cgroup root hierarchy.

- **-i, --ignore-unmappable**

  ignore errors for values that cannot be converted from v1 to v2 or vice versa

- **-r \<name=value\>**

  defines the name of the file to set and the value which should be written to that file. This parameter can be used multiple times.

- **--copy-from \<source\_cgroup\_path\>**

  defines the name of the cgroup whose parameters will be copied to the input cgroup.

## ENVIRONMENT VARIABLES

- **CGROUP\_LOGLEVEL**

  controls verbosity of the tool. Allowed values are **DEBUG**, **INFO**, **WARNING** or **ERROR**.

## EXAMPLES

- **cgxset -1 -r cpuset.cpus=0-1 student**

  set variable cpus in control group student (controller cpuset) to 0-1

- **cgxset -2 -r cpu.weight=42 first**

  set variable weight in control group first (controller cpu) to 42

- **cgxset --copy-from group1/ group2/**

  copy all parameters of group group1 to group group2 (for all path where both cgroups are defined)

## SEE ALSO

cgrules.conf (1), cgcreate (1), cgget (1), cgset (1), cgxget (1)