€•o?Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ0/translations/zh_CN/virt/kvm/devices/arm-vgic-v5”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ0/translations/zh_TW/virt/kvm/devices/arm-vgic-v5”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ0/translations/it_IT/virt/kvm/devices/arm-vgic-v5”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ0/translations/ja_JP/virt/kvm/devices/arm-vgic-v5”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ0/translations/ko_KR/virt/kvm/devices/arm-vgic-v5”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ0/translations/pt_BR/virt/kvm/devices/arm-vgic-v5”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ0/translations/sp_SP/virt/kvm/devices/arm-vgic-v5”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1hµhhh²hh³ŒJ/var/lib/git/docbuild/linux/Documentation/virt/kvm/devices/arm-vgic-v5.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ4ARM Virtual Generic Interrupt Controller v5 (VGICv5)”h]”hŒ4ARM Virtual Generic Interrupt Controller v5 (VGICv5)”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒdefinition_list”“”)”}”(hhh]”hŒdefinition_list_item”“”)”}”(hŒ]Device types supported: - KVM_DEV_TYPE_ARM_VGIC_V5 ARM Generic Interrupt Controller v5.0 ”h]”(hŒterm”“”)”}”(hŒDevice types supported:”h]”hŒDevice types supported:”…””}”(hhêh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèh³hÇh´K hhäubhŒ definition”“”)”}”(hhh]”hŒ bullet_list”“”)”}”(hhh]”hŒ list_item”“”)”}”(hŒCKVM_DEV_TYPE_ARM_VGIC_V5 ARM Generic Interrupt Controller v5.0 ”h]”hŒ paragraph”“”)”}”(hŒBKVM_DEV_TYPE_ARM_VGIC_V5 ARM Generic Interrupt Controller v5.0”h]”hŒBKVM_DEV_TYPE_ARM_VGIC_V5 ARM Generic Interrupt Controller v5.0”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhhÿubah}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1hýh³hÇh´K hhúubah}”(h]”h ]”h"]”h$]”h&]”uh1høhhäubeh}”(h]”h ]”h"]”h$]”h&]”uh1hâh³hÇh´K hhßubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhhÊh²hh³Nh´Nubj )”}”(hŒÛOnly one VGIC instance may be instantiated through this API. The created VGIC will act as the VM interrupt controller, requiring emulated user-space devices to inject interrupts to the VGIC instead of directly to CPUs.”h]”hŒÛOnly one VGIC instance may be instantiated through this API. The created VGIC will act as the VM interrupt controller, requiring emulated user-space devices to inject interrupts to the VGIC instead of directly to CPUs.”…””}”(hj8h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K hhÊh²hubj )”}”(hŒñCreating a guest GICv5 device requires a host GICv5 host. The current VGICv5 device only supports PPI interrupts. These can either be injected from emulated in-kernel devices (such as the Arch Timer, or PMU), or via the KVM_IRQ_LINE ioctl.”h]”hŒñCreating a guest GICv5 device requires a host GICv5 host. The current VGICv5 device only supports PPI interrupts. These can either be injected from emulated in-kernel devices (such as the Arch Timer, or PMU), or via the KVM_IRQ_LINE ioctl.”…””}”(hjFh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KhhÊh²hubhÞ)”}”(hhh]”hã)”}”(hXøGroups: KVM_DEV_ARM_VGIC_GRP_CTRL Attributes: KVM_DEV_ARM_VGIC_CTRL_INIT request the initialization of the VGIC, no additional parameter in kvm_device_attr.addr. Must be called after all VCPUs have been created. KVM_DEV_ARM_VGIC_USERPSPACE_PPIs request the mask of userspace-drivable PPIs. Only a subset of the PPIs can be directly driven from userspace with GICv5, and the returned mask informs userspace of which it is allowed to drive via KVM_IRQ_LINE. Userspace must allocate and point to __u64[2] of data in kvm_device_attr.addr. When this call returns, the provided memory will be populated with the userspace PPI mask. The lower __u64 contains the mask for the lower 64 PPIS, with the remaining 64 being in the second __u64. This is a read-only attribute, and cannot be set. Attempts to set it are rejected. Errors: ======= ======================================================== -ENXIO VGIC not properly configured as required prior to calling this attribute -ENODEV no online VCPU -ENOMEM memory shortage when allocating vgic internal data -EFAULT Invalid guest ram access -EBUSY One or more VCPUS are running ======= ========================================================”h]”(hé)”}”(hŒGroups:”h]”hŒGroups:”…””}”(hj[h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèh³hÇh´K1hjWubhù)”}”(hhh]”(hÞ)”}”(hhh]”hã)”}”(hXMKVM_DEV_ARM_VGIC_GRP_CTRL Attributes: KVM_DEV_ARM_VGIC_CTRL_INIT request the initialization of the VGIC, no additional parameter in kvm_device_attr.addr. Must be called after all VCPUs have been created. KVM_DEV_ARM_VGIC_USERPSPACE_PPIs request the mask of userspace-drivable PPIs. Only a subset of the PPIs can be directly driven from userspace with GICv5, and the returned mask informs userspace of which it is allowed to drive via KVM_IRQ_LINE. Userspace must allocate and point to __u64[2] of data in kvm_device_attr.addr. When this call returns, the provided memory will be populated with the userspace PPI mask. The lower __u64 contains the mask for the lower 64 PPIS, with the remaining 64 being in the second __u64. This is a read-only attribute, and cannot be set. Attempts to set it are rejected. ”h]”(hé)”}”(hŒKVM_DEV_ARM_VGIC_GRP_CTRL”h]”hŒKVM_DEV_ARM_VGIC_GRP_CTRL”…””}”(hjsh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèh³hÇh´K'hjoubhù)”}”(hhh]”(j )”}”(hŒ Attributes:”h]”hŒ Attributes:”…””}”(hj„h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KhjubhŒ block_quote”“”)”}”(hŒªKVM_DEV_ARM_VGIC_CTRL_INIT request the initialization of the VGIC, no additional parameter in kvm_device_attr.addr. Must be called after all VCPUs have been created. ”h]”hÞ)”}”(hhh]”hã)”}”(hŒ¦KVM_DEV_ARM_VGIC_CTRL_INIT request the initialization of the VGIC, no additional parameter in kvm_device_attr.addr. Must be called after all VCPUs have been created. ”h]”(hé)”}”(hŒKVM_DEV_ARM_VGIC_CTRL_INIT”h]”hŒKVM_DEV_ARM_VGIC_CTRL_INIT”…””}”(hjŸh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèh³hÇh´Khj›ubhù)”}”(hhh]”j )”}”(hŒŠrequest the initialization of the VGIC, no additional parameter in kvm_device_attr.addr. Must be called after all VCPUs have been created.”h]”hŒŠrequest the initialization of the VGIC, no additional parameter in kvm_device_attr.addr. Must be called after all VCPUs have been created.”…””}”(hj°h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Khj­ubah}”(h]”h ]”h"]”h$]”h&]”uh1høhj›ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hâh³hÇh´Khj˜ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhj”ubah}”(h]”h ]”h"]”h$]”h&]”uh1j’h³hÇh´KhjubhÞ)”}”(hhh]”hã)”}”(hX]KVM_DEV_ARM_VGIC_USERPSPACE_PPIs request the mask of userspace-drivable PPIs. Only a subset of the PPIs can be directly driven from userspace with GICv5, and the returned mask informs userspace of which it is allowed to drive via KVM_IRQ_LINE. Userspace must allocate and point to __u64[2] of data in kvm_device_attr.addr. When this call returns, the provided memory will be populated with the userspace PPI mask. The lower __u64 contains the mask for the lower 64 PPIS, with the remaining 64 being in the second __u64. This is a read-only attribute, and cannot be set. Attempts to set it are rejected. ”h]”(hé)”}”(hŒ KVM_DEV_ARM_VGIC_USERPSPACE_PPIs”h]”hŒ KVM_DEV_ARM_VGIC_USERPSPACE_PPIs”…””}”(hjÝh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèh³hÇh´K'hjÙubhù)”}”(hhh]”(j )”}”(hŒÒrequest the mask of userspace-drivable PPIs. Only a subset of the PPIs can be directly driven from userspace with GICv5, and the returned mask informs userspace of which it is allowed to drive via KVM_IRQ_LINE.”h]”hŒÒrequest the mask of userspace-drivable PPIs. Only a subset of the PPIs can be directly driven from userspace with GICv5, and the returned mask informs userspace of which it is allowed to drive via KVM_IRQ_LINE.”…””}”(hjîh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Khjëubj )”}”(hXUserspace must allocate and point to __u64[2] of data in kvm_device_attr.addr. When this call returns, the provided memory will be populated with the userspace PPI mask. The lower __u64 contains the mask for the lower 64 PPIS, with the remaining 64 being in the second __u64.”h]”hXUserspace must allocate and point to __u64[2] of data in kvm_device_attr.addr. When this call returns, the provided memory will be populated with the userspace PPI mask. The lower __u64 contains the mask for the lower 64 PPIS, with the remaining 64 being in the second __u64.”…””}”(hjüh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K!hjëubj )”}”(hŒRThis is a read-only attribute, and cannot be set. Attempts to set it are rejected.”h]”hŒRThis is a read-only attribute, and cannot be set. Attempts to set it are rejected.”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K&hjëubeh}”(h]”h ]”h"]”h$]”h&]”uh1høhjÙubeh}”(h]”h ]”h"]”h$]”h&]”uh1hâh³hÇh´K'hjÖubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1høhjoubeh}”(h]”h ]”h"]”h$]”h&]”uh1hâh³hÇh´K'hjlubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhjiubj )”}”(hŒErrors:”h]”hŒErrors:”…””}”(hj<h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K)hjiubj“)”}”(hX{======= ======================================================== -ENXIO VGIC not properly configured as required prior to calling this attribute -ENODEV no online VCPU -ENOMEM memory shortage when allocating vgic internal data -EFAULT Invalid guest ram access -EBUSY One or more VCPUS are running ======= ========================================================”h]”hŒtable”“”)”}”(hhh]”hŒtgroup”“”)”}”(hhh]”(hŒcolspec”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”Kuh1jXhjUubjY)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”K9uh1jXhjUubhŒtbody”“”)”}”(hhh]”(hŒrow”“”)”}”(hhh]”(hŒentry”“”)”}”(hhh]”j )”}”(hŒ-ENXIO”h]”hŒ-ENXIO”…””}”(hj}h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K,hjzubah}”(h]”h ]”h"]”h$]”h&]”uh1jxhjuubjy)”}”(hhh]”j )”}”(hŒHVGIC not properly configured as required prior to calling this attribute”h]”hŒHVGIC not properly configured as required prior to calling this attribute”…””}”(hj”h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K,hj‘ubah}”(h]”h ]”h"]”h$]”h&]”uh1jxhjuubeh}”(h]”h ]”h"]”h$]”h&]”uh1jshjpubjt)”}”(hhh]”(jy)”}”(hhh]”j )”}”(hŒ-ENODEV”h]”hŒ-ENODEV”…””}”(hj´h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K.hj±ubah}”(h]”h ]”h"]”h$]”h&]”uh1jxhj®ubjy)”}”(hhh]”j )”}”(hŒno online VCPU”h]”hŒno online VCPU”…””}”(hjËh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K.hjÈubah}”(h]”h ]”h"]”h$]”h&]”uh1jxhj®ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jshjpubjt)”}”(hhh]”(jy)”}”(hhh]”j )”}”(hŒ-ENOMEM”h]”hŒ-ENOMEM”…””}”(hjëh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K/hjèubah}”(h]”h ]”h"]”h$]”h&]”uh1jxhjåubjy)”}”(hhh]”j )”}”(hŒ2memory shortage when allocating vgic internal data”h]”hŒ2memory shortage when allocating vgic internal data”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K/hjÿubah}”(h]”h ]”h"]”h$]”h&]”uh1jxhjåubeh}”(h]”h ]”h"]”h$]”h&]”uh1jshjpubjt)”}”(hhh]”(jy)”}”(hhh]”j )”}”(hŒ-EFAULT”h]”hŒ-EFAULT”…””}”(hj"h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K0hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jxhjubjy)”}”(hhh]”j )”}”(hŒInvalid guest ram access”h]”hŒInvalid guest ram access”…””}”(hj9h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K0hj6ubah}”(h]”h ]”h"]”h$]”h&]”uh1jxhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jshjpubjt)”}”(hhh]”(jy)”}”(hhh]”j )”}”(hŒ-EBUSY”h]”hŒ-EBUSY”…””}”(hjYh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K1hjVubah}”(h]”h ]”h"]”h$]”h&]”uh1jxhjSubjy)”}”(hhh]”j )”}”(hŒOne or more VCPUS are running”h]”hŒOne or more VCPUS are running”…””}”(hjph²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K1hjmubah}”(h]”h ]”h"]”h$]”h&]”uh1jxhjSubeh}”(h]”h ]”h"]”h$]”h&]”uh1jshjpubeh}”(h]”h ]”h"]”h$]”h&]”uh1jnhjUubeh}”(h]”h ]”h"]”h$]”h&]”Œcols”Kuh1jShjPubah}”(h]”h ]”h"]”h$]”h&]”uh1jNhjJubah}”(h]”h ]”h"]”h$]”h&]”uh1j’h³hÇh´K+hjiubeh}”(h]”h ]”h"]”h$]”h&]”uh1høhjWubeh}”(h]”h ]”h"]”h$]”h&]”uh1hâh³hÇh´K1hjTubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhhÊh²hh³hÇh´Nubeh}”(h]”Œ2arm-virtual-generic-interrupt-controller-v5-vgicv5”ah ]”h"]”Œ4arm virtual generic interrupt controller v5 (vgicv5)”ah$]”h&]”uh1hÈhhh²hh³hÇh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÇuh1hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÍNŒ generator”NŒ datestamp”NŒ source_link”NŒ source_url”NŒ toc_backlinks”jxŒfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒ report_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jߌerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÇŒ _destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œpep_references”NŒ pep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒ rfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œ smart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”jºj·sŒ nametypes”}”jº‰sh}”j·hÊsŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nh²hub.