.nh
.TH runc-update "8"

.SH NAME
.PP
\fBrunc-update\fP - update running container resource constraints


.SH SYNOPSIS
.PP
\fBrunc update\fP [\fIoption\fP ...] \fIcontainer-id\fP

.PP
\fBrunc update\fP \fB-r\fP \fIresources.json\fP|\fB-\fP  \fIcontainer-id\fP


.SH DESCRIPTION
.PP
The \fBupdate\fP command change the resource constraints of a running container
instance.

.PP
The resources can be set using options, or, if \fB-r\fP is used, parsed from JSON
provided as a file or from stdin.

.PP
In case \fB-r\fP is used, the JSON format is like this:

.EX
{
	"memory": {
		"limit": 0,
			"reservation": 0,
			"swap": 0,
			"kernel": 0,
			"kernelTCP": 0
	},
		"cpu": {
			"shares": 0,
			"quota": 0,
			"period": 0,
			"realtimeRuntime": 0,
			"realtimePeriod": 0,
			"cpus": "",
			"mems": ""
		},
		"blockIO": {
			"blkioWeight": 0
		}
}

.EE


.SH OPTIONS
.TP
\fB--resources\fP|\fB-r\fP \fIresources.json\fP
Read the new resource limits from \fIresources.json\fP\&. Use \fB-\fP to read from
stdin. If this option is used, all other options are ignored.

.TP
\fB--blkio-weight\fP \fIweight\fP
Set a new io weight.

.TP
\fB--cpu-period\fP \fInum\fP
Set CPU CFS period to be used for hardcapping (in microseconds)

.TP
\fB--cpu-quota\fP \fInum\fP
Set CPU usage limit within a given period (in microseconds).

.TP
\fB--cpu-rt-period\fP \fInum\fP
Set CPU realtime period to be used for hardcapping (in microseconds).

.TP
\fB--cpu-rt-runtime\fP \fInum\fP
Set CPU realtime hardcap limit (in usecs). Allowed cpu time in a given period.

.TP
\fB--cpu-share\fP \fInum\fP
Set CPU shares (relative weight vs. other containers).

.TP
\fB--cpuset-cpus\fP \fIlist\fP
Set CPU(s) to use. The \fIlist\fP can contain commas and ranges. For example:
\fB0-3,7\fP\&.

.TP
\fB--cpuset-mems\fP \fIlist\fP
Set memory node(s) to use. The \fIlist\fP format is the same as for
\fB--cpuset-cpus\fP\&.

.TP
\fB--memory\fP \fInum\fP
Set memory limit to \fInum\fP bytes.

.TP
\fB--memory-reservation\fP \fInum\fP
Set memory reservation, or soft limit, to \fInum\fP bytes.

.TP
\fB--memory-swap\fP \fInum\fP
Set total memory + swap usage to \fInum\fP bytes. Use \fB-1\fP to unset the limit
(i.e. use unlimited swap).

.TP
\fB--pids-limit\fP \fInum\fP
Set the maximum number of processes allowed in the container.

.TP
\fB--l3-cache-schema\fP \fIvalue\fP
Set the value for Intel RDT/CAT L3 cache schema.

.TP
\fB--mem-bw-schema\fP \fIvalue\fP
Set the Intel RDT/MBA memory bandwidth schema.


.SH SEE ALSO
.PP
\fBrunc\fP(8).