libcgroup/doc/man/cgsnapshot.1

101 lines
2.2 KiB
Groff
Raw Normal View History

2022-06-18 14:07:38 +08:00
.\" Copyright (C) 2010 Red Hat, Inc. All Rights Reserved.
.\" Written by Ivana Hutarova Varekova <varekova@redhat.com>
.TH CGSNAPSHOT 1 2010-07-28 "Linux" "libcgroup Manual"
.SH NAME
cgsnapshot \- generate the configuration file for given controllers
.SH SYNOPSIS
\fBcgsnapshot\fR [\fB\-h\fR] [\fB\-s\fR] [\fB\-t\fR] [\fB\-b\fR \fIfile\fR]
[\fB\-w\fR \fIfile\fR] [\fB\-f\fR \fIoutput_file\fR] [\fBcontroller\fR] [...]
2022-06-18 14:07:38 +08:00
.SH DESCRIPTION
\fBcgsnapshot\fR
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
.B cgconfig.conf
configuration file.
.TP
.B \-b file
2022-06-18 14:07:38 +08:00
Display only variables from the blacklist.
The default location of the blacklist is
.B /etc/cgsnapshot_blacklist.conf.
This list contains all variables which should be ignored by the
.B cgsnapshot
.
If the variable is blacklisted, it will not be displayed.
If it is not present on the blacklist, the whitelist
is checked.
.TP
.B \-h, \-\-help
2022-06-18 14:07:38 +08:00
display this help and exit
.TP
.B \-f, \-\-file
2022-06-18 14:07:38 +08:00
Redirect the output to output_file
.TP
.B \-s, \-\-silent
2022-06-18 14:07:38 +08:00
Ignore all warnings
.TP
.B \-t, \-\-strict
2022-06-18 14:07:38 +08:00
Do not display the variables which are not on the whitelist
.TP
.B \-w file
2022-06-18 14:07:38 +08:00
Set the blacklist configuration file.
This list contains all variables which should be displayed by
.B cgsnapshot
.
If the variable is not blacklisted, the whitelist is checked.
If the variable is on the whitelist, it is displayed by
.B 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
.B \-s, \-\-silent
2022-06-18 14:07:38 +08:00
flag.
If the
.B \-t, \-\-strict
2022-06-18 14:07:38 +08:00
flag is used, the variable which is not on the whitelist is
not displayed.
.TP
.B controller
defines the controller whose hierarchies will be
output
.SH ENVIRONMENT VARIABLES
.TP
.B CGROUP_LOGLEVEL
controls verbosity of the tool. Allowed values are \fBDEBUG\fR,
\fBINFO\fR, \fBWARNING\fR or \fBERROR\fR.
.SH FILES
.TP
.B /etc/cgsnapshot_blacklist.conf
default blacklist
.TP
.B /etc/cgsnapshot_whitelist.conf
default whitelist
.TP
.B /etc/cgconfig.conf
default libcgroup configuration file
.SH SEE ALSO
cgconfig.conf (5)