-h

顯示幫助并退出

-version

顯示版本信息并退出

-machine?[type=]name[,prop=value[,...]]

按名稱選擇模擬計(jì)算機(jī)。用于列出可用計(jì)算機(jī)。-machine?help

對于旨在支持跨版本的實(shí)時(shí)遷移兼容性的體系結(jié)構(gòu)，每個(gè)版本都將引入新版本的計(jì)算機(jī)類型。例如，2.8.0 版本為 x86_64/i686 體系結(jié)構(gòu)引入了計(jì)算機(jī)類型“pc-i440fx-2.8”和“pc-q35-2.8”。

要允許來賓從 QEMU 版本 2.8.0 實(shí)時(shí)遷移到 QEMU 版本 2.9.0，2.9.0 版本也必須支持“pc-i440fx-2.8”和“pc-q35-2.8”計(jì)算機(jī)。為了允許用戶實(shí)時(shí)遷移 VM 在升級時(shí)跳過多個(gè)中間版本，新版本的 QEMU 將支持許多以前版本中的計(jì)算機(jī)類型。

支持的計(jì)算機(jī)屬性包括：

• accel=accels1[:accels2[:...]]

• 這用于啟用加速器。根據(jù)目標(biāo)架構(gòu)的不同，可以使用 kvm、xen、hax、hvf、nvmm、whpx 或 tcg。默認(rèn)情況下，使用 tcg。如果指定了多個(gè)加速器，則在前一個(gè)加速器無法初始化時(shí)，將使用下一個(gè)加速器。

• vmport=on|off|auto

• 啟用VMWare IO端口的仿真，對于 vmmouse 等，自動(dòng)說根據(jù) accel 選擇值。對于 accel=xen，默認(rèn)值為關(guān)閉，否則默認(rèn)值為打開。

• dump-guest-core=on|off

• 在核心轉(zhuǎn)儲(chǔ)中包含來賓內(nèi)存。默認(rèn)值為打開。

• mem-merge=on|off

• 啟用或禁用內(nèi)存合并支持。當(dāng)主機(jī)支持此功能時(shí)，它會(huì)在 VM 實(shí)例之間消除相同的內(nèi)存頁（默認(rèn)情況下處于啟用狀態(tài)）。

• aes-key-wrap=on|off

• 在 s390-ccw 主機(jī)上啟用或禁用 AES 密鑰包裝支持。此功能控制是否將創(chuàng)建 AES 包裝密鑰以允許執(zhí)行 AES 加密功能。默認(rèn)值為打開。

• dea-key-wrap=on|off

• 在 s390-ccw 主機(jī)上啟用或禁用 DEA 密鑰包裝支持。此功能控制是否將創(chuàng)建 DEA 包裝密鑰以允許執(zhí)行 DEA 加密功能。默認(rèn)值為打開。

• nvdimm=on|off

• 啟用或禁用 NVDIMM 支持。默認(rèn)值為關(guān)閉。

• memory-encryption=

• 要使用的內(nèi)存加密對象。默認(rèn)值為無。

• hmat=on|off

• 啟用或禁用 ACPI 異構(gòu)內(nèi)存屬性表 （HMAT） 支持。默認(rèn)值為關(guān)閉。

• memory-backend='id'

• 傳統(tǒng)和選項(xiàng)的替代方案。允許使用內(nèi)存后端作為主 RAM。-mem-pathmem-prealloc

  例如：

  -object memory-backend-file,id=pc.ram,size=512M,mem-path=/hugetlbfs,prealloc=on,share=on-machine memory-backend=pc.ram-m 512M

  遷移兼容性說明：

  • 作為后端id，如果預(yù)期遷移到/從舊的QEMU（<5.0）遷移，則應(yīng)使用按機(jī)器類型通告的“default-ram-id”值（可通過QMP命令獲得）。query-machines

  • 對于計(jì)算機(jī)類型 4.0 及更早版本，如果需要遷移到/從舊 QEMU （<5.0） 遷移，則用戶應(yīng)使用后端選項(xiàng)。x-use-canonical-path-for-ramblock-id=off

  例如：

  -object memory-backend-ram,id=pc.ram,size=512M,x-use-canonical-path-for-ramblock-id=off-machine memory-backend=pc.ram-m 512M

• cxl-fmw.0.targets.0=firsttarget,cxl-fmw.0.targets.1=secondtarget,cxl-fmw.0.size=size[,cxl-fmw.0.interleave-granularity=granularity]

