Extra Specs

The following is an overview of all extra specs recognized by nova in its default configuration.

Note

Other services and virt drivers may provide additional extra specs not listed here. In addition, it is possible to register your own extra specs. For more information on the latter, refer to Compute schedulers.

Placement

The following extra specs are used during scheduling to modify the request sent to placement.

resources

The following extra specs are used to request an amount of the specified resource from placement when scheduling. All extra specs expect an integer value.

Note

Not all of the resource types listed below are supported by all virt drivers.

resources{group}:VCPU
Type

int

The amount of resource VCPU requested.

resources{group}:MEMORY_MB
Type

int

The amount of resource MEMORY_MB requested.

resources{group}:DISK_GB
Type

int

The amount of resource DISK_GB requested.

resources{group}:PCI_DEVICE
Type

int

The amount of resource PCI_DEVICE requested.

resources{group}:SRIOV_NET_VF
Type

int

The amount of resource SRIOV_NET_VF requested.

resources{group}:NUMA_SOCKET
Type

int

The amount of resource NUMA_SOCKET requested.

resources{group}:NUMA_CORE
Type

int

The amount of resource NUMA_CORE requested.

resources{group}:NUMA_THREAD
Type

int

The amount of resource NUMA_THREAD requested.

resources{group}:NUMA_MEMORY_MB
Type

int

The amount of resource NUMA_MEMORY_MB requested.

resources{group}:IPV4_ADDRESS
Type

int

The amount of resource IPV4_ADDRESS requested.

resources{group}:VGPU
Type

int

The amount of resource VGPU requested.

resources{group}:VGPU_DISPLAY_HEAD
Type

int

The amount of resource VGPU_DISPLAY_HEAD requested.

resources{group}:NET_BW_EGR_KILOBIT_PER_SEC
Type

int

The amount of resource NET_BW_EGR_KILOBIT_PER_SEC requested.

resources{group}:NET_BW_IGR_KILOBIT_PER_SEC
Type

int

The amount of resource NET_BW_IGR_KILOBIT_PER_SEC requested.

resources{group}:PCPU
Type

int

The amount of resource PCPU requested.

resources{group}:MEM_ENCRYPTION_CONTEXT
Type

int

The amount of resource MEM_ENCRYPTION_CONTEXT requested.

resources{group}:FPGA
Type

int

The amount of resource FPGA requested.

resources{group}:PGPU
Type

int

The amount of resource PGPU requested.

resources{group}:NET_PACKET_RATE_KILOPACKET_PER_SEC
Type

int

The amount of resource NET_PACKET_RATE_KILOPACKET_PER_SEC requested.

resources{group}:NET_PACKET_RATE_EGR_KILOPACKET_PER_SEC
Type

int

The amount of resource NET_PACKET_RATE_EGR_KILOPACKET_PER_SEC requested.

resources{group}:NET_PACKET_RATE_IGR_KILOPACKET_PER_SEC
Type

int

The amount of resource NET_PACKET_RATE_IGR_KILOPACKET_PER_SEC requested.

resources{group}:CUSTOM_{resource}
Type

int

The amount of resource CUSTOM_{resource} requested.

trait

The following extra specs are used to request a specified trait from placement when scheduling. All extra specs expect one of the following values:

  • required

  • forbidden

Note

Not all of the traits listed below are supported by all virt drivers.

trait{group}:COMPUTE_DEVICE_TAGGING
Type

str

Require or forbid trait COMPUTE_DEVICE_TAGGING.

trait{group}:COMPUTE_NODE
Type

str

Require or forbid trait COMPUTE_NODE.

trait{group}:COMPUTE_TRUSTED_CERTS
Type

str

Require or forbid trait COMPUTE_TRUSTED_CERTS.

trait{group}:COMPUTE_SAME_HOST_COLD_MIGRATE
Type

str

Require or forbid trait COMPUTE_SAME_HOST_COLD_MIGRATE.

trait{group}:COMPUTE_RESCUE_BFV
Type

str

Require or forbid trait COMPUTE_RESCUE_BFV.

trait{group}:COMPUTE_ACCELERATORS
Type

str

Require or forbid trait COMPUTE_ACCELERATORS.

trait{group}:COMPUTE_SOCKET_PCI_NUMA_AFFINITY
Type

str

Require or forbid trait COMPUTE_SOCKET_PCI_NUMA_AFFINITY.

trait{group}:COMPUTE_REMOTE_MANAGED_PORTS
Type

str

Require or forbid trait COMPUTE_REMOTE_MANAGED_PORTS.

trait{group}:COMPUTE_MEM_BACKING_FILE
Type

str

Require or forbid trait COMPUTE_MEM_BACKING_FILE.

trait{group}:COMPUTE_MANAGED_PCI_DEVICE
Type

str

Require or forbid trait COMPUTE_MANAGED_PCI_DEVICE.

trait{group}:COMPUTE_ARCH_AARCH64
Type

str

Require or forbid trait COMPUTE_ARCH_AARCH64.

trait{group}:COMPUTE_ARCH_PPC64LE
Type

str

Require or forbid trait COMPUTE_ARCH_PPC64LE.

trait{group}:COMPUTE_ARCH_MIPSEL
Type

str

Require or forbid trait COMPUTE_ARCH_MIPSEL.

trait{group}:COMPUTE_ARCH_S390X
Type

str

Require or forbid trait COMPUTE_ARCH_S390X.

trait{group}:COMPUTE_ARCH_RISCV64
Type

str

Require or forbid trait COMPUTE_ARCH_RISCV64.

trait{group}:COMPUTE_ARCH_X86_64
Type

str

Require or forbid trait COMPUTE_ARCH_X86_64.

trait{group}:COMPUTE_CONFIG_DRIVE_REGENERATION
Type

str

Require or forbid trait COMPUTE_CONFIG_DRIVE_REGENERATION.

trait{group}:COMPUTE_EPHEMERAL_ENCRYPTION
Type

str

Require or forbid trait COMPUTE_EPHEMERAL_ENCRYPTION.

trait{group}:COMPUTE_EPHEMERAL_ENCRYPTION_PLAIN
Type

str

Require or forbid trait COMPUTE_EPHEMERAL_ENCRYPTION_PLAIN.

trait{group}:COMPUTE_EPHEMERAL_ENCRYPTION_LUKS
Type

str

Require or forbid trait COMPUTE_EPHEMERAL_ENCRYPTION_LUKS.

trait{group}:COMPUTE_EPHEMERAL_ENCRYPTION_LUKSV2
Type

str

Require or forbid trait COMPUTE_EPHEMERAL_ENCRYPTION_LUKSV2.

trait{group}:COMPUTE_FIRMWARE_BIOS
Type

str

Require or forbid trait COMPUTE_FIRMWARE_BIOS.

trait{group}:COMPUTE_FIRMWARE_UEFI
Type

str

Require or forbid trait COMPUTE_FIRMWARE_UEFI.

trait{group}:COMPUTE_GRAPHICS_MODEL_BOCHS
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_BOCHS.

trait{group}:COMPUTE_GRAPHICS_MODEL_CIRRUS
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_CIRRUS.

trait{group}:COMPUTE_GRAPHICS_MODEL_GOP
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_GOP.

trait{group}:COMPUTE_GRAPHICS_MODEL_NONE
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_NONE.

trait{group}:COMPUTE_GRAPHICS_MODEL_QXL
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_QXL.

trait{group}:COMPUTE_GRAPHICS_MODEL_VGA
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_VGA.

trait{group}:COMPUTE_GRAPHICS_MODEL_VIRTIO
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_VIRTIO.

trait{group}:COMPUTE_GRAPHICS_MODEL_VMVGA
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_VMVGA.

trait{group}:COMPUTE_GRAPHICS_MODEL_XEN
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_XEN.

trait{group}:COMPUTE_IMAGE_TYPE_AKI
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_AKI.

trait{group}:COMPUTE_IMAGE_TYPE_AMI
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_AMI.

trait{group}:COMPUTE_IMAGE_TYPE_ARI
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_ARI.

trait{group}:COMPUTE_IMAGE_TYPE_ISO
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_ISO.

trait{group}:COMPUTE_IMAGE_TYPE_QCOW2
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_QCOW2.

trait{group}:COMPUTE_IMAGE_TYPE_RAW
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_RAW.

