~ubuntu-branches/ubuntu/maverick/libcgroup/maverick-proposed

« back to all changes in this revision

Viewing changes to doc/man/cgexec.1

  • Committer: Bazaar Package Importer
  • Author(s): Dustin Kirkland
  • Date: 2009-08-26 11:29:17 UTC
  • Revision ID: james.westby@ubuntu.com-20090826112917-402ews2uj6v350d2
Tags: upstream-0.34
ImportĀ upstreamĀ versionĀ 0.34

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" Copyright (C) 2009 Red Hat, Inc. All Rights Reserved.
 
2
.\" Written by Ivana Varekova <varekova@redhat.com>
 
3
 
 
4
.TH CGEXEC  1 2009-03-15 "Linux" "libcgroup Manual"
 
5
.SH NAME
 
6
 
 
7
cgexec \- run the task in given control groups
 
8
 
 
9
.SH SYNOPSIS
 
10
\fBcgexec\fR [\fB-g\fR <\fIcontrollers>:<path\fR>] [--sticky] \fBcommand\fR [\fIarguments\fR]
 
11
 
 
12
.SH DESCRIPTION
 
13
The \fBcgexec\fR
 
14
program executes the task \fBcommand\fR
 
15
with arguments \fBarguments\fR in given control groups.
 
16
 
 
17
.TP
 
18
.B -g <controllers>:<path>
 
19
defines control groups in which the task will be run.
 
20
\fBcontrollers\fR is a list of controllers and
 
21
\fBpath\fR is the relative path to control groups
 
22
in the given controllers list.
 
23
 
 
24
This flag can be used multiple times to
 
25
define multiple pairs of lists of controllers
 
26
and relative paths.
 
27
Instead of the list of all mounted controllers,
 
28
wildcard \fBb*b\fR can be used.
 
29
 
 
30
If this option is not used then
 
31
\fBcgexec\fR will automatically place the task to the right
 
32
cgroup based on \fB/etc/cgrules.conf\fR.
 
33
 
 
34
.TP
 
35
.B --sticky
 
36
If running the task \fBcommand\fR with this option, the daemon of
 
37
service cgred (cgrulesengd process) does not change both the task
 
38
of the \fBcommand\fR and the children tasks. Without this option,
 
39
the daemon does not change the task of the \fBcommand\fR but it
 
40
changes the children tasks to the right cgroup based on
 
41
\fB/etc/cgrules.conf\fR automatically.
 
42
 
 
43
.LP
 
44
 
 
45
.SH EXAMPLES
 
46
 
 
47
.nf
 
48
.ft B
 
49
cgexec -g *:test1 ls
 
50
.ft R
 
51
.fi
 
52
runs command \fBls\fR in control group test1
 
53
in all mounted controllers.
 
54
 
 
55
.nf
 
56
.ft B
 
57
cgexec -g cpu,memory:test1 ls -l
 
58
.ft R
 
59
.fi
 
60
runs command \fBls -l\fR in control group test1
 
61
in controllers cpu and memory.
 
62
 
 
63
.nf
 
64
.ft B
 
65
cgexec -g cpu,memory:test1 -g swap:test2 ls -l
 
66
.ft R
 
67
.fi
 
68
runs command \fBls -l\fR in control group test1
 
69
in controllers cpu and memory and control group 
 
70
test2 in controller swap.
 
71
 
 
72
.SH FILES
 
73
.LP
 
74
.PD .1v
 
75
.TP 20
 
76
.B /etc/cgrules.conf
 
77
.TP
 
78
default libcgroup configuration file
 
79
 
 
80
.SH SEE ALSO
 
81
cgrules.conf (5)