• 定義 CXL 固定內(nèi)存窗口 （CFMW）。

  在 CXL 2.0 ECN 中描述：CEDT CFMWS & QTG _DSM。

  它們是系統(tǒng)上主機(jī)物理地址 （HPA） 的區(qū)域，可以在一個(gè)或多個(gè) CXL 主機(jī)網(wǎng)橋上交錯(cuò)。系統(tǒng)軟件會(huì)將特定設(shè)備分配到這些窗口中，并在啟用內(nèi)存設(shè)備之前，在根端口、交換機(jī)端口和設(shè)備中適當(dāng)?shù)嘏渲孟掠沃鳈C(jī)托管設(shè)備內(nèi)存 （HDM） 解碼器，以滿足交錯(cuò)要求。

  targets.X=target提供到 CXL 主機(jī)網(wǎng)橋的映射，這些網(wǎng)橋可由 -device 條目中提供的 id 標(biāo)識(shí)。當(dāng)固定內(nèi)存窗口表示交錯(cuò)內(nèi)存時(shí)，需要多個(gè)條目來指定所有目標(biāo)。X 是從 0 開始的目標(biāo)索引。

  size=size設(shè)置 CFMW 的大小。這必須是 256MiB 的倍數(shù)。該區(qū)域?qū)R到 256MiB，但位置取決于平臺(tái)和配置。

  interleave-granularity=granularity設(shè)置交錯(cuò)的粒度。默認(rèn)值為 256KiB。僅支持 256KiB、512KiB、1024KiB、2048KiB 4096KiB、8192KiB 和 16384KiB 粒度。

  例：

  -machine cxl-fmw.0.targets.0=cxl.0,cxl-fmw.0.targets.1=cxl.1,cxl-fmw.0.size=128G,cxl-fmw.0.interleave-granularity=512k

sgx-epc.0.memdev=@var{memid},sgx-epc.0.node=@var{numaid}

定義新交所EPC部分。

-cpu?model

選擇 CPU 型號(hào)（用于列表和其他功能選擇）-cpu?help

-accel?name[,prop=value[,...]]

這用于啟用加速器。根據(jù)目標(biāo)架構(gòu)的不同，可以使用 kvm、xen、hax、hvf、nvmm、whpx 或 tcg。默認(rèn)情況下，使用 tcg。如果指定了多個(gè)加速器，則在前一個(gè)加速器無法初始化時(shí)，將使用下一個(gè)加速器。

• igd-passthru=on|off

• 當(dāng) Xen 正在使用時(shí)，此選項(xiàng)控制英特爾集成圖形設(shè)備是否可以傳遞到客戶機(jī)（默認(rèn)為 off）

• kernel-irqchip=on|off|split

• 控制 KVM 內(nèi)核 irqchip 支持。默認(rèn)值為中斷控制器的完全加速。在 x86 上，拆分 irqchip 可減少內(nèi)核攻擊面，但非 MSI 中斷會(huì)降低性能成本。不建議完全禁用內(nèi)核中的 irqchip，除非用于調(diào)試目的。

• kvm-shadow-mem=size

• 定義 KVM 陰影 MMU 的大小。

• split-wx=on|off

• 控制對 TCG 代碼生成緩沖區(qū)使用拆分 w^x 映射。某些操作系統(tǒng)要求啟用此功能，在這種情況下，這將默認(rèn)打開。在其他操作系統(tǒng)上，這將默認(rèn)關(guān)閉，但可以啟用此功能以進(jìn)行測試或調(diào)試。

• tb-size=n

• 控制 TCG 轉(zhuǎn)換塊緩存的大?。ㄒ?MiB 為單位）。

• thread=single|multi

• 控制 TCG 線程數(shù)。當(dāng) TCG 是多線程的時(shí)，每個(gè) vCPU 將有一個(gè)線程，因此可以利用額外的主機(jī)內(nèi)核。默認(rèn)設(shè)置是啟用多線程，其中后端和前端都支持它，并且沒有啟用不兼容的TCG功能（例如icount/replay）。

• dirty-ring-size=n

