1runc-update(8) System Manager's Manual runc-update(8)
2
3
4
6 runc-update - update running container resource constraints
7
8
9
11 runc update [option ...] container-id
12
13
14 runc update -r resources.json|- container-id
15
16
17
19 The update command change the resource constraints of a running con‐
20 tainer instance.
21
22
23 The resources can be set using options, or, if -r is used, parsed from
24 JSON provided as a file or from stdin.
25
26
27 In case -r is used, the JSON format is like this:
28
29
30 {
31 "memory": {
32 "limit": 0,
33 "reservation": 0,
34 "swap": 0,
35 "kernel": 0,
36 "kernelTCP": 0
37 },
38 "cpu": {
39 "shares": 0,
40 "quota": 0,
41 "period": 0,
42 "realtimeRuntime": 0,
43 "realtimePeriod": 0,
44 "cpus": "",
45 "mems": ""
46 },
47 "blockIO": {
48 "blkioWeight": 0
49 }
50 }
51
52
53
54
56 --resources|-r resources.json
57 Read the new resource limtis from resources.json. Use - to read
58 from stdin. If this option is used, all other options are ig‐
59 nored.
60
61
62 --blkio-weight weight
63 Set a new io weight.
64
65
66 --cpu-period num
67 Set CPU CFS period to be used for hardcapping (in microseconds)
68
69
70 --cpu-quota num
71 Set CPU usage limit within a given period (in microseconds).
72
73
74 --cpu-rt-period num
75 Set CPU realtime period to be used for hardcapping (in microsec‐
76 onds).
77
78
79 --cpu-rt-runtime num
80 Set CPU realtime hardcap limit (in usecs). Allowed cpu time in a
81 given period.
82
83
84 --cpu-share num
85 Set CPU shares (relative weight vs. other containers).
86
87
88 --cpuset-cpus list
89 Set CPU(s) to use. The list can contain commas and ranges. For
90 example: 0-3,7.
91
92
93 --cpuset-mems list
94 Set memory node(s) to use. The list format is the same as for
95 --cpuset-cpus.
96
97
98 --memory num
99 Set memory limit to num bytes.
100
101
102 --memory-reservation num
103 Set memory reservation, or soft limit, to num bytes.
104
105
106 --memory-swap num
107 Set total memory + swap usage to num bytes. Use -1 to unset the
108 limit (i.e. use unlimited swap).
109
110
111 --pids-limit num
112 Set the maximum number of processes allowed in the container.
113
114
115 --l3-cache-schema value
116 Set the value for Intel RDT/CAT L3 cache schema.
117
118
119 --mem-bw-schema value
120 Set the Intel RDT/MBA memory bandwidth schema.
121
122
123
125 runc(8).
126
127
128
129 runc-update(8)