trait{group}:COMPUTE_IMAGE_TYPE_VDI
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_VDI.

trait{group}:COMPUTE_IMAGE_TYPE_VHD
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_VHD.

trait{group}:COMPUTE_IMAGE_TYPE_VHDX
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_VHDX.

trait{group}:COMPUTE_IMAGE_TYPE_VMDK
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_VMDK.

trait{group}:COMPUTE_IMAGE_TYPE_PLOOP
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_PLOOP.

trait{group}:COMPUTE_MIGRATE_AUTO_CONVERGE
Type

str

Require or forbid trait COMPUTE_MIGRATE_AUTO_CONVERGE.

trait{group}:COMPUTE_MIGRATE_POST_COPY
Type

str

Require or forbid trait COMPUTE_MIGRATE_POST_COPY.

trait{group}:COMPUTE_NET_ATTACH_INTERFACE
Type

str

Require or forbid trait COMPUTE_NET_ATTACH_INTERFACE.

trait{group}:COMPUTE_NET_ATTACH_INTERFACE_WITH_TAG
Type

str

Require or forbid trait COMPUTE_NET_ATTACH_INTERFACE_WITH_TAG.

trait{group}:COMPUTE_NET_VIF_MODEL_E1000
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_E1000.

trait{group}:COMPUTE_NET_VIF_MODEL_E1000E
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_E1000E.

trait{group}:COMPUTE_NET_VIF_MODEL_LAN9118
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_LAN9118.

trait{group}:COMPUTE_NET_VIF_MODEL_NETFRONT
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_NETFRONT.

trait{group}:COMPUTE_NET_VIF_MODEL_NE2K_PCI
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_NE2K_PCI.

trait{group}:COMPUTE_NET_VIF_MODEL_PCNET
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_PCNET.

trait{group}:COMPUTE_NET_VIF_MODEL_RTL8139
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_RTL8139.

trait{group}:COMPUTE_NET_VIF_MODEL_SPAPR_VLAN
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_SPAPR_VLAN.

trait{group}:COMPUTE_NET_VIF_MODEL_SRIOV
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_SRIOV.

trait{group}:COMPUTE_NET_VIF_MODEL_VIRTIO
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_VIRTIO.

trait{group}:COMPUTE_NET_VIF_MODEL_VMXNET
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_VMXNET.

trait{group}:COMPUTE_NET_VIF_MODEL_VMXNET3
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_VMXNET3.

trait{group}:COMPUTE_SECURITY_TPM_1_2
Type

str

Require or forbid trait COMPUTE_SECURITY_TPM_1_2.

trait{group}:COMPUTE_SECURITY_TPM_2_0
Type

str

Require or forbid trait COMPUTE_SECURITY_TPM_2_0.

trait{group}:COMPUTE_SECURITY_UEFI_SECURE_BOOT
Type

str

Require or forbid trait COMPUTE_SECURITY_UEFI_SECURE_BOOT.

trait{group}:COMPUTE_STATUS_DISABLED
Type

str

Require or forbid trait COMPUTE_STATUS_DISABLED.

trait{group}:COMPUTE_STORAGE_BUS_FDC
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_FDC.

trait{group}:COMPUTE_STORAGE_BUS_IDE
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_IDE.

trait{group}:COMPUTE_STORAGE_BUS_LXC
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_LXC.

trait{group}:COMPUTE_STORAGE_BUS_SATA
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_SATA.

trait{group}:COMPUTE_STORAGE_BUS_SCSI
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_SCSI.

trait{group}:COMPUTE_STORAGE_BUS_USB
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_USB.

trait{group}:COMPUTE_STORAGE_BUS_VIRTIO
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_VIRTIO.

trait{group}:COMPUTE_STORAGE_BUS_UML
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_UML.

trait{group}:COMPUTE_STORAGE_BUS_XEN
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_XEN.

trait{group}:COMPUTE_STORAGE_VIRTIO_FS
Type

str

Require or forbid trait COMPUTE_STORAGE_VIRTIO_FS.

trait{group}:COMPUTE_VIOMMU_MODEL_INTEL
Type

str

Require or forbid trait COMPUTE_VIOMMU_MODEL_INTEL.

trait{group}:COMPUTE_VIOMMU_MODEL_SMMUV3
Type

str

Require or forbid trait COMPUTE_VIOMMU_MODEL_SMMUV3.

trait{group}:COMPUTE_VIOMMU_MODEL_VIRTIO
Type

str

Require or forbid trait COMPUTE_VIOMMU_MODEL_VIRTIO.

trait{group}:COMPUTE_VIOMMU_MODEL_AUTO
Type

str

Require or forbid trait COMPUTE_VIOMMU_MODEL_AUTO.

trait{group}:COMPUTE_VOLUME_ATTACH
Type

str

Require or forbid trait COMPUTE_VOLUME_ATTACH.

trait{group}:COMPUTE_VOLUME_ATTACH_WITH_TAG
Type

str

Require or forbid trait COMPUTE_VOLUME_ATTACH_WITH_TAG.

trait{group}:COMPUTE_VOLUME_EXTEND
Type

str

Require or forbid trait COMPUTE_VOLUME_EXTEND.

trait{group}:COMPUTE_VOLUME_MULTI_ATTACH
Type

str

Require or forbid trait COMPUTE_VOLUME_MULTI_ATTACH.

trait{group}:HW_ARCH_ALPHA
Type

str

Require or forbid trait HW_ARCH_ALPHA.

trait{group}:HW_ARCH_ARMV6
Type

str

Require or forbid trait HW_ARCH_ARMV6.

trait{group}:HW_ARCH_ARMV7
Type

str

Require or forbid trait HW_ARCH_ARMV7.

trait{group}:HW_ARCH_ARMV7B
Type

str

Require or forbid trait HW_ARCH_ARMV7B.

trait{group}:HW_ARCH_AARCH64
Type

str

Require or forbid trait HW_ARCH_AARCH64.

trait{group}:HW_ARCH_CRIS
Type

str

Require or forbid trait HW_ARCH_CRIS.

trait{group}:HW_ARCH_I686
Type

str

Require or forbid trait HW_ARCH_I686.

trait{group}:HW_ARCH_IA64
Type

str

Require or forbid trait HW_ARCH_IA64.

trait{group}:HW_ARCH_LM32
Type

str

Require or forbid trait HW_ARCH_LM32.

trait{group}:HW_ARCH_M68K
Type

str

Require or forbid trait HW_ARCH_M68K.

trait{group}:HW_ARCH_MICROBLAZE
Type

str

Require or forbid trait HW_ARCH_MICROBLAZE.

trait{group}:HW_ARCH_MICROBLAZEEL
Type

str

Require or forbid trait HW_ARCH_MICROBLAZEEL.

trait{group}:HW_ARCH_MIPS
Type

str

Require or forbid trait HW_ARCH_MIPS.

trait{group}:HW_ARCH_MIPSEL
Type

str

Require or forbid trait HW_ARCH_MIPSEL.

trait{group}:HW_ARCH_MIPS64
Type

str

Require or forbid trait HW_ARCH_MIPS64.

trait{group}:HW_ARCH_MIPS64EL
Type

str

Require or forbid trait HW_ARCH_MIPS64EL.

trait{group}:HW_ARCH_OPENRISC
Type

str

Require or forbid trait HW_ARCH_OPENRISC.

trait{group}:HW_ARCH_PARISC
Type

str

Require or forbid trait HW_ARCH_PARISC.

trait{group}:HW_ARCH_PARISC64
Type

str

Require or forbid trait HW_ARCH_PARISC64.

trait{group}:HW_ARCH_PPC
Type

str

Require or forbid trait HW_ARCH_PPC.

trait{group}:HW_ARCH_PPCLE
Type

str

Require or forbid trait HW_ARCH_PPCLE.

trait{group}:HW_ARCH_PPC64
Type

str

Require or forbid trait HW_ARCH_PPC64.

trait{group}:HW_ARCH_PPC64LE
Type

str

Require or forbid trait HW_ARCH_PPC64LE.

trait{group}:HW_ARCH_PPCEMB
Type

str

Require or forbid trait HW_ARCH_PPCEMB.

trait{group}:HW_ARCH_S390
Type

str

Require or forbid trait HW_ARCH_S390.