• 使用 KVM 加速器時(shí)，它控制每個(gè) vCPU 臟頁環(huán)形緩沖區(qū)的大小（每個(gè) vCPU 的條目數(shù)）。它應(yīng)該是 2 的冪值，并且應(yīng)該是 1024 或更大（但仍然小于內(nèi)核支持的最大值）。4096可能是一個(gè)很好的初始值，如果你不知道哪個(gè)是最好的。將此值設(shè)置為 0 可禁用該功能。默認(rèn)情況下，此功能處于禁用狀態(tài)（臟環(huán)大小 = 0）。啟用后，KVM 將改為在位圖中記錄臟頁。

-smp?[[cpus=]n][,maxcpus=maxcpus][,sockets=sockets][,dies=dies][,clusters=clusters][,cores=cores][,threads=threads]

使用最初存在于機(jī)器類型板上的“”CPU 模擬 SMP 系統(tǒng)。在支持 CPU 熱插拔的主板上，可以設(shè)置可選的 '' 參數(shù)，以便在運(yùn)行時(shí)添加更多 CPU。如果省略這兩個(gè)參數(shù)，將從提供的拓?fù)涑蓡T中計(jì)算 CPU 的最大數(shù)量，并且初始 CPU 計(jì)數(shù)將與最大數(shù)量匹配。當(dāng)只給出其中一個(gè)時(shí)，省略的那個(gè)將被設(shè)置為其對應(yīng)物的值?？梢酝瑫r(shí)指定這兩個(gè)參數(shù)，但 CPU 的最大數(shù)量必須等于或大于初始 CPU 計(jì)數(shù)。CPU 拓?fù)鋵哟谓Y(jié)構(gòu)的乘積必須等于 CPU 的最大數(shù)量。這兩個(gè)參數(shù)都受制于由所選特定機(jī)器類型確定的上限。nmaxcpus

若要控制 CPU 拓?fù)湫畔⒌膱?bào)告，可以指定拓?fù)鋮?shù)的值。計(jì)算機(jī)可能僅支持參數(shù)的子集，不同的計(jì)算機(jī)可能具有不同的子集，這些子集根據(jù)相應(yīng) CPU 目標(biāo)的容量而有所不同。因此，對于特定的機(jī)器類型板，可以通過支持的子選項(xiàng)定義預(yù)期的拓?fù)鋵哟谓Y(jié)構(gòu)。除了子選項(xiàng)之外，還可以提供不受支持的參數(shù)，但為了正確解析，必須將其值設(shè)置為 1。

必須指定初始 CPU 計(jì)數(shù)或至少一個(gè)拓?fù)鋮?shù)。指定的參數(shù)必須大于零，不允許使用“cpus=0”等顯式配置。任何省略參數(shù)的值將從給定的參數(shù)中計(jì)算出來。

例如，以下子選項(xiàng)為僅支持套接字/內(nèi)核/線程的計(jì)算機(jī)定義了 CPU 拓?fù)鋵哟谓Y(jié)構(gòu)（計(jì)算機(jī)上總共 2 個(gè)套接字，每個(gè)套接字 2 個(gè)內(nèi)核，每個(gè)內(nèi)核 2 個(gè)線程）?？梢允÷栽撨x項(xiàng)的某些成員，但將自動(dòng)計(jì)算其值：

以下子選項(xiàng)為支持套接字/芯片/內(nèi)核/線程的 PC 機(jī)器定義了 CPU 拓?fù)鋵哟谓Y(jié)構(gòu)（機(jī)器上總共 2 個(gè)插槽，每個(gè)插槽 2 個(gè)芯片，每個(gè)芯片 2 個(gè)內(nèi)核）。

以下子選項(xiàng)為支持套接字/集群/內(nèi)核/線程的 ARM virt 機(jī)器定義了 CPU 拓?fù)鋵哟谓Y(jié)構(gòu)（計(jì)算機(jī)上總共 2 個(gè)套接字，每個(gè)套接字 2 個(gè)集群，每個(gè)集群 2 個(gè)內(nèi)核）。

從歷史上看，在計(jì)算缺失值時(shí)優(yōu)先考慮最粗糙的拓?fù)鋮?shù)（即套接字優(yōu)先于內(nèi)核，內(nèi)核優(yōu)先于線程），但是，這種行為被認(rèn)為容易改變。在 6.2 之前，首選是套接字優(yōu)先于內(nèi)核而不是線程。從 6.2 開始，首選是內(nèi)核而不是套接字而不是線程。

例如，以下選項(xiàng)定義了一個(gè)機(jī)板，在 6.2 之前有 2 個(gè) 1 核插槽，在 6.2 之后有 1 個(gè) 2 核插槽：

