man > cgsnapshot(1)

man perldoc info pydoc3 ri search

📖 NAME

cgsnapshot - generate the configuration file for given controllers

🚀 Quick Reference

Use Case	Command	Description
Generate config for all mounted controllers	cgsnapshot -s -f /etc/cgconfig.conf.cgsnapshot	Create a configuration file containing all mounted controllers and control groups
Generate config for a specific controller	cgsnapshot -s -f /etc/cgconfig.conf.cgsnapshot cpu	Create a configuration file for the cpu controller hierarchy
Use custom blacklist file	cgsnapshot -b /path/to/blacklist.conf	Only display variables from the blacklist
Use custom whitelist file	cgsnapshot -w /path/to/whitelist.conf	Only display variables on the whitelist (with warnings for others)
Silent mode (no warnings)	cgsnapshot -s	Ignore all warnings
Strict mode (hide non-whitelisted)	cgsnapshot -t	Do not display variables not on the whitelist
Display help	cgsnapshot -h	Show help and exit

📋 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.

⚙️ OPTIONS

🔹 -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 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

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

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)

📖 NAME 🚀 Quick Reference 📋 SYNOPSIS 📝 DESCRIPTION ⚙️ OPTIONS 🌍 ENVIRONMENT VARIABLES 📁 FILES 💡 EXAMPLES 🔗 SEE ALSO