From 4e7f60c22018b712dc9ed021ac0e3c5e47606444 Mon Sep 17 00:00:00 2001 From: Thomas Lamprecht Date: Mon, 14 Nov 2022 14:26:34 +0100 Subject: [PATCH] update static/schema information Signed-off-by: Thomas Lamprecht --- api-viewer/apidata.js | 387 +++++++++++++++++++++++++++++----------- pct.1-synopsis.adoc | 48 +++-- pct.conf.5-opts.adoc | 14 +- qm.1-synopsis.adoc | 278 +++++++++++++++++------------ qm.conf.5-opts.adoc | 14 +- vzdump.1-synopsis.adoc | 6 +- vzdump.conf.5-opts.adoc | 10 +- 7 files changed, 500 insertions(+), 257 deletions(-) diff --git a/api-viewer/apidata.js b/api-viewer/apidata.js index 1d4f7a3..63c38da 100644 --- a/api-viewer/apidata.js +++ b/api-viewer/apidata.js @@ -3694,12 +3694,20 @@ const apiSchema = [ "typetext" : "" }, "notes-template" : { - "description" : "Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are {{cluster}}, {{guestname}}, {{node}}, and {{vmid}}, but more might be added in the future.", + "description" : "Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are {{cluster}}, {{guestname}}, {{node}}, and {{vmid}}, but more might be added in the future. Needs to be a single line, newline and backslash need to be escaped as '\\n' and '\\\\' respectively.", + "maxLength" : 1024, "optional" : 1, "requires" : "storage", "type" : "string", "typetext" : "" }, + "performance" : { + "description" : "Other performance-related settings.", + "format" : "backup-performance", + "optional" : 1, + "type" : "string", + "typetext" : "[max-workers=]" + }, "pigz" : { "default" : 0, "description" : "Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread count.", @@ -4026,12 +4034,20 @@ const apiSchema = [ "typetext" : "" }, "notes-template" : { - "description" : "Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are {{cluster}}, {{guestname}}, {{node}}, and {{vmid}}, but more might be added in the future.", + "description" : "Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are {{cluster}}, {{guestname}}, {{node}}, and {{vmid}}, but more might be added in the future. Needs to be a single line, newline and backslash need to be escaped as '\\n' and '\\\\' respectively.", + "maxLength" : 1024, "optional" : 1, "requires" : "storage", "type" : "string", "typetext" : "" }, + "performance" : { + "description" : "Other performance-related settings.", + "format" : "backup-performance", + "optional" : 1, + "type" : "string", + "typetext" : "[max-workers=]" + }, "pigz" : { "default" : 0, "description" : "Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread count.", @@ -8426,15 +8442,17 @@ const apiSchema = [ }, "cpu" : { "description" : "CPU utilization (when type in node,qemu,lxc).", + "minimum" : 0, "optional" : 1, "renderer" : "fraction_as_percentage", "type" : "number" }, "disk" : { "description" : "Used disk space in bytes (when type in storage), used root image spave for VMs (type in qemu,lxc).", + "minimum" : 0, "optional" : 1, "renderer" : "bytes", - "type" : "string" + "type" : "integer" }, "hastate" : { "description" : "HA service status (for HA managed VMs).", @@ -8451,11 +8469,13 @@ const apiSchema = [ }, "maxcpu" : { "description" : "Number of available CPUs (when type in node,qemu,lxc).", + "minimum" : 0, "optional" : 1, "type" : "number" }, "maxdisk" : { "description" : "Storage size in bytes (when type in storage), root image size for VMs (type in qemu,lxc).", + "minimum" : 0, "optional" : 1, "renderer" : "bytes", "type" : "integer" @@ -8468,9 +8488,10 @@ const apiSchema = [ }, "mem" : { "description" : "Used memory in bytes (when type in node,qemu,lxc).", + "minimum" : 0, "optional" : 1, "renderer" : "bytes", - "type" : "string" + "type" : "integer" }, "name" : { "description" : "Name of the resource.", @@ -8522,6 +8543,12 @@ const apiSchema = [ "optional" : 1, "renderer" : "duration", "type" : "integer" + }, + "vmid" : { + "description" : "The numerical vmid (when type in qemu,lxc).", + "minimum" : 1, + "optional" : 1, + "type" : "integer" } }, "type" : "object" @@ -12475,6 +12502,12 @@ const apiSchema = [ "optional" : 1, "type" : "boolean" }, + "affinity" : { + "description" : "List of host cores used to execute guest processes.", + "format" : "pve-cpuset", + "optional" : 1, + "type" : "string" + }, "agent" : { "description" : "Enable/disable communication with the Qemu Guest Agent and its properties.", "format" : { @@ -12728,7 +12761,7 @@ const apiSchema = [ }, "hotplug" : { "default" : "network,disk,usb", - "description" : "Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`.", + "description" : "Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory', 'usb' and 'cloudinit'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. USB hotplugging is possible for guests with machine version >= 7.1 and ostype l26 or windows > 7.", "format" : "pve-hotplug-features", "optional" : 1, "type" : "string" @@ -14291,7 +14324,7 @@ const apiSchema = [ "type" : "string" }, "usb[n]" : { - "description" : "Configure an USB device (n is 0 to 4).", + "description" : "Configure an USB device (n is 0 to 4, for machine version >= 7.1 and ostype l26 or windows > 7, n can be up to 14).", "format" : { "host" : { "default_key" : 1, @@ -14302,7 +14335,7 @@ const apiSchema = [ }, "usb3" : { "default" : 0, - "description" : "Specifies whether if given host option is a USB3 device or port.", + "description" : "Specifies whether if given host option is a USB3 device or port. For modern guests (machine version >= 7.1 and ostype l26 and windows > 7), this flag is irrelevant (all devices are plugged into a xhci controller).", "optional" : 1, "type" : "boolean" } @@ -14711,6 +14744,13 @@ const apiSchema = [ "type" : "boolean", "typetext" : "" }, + "affinity" : { + "description" : "List of host cores used to execute guest processes.", + "format" : "pve-cpuset", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "agent" : { "description" : "Enable/disable communication with the Qemu Guest Agent and its properties.", "format" : { @@ -15014,7 +15054,7 @@ const apiSchema = [ }, "hotplug" : { "default" : "network,disk,usb", - "description" : "Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`.", + "description" : "Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory', 'usb' and 'cloudinit'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. USB hotplugging is possible for guests with machine version >= 7.1 and ostype l26 or windows > 7.", "format" : "pve-hotplug-features", "optional" : 1, "type" : "string", @@ -16658,7 +16698,7 @@ const apiSchema = [ "typetext" : "[file=]" }, "usb[n]" : { - "description" : "Configure an USB device (n is 0 to 4).", + "description" : "Configure an USB device (n is 0 to 4, for machine version >= 7.1 and ostype l26 or windows > 7, n can be up to 14).", "format" : { "host" : { "default_key" : 1, @@ -16669,7 +16709,7 @@ const apiSchema = [ }, "usb3" : { "default" : 0, - "description" : "Specifies whether if given host option is a USB3 device or port.", + "description" : "Specifies whether if given host option is a USB3 device or port. For modern guests (machine version >= 7.1 and ostype l26 and windows > 7), this flag is irrelevant (all devices are plugged into a xhci controller).", "optional" : 1, "type" : "boolean" } @@ -17121,6 +17161,13 @@ const apiSchema = [ "type" : "boolean", "typetext" : "" }, + "affinity" : { + "description" : "List of host cores used to execute guest processes.", + "format" : "pve-cpuset", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "agent" : { "description" : "Enable/disable communication with the Qemu Guest Agent and its properties.", "format" : { @@ -17416,7 +17463,7 @@ const apiSchema = [ }, "hotplug" : { "default" : "network,disk,usb", - "description" : "Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`.", + "description" : "Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory', 'usb' and 'cloudinit'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. USB hotplugging is possible for guests with machine version >= 7.1 and ostype l26 or windows > 7.", "format" : "pve-hotplug-features", "optional" : 1, "type" : "string", @@ -19060,7 +19107,7 @@ const apiSchema = [ "typetext" : "[file=]" }, "usb[n]" : { - "description" : "Configure an USB device (n is 0 to 4).", + "description" : "Configure an USB device (n is 0 to 4, for machine version >= 7.1 and ostype l26 or windows > 7, n can be up to 14).", "format" : { "host" : { "default_key" : 1, @@ -19071,7 +19118,7 @@ const apiSchema = [ }, "usb3" : { "default" : 0, - "description" : "Specifies whether if given host option is a USB3 device or port.", + "description" : "Specifies whether if given host option is a USB3 device or port. For modern guests (machine version >= 7.1 and ostype l26 and windows > 7), this flag is irrelevant (all devices are plugged into a xhci controller).", "optional" : 1, "type" : "boolean" } @@ -19582,6 +19629,167 @@ const apiSchema = [ "path" : "/nodes/{node}/qemu/{vmid}/pending", "text" : "pending" }, + { + "children" : [ + { + "info" : { + "GET" : { + "allowtoken" : 1, + "description" : "Get automatically generated cloudinit config.", + "method" : "GET", + "name" : "cloudinit_generated_config_dump", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "node" : { + "description" : "The cluster node name.", + "format" : "pve-node", + "type" : "string", + "typetext" : "" + }, + "type" : { + "description" : "Config type.", + "enum" : [ + "user", + "network", + "meta" + ], + "type" : "string" + }, + "vmid" : { + "description" : "The (unique) ID of the VM.", + "format" : "pve-vmid", + "minimum" : 1, + "type" : "integer", + "typetext" : " (1 - N)" + } + } + }, + "permissions" : { + "check" : [ + "perm", + "/vms/{vmid}", + [ + "VM.Audit" + ] + ] + }, + "proxyto" : "node", + "returns" : { + "type" : "string" + } + } + }, + "leaf" : 1, + "path" : "/nodes/{node}/qemu/{vmid}/cloudinit/dump", + "text" : "dump" + } + ], + "info" : { + "GET" : { + "allowtoken" : 1, + "description" : "Get the cloudinit configuration with both current and pending values.", + "method" : "GET", + "name" : "cloudinit_pending", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "node" : { + "description" : "The cluster node name.", + "format" : "pve-node", + "type" : "string", + "typetext" : "" + }, + "vmid" : { + "description" : "The (unique) ID of the VM.", + "format" : "pve-vmid", + "minimum" : 1, + "type" : "integer", + "typetext" : " (1 - N)" + } + } + }, + "permissions" : { + "check" : [ + "perm", + "/vms/{vmid}", + [ + "VM.Audit" + ] + ] + }, + "proxyto" : "node", + "returns" : { + "items" : { + "properties" : { + "delete" : { + "description" : "Indicates a pending delete request if present and not 0. The value 2 indicates a force-delete request.", + "maximum" : 2, + "minimum" : 0, + "optional" : 1, + "type" : "integer" + }, + "key" : { + "description" : "Configuration option name.", + "type" : "string" + }, + "pending" : { + "description" : "Pending value.", + "optional" : 1, + "type" : "string" + }, + "value" : { + "description" : "Current value.", + "optional" : 1, + "type" : "string" + } + }, + "type" : "object" + }, + "type" : "array" + } + }, + "PUT" : { + "allowtoken" : 1, + "description" : "Regenerate and change cloudinit config drive.", + "method" : "PUT", + "name" : "cloudinit_update", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "node" : { + "description" : "The cluster node name.", + "format" : "pve-node", + "type" : "string", + "typetext" : "" + }, + "vmid" : { + "description" : "The (unique) ID of the VM.", + "format" : "pve-vmid", + "minimum" : 1, + "type" : "integer", + "typetext" : " (1 - N)" + } + } + }, + "permissions" : { + "check" : [ + "perm", + "/vms/{vmid}", + "VM.Config.Cloudinit" + ] + }, + "protected" : 1, + "proxyto" : "node", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 0, + "path" : "/nodes/{node}/qemu/{vmid}/cloudinit", + "text" : "cloudinit" + }, { "info" : { "PUT" : { @@ -22080,6 +22288,13 @@ const apiSchema = [ "type" : "string", "typetext" : "" }, + "start" : { + "default" : 0, + "description" : "Whether the VM should get started after rolling back successfully", + "optional" : 1, + "type" : "boolean", + "typetext" : "" + }, "vmid" : { "description" : "The (unique) ID of the VM.", "format" : "pve-vmid", @@ -22469,66 +22684,6 @@ const apiSchema = [ "leaf" : 1, "path" : "/nodes/{node}/qemu/{vmid}/template", "text" : "template" - }, - { - "children" : [ - { - "info" : { - "GET" : { - "allowtoken" : 1, - "description" : "Get automatically generated cloudinit config.", - "method" : "GET", - "name" : "cloudinit_generated_config_dump", - "parameters" : { - "additionalProperties" : 0, - "properties" : { - "node" : { - "description" : "The cluster node name.", - "format" : "pve-node", - "type" : "string", - "typetext" : "" - }, - "type" : { - "description" : "Config type.", - "enum" : [ - "user", - "network", - "meta" - ], - "type" : "string" - }, - "vmid" : { - "description" : "The (unique) ID of the VM.", - "format" : "pve-vmid", - "minimum" : 1, - "type" : "integer", - "typetext" : " (1 - N)" - } - } - }, - "permissions" : { - "check" : [ - "perm", - "/vms/{vmid}", - [ - "VM.Audit" - ] - ] - }, - "proxyto" : "node", - "returns" : { - "type" : "string" - } - } - }, - "leaf" : 1, - "path" : "/nodes/{node}/qemu/{vmid}/cloudinit/dump", - "text" : "dump" - } - ], - "leaf" : 0, - "path" : "/nodes/{node}/qemu/{vmid}/cloudinit", - "text" : "cloudinit" } ], "info" : { @@ -22771,6 +22926,13 @@ const apiSchema = [ "type" : "boolean", "typetext" : "" }, + "affinity" : { + "description" : "List of host cores used to execute guest processes.", + "format" : "pve-cpuset", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "agent" : { "description" : "Enable/disable communication with the Qemu Guest Agent and its properties.", "format" : { @@ -23067,7 +23229,7 @@ const apiSchema = [ }, "hotplug" : { "default" : "network,disk,usb", - "description" : "Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`.", + "description" : "Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory', 'usb' and 'cloudinit'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. USB hotplugging is possible for guests with machine version >= 7.1 and ostype l26 or windows > 7.", "format" : "pve-hotplug-features", "optional" : 1, "type" : "string", @@ -24733,7 +24895,7 @@ const apiSchema = [ "typetext" : "[file=]" }, "usb[n]" : { - "description" : "Configure an USB device (n is 0 to 4).", + "description" : "Configure an USB device (n is 0 to 4, for machine version >= 7.1 and ostype l26 or windows > 7, n can be up to 14).", "format" : { "host" : { "default_key" : 1, @@ -24744,7 +24906,7 @@ const apiSchema = [ }, "usb3" : { "default" : 0, - "description" : "Specifies whether if given host option is a USB3 device or port.", + "description" : "Specifies whether if given host option is a USB3 device or port. For modern guests (machine version >= 7.1 and ostype l26 and windows > 7), this flag is irrelevant (all devices are plugged into a xhci controller).", "optional" : 1, "type" : "boolean" } @@ -25272,12 +25434,13 @@ const apiSchema = [ "type" : "number" }, "cpuunits" : { - "default" : 1024, - "description" : "CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to the weights of all the other running VMs.\n\nNOTE: You can disable fair-scheduler configuration by setting this to 0.", + "default" : "cgroup v1: 1024, cgroup v2: 100", + "description" : "CPU weight for a container, will be clamped to [1, 10000] in cgroup v2.", "maximum" : 500000, "minimum" : 0, "optional" : 1, - "type" : "integer" + "type" : "integer", + "verbose_description" : "CPU weight for a container. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this container gets. Number is relative to the weights of all the other running guests." }, "debug" : { "default" : 0, @@ -25353,7 +25516,7 @@ const apiSchema = [ "type" : "string" }, "lock" : { - "description" : "Lock/unlock the VM.", + "description" : "Lock/unlock the container.", "enum" : [ "backup", "create", @@ -25382,7 +25545,7 @@ const apiSchema = [ }, "memory" : { "default" : 512, - "description" : "Amount of RAM for the VM in MB.", + "description" : "Amount of RAM for the container in MB.", "minimum" : 16, "optional" : 1, "type" : "integer" @@ -25559,7 +25722,7 @@ const apiSchema = [ }, "onboot" : { "default" : 0, - "description" : "Specifies whether a VM will be started during system bootup.", + "description" : "Specifies whether a container will be started during system bootup.", "optional" : 1, "type" : "boolean" }, @@ -25658,7 +25821,7 @@ const apiSchema = [ }, "swap" : { "default" : 512, - "description" : "Amount of SWAP for the VM in MB.", + "description" : "Amount of SWAP for the container in MB.", "minimum" : 0, "optional" : 1, "type" : "integer" @@ -25769,13 +25932,14 @@ const apiSchema = [ "typetext" : " (0 - 8192)" }, "cpuunits" : { - "default" : 1024, - "description" : "CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to the weights of all the other running VMs.\n\nNOTE: You can disable fair-scheduler configuration by setting this to 0.", + "default" : "cgroup v1: 1024, cgroup v2: 100", + "description" : "CPU weight for a container, will be clamped to [1, 10000] in cgroup v2.", "maximum" : 500000, "minimum" : 0, "optional" : 1, "type" : "integer", - "typetext" : " (0 - 500000)" + "typetext" : " (0 - 500000)", + "verbose_description" : "CPU weight for a container. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this container gets. Number is relative to the weights of all the other running guests." }, "debug" : { "default" : 0, @@ -25866,7 +26030,7 @@ const apiSchema = [ "typetext" : "" }, "lock" : { - "description" : "Lock/unlock the VM.", + "description" : "Lock/unlock the container.", "enum" : [ "backup", "create", @@ -25884,7 +26048,7 @@ const apiSchema = [ }, "memory" : { "default" : 512, - "description" : "Amount of RAM for the VM in MB.", + "description" : "Amount of RAM for the container in MB.", "minimum" : 16, "optional" : 1, "type" : "integer", @@ -26071,7 +26235,7 @@ const apiSchema = [ }, "onboot" : { "default" : 0, - "description" : "Specifies whether a VM will be started during system bootup.", + "description" : "Specifies whether a container will be started during system bootup.", "optional" : 1, "type" : "boolean", "typetext" : "" @@ -26181,7 +26345,7 @@ const apiSchema = [ }, "swap" : { "default" : 512, - "description" : "Amount of SWAP for the VM in MB.", + "description" : "Amount of SWAP for the container in MB.", "minimum" : 0, "optional" : 1, "type" : "integer", @@ -26776,6 +26940,13 @@ const apiSchema = [ "type" : "string", "typetext" : "" }, + "start" : { + "default" : 0, + "description" : "Whether the container should get started after rolling back successfully", + "optional" : 1, + "type" : "boolean", + "typetext" : "" + }, "vmid" : { "description" : "The (unique) ID of the VM.", "format" : "pve-vmid", @@ -31519,13 +31690,14 @@ const apiSchema = [ "typetext" : " (0 - 8192)" }, "cpuunits" : { - "default" : 1024, - "description" : "CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to the weights of all the other running VMs.\n\nNOTE: You can disable fair-scheduler configuration by setting this to 0.", + "default" : "cgroup v1: 1024, cgroup v2: 100", + "description" : "CPU weight for a container, will be clamped to [1, 10000] in cgroup v2.", "maximum" : 500000, "minimum" : 0, "optional" : 1, "type" : "integer", - "typetext" : " (0 - 500000)" + "typetext" : " (0 - 500000)", + "verbose_description" : "CPU weight for a container. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this container gets. Number is relative to the weights of all the other running guests." }, "debug" : { "default" : 0, @@ -31614,7 +31786,7 @@ const apiSchema = [ "typetext" : "" }, "lock" : { - "description" : "Lock/unlock the VM.", + "description" : "Lock/unlock the container.", "enum" : [ "backup", "create", @@ -31632,7 +31804,7 @@ const apiSchema = [ }, "memory" : { "default" : 512, - "description" : "Amount of RAM for the VM in MB.", + "description" : "Amount of RAM for the container in MB.", "minimum" : 16, "optional" : 1, "type" : "integer", @@ -31819,7 +31991,7 @@ const apiSchema = [ }, "onboot" : { "default" : 0, - "description" : "Specifies whether a VM will be started during system bootup.", + "description" : "Specifies whether a container will be started during system bootup.", "optional" : 1, "type" : "boolean", "typetext" : "" @@ -31969,7 +32141,7 @@ const apiSchema = [ }, "swap" : { "default" : 512, - "description" : "Amount of SWAP for the VM in MB.", + "description" : "Amount of SWAP for the container in MB.", "minimum" : 0, "optional" : 1, "type" : "integer", @@ -34318,11 +34490,18 @@ const apiSchema = [ "type" : "string" }, "notes-template" : { - "description" : "Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are {{cluster}}, {{guestname}}, {{node}}, and {{vmid}}, but more might be added in the future.", + "description" : "Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are {{cluster}}, {{guestname}}, {{node}}, and {{vmid}}, but more might be added in the future. Needs to be a single line, newline and backslash need to be escaped as '\\n' and '\\\\' respectively.", + "maxLength" : 1024, "optional" : 1, "requires" : "storage", "type" : "string" }, + "performance" : { + "description" : "Other performance-related settings.", + "format" : "backup-performance", + "optional" : 1, + "type" : "string" + }, "pigz" : { "default" : 0, "description" : "Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread count.", @@ -34571,12 +34750,20 @@ const apiSchema = [ "typetext" : "" }, "notes-template" : { - "description" : "Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are {{cluster}}, {{guestname}}, {{node}}, and {{vmid}}, but more might be added in the future.", + "description" : "Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are {{cluster}}, {{guestname}}, {{node}}, and {{vmid}}, but more might be added in the future. Needs to be a single line, newline and backslash need to be escaped as '\\n' and '\\\\' respectively.", + "maxLength" : 1024, "optional" : 1, "requires" : "storage", "type" : "string", "typetext" : "" }, + "performance" : { + "description" : "Other performance-related settings.", + "format" : "backup-performance", + "optional" : 1, + "type" : "string", + "typetext" : "[max-workers=]" + }, "pigz" : { "default" : 0, "description" : "Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread count.", @@ -34683,7 +34870,7 @@ const apiSchema = [ } }, "permissions" : { - "description" : "The user needs 'VM.Backup' permissions on any VM, and 'Datastore.AllocateSpace' on the backup storage. The 'maxfiles', 'prune-backups', 'tmpdir', 'dumpdir', 'script', 'bwlimit' and 'ionice' parameters are restricted to the 'root@pam' user.", + "description" : "The user needs 'VM.Backup' permissions on any VM, and 'Datastore.AllocateSpace' on the backup storage. The 'maxfiles', 'prune-backups', 'tmpdir', 'dumpdir', 'script', 'bwlimit', 'performance' and 'ionice' parameters are restricted to the 'root@pam' user.", "user" : "all" }, "protected" : 1, diff --git a/pct.1-synopsis.adoc b/pct.1-synopsis.adoc index 4c82a59..e8a4846 100644 --- a/pct.1-synopsis.adoc +++ b/pct.1-synopsis.adoc @@ -114,11 +114,9 @@ Limit of CPU usage. + NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit. -`--cpuunits` ` (0 - 500000)` ('default =' `1024`):: +`--cpuunits` ` (0 - 500000)` ('default =' `cgroup v1: 1024, cgroup v2: 100`):: -CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to the weights of all the other running VMs. -+ -NOTE: You can disable fair-scheduler configuration by setting this to 0. +CPU weight for a container, will be clamped to [1, 10000] in cgroup v2. `--debug` `` ('default =' `0`):: @@ -150,11 +148,11 @@ Ignore errors when extracting the template. `--lock` `` :: -Lock/unlock the VM. +Lock/unlock the container. `--memory` ` (16 - N)` ('default =' `512`):: -Amount of RAM for the VM in MB. +Amount of RAM for the container in MB. `--mp[n]` `[volume=] ,mp= [,acl=<1|0>] [,backup=<1|0>] [,mountoptions=] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=]` :: @@ -170,7 +168,7 @@ Specifies network interfaces for the container. `--onboot` `` ('default =' `0`):: -Specifies whether a VM will be started during system bootup. +Specifies whether a container will be started during system bootup. `--ostype` `` :: @@ -218,7 +216,7 @@ Default Storage. `--swap` ` (0 - N)` ('default =' `512`):: -Amount of SWAP for the VM in MB. +Amount of SWAP for the container in MB. `--tags` `` :: @@ -603,11 +601,9 @@ Limit of CPU usage. + NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit. -`--cpuunits` ` (0 - 500000)` ('default =' `1024`):: +`--cpuunits` ` (0 - 500000)` ('default =' `cgroup v1: 1024, cgroup v2: 100`):: -CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to the weights of all the other running VMs. -+ -NOTE: You can disable fair-scheduler configuration by setting this to 0. +CPU weight for a container, will be clamped to [1, 10000] in cgroup v2. `--debug` `` ('default =' `0`):: @@ -639,11 +635,11 @@ Ignore errors when extracting the template. `--lock` `` :: -Lock/unlock the VM. +Lock/unlock the container. `--memory` ` (16 - N)` ('default =' `512`):: -Amount of RAM for the VM in MB. +Amount of RAM for the container in MB. `--mp[n]` `[volume=] ,mp= [,acl=<1|0>] [,backup=<1|0>] [,mountoptions=] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=]` :: @@ -659,7 +655,7 @@ Specifies network interfaces for the container. `--onboot` `` ('default =' `0`):: -Specifies whether a VM will be started during system bootup. +Specifies whether a container will be started during system bootup. `--ostype` `` :: @@ -703,7 +699,7 @@ Default Storage. `--swap` ` (0 - N)` ('default =' `512`):: -Amount of SWAP for the VM in MB. +Amount of SWAP for the container in MB. `--tags` `` :: @@ -743,7 +739,7 @@ Resume the container. The (unique) ID of the VM. -*pct rollback* ` ` +*pct rollback* ` ` `[OPTIONS]` Rollback LXC state to specified snapshot. @@ -755,6 +751,10 @@ The (unique) ID of the VM. The name of the snapshot. +`--start` `` ('default =' `0`):: + +Whether the container should get started after rolling back successfully + *pct set* `` `[OPTIONS]` Set container options. @@ -785,11 +785,9 @@ Limit of CPU usage. + NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit. -`--cpuunits` ` (0 - 500000)` ('default =' `1024`):: +`--cpuunits` ` (0 - 500000)` ('default =' `cgroup v1: 1024, cgroup v2: 100`):: -CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to the weights of all the other running VMs. -+ -NOTE: You can disable fair-scheduler configuration by setting this to 0. +CPU weight for a container, will be clamped to [1, 10000] in cgroup v2. `--debug` `` ('default =' `0`):: @@ -821,11 +819,11 @@ Set a host name for the container. `--lock` `` :: -Lock/unlock the VM. +Lock/unlock the container. `--memory` ` (16 - N)` ('default =' `512`):: -Amount of RAM for the VM in MB. +Amount of RAM for the container in MB. `--mp[n]` `[volume=] ,mp= [,acl=<1|0>] [,backup=<1|0>] [,mountoptions=] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=]` :: @@ -841,7 +839,7 @@ Specifies network interfaces for the container. `--onboot` `` ('default =' `0`):: -Specifies whether a VM will be started during system bootup. +Specifies whether a container will be started during system bootup. `--ostype` `` :: @@ -869,7 +867,7 @@ Startup and shutdown behavior. Order is a non-negative number defining the gener `--swap` ` (0 - N)` ('default =' `512`):: -Amount of SWAP for the VM in MB. +Amount of SWAP for the container in MB. `--tags` `` :: diff --git a/pct.conf.5-opts.adoc b/pct.conf.5-opts.adoc index c9a4fa3..cf52b5e 100644 --- a/pct.conf.5-opts.adoc +++ b/pct.conf.5-opts.adoc @@ -20,11 +20,9 @@ Limit of CPU usage. + NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit. -`cpuunits`: ` (0 - 500000)` ('default =' `1024`):: +`cpuunits`: ` (0 - 500000)` ('default =' `cgroup v1: 1024, cgroup v2: 100`):: -CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to the weights of all the other running VMs. -+ -NOTE: You can disable fair-scheduler configuration by setting this to 0. +CPU weight for a container. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this container gets. Number is relative to the weights of all the other running guests. `debug`: `` ('default =' `0`):: @@ -72,11 +70,11 @@ Set a host name for the container. `lock`: `` :: -Lock/unlock the VM. +Lock/unlock the container. `memory`: ` (16 - N)` ('default =' `512`):: -Amount of RAM for the VM in MB. +Amount of RAM for the container in MB. `mp[n]`: `[volume=] ,mp= [,acl=<1|0>] [,backup=<1|0>] [,mountoptions=] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=]` :: @@ -188,7 +186,7 @@ Network interface type. `onboot`: `` ('default =' `0`):: -Specifies whether a VM will be started during system bootup. +Specifies whether a container will be started during system bootup. `ostype`: `` :: @@ -246,7 +244,7 @@ Startup and shutdown behavior. Order is a non-negative number defining the gener `swap`: ` (0 - N)` ('default =' `512`):: -Amount of SWAP for the VM in MB. +Amount of SWAP for the container in MB. `tags`: `` :: diff --git a/qm.1-synopsis.adoc b/qm.1-synopsis.adoc index 3e59547..b9189d1 100644 --- a/qm.1-synopsis.adoc +++ b/qm.1-synopsis.adoc @@ -81,6 +81,22 @@ The (unique) ID of the VM. Config type. +*qm cloudinit pending* `` + +Get the cloudinit configuration with both current and pending values. + +``: ` (1 - N)` :: + +The (unique) ID of the VM. + +*qm cloudinit update* `` + +Regenerate and change cloudinit config drive. + +``: ` (1 - N)` :: + +The (unique) ID of the VM. + *qm config* `` `[OPTIONS]` Get the virtual machine configuration with pending configuration changes @@ -111,6 +127,10 @@ The (unique) ID of the VM. Enable/disable ACPI. +`--affinity` `` :: + +List of host cores used to execute guest processes. + `--agent` `[enabled=]<1|0> [,fstrim_cloned_disks=<1|0>] [,type=]` :: Enable/disable communication with the Qemu Guest Agent and its properties. @@ -219,7 +239,7 @@ Map host PCI devices into guest. `--hotplug` `` ('default =' `network,disk,usb`):: -Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. +Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory', 'usb' and 'cloudinit'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. USB hotplugging is possible for guests with machine version >= 7.1 and ostype l26 or windows > 7. `--hugepages` `<1024 | 2 | any>` :: @@ -429,7 +449,7 @@ Reference to unused volumes. This is used internally, and should not be modified `--usb[n]` `[host=] [,usb3=<1|0>]` :: -Configure an USB device (n is 0 to 4). +Configure an USB device (n is 0 to 4, for machine version >= 7.1 and ostype l26 or windows > 7, n can be up to 14). `--vcpus` ` (1 - N)` ('default =' `0`):: @@ -492,6 +512,125 @@ Remove VMID from configurations, like backup & replication jobs and HA. Ignore locks - only root is allowed to use this option. +*qm disk import* ` ` `[OPTIONS]` + +Import an external disk image as an unused disk in a VM. The + image format has to be supported by qemu-img(1). + +``: ` (1 - N)` :: + +The (unique) ID of the VM. + +``: `` :: + +Path to the disk image to import + +``: `` :: + +Target storage ID + +`--format` `` :: + +Target format + +*qm disk move* ` []` `[OPTIONS]` + +Move volume to different storage or to a different VM. + +``: ` (1 - N)` :: + +The (unique) ID of the VM. + +``: `` :: + +The disk you want to move. + +``: `` :: + +Target storage. + +`--bwlimit` ` (0 - N)` ('default =' `move limit from datacenter or storage config`):: + +Override I/O bandwidth limit (in KiB/s). + +`--delete` `` ('default =' `0`):: + +Delete the original disk after successful copy. By default the original disk is kept as unused disk. + +`--digest` `` :: + +Prevent changes if current configuration file has different SHA1" + ." digest. This can be used to prevent concurrent modifications. + +`--format` `` :: + +Target Format. + +`--target-digest` `` :: + +Prevent changes if the current config file of the target VM has a" + ." different SHA1 digest. This can be used to detect concurrent modifications. + +`--target-disk` `` :: + +The config key the disk will be moved to on the target VM (for example, ide0 or scsi1). Default is the source disk key. + +`--target-vmid` ` (1 - N)` :: + +The (unique) ID of the VM. + +*qm disk rescan* `[OPTIONS]` + +Rescan all storages and update disk sizes and unused disk images. + +`--dryrun` `` ('default =' `0`):: + +Do not actually write changes out to VM config(s). + +`--vmid` ` (1 - N)` :: + +The (unique) ID of the VM. + +*qm disk resize* ` ` `[OPTIONS]` + +Extend volume size. + +``: ` (1 - N)` :: + +The (unique) ID of the VM. + +``: `` :: + +The disk you want to resize. + +``: `\+?\d+(\.\d+)?[KMGT]?` :: + +The new size. With the `+` sign the value is added to the actual size of the volume and without it, the value is taken as an absolute one. Shrinking disk size is not supported. + +`--digest` `` :: + +Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications. + +`--skiplock` `` :: + +Ignore locks - only root is allowed to use this option. + +*qm disk unlink* ` --idlist ` `[OPTIONS]` + +Unlink/delete disk images. + +``: ` (1 - N)` :: + +The (unique) ID of the VM. + +`--force` `` :: + +Force physical removal. Without this, we simple remove the disk from the config file and create an additional configuration entry called 'unused[n]', which contains the volume ID. Unlink of unused[n] always cause physical removal. + +`--idlist` `` :: + +A list of disk IDs you want to delete. + *qm guest cmd* ` ` Execute Qemu Guest Agent commands. @@ -568,26 +707,9 @@ Shows help for a specific command Verbose output format. -*qm importdisk* ` ` `[OPTIONS]` - -Import an external disk image as an unused disk in a VM. The - image format has to be supported by qemu-img(1). - -``: ` (1 - N)` :: - -The (unique) ID of the VM. - -``: `` :: - -Path to the disk image to import - -``: `` :: +*qm importdisk* -Target storage ID - -`--format` `` :: - -Target format +An alias for 'qm disk import'. *qm importovf* ` ` `[OPTIONS]` @@ -677,55 +799,13 @@ Enter Qemu Monitor interface. The (unique) ID of the VM. -*qm move-disk* ` []` `[OPTIONS]` - -Move volume to different storage or to a different VM. - -``: ` (1 - N)` :: - -The (unique) ID of the VM. - -``: `` :: - -The disk you want to move. - -``: `` :: - -Target storage. - -`--bwlimit` ` (0 - N)` ('default =' `move limit from datacenter or storage config`):: - -Override I/O bandwidth limit (in KiB/s). - -`--delete` `` ('default =' `0`):: - -Delete the original disk after successful copy. By default the original disk is kept as unused disk. - -`--digest` `` :: - -Prevent changes if current configuration file has different SHA1" - ." digest. This can be used to prevent concurrent modifications. - -`--format` `` :: - -Target Format. - -`--target-digest` `` :: - -Prevent changes if the current config file of the target VM has a" - ." different SHA1 digest. This can be used to detect concurrent modifications. +*qm move-disk* -`--target-disk` `` :: - -The config key the disk will be moved to on the target VM (for example, ide0 or scsi1). Default is the source disk key. - -`--target-vmid` ` (1 - N)` :: - -The (unique) ID of the VM. +An alias for 'qm disk move'. *qm move_disk* -An alias for 'qm move-disk'. +An alias for 'qm disk move'. *qm mtunnel* @@ -760,17 +840,9 @@ The (unique) ID of the VM. Wait maximal timeout seconds for the shutdown. -*qm rescan* `[OPTIONS]` - -Rescan all storages and update disk sizes and unused disk images. - -`--dryrun` `` ('default =' `0`):: - -Do not actually write changes out to VM config(s). - -`--vmid` ` (1 - N)` :: +*qm rescan* -The (unique) ID of the VM. +An alias for 'qm disk rescan'. *qm reset* `` `[OPTIONS]` @@ -784,29 +856,9 @@ The (unique) ID of the VM. Ignore locks - only root is allowed to use this option. -*qm resize* ` ` `[OPTIONS]` - -Extend volume size. +*qm resize* -``: ` (1 - N)` :: - -The (unique) ID of the VM. - -``: `` :: - -The disk you want to resize. - -``: `\+?\d+(\.\d+)?[KMGT]?` :: - -The new size. With the `+` sign the value is added to the actual size of the volume and without it, the value is taken as an absolute one. Shrinking disk size is not supported. - -`--digest` `` :: - -Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications. - -`--skiplock` `` :: - -Ignore locks - only root is allowed to use this option. +An alias for 'qm disk resize'. *qm resume* `` `[OPTIONS]` @@ -824,7 +876,7 @@ no description available Ignore locks - only root is allowed to use this option. -*qm rollback* ` ` +*qm rollback* ` ` `[OPTIONS]` Rollback VM state to specified snapshot. @@ -836,6 +888,10 @@ The (unique) ID of the VM. The name of the snapshot. +`--start` `` ('default =' `0`):: + +Whether the VM should get started after rolling back successfully + *qm sendkey* ` ` `[OPTIONS]` Send key event to virtual machine. @@ -866,6 +922,10 @@ The (unique) ID of the VM. Enable/disable ACPI. +`--affinity` `` :: + +List of host cores used to execute guest processes. + `--agent` `[enabled=]<1|0> [,fstrim_cloned_disks=<1|0>] [,type=]` :: Enable/disable communication with the Qemu Guest Agent and its properties. @@ -974,7 +1034,7 @@ Map host PCI devices into guest. `--hotplug` `` ('default =' `network,disk,usb`):: -Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. +Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory', 'usb' and 'cloudinit'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. USB hotplugging is possible for guests with machine version >= 7.1 and ostype l26 or windows > 7. `--hugepages` `<1024 | 2 | any>` :: @@ -1168,7 +1228,7 @@ Reference to unused volumes. This is used internally, and should not be modified `--usb[n]` `[host=] [,usb3=<1|0>]` :: -Configure an USB device (n is 0 to 4). +Configure an USB device (n is 0 to 4, for machine version >= 7.1 and ostype l26 or windows > 7, n can be up to 14). `--vcpus` ` (1 - N)` ('default =' `0`):: @@ -1388,21 +1448,9 @@ Escape character. Select the serial device. By default we simply use the first suitable device. -*qm unlink* ` --idlist ` `[OPTIONS]` - -Unlink/delete disk images. - -``: ` (1 - N)` :: - -The (unique) ID of the VM. - -`--force` `` :: - -Force physical removal. Without this, we simple remove the disk from the config file and create an additional configuration entry called 'unused[n]', which contains the volume ID. Unlink of unused[n] always cause physical removal. +*qm unlink* -`--idlist` `` :: - -A list of disk IDs you want to delete. +An alias for 'qm disk unlink'. *qm unlock* `` diff --git a/qm.conf.5-opts.adoc b/qm.conf.5-opts.adoc index 64e1418..33dd6ac 100644 --- a/qm.conf.5-opts.adoc +++ b/qm.conf.5-opts.adoc @@ -2,6 +2,10 @@ Enable/disable ACPI. +`affinity`: `` :: + +List of host cores used to execute guest processes. + `agent`: `[enabled=]<1|0> [,fstrim_cloned_disks=<1|0>] [,type=]` :: Enable/disable communication with the Qemu Guest Agent and its properties. @@ -155,10 +159,6 @@ Limit of CPU usage. + NOTE: If the computer has 2 CPUs, it has total of '2' CPU time. Value '0' indicates no CPU limit. -`affinity`: ``:: - -Set of CPU cores to pin the virtual machine processes to. This is a comma sepparated list of numbers or ranges in list format as defined by the Linux man page for cpuset. ( e.g `0,4-6,9` ) - `cpuunits`: ` (1 - 262144)` ('default =' `cgroup v1: 1024, cgroup v2: 100`):: CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to weights of all the other running VMs. @@ -261,7 +261,7 @@ Enable vfio-vga device support. `hotplug`: `` ('default =' `network,disk,usb`):: -Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. +Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory', 'usb' and 'cloudinit'. Use '0' to disable hotplug completely. Using '1' as value is an alias for the default `network,disk,usb`. USB hotplugging is possible for guests with machine version >= 7.1 and ostype l26 or windows > 7. `hugepages`: `<1024 | 2 | any>` :: @@ -1170,7 +1170,7 @@ The drive's backing volume. `usb[n]`: `[host=] [,usb3=<1|0>]` :: -Configure an USB device (n is 0 to 4). +Configure an USB device (n is 0 to 4, for machine version >= 7.1 and ostype l26 or windows > 7, n can be up to 14). `host`=`` ;; @@ -1189,7 +1189,7 @@ The value 'spice' can be used to add a usb redirection devices for spice. `usb3`=`` ('default =' `0`);; -Specifies whether if given host option is a USB3 device or port. +Specifies whether if given host option is a USB3 device or port. For modern guests (machine version >= 7.1 and ostype l26 and windows > 7), this flag is irrelevant (all devices are plugged into a xhci controller). `vcpus`: ` (1 - N)` ('default =' `0`):: diff --git a/vzdump.1-synopsis.adoc b/vzdump.1-synopsis.adoc index 1654299..5434a52 100644 --- a/vzdump.1-synopsis.adoc +++ b/vzdump.1-synopsis.adoc @@ -62,10 +62,14 @@ Only run if executed on this node. `--notes-template` `` :: -Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are \{\{cluster\}\}, \{\{guestname\}\}, \{\{node\}\}, and \{\{vmid\}\}, but more might be added in the future. +Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are \{\{cluster\}\}, \{\{guestname\}\}, \{\{node\}\}, and \{\{vmid\}\}, but more might be added in the future. Needs to be a single line, newline and backslash need to be escaped as '\n' and '\\' respectively. + NOTE: Requires option(s): `storage` +`--performance` `[max-workers=]` :: + +Other performance-related settings. + `--pigz` `` ('default =' `0`):: Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread count. diff --git a/vzdump.conf.5-opts.adoc b/vzdump.conf.5-opts.adoc index 0f4dde9..58b5167 100644 --- a/vzdump.conf.5-opts.adoc +++ b/vzdump.conf.5-opts.adoc @@ -40,10 +40,18 @@ Backup mode. `notes-template`: `` :: -Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are \{\{cluster\}\}, \{\{guestname\}\}, \{\{node\}\}, and \{\{vmid\}\}, but more might be added in the future. +Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are \{\{cluster\}\}, \{\{guestname\}\}, \{\{node\}\}, and \{\{vmid\}\}, but more might be added in the future. Needs to be a single line, newline and backslash need to be escaped as '\n' and '\\' respectively. + NOTE: Requires option(s): `storage` +`performance`: `[max-workers=]` :: + +Other performance-related settings. + +`max-workers`=` (1 - 256)` ('default =' `16`);; + +Applies to VMs. Allow up to this many IO workers at the same time. + `pigz`: `` ('default =' `0`):: Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread count. -- 2.39.2