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

# cgsnapshot(1)

generate the configuration file for given controllers

## NAME

cgsnapshot - generate the configuration file for given controllers

## SYNOPSIS

**cgsnapshot** \[**-h**\] \[**-s**\] \[**-t**\] \[**-b** *file*\] \[**-w** *file*\] \[**-f** *output\_file*\] \[**controller**\] \[...\]

## DESCRIPTION

**cgsnapshot** generates the cgconfig compatible configuration file for the given controllers. If no controller is set, then cgsnapshot shows all mounted hierarchies. The output is in the same format as the **cgconfig.conf** configuration file.

- **-b file**

  Display only variables from the denylist. The default location of the denylist is **/etc/cgsnapshot\_denylist.conf.** This list contains all variables which should be ignored by the **cgsnapshot** If the variable is denylisted, it will not be displayed. If it is not present on the denylist, the allowlist is checked.

- **-h, --help**

  display this help and exit

- **-f, --file**

  Redirect the output to output\_file

- **-s, --silent**

  Ignore all warnings

- **-t, --strict**

  Do not display the variables which are not on the allowlist

- **-w file**

  Set the denylist configuration file. This list contains all variables which should be displayed by **cgsnapshot** If the variable is not denylisted, the allowlist is checked. If the variable is on the allowlist, it is displayed by **cgsnapshot** If the variable is not on the allowlist, the variable is displayed and a warning message is produced. By default the allowlist is not used.

  The warning message can be omitted using the **-s, --silent** flag. If the **-t, --strict** flag is used, the variable which is not on the allowlist is not displayed.

- **controller**

  defines the controller whose hierarchies will be output

## ENVIRONMENT VARIABLES

- **CGROUP\_LOGLEVEL**

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

## FILES

- **/etc/cgsnapshot\_denylist.conf**

  default denylist

- **/etc/cgsnapshot\_allowlist.conf**

  default allowlist

- **/etc/cgconfig.conf**

  default libcgroup configuration file

## EXAMPLES

- **cgsnapshot -s -f /etc/cgconfig.conf.cgsnapshot**

  create configuration file which contains all mounted controllers and all control groups which are on the actual system

- **cgsnapshot -s -f /etc/cgconfig.conf.cgsnapshot cpu**

  create configuration file which contains hierarchy containing cpu controller and all its control groups on the actual system

## SEE ALSO

cgconfig.conf (5)