€•Ó.      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ!/translations/zh_CN/gpu/xen-front”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/zh_TW/gpu/xen-front”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/it_IT/gpu/xen-front”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/ja_JP/gpu/xen-front”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/ko_KR/gpu/xen-front”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/pt_BR/gpu/xen-front”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ!/translations/sp_SP/gpu/xen-front”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ2drm/xen-front Xen para-virtualized frontend driver”h]”hŒ2drm/xen-front Xen para-virtualized frontend driver”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³Œ;/var/lib/git/docbuild/linux/Documentation/gpu/xen-front.rst”h´KubhŒ	paragraph”“”)”}”(hŒŽThis frontend driver implements Xen para-virtualized display
according to the display protocol described at
include/xen/interface/io/displif.h”h]”hŒŽThis frontend driver implements Xen para-virtualized display
according to the display protocol described at
include/xen/interface/io/displif.h”…””}”(hhÍh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubh¶)”}”(hhh]”(h»)”}”(hŒ:Driver modes of operation in terms of display buffers used”h]”hŒ:Driver modes of operation in terms of display buffers used”…””}”(hhÞh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhhÛh²hh³hÊh´K
ubhÌ)”}”(hŒûDepending on the requirements for the para-virtualized environment, namely
requirements dictated by the accompanying DRM/(v)GPU drivers running in both
host and guest environments, display buffers can be allocated by either
frontend driver or backend.”h]”hŒûDepending on the requirements for the para-virtualized environment, namely
requirements dictated by the accompanying DRM/(v)GPU drivers running in both
host and guest environments, display buffers can be allocated by either
frontend driver or backend.”…””}”(hhìh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³Œa/var/lib/git/docbuild/linux/Documentation/gpu/xen-front:12: ./drivers/gpu/drm/xen/xen_drm_front.h”h´KhhÛh²hubh¶)”}”(hhh]”(h»)”}”(hŒ(Buffers allocated by the frontend driver”h]”hŒ(Buffers allocated by the frontend driver”…””}”(hhþh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhhûh²hh³hÊh´KubhÌ)”}”(hŒFIn this mode of operation driver allocates buffers from system memory.”h]”hŒFIn this mode of operation driver allocates buffers from system memory.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³Œa/var/lib/git/docbuild/linux/Documentation/gpu/xen-front:18: ./drivers/gpu/drm/xen/xen_drm_front.h”h´K$hhûh²hubhÌ)”}”(hŒôNote! If used with accompanying DRM/(v)GPU drivers this mode of operation
may require IOMMU support on the platform, so accompanying DRM/vGPU
hardware can still reach display buffer memory while importing PRIME
buffers from the frontend driver.”h]”hŒôNote! If used with accompanying DRM/(v)GPU drivers this mode of operation
may require IOMMU support on the platform, so accompanying DRM/vGPU
hardware can still reach display buffer memory while importing PRIME
buffers from the frontend driver.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³Œa/var/lib/git/docbuild/linux/Documentation/gpu/xen-front:18: ./drivers/gpu/drm/xen/xen_drm_front.h”h´K&hhûh²hubeh}”(h]”Œ(buffers-allocated-by-the-frontend-driver”ah ]”h"]”Œ(buffers allocated by the frontend driver”ah$]”h&]”uh1hµhhÛh²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒ Buffers allocated by the backend”h]”hŒ Buffers allocated by the backend”…””}”(hj5  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj2  h²hh³hÊh´KubhÌ)”}”(hŒfThis mode of operation is run-time configured via guest domain configuration
through XenStore entries.”h]”hŒfThis mode of operation is run-time configured via guest domain configuration
through XenStore entries.”…””}”(hjC  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³Œa/var/lib/git/docbuild/linux/Documentation/gpu/xen-front:24: ./drivers/gpu/drm/xen/xen_drm_front.h”h´K/hj2  h²hubhÌ)”}”(hX[  For systems which do not provide IOMMU support, but having specific
requirements for display buffers it is possible to allocate such buffers
at backend side and share those with the frontend.
For example, if host domain is 1:1 mapped and has DRM/GPU hardware expecting
physically contiguous memory, this allows implementing zero-copying
use-cases.”h]”hX[  For systems which do not provide IOMMU support, but having specific
requirements for display buffers it is possible to allocate such buffers
at backend side and share those with the frontend.
For example, if host domain is 1:1 mapped and has DRM/GPU hardware expecting
physically contiguous memory, this allows implementing zero-copying
use-cases.”…””}”(hjR  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³Œa/var/lib/git/docbuild/linux/Documentation/gpu/xen-front:24: ./drivers/gpu/drm/xen/xen_drm_front.h”h´K2hj2  h²hubhÌ)”}”(hŒCNote, while using this scenario the following should be considered:”h]”hŒCNote, while using this scenario the following should be considered:”…””}”(hja  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³Œa/var/lib/git/docbuild/linux/Documentation/gpu/xen-front:24: ./drivers/gpu/drm/xen/xen_drm_front.h”h´K9hj2  h²hubhŒenumerated_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒXIf guest domain dies then pages/grants received from the backend
cannot be claimed back
”h]”hÌ)”}”(hŒWIf guest domain dies then pages/grants received from the backend
cannot be claimed back”h]”hŒWIf guest domain dies then pages/grants received from the backend
cannot be claimed back”…””}”(hj{  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³Œa/var/lib/git/docbuild/linux/Documentation/gpu/xen-front:24: ./drivers/gpu/drm/xen/xen_drm_front.h”h´K;hjw  ubah}”(h]”h ]”h"]”h$]”h&]”uh1ju  hjr  ubjv  )”}”(hŒŠMisbehaving guest may send too many requests to the
backend exhausting its grant references and memory
(consider this from security POV)