trait{group}:HW_ARCH_S390X
Type

str

Require or forbid trait HW_ARCH_S390X.

trait{group}:HW_ARCH_SH4
Type

str

Require or forbid trait HW_ARCH_SH4.

trait{group}:HW_ARCH_SH4EB
Type

str

Require or forbid trait HW_ARCH_SH4EB.

trait{group}:HW_ARCH_SPARC
Type

str

Require or forbid trait HW_ARCH_SPARC.

trait{group}:HW_ARCH_SPARC64
Type

str

Require or forbid trait HW_ARCH_SPARC64.

trait{group}:HW_ARCH_UNICORE32
Type

str

Require or forbid trait HW_ARCH_UNICORE32.

trait{group}:HW_ARCH_X86_64
Type

str

Require or forbid trait HW_ARCH_X86_64.

trait{group}:HW_ARCH_XTENSA
Type

str

Require or forbid trait HW_ARCH_XTENSA.

trait{group}:HW_ARCH_XTENSAEB
Type

str

Require or forbid trait HW_ARCH_XTENSAEB.

trait{group}:HW_CPU_HYPERTHREADING
Type

str

Require or forbid trait HW_CPU_HYPERTHREADING.

trait{group}:HW_CPU_AARCH64_FP
Type

str

Require or forbid trait HW_CPU_AARCH64_FP.

trait{group}:HW_CPU_AARCH64_ASIMD
Type

str

Require or forbid trait HW_CPU_AARCH64_ASIMD.

trait{group}:HW_CPU_AARCH64_EVTSTRM
Type

str

Require or forbid trait HW_CPU_AARCH64_EVTSTRM.

trait{group}:HW_CPU_AARCH64_AES
Type

str

Require or forbid trait HW_CPU_AARCH64_AES.

trait{group}:HW_CPU_AARCH64_PMULL
Type

str

Require or forbid trait HW_CPU_AARCH64_PMULL.

trait{group}:HW_CPU_AARCH64_SHA1
Type

str

Require or forbid trait HW_CPU_AARCH64_SHA1.

trait{group}:HW_CPU_AARCH64_SHA2
Type

str

Require or forbid trait HW_CPU_AARCH64_SHA2.

trait{group}:HW_CPU_AARCH64_CRC32
Type

str

Require or forbid trait HW_CPU_AARCH64_CRC32.

trait{group}:HW_CPU_AARCH64_FPHP
Type

str

Require or forbid trait HW_CPU_AARCH64_FPHP.

trait{group}:HW_CPU_AARCH64_ASIMDHP
Type

str

Require or forbid trait HW_CPU_AARCH64_ASIMDHP.

trait{group}:HW_CPU_AARCH64_ASIMDRDM
Type

str

Require or forbid trait HW_CPU_AARCH64_ASIMDRDM.

trait{group}:HW_CPU_AARCH64_ATOMICS
Type

str

Require or forbid trait HW_CPU_AARCH64_ATOMICS.

trait{group}:HW_CPU_AARCH64_JSCVT
Type

str

Require or forbid trait HW_CPU_AARCH64_JSCVT.

trait{group}:HW_CPU_AARCH64_FCMA
Type

str

Require or forbid trait HW_CPU_AARCH64_FCMA.

trait{group}:HW_CPU_AARCH64_LRCPC
Type

str

Require or forbid trait HW_CPU_AARCH64_LRCPC.

trait{group}:HW_CPU_AARCH64_DCPOP
Type

str

Require or forbid trait HW_CPU_AARCH64_DCPOP.

trait{group}:HW_CPU_AARCH64_SHA3
Type

str

Require or forbid trait HW_CPU_AARCH64_SHA3.

trait{group}:HW_CPU_AARCH64_SM3
Type

str

Require or forbid trait HW_CPU_AARCH64_SM3.

trait{group}:HW_CPU_AARCH64_SM4
Type

str

Require or forbid trait HW_CPU_AARCH64_SM4.

trait{group}:HW_CPU_AARCH64_ASIMDDP
Type

str

Require or forbid trait HW_CPU_AARCH64_ASIMDDP.

trait{group}:HW_CPU_AARCH64_SHA512
Type

str

Require or forbid trait HW_CPU_AARCH64_SHA512.

trait{group}:HW_CPU_AARCH64_SVE
Type

str

Require or forbid trait HW_CPU_AARCH64_SVE.

trait{group}:HW_CPU_AARCH64_CPUID
Type

str

Require or forbid trait HW_CPU_AARCH64_CPUID.

trait{group}:HW_CPU_AMD_SEV
Type

str

Require or forbid trait HW_CPU_AMD_SEV.

trait{group}:HW_CPU_PPC64LE_POWER8
Type

str

Require or forbid trait HW_CPU_PPC64LE_POWER8.

trait{group}:HW_CPU_PPC64LE_POWER9
Type

str

Require or forbid trait HW_CPU_PPC64LE_POWER9.

trait{group}:HW_CPU_X86_AVX
Type

str

Require or forbid trait HW_CPU_X86_AVX.

trait{group}:HW_CPU_X86_AVX2
Type

str

Require or forbid trait HW_CPU_X86_AVX2.

trait{group}:HW_CPU_X86_CLMUL
Type

str

Require or forbid trait HW_CPU_X86_CLMUL.

trait{group}:HW_CPU_X86_FMA3
Type

str

Require or forbid trait HW_CPU_X86_FMA3.

trait{group}:HW_CPU_X86_FMA4
Type

str

Require or forbid trait HW_CPU_X86_FMA4.

trait{group}:HW_CPU_X86_F16C
Type

str

Require or forbid trait HW_CPU_X86_F16C.

trait{group}:HW_CPU_X86_MMX
Type

str

Require or forbid trait HW_CPU_X86_MMX.

trait{group}:HW_CPU_X86_SSE
Type

str

Require or forbid trait HW_CPU_X86_SSE.

trait{group}:HW_CPU_X86_SSE2
Type

str

Require or forbid trait HW_CPU_X86_SSE2.

trait{group}:HW_CPU_X86_SSE3
Type

str

Require or forbid trait HW_CPU_X86_SSE3.

trait{group}:HW_CPU_X86_SSSE3
Type

str

Require or forbid trait HW_CPU_X86_SSSE3.

trait{group}:HW_CPU_X86_SSE41
Type

str

Require or forbid trait HW_CPU_X86_SSE41.

trait{group}:HW_CPU_X86_SSE42
Type

str

Require or forbid trait HW_CPU_X86_SSE42.

trait{group}:HW_CPU_X86_SSE4A
Type

str

Require or forbid trait HW_CPU_X86_SSE4A.

trait{group}:HW_CPU_X86_XOP
Type

str

Require or forbid trait HW_CPU_X86_XOP.

trait{group}:HW_CPU_X86_3DNOW
Type

str

Require or forbid trait HW_CPU_X86_3DNOW.

trait{group}:HW_CPU_X86_AVX512F
Type

str

Require or forbid trait HW_CPU_X86_AVX512F.

trait{group}:HW_CPU_X86_AVX512CD
Type

str

Require or forbid trait HW_CPU_X86_AVX512CD.

trait{group}:HW_CPU_X86_AVX512PF
Type

str

Require or forbid trait HW_CPU_X86_AVX512PF.

trait{group}:HW_CPU_X86_AVX512ER
Type

str

Require or forbid trait HW_CPU_X86_AVX512ER.

trait{group}:HW_CPU_X86_AVX512VL
Type

str

Require or forbid trait HW_CPU_X86_AVX512VL.

trait{group}:HW_CPU_X86_AVX512BW
Type

str

Require or forbid trait HW_CPU_X86_AVX512BW.

trait{group}:HW_CPU_X86_AVX512DQ
Type

str

Require or forbid trait HW_CPU_X86_AVX512DQ.

trait{group}:HW_CPU_X86_AVX512VNNI
Type

str

Require or forbid trait HW_CPU_X86_AVX512VNNI.

trait{group}:HW_CPU_X86_AVX512VBMI
Type

str

Require or forbid trait HW_CPU_X86_AVX512VBMI.

trait{group}:HW_CPU_X86_AVX512IFMA
Type

str

Require or forbid trait HW_CPU_X86_AVX512IFMA.

trait{group}:HW_CPU_X86_AVX512VBMI2
Type

str

