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



NAME
       runc-update - update running container resource constraints



SYNOPSIS
       runc update [option ...] container-id


       runc update -r resources.json|-  container-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,
                      "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.


       --blkio-weight weight
              Set a new io weight.


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


       --cpu-quota num
              Set CPU usage limit within a given period (in microseconds).


       --cpu-rt-period num
              Set CPU realtime period to be used for hardcapping (in
              microseconds).


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


       --cpu-share num
              Set CPU shares (relative weight vs. other containers).


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


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


       --memory num
              Set memory limit to num bytes.


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


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


       --pids-limit num
              Set the maximum number of processes allowed in the container.


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


       --mem-bw-schema value
              Set the Intel RDT/MBA memory bandwidth schema.



SEE ALSO
       runc(8).

                                                                runc-update(8)