-numa?node[,mem=size][,cpus=firstcpu[-lastcpu]][,nodeid=node][,initiator=initiator]

-numa?node[,memdev=id][,cpus=firstcpu[-lastcpu]][,nodeid=node][,initiator=initiator]

-numa?dist,src=source,dst=destination,val=distance

-numa?cpu,node-id=node[,socket-id=x][,core-id=y][,thread-id=z]

-numa?hmat-lb,initiator=node,target=node,hierarchy=hierarchy,data-type=tpye[,latency=lat][,bandwidth=bw]

-numa?hmat-cache,node-id=node,size=size,level=level[,associativity=str][,policy=str][,line=size]

定義 NUMA 節(jié)點(diǎn)并為其分配 RAM 和 VCPU。設(shè)置從源節(jié)點(diǎn)到目標(biāo)節(jié)點(diǎn)的 NUMA 距離。為給定節(jié)點(diǎn)設(shè)置 ACPI 異構(gòu)內(nèi)存屬性。

舊版 VCPU 分配使用“”選項(xiàng)，其中 firstcpu 和 lastcpu 是 CPU 索引。每個(gè)“”選項(xiàng)表示 CPU 索引的連續(xù)范圍（如果省略 lastcpu，則表示單個(gè) VCPU）。一組不連續(xù)的 VCPU 可以通過提供多個(gè)“”選項(xiàng)來表示。如果所有節(jié)點(diǎn)上都省略了 “”，則 VCPU 會(huì)自動(dòng)在它們之間拆分。cpuscpuscpuscpus

例如，以下選項(xiàng)將 VCPU 0、1、2 和 5 分配給 NUMA 節(jié)點(diǎn)：

