€•.      Œ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Œ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hø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j!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  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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  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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 K2hj  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jM  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j  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jg  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jc  ubah}”(h]”h ]”h"]”h$]”h&]”uh1ja  hj^  ubjb  )”}”(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&]”uh1ja  hj^  ubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1j\  hj  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ubj]  )”}”(hhh]”(jb  )”}”(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&]”uh1ja  hjÁ  ubjb  )”}”(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&]”uh1ja  hjÁ  ubjb  )”}”(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&]”uh1ja  hjÁ  ubeh}”(h]”h ]”h"]”h$]”h&]”j›  jœ  j  hjž  jŸ  uh1j\  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”jH  Œ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  j­  jª  j  j  j¥  j¢  j  j  uŒ	nametypes”}”(j"  ‰j­  ‰j  ‰j¥  ‰j  ‰uh}”(j  h£jª  hÇj  hçj¢  j  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.