From bd92b745807e5173d7d30769007fa634119bbcd8 Mon Sep 17 00:00:00 2001 From: Thomas Lamprecht Date: Fri, 17 Nov 2023 13:35:08 +0100 Subject: [PATCH] update static/schema information Signed-off-by: Thomas Lamprecht --- api-viewer/apidata.js | 288 +++++++++++++++++++++++--------- pvenode.1-synopsis.adoc | 4 +- pvesubscription.1-synopsis.adoc | 2 +- qm.1-synopsis.adoc | 8 +- qm.conf.5-opts.adoc | 20 ++- 5 files changed, 225 insertions(+), 97 deletions(-) diff --git a/api-viewer/apidata.js b/api-viewer/apidata.js index abeeb7b..2b09bc7 100644 --- a/api-viewer/apidata.js +++ b/api-viewer/apidata.js @@ -6745,12 +6745,14 @@ const apiSchema = [ "ad", "ali", "anx", + "artfiles", "arvan", "aurora", "autodns", "aws", "azion", "azure", + "bookmyname", "bunny", "cf", "clouddns", @@ -6766,6 +6768,7 @@ const apiSchema = [ "desec", "df", "dgon", + "dnsexit", "dnshome", "dnsimple", "dnsservices", @@ -6863,6 +6866,7 @@ const apiSchema = [ "servercow", "simply", "tele3", + "tencent", "transip", "udr", "ultra", @@ -7023,12 +7027,14 @@ const apiSchema = [ "ad", "ali", "anx", + "artfiles", "arvan", "aurora", "autodns", "aws", "azion", "azure", + "bookmyname", "bunny", "cf", "clouddns", @@ -7044,6 +7050,7 @@ const apiSchema = [ "desec", "df", "dgon", + "dnsexit", "dnshome", "dnsimple", "dnsservices", @@ -7141,6 +7148,7 @@ const apiSchema = [ "servercow", "simply", "tele3", + "tencent", "transip", "udr", "ultra", @@ -9320,13 +9328,8 @@ const apiSchema = [ } }, "permissions" : { - "check" : [ - "perm", - "/sdn/vnets/{vnet}/subnets", - [ - "SDN.Allocate" - ] - ] + "description" : "Require 'SDN.Allocate' permission on '/sdn/zones//'", + "user" : "all" }, "protected" : 1, "returns" : { @@ -9368,13 +9371,8 @@ const apiSchema = [ } }, "permissions" : { - "check" : [ - "perm", - "/sdn/vnets/{vnet}/subnets/{subnet}", - [ - "SDN.Allocate" - ] - ] + "description" : "Require 'SDN.Audit' or 'SDN.Allocate' permissions on '/sdn/zones//'", + "user" : "all" }, "returns" : { "type" : "object" @@ -9439,13 +9437,8 @@ const apiSchema = [ "type" : "object" }, "permissions" : { - "check" : [ - "perm", - "/sdn/vnets/{vnet}/subnets", - [ - "SDN.Allocate" - ] - ] + "description" : "Require 'SDN.Allocate' permission on '/sdn/zones//'", + "user" : "all" }, "protected" : 1, "returns" : { @@ -9488,7 +9481,7 @@ const apiSchema = [ } }, "permissions" : { - "description" : "Only list entries where you have 'SDN.Audit' or 'SDN.Allocate' permissions on '/sdn/subnets/'", + "description" : "Only list entries where you have 'SDN.Audit' or 'SDN.Allocate' permissions on '/sdn/zones//'", "user" : "all" }, "returns" : { @@ -9555,13 +9548,8 @@ const apiSchema = [ "type" : "object" }, "permissions" : { - "check" : [ - "perm", - "/sdn/vnets/{vnet}/subnets", - [ - "SDN.Allocate" - ] - ] + "description" : "Require 'SDN.Allocate' permission on '/sdn/zones//'", + "user" : "all" }, "protected" : 1, "returns" : { @@ -9592,13 +9580,8 @@ const apiSchema = [ } }, "permissions" : { - "check" : [ - "perm", - "/sdn/vnets", - [ - "SDN.Allocate" - ] - ] + "description" : "Require 'SDN.Allocate' permission on '/sdn/zones//'", + "user" : "all" }, "protected" : 1, "returns" : { @@ -9634,13 +9617,8 @@ const apiSchema = [ } }, "permissions" : { - "check" : [ - "perm", - "/sdn/vnets/{vnet}", - [ - "SDN.Allocate" - ] - ] + "description" : "Require 'SDN.Audit' or 'SDN.Allocate' permissions on '/sdn/zones//'", + "user" : "all" }, "returns" : { "type" : "object" @@ -9704,13 +9682,8 @@ const apiSchema = [ "type" : "object" }, "permissions" : { - "check" : [ - "perm", - "/sdn/vnets", - [ - "SDN.Allocate" - ] - ] + "description" : "Require 'SDN.Allocate' permission on '/sdn/zones//'", + "user" : "all" }, "protected" : 1, "returns" : { @@ -9747,7 +9720,7 @@ const apiSchema = [ } }, "permissions" : { - "description" : "Only list entries where you have 'SDN.Audit' or 'SDN.Allocate' permissions on '/sdn/vnets/'", + "description" : "Only list entries where you have 'SDN.Audit' or 'SDN.Allocate' permissions on '/sdn/zones//'", "user" : "all" }, "returns" : { @@ -9817,7 +9790,7 @@ const apiSchema = [ "permissions" : { "check" : [ "perm", - "/sdn/vnets", + "/sdn/zones/{zone}", [ "SDN.Allocate" ] @@ -9856,7 +9829,7 @@ const apiSchema = [ "permissions" : { "check" : [ "perm", - "/sdn/zones", + "/sdn/zones/{zone}", [ "SDN.Allocate" ] @@ -10087,7 +10060,7 @@ const apiSchema = [ "permissions" : { "check" : [ "perm", - "/sdn/zones", + "/sdn/zones/{zone}", [ "SDN.Allocate" ] @@ -10517,6 +10490,25 @@ const apiSchema = [ "type" : "integer", "typetext" : "" }, + "isis-domain" : { + "description" : "ISIS domain.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "isis-ifaces" : { + "description" : "ISIS interface.", + "format" : "pve-iface-list", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "isis-net" : { + "description" : "ISIS network entity title.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "loopback" : { "description" : "source loopback interface.", "optional" : 1, @@ -10586,7 +10578,8 @@ const apiSchema = [ "enum" : [ "bgp", "evpn", - "faucet" + "faucet", + "isis" ], "optional" : 1, "type" : "string" @@ -10663,6 +10656,25 @@ const apiSchema = [ "type" : "integer", "typetext" : "" }, + "isis-domain" : { + "description" : "ISIS domain.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "isis-ifaces" : { + "description" : "ISIS interface.", + "format" : "pve-iface-list", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "isis-net" : { + "description" : "ISIS network entity title.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "loopback" : { "description" : "source loopback interface.", "optional" : 1, @@ -10688,7 +10700,8 @@ const apiSchema = [ "enum" : [ "bgp", "evpn", - "faucet" + "faucet", + "isis" ], "format" : "pve-configid", "type" : "string" @@ -11213,7 +11226,7 @@ const apiSchema = [ "permissions" : { "check" : [ "perm", - "/", + "/sdn", [ "SDN.Audit" ] @@ -15860,7 +15873,7 @@ const apiSchema = [ "format" : { "efitype" : { "default" : "2m", - "description" : "Size and type of the OVMF EFI vars. '4m' is newer and recommended, and required for Secure Boot. For backwards compatibility, '2m' is used if not otherwise specified. Ignored for VMs with arch=aarc64 (ARM).", + "description" : "Size and type of the OVMF EFI vars. '4m' is newer and recommended, and required for Secure Boot. For backwards compatibility, '2m' is used if not otherwise specified. Ignored for VMs with arch=aarch64 (ARM).", "enum" : [ "2m", "4m" @@ -16368,11 +16381,18 @@ const apiSchema = [ "type" : "string" }, "memory" : { - "default" : 512, - "description" : "Amount of RAM for the VM in MiB. This is the maximum available memory when you use the balloon device.", - "minimum" : 16, + "description" : "Memory properties.", + "format" : { + "current" : { + "default" : 512, + "default_key" : 1, + "description" : "Current amount of online RAM for the VM in MiB. This is the maximum available memory when you use the balloon device.", + "minimum" : 16, + "type" : "integer" + } + }, "optional" : 1, - "type" : "integer" + "type" : "string" }, "migrate_downtime" : { "default" : 0.1, @@ -18156,7 +18176,7 @@ const apiSchema = [ "format" : { "efitype" : { "default" : "2m", - "description" : "Size and type of the OVMF EFI vars. '4m' is newer and recommended, and required for Secure Boot. For backwards compatibility, '2m' is used if not otherwise specified. Ignored for VMs with arch=aarc64 (ARM).", + "description" : "Size and type of the OVMF EFI vars. '4m' is newer and recommended, and required for Secure Boot. For backwards compatibility, '2m' is used if not otherwise specified. Ignored for VMs with arch=aarch64 (ARM).", "enum" : [ "2m", "4m" @@ -18696,12 +18716,19 @@ const apiSchema = [ "type" : "string" }, "memory" : { - "default" : 512, - "description" : "Amount of RAM for the VM in MiB. This is the maximum available memory when you use the balloon device.", - "minimum" : 16, + "description" : "Memory properties.", + "format" : { + "current" : { + "default" : 512, + "default_key" : 1, + "description" : "Current amount of online RAM for the VM in MiB. This is the maximum available memory when you use the balloon device.", + "minimum" : 16, + "type" : "integer" + } + }, "optional" : 1, - "type" : "integer", - "typetext" : " (16 - N)" + "type" : "string", + "typetext" : "[current=]" }, "migrate_downtime" : { "default" : 0.1, @@ -20587,7 +20614,7 @@ const apiSchema = [ "format" : { "efitype" : { "default" : "2m", - "description" : "Size and type of the OVMF EFI vars. '4m' is newer and recommended, and required for Secure Boot. For backwards compatibility, '2m' is used if not otherwise specified. Ignored for VMs with arch=aarc64 (ARM).", + "description" : "Size and type of the OVMF EFI vars. '4m' is newer and recommended, and required for Secure Boot. For backwards compatibility, '2m' is used if not otherwise specified. Ignored for VMs with arch=aarch64 (ARM).", "enum" : [ "2m", "4m" @@ -21127,12 +21154,19 @@ const apiSchema = [ "type" : "string" }, "memory" : { - "default" : 512, - "description" : "Amount of RAM for the VM in MiB. This is the maximum available memory when you use the balloon device.", - "minimum" : 16, + "description" : "Memory properties.", + "format" : { + "current" : { + "default" : 512, + "default_key" : 1, + "description" : "Current amount of online RAM for the VM in MiB. This is the maximum available memory when you use the balloon device.", + "minimum" : 16, + "type" : "integer" + } + }, "optional" : 1, - "type" : "integer", - "typetext" : " (16 - N)" + "type" : "string", + "typetext" : "[current=]" }, "migrate_downtime" : { "default" : 0.1, @@ -23106,7 +23140,7 @@ const apiSchema = [ "typetext" : " (100 - 999999999)" }, "websocket" : { - "description" : "starts websockify instead of vncproxy", + "description" : "Prepare for websocket upgrade (only required when using serial terminal, otherwise upgrade is always possible).", "optional" : 1, "type" : "boolean", "typetext" : "" @@ -26658,7 +26692,7 @@ const apiSchema = [ "format" : { "efitype" : { "default" : "2m", - "description" : "Size and type of the OVMF EFI vars. '4m' is newer and recommended, and required for Secure Boot. For backwards compatibility, '2m' is used if not otherwise specified. Ignored for VMs with arch=aarc64 (ARM).", + "description" : "Size and type of the OVMF EFI vars. '4m' is newer and recommended, and required for Secure Boot. For backwards compatibility, '2m' is used if not otherwise specified. Ignored for VMs with arch=aarch64 (ARM).", "enum" : [ "2m", "4m" @@ -27205,12 +27239,19 @@ const apiSchema = [ "type" : "string" }, "memory" : { - "default" : 512, - "description" : "Amount of RAM for the VM in MiB. This is the maximum available memory when you use the balloon device.", - "minimum" : 16, + "description" : "Memory properties.", + "format" : { + "current" : { + "default" : 512, + "default_key" : 1, + "description" : "Current amount of online RAM for the VM in MiB. This is the maximum available memory when you use the balloon device.", + "minimum" : 16, + "type" : "integer" + } + }, "optional" : 1, - "type" : "integer", - "typetext" : " (16 - N)" + "type" : "string", + "typetext" : "[current=]" }, "migrate_downtime" : { "default" : 0.1, @@ -35151,6 +35192,76 @@ const apiSchema = [ "path" : "/nodes/{node}/lxc/{vmid}/pending", "text" : "pending" }, + { + "info" : { + "GET" : { + "allowtoken" : 1, + "description" : "Get IP addresses of the specified container interface.", + "method" : "GET", + "name" : "ip", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "node" : { + "description" : "The cluster node name.", + "format" : "pve-node", + "type" : "string", + "typetext" : "" + }, + "vmid" : { + "description" : "The (unique) ID of the VM.", + "format" : "pve-vmid", + "maximum" : 999999999, + "minimum" : 100, + "type" : "integer", + "typetext" : " (100 - 999999999)" + } + } + }, + "permissions" : { + "check" : [ + "perm", + "/vms/{vmid}", + [ + "VM.Audit" + ] + ] + }, + "protected" : 1, + "returns" : { + "items" : { + "properties" : { + "hwaddr" : { + "description" : "The MAC address of the interface", + "optional" : 0, + "type" : "string" + }, + "inet" : { + "description" : "The IPv4 address of the interface", + "optional" : 1, + "type" : "string" + }, + "inet6" : { + "description" : "The IPv6 address of the interface", + "optional" : 1, + "type" : "string" + }, + "name" : { + "description" : "The name of the interface", + "optional" : 0, + "type" : "string" + } + }, + "type" : "object" + }, + "type" : "array" + } + } + }, + "leaf" : 1, + "path" : "/nodes/{node}/lxc/{vmid}/interfaces", + "text" : "interfaces" + }, { "info" : { "POST" : { @@ -39829,7 +39940,7 @@ const apiSchema = [ "key" : { "description" : "Proxmox VE subscription key", "maxLength" : 32, - "pattern" : "pve([1248])([cbsp])-[0-9a-f]{10}", + "pattern" : "\\s*pve([1248])([cbsp])-[0-9a-f]{10}\\s*", "type" : "string" }, "node" : { @@ -42725,6 +42836,13 @@ const apiSchema = [ "type" : "string", "typetext" : "" }, + "tar" : { + "default" : 0, + "description" : "Download dirs as 'tar.zst' instead of 'zip'.", + "optional" : 1, + "type" : "boolean", + "typetext" : "" + }, "volume" : { "description" : "Backup volume ID or name. Currently only PBS snapshots are supported.", "type" : "string", @@ -44337,6 +44455,12 @@ const apiSchema = [ "osdid" : { "type" : "integer" }, + "osdid-list" : { + "items" : { + "type" : "integer" + }, + "type" : "array" + }, "parent" : { "description" : "For partitions only. The device path of the disk the partition resides on.", "optional" : 1, diff --git a/pvenode.1-synopsis.adoc b/pvenode.1-synopsis.adoc index c0acf81..7f7085a 100644 --- a/pvenode.1-synopsis.adoc +++ b/pvenode.1-synopsis.adoc @@ -81,7 +81,7 @@ ACME challenge type. ACME Plugin ID name -`--api` `<1984hosting | acmedns | acmeproxy | active24 | ad | ali | anx | arvan | aurora | autodns | aws | azion | azure | bunny | cf | clouddns | cloudns | cn | conoha | constellix | cpanel | curanet | cyon | da | ddnss | desec | df | dgon | dnshome | dnsimple | dnsservices | do | doapi | domeneshop | dp | dpi | dreamhost | duckdns | durabledns | dyn | dynu | dynv6 | easydns | edgedns | euserv | exoscale | fornex | freedns | gandi_livedns | gcloud | gcore | gd | geoscaling | googledomains | he | hetzner | hexonet | hostingde | huaweicloud | infoblox | infomaniak | internetbs | inwx | ionos | ipv64 | ispconfig | jd | joker | kappernet | kas | kinghost | knot | la | leaseweb | lexicon | linode | linode_v4 | loopia | lua | maradns | me | miab | misaka | myapi | mydevil | mydnsjp | mythic_beasts | namecheap | namecom | namesilo | nanelo | nederhost | neodigit | netcup | netlify | nic | njalla | nm | nsd | nsone | nsupdate | nw | oci | one | online | openprovider | openstack | opnsense | ovh | pdns | pleskxml | pointhq | porkbun | rackcorp | rackspace | rage4 | rcode0 | regru | scaleway | schlundtech | selectel | selfhost | servercow | simply | tele3 | transip | udr | ultra | unoeuro | variomedia | veesp | vercel | vscale | vultr | websupport | world4you | yandex | yc | zilore | zone | zonomi>` :: +`--api` `<1984hosting | acmedns | acmeproxy | active24 | ad | ali | anx | artfiles | arvan | aurora | autodns | aws | azion | azure | bookmyname | bunny | cf | clouddns | cloudns | cn | conoha | constellix | cpanel | curanet | cyon | da | ddnss | desec | df | dgon | dnsexit | dnshome | dnsimple | dnsservices | do | doapi | domeneshop | dp | dpi | dreamhost | duckdns | durabledns | dyn | dynu | dynv6 | easydns | edgedns | euserv | exoscale | fornex | freedns | gandi_livedns | gcloud | gcore | gd | geoscaling | googledomains | he | hetzner | hexonet | hostingde | huaweicloud | infoblox | infomaniak | internetbs | inwx | ionos | ipv64 | ispconfig | jd | joker | kappernet | kas | kinghost | knot | la | leaseweb | lexicon | linode | linode_v4 | loopia | lua | maradns | me | miab | misaka | myapi | mydevil | mydnsjp | mythic_beasts | namecheap | namecom | namesilo | nanelo | nederhost | neodigit | netcup | netlify | nic | njalla | nm | nsd | nsone | nsupdate | nw | oci | one | online | openprovider | openstack | opnsense | ovh | pdns | pleskxml | pointhq | porkbun | rackcorp | rackspace | rage4 | rcode0 | regru | scaleway | schlundtech | selectel | selfhost | servercow | simply | tele3 | tencent | transip | udr | ultra | unoeuro | variomedia | veesp | vercel | vscale | vultr | websupport | world4you | yandex | yc | zilore | zone | zonomi>` :: API plugin name @@ -133,7 +133,7 @@ Update ACME plugin configuration. ACME Plugin ID name -`--api` `<1984hosting | acmedns | acmeproxy | active24 | ad | ali | anx | arvan | aurora | autodns | aws | azion | azure | bunny | cf | clouddns | cloudns | cn | conoha | constellix | cpanel | curanet | cyon | da | ddnss | desec | df | dgon | dnshome | dnsimple | dnsservices | do | doapi | domeneshop | dp | dpi | dreamhost | duckdns | durabledns | dyn | dynu | dynv6 | easydns | edgedns | euserv | exoscale | fornex | freedns | gandi_livedns | gcloud | gcore | gd | geoscaling | googledomains | he | hetzner | hexonet | hostingde | huaweicloud | infoblox | infomaniak | internetbs | inwx | ionos | ipv64 | ispconfig | jd | joker | kappernet | kas | kinghost | knot | la | leaseweb | lexicon | linode | linode_v4 | loopia | lua | maradns | me | miab | misaka | myapi | mydevil | mydnsjp | mythic_beasts | namecheap | namecom | namesilo | nanelo | nederhost | neodigit | netcup | netlify | nic | njalla | nm | nsd | nsone | nsupdate | nw | oci | one | online | openprovider | openstack | opnsense | ovh | pdns | pleskxml | pointhq | porkbun | rackcorp | rackspace | rage4 | rcode0 | regru | scaleway | schlundtech | selectel | selfhost | servercow | simply | tele3 | transip | udr | ultra | unoeuro | variomedia | veesp | vercel | vscale | vultr | websupport | world4you | yandex | yc | zilore | zone | zonomi>` :: +`--api` `<1984hosting | acmedns | acmeproxy | active24 | ad | ali | anx | artfiles | arvan | aurora | autodns | aws | azion | azure | bookmyname | bunny | cf | clouddns | cloudns | cn | conoha | constellix | cpanel | curanet | cyon | da | ddnss | desec | df | dgon | dnsexit | dnshome | dnsimple | dnsservices | do | doapi | domeneshop | dp | dpi | dreamhost | duckdns | durabledns | dyn | dynu | dynv6 | easydns | edgedns | euserv | exoscale | fornex | freedns | gandi_livedns | gcloud | gcore | gd | geoscaling | googledomains | he | hetzner | hexonet | hostingde | huaweicloud | infoblox | infomaniak | internetbs | inwx | ionos | ipv64 | ispconfig | jd | joker | kappernet | kas | kinghost | knot | la | leaseweb | lexicon | linode | linode_v4 | loopia | lua | maradns | me | miab | misaka | myapi | mydevil | mydnsjp | mythic_beasts | namecheap | namecom | namesilo | nanelo | nederhost | neodigit | netcup | netlify | nic | njalla | nm | nsd | nsone | nsupdate | nw | oci | one | online | openprovider | openstack | opnsense | ovh | pdns | pleskxml | pointhq | porkbun | rackcorp | rackspace | rage4 | rcode0 | regru | scaleway | schlundtech | selectel | selfhost | servercow | simply | tele3 | tencent | transip | udr | ultra | unoeuro | variomedia | veesp | vercel | vscale | vultr | websupport | world4you | yandex | yc | zilore | zone | zonomi>` :: API plugin name diff --git a/pvesubscription.1-synopsis.adoc b/pvesubscription.1-synopsis.adoc index 5984633..3ec7d22 100644 --- a/pvesubscription.1-synopsis.adoc +++ b/pvesubscription.1-synopsis.adoc @@ -24,7 +24,7 @@ Verbose output format. Set subscription key. -``: `pve([1248])([cbsp])-[0-9a-f]{10}` :: +``: `\s*pve([1248])([cbsp])-[0-9a-f]{10}\s*` :: Proxmox VE subscription key diff --git a/qm.1-synopsis.adoc b/qm.1-synopsis.adoc index 01a8bce..fb2f2bc 100644 --- a/qm.1-synopsis.adoc +++ b/qm.1-synopsis.adoc @@ -301,9 +301,9 @@ Lock/unlock the VM. Specifies the QEMU machine type. -`--memory` ` (16 - N)` ('default =' `512`):: +`--memory` `[current=]` :: -Amount of RAM for the VM in MiB. This is the maximum available memory when you use the balloon device. +Memory properties. `--migrate_downtime` ` (0 - N)` ('default =' `0.1`):: @@ -1131,9 +1131,9 @@ Lock/unlock the VM. Specifies the QEMU machine type. -`--memory` ` (16 - N)` ('default =' `512`):: +`--memory` `[current=]` :: -Amount of RAM for the VM in MiB. This is the maximum available memory when you use the balloon device. +Memory properties. `--migrate_downtime` ` (0 - N)` ('default =' `0.1`):: diff --git a/qm.conf.5-opts.adoc b/qm.conf.5-opts.adoc index 19579cc..cd51cc8 100644 --- a/qm.conf.5-opts.adoc +++ b/qm.conf.5-opts.adoc @@ -74,9 +74,9 @@ Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n). Deprecated, use ' The guest will attempt to boot from devices in the order they appear here. + -Disks, optical drives and storage USB devices that are passed through 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). +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 @@ -181,7 +181,7 @@ Configure a disk for storing EFI vars. `efitype`=`<2m | 4m>` ('default =' `2m`);; -Size and type of the OVMF EFI vars. '4m' is newer and recommended, and required for Secure Boot. For backwards compatibility, '2m' is used if not otherwise specified. Ignored for VMs with arch=aarc64 (ARM). +Size and type of the OVMF EFI vars. '4m' is newer and recommended, and required for Secure Boot. For backwards compatibility, '2m' is used if not otherwise specified. Ignored for VMs with arch=aarch64 (ARM). `file`=`` ;; @@ -222,7 +222,7 @@ Override PCI device ID visible to guest `host`=`` ;; -Pass through host PCI device. The PCI ID of a host's PCI device or a list +Host PCI device pass through. The PCI ID of a host's PCI device or a list of PCI virtual functions of the host. HOSTPCIID syntax is: + 'bus:dev.func' (hexadecimal numbers) @@ -529,9 +529,13 @@ Lock/unlock the VM. Specifies the QEMU machine type. -`memory`: ` (16 - N)` ('default =' `512`):: +`memory`: `[current=]` :: -Amount of RAM for the VM in MiB. This is the maximum available memory when you use the balloon device. +Memory properties. + +`current`=` (16 - N)` ('default =' `512`);; + +Current amount of online RAM for the VM in MiB. This is the maximum available memory when you use the balloon device. `migrate_downtime`: ` (0 - N)` ('default =' `0.1`):: @@ -1194,7 +1198,7 @@ The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is: 'vendor_id:product_id' (hexadeciaml numbers) or 'spice' + -You can use the 'lsusb -t' command to list existing USB devices. +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. -- 2.39.5