“”選項(xiàng)是“”選項(xiàng)的新替代方法，它使用“”屬性將 CPU 對象分配給使用 CPU 的拓?fù)洳季謱傩缘墓?jié)點(diǎn)。屬性集是特定于計(jì)算機(jī)的，并且取決于已使用的計(jì)算機(jī)類型/'''選項(xiàng)。可以使用“”監(jiān)視器命令對其進(jìn)行查詢。'' 屬性指定將分配給 CPU 對象的節(jié)點(diǎn)，在與 '' 選項(xiàng)一起使用之前，需要使用 '' 選項(xiàng)聲明節(jié)點(diǎn)。cpucpussocket-id|core-id|thread-idsmphotpluggable-cpusnode-idnodecpu

例如：

舊版“”為節(jié)點(diǎn)分配給定的 RAM 量（5.1 和更新的計(jì)算機(jī)類型不支持）。'' 將 RAM 從給定的內(nèi)存后端設(shè)備分配給節(jié)點(diǎn)。如果所有節(jié)點(diǎn)中都省略了“”和“”，則 RAM 將在它們之間平均分配。memmemdevmemmemdev

“”和“”是互斥的。此外，如果一個(gè)節(jié)點(diǎn)使用 ''，則所有節(jié)點(diǎn)都必須使用它。memmemdevmemdev

“”是一個(gè)附加選項(xiàng)，指向?qū)Υ?NUMA 節(jié)點(diǎn)具有最佳性能（最低延遲或最大帶寬）的啟動(dòng)器 NUMA 節(jié)點(diǎn)。請注意，僅當(dāng)計(jì)算機(jī)屬性“hmat”設(shè)置為“on”時(shí)，才能設(shè)置此選項(xiàng)。initiator

下面的示例創(chuàng)建一個(gè)具有 2 個(gè) NUMA 節(jié)點(diǎn)的計(jì)算機(jī)，節(jié)點(diǎn) 0 具有 CPU。節(jié)點(diǎn) 1 只有內(nèi)存，其發(fā)起方是節(jié)點(diǎn) 0。請注意，由于節(jié)點(diǎn) 0 具有 CPU，因此默認(rèn)情況下，節(jié)點(diǎn) 0 的發(fā)起方是自身，并且必須是自身。

源和目標(biāo)是 NUMA 節(jié)點(diǎn) ID。距離是從源到目標(biāo)的 NUMA 距離。從節(jié)點(diǎn)到自身的距離始終為 10。如果為任何一對節(jié)點(diǎn)指定一個(gè)距離，則必須為所有節(jié)點(diǎn)對指定距離。雖然，當(dāng)每對節(jié)點(diǎn)僅在一個(gè)方向上給出距離時(shí)，則假定相反方向的距離是相同的。但是，如果甚至為一個(gè)節(jié)點(diǎn)對給定一個(gè)不對稱的距離對，則必須為兩個(gè)方向提供所有節(jié)點(diǎn)對的距離值，即使它們是對稱的。當(dāng)一個(gè)節(jié)點(diǎn)無法從另一個(gè)節(jié)點(diǎn)到達(dá)時(shí)，將該對的距離設(shè)置為 255。

請注意，- 選項(xiàng)不會(huì)分配任何指定的資源，它只是將現(xiàn)有資源分配給 NUMA 節(jié)點(diǎn)。這意味著仍然必須使用 ，選項(xiàng)分別分配 RAM 和 VCPU。numa-m-smp

使用“”在 ACPI 異構(gòu)屬性內(nèi)存表 （HMAT） 中設(shè)置啟動(dòng)器和目標(biāo) NUMA 節(jié)點(diǎn)之間的系統(tǒng)局部性延遲和帶寬信息。發(fā)起方 NUMA 節(jié)點(diǎn)可以創(chuàng)建內(nèi)存請求，通常它具有一個(gè)或多個(gè)處理器。目標(biāo) NUMA 節(jié)點(diǎn)包含可尋址內(nèi)存。hmat-lb

在“”選項(xiàng)中，節(jié)點(diǎn)是 NUMA 節(jié)點(diǎn) ID。層次結(jié)構(gòu)是目標(biāo) NUMA 節(jié)點(diǎn)的內(nèi)存層次結(jié)構(gòu)：如果層次結(jié)構(gòu)是“內(nèi)存”，則結(jié)構(gòu)表示內(nèi)存性能;如果層次結(jié)構(gòu)是“第一級|二級|三級”，則此結(jié)構(gòu)表示每個(gè)域的內(nèi)存端緩存的聚合性能?！皵?shù)據(jù)類型”的類型是此結(jié)構(gòu)實(shí)例表示的數(shù)據(jù)類型：如果“層次結(jié)構(gòu)”是“內(nèi)存”，“數(shù)據(jù)類型”是目標(biāo)內(nèi)存的“訪問|讀|寫”延遲或“訪問|讀|寫”帶寬;如果“層次結(jié)構(gòu)”是“第一級|第二級|第三級”，“數(shù)據(jù)類型”是目標(biāo)內(nèi)存端緩存的“訪問|讀|寫”命中延遲或“訪問|讀取|寫入”命中帶寬。hmat-lb

lat 是以納秒為單位的延遲值。bw 是帶寬值，可能的值和單位是 NUM[M|G|T]，表示帶寬值為每秒 NUM 字節(jié)數(shù)（或 MB/s、GB/s 或 TB/s，具體取決于使用的后綴）。請注意，如果延遲或帶寬值為 0，則表示未提供相應(yīng)的延遲或帶寬信息。

在''選項(xiàng)中，node-id是內(nèi)存所屬的NUMA-ID。size 是內(nèi)存端緩存的大?。ㄒ宰止?jié)為單位）。level 是此結(jié)構(gòu)中描述的緩存級別，請注意，緩存級別 0 不應(yīng)與 '' 選項(xiàng)一起使用。關(guān)聯(lián)性是緩存關(guān)聯(lián)性，可能的值為“none/direct（direct-mapped）/complex（complex cache indexing）”。策略是寫入策略。行是緩存行大小（以字節(jié)為單位）。hmat-cachehmat-cache

例如，以下選項(xiàng)描述 2 個(gè) NUMA 節(jié)點(diǎn)。節(jié)點(diǎn) 0 有 2 個(gè) cpu 和一個(gè) ram，節(jié)點(diǎn) 1 只有一個(gè) ram。節(jié)點(diǎn) 0 中的處理器訪問節(jié)點(diǎn) 0 中的內(nèi)存，訪問延遲為 5 納秒，訪問帶寬為 200 MB/s;NUMA 節(jié)點(diǎn) 0 中的處理器訪問 NUMA 節(jié)點(diǎn) 1 中的內(nèi)存，訪問延遲為 10 納秒，訪問帶寬為 100 MB/s。對于內(nèi)存端緩存信息，NUMA 節(jié)點(diǎn) 0 和 1 都有 1 級內(nèi)存緩存，大小為 10KB，策略為回寫，緩存行大小為 8 字節(jié)：