From 076dd1c6714b51dba4d5d001a730504219c49a59 Mon Sep 17 00:00:00 2001 From: Balbir Singh Date: Tue, 17 Feb 2009 09:25:59 +0000 Subject: 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 Signed-off-by: Balbir Singh git-svn-id: https://libcg.svn.sourceforge.net/svnroot/libcg/trunk@331 4f4bb910-9a46-0410-90c8-c897d4f1cd53 --- doc/man/cgexec.1 | 72 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 doc/man/cgexec.1 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 + +.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>:] \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 : +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) -- cgit