Require or forbid trait HW_CPU_X86_AVX512VBMI2.

trait{group}:HW_CPU_X86_AVX512BITALG
Type

str

Require or forbid trait HW_CPU_X86_AVX512BITALG.

trait{group}:HW_CPU_X86_AVX512VAES
Type

str

Require or forbid trait HW_CPU_X86_AVX512VAES.

trait{group}:HW_CPU_X86_AVX512GFNI
Type

str

Require or forbid trait HW_CPU_X86_AVX512GFNI.

trait{group}:HW_CPU_X86_AVX512VPCLMULQDQ
Type

str

Require or forbid trait HW_CPU_X86_AVX512VPCLMULQDQ.

trait{group}:HW_CPU_X86_AVX512VPOPCNTDQ
Type

str

Require or forbid trait HW_CPU_X86_AVX512VPOPCNTDQ.

trait{group}:HW_CPU_X86_ABM
Type

str

Require or forbid trait HW_CPU_X86_ABM.

trait{group}:HW_CPU_X86_BMI
Type

str

Require or forbid trait HW_CPU_X86_BMI.

trait{group}:HW_CPU_X86_BMI2
Type

str

Require or forbid trait HW_CPU_X86_BMI2.

trait{group}:HW_CPU_X86_TBM
Type

str

Require or forbid trait HW_CPU_X86_TBM.

trait{group}:HW_CPU_X86_AESNI
Type

str

Require or forbid trait HW_CPU_X86_AESNI.

trait{group}:HW_CPU_X86_SHA
Type

str

Require or forbid trait HW_CPU_X86_SHA.

trait{group}:HW_CPU_X86_MPX
Type

str

Require or forbid trait HW_CPU_X86_MPX.

trait{group}:HW_CPU_X86_SGX
Type

str

Require or forbid trait HW_CPU_X86_SGX.

trait{group}:HW_CPU_X86_TSX
Type

str

Require or forbid trait HW_CPU_X86_TSX.

trait{group}:HW_CPU_X86_ASF
Type

str

Require or forbid trait HW_CPU_X86_ASF.

trait{group}:HW_CPU_X86_VMX
Type

str

Require or forbid trait HW_CPU_X86_VMX.

trait{group}:HW_CPU_X86_SVM
Type

str

Require or forbid trait HW_CPU_X86_SVM.

trait{group}:HW_CPU_X86_PDPE1GB
Type

str

Require or forbid trait HW_CPU_X86_PDPE1GB.

trait{group}:HW_CPU_X86_STIBP
Type

str

Require or forbid trait HW_CPU_X86_STIBP.

trait{group}:HW_CPU_X86_AMD_SEV
Type

str

Require or forbid trait HW_CPU_X86_AMD_SEV.

trait{group}:HW_CPU_X86_AMD_SVM
Type

str

Require or forbid trait HW_CPU_X86_AMD_SVM.

trait{group}:HW_CPU_X86_AMD_IBPB
Type

str

Require or forbid trait HW_CPU_X86_AMD_IBPB.

trait{group}:HW_CPU_X86_AMD_NO_SSB
Type

str

Require or forbid trait HW_CPU_X86_AMD_NO_SSB.

trait{group}:HW_CPU_X86_AMD_SSBD
Type

str

Require or forbid trait HW_CPU_X86_AMD_SSBD.

trait{group}:HW_CPU_X86_AMD_VIRT_SSBD
Type

str

Require or forbid trait HW_CPU_X86_AMD_VIRT_SSBD.

trait{group}:HW_CPU_X86_INTEL_MD_CLEAR
Type

str

Require or forbid trait HW_CPU_X86_INTEL_MD_CLEAR.

trait{group}:HW_CPU_X86_INTEL_PCID
Type

str

Require or forbid trait HW_CPU_X86_INTEL_PCID.

trait{group}:HW_CPU_X86_INTEL_SPEC_CTRL
Type

str

Require or forbid trait HW_CPU_X86_INTEL_SPEC_CTRL.

trait{group}:HW_CPU_X86_INTEL_SSBD
Type

str

Require or forbid trait HW_CPU_X86_INTEL_SSBD.

trait{group}:HW_CPU_X86_INTEL_VMX
Type

str

Require or forbid trait HW_CPU_X86_INTEL_VMX.

trait{group}:HW_GPU_API_DIRECTX_V10
Type

str

Require or forbid trait HW_GPU_API_DIRECTX_V10.

trait{group}:HW_GPU_API_DIRECTX_V11
Type

str

Require or forbid trait HW_GPU_API_DIRECTX_V11.

trait{group}:HW_GPU_API_DIRECTX_V12
Type

str

Require or forbid trait HW_GPU_API_DIRECTX_V12.

trait{group}:HW_GPU_API_DIRECT2D
Type

str

Require or forbid trait HW_GPU_API_DIRECT2D.

trait{group}:HW_GPU_API_DIRECT3D_V6_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V6_0.

trait{group}:HW_GPU_API_DIRECT3D_V7_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V7_0.

trait{group}:HW_GPU_API_DIRECT3D_V8_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V8_0.

trait{group}:HW_GPU_API_DIRECT3D_V8_1
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V8_1.

trait{group}:HW_GPU_API_DIRECT3D_V9_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V9_0.

trait{group}:HW_GPU_API_DIRECT3D_V9_0B
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V9_0B.

trait{group}:HW_GPU_API_DIRECT3D_V9_0C
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V9_0C.

trait{group}:HW_GPU_API_DIRECT3D_V9_0L
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V9_0L.

trait{group}:HW_GPU_API_DIRECT3D_V10_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V10_0.

trait{group}:HW_GPU_API_DIRECT3D_V10_1
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V10_1.

trait{group}:HW_GPU_API_DIRECT3D_V11_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V11_0.

trait{group}:HW_GPU_API_DIRECT3D_V11_1
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V11_1.

trait{group}:HW_GPU_API_DIRECT3D_V11_2
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V11_2.

trait{group}:HW_GPU_API_DIRECT3D_V11_3
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V11_3.

trait{group}:HW_GPU_API_DIRECT3D_V12_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V12_0.

trait{group}:HW_GPU_API_VULKAN
Type

str

Require or forbid trait HW_GPU_API_VULKAN.

trait{group}:HW_GPU_API_DXVA
Type

str

Require or forbid trait HW_GPU_API_DXVA.

trait{group}:HW_GPU_API_OPENCL_V1_0
Type

str

Require or forbid trait HW_GPU_API_OPENCL_V1_0.

trait{group}:HW_GPU_API_OPENCL_V1_1
Type

str

Require or forbid trait HW_GPU_API_OPENCL_V1_1.

trait{group}:HW_GPU_API_OPENCL_V1_2
Type

str

Require or forbid trait HW_GPU_API_OPENCL_V1_2.

trait{group}:HW_GPU_API_OPENCL_V2_0
Type

str

Require or forbid trait HW_GPU_API_OPENCL_V2_0.

trait{group}:HW_GPU_API_OPENCL_V2_1
Type

str

Require or forbid trait HW_GPU_API_OPENCL_V2_1.

trait{group}:HW_GPU_API_OPENCL_V2_2
Type

str

Require or forbid trait HW_GPU_API_OPENCL_V2_2.

trait{group}:HW_GPU_API_OPENGL_V1_1
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V1_1.

trait{group}:HW_GPU_API_OPENGL_V1_2
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V1_2.

trait{group}:HW_GPU_API_OPENGL_V1_3
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V1_3.

trait{group}:HW_GPU_API_OPENGL_V1_4
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V1_4.

trait{group}:HW_GPU_API_OPENGL_V1_5
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V1_5.

trait{group}:HW_GPU_API_OPENGL_V2_0
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V2_0.

trait{group}:HW_GPU_API_OPENGL_V2_1
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V2_1.

trait{group}:HW_GPU_API_OPENGL_V3_0
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V3_0.

trait{group}:HW_GPU_API_OPENGL_V3_1
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V3_1.

trait{group}:HW_GPU_API_OPENGL_V3_2
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V3_2.

trait{group}:HW_GPU_API_OPENGL_V3_3
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V3_3.

trait{group}:HW_GPU_API_OPENGL_V4_0
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V4_0.

trait{group}:HW_GPU_API_OPENGL_V4_1
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V4_1.

