man > CGSNAPSHOT(1)

CGSNAPSHOT(1)                             libcgroup Manual                             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 blacklist.  The default location of the  blacklist  is
              /etc/cgsnapshot_blacklist.conf.   This list contains all variables which should be ig‐
              nored 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.


       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_blacklist.conf
              default blacklist


       /etc/cgsnapshot_whitelist.conf
              default whitelist


       /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)

Linux                                        2010-07-28                                CGSNAPSHOT(1)