”h]”hÌ)”}”(hŒˆMisbehaving guest may send too many requests to the
backend exhausting its grant references and memory
(consider this from security POV)”h]”hŒˆMisbehaving guest may send too many requests to the
backend exhausting its grant references and memory
(consider this from security POV)”…””}”(hj”  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³Œa/var/lib/git/docbuild/linux/Documentation/gpu/xen-front:24: ./drivers/gpu/drm/xen/xen_drm_front.h”h´K>hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1ju  hjr  ubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1jp  hj2  h²hh³Nh´Nubeh}”(h]”Œ buffers-allocated-by-the-backend”ah ]”h"]”Œ buffers allocated by the backend”ah$]”h&]”uh1hµhhÛh²hh³hÊh´Kubeh}”(h]”Œ:driver-modes-of-operation-in-terms-of-display-buffers-used”ah ]”h"]”Œ:driver modes of operation in terms of display buffers used”ah$]”h&]”uh1hµhh·h²hh³hÊh´K
ubh¶)”}”(hhh]”(h»)”}”(hŒDriver limitations”h]”hŒDriver limitations”…””}”(hjÇ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjÄ  h²hh³hÊh´Kubjq  )”}”(hhh]”(jv  )”}”(hŒ?Only primary plane without additional properties is supported.
”h]”hÌ)”}”(hŒ>Only primary plane without additional properties is supported.”h]”hŒ>Only primary plane without additional properties is supported.”…””}”(hjÜ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³Œa/var/lib/git/docbuild/linux/Documentation/gpu/xen-front:30: ./drivers/gpu/drm/xen/xen_drm_front.h”h´KFhjØ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1ju  hjÕ  ubjv  )”}”(hŒNOnly one video mode per connector supported which is configured
via XenStore.
”h]”hÌ)”}”(hŒMOnly one video mode per connector supported which is configured
via XenStore.”h]”hŒMOnly one video mode per connector supported which is configured
via XenStore.”…””}”(hjõ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³Œa/var/lib/git/docbuild/linux/Documentation/gpu/xen-front:30: ./drivers/gpu/drm/xen/xen_drm_front.h”h´KHhjñ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1ju  hjÕ  ubjv  )”}”(hŒ/All CRTCs operate at fixed frequency of 60Hz.

”h]”hÌ)”}”(hŒ-All CRTCs operate at fixed frequency of 60Hz.”h]”hŒ-All CRTCs operate at fixed frequency of 60Hz.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³Œa/var/lib/git/docbuild/linux/Documentation/gpu/xen-front:30: ./drivers/gpu/drm/xen/xen_drm_front.h”h´KKhj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1ju  hjÕ  ubeh}”(h]”h ]”h"]”h$]”h&]”j¯  j°  j±  hj²  j³  uh1jp  hjÄ  h²hh³Nh´Nubeh}”(h]”Œdriver-limitations”ah ]”h"]”Œdriver limitations”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubeh}”(h]”Œ2drm-xen-front-xen-para-virtualized-frontend-driver”ah ]”h"]”Œ2drm/xen-front xen para-virtualized frontend driver”ah$]”h&]”uh1hµhhh²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”Œentry”Œ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”}”(j6  j3  jÁ  j¾  j/  j,  j¹  j¶  j.  j+  uŒ	nametypes”}”(j6  ‰jÁ  ‰j/  ‰j¹  ‰j.  ‰uh}”(j3  h·j¾  hÛj,  hûj¶  j2  j+  jÄ  uŒ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.