run-update

Section: Misc. Reference Manual Pages (8)
Index Return to Main Contents

---

 

NAME

run-update - update running container resource constraints

 

SYNOPSIS

runc update [option ...] containe-id

runc update -r resources.json|- containe-id

 

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

-resources|-r resources.json

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

-blki-weight weight

Set a new io weight.

-cp-period num

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

-cp-quota num

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

-cp-burst num

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

-cp-r-period num

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

-cp-r-runtime num

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

-cp-share num

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

-cpuse-cpus list

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

-cpuse-mems list

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

-memory num

Set memory limit to num bytes.

-memor-reservation num

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

-memor-swap num

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

-pid-limit num

Set the maximum number of processes allowed in the container.

-l-cach-schema value

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

-me-b-schema value

Set the Intel RDT/MBA memory bandwidth schema.

 

SEE ALSO

runc(8).

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

SEE ALSO