trait{group}:HW_GPU_API_OPENGL_V4_2
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V4_2.

trait{group}:HW_GPU_API_OPENGL_V4_3
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V4_3.

trait{group}:HW_GPU_API_OPENGL_V4_4
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V4_4.

trait{group}:HW_GPU_API_OPENGL_V4_5
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V4_5.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_0
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_0.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_1
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_1.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_2
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_2.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_3
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_3.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V2_0
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V2_0.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V2_1
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V2_1.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_0
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_0.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_2
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_2.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_5
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_5.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_7
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_7.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_0
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_0.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_2
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_2.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_3
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_3.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_0
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_0.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_1
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_1.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_2
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_2.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_0
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_0.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_1
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_1.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_2
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_2.

trait{group}:HW_GPU_CUDA_SDK_V6_5
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V6_5.

trait{group}:HW_GPU_CUDA_SDK_V7_5
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V7_5.

trait{group}:HW_GPU_CUDA_SDK_V8_0
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V8_0.

trait{group}:HW_GPU_CUDA_SDK_V9_0
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V9_0.

trait{group}:HW_GPU_CUDA_SDK_V9_1
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V9_1.

trait{group}:HW_GPU_CUDA_SDK_V9_2
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V9_2.

trait{group}:HW_GPU_CUDA_SDK_V10_0
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V10_0.

trait{group}:HW_GPU_MAX_DISPLAY_HEADS_1
Type

str

Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_1.

trait{group}:HW_GPU_MAX_DISPLAY_HEADS_2
Type

str

Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_2.

trait{group}:HW_GPU_MAX_DISPLAY_HEADS_4
Type

str

Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_4.

trait{group}:HW_GPU_MAX_DISPLAY_HEADS_6
Type

str

Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_6.

trait{group}:HW_GPU_MAX_DISPLAY_HEADS_8
Type

str

Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_8.

trait{group}:HW_GPU_RESOLUTION_W320H240
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W320H240.

trait{group}:HW_GPU_RESOLUTION_W640H480
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W640H480.

trait{group}:HW_GPU_RESOLUTION_W800H600
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W800H600.

trait{group}:HW_GPU_RESOLUTION_W1024H600
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1024H600.

trait{group}:HW_GPU_RESOLUTION_W1024H768
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1024H768.

trait{group}:HW_GPU_RESOLUTION_W1152H864
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1152H864.

trait{group}:HW_GPU_RESOLUTION_W1280H720
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1280H720.

trait{group}:HW_GPU_RESOLUTION_W1280H768
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1280H768.

trait{group}:HW_GPU_RESOLUTION_W1280H800
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1280H800.

trait{group}:HW_GPU_RESOLUTION_W1280H1024
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1280H1024.

trait{group}:HW_GPU_RESOLUTION_W1360H768
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1360H768.

trait{group}:HW_GPU_RESOLUTION_W1366H768
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1366H768.

trait{group}:HW_GPU_RESOLUTION_W1440H900
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1440H900.

trait{group}:HW_GPU_RESOLUTION_W1600H900
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1600H900.

trait{group}:HW_GPU_RESOLUTION_W1600H1200
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1600H1200.

trait{group}:HW_GPU_RESOLUTION_W1680H1050
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1680H1050.

trait{group}:HW_GPU_RESOLUTION_W1920H1080
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1920H1080.

trait{group}:HW_GPU_RESOLUTION_W1920H1200
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1920H1200.

trait{group}:HW_GPU_RESOLUTION_W2560H1440
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W2560H1440.

trait{group}:HW_GPU_RESOLUTION_W2560H1600
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W2560H1600.

trait{group}:HW_GPU_RESOLUTION_W3840H2160
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W3840H2160.

trait{group}:HW_GPU_RESOLUTION_W7680H4320
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W7680H4320.

trait{group}:HW_NIC_SRIOV
Type

str

Require or forbid trait HW_NIC_SRIOV.

trait{group}:HW_NIC_MULTIQUEUE
Type

str

Require or forbid trait HW_NIC_MULTIQUEUE.

trait{group}:HW_NIC_VMDQ
Type

str

Require or forbid trait HW_NIC_VMDQ.

trait{group}:HW_NIC_PROGRAMMABLE_PIPELINE
Type

str

Require or forbid trait HW_NIC_PROGRAMMABLE_PIPELINE.

trait{group}:HW_NIC_ACCEL_SSL
Type

str

Require or forbid trait HW_NIC_ACCEL_SSL.

trait{group}:HW_NIC_ACCEL_IPSEC
Type

str

Require or forbid trait HW_NIC_ACCEL_IPSEC.

trait{group}:HW_NIC_ACCEL_TLS
Type

str

Require or forbid trait HW_NIC_ACCEL_TLS.

trait{group}:HW_NIC_ACCEL_DIFFIEH
Type

str

Require or forbid trait HW_NIC_ACCEL_DIFFIEH.

trait{group}:HW_NIC_ACCEL_RSA
Type

str

Require or forbid trait HW_NIC_ACCEL_RSA.

trait{group}:HW_NIC_ACCEL_ECC
Type

str

Require or forbid trait HW_NIC_ACCEL_ECC.

trait{group}:HW_NIC_ACCEL_LZS
Type

str

Require or forbid trait HW_NIC_ACCEL_LZS.

trait{group}:HW_NIC_ACCEL_DEFLATE
Type

str

Require or forbid trait HW_NIC_ACCEL_DEFLATE.

trait{group}:HW_NIC_DCB_PFC
Type

str

Require or forbid trait HW_NIC_DCB_PFC.

trait{group}:HW_NIC_DCB_ETS
Type

str

Require or forbid trait HW_NIC_DCB_ETS.

trait{group}:HW_NIC_DCB_QCN
Type

str

Require or forbid trait HW_NIC_DCB_QCN.

trait{group}:HW_NIC_OFFLOAD_TSO
Type

str

Require or forbid trait HW_NIC_OFFLOAD_TSO.

trait{group}:HW_NIC_OFFLOAD_GRO
Type

str

Require or forbid trait HW_NIC_OFFLOAD_GRO.

trait{group}:HW_NIC_OFFLOAD_GSO
Type

str

Require or forbid trait HW_NIC_OFFLOAD_GSO.

trait{group}:HW_NIC_OFFLOAD_UFO
Type

str

Require or forbid trait HW_NIC_OFFLOAD_UFO.

trait{group}:HW_NIC_OFFLOAD_LRO
Type

str

Require or forbid trait HW_NIC_OFFLOAD_LRO.

trait{group}:HW_NIC_OFFLOAD_LSO
Type

str

Require or forbid trait HW_NIC_OFFLOAD_LSO.

trait{group}:HW_NIC_OFFLOAD_TCS
Type

str

Require or forbid trait HW_NIC_OFFLOAD_TCS.

trait{group}:HW_NIC_OFFLOAD_UCS
Type

str

Require or forbid trait HW_NIC_OFFLOAD_UCS.

trait{group}:HW_NIC_OFFLOAD_SCS
Type

str

Require or forbid trait HW_NIC_OFFLOAD_SCS.

trait{group}:HW_NIC_OFFLOAD_L2CRC
Type

str

Require or forbid trait HW_NIC_OFFLOAD_L2CRC.

trait{group}:HW_NIC_OFFLOAD_FDF
Type

str

Require or forbid trait HW_NIC_OFFLOAD_FDF.

trait{group}:HW_NIC_OFFLOAD_RXVLAN
Type

str

Require or forbid trait HW_NIC_OFFLOAD_RXVLAN.

trait{group}:HW_NIC_OFFLOAD_TXVLAN
Type

str

Require or forbid trait HW_NIC_OFFLOAD_TXVLAN.

trait{group}:HW_NIC_OFFLOAD_VXLAN
Type

str

Require or forbid trait HW_NIC_OFFLOAD_VXLAN.

trait{group}:HW_NIC_OFFLOAD_GRE
Type

str

Require or forbid trait HW_NIC_OFFLOAD_GRE.

trait{group}:HW_NIC_OFFLOAD_GENEVE
Type

str

Require or forbid trait HW_NIC_OFFLOAD_GENEVE.

trait{group}:HW_NIC_OFFLOAD_TXUDP
Type

str

Require or forbid trait HW_NIC_OFFLOAD_TXUDP.

