CHANGELOG v3
* fix the man page to show the actual cgsnapshot options
CHANGELOG v2
* incorporate dhavalś feedback
whitelist -> blacklist
CHANGELOG v1
* fix jsafranek comments
This patch adds cgsnapshot man page
Signed-off-by: Ivana Hutarova Varekova <[email protected]>
---
0 files changed, 0 insertions(+), 0 deletions(-)
diff --git a/doc/man/Makefile.am b/doc/man/Makefile.am
index 42323fd..26338d8 100644
--- a/doc/man/Makefile.am
+++ b/doc/man/Makefile.am
@@ -1,6 +1,6 @@
man_MANS = cgclassify.1 cgconfig.conf.5 cgconfigparser.8 cgexec.1 cgred.conf.5
\
cgrules.conf.5 cgrulesengd.8 cgcreate.1 cgset.1 cgclear.1 cgget.1 \
- cgdelete.1 lssubsys.1 lscgroup.1
+ cgdelete.1 lssubsys.1 lscgroup.1 cgsnapshot.1
EXTRA_DIST = $(man_MANS)
diff --git a/doc/man/cgsnapshot.1 b/doc/man/cgsnapshot.1
new file mode 100644
index 0000000..37ccd59
--- /dev/null
+++ b/doc/man/cgsnapshot.1
@@ -0,0 +1,95 @@
+.\" Copyright (C) 2010 Red Hat, Inc. All Rights Reserved.
+.\" Written by Ivana Varekova <[email protected]>
+
+.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]
[...]
+
+.SH DESCRIPTION
+
+\fBcgsnapshot\fR
+generates the cgconfig compatible configuration file
+for given controllers.
+If no controller is set, then
+cgsnapshot shows all mounted hierarchies.
+The output is in the same format as
+.B cgconfig.conf
+configuration file.
+
+.TP
+.B -b file
+Display only variables from blacklist.
+The default location of the blacklist is
+.B /etc/cgsnapshot_blacklist.conf.
+This list contains all variables which should be ignored by
+.B cgsnapshot
+tool.
+If the variable is blacklisted, then it will not be displayed.
+If it is not present on the blacklist, then the whitelist
+is checked.
+
+.TP
+.B -h, --help
+display this help and exit
+
+.TP
+.B -f, --file
+Redirect the output to output_file
+
+
+.TP
+.B -s, --silent
+Ignore all warnings
+
+.TP
+.B -t, --strict
+Do not display the variables which are not on the whitelist
+
+
+.TP
+.B -w file
+Set the blacklist configuration file.
+The default location of the whitelist is
+.B /etc/cgsnapshot_whitelist.conf.
+This list contains all variables which should be displayed by
+.B cgsnapshot
+tool.
+If the variable is not blacklisted then whitelist is checked.
+If the variable is on the whitelist, then it is displayed by
+.B cgsnapshot
+tool.
+If the variable is not on the whitelist, then
+the variable is displayed and warning message is produced.
+The warning message can be omitted using
+.B -s, --silent
+flag.
+If
+.B -t, --strict
+flag is used then the variable which is not on whitelist is
+not displayed.
+
+.TP
+.B controller
+defines controller whose hierarchies will be
+output
+
+.SH FILES
+.TP
+.B /etc/cgsnapshot_blacklist.conf
+default location of the blacklist
+
+.TP
+.B /etc/cgsnapshot_whitelist.conf
+default location of the whitelist
+
+.TP
+.B /etc/cgconfig.conf
+default libcgroup configuration file
+
+.SH SEE ALSO
+cgconfig.conf (5)
------------------------------------------------------------------------------
Virtualization is moving to the mainstream and overtaking non-virtualized
environment for deploying applications. Does it make network security
easier or more difficult to achieve? Read this whitepaper to separate the
two and get a better understanding.
http://p.sf.net/sfu/hp-phase2-d2d
_______________________________________________
Libcg-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/libcg-devel
