From 4772952b604a1fd9bca16e70fbe6a1d3b2d7feca Mon Sep 17 00:00:00 2001 From: Thomas Lamprecht Date: Tue, 24 Nov 2020 14:31:57 +0100 Subject: [PATCH] update static and schema information Signed-off-by: Thomas Lamprecht --- api-viewer/apidata.js | 960 ++++++++++++++++++++++++++++++--- pct.1-synopsis.adoc | 18 +- pct.conf.5-opts.adoc | 4 +- pve-firewall-cluster-opts.adoc | 2 +- pve-firewall-macros.adoc | 4 +- pve-firewall-rules-opts.adoc | 4 + pveceph.1-synopsis.adoc | 40 +- pvesm.1-synopsis.adoc | 46 +- pveum.1-synopsis.adoc | 8 + qm-cloud-init-opts.adoc | 17 +- qm.1-synopsis.adoc | 52 +- qm.conf.5-opts.adoc | 60 ++- vzdump.1-synopsis.adoc | 2 +- vzdump.conf.5-opts.adoc | 6 +- 14 files changed, 1080 insertions(+), 143 deletions(-) diff --git a/api-viewer/apidata.js b/api-viewer/apidata.js index a438090..a8f41de 100644 --- a/api-viewer/apidata.js +++ b/api-viewer/apidata.js @@ -292,6 +292,351 @@ var pveapi = [ "path" : "/cluster/replication", "text" : "replication" }, + { + "children" : [ + { + "children" : [ + { + "info" : { + "DELETE" : { + "allowtoken" : 1, + "description" : "Remove Metric server.", + "method" : "DELETE", + "name" : "delete", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "format" : "pve-configid", + "type" : "string", + "typetext" : "" + } + } + }, + "permissions" : { + "check" : [ + "perm", + "/", + [ + "Sys.Modify" + ] + ] + }, + "protected" : 1, + "returns" : { + "type" : "null" + } + }, + "GET" : { + "allowtoken" : 1, + "description" : "Read metric server configuration.", + "method" : "GET", + "name" : "read", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "format" : "pve-configid", + "type" : "string", + "typetext" : "" + } + } + }, + "permissions" : { + "check" : [ + "perm", + "/", + [ + "Sys.Audit" + ] + ] + }, + "returns" : { + "type" : "object" + } + }, + "POST" : { + "allowtoken" : 1, + "description" : "Create a new external metric server config", + "method" : "POST", + "name" : "create", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "disable" : { + "description" : "Flag to disable the plugin.", + "optional" : 1, + "type" : "boolean", + "typetext" : "" + }, + "id" : { + "description" : "The ID of the entry.", + "format" : "pve-configid", + "type" : "string", + "typetext" : "" + }, + "mtu" : { + "default" : 1500, + "description" : "MTU for metrics transmission over UDP", + "maximum" : 65536, + "minimum" : 512, + "optional" : 1, + "type" : "integer", + "typetext" : " (512 - 65536)" + }, + "path" : { + "description" : "root graphite path (ex: proxmox.mycluster.mykey)", + "format" : "graphite-path", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "port" : { + "description" : "server network port", + "type" : "integer", + "typetext" : "" + }, + "proto" : { + "description" : "Protocol to send graphite data. TCP or UDP (default)", + "enum" : [ + "udp", + "tcp" + ], + "optional" : 1, + "type" : "string" + }, + "server" : { + "description" : "server dns name or IP address", + "format" : "address", + "type" : "string", + "typetext" : "" + }, + "timeout" : { + "default" : 1, + "description" : "graphite TCP socket timeout (default=1)", + "minimum" : 0, + "optional" : 1, + "type" : "integer", + "typetext" : " (0 - N)" + }, + "type" : { + "description" : "Plugin type.", + "enum" : [ + "graphite", + "influxdb" + ], + "format" : "pve-configid", + "type" : "string" + } + }, + "type" : "object" + }, + "permissions" : { + "check" : [ + "perm", + "/", + [ + "Sys.Modify" + ] + ] + }, + "protected" : 1, + "returns" : { + "type" : "null" + } + }, + "PUT" : { + "allowtoken" : 1, + "description" : "Update metric server configuration.", + "method" : "PUT", + "name" : "update", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "delete" : { + "description" : "A list of settings you want to delete.", + "format" : "pve-configid-list", + "maxLength" : 4096, + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "digest" : { + "description" : "Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.", + "maxLength" : 40, + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "disable" : { + "description" : "Flag to disable the plugin.", + "optional" : 1, + "type" : "boolean", + "typetext" : "" + }, + "id" : { + "description" : "The ID of the entry.", + "format" : "pve-configid", + "type" : "string", + "typetext" : "" + }, + "mtu" : { + "default" : 1500, + "description" : "MTU for metrics transmission over UDP", + "maximum" : 65536, + "minimum" : 512, + "optional" : 1, + "type" : "integer", + "typetext" : " (512 - 65536)" + }, + "path" : { + "description" : "root graphite path (ex: proxmox.mycluster.mykey)", + "format" : "graphite-path", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "port" : { + "description" : "server network port", + "type" : "integer", + "typetext" : "" + }, + "proto" : { + "description" : "Protocol to send graphite data. TCP or UDP (default)", + "enum" : [ + "udp", + "tcp" + ], + "optional" : 1, + "type" : "string" + }, + "server" : { + "description" : "server dns name or IP address", + "format" : "address", + "type" : "string", + "typetext" : "" + }, + "timeout" : { + "default" : 1, + "description" : "graphite TCP socket timeout (default=1)", + "minimum" : 0, + "optional" : 1, + "type" : "integer", + "typetext" : " (0 - N)" + } + }, + "type" : "object" + }, + "permissions" : { + "check" : [ + "perm", + "/", + [ + "Sys.Modify" + ] + ] + }, + "protected" : 1, + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/cluster/metrics/server/{id}", + "text" : "{id}" + } + ], + "info" : { + "GET" : { + "allowtoken" : 1, + "description" : "List configured metric servers.", + "method" : "GET", + "name" : "server_index", + "parameters" : { + "additionalProperties" : 0 + }, + "permissions" : { + "check" : [ + "perm", + "/", + [ + "Sys.Audit" + ] + ] + }, + "returns" : { + "items" : { + "properties" : { + "disable" : { + "description" : "Flag to disable the plugin.", + "type" : "boolean" + }, + "id" : { + "description" : "The ID of the entry.", + "type" : "string" + }, + "port" : { + "description" : "Server network port", + "type" : "integer" + }, + "server" : { + "description" : "Server dns name or IP address", + "type" : "string" + }, + "type" : { + "description" : "Plugin type.", + "type" : "string" + } + }, + "type" : "object" + }, + "links" : [ + { + "href" : "{id}", + "rel" : "child" + } + ], + "type" : "array" + } + } + }, + "leaf" : 0, + "path" : "/cluster/metrics/server", + "text" : "server" + } + ], + "info" : { + "GET" : { + "allowtoken" : 1, + "description" : "Metrics index.", + "method" : "GET", + "name" : "index", + "parameters" : { + "additionalProperties" : 0 + }, + "permissions" : { + "user" : "all" + }, + "returns" : { + "items" : { + "properties" : {}, + "type" : "object" + }, + "links" : [ + { + "href" : "{name}", + "rel" : "child" + } + ], + "type" : "array" + } + } + }, + "leaf" : 0, + "path" : "/cluster/metrics", + "text" : "metrics" + }, { "children" : [ { @@ -930,6 +1275,10 @@ var pveapi = [ "optional" : 1, "type" : "integer" }, + "icmp-type" : { + "optional" : 1, + "type" : "string" + }, "iface" : { "optional" : 1, "type" : "string" @@ -1044,6 +1393,13 @@ var pveapi = [ "pattern" : "[A-Za-z][A-Za-z0-9\\-\\_]+", "type" : "string" }, + "icmp-type" : { + "description" : "Specify icmp-type. Only valid if proto equals 'icmp'.", + "format" : "pve-fw-icmp-type-spec", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "iface" : { "description" : "Network interface name. You have to use network configuration key names for VMs and containers ('net\\d+'). Host related rules can use arbitrary strings.", "format" : "pve-iface", @@ -1278,6 +1634,13 @@ var pveapi = [ "pattern" : "[A-Za-z][A-Za-z0-9\\-\\_]+", "type" : "string" }, + "icmp-type" : { + "description" : "Specify icmp-type. Only valid if proto equals 'icmp'.", + "format" : "pve-fw-icmp-type-spec", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "iface" : { "description" : "Network interface name. You have to use network configuration key names for VMs and containers ('net\\d+'). Host related rules can use arbitrary strings.", "format" : "pve-iface", @@ -1562,6 +1925,10 @@ var pveapi = [ "optional" : 1, "type" : "integer" }, + "icmp-type" : { + "optional" : 1, + "type" : "string" + }, "iface" : { "optional" : 1, "type" : "string" @@ -1669,6 +2036,13 @@ var pveapi = [ "type" : "integer", "typetext" : " (0 - N)" }, + "icmp-type" : { + "description" : "Specify icmp-type. Only valid if proto equals 'icmp'.", + "format" : "pve-fw-icmp-type-spec", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "iface" : { "description" : "Network interface name. You have to use network configuration key names for VMs and containers ('net\\d+'). Host related rules can use arbitrary strings.", "format" : "pve-iface", @@ -1856,6 +2230,13 @@ var pveapi = [ "type" : "integer", "typetext" : " (0 - N)" }, + "icmp-type" : { + "description" : "Specify icmp-type. Only valid if proto equals 'icmp'.", + "format" : "pve-fw-icmp-type-spec", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "iface" : { "description" : "Network interface name. You have to use network configuration key names for VMs and containers ('net\\d+'). Host related rules can use arbitrary strings.", "format" : "pve-iface", @@ -2613,7 +2994,7 @@ var pveapi = [ "format" : { "burst" : { "default" : 5, - "description" : "Inital burst of packages which will get logged", + "description" : "Initial burst of packages which will always get logged before the rate is applied", "minimum" : 0, "optional" : 1, "type" : "integer" @@ -2701,7 +3082,7 @@ var pveapi = [ "format" : { "burst" : { "default" : 5, - "description" : "Inital burst of packages which will get logged", + "description" : "Initial burst of packages which will always get logged before the rate is applied", "minimum" : 0, "optional" : 1, "type" : "integer" @@ -3212,7 +3593,7 @@ var pveapi = [ "format" : "prune-backups", "optional" : 1, "type" : "string", - "typetext" : "[keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" + "typetext" : "[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" }, "quiet" : { "default" : 0, @@ -3507,7 +3888,7 @@ var pveapi = [ "format" : "prune-backups", "optional" : 1, "type" : "string", - "typetext" : "[keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" + "typetext" : "[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" }, "quiet" : { "default" : 0, @@ -6666,6 +7047,12 @@ var pveapi = [ "returns" : { "items" : { "properties" : { + "content" : { + "description" : "Allowed storage content types (when type == storage).", + "format" : "pve-storage-content-list", + "optional" : 1, + "type" : "string" + }, "cpu" : { "description" : "CPU utilization (when type in node,qemu,lxc).", "optional" : 1, @@ -7358,6 +7745,10 @@ var pveapi = [ "optional" : 1, "type" : "integer" }, + "icmp-type" : { + "optional" : 1, + "type" : "string" + }, "iface" : { "optional" : 1, "type" : "string" @@ -7465,6 +7856,13 @@ var pveapi = [ "type" : "integer", "typetext" : " (0 - N)" }, + "icmp-type" : { + "description" : "Specify icmp-type. Only valid if proto equals 'icmp'.", + "format" : "pve-fw-icmp-type-spec", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "iface" : { "description" : "Network interface name. You have to use network configuration key names for VMs and containers ('net\\d+'). Host related rules can use arbitrary strings.", "format" : "pve-iface", @@ -7680,6 +8078,13 @@ var pveapi = [ "type" : "integer", "typetext" : " (0 - N)" }, + "icmp-type" : { + "description" : "Specify icmp-type. Only valid if proto equals 'icmp'.", + "format" : "pve-fw-icmp-type-spec", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "iface" : { "description" : "Network interface name. You have to use network configuration key names for VMs and containers ('net\\d+'). Host related rules can use arbitrary strings.", "format" : "pve-iface", @@ -10713,14 +11118,13 @@ var pveapi = [ "type" : "string" }, "boot" : { - "default" : "cdn", - "description" : "Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).", + "description" : "Specify guest boot order. Use with 'order=', usage with no key or 'legacy=' is deprecated.", + "format" : "pve-qm-boot", "optional" : 1, - "pattern" : "[acdn]{1,4}", "type" : "string" }, "bootdisk" : { - "description" : "Enable booting from specified disk.", + "description" : "Enable booting from specified disk. Deprecated: Use 'boot: order=foo;bar' instead.", "format" : "pve-qm-bootdisk", "optional" : 1, "pattern" : "(ide|sata|scsi|virtio)\\d+", @@ -11196,7 +11600,7 @@ var pveapi = [ "type" : "string" }, "ipconfig[n]" : { - "description" : "cloud-init: Specify IP addresses and gateways for the corresponding interface.\n\nIP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.\n\nThe special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.\nFor IPv6 the special string 'auto' can be used to use stateless autoconfiguration.\n\nIf cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.\n", + "description" : "cloud-init: Specify IP addresses and gateways for the corresponding interface.\n\nIP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.\n\nThe special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit\ngateway should be provided.\nFor IPv6 the special string 'auto' can be used to use stateless autoconfiguration.\n\nIf cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using\ndhcp on IPv4.\n", "format" : "pve-qm-ipconfig", "optional" : 1, "type" : "string" @@ -11220,6 +11624,12 @@ var pveapi = [ "optional" : 1, "type" : "string" }, + "keephugepages" : { + "default" : 0, + "description" : "Use together with hugepages. If enabled, hugepages will not not be deleted after VM shutdown and can be used for subsequent starts.", + "optional" : 1, + "type" : "boolean" + }, "keyboard" : { "default" : null, "description" : "Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it.", @@ -11315,7 +11725,7 @@ var pveapi = [ "type" : "string" }, "nameserver" : { - "description" : "cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.", + "description" : "cloud-init: Sets DNS server IP address for a container. Create will'\n\t .' automatically use the setting from the host if neither searchdomain nor nameserver'\n\t .' are set.", "format" : "address-list", "optional" : 1, "type" : "string" @@ -11530,7 +11940,7 @@ var pveapi = [ "optional" : 1, "pattern" : "/dev/parport\\d+|/dev/usb/lp\\d+", "type" : "string", - "verbose_description" : "Map host parallel devices (n is 0 to 2).\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" + "verbose_description" : "Map host parallel devices (n is 0 to 2).\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such\nmachines - use with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" }, "protection" : { "default" : 0, @@ -12237,7 +12647,7 @@ var pveapi = [ "type" : "string" }, "searchdomain" : { - "description" : "cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.", + "description" : "cloud-init: Sets DNS search domains for a container. Create will'\n\t .' automatically use the setting from the host if neither searchdomain nor nameserver'\n\t .' are set.", "optional" : 1, "type" : "string" }, @@ -12246,7 +12656,7 @@ var pveapi = [ "optional" : 1, "pattern" : "(/dev/.+|socket)", "type" : "string", - "verbose_description" : "Create a serial device inside the VM (n is 0 to 3), and pass through a\nhost serial device (i.e. /dev/ttyS0), or create a unix socket on the\nhost side (use 'qm terminal' to open a terminal connection).\n\nNOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" + "verbose_description" : "Create a serial device inside the VM (n is 0 to 3), and pass through a\nhost serial device (i.e. /dev/ttyS0), or create a unix socket on the\nhost side (use 'qm terminal' to open a terminal connection).\n\nNOTE: If you pass through a host serial device, it is no longer possible to migrate such machines -\nuse with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" }, "shares" : { "default" : 1000, @@ -12309,7 +12719,7 @@ var pveapi = [ }, "startdate" : { "default" : "now", - "description" : "Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'.", + "description" : "Set the initial date of the real time clock. Valid format for date are:'now' or '2006-06-17T16:01:21' or '2006-06-17'.", "optional" : 1, "pattern" : "(now|\\d{4}-\\d{1,2}-\\d{1,2}(T\\d{1,2}:\\d{1,2}:\\d{1,2})?)", "type" : "string", @@ -12327,7 +12737,7 @@ var pveapi = [ "description" : "Enable/disable the USB tablet device.", "optional" : 1, "type" : "boolean", - "verbose_description" : "Enable/disable the USB tablet device. This device is usually needed to allow absolute mouse positioning with VNC. Else the mouse runs out of sync with normal VNC clients. If you're running lots of console-only guests on one host, you may consider disabling this to save some context switches. This is turned off by default if you use spice (-vga=qxl)." + "verbose_description" : "Enable/disable the USB tablet device. This device is usually needed to allow absolute mouse positioning with VNC. Else the mouse runs out of sync with normal VNC clients. If you're running lots of console-only guests on one host, you may consider disabling this to save some context switches. This is turned off by default if you use spice (`qm set --vga qxl`)." }, "tags" : { "description" : "Tags of the VM. This is only meta information.", @@ -12369,7 +12779,7 @@ var pveapi = [ "format" : { "host" : { "default_key" : 1, - "description" : "The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:\n\n 'bus-port(.port)*' (decimal numbers) or\n 'vendor_id:product_id' (hexadeciaml numbers) or\n 'spice'\n\nYou can use the 'lsusb -t' command to list existing usb devices.\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.\n\nThe value 'spice' can be used to add a usb redirection devices for spice.\n", + "description" : "The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:\n\n 'bus-port(.port)*' (decimal numbers) or\n 'vendor_id:product_id' (hexadeciaml numbers) or\n 'spice'\n\nYou can use the 'lsusb -t' command to list existing usb devices.\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such\nmachines - use with special care.\n\nThe value 'spice' can be used to add a usb redirection devices for spice.\n", "format" : "pve-qm-usb-device", "format_description" : "HOSTUSBDEVICE|spice", "type" : "string" @@ -12744,7 +13154,7 @@ var pveapi = [ "optional" : 1, "pattern" : "(?:[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}|[01])", "type" : "string", - "verbose_description" : "The VM generation ID (vmgenid) device exposes a 128-bit integer value identifier to the guest OS. This allows to notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template). The guest operating system notices the change, and is then able to react as appropriate by marking its copies of distributed databases as dirty, re-initializing its random number generator, etc.\nNote that auto-creation only works when done throug API/CLI create or update methods, but not when manually editing the config file." + "verbose_description" : "The VM generation ID (vmgenid) device exposes a 128-bit integer value identifier to the guest OS. This allows to notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template). The guest operating system notices the change, and is then able to react as appropriate by marking its copies of distributed databases as dirty, re-initializing its random number generator, etc.\nNote that auto-creation only works when done through API/CLI create or update methods, but not when manually editing the config file." }, "vmstatestorage" : { "description" : "Default storage for VM state volumes/files.", @@ -12883,14 +13293,14 @@ var pveapi = [ "type" : "string" }, "boot" : { - "default" : "cdn", - "description" : "Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).", + "description" : "Specify guest boot order. Use with 'order=', usage with no key or 'legacy=' is deprecated.", + "format" : "pve-qm-boot", "optional" : 1, - "pattern" : "[acdn]{1,4}", - "type" : "string" + "type" : "string", + "typetext" : "[[legacy=]<[acdn]{1,4}>] [,order=]" }, "bootdisk" : { - "description" : "Enable booting from specified disk.", + "description" : "Enable booting from specified disk. Deprecated: Use 'boot: order=foo;bar' instead.", "format" : "pve-qm-bootdisk", "optional" : 1, "pattern" : "(ide|sata|scsi|virtio)\\d+", @@ -13397,7 +13807,7 @@ var pveapi = [ "typetext" : "[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_max_length=] [,bps_wr=] [,bps_wr_max_length=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_max=] [,iops_rd_max_length=] [,iops_wr=] [,iops_wr_max=] [,iops_wr_max_length=] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,model=] [,replicate=<1|0>] [,rerror=] [,secs=] [,serial=] [,shared=<1|0>] [,size=] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=] [,werror=] [,wwn=]" }, "ipconfig[n]" : { - "description" : "cloud-init: Specify IP addresses and gateways for the corresponding interface.\n\nIP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.\n\nThe special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.\nFor IPv6 the special string 'auto' can be used to use stateless autoconfiguration.\n\nIf cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.\n", + "description" : "cloud-init: Specify IP addresses and gateways for the corresponding interface.\n\nIP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.\n\nThe special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit\ngateway should be provided.\nFor IPv6 the special string 'auto' can be used to use stateless autoconfiguration.\n\nIf cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using\ndhcp on IPv4.\n", "format" : "pve-qm-ipconfig", "optional" : 1, "type" : "string", @@ -13423,6 +13833,13 @@ var pveapi = [ "type" : "string", "typetext" : "size= [,name=]" }, + "keephugepages" : { + "default" : 0, + "description" : "Use together with hugepages. If enabled, hugepages will not not be deleted after VM shutdown and can be used for subsequent starts.", + "optional" : 1, + "type" : "boolean", + "typetext" : "" + }, "keyboard" : { "default" : null, "description" : "Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it.", @@ -13524,7 +13941,7 @@ var pveapi = [ "typetext" : "" }, "nameserver" : { - "description" : "cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.", + "description" : "cloud-init: Sets DNS server IP address for a container. Create will'\n\t .' automatically use the setting from the host if neither searchdomain nor nameserver'\n\t .' are set.", "format" : "address-list", "optional" : 1, "type" : "string", @@ -13750,7 +14167,7 @@ var pveapi = [ "optional" : 1, "pattern" : "/dev/parport\\d+|/dev/usb/lp\\d+", "type" : "string", - "verbose_description" : "Map host parallel devices (n is 0 to 2).\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" + "verbose_description" : "Map host parallel devices (n is 0 to 2).\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such\nmachines - use with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" }, "protection" : { "default" : 0, @@ -14469,7 +14886,7 @@ var pveapi = [ "type" : "string" }, "searchdomain" : { - "description" : "cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.", + "description" : "cloud-init: Sets DNS search domains for a container. Create will'\n\t .' automatically use the setting from the host if neither searchdomain nor nameserver'\n\t .' are set.", "optional" : 1, "type" : "string", "typetext" : "" @@ -14479,7 +14896,7 @@ var pveapi = [ "optional" : 1, "pattern" : "(/dev/.+|socket)", "type" : "string", - "verbose_description" : "Create a serial device inside the VM (n is 0 to 3), and pass through a\nhost serial device (i.e. /dev/ttyS0), or create a unix socket on the\nhost side (use 'qm terminal' to open a terminal connection).\n\nNOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" + "verbose_description" : "Create a serial device inside the VM (n is 0 to 3), and pass through a\nhost serial device (i.e. /dev/ttyS0), or create a unix socket on the\nhost side (use 'qm terminal' to open a terminal connection).\n\nNOTE: If you pass through a host serial device, it is no longer possible to migrate such machines -\nuse with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" }, "shares" : { "default" : 1000, @@ -14554,7 +14971,7 @@ var pveapi = [ }, "startdate" : { "default" : "now", - "description" : "Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'.", + "description" : "Set the initial date of the real time clock. Valid format for date are:'now' or '2006-06-17T16:01:21' or '2006-06-17'.", "optional" : 1, "pattern" : "(now|\\d{4}-\\d{1,2}-\\d{1,2}(T\\d{1,2}:\\d{1,2}:\\d{1,2})?)", "type" : "string", @@ -14573,7 +14990,7 @@ var pveapi = [ "optional" : 1, "type" : "boolean", "typetext" : "", - "verbose_description" : "Enable/disable the USB tablet device. This device is usually needed to allow absolute mouse positioning with VNC. Else the mouse runs out of sync with normal VNC clients. If you're running lots of console-only guests on one host, you may consider disabling this to save some context switches. This is turned off by default if you use spice (-vga=qxl)." + "verbose_description" : "Enable/disable the USB tablet device. This device is usually needed to allow absolute mouse positioning with VNC. Else the mouse runs out of sync with normal VNC clients. If you're running lots of console-only guests on one host, you may consider disabling this to save some context switches. This is turned off by default if you use spice (`qm set --vga qxl`)." }, "tags" : { "description" : "Tags of the VM. This is only meta information.", @@ -14619,7 +15036,7 @@ var pveapi = [ "format" : { "host" : { "default_key" : 1, - "description" : "The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:\n\n 'bus-port(.port)*' (decimal numbers) or\n 'vendor_id:product_id' (hexadeciaml numbers) or\n 'spice'\n\nYou can use the 'lsusb -t' command to list existing usb devices.\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.\n\nThe value 'spice' can be used to add a usb redirection devices for spice.\n", + "description" : "The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:\n\n 'bus-port(.port)*' (decimal numbers) or\n 'vendor_id:product_id' (hexadeciaml numbers) or\n 'spice'\n\nYou can use the 'lsusb -t' command to list existing usb devices.\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such\nmachines - use with special care.\n\nThe value 'spice' can be used to add a usb redirection devices for spice.\n", "format" : "pve-qm-usb-device", "format_description" : "HOSTUSBDEVICE|spice", "type" : "string" @@ -14998,7 +15415,7 @@ var pveapi = [ "optional" : 1, "pattern" : "(?:[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}|[01])", "type" : "string", - "verbose_description" : "The VM generation ID (vmgenid) device exposes a 128-bit integer value identifier to the guest OS. This allows to notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template). The guest operating system notices the change, and is then able to react as appropriate by marking its copies of distributed databases as dirty, re-initializing its random number generator, etc.\nNote that auto-creation only works when done throug API/CLI create or update methods, but not when manually editing the config file." + "verbose_description" : "The VM generation ID (vmgenid) device exposes a 128-bit integer value identifier to the guest OS. This allows to notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template). The guest operating system notices the change, and is then able to react as appropriate by marking its copies of distributed databases as dirty, re-initializing its random number generator, etc.\nNote that auto-creation only works when done through API/CLI create or update methods, but not when manually editing the config file." }, "vmid" : { "description" : "The (unique) ID of the VM.", @@ -15161,14 +15578,14 @@ var pveapi = [ "type" : "string" }, "boot" : { - "default" : "cdn", - "description" : "Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).", + "description" : "Specify guest boot order. Use with 'order=', usage with no key or 'legacy=' is deprecated.", + "format" : "pve-qm-boot", "optional" : 1, - "pattern" : "[acdn]{1,4}", - "type" : "string" + "type" : "string", + "typetext" : "[[legacy=]<[acdn]{1,4}>] [,order=]" }, "bootdisk" : { - "description" : "Enable booting from specified disk.", + "description" : "Enable booting from specified disk. Deprecated: Use 'boot: order=foo;bar' instead.", "format" : "pve-qm-bootdisk", "optional" : 1, "pattern" : "(ide|sata|scsi|virtio)\\d+", @@ -15675,7 +16092,7 @@ var pveapi = [ "typetext" : "[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_max_length=] [,bps_wr=] [,bps_wr_max_length=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_max=] [,iops_rd_max_length=] [,iops_wr=] [,iops_wr_max=] [,iops_wr_max_length=] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,model=] [,replicate=<1|0>] [,rerror=] [,secs=] [,serial=] [,shared=<1|0>] [,size=] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=] [,werror=] [,wwn=]" }, "ipconfig[n]" : { - "description" : "cloud-init: Specify IP addresses and gateways for the corresponding interface.\n\nIP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.\n\nThe special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.\nFor IPv6 the special string 'auto' can be used to use stateless autoconfiguration.\n\nIf cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.\n", + "description" : "cloud-init: Specify IP addresses and gateways for the corresponding interface.\n\nIP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.\n\nThe special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit\ngateway should be provided.\nFor IPv6 the special string 'auto' can be used to use stateless autoconfiguration.\n\nIf cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using\ndhcp on IPv4.\n", "format" : "pve-qm-ipconfig", "optional" : 1, "type" : "string", @@ -15701,6 +16118,13 @@ var pveapi = [ "type" : "string", "typetext" : "size= [,name=]" }, + "keephugepages" : { + "default" : 0, + "description" : "Use together with hugepages. If enabled, hugepages will not not be deleted after VM shutdown and can be used for subsequent starts.", + "optional" : 1, + "type" : "boolean", + "typetext" : "" + }, "keyboard" : { "default" : null, "description" : "Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it.", @@ -15802,7 +16226,7 @@ var pveapi = [ "typetext" : "" }, "nameserver" : { - "description" : "cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.", + "description" : "cloud-init: Sets DNS server IP address for a container. Create will'\n\t .' automatically use the setting from the host if neither searchdomain nor nameserver'\n\t .' are set.", "format" : "address-list", "optional" : 1, "type" : "string", @@ -16028,7 +16452,7 @@ var pveapi = [ "optional" : 1, "pattern" : "/dev/parport\\d+|/dev/usb/lp\\d+", "type" : "string", - "verbose_description" : "Map host parallel devices (n is 0 to 2).\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" + "verbose_description" : "Map host parallel devices (n is 0 to 2).\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such\nmachines - use with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" }, "protection" : { "default" : 0, @@ -16747,7 +17171,7 @@ var pveapi = [ "type" : "string" }, "searchdomain" : { - "description" : "cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.", + "description" : "cloud-init: Sets DNS search domains for a container. Create will'\n\t .' automatically use the setting from the host if neither searchdomain nor nameserver'\n\t .' are set.", "optional" : 1, "type" : "string", "typetext" : "" @@ -16757,7 +17181,7 @@ var pveapi = [ "optional" : 1, "pattern" : "(/dev/.+|socket)", "type" : "string", - "verbose_description" : "Create a serial device inside the VM (n is 0 to 3), and pass through a\nhost serial device (i.e. /dev/ttyS0), or create a unix socket on the\nhost side (use 'qm terminal' to open a terminal connection).\n\nNOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" + "verbose_description" : "Create a serial device inside the VM (n is 0 to 3), and pass through a\nhost serial device (i.e. /dev/ttyS0), or create a unix socket on the\nhost side (use 'qm terminal' to open a terminal connection).\n\nNOTE: If you pass through a host serial device, it is no longer possible to migrate such machines -\nuse with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" }, "shares" : { "default" : 1000, @@ -16832,7 +17256,7 @@ var pveapi = [ }, "startdate" : { "default" : "now", - "description" : "Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'.", + "description" : "Set the initial date of the real time clock. Valid format for date are:'now' or '2006-06-17T16:01:21' or '2006-06-17'.", "optional" : 1, "pattern" : "(now|\\d{4}-\\d{1,2}-\\d{1,2}(T\\d{1,2}:\\d{1,2}:\\d{1,2})?)", "type" : "string", @@ -16851,7 +17275,7 @@ var pveapi = [ "optional" : 1, "type" : "boolean", "typetext" : "", - "verbose_description" : "Enable/disable the USB tablet device. This device is usually needed to allow absolute mouse positioning with VNC. Else the mouse runs out of sync with normal VNC clients. If you're running lots of console-only guests on one host, you may consider disabling this to save some context switches. This is turned off by default if you use spice (-vga=qxl)." + "verbose_description" : "Enable/disable the USB tablet device. This device is usually needed to allow absolute mouse positioning with VNC. Else the mouse runs out of sync with normal VNC clients. If you're running lots of console-only guests on one host, you may consider disabling this to save some context switches. This is turned off by default if you use spice (`qm set --vga qxl`)." }, "tags" : { "description" : "Tags of the VM. This is only meta information.", @@ -16897,7 +17321,7 @@ var pveapi = [ "format" : { "host" : { "default_key" : 1, - "description" : "The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:\n\n 'bus-port(.port)*' (decimal numbers) or\n 'vendor_id:product_id' (hexadeciaml numbers) or\n 'spice'\n\nYou can use the 'lsusb -t' command to list existing usb devices.\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.\n\nThe value 'spice' can be used to add a usb redirection devices for spice.\n", + "description" : "The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:\n\n 'bus-port(.port)*' (decimal numbers) or\n 'vendor_id:product_id' (hexadeciaml numbers) or\n 'spice'\n\nYou can use the 'lsusb -t' command to list existing usb devices.\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such\nmachines - use with special care.\n\nThe value 'spice' can be used to add a usb redirection devices for spice.\n", "format" : "pve-qm-usb-device", "format_description" : "HOSTUSBDEVICE|spice", "type" : "string" @@ -17276,7 +17700,7 @@ var pveapi = [ "optional" : 1, "pattern" : "(?:[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}|[01])", "type" : "string", - "verbose_description" : "The VM generation ID (vmgenid) device exposes a 128-bit integer value identifier to the guest OS. This allows to notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template). The guest operating system notices the change, and is then able to react as appropriate by marking its copies of distributed databases as dirty, re-initializing its random number generator, etc.\nNote that auto-creation only works when done throug API/CLI create or update methods, but not when manually editing the config file." + "verbose_description" : "The VM generation ID (vmgenid) device exposes a 128-bit integer value identifier to the guest OS. This allows to notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template). The guest operating system notices the change, and is then able to react as appropriate by marking its copies of distributed databases as dirty, re-initializing its random number generator, etc.\nNote that auto-creation only works when done through API/CLI create or update methods, but not when manually editing the config file." }, "vmid" : { "description" : "The (unique) ID of the VM.", @@ -20079,14 +20503,14 @@ var pveapi = [ "type" : "string" }, "boot" : { - "default" : "cdn", - "description" : "Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).", + "description" : "Specify guest boot order. Use with 'order=', usage with no key or 'legacy=' is deprecated.", + "format" : "pve-qm-boot", "optional" : 1, - "pattern" : "[acdn]{1,4}", - "type" : "string" + "type" : "string", + "typetext" : "[[legacy=]<[acdn]{1,4}>] [,order=]" }, "bootdisk" : { - "description" : "Enable booting from specified disk.", + "description" : "Enable booting from specified disk. Deprecated: Use 'boot: order=foo;bar' instead.", "format" : "pve-qm-bootdisk", "optional" : 1, "pattern" : "(ide|sata|scsi|virtio)\\d+", @@ -20587,7 +21011,7 @@ var pveapi = [ "typetext" : "[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_max_length=] [,bps_wr=] [,bps_wr_max_length=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_max=] [,iops_rd_max_length=] [,iops_wr=] [,iops_wr_max=] [,iops_wr_max_length=] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,model=] [,replicate=<1|0>] [,rerror=] [,secs=] [,serial=] [,shared=<1|0>] [,size=] [,snapshot=<1|0>] [,ssd=<1|0>] [,trans=] [,werror=] [,wwn=]" }, "ipconfig[n]" : { - "description" : "cloud-init: Specify IP addresses and gateways for the corresponding interface.\n\nIP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.\n\nThe special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.\nFor IPv6 the special string 'auto' can be used to use stateless autoconfiguration.\n\nIf cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.\n", + "description" : "cloud-init: Specify IP addresses and gateways for the corresponding interface.\n\nIP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.\n\nThe special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit\ngateway should be provided.\nFor IPv6 the special string 'auto' can be used to use stateless autoconfiguration.\n\nIf cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using\ndhcp on IPv4.\n", "format" : "pve-qm-ipconfig", "optional" : 1, "type" : "string", @@ -20613,6 +21037,13 @@ var pveapi = [ "type" : "string", "typetext" : "size= [,name=]" }, + "keephugepages" : { + "default" : 0, + "description" : "Use together with hugepages. If enabled, hugepages will not not be deleted after VM shutdown and can be used for subsequent starts.", + "optional" : 1, + "type" : "boolean", + "typetext" : "" + }, "keyboard" : { "default" : null, "description" : "Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it.", @@ -20714,7 +21145,7 @@ var pveapi = [ "typetext" : "" }, "nameserver" : { - "description" : "cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.", + "description" : "cloud-init: Sets DNS server IP address for a container. Create will'\n\t .' automatically use the setting from the host if neither searchdomain nor nameserver'\n\t .' are set.", "format" : "address-list", "optional" : 1, "type" : "string", @@ -20940,7 +21371,7 @@ var pveapi = [ "optional" : 1, "pattern" : "/dev/parport\\d+|/dev/usb/lp\\d+", "type" : "string", - "verbose_description" : "Map host parallel devices (n is 0 to 2).\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" + "verbose_description" : "Map host parallel devices (n is 0 to 2).\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such\nmachines - use with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" }, "pool" : { "description" : "Add the VM to the specified pool.", @@ -21659,7 +22090,7 @@ var pveapi = [ "type" : "string" }, "searchdomain" : { - "description" : "cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.", + "description" : "cloud-init: Sets DNS search domains for a container. Create will'\n\t .' automatically use the setting from the host if neither searchdomain nor nameserver'\n\t .' are set.", "optional" : 1, "type" : "string", "typetext" : "" @@ -21669,7 +22100,7 @@ var pveapi = [ "optional" : 1, "pattern" : "(/dev/.+|socket)", "type" : "string", - "verbose_description" : "Create a serial device inside the VM (n is 0 to 3), and pass through a\nhost serial device (i.e. /dev/ttyS0), or create a unix socket on the\nhost side (use 'qm terminal' to open a terminal connection).\n\nNOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" + "verbose_description" : "Create a serial device inside the VM (n is 0 to 3), and pass through a\nhost serial device (i.e. /dev/ttyS0), or create a unix socket on the\nhost side (use 'qm terminal' to open a terminal connection).\n\nNOTE: If you pass through a host serial device, it is no longer possible to migrate such machines -\nuse with special care.\n\nCAUTION: Experimental! User reported problems with this option.\n" }, "shares" : { "default" : 1000, @@ -21745,7 +22176,7 @@ var pveapi = [ }, "startdate" : { "default" : "now", - "description" : "Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'.", + "description" : "Set the initial date of the real time clock. Valid format for date are:'now' or '2006-06-17T16:01:21' or '2006-06-17'.", "optional" : 1, "pattern" : "(now|\\d{4}-\\d{1,2}-\\d{1,2}(T\\d{1,2}:\\d{1,2}:\\d{1,2})?)", "type" : "string", @@ -21771,7 +22202,7 @@ var pveapi = [ "optional" : 1, "type" : "boolean", "typetext" : "", - "verbose_description" : "Enable/disable the USB tablet device. This device is usually needed to allow absolute mouse positioning with VNC. Else the mouse runs out of sync with normal VNC clients. If you're running lots of console-only guests on one host, you may consider disabling this to save some context switches. This is turned off by default if you use spice (-vga=qxl)." + "verbose_description" : "Enable/disable the USB tablet device. This device is usually needed to allow absolute mouse positioning with VNC. Else the mouse runs out of sync with normal VNC clients. If you're running lots of console-only guests on one host, you may consider disabling this to save some context switches. This is turned off by default if you use spice (`qm set --vga qxl`)." }, "tags" : { "description" : "Tags of the VM. This is only meta information.", @@ -21824,7 +22255,7 @@ var pveapi = [ "format" : { "host" : { "default_key" : 1, - "description" : "The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:\n\n 'bus-port(.port)*' (decimal numbers) or\n 'vendor_id:product_id' (hexadeciaml numbers) or\n 'spice'\n\nYou can use the 'lsusb -t' command to list existing usb devices.\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.\n\nThe value 'spice' can be used to add a usb redirection devices for spice.\n", + "description" : "The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:\n\n 'bus-port(.port)*' (decimal numbers) or\n 'vendor_id:product_id' (hexadeciaml numbers) or\n 'spice'\n\nYou can use the 'lsusb -t' command to list existing usb devices.\n\nNOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such\nmachines - use with special care.\n\nThe value 'spice' can be used to add a usb redirection devices for spice.\n", "format" : "pve-qm-usb-device", "format_description" : "HOSTUSBDEVICE|spice", "type" : "string" @@ -22203,7 +22634,7 @@ var pveapi = [ "optional" : 1, "pattern" : "(?:[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}|[01])", "type" : "string", - "verbose_description" : "The VM generation ID (vmgenid) device exposes a 128-bit integer value identifier to the guest OS. This allows to notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template). The guest operating system notices the change, and is then able to react as appropriate by marking its copies of distributed databases as dirty, re-initializing its random number generator, etc.\nNote that auto-creation only works when done throug API/CLI create or update methods, but not when manually editing the config file." + "verbose_description" : "The VM generation ID (vmgenid) device exposes a 128-bit integer value identifier to the guest OS. This allows to notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template). The guest operating system notices the change, and is then able to react as appropriate by marking its copies of distributed databases as dirty, re-initializing its random number generator, etc.\nNote that auto-creation only works when done through API/CLI create or update methods, but not when manually editing the config file." }, "vmid" : { "description" : "The (unique) ID of the VM.", @@ -22385,7 +22816,7 @@ var pveapi = [ }, "cores" : { "description" : "The number of cores assigned to the container. A container can use all available cores by default.", - "maximum" : 128, + "maximum" : 8192, "minimum" : 1, "optional" : 1, "type" : "integer" @@ -22393,7 +22824,7 @@ var pveapi = [ "cpulimit" : { "default" : 0, "description" : "Limit of CPU usage.\n\nNOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.", - "maximum" : 128, + "maximum" : 8192, "minimum" : 0, "optional" : 1, "type" : "number" @@ -22877,20 +23308,20 @@ var pveapi = [ }, "cores" : { "description" : "The number of cores assigned to the container. A container can use all available cores by default.", - "maximum" : 128, + "maximum" : 8192, "minimum" : 1, "optional" : 1, "type" : "integer", - "typetext" : " (1 - 128)" + "typetext" : " (1 - 8192)" }, "cpulimit" : { "default" : 0, "description" : "Limit of CPU usage.\n\nNOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.", - "maximum" : 128, + "maximum" : 8192, "minimum" : 0, "optional" : 1, "type" : "number", - "typetext" : " (0 - 128)" + "typetext" : " (0 - 8192)" }, "cpuunits" : { "default" : 1024, @@ -24388,6 +24819,10 @@ var pveapi = [ "optional" : 1, "type" : "integer" }, + "icmp-type" : { + "optional" : 1, + "type" : "string" + }, "iface" : { "optional" : 1, "type" : "string" @@ -24495,6 +24930,13 @@ var pveapi = [ "type" : "integer", "typetext" : " (0 - N)" }, + "icmp-type" : { + "description" : "Specify icmp-type. Only valid if proto equals 'icmp'.", + "format" : "pve-fw-icmp-type-spec", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "iface" : { "description" : "Network interface name. You have to use network configuration key names for VMs and containers ('net\\d+'). Host related rules can use arbitrary strings.", "format" : "pve-iface", @@ -24710,6 +25152,13 @@ var pveapi = [ "type" : "integer", "typetext" : " (0 - N)" }, + "icmp-type" : { + "description" : "Specify icmp-type. Only valid if proto equals 'icmp'.", + "format" : "pve-fw-icmp-type-spec", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "iface" : { "description" : "Network interface name. You have to use network configuration key names for VMs and containers ('net\\d+'). Host related rules can use arbitrary strings.", "format" : "pve-iface", @@ -27813,20 +28262,20 @@ var pveapi = [ }, "cores" : { "description" : "The number of cores assigned to the container. A container can use all available cores by default.", - "maximum" : 128, + "maximum" : 8192, "minimum" : 1, "optional" : 1, "type" : "integer", - "typetext" : " (1 - 128)" + "typetext" : " (1 - 8192)" }, "cpulimit" : { "default" : 0, "description" : "Limit of CPU usage.\n\nNOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.", - "maximum" : 128, + "maximum" : 8192, "minimum" : 0, "optional" : 1, "type" : "number", - "typetext" : " (0 - 128)" + "typetext" : " (0 - 8192)" }, "cpuunits" : { "default" : 1024, @@ -29763,6 +30212,92 @@ var pveapi = [ "returns" : { "type" : "string" } + }, + "PUT" : { + "allowtoken" : 1, + "description" : "Change POOL settings", + "method" : "PUT", + "name" : "setpool", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "application" : { + "description" : "The application of the pool.", + "enum" : [ + "rbd", + "cephfs", + "rgw" + ], + "optional" : 1, + "type" : "string" + }, + "crush_rule" : { + "description" : "The rule to use for mapping object placement in the cluster.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "min_size" : { + "description" : "Minimum number of replicas per object", + "maximum" : 7, + "minimum" : 1, + "optional" : 1, + "type" : "integer", + "typetext" : " (1 - 7)" + }, + "name" : { + "description" : "The name of the pool. It must be unique.", + "type" : "string", + "typetext" : "" + }, + "node" : { + "description" : "The cluster node name.", + "format" : "pve-node", + "type" : "string", + "typetext" : "" + }, + "pg_autoscale_mode" : { + "description" : "The automatic PG scaling mode of the pool.", + "enum" : [ + "on", + "off", + "warn" + ], + "optional" : 1, + "type" : "string" + }, + "pg_num" : { + "description" : "Number of placement groups.", + "maximum" : 32768, + "minimum" : 8, + "optional" : 1, + "type" : "integer", + "typetext" : " (8 - 32768)" + }, + "size" : { + "description" : "Number of replicas per object", + "maximum" : 7, + "minimum" : 1, + "optional" : 1, + "type" : "integer", + "typetext" : " (1 - 7)" + } + } + }, + "permissions" : { + "check" : [ + "perm", + "/", + [ + "Sys.Modify" + ] + ] + }, + "protected" : 1, + "proxyto" : "node", + "returns" : { + "type" : "string" + } } }, "leaf" : 1, @@ -29872,7 +30407,8 @@ var pveapi = [ "typetext" : "" }, "application" : { - "description" : "The application of the pool, 'rbd' by default.", + "default" : "rbd", + "description" : "The application of the pool.", "enum" : [ "rbd", "cephfs", @@ -29907,6 +30443,17 @@ var pveapi = [ "type" : "string", "typetext" : "" }, + "pg_autoscale_mode" : { + "default" : "warn", + "description" : "The automatic PG scaling mode of the pool.", + "enum" : [ + "on", + "off", + "warn" + ], + "optional" : 1, + "type" : "string" + }, "pg_num" : { "default" : 128, "description" : "Number of placement groups.", @@ -30470,7 +31017,7 @@ var pveapi = [ "format" : "prune-backups", "optional" : 1, "type" : "string", - "typetext" : "[keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" + "typetext" : "[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" }, "quiet" : { "default" : 0, @@ -30558,7 +31105,7 @@ var pveapi = [ } }, "permissions" : { - "description" : "The user needs 'VM.Backup' permissions on any VM, and 'Datastore.AllocateSpace' on the backup storage. The 'maxfiles', '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' and 'ionice' parameters are restricted to the 'root@pam' user.", "user" : "all" }, "protected" : 1, @@ -32990,7 +33537,7 @@ var pveapi = [ "format" : "prune-backups", "optional" : 1, "type" : "string", - "typetext" : "[keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" + "typetext" : "[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" }, "storage" : { "description" : "The storage identifier.", @@ -33029,7 +33576,7 @@ var pveapi = [ }, "GET" : { "allowtoken" : 1, - "description" : "Get prune information for backups. NOTE: this is only a preview and might not be exactly what a subsequent prune call does, if the hour changes or if backups are removed/added in the meantime.", + "description" : "Get prune information for backups. NOTE: this is only a preview and might not be what a subsequent prune call does if backups are removed/added in the meantime.", "method" : "GET", "name" : "dryrun", "parameters" : { @@ -33046,7 +33593,7 @@ var pveapi = [ "format" : "prune-backups", "optional" : 1, "type" : "string", - "typetext" : "[keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" + "typetext" : "[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" }, "storage" : { "description" : "The storage identifier.", @@ -33208,6 +33755,31 @@ var pveapi = [ "protected" : 1, "proxyto" : "node", "returns" : { + "properties" : { + "format" : { + "description" : "Format identifier ('raw', 'qcow2', 'subvol', 'iso', 'tgz' ...)", + "type" : "string" + }, + "notes" : { + "description" : "Optional notes.", + "optional" : 1, + "type" : "string" + }, + "path" : { + "description" : "The Path", + "type" : "string" + }, + "size" : { + "description" : "Volume size in bytes.", + "renderer" : "bytes", + "type" : "integer" + }, + "used" : { + "description" : "Used space. Please note that most storage plugins do not report anything useful here.", + "renderer" : "bytes", + "type" : "integer" + } + }, "type" : "object" } }, @@ -33256,6 +33828,50 @@ var pveapi = [ "returns" : { "type" : "string" } + }, + "PUT" : { + "allowtoken" : 1, + "description" : "Update volume attributes", + "method" : "PUT", + "name" : "updateattributes", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "node" : { + "description" : "The cluster node name.", + "format" : "pve-node", + "type" : "string", + "typetext" : "" + }, + "notes" : { + "description" : "The new notes.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "storage" : { + "description" : "The storage identifier.", + "format" : "pve-storage-id", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "volume" : { + "description" : "Volume identifier", + "type" : "string", + "typetext" : "" + } + } + }, + "permissions" : { + "description" : "You need read access for the volume.", + "user" : "all" + }, + "protected" : 1, + "proxyto" : "node", + "returns" : { + "type" : "null" + } } }, "leaf" : 1, @@ -33328,6 +33944,11 @@ var pveapi = [ "description" : "Format identifier ('raw', 'qcow2', 'subvol', 'iso', 'tgz' ...)", "type" : "string" }, + "notes" : { + "description" : "Optional notes. If they contain multiple lines, only the first one is returned here.", + "optional" : 1, + "type" : "string" + }, "parent" : { "description" : "Volume identifier of parent (for linked cloned).", "optional" : 1, @@ -33344,6 +33965,21 @@ var pveapi = [ "renderer" : "bytes", "type" : "integer" }, + "verification" : { + "description" : "Last backup verification result, only useful for PBS storages.", + "optional" : 1, + "properties" : { + "state" : { + "description" : "Last backup verification state.", + "type" : "string" + }, + "upid" : { + "description" : "Last backup verification UPID.", + "type" : "string" + } + }, + "type" : "object" + }, "vmid" : { "description" : "Associated Owner VMID.", "optional" : 1, @@ -35133,6 +35769,10 @@ var pveapi = [ "optional" : 1, "type" : "integer" }, + "icmp-type" : { + "optional" : 1, + "type" : "string" + }, "iface" : { "optional" : 1, "type" : "string" @@ -35240,6 +35880,13 @@ var pveapi = [ "type" : "integer", "typetext" : " (0 - N)" }, + "icmp-type" : { + "description" : "Specify icmp-type. Only valid if proto equals 'icmp'.", + "format" : "pve-fw-icmp-type-spec", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "iface" : { "description" : "Network interface name. You have to use network configuration key names for VMs and containers ('net\\d+'). Host related rules can use arbitrary strings.", "format" : "pve-iface", @@ -35441,6 +36088,13 @@ var pveapi = [ "type" : "integer", "typetext" : " (0 - N)" }, + "icmp-type" : { + "description" : "Specify icmp-type. Only valid if proto equals 'icmp'.", + "format" : "pve-fw-icmp-type-spec", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "iface" : { "description" : "Network interface name. You have to use network configuration key names for VMs and containers ('net\\d+'). Host related rules can use arbitrary strings.", "format" : "pve-iface", @@ -37671,12 +38325,20 @@ var pveapi = [ "description" : "Run specific command or default to login.", "enum" : [ "login", - "ceph_install", - "upgrade" + "upgrade", + "ceph_install" ], "optional" : 1, "type" : "string" }, + "cmd-opts" : { + "default" : "", + "description" : "Add parameters to a command. Encoded as null terminated strings.", + "optional" : 1, + "requires" : "cmd", + "type" : "string", + "typetext" : "" + }, "height" : { "description" : "sets the height of the console in pixels.", "maximum" : 2160, @@ -37766,12 +38428,20 @@ var pveapi = [ "description" : "Run specific command or default to login.", "enum" : [ "login", - "ceph_install", - "upgrade" + "upgrade", + "ceph_install" ], "optional" : 1, "type" : "string" }, + "cmd-opts" : { + "default" : "", + "description" : "Add parameters to a command. Encoded as null terminated strings.", + "optional" : 1, + "requires" : "cmd", + "type" : "string", + "typetext" : "" + }, "node" : { "description" : "The cluster node name.", "format" : "pve-node", @@ -37891,12 +38561,20 @@ var pveapi = [ "description" : "Run specific command or default to login.", "enum" : [ "login", - "ceph_install", - "upgrade" + "upgrade", + "ceph_install" ], "optional" : 1, "type" : "string" }, + "cmd-opts" : { + "default" : "", + "description" : "Add parameters to a command. Encoded as null terminated strings.", + "optional" : 1, + "requires" : "cmd", + "type" : "string", + "typetext" : "" + }, "node" : { "description" : "The cluster node name.", "format" : "pve-node", @@ -38935,12 +39613,21 @@ var pveapi = [ "type" : "string", "typetext" : "" }, + "port" : { + "default" : 8007, + "description" : "For non default port.", + "maximum" : 65535, + "minimum" : 1, + "optional" : 1, + "type" : "integer", + "typetext" : " (1 - 65535)" + }, "prune-backups" : { "description" : "The retention options with shorter intervals are processed first with --keep-last being the very first one. Each option covers a specific period of time. We say that backups within this period are covered by this option. The next option does not take care of already covered backups and only considers older backups.", "format" : "prune-backups", "optional" : 1, "type" : "string", - "typetext" : "[keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" + "typetext" : "[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" }, "redundancy" : { "default" : 2, @@ -39049,7 +39736,46 @@ var pveapi = [ }, "protected" : 1, "returns" : { - "type" : "null" + "properties" : { + "config" : { + "additionalProperties" : 1, + "description" : "Partial, possible server generated, configuration properties.", + "optional" : 1, + "properties" : { + "encryption-key" : { + "description" : "The, possible auto-generated, encryption-key.", + "optional" : 1, + "type" : "string" + } + }, + "type" : "object" + }, + "storage" : { + "description" : "The ID of the created storage.", + "type" : "string" + }, + "type" : { + "description" : "The type of the created storage.", + "enum" : [ + "cephfs", + "cifs", + "dir", + "drbd", + "glusterfs", + "iscsi", + "iscsidirect", + "lvm", + "lvmthin", + "nfs", + "pbs", + "rbd", + "zfs", + "zfspool" + ], + "type" : "string" + } + }, + "type" : "object" } } }, @@ -39202,7 +39928,7 @@ var pveapi = [ "typetext" : "" }, "datastore" : { - "description" : "Proxmox backup server datastore name.", + "description" : "Proxmox Backup Server datastore name.", "optional" : 1, "type" : "string", "typetext" : "" @@ -39345,6 +40071,15 @@ var pveapi = [ "type" : "string", "typetext" : "" }, + "port" : { + "default" : 8007, + "description" : "For non default port.", + "maximum" : 65535, + "minimum" : 1, + "optional" : 1, + "type" : "integer", + "typetext" : " (1 - 65535)" + }, "portal" : { "description" : "iSCSI portal (IP or DNS name with optional port).", "format" : "pve-storage-portal-dns", @@ -39357,7 +40092,7 @@ var pveapi = [ "format" : "prune-backups", "optional" : 1, "type" : "string", - "typetext" : "[keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" + "typetext" : "[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]" }, "redundancy" : { "default" : 2, @@ -39518,7 +40253,46 @@ var pveapi = [ }, "protected" : 1, "returns" : { - "type" : "null" + "properties" : { + "config" : { + "additionalProperties" : 1, + "description" : "Partial, possible server generated, configuration properties.", + "optional" : 1, + "properties" : { + "encryption-key" : { + "description" : "The, possible auto-generated, encryption-key.", + "optional" : 1, + "type" : "string" + } + }, + "type" : "object" + }, + "storage" : { + "description" : "The ID of the created storage.", + "type" : "string" + }, + "type" : { + "description" : "The type of the created storage.", + "enum" : [ + "cephfs", + "cifs", + "dir", + "drbd", + "glusterfs", + "iscsi", + "iscsidirect", + "lvm", + "lvmthin", + "nfs", + "pbs", + "rbd", + "zfs", + "zfspool" + ], + "type" : "string" + } + }, + "type" : "object" } } }, @@ -41221,6 +41995,13 @@ var pveapi = [ "type" : "string", "typetext" : "" }, + "case-sensitive" : { + "default" : 1, + "description" : "username is case-sensitive", + "optional" : 1, + "type" : "boolean", + "typetext" : "" + }, "cert" : { "description" : "Path to the client certificate", "optional" : 1, @@ -41513,6 +42294,13 @@ var pveapi = [ "type" : "string", "typetext" : "" }, + "case-sensitive" : { + "default" : 1, + "description" : "username is case-sensitive", + "optional" : 1, + "type" : "boolean", + "typetext" : "" + }, "cert" : { "description" : "Path to the client certificate", "optional" : 1, diff --git a/pct.1-synopsis.adoc b/pct.1-synopsis.adoc index c3862db..3c6c51f 100644 --- a/pct.1-synopsis.adoc +++ b/pct.1-synopsis.adoc @@ -104,11 +104,11 @@ Console mode. By default, the console command tries to open a connection to one Attach a console device (/dev/console) to the container. -`--cores` ` (1 - 128)` :: +`--cores` ` (1 - 8192)` :: The number of cores assigned to the container. A container can use all available cores by default. -`--cpulimit` ` (0 - 128)` ('default =' `0`):: +`--cpulimit` ` (0 - 8192)` ('default =' `0`):: Limit of CPU usage. + @@ -326,7 +326,7 @@ A volume on which to run the filesystem check Force checking, even if the filesystem seems clean -*pct fstrim* `` +*pct fstrim* `` `[OPTIONS]` Run fstrim on a chosen CT and its mountpoints. @@ -334,6 +334,10 @@ Run fstrim on a chosen CT and its mountpoints. The (unique) ID of the VM. +`--ignore-mountpoints` `` :: + +Skip all mountpoints, only do fstrim on the container root. + *pct help* `[OPTIONS]` Get help about specified command. @@ -565,11 +569,11 @@ Console mode. By default, the console command tries to open a connection to one Attach a console device (/dev/console) to the container. -`--cores` ` (1 - 128)` :: +`--cores` ` (1 - 8192)` :: The number of cores assigned to the container. A container can use all available cores by default. -`--cpulimit` ` (0 - 128)` ('default =' `0`):: +`--cpulimit` ` (0 - 8192)` ('default =' `0`):: Limit of CPU usage. + @@ -747,11 +751,11 @@ Console mode. By default, the console command tries to open a connection to one Attach a console device (/dev/console) to the container. -`--cores` ` (1 - 128)` :: +`--cores` ` (1 - 8192)` :: The number of cores assigned to the container. A container can use all available cores by default. -`--cpulimit` ` (0 - 128)` ('default =' `0`):: +`--cpulimit` ` (0 - 8192)` ('default =' `0`):: Limit of CPU usage. + diff --git a/pct.conf.5-opts.adoc b/pct.conf.5-opts.adoc index 9102c6a..5e1c208 100644 --- a/pct.conf.5-opts.adoc +++ b/pct.conf.5-opts.adoc @@ -10,11 +10,11 @@ Console mode. By default, the console command tries to open a connection to one Attach a console device (/dev/console) to the container. -`cores`: ` (1 - 128)` :: +`cores`: ` (1 - 8192)` :: The number of cores assigned to the container. A container can use all available cores by default. -`cpulimit`: ` (0 - 128)` ('default =' `0`):: +`cpulimit`: ` (0 - 8192)` ('default =' `0`):: Limit of CPU usage. + diff --git a/pve-firewall-cluster-opts.adoc b/pve-firewall-cluster-opts.adoc index dbde950..d795e9f 100644 --- a/pve-firewall-cluster-opts.adoc +++ b/pve-firewall-cluster-opts.adoc @@ -12,7 +12,7 @@ Log ratelimiting settings `burst`=` (0 - N)` ('default =' `5`);; -Inital burst of packages which will get logged +Initial burst of packages which will always get logged before the rate is applied `enable`=`` ('default =' `1`);; diff --git a/pve-firewall-macros.adoc b/pve-firewall-macros.adoc index aad4150..87309ca 100644 --- a/pve-firewall-macros.adoc +++ b/pve-firewall-macros.adoc @@ -56,7 +56,7 @@ |=========================================================== [horizontal] -'Ceph':: Ceph Storage Cluster traffic (Ceph Monitors, OSD & MDS Deamons) +'Ceph':: Ceph Storage Cluster traffic (Ceph Monitors, OSD & MDS Daemons) [width="100%",options="header"] |=========================================================== @@ -182,7 +182,7 @@ |=========================================================== [horizontal] -'HKP':: OpenPGP HTTP keyserver protocol traffic +'HKP':: OpenPGP HTTP key server protocol traffic [width="100%",options="header"] |=========================================================== diff --git a/pve-firewall-rules-opts.adoc b/pve-firewall-rules-opts.adoc index 13ec8d8..4e674af 100644 --- a/pve-firewall-rules-opts.adoc +++ b/pve-firewall-rules-opts.adoc @@ -6,6 +6,10 @@ Restrict packet destination address. This can refer to a single IP address, an I Restrict TCP/UDP destination port. You can use service names or simple numbers (0-65535), as defined in '/etc/services'. Port ranges can be specified with '\d+:\d+', for example '80:85', and you can use comma separated list to match several ports or ranges. +`--icmp-type` `` :: + +Specify icmp-type. Only valid if proto equals 'icmp'. + `--iface` `` :: Network interface name. You have to use network configuration key names for VMs and containers ('net\d+'). Host related rules can use arbitrary strings. diff --git a/pveceph.1-synopsis.adoc b/pveceph.1-synopsis.adoc index 6d15c85..b5eaa87 100644 --- a/pveceph.1-synopsis.adoc +++ b/pveceph.1-synopsis.adoc @@ -226,9 +226,9 @@ The name of the pool. It must be unique. Configure VM and CT storage using the new pool. -`--application` `` :: +`--application` `` ('default =' `rbd`):: -The application of the pool, 'rbd' by default. +The application of the pool. `--crush_rule` `` :: @@ -238,6 +238,10 @@ The rule to use for mapping object placement in the cluster. Minimum number of replicas per object +`--pg_autoscale_mode` `` ('default =' `warn`):: + +The automatic PG scaling mode of the pool. + `--pg_num` ` (8 - 32768)` ('default =' `128`):: Number of placement groups. @@ -266,6 +270,38 @@ Remove all pveceph-managed storages configured for this pool List all pools. +*pveceph pool set* `` `[OPTIONS]` + +Change POOL settings + +``: `` :: + +The name of the pool. It must be unique. + +`--application` `` :: + +The application of the pool. + +`--crush_rule` `` :: + +The rule to use for mapping object placement in the cluster. + +`--min_size` ` (1 - 7)` :: + +Minimum number of replicas per object + +`--pg_autoscale_mode` `` :: + +The automatic PG scaling mode of the pool. + +`--pg_num` ` (8 - 32768)` :: + +Number of placement groups. + +`--size` ` (1 - 7)` :: + +Number of replicas per object + *pveceph purge* `[OPTIONS]` Destroy ceph related data and configuration files. diff --git a/pvesm.1-synopsis.adoc b/pvesm.1-synopsis.adoc index af25db2..d231c48 100644 --- a/pvesm.1-synopsis.adoc +++ b/pvesm.1-synopsis.adoc @@ -44,7 +44,7 @@ NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs. `--datastore` `` :: -Proxmox backup server datastore name. +Proxmox Backup Server datastore name. `--disable` `` :: @@ -130,11 +130,15 @@ File system path. Pool. +`--port` ` (1 - 65535)` ('default =' `8007`):: + +For non default port. + `--portal` `` :: iSCSI portal (IP or DNS name with optional port). -`--prune-backups` `[keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]` :: +`--prune-backups` `[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]` :: The retention options with shorter intervals are processed first with --keep-last being the very first one. Each option covers a specific period of time. We say that backups within this period are covered by this option. The next option does not take care of already covered backups and only considers older backups. @@ -384,7 +388,9 @@ Volume identifier *pvesm prune-backups* `` `[OPTIONS]` -Prune backups. This is only a wrapper for the proper API endpoints. +Prune backups. Only those using the standard naming scheme are considered. +If no keep options are specified, those from the storage configuration are +used. ``: `` :: @@ -394,9 +400,33 @@ The storage identifier. Only show what would be pruned, don't delete anything. -`--prune-backups` `[keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]` :: +`--keep-all` `` :: + +Keep all backups. Conflicts with the other options when true. + +`--keep-daily` `` :: + +Keep backups for the last different days. If there is morethan one backup for a single day, only the latest one is kept. + +`--keep-hourly` `` :: + +Keep backups for the last different hours. If there is morethan one backup for a single hour, only the latest one is kept. + +`--keep-last` `` :: -Use these retention options instead of those from the storage configuration. +Keep the last backups. + +`--keep-monthly` `` :: + +Keep backups for the last different months. If there is morethan one backup for a single month, only the latest one is kept. + +`--keep-weekly` `` :: + +Keep backups for the last different weeks. If there is morethan one backup for a single week, only the latest one is kept. + +`--keep-yearly` `` :: + +Keep backups for the last different years. If there is morethan one backup for a single year, only the latest one is kept. `--type` `` :: @@ -584,7 +614,11 @@ Password for accessing the share/datastore. Pool. -`--prune-backups` `[keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]` :: +`--port` ` (1 - 65535)` ('default =' `8007`):: + +For non default port. + +`--prune-backups` `[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]` :: The retention options with shorter intervals are processed first with --keep-last being the very first one. Each option covers a specific period of time. We say that backups within this period are covered by this option. The next option does not take care of already covered backups and only considers older backups. diff --git a/pveum.1-synopsis.adoc b/pveum.1-synopsis.adoc index 2822d41..e00cfdf 100644 --- a/pveum.1-synopsis.adoc +++ b/pveum.1-synopsis.adoc @@ -156,6 +156,10 @@ LDAP bind domain name Path to the CA certificate store +`--case-sensitive` `` ('default =' `1`):: + +username is case-sensitive + `--cert` `` :: Path to the client certificate @@ -284,6 +288,10 @@ LDAP bind domain name Path to the CA certificate store +`--case-sensitive` `` ('default =' `1`):: + +username is case-sensitive + `--cert` `` :: Path to the client certificate diff --git a/qm-cloud-init-opts.adoc b/qm-cloud-init-opts.adoc index 43e4415..a03f3ac 100644 --- a/qm-cloud-init-opts.adoc +++ b/qm-cloud-init-opts.adoc @@ -4,7 +4,8 @@ Specify custom files to replace the automatically generated ones at start. `meta`=`` ;; -Specify a custom file containing all meta data passed to the VM via cloud-init. This is provider specific meaning configdrive2 and nocloud differ. +Specify a custom file containing all meta data passed to the VM via" + ." cloud-init. This is provider specific meaning configdrive2 and nocloud differ. `network`=`` ;; @@ -32,10 +33,12 @@ Specify IP addresses and gateways for the corresponding interface. + IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified. + -The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided. +The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit +gateway should be provided. For IPv6 the special string 'auto' can be used to use stateless autoconfiguration. + -If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4. +If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using +dhcp on IPv4. `gw`=`` ;; @@ -59,11 +62,15 @@ IPv6 address in CIDR format. `nameserver`: `` :: -Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set. +Sets DNS server IP address for a container. Create will' + .' automatically use the setting from the host if neither searchdomain nor nameserver' + .' are set. `searchdomain`: `` :: -Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set. +Sets DNS search domains for a container. Create will' + .' automatically use the setting from the host if neither searchdomain nor nameserver' + .' are set. `sshkeys`: `` :: diff --git a/qm.1-synopsis.adoc b/qm.1-synopsis.adoc index be8288f..3f4964b 100644 --- a/qm.1-synopsis.adoc +++ b/qm.1-synopsis.adoc @@ -143,13 +143,13 @@ Amount of target RAM for the VM in MB. Using zero disables the ballon driver. Select BIOS implementation. -`--boot` `[acdn]{1,4}` ('default =' `cdn`):: +`--boot` `[[legacy=]<[acdn]{1,4}>] [,order=]` :: -Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n). +Specify guest boot order. Use with 'order=', usage with no key or 'legacy=' is deprecated. `--bootdisk` `(ide|sata|scsi|virtio)\d+` :: -Enable booting from specified disk. +Enable booting from specified disk. Deprecated: Use 'boot: order=foo;bar' instead. `--bwlimit` ` (0 - N)` ('default =' `restore limit from datacenter or storage config`):: @@ -235,15 +235,21 @@ cloud-init: Specify IP addresses and gateways for the corresponding interface. + IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified. + -The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided. +The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit +gateway should be provided. For IPv6 the special string 'auto' can be used to use stateless autoconfiguration. + -If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4. +If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using +dhcp on IPv4. `--ivshmem` `size= [,name=]` :: Inter-VM shared memory. Useful for direct communication between VMs, or to the host. +`--keephugepages` `` ('default =' `0`):: + +Use together with hugepages. If enabled, hugepages will not not be deleted after VM shutdown and can be used for subsequent starts. + `--keyboard` `` :: Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it. @@ -282,7 +288,9 @@ Set a name for the VM. Only used on the configuration web interface. `--nameserver` `` :: -cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set. +cloud-init: Sets DNS server IP address for a container. Create will' + .' automatically use the setting from the host if neither searchdomain nor nameserver' + .' are set. `--net[n]` `[model=] [,bridge=] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=] [,mtu=] [,queues=] [,rate=] [,tag=] [,trunks=] [,=]` :: @@ -338,7 +346,9 @@ SCSI controller model `--searchdomain` `` :: -cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set. +cloud-init: Sets DNS search domains for a container. Create will' + .' automatically use the setting from the host if neither searchdomain nor nameserver' + .' are set. `--serial[n]` `(/dev/.+|socket)` :: @@ -374,7 +384,7 @@ Start VM after it was created successfully. `--startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` ('default =' `now`):: -Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'. +Set the initial date of the real time clock. Valid format for date are:'now' or '2006-06-17T16:01:21' or '2006-06-17'. `--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` :: @@ -854,13 +864,13 @@ Amount of target RAM for the VM in MB. Using zero disables the ballon driver. Select BIOS implementation. -`--boot` `[acdn]{1,4}` ('default =' `cdn`):: +`--boot` `[[legacy=]<[acdn]{1,4}>] [,order=]` :: -Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n). +Specify guest boot order. Use with 'order=', usage with no key or 'legacy=' is deprecated. `--bootdisk` `(ide|sata|scsi|virtio)\d+` :: -Enable booting from specified disk. +Enable booting from specified disk. Deprecated: Use 'boot: order=foo;bar' instead. `--cdrom` `` :: @@ -950,15 +960,21 @@ cloud-init: Specify IP addresses and gateways for the corresponding interface. + IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified. + -The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided. +The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit +gateway should be provided. For IPv6 the special string 'auto' can be used to use stateless autoconfiguration. + -If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4. +If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using +dhcp on IPv4. `--ivshmem` `size= [,name=]` :: Inter-VM shared memory. Useful for direct communication between VMs, or to the host. +`--keephugepages` `` ('default =' `0`):: + +Use together with hugepages. If enabled, hugepages will not not be deleted after VM shutdown and can be used for subsequent starts. + `--keyboard` `` :: Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it. @@ -997,7 +1013,9 @@ Set a name for the VM. Only used on the configuration web interface. `--nameserver` `` :: -cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set. +cloud-init: Sets DNS server IP address for a container. Create will' + .' automatically use the setting from the host if neither searchdomain nor nameserver' + .' are set. `--net[n]` `[model=] [,bridge=] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=] [,mtu=] [,queues=] [,rate=] [,tag=] [,trunks=] [,=]` :: @@ -1053,7 +1071,9 @@ SCSI controller model `--searchdomain` `` :: -cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set. +cloud-init: Sets DNS search domains for a container. Create will' + .' automatically use the setting from the host if neither searchdomain nor nameserver' + .' are set. `--serial[n]` `(/dev/.+|socket)` :: @@ -1089,7 +1109,7 @@ cloud-init: Setup public SSH keys (one key per line, OpenSSH format). `--startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` ('default =' `now`):: -Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'. +Set the initial date of the real time clock. Valid format for date are:'now' or '2006-06-17T16:01:21' or '2006-06-17'. `--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` :: diff --git a/qm.conf.5-opts.adoc b/qm.conf.5-opts.adoc index fc9606c..07bd624 100644 --- a/qm.conf.5-opts.adoc +++ b/qm.conf.5-opts.adoc @@ -54,13 +54,31 @@ Amount of target RAM for the VM in MB. Using zero disables the ballon driver. Select BIOS implementation. -`boot`: `[acdn]{1,4}` ('default =' `cdn`):: +`boot`: `[[legacy=]<[acdn]{1,4}>] [,order=]` :: -Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n). +Specify guest boot order. Use with 'order=', usage with no key or 'legacy=' is deprecated. + +`legacy`=`<[acdn]{1,4}>` ('default =' `cdn`);; + +Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n). Deprecated, use 'order=' instead. + +`order`=`` ;; + +The guest will attempt to boot from devices in the order they appear here. ++ +Disks, optical drives and passed-through storage USB devices will be directly +booted from, NICs will load PXE, and PCIe devices will either behave like disks +(e.g. NVMe) or load an option ROM (e.g. RAID controller, hardware NIC). ++ +Note that only devices in this list will be marked as bootable and thus loaded +by the guest firmware (BIOS/UEFI). If you require multiple disks for booting +(e.g. software-raid), you need to specify all of them here. ++ +Overrides the deprecated 'legacy=[acdn]*' value when given. `bootdisk`: `(ide|sata|scsi|virtio)\d+` :: -Enable booting from specified disk. +Enable booting from specified disk. Deprecated: Use 'boot: order=foo;bar' instead. `cdrom`: `` :: @@ -72,7 +90,8 @@ cloud-init: Specify custom files to replace the automatically generated ones at `meta`=`` ;; -Specify a custom file containing all meta data passed to the VM via cloud-init. This is provider specific meaning configdrive2 and nocloud differ. +Specify a custom file containing all meta data passed to the VM via" + ." cloud-init. This is provider specific meaning configdrive2 and nocloud differ. `network`=`` ;; @@ -400,10 +419,12 @@ cloud-init: Specify IP addresses and gateways for the corresponding interface. + IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified. + -The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided. +The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit +gateway should be provided. For IPv6 the special string 'auto' can be used to use stateless autoconfiguration. + -If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4. +If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using +dhcp on IPv4. `gw`=`` ;; @@ -437,6 +458,10 @@ The name of the file. Will be prefixed with 'pve-shm-'. Default is the VMID. Wil The size of the file in MB. +`keephugepages`: `` ('default =' `0`):: + +Use together with hugepages. If enabled, hugepages will not not be deleted after VM shutdown and can be used for subsequent starts. + `keyboard`: `` :: Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.It should not be necessary to set it. @@ -475,7 +500,9 @@ Set a name for the VM. Only used on the configuration web interface. `nameserver`: `` :: -cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set. +cloud-init: Sets DNS server IP address for a container. Create will' + .' automatically use the setting from the host if neither searchdomain nor nameserver' + .' are set. `net[n]`: `[model=] [,bridge=] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=] [,mtu=] [,queues=] [,rate=] [,tag=] [,trunks=] [,=]` :: @@ -583,7 +610,8 @@ solaris;; Solaris/OpenSolaris/OpenIndiania kernel Map host parallel devices (n is 0 to 2). + -NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. +NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such +machines - use with special care. + CAUTION: Experimental! User reported problems with this option. @@ -979,7 +1007,9 @@ SCSI controller model `searchdomain`: `` :: -cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set. +cloud-init: Sets DNS search domains for a container. Create will' + .' automatically use the setting from the host if neither searchdomain nor nameserver' + .' are set. `serial[n]`: `(/dev/.+|socket)` :: @@ -987,7 +1017,8 @@ Create a serial device inside the VM (n is 0 to 3), and pass through a host serial device (i.e. /dev/ttyS0), or create a unix socket on the host side (use 'qm terminal' to open a terminal connection). + -NOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care. +NOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - +use with special care. + CAUTION: Experimental! User reported problems with this option. @@ -1057,7 +1088,7 @@ cloud-init: Setup public SSH keys (one key per line, OpenSSH format). `startdate`: `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` ('default =' `now`):: -Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'. +Set the initial date of the real time clock. Valid format for date are:'now' or '2006-06-17T16:01:21' or '2006-06-17'. `startup`: `[[order=]\d+] [,up=\d+] [,down=\d+] ` :: @@ -1065,7 +1096,7 @@ Startup and shutdown behavior. Order is a non-negative number defining the gener `tablet`: `` ('default =' `1`):: -Enable/disable the USB tablet device. This device is usually needed to allow absolute mouse positioning with VNC. Else the mouse runs out of sync with normal VNC clients. If you're running lots of console-only guests on one host, you may consider disabling this to save some context switches. This is turned off by default if you use spice (-vga=qxl). +Enable/disable the USB tablet device. This device is usually needed to allow absolute mouse positioning with VNC. Else the mouse runs out of sync with normal VNC clients. If you're running lots of console-only guests on one host, you may consider disabling this to save some context switches. This is turned off by default if you use spice (`qm set --vga qxl`). `tags`: `` :: @@ -1101,7 +1132,8 @@ The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is: + You can use the 'lsusb -t' command to list existing usb devices. + -NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. +NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such +machines - use with special care. + The value 'spice' can be used to add a usb redirection devices for spice. @@ -1299,7 +1331,7 @@ Write error action. `vmgenid`: `` ('default =' `1 (autogenerated)`):: The VM generation ID (vmgenid) device exposes a 128-bit integer value identifier to the guest OS. This allows to notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template). The guest operating system notices the change, and is then able to react as appropriate by marking its copies of distributed databases as dirty, re-initializing its random number generator, etc. -Note that auto-creation only works when done throug API/CLI create or update methods, but not when manually editing the config file. +Note that auto-creation only works when done through API/CLI create or update methods, but not when manually editing the config file. `vmstatestorage`: `` :: diff --git a/vzdump.1-synopsis.adoc b/vzdump.1-synopsis.adoc index 7458711..6036647 100644 --- a/vzdump.1-synopsis.adoc +++ b/vzdump.1-synopsis.adoc @@ -68,7 +68,7 @@ Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread Backup all known guest systems included in the specified pool. -`--prune-backups` `[keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]` :: +`--prune-backups` `[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]` :: Use these retention options instead of those from the storage configuration. diff --git a/vzdump.conf.5-opts.adoc b/vzdump.conf.5-opts.adoc index b262499..21b96e8 100644 --- a/vzdump.conf.5-opts.adoc +++ b/vzdump.conf.5-opts.adoc @@ -46,10 +46,14 @@ Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread Backup all known guest systems included in the specified pool. -`prune-backups`: `[keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]` :: +`prune-backups`: `[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]` :: Use these retention options instead of those from the storage configuration. +`keep-all`=`` ;; + +Keep all backups. Conflicts with the other options when true. + `keep-daily`=`` ;; Keep backups for the last different days. If there is morethan one backup for a single day, only the latest one is kept. -- 2.39.2