€•Ð2      Œ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/xe/xe_cs”Œ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/xe/xe_cs”Œ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/xe/xe_cs”Œ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/xe/xe_cs”Œ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/xe/xe_cs”Œ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/xe/xe_cs”Œ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Œcomment”“”)”}”(hŒ*SPDX-License-Identifier: (GPL-2.0+ OR MIT)”h]”hŒ*SPDX-License-Identifier: (GPL-2.0+ OR MIT)”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒ:/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒCommand submission”h]”hŒCommand submission”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ	paragraph”“”)”}”(hŒkExecs have historically been rather complicated in DRM drivers (at least in
the i915) because a few things:”h]”hŒkExecs have historically been rather complicated in DRM drivers (at least in
the i915) because a few things:”…””}”(hhËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒX/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs:7: ./drivers/gpu/drm/xe/xe_exec.c”h Khh¶hžhubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒHPassing in a list BO which are read / written to creating implicit syncs”h]”hÊ)”}”(hhãh]”hŒHPassing in a list BO which are read / written to creating implicit syncs”…””}”(hhåhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒX/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs:7: ./drivers/gpu/drm/xe/xe_exec.c”h Khháubah}”(h]”h ]”h"]”h$]”h&]”uh1hßhhÜubhà)”}”(hŒBinding at exec time”h]”hÊ)”}”(hhûh]”hŒBinding at exec time”…””}”(hhýhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒX/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs:7: ./drivers/gpu/drm/xe/xe_exec.c”h Khhùubah}”(h]”h ]”h"]”h$]”h&]”uh1hßhhÜubhà)”}”(hŒ'Flow controlling the ring at exec time
”h]”hÊ)”}”(hŒ&Flow controlling the ring at exec time”h]”hŒ&Flow controlling the ring at exec time”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒX/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs:7: ./drivers/gpu/drm/xe/xe_exec.c”h K hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hßhhÜubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1hÚhŸhòh Khh¶hžhubhÊ)”}”(hŒýIn Xe we avoid all of this complication by not allowing a BO list to be
passed into an exec, using the dma-buf implicit sync uAPI, have binds as
separate operations, and using the DRM scheduler to flow control the ring.
Let's deep dive on each of these.”h]”hŒÿIn Xe we avoid all of this complication by not allowing a BO list to be
passed into an exec, using the dma-buf implicit sync uAPI, have binds as
separate operations, and using the DRM scheduler to flow control the ring.
Letâ€™s deep dive on each of these.”…””}”(hj2  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒX/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs:7: ./drivers/gpu/drm/xe/xe_exec.c”h K"hh¶hžhubhÊ)”}”(hX0  We can get away from a BO list by forcing the user to use in / out fences on
every exec rather than the kernel tracking dependencies of BO (e.g. if the
user knows an exec writes to a BO and reads from the BO in the next exec, it
is the user's responsibility to pass in / out fence between the two execs).”h]”hX2  We can get away from a BO list by forcing the user to use in / out fences on
every exec rather than the kernel tracking dependencies of BO (e.g. if the
user knows an exec writes to a BO and reads from the BO in the next exec, it
is the userâ€™s responsibility to pass in / out fence between the two execs).”…””}”(hjA  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒX/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs:7: ./drivers/gpu/drm/xe/xe_exec.c”h K'hh¶hžhubhÊ)”}”(hX}  We do not allow a user to trigger a bind at exec time rather we have a VM
bind IOCTL which uses the same in / out fence interface as exec. In that
sense, a VM bind is basically the same operation as an exec from the user
perspective. e.g. If an exec depends on a VM bind use the in / out fence
interface (struct drm_xe_sync) to synchronize like syncing between two
dependent execs.”h]”hX}  We do not allow a user to trigger a bind at exec time rather we have a VM
bind IOCTL which uses the same in / out fence interface as exec. In that
sense, a VM bind is basically the same operation as an exec from the user
perspective. e.g. If an exec depends on a VM bind use the in / out fence
interface (struct drm_xe_sync) to synchronize like syncing between two
dependent execs.”…””}”(hjP  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒX/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs:7: ./drivers/gpu/drm/xe/xe_exec.c”h K,hh¶hžhubhÊ)”}”(hX  Although a user cannot trigger a bind, we still have to rebind userptrs in
the VM that have been invalidated since the last exec, likewise we also have
to rebind BOs that have been evicted by the kernel. We schedule these rebinds
behind any pending kernel operations on any external BOs in VM or any BOs
private to the VM. This is accomplished by the rebinds waiting on BOs
DMA_RESV_USAGE_KERNEL slot (kernel ops) and kernel ops waiting on all BOs
slots (inflight execs are in the DMA_RESV_USAGE_BOOKKEEP for private BOs and
for external BOs).”h]”hX  Although a user cannot trigger a bind, we still have to rebind userptrs in
the VM that have been invalidated since the last exec, likewise we also have
to rebind BOs that have been evicted by the kernel. We schedule these rebinds
behind any pending kernel operations on any external BOs in VM or any BOs
private to the VM. This is accomplished by the rebinds waiting on BOs
DMA_RESV_USAGE_KERNEL slot (kernel ops) and kernel ops waiting on all BOs
slots (inflight execs are in the DMA_RESV_USAGE_BOOKKEEP for private BOs and
for external BOs).”…””}”(hj_  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒX/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs:7: ./drivers/gpu/drm/xe/xe_exec.c”h K3hh¶hžhubhÊ)”}”(hŒ‘Rebinds / dma-resv usage applies to non-compute mode VMs only as for compute
mode VMs we use preempt fences and a rebind worker (TODO: add link).”h]”hŒ‘Rebinds / dma-resv usage applies to non-compute mode VMs only as for compute
mode VMs we use preempt fences and a rebind worker (TODO: add link).”…””}”(hjn  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒX/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs:7: ./drivers/gpu/drm/xe/xe_exec.c”h K<hh¶hžhubhÊ)”}”(hŒòThere is no need to flow control the ring in the exec as we write the ring at
submission time and set the DRM scheduler max job limit SIZE_OF_RING /
MAX_JOB_SIZE. The DRM scheduler will then hold all jobs until space in the
ring is available.”h]”hŒòThere is no need to flow control the ring in the exec as we write the ring at
submission time and set the DRM scheduler max job limit SIZE_OF_RING /
MAX_JOB_SIZE. The DRM scheduler will then hold all jobs until space in the
ring is available.”…””}”(hj}  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒX/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs:7: ./drivers/gpu/drm/xe/xe_exec.c”h K?hh¶hžhubhÊ)”}”(hŒ;All of this results in a rather simple exec implementation.”h]”hŒ;All of this results in a rather simple exec implementation.”…””}”(hjŒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒX/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs:7: ./drivers/gpu/drm/xe/xe_exec.c”h KDhh¶hžhubhµ)”}”(hhh]”(hº)”}”(hŒFlow”h]”hŒFlow”…””}”(hjž  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj›  hŸNh NubhŒliteral_block”“”)”}”(hX¦  Parse input arguments
Wait for any async VM bind passed as in-fences to start
<----------------------------------------------------------------------|
Lock global VM lock in read mode                                       |
Pin userptrs (also finds userptr invalidated since last exec)          |
Lock exec (VM dma-resv lock, external BOs dma-resv locks)              |
Validate BOs that have been evicted                                    |
Create job                                                             |
Rebind invalidated userptrs + evicted BOs (non-compute-mode)           |
Add rebind fence dependency to job                                     |
Add job VM dma-resv bookkeeping slot (non-compute mode)                |
Add job to external BOs dma-resv write slots (non-compute mode)        |
Check if any userptrs invalidated since pin ------ Drop locks ---------|
Install in / out fences for job
Submit job
Unlock all”h]”hX¦  Parse input arguments
Wait for any async VM bind passed as in-fences to start
<----------------------------------------------------------------------|
Lock global VM lock in read mode                                       |
Pin userptrs (also finds userptr invalidated since last exec)          |
Lock exec (VM dma-resv lock, external BOs dma-resv locks)              |
Validate BOs that have been evicted                                    |
Create job                                                             |
Rebind invalidated userptrs + evicted BOs (non-compute-mode)           |
Add rebind fence dependency to job                                     |
Add job VM dma-resv bookkeeping slot (non-compute mode)                |
Add job to external BOs dma-resv write slots (non-compute mode)        |
Check if any userptrs invalidated since pin ------ Drop locks ---------|
Install in / out fences for job
Submit job
Unlock all”…””}”hj®  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²Œforce”‰Œlanguage”Œnone”Œhighlight_args”}”uh1j¬  hŸŒX/var/lib/git/docbuild/linux/Documentation/gpu/xe/xe_cs:7: ./drivers/gpu/drm/xe/xe_exec.c”h KIhj›  ubeh}”(h]”Œflow”ah ]”h"]”Œflow”ah$]”h&]”uh1h´hh¶hžhhŸNh Nubeh}”(h]”Œcommand-submission”ah ]”h"]”Œcommand submission”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(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”}”(jÏ  jÌ  jÇ  jÄ  uŒ	nametypes”}”(jÏ  ‰jÇ  ‰uh}”(jÌ  h¶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.