trait{group}:HW_NIC_OFFLOAD_QINQ
Type

str

Require or forbid trait HW_NIC_OFFLOAD_QINQ.

trait{group}:HW_NIC_OFFLOAD_RDMA
Type

str

Require or forbid trait HW_NIC_OFFLOAD_RDMA.

trait{group}:HW_NIC_OFFLOAD_RXHASH
Type

str

Require or forbid trait HW_NIC_OFFLOAD_RXHASH.

trait{group}:HW_NIC_OFFLOAD_RX
Type

str

Require or forbid trait HW_NIC_OFFLOAD_RX.

trait{group}:HW_NIC_OFFLOAD_TX
Type

str

Require or forbid trait HW_NIC_OFFLOAD_TX.

trait{group}:HW_NIC_OFFLOAD_SG
Type

str

Require or forbid trait HW_NIC_OFFLOAD_SG.

trait{group}:HW_NIC_OFFLOAD_SWITCHDEV
Type

str

Require or forbid trait HW_NIC_OFFLOAD_SWITCHDEV.

trait{group}:HW_NIC_SRIOV_QOS_TX
Type

str

Require or forbid trait HW_NIC_SRIOV_QOS_TX.

trait{group}:HW_NIC_SRIOV_QOS_RX
Type

str

Require or forbid trait HW_NIC_SRIOV_QOS_RX.

trait{group}:HW_NIC_SRIOV_MULTIQUEUE
Type

str

Require or forbid trait HW_NIC_SRIOV_MULTIQUEUE.

trait{group}:HW_NIC_SRIOV_TRUSTED
Type

str

Require or forbid trait HW_NIC_SRIOV_TRUSTED.

trait{group}:HW_NUMA_ROOT
Type

str

Require or forbid trait HW_NUMA_ROOT.

trait{group}:MISC_SHARES_VIA_AGGREGATE
Type

str

Require or forbid trait MISC_SHARES_VIA_AGGREGATE.

trait{group}:OWNER_CYBORG
Type

str

Require or forbid trait OWNER_CYBORG.

trait{group}:OWNER_NOVA
Type

str

Require or forbid trait OWNER_NOVA.

trait{group}:STORAGE_DISK_HDD
Type

str

Require or forbid trait STORAGE_DISK_HDD.

trait{group}:STORAGE_DISK_SSD
Type

str

Require or forbid trait STORAGE_DISK_SSD.

trait{group}:CUSTOM_{trait}
Type

str

Require or forbid trait CUSTOM_{trait}.

Scheduler Filters

The following extra specs are specific to various in-tree scheduler filters.

aggregate_instance_extra_specs

The following extra specs are used to specify metadata that must be present on the aggregate of a host. If this metadata is not present or does not match the expected value, the aggregate and all hosts within in will be rejected.

Requires the AggregateInstanceExtraSpecsFilter scheduler filter.

aggregate_instance_extra_specs:{key}
Type

str

Specify metadata that must be present on the aggregate of a host. If this metadata is not present, the host will be rejected. Requires the AggregateInstanceExtraSpecsFilter scheduler filter.

The value can be one of the following:

  • = (equal to or greater than as a number; same as vcpus case)

  • == (equal to as a number)

  • != (not equal to as a number)

  • >= (greater than or equal to as a number)

  • <= (less than or equal to as a number)

  • s== (equal to as a string)

  • s!= (not equal to as a string)

  • s>= (greater than or equal to as a string)

  • s> (greater than as a string)

  • s<= (less than or equal to as a string)

  • s< (less than as a string)

  • <in> (substring)

  • <all-in> (all elements contained in collection)

  • <or> (find one of these)

  • A specific value, e.g. true, 123, testing

capabilities

The following extra specs are used to specify a host capability that must be provided by the host compute service. If this capability is not present or does not match the expected value, the host will be rejected.

Requires the ComputeCapabilitiesFilter scheduler filter.

All extra specs expect similar types of values:

  • = (equal to or greater than as a number; same as vcpus case)

  • == (equal to as a number)

  • != (not equal to as a number)

  • >= (greater than or equal to as a number)

  • <= (less than or equal to as a number)

  • s== (equal to as a string)

  • s!= (not equal to as a string)

  • s>= (greater than or equal to as a string)

  • s> (greater than as a string)

  • s<= (less than or equal to as a string)

  • s< (less than as a string)

  • <in> (substring)

  • <all-in> (all elements contained in collection)

  • <or> (find one of these)

  • A specific value, e.g. true, 123, testing

Examples are: >= 5, s== 2.1.0, <in> gcc, <all-in> aes mmx, and <or> fpu <or> gpu

Note

Not all operators will apply to all types of values. For example, the == operator should not be used for a string value - use s== instead.

capabilities:id
Type

str

Specify that the ‘id’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:uuid
Type

str

Specify that the ‘uuid’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:service_id
Type

str

Specify that the ‘service_id’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:host
Type

str

Specify that the ‘host’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:vcpus
Type

str

Specify that the ‘vcpus’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:memory_mb
Type

str

Specify that the ‘memory_mb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:local_gb
Type

str

Specify that the ‘local_gb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:vcpus_used
Type

str

Specify that the ‘vcpus_used’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:memory_mb_used
Type

str

Specify that the ‘memory_mb_used’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:local_gb_used
Type

str

Specify that the ‘local_gb_used’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:hypervisor_type
Type

str

Specify that the ‘hypervisor_type’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:hypervisor_version
Type

str

Specify that the ‘hypervisor_version’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:hypervisor_hostname
Type

str

Specify that the ‘hypervisor_hostname’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:free_ram_mb
Type

str

Specify that the ‘free_ram_mb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:free_disk_gb
Type

str

Specify that the ‘free_disk_gb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:current_workload
Type

str

Specify that the ‘current_workload’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:running_vms
Type

str

Specify that the ‘running_vms’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:disk_available_least
Type

str

Specify that the ‘disk_available_least’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:host_ip
Type

str

Specify that the ‘host_ip’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:mapped
Type

str

Specify that the ‘mapped’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:cpu_allocation_ratio
Type

str

Specify that the ‘cpu_allocation_ratio’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:ram_allocation_ratio
Type

str

Specify that the ‘ram_allocation_ratio’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:disk_allocation_ratio
Type

str

Specify that the ‘disk_allocation_ratio’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:total_usable_ram_mb
Type

str

Specify that the ‘total_usable_ram_mb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:total_usable_disk_gb
Type

str

Specify that the ‘total_usable_disk_gb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:disk_mb_used
Type

str

Specify that the ‘disk_mb_used’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:free_disk_mb
Type

str

Specify that the ‘free_disk_mb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:vcpus_total
Type

str

Specify that the ‘vcpus_total’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:num_instances
Type

str

Specify that the ‘num_instances’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:num_io_ops
Type

str

Specify that the ‘num_io_ops’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:failed_builds
Type

str

Specify that the ‘failed_builds’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:aggregates
Type

str

Specify that the ‘aggregates’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:cell_uuid
Type

str

Specify that the ‘cell_uuid’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:updated
Type

str

Specify that the ‘updated’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:cpu_info{filter}
Type

str

Specify that the ‘cpu_info’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:metrics{filter}
Type

str

Specify that the ‘metrics’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:stats{filter}
Type

str

Specify that the ‘stats’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:numa_topology{filter}
Type

str

Specify that the ‘numa_topology’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:supported_hv_specs{filter}
Type

str

Specify that the ‘supported_hv_specs’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:pci_device_pools{filter}
Type

str

Specify that the ‘pci_device_pools’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:nodename{filter}
Type

str

Specify that the ‘nodename’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:pci_stats{filter}
Type

str

Specify that the ‘pci_stats’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:supported_instances{filter}
Type

str

Specify that the ‘supported_instances’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:limits{filter}
Type

str

Specify that the ‘limits’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:instances{filter}
Type

str

Specify that the ‘instances’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

Virt driver

The following extra specs are used as hints to configure internals of a instance, from the bus used for paravirtualized devices to the amount of a physical device to passthrough to the instance. Most of these are virt driver-specific.

quota

The following extra specs are used to configure quotas for various paravirtualized devices. Different quotas are supported by different virt drivers, as noted below.

quota:cpu_limit
Type

int

Min

0

