summaryrefslogtreecommitdiffstats
path: root/doc/man/cgexec.1
diff options
context:
space:
mode:
authorBalbir Singh <balbir@linux.vnet.ibm.com>2009-02-17 09:25:59 +0000
committerBalbir Singh <balbir@linux.vnet.ibm.com>2009-02-17 09:25:59 +0000
commit076dd1c6714b51dba4d5d001a730504219c49a59 (patch)
treeebb357a4dfbfea96eb76f30f815135ec0b193e15 /doc/man/cgexec.1
parent6ddd963b8329e6def838b6e0e0f9459210e52d7a (diff)
downloadlibcg-076dd1c6714b51dba4d5d001a730504219c49a59.tar.gz
libcg-076dd1c6714b51dba4d5d001a730504219c49a59.tar.xz
libcg-076dd1c6714b51dba4d5d001a730504219c49a59.zip
This is my proposal of cgexec man page. I've used some of some parts
of present documentation of libcg - again. Signed-off-by: Ivana Varekova <varekova@redhat.com> Signed-off-by: Balbir Singh <balbir@linux.vnet.ibm.com> git-svn-id: https://libcg.svn.sourceforge.net/svnroot/libcg/trunk@331 4f4bb910-9a46-0410-90c8-c897d4f1cd53
Diffstat (limited to 'doc/man/cgexec.1')
-rw-r--r--doc/man/cgexec.172
1 files changed, 72 insertions, 0 deletions
diff --git a/doc/man/cgexec.1 b/doc/man/cgexec.1
new file mode 100644
index 0000000..6d0ca7e
--- /dev/null
+++ b/doc/man/cgexec.1
@@ -0,0 +1,72 @@
+.\" Copyright (C) 2006 Red Hat, Inc. All Rights Reserved.
+.\" Written by Ivana Varekova <varekova@redhat.com>
+
+.TH CGEXEC 1 2009-03-15 "Linux" "libcg Manual"
+.SH NAME
+
+cgexec \- run the task in given control groups
+
+.SH SYNOPSIS
+\fBcgexec\fR [\fB-g\fR <\fIcontrollers>:<path\fR>] \fBcommand\fR [\fIarguments\fR]
+
+.SH DESCRIPTION
+The \fBcgexec\fR
+program executes the task \fBcommand\fR
+with arguments \fBarguments\fR in given control groups.
+
+.TP
+.B -g <controllers>:<path>
+defines control groups in which the task will be run.
+\fBcontrollers\fR is a list of controllers and
+\fBpath\fR is the relative path to control groups
+in the given controllers list.
+
+This flag can be used multiple times to
+define multiple pairs of lists of controllers
+and relative paths.
+Instead of the list of all mounted controllers,
+wildcard \fBb*b\fR can be used.
+
+If this option is not used then
+\fBcgexec\fR will automatically place the task to the right
+cgroup based on \fB/etc/cgrules.conf\fR.
+
+.LP
+
+.SH EXAMPLES
+
+.nf
+.ft B
+cgexec -g *:test1 ls
+.ft R
+.fi
+runs command \fBls\fR in control group test1
+in all mounted controllers.
+
+.nf
+.ft B
+cgexec -g cpu,memory:test1 ls -l
+.ft R
+.fi
+runs command \fBls -l\fR in control group test1
+in controllers cpu and memory.
+
+.nf
+.ft B
+cgexec -g cpu,memory:test1 -g swap:test2 ls -l
+.ft R
+.fi
+runs command \fBls -l\fR in control group test1
+in controllers cpu and memory and control group
+test2 in controller swap.
+
+.SH FILES
+.LP
+.PD .1v
+.TP 20
+.B /etc/cgrules.conf
+.TP
+default libcgroup configuration file
+
+.SH SEE ALSO
+cgrules.conf (5)