runc-update(8) System Manager's Manual runc-update(8)

# [NAME](#NAME)

**runc-update** - update running container resource constraints

# [SYNOPSIS](#SYNOPSIS)

**runc update** \[*option* ...] *container-id*

**runc update** **-r** *resources.json*|**-** *container-id*

# [DESCRIPTION](#DESCRIPTION)

The **update** command change the resource constraints of a running container instance.

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

In case **-r** is used, the JSON format is like this:

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

# [OPTIONS](#OPTIONS)

[**--resources**|**-r** *resources.json*](#resources)

Read the new resource limits from *resources.json*. Use **-** to read from stdin. If this option is used, all other options are ignored.

[**--blkio-weight** *weight*](#blkio_weight)

Set a new io weight.

[**--cpu-period** *num*](#cpu_period)

Set CPU CFS period to be used for hardcapping (in microseconds)

[**--cpu-quota** *num*](#cpu_quota)

Set CPU usage limit within a given period (in microseconds).

[**--cpu-burst** *num*](#cpu_burst)

Set CPU burst limit within a given period (in microseconds).

[**--cpu-rt-period** *num*](#cpu_rt_period)

Set CPU realtime period to be used for hardcapping (in microseconds).

[**--cpu-rt-runtime** *num*](#cpu_rt_runtime)

Set CPU realtime hardcap limit (in usecs). Allowed cpu time in a given period.

[**--cpu-share** *num*](#cpu_share)

Set CPU shares (relative weight vs. other containers).

[**--cpuset-cpus** *list*](#cpuset_cpus)

Set CPU(s) to use. The *list* can contain commas and ranges. For example: **0-3,7**.

[**--cpuset-mems** *list*](#cpuset_mems)

Set memory node(s) to use. The *list* format is the same as for **--cpuset-cpus**.

[**--memory** *num*](#memory)

Set memory limit to *num* bytes.

[**--memory-reservation** *num*](#memory_reservation)

Set memory reservation, or soft limit, to *num* bytes.

[**--memory-swap** *num*](#memory_swap)

Set total memory + swap usage to *num* bytes. Use **-1** to unset the limit (i.e. use unlimited swap).

[**--pids-limit** *num*](#pids_limit)

Set the maximum number of processes allowed in the container. Use **-1** to unset the limit.

[**--l3-cache-schema** *value*](#l3-cache_schema)

Set the value for Intel RDT/CAT L3 cache schema.

[**--mem-bw-schema** *value*](#mem_bw_schema)

Set the Intel RDT/MBA memory bandwidth schema.

# [SEE ALSO](#SEE_ALSO)

[**runc**(8)](/man/os/runc/runc.8).

---

Document: runc-update(8) from runc 1.5.2-r1 (Chainguard OS)
Source: https://github.com/opencontainers/runc