The upper limit for CPU allocation in MHz. The utilization of an instance will not exceed this limit, even if there are available resources. This is typically used to ensure a consistent performance of instances independent of available resources.The value 0 indicates that CPU usage is not limited.Only supported by the VMWare virt driver.

quota:cpu_reservation
Type

int

The guaranteed minimum CPU reservation in MHz. This means the specified amount of CPU that will be guaranteed for the instance. Only supported by the VMWare virt driver.

quota:cpu_shares_level
Type

str

The allocation level for CPU. If you choose ‘custom’, set the number of CPU shares using ‘quota:cpu_shares_share’. Only supported by the VMWare virt driver.

quota:cpu_shares_share
Type

int

Min

0

The number of shares of CPU allocated in the event that ‘quota:cpu_shares_level=custom’ is used. Ignored otherwise. There is no unit for this value: it is a relative measure based on the settings for other instances. Only supported by the VMWare virt driver.

quota:memory_limit
Type

int

Min

0

The upper limit for memory allocation in MB. The utilization of an instance will not exceed this limit, even if there are available resources. This is typically used to ensure a consistent performance of instances independent of available resources.The value 0 indicates that memory usage is not limited.Only supported by the VMWare virt driver.

quota:memory_reservation
Type

int

The guaranteed minimum memory reservation in MB. This means the specified amount of memory that will be guaranteed for the instance. Only supported by the VMWare virt driver.

quota:memory_shares_level
Type

str

The allocation level for memory. If you choose ‘custom’, set the number of memory shares using ‘quota:memory_shares_share’. Only supported by the VMWare virt driver.

quota:memory_shares_share
Type

int

Min

0

The number of shares of memory allocated in the event that ‘quota:memory_shares_level=custom’ is used. Ignored otherwise. There is no unit for this value: it is a relative measure based on the settings for other instances. Only supported by the VMWare virt driver.

quota:disk_io_limit
Type

int

Min

0

The upper limit for disk IO allocation in I/O per second. The utilization of an instance will not exceed this limit, even if there are available resources. This is typically used to ensure a consistent performance of instances independent of available resources.The value 0 indicates that disk IO usage is not limited.Only supported by the VMWare virt driver.

quota:disk_io_reservation
Type

int

The guaranteed minimum disk IO reservation in I/O per second. This means the specified amount of disk IO that will be guaranteed for the instance. Only supported by the VMWare virt driver.

quota:disk_io_shares_level
Type

str

The allocation level for disk IO. If you choose ‘custom’, set the number of disk IO shares using ‘quota:disk_io_shares_share’. Only supported by the VMWare virt driver.

quota:disk_io_shares_share
Type

int

Min

0

The number of shares of disk IO allocated in the event that ‘quota:disk_io_shares_level=custom’ is used. Ignored otherwise. There is no unit for this value: it is a relative measure based on the settings for other instances. Only supported by the VMWare virt driver.

quota:vif_limit
Type

int

Min

0

The upper limit for virtual interface allocation in Mbps. The utilization of an instance will not exceed this limit, even if there are available resources. This is typically used to ensure a consistent performance of instances independent of available resources.The value 0 indicates that virtual interface usage is not limited.Only supported by the VMWare virt driver.

quota:vif_reservation
Type

int

The guaranteed minimum virtual interface reservation in Mbps. This means the specified amount of virtual interface that will be guaranteed for the instance. Only supported by the VMWare virt driver.

quota:vif_shares_level
Type

str

The allocation level for virtual interface. If you choose ‘custom’, set the number of virtual interface shares using ‘quota:vif_shares_share’. Only supported by the VMWare virt driver.

quota:vif_shares_share
Type

int

Min

0

The number of shares of virtual interface allocated in the event that ‘quota:vif_shares_level=custom’ is used. Ignored otherwise. There is no unit for this value: it is a relative measure based on the settings for other instances. Only supported by the VMWare virt driver.

quota:cpu_shares
Type

int

Min

0

The proportional weighted share for the domain. If this element is omitted, the service defaults to the OS provided defaults. There is no unit for the value; it is a relative measure based on the setting of other VMs. For example, a VM configured with a value of 2048 gets twice as much CPU time as a VM configured with value 1024. Only supported by the libvirt virt driver.

quota:cpu_period
Type

int

Min

0

Specifies the enforcement interval in microseconds. Within a period, each VCPU of the instance is not allowed to consume more than the quota worth of runtime. The value should be in range 1,000 - 1,000,000. A period with a value of 0 means no value. Only supported by the libvirt virt driver.

quota:cpu_quota
Type

int

The maximum allowed bandwidth in microseconds. Can be combined with ‘quota:cpu_period’ to limit an instance to a percentage of capacity of a physical CPU. The value should be in range 1,000 - 2^64 or negative. A negative value indicates that the instance has infinite bandwidth. Only supported by the libvirt virt driver.

quota:disk_read_bytes_sec
Type

int

Min

0

The quota read bytes for disk. Only supported by the libvirt virt driver.

quota:disk_read_iops_sec
Type

int

Min

0

The quota read iops for disk. Only supported by the libvirt virt driver.

quota:disk_write_bytes_sec
Type

int

Min

0

The quota write bytes for disk. Only supported by the libvirt virt driver.

quota:disk_write_iops_sec
Type

int

Min

0

The quota write iops for disk. Only supported by the libvirt virt driver.

quota:disk_total_bytes_sec
Type

int

Min

0

The quota total bytes for disk. Only supported by the libvirt virt driver.

quota:disk_total_iops_sec
Type

int

Min

0

The quota total iops for disk. Only supported by the libvirt virt driver.

quota:vif_inbound_average
Type

int

Min

0

The quota inbound average for VIF. Only supported by the libvirt virt driver.

quota:vif_inbound_peak
Type

int

Min

0

The quota inbound peak for VIF. Only supported by the libvirt virt driver.

quota:vif_inbound_burst
Type

int

Min

0

The quota inbound burst for VIF. Only supported by the libvirt virt driver.

quota:vif_outbound_average
Type

int

Min

0

The quota outbound average for VIF. Only supported by the libvirt virt driver.

quota:vif_outbound_peak
Type

int

Min

0

The quota outbound peak for VIF. Only supported by the libvirt virt driver.

quota:vif_outbound_burst
Type

int

Min

0

The quota outbound burst for VIF. Only supported by the libvirt virt driver.

accel

The following extra specs are used to configure attachment of various accelerators to an instance. For more information, refer to the Cyborg documentation.

They are only supported by the libvirt virt driver.

accel:device_profile
Type

str

The name of a device profile to configure for the instance. A device profile may be viewed as a “flavor for devices”.

pci_passthrough

The following extra specs are used to configure passthrough of a host PCI device to an instance. This requires prior host configuration. For more information, refer to Attaching physical PCI devices to guests.

They are only supported by the libvirt virt driver.

pci_passthrough:alias
Type

str

Specify the number of $alias PCI device(s) to attach to the instance. Must be of format $alias:$count, where $alias corresponds to a particular PCI device class (as configured in nova.conf) and $count is the amount of PCI devices of type $alias to be assigned to the instance. Use commas to specify multiple values. Only supported by the libvirt virt driver.

hw

The following extra specs are used to configure various attributes of instances. Some of the extra specs act as feature flags, while others tweak for example the guest-visible CPU topology of the instance.

Except where otherwise stated, they are only supported by the libvirt virt driver.

hw:cpu_realtime
Type

bool

Determine whether realtime mode should be enabled for the instance or not. Only supported by the libvirt virt driver.

hw:cpu_realtime_mask
Type

str

A exclusion mask of CPUs that should not be enabled for realtime. Only supported by the libvirt virt driver.

hw:hide_hypervisor_id
Type

bool

Determine whether the hypervisor ID should be hidden from the guest. Only supported by the libvirt virt driver.

hw:cpu_policy
Type

str

The policy to apply when determining what host CPUs the guest CPUs can run on. If shared (default), guest CPUs can be overallocated but cannot float across host cores. If dedicated, guest CPUs cannot be overallocated but are individually pinned to their own host core. If mixed, the policy for each instance CPU can be specified using the hw:cpu_dedicated_mask or hw:cpu_realtime_mask extra specs.Only supported by the libvirt virt driver.

hw:cpu_thread_policy
Type

str

