From: Ivana Hutarova Varekova <varekova@redhat.com>
Date: Wed, 20 Oct 2010 13:39:15 +0000 (+0530)
Subject: CHANGELOG v4
X-Git-Tag: v0.37~48
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ab6396e6fc11c98332cd514a573c5f725cc1f95b;p=thirdparty%2Flibcgroup.git

CHANGELOG v4
	* fix the description of the default behavior of -w option

	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 <varekova@redhat.com>
Signed-off-by: Balbir Singh <balbir@linux.vnet.ibm.com>
Acked-by: Jan Safranek <jsafrane@redhat.com>
---

diff --git a/doc/man/Makefile.am b/doc/man/Makefile.am
index 42323fdf..26338d82 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 00000000..1516bb2c
--- /dev/null
+++ b/doc/man/cgsnapshot.1
@@ -0,0 +1,95 @@
+.\" 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] [...]
+
+.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.
+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.
+By default the whitelist is not used.
+
+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)