cgsnapshot man page

cgsnapshot — generate the configuration file for given controllers


cgsnapshot [-h] [-s] [-t] [-b file] [-w file] [-f output_file]  [controller] [...]


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 blacklist. The default location of the blacklist is /etc/cgsnapshot_blacklist.conf. This list contains all variables which should be ignored by the cgsnapshot If the variable is blacklisted, it will not be displayed. If it is not present on the blacklist, the whitelist 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 whitelist

-w file

Set the blacklist configuration file. This list contains all variables which should be displayed by cgsnapshot If the variable is not blacklisted, the whitelist is checked. If the variable is on the whitelist, it is displayed by cgsnapshot If the variable is not on the whitelist, the variable is displayed and a warning message is produced. By default the whitelist 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 whitelist is not displayed.


defines the controller whose hierarchies will be output

Environment Variables


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



default blacklist


default whitelist


default libcgroup configuration file

See Also

cgconfig.conf (5)


2010-07-28 Linux libcgroup Manual