The policy to apply when determining whether the destination host can have hardware threads enabled or not. If prefer (default), hosts with hardware threads will be preferred. If require, hosts with hardware threads will be required. If isolate, hosts with hardware threads will be forbidden. Only supported by the libvirt virt driver.

hw:emulator_threads_policy
Type

str

The policy to apply when determining whether emulator threads should be offloaded to a separate isolated core or to a pool of shared cores. If share, emulator overhead threads will be offloaded to a pool of shared cores. If isolate, emulator overhead threads will be offloaded to their own core. Only supported by the libvirt virt driver.

hw:cpu_dedicated_mask
Type

str

A mapping of guest (instance) CPUs to be pinned to host CPUs for an instance with a mixed CPU policy. Any guest CPUs which are not in this mapping will float across host cores. Only supported by the libvirt virt driver.

hw:mem_page_size
Type

str

The size of memory pages to allocate to the guest with. Can be one of the three alias - large, small or any, - or an actual size. Only supported by the libvirt virt driver.

hw:locked_memory
Type

bool

Determine if guest (instance) memory should be locked preventing swaping. This is required in rare cases for device DMA transfers. Only supported by the libvirt virt driver.

hw:numa_nodes
Type

int

Min

1

The number of virtual NUMA nodes to allocate to configure the guest with. Each virtual NUMA node will be mapped to a unique host NUMA node. Only supported by the libvirt virt driver.

hw:numa_cpus.{num}
Type

str

A mapping of guest (instance) CPUs to the guest (not host!) NUMA node identified by {num}. This can be used to provide asymmetric CPU-NUMA allocation and is necessary where the number of guest NUMA nodes is not a factor of the number of guest CPUs. Only supported by the libvirt virt driver.

hw:numa_mem.{num}
Type

int

Min

1

A mapping of guest memory to the guest (not host!) NUMA node identified by {num}. This can be used to provide asymmetric memory-NUMA allocation and is necessary where the number of guest NUMA nodes is not a factor of the total guest memory. Only supported by the libvirt virt driver.

hw:pci_numa_affinity_policy
Type

str

The NUMA affinity policy of any PCI passthrough devices or SR-IOV network interfaces attached to the instance. If required`, only PCI devices from one of the host NUMA nodes the instance VCPUs are allocated from can be used by said instance. If ``preferred, any PCI device can be used, though preference will be given to those from the same NUMA node as the instance VCPUs. If legacy (default), behavior is as with required unless the PCI device does not support provide NUMA affinity information, in which case affinity is ignored. Only supported by the libvirt virt driver.

hw:cpu_sockets
Type

int

Min

1

The number of virtual CPU threads to emulate in the guest CPU topology. Defaults to the number of vCPUs requested. Only supported by the libvirt virt driver.

hw:cpu_cores
Type

int

Min

1

The number of virtual CPU cores to emulate per socket in the guest CPU topology. Defaults to 1.Only supported by the libvirt virt driver.

hw:cpu_threads
Type

int

Min

1

The number of virtual CPU threads to emulate per core in the guest CPU topology.Defaults to 1. Only supported by the libvirt virt driver.

hw:max_cpu_sockets
Type

int

Min

1

The max number of virtual CPU threads to emulate in the guest CPU topology. This is used to limit the topologies that can be requested by an image and will be used to validate the hw_cpu_sockets image metadata property. Only supported by the libvirt virt driver.

hw:max_cpu_cores
Type

int

Min

1

The max number of virtual CPU cores to emulate per socket in the guest CPU topology. This is used to limit the topologies that can be requested by an image and will be used to validate the hw_cpu_cores image metadata property. Only supported by the libvirt virt driver.

hw:max_cpu_threads
Type

int

Min

1

The max number of virtual CPU threads to emulate per core in the guest CPU topology. This is used to limit the topologies that can be requested by an image and will be used to validate the hw_cpu_threads image metadata property. Only supported by the libvirt virt driver.

hw:boot_menu
Type

bool

Whether to show a boot menu when booting the guest. Only supported by the libvirt virt driver.

hw:vif_multiqueue_enabled
Type

bool

Whether to enable the virtio-net multiqueue feature. When set, the driver sets the number of queues equal to the number of guest vCPUs. This makes the network performance scale across a number of vCPUs. This requires guest support and is only supported by the libvirt driver.

hw:mem_encryption
Type

bool

Whether to enable memory encryption for the guest. Only supported by the libvirt virt driver on hosts with AMD SEV support.

hw:pmem
Type

str

A comma-separated list of $LABELs defined in config for vPMEM devices. Only supported by the libvirt virt driver on hosts with PMEM devices.

hw:pmu
Type

bool

Whether to enable the Performance Monitory Unit (PMU) for the guest. If this option is not specified, the presence of the vPMU is determined by the hypervisor. The vPMU is used by tools like perf in the guest to provide more accurate information for profiling application and monitoring guest performance. For realtime workloads, the emulation of a vPMU can introduce additional latency which may be undesirable. If the telemetry it provides is not required, such workloads should disable this feature. For most workloads, the default of unset will be correct. Only supported by the libvirt virt driver.

hw:serial_port_count
Type

int

Min

0

The number of serial ports to allocate to the guest. Only supported by the libvirt virt driver.

hw:tpm_model
Type

str

The model of the attached TPM device. Only supported by the libvirt virt driver.

hw:tpm_version
Type

str

The TPM version. Required if requesting a vTPM via the ‘hw:tpm_model’ extra spec or equivalent image metadata property. Only supported by the libvirt virt driver.

hw:watchdog_action
Type

str

The action to take when the watchdog timer is kicked. Watchdog devices keep an eye on the instance and carry out the specified action if the server hangs. The watchdog uses the i6300esb device, emulating a PCI Intel 6300ESB. Only supported by the libvirt virt driver.

hw:viommu_model
Type

str

This can be used to set model for virtual IOMMU device.

hw:ephemeral_encryption
Type

bool

Whether to enable ephemeral storage encryption.

hw:ephemeral_encryption_format
Type

str

The encryption format to be used if ephemeral storage encryption is enabled via hw:ephemeral_encryption.

hw_rng

The following extra specs are used to configure a random number generator for an instance.

They are only supported by the libvirt virt driver.

hw_rng:allowed
Type

bool

Whether to disable configuration of a random number generator in their image. Before 21.0.0 (Ussuri), random number generators were not enabled by default so this was used to determine whether to enable configuration.

hw_rng:rate_bytes
Type

int

Min

0

The allowed amount of bytes for the guest to read from the host’s entropy per period.

hw_rng:rate_period
Type

int

Min

0

The duration of a read period in milliseconds.

hw_video

The following extra specs are used to configure attributes of the default guest video device.

They are only supported by the libvirt virt driver.

hw_video:ram_max_mb
Type

int

Min

0

The maximum amount of memory the user can request using the hw_video_ram image metadata property, which represents the video memory that the guest OS will see. This has no effect for vGPUs.

os

The following extra specs are used to configure various attributes of instances when using the HyperV virt driver.

They are only supported by the HyperV virt driver.

os:secure_boot
Type

str

Determine whether secure boot is enabled or not. Only supported by the libvirt and HyperV virt drivers.

os:resolution
Type

str

Guest VM screen resolution size. Only supported by the HyperV driver.

os:monitors
Type

int

Min

1

Max

8

Guest VM number of monitors. Only supported by the HyperV driver.

os:vram
Type

str

Guest VM VRAM amount. Only supported by the HyperV driver.

vmware

The following extra specs are used to configure various attributes of instances when using the VMWare virt driver.

They are only supported by the VMWare virt driver.

vmware:hw_version
Type

str

Specify the hardware version used to create images. In an environment with different host versions, you can use this parameter to place instances on the correct hosts.

vmware:storage_policy
Type

str

Specify the storage policy used for new instances. If Storage Policy-Based Management (SPBM) is not enabled, this parameter is ignored.

Others (uncategorized)

The following extra specs are not part of a group.

hide_hypervisor_id
Type

bool

Determine whether the hypervisor ID should be hidden from the guest. Only supported by the libvirt virt driver. This extra spec is not compatible with the AggregateInstanceExtraSpecsFilter scheduler filter. The hw:hide_hypervisor_id extra spec should be used instead.

Warning

This extra spec has been deprecated and should not be used.

group_policy
Type

str

The group policy to apply when using the granular resource request syntax.