github.com/opencontainers/runc@v1.2.0-rc.1.0.20240520010911-492dc558cdd6/man/runc-update.8.md (about)

     1  % runc-update "8"
     2  
     3  # NAME
     4  **runc-update** - update running container resource constraints
     5  
     6  # SYNOPSIS
     7  **runc update** [_option_ ...] _container-id_
     8  
     9  **runc update** **-r** _resources.json_|**-**  _container-id_
    10  
    11  # DESCRIPTION
    12  The **update** command change the resource constraints of a running container
    13  instance.
    14  
    15  The resources can be set using options, or, if **-r** is used, parsed from JSON
    16  provided as a file or from stdin.
    17  
    18  In case **-r** is used, the JSON format is like this:
    19  
    20  	{
    21  		"memory": {
    22  			"limit": 0,
    23  				"reservation": 0,
    24  				"swap": 0,
    25  				"kernel": 0,
    26  				"kernelTCP": 0
    27  		},
    28  			"cpu": {
    29  				"shares": 0,
    30  				"quota": 0,
    31  				"burst": 0,
    32  				"period": 0,
    33  				"realtimeRuntime": 0,
    34  				"realtimePeriod": 0,
    35  				"cpus": "",
    36  				"mems": ""
    37  			},
    38  			"blockIO": {
    39  				"blkioWeight": 0
    40  			}
    41  	}
    42  
    43  # OPTIONS
    44  **--resources**|**-r** _resources.json_
    45  : Read the new resource limits from _resources.json_. Use **-** to read from
    46  stdin. If this option is used, all other options are ignored.
    47  
    48  **--blkio-weight** _weight_
    49  : Set a new io weight.
    50  
    51  **--cpu-period** _num_
    52  : Set CPU CFS period to be used for hardcapping (in microseconds)
    53  
    54  **--cpu-quota** _num_
    55  : Set CPU usage limit within a given period (in microseconds).
    56  
    57  **--cpu-burst** _num_
    58  : Set CPU burst limit within a given period (in microseconds).
    59  
    60  **--cpu-rt-period** _num_
    61  : Set CPU realtime period to be used for hardcapping (in microseconds).
    62  
    63  **--cpu-rt-runtime** _num_
    64  : Set CPU realtime hardcap limit (in usecs). Allowed cpu time in a given period.
    65  
    66  **--cpu-share** _num_
    67  : Set CPU shares (relative weight vs. other containers).
    68  
    69  **--cpuset-cpus** _list_
    70  : Set CPU(s) to use. The _list_ can contain commas and ranges. For example:
    71  **0-3,7**.
    72  
    73  **--cpuset-mems** _list_
    74  : Set memory node(s) to use. The _list_ format is the same as for
    75  **--cpuset-cpus**.
    76  
    77  **--memory** _num_
    78  : Set memory limit to _num_ bytes.
    79  
    80  **--memory-reservation** _num_
    81  : Set memory reservation, or soft limit, to _num_ bytes.
    82  
    83  **--memory-swap** _num_
    84  : Set total memory + swap usage to _num_ bytes. Use **-1** to unset the limit
    85  (i.e. use unlimited swap).
    86  
    87  **--pids-limit** _num_
    88  : Set the maximum number of processes allowed in the container.
    89  
    90  **--l3-cache-schema** _value_
    91  : Set the value for Intel RDT/CAT L3 cache schema.
    92  
    93  **--mem-bw-schema** _value_
    94  : Set the Intel RDT/MBA memory bandwidth schema.
    95  
    96  # SEE ALSO
    97  
    98  **runc**(8).