CGSNAPSHOT(1)

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)