€•êm      Œ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/amdgpu/ras”Œ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/amdgpu/ras”Œ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/amdgpu/ras”Œ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/amdgpu/ras”Œ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/amdgpu/ras”Œ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/amdgpu/ras”Œ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ŒAMDGPU RAS Support”h]”hŒAMDGPU RAS Support”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒ</var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras.rst”h KubhŒ	paragraph”“”)”}”(hŒnThe AMDGPU RAS interfaces are exposed via sysfs (for informational queries) and
debugfs (for error injection).”h]”hŒnThe AMDGPU RAS interfaces are exposed via sysfs (for informational queries) and
debugfs (for error injection).”…””}”(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Œ8RAS debugfs/sysfs Control and Error Injection Interfaces”h]”hŒ8RAS debugfs/sysfs Control and Error Injection Interfaces”…””}”(hhÊhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hhÇhžhhŸh¶h K	ubh¸)”}”(hŒHThe control interface accepts struct ras_debug_if which has two members.”h]”hŒHThe control interface accepts struct ras_debug_if which has two members.”…””}”(hhØhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MhhÇhžhubh¸)”}”(hŒ9First member: ras_debug_if::head or ras_debug_if::inject.”h]”hŒ9First member: ras_debug_if::head or ras_debug_if::inject.”…””}”(hhçhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M‘hhÇhžhubh¸)”}”(hŒ>head is used to indicate which IP block will be under control.”h]”hŒ>head is used to indicate which IP block will be under control.”…””}”(hhöhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M“hhÇhžhubh¸)”}”(hŒùhead has four members, they are block, type, sub_block_index, name.
block: which IP will be under control.
type: what kind of error will be enabled/disabled/injected.
sub_block_index: some IPs have subcomponets. say, GFX, sDMA.
name: the name of IP.”h]”hŒùhead has four members, they are block, type, sub_block_index, name.
block: which IP will be under control.
type: what kind of error will be enabled/disabled/injected.
sub_block_index: some IPs have subcomponets. say, GFX, sDMA.
name: the name of IP.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M•hhÇhžhubh¸)”}”(hŒ™inject has three more members than head, they are address, value and mask.
As their names indicate, inject operation will write the
value to the address.”h]”hŒ™inject has three more members than head, they are address, value and mask.
As their names indicate, inject operation will write the
value to the address.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M›hhÇhžhubh¸)”}”(hŒMThe second member: struct ras_debug_if::op.
It has three kinds of operations.”h]”hŒMThe second member: struct ras_debug_if::op.
It has three kinds of operations.”…””}”(hj#  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MŸhhÇhžhubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ50: disable RAS on the block. Take ::head as its data.”h]”h¸)”}”(hj;  h]”hŒ50: disable RAS on the block. Take ::head as its data.”…””}”(hj=  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M¢hj9  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j7  hj4  ubj8  )”}”(hŒ41: enable RAS on the block. Take ::head as its data.”h]”h¸)”}”(hjS  h]”hŒ41: enable RAS on the block. Take ::head as its data.”…””}”(hjU  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M£hjQ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j7  hj4  ubj8  )”}”(hŒ:2: inject errors on the block. Take ::inject as its data.
”h]”h¸)”}”(hŒ92: inject errors on the block. Take ::inject as its data.”h]”hŒ92: inject errors on the block. Take ::inject as its data.”…””}”(hjm  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M¤hji  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j7  hj4  ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j2  hŸjJ  h M¢hhÇhžhubh¸)”}”(hŒHow to use the interface?”h]”hŒHow to use the interface?”…””}”(hjŠ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M¦hhÇhžhubh¸)”}”(hŒIn a program”h]”hŒIn a program”…””}”(hj™  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M¨hhÇhžhubh¸)”}”(hŒgCopy the struct ras_debug_if in your code and initialize it.
Write the struct to the control interface.”h]”hŒgCopy the struct ras_debug_if in your code and initialize it.
Write the struct to the control interface.”…””}”(hj¨  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MªhhÇhžhubh¸)”}”(hŒ
From shell”h]”hŒ
From shell”…””}”(hj·  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M­hhÇhžhubhŒliteral_block”“”)”}”(hŒôecho "disable <block>" > /sys/kernel/debug/dri/<N>/ras/ras_ctrl
echo "enable  <block> <error>" > /sys/kernel/debug/dri/<N>/ras/ras_ctrl
echo "inject  <block> <error> <sub-block> <address> <value> <mask>" > /sys/kernel/debug/dri/<N>/ras/ras_ctrl”h]”hŒôecho "disable <block>" > /sys/kernel/debug/dri/<N>/ras/ras_ctrl
echo "enable  <block> <error>" > /sys/kernel/debug/dri/<N>/ras/ras_ctrl
echo "inject  <block> <error> <sub-block> <address> <value> <mask>" > /sys/kernel/debug/dri/<N>/ras/ras_ctrl”…””}”hjÈ  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”Œforce”‰Œlanguage”Œbash”Œhighlight_args”}”uh1jÆ  hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M¯hhÇhžhubh¸)”}”(hŒ.Where N, is the card which you want to affect.”h]”hŒ.Where N, is the card which you want to affect.”…””}”(hjÞ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MµhhÇhžhubh¸)”}”(hŒ‹"disable" requires only the block.
"enable" requires the block and error type.
"inject" requires the block, error type, address, and value.”h]”hŒ—â€œdisableâ€ requires only the block.
â€œenableâ€ requires the block and error type.
â€œinjectâ€ requires the block, error type, address, and value.”…””}”(hjí  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M·hhÇhžhubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒMThe block is one of: umc, sdma, gfx, etc.
see ras_block_string[] for details
”h]”(hŒterm”“”)”}”(hŒ)The block is one of: umc, sdma, gfx, etc.”h]”hŒ)The block is one of: umc, sdma, gfx, etc.”…””}”(hj	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M¼hj  ubhŒ
definition”“”)”}”(hhh]”h¸)”}”(hŒ"see ras_block_string[] for details”h]”hŒ"see ras_block_string[] for details”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸj  h M¼hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸj  h M¼hjþ  ubj  )”}”(hŒwThe error type is one of: ue, ce and poison where,
ue is multi-uncorrectable
ce is single-correctable
poison is poison
”h]”(j  )”}”(hŒ2The error type is one of: ue, ce and poison where,”h]”hŒ2The error type is one of: ue, ce and poison where,”…””}”(hj;  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MÁhj7  ubj  )”}”(hhh]”h¸)”}”(hŒCue is multi-uncorrectable
ce is single-correctable
poison is poison”h]”hŒCue is multi-uncorrectable
ce is single-correctable
poison is poison”…””}”(hjM  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M¿hjJ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj7  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸjI  h MÁhjþ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jü  hhÇhžhhŸNh Nubh¸)”}”(hŒÐThe sub-block is a the sub-block index, pass 0 if there is no sub-block.
The address and value are hexadecimal numbers, leading 0x is optional.
The mask means instance mask, is optional, default value is 0x1.”h]”hŒÐThe sub-block is a the sub-block index, pass 0 if there is no sub-block.
The address and value are hexadecimal numbers, leading 0x is optional.
The mask means instance mask, is optional, default value is 0x1.”…””}”(hjn  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MÃhhÇhžhubh¸)”}”(hŒFor instance,”h]”hŒFor instance,”…””}”(hj}  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MÇhhÇhžhubjÇ  )”}”(hŒ¿echo inject umc ue 0x0 0x0 0x0 > /sys/kernel/debug/dri/0/ras/ras_ctrl
echo inject umc ce 0 0 0 3 > /sys/kernel/debug/dri/0/ras/ras_ctrl
echo disable umc > /sys/kernel/debug/dri/0/ras/ras_ctrl”h]”hŒ¿echo inject umc ue 0x0 0x0 0x0 > /sys/kernel/debug/dri/0/ras/ras_ctrl
echo inject umc ce 0 0 0 3 > /sys/kernel/debug/dri/0/ras/ras_ctrl
echo disable umc > /sys/kernel/debug/dri/0/ras/ras_ctrl”…””}”hjŒ  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  jØ  ‰jÙ  Œbash”jÛ  }”uh1jÆ  hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MÉhhÇhžhubh¸)”}”(hŒ)How to check the result of the operation?”h]”hŒ)How to check the result of the operation?”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MÏhhÇhžhubh¸)”}”(hŒaTo check disable/enable, see "ras" features at,
/sys/class/drm/card[0/1/2...]/device/ras/features”h]”hŒeTo check disable/enable, see â€œrasâ€ features at,
/sys/class/drm/card[0/1/2...]/device/ras/features”…””}”(hj¬  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MÑhhÇhžhubh¸)”}”(hŒ|To check inject, see the corresponding error count at,
/sys/class/drm/card[0/1/2...]/device/ras/[gfx|sdma|umc|...]_err_count”h]”hŒ|To check inject, see the corresponding error count at,
/sys/class/drm/card[0/1/2...]/device/ras/[gfx|sdma|umc|...]_err_count”…””}”(hj»  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MÔhhÇhžhubhŒnote”“”)”}”(hŒ¯Operations are only allowed on blocks which are supported.
Check the "ras" mask at /sys/module/amdgpu/parameters/ras_mask
to see which blocks support RAS on a particular asic.”h]”h¸)”}”(hŒ¯Operations are only allowed on blocks which are supported.
Check the "ras" mask at /sys/module/amdgpu/parameters/ras_mask
to see which blocks support RAS on a particular asic.”h]”hŒ³Operations are only allowed on blocks which are supported.
Check the â€œrasâ€ mask at /sys/module/amdgpu/parameters/ras_mask
to see which blocks support RAS on a particular asic.”…””}”(hjÐ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:11: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MØhjÌ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  hhÇhžhhŸNh Nubeh}”(h]”Œ8ras-debugfs-sysfs-control-and-error-injection-interfaces”ah ]”h"]”Œ8ras debugfs/sysfs control and error injection interfaces”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K	ubh¢)”}”(hhh]”(h§)”}”(hŒ,RAS Reboot Behavior for Unrecoverable Errors”h]”hŒ,RAS Reboot Behavior for Unrecoverable Errors”…””}”(hjð  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjí  hžhhŸh¶h Kubh¸)”}”(hŒÝNormally when there is an uncorrectable error, the driver will reset
the GPU to recover.  However, in the event of an unrecoverable error,
the driver provides an interface to reboot the system automatically
in that event.”h]”hŒÝNormally when there is an uncorrectable error, the driver will reset
the GPU to recover.  However, in the event of an unrecoverable error,
the driver provides an interface to reboot the system automatically
in that event.”…””}”(hjþ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:17: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M‘hjí  hžhubh¸)”}”(hŒgThe following file in debugfs provides that interface:
/sys/kernel/debug/dri/[0/1/2...]/ras/auto_reboot”h]”hŒgThe following file in debugfs provides that interface:
/sys/kernel/debug/dri/[0/1/2...]/ras/auto_reboot”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:17: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M–hjí  hžhubh¸)”}”(hŒUsage:”h]”hŒUsage:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:17: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M™hjí  hžhubjÇ  )”}”(hŒecho true > .../ras/auto_reboot”h]”hŒecho true > .../ras/auto_reboot”…””}”hj+  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  jØ  ‰jÙ  Œbash”jÛ  }”uh1jÆ  hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:17: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M›hjí  hžhubeh}”(h]”Œ,ras-reboot-behavior-for-unrecoverable-errors”ah ]”h"]”Œ,ras reboot behavior for unrecoverable errors”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒRAS Error Count sysfs Interface”h]”hŒRAS Error Count sysfs Interface”…””}”(hjG  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjD  hžhhŸh¶h Kubh¸)”}”(hŒ‘It allows the user to read the error count for each IP block on the gpu through
/sys/class/drm/card[0/1/2...]/device/ras/[gfx/sdma/...]_err_count”h]”hŒ‘It allows the user to read the error count for each IP block on the gpu through
/sys/class/drm/card[0/1/2...]/device/ras/[gfx/sdma/...]_err_count”…””}”(hjU  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:23: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M[hjD  hžhubh¸)”}”(hŒ`It outputs the multiple lines which report the uncorrected (ue) and corrected
(ce) error counts.”h]”hŒ`It outputs the multiple lines which report the uncorrected (ue) and corrected
(ce) error counts.”…””}”(hjd  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:23: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M^hjD  hžhubh¸)”}”(hŒ The format of one line is below,”h]”hŒ The format of one line is below,”…””}”(hjs  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:23: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MahjD  hžhubh¸)”}”(hŒ[ce|ue]: count”h]”hŒ[ce|ue]: count”…””}”(hj‚  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:23: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MchjD  hžhubh¸)”}”(hŒExample:”h]”hŒExample:”…””}”(hj‘  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:23: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MehjD  hžhubjÇ  )”}”(hŒue: 0
ce: 1”h]”hŒue: 0
ce: 1”…””}”hj   sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  jØ  ‰jÙ  Œbash”jÛ  }”uh1jÆ  hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:23: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h MghjD  hžhubeh}”(h]”Œras-error-count-sysfs-interface”ah ]”h"]”Œras error count sysfs interface”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒRAS EEPROM debugfs Interface”h]”hŒRAS EEPROM debugfs Interface”…””}”(hj¼  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj¹  hžhhŸh¶h Kubh¸)”}”(hŒÔSome boards contain an EEPROM which is used to persistently store a list of
bad pages which experiences ECC errors in vram.  This interface provides
a way to reset the EEPROM, e.g., after testing error injection.”h]”hŒÔSome boards contain an EEPROM which is used to persistently store a list of
bad pages which experiences ECC errors in vram.  This interface provides
a way to reset the EEPROM, e.g., after testing error injection.”…””}”(hjÊ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:29: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M(hj¹  hžhubh¸)”}”(hŒUsage:”h]”hŒUsage:”…””}”(hjÙ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:29: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M,hj¹  hžhubjÇ  )”}”(hŒ echo 1 > ../ras/ras_eeprom_reset”h]”hŒ echo 1 > ../ras/ras_eeprom_reset”…””}”hjè  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  jØ  ‰jÙ  Œbash”jÛ  }”uh1jÆ  hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:29: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M.hj¹  hžhubh¸)”}”(hŒ%will reset EEPROM table to 0 entries.”h]”hŒ%will reset EEPROM table to 0 entries.”…””}”(hjù  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:29: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M2hj¹  hžhubeh}”(h]”Œras-eeprom-debugfs-interface”ah ]”h"]”Œras eeprom debugfs interface”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒ"RAS VRAM Bad Pages sysfs Interface”h]”hŒ"RAS VRAM Bad Pages sysfs Interface”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h K!ubh¸)”}”(hŒ{It allows user to read the bad pages of vram on the gpu through
/sys/class/drm/card[0/1/2...]/device/ras/gpu_vram_bad_pages”h]”hŒ{It allows user to read the bad pages of vram on the gpu through
/sys/class/drm/card[0/1/2...]/device/ras/gpu_vram_bad_pages”…””}”(hj!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:35: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M«hj  hžhubh¸)”}”(hŒAIt outputs multiple lines, and each line stands for one gpu page.”h]”hŒAIt outputs multiple lines, and each line stands for one gpu page.”…””}”(hj0  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:35: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M®hj  hžhubh¸)”}”(hŒ@The format of one line is below,
gpu pfn : gpu page size : flags”h]”hŒ@The format of one line is below,
gpu pfn : gpu page size : flags”…””}”(hj?  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:35: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M°hj  hžhubh¸)”}”(hŒYgpu pfn and gpu page size are printed in hex format.
flags can be one of below character,”h]”hŒYgpu pfn and gpu page size are printed in hex format.
flags can be one of below character,”…””}”(hjN  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:35: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M³hj  hžhubh¸)”}”(hŒ;R: reserved, this gpu page is reserved and not able to use.”h]”hŒ;R: reserved, this gpu page is reserved and not able to use.”…””}”(hj]  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:35: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M¶hj  hžhubh¸)”}”(hŒhP: pending for reserve, this gpu page is marked as bad, will be reserved
in next window of page_reserve.”h]”hŒhP: pending for reserve, this gpu page is marked as bad, will be reserved
in next window of page_reserve.”…””}”(hjl  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:35: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M¸hj  hžhubh¸)”}”(hŒJF: unable to reserve. this gpu page can't be reserved due to some reasons.”h]”hŒLF: unable to reserve. this gpu page canâ€™t be reserved due to some reasons.”…””}”(hj{  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:35: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M»hj  hžhubh¸)”}”(hŒ	Examples:”h]”hŒ	Examples:”…””}”(hjŠ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:35: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M½hj  hžhubjÇ  )”}”(hŒ70x00000001 : 0x00001000 : R
0x00000002 : 0x00001000 : P”h]”hŒ70x00000001 : 0x00001000 : R
0x00000002 : 0x00001000 : P”…””}”hj™  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  jØ  ‰jÙ  Œbash”jÛ  }”uh1jÆ  hŸŒf/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/ras:35: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c”h M¿hj  hžhubeh}”(h]”Œ"ras-vram-bad-pages-sysfs-interface”ah ]”h"]”Œ"ras vram bad pages sysfs interface”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K!ubh¢)”}”(hhh]”(h§)”}”(hŒSample Code”h]”hŒSample Code”…””}”(hjµ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj²  hžhhŸh¶h K'ubh¸)”}”(hŒ~Sample code for testing error injection can be found here:
https://cgit.freedesktop.org/mesa/drm/tree/tests/amdgpu/ras_tests.c”h]”(hŒ;Sample code for testing error injection can be found here:
”…””}”(hjÃ  hžhhŸNh NubhŒ	reference”“”)”}”(hŒChttps://cgit.freedesktop.org/mesa/drm/tree/tests/amdgpu/ras_tests.c”h]”hŒChttps://cgit.freedesktop.org/mesa/drm/tree/tests/amdgpu/ras_tests.c”…””}”(hjÍ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jÏ  uh1jË  hjÃ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K(hj²  hžhubh¸)”}”(hŒpThis is part of the libdrm amdgpu unit tests which cover several areas of the GPU.
There are four sets of tests:”h]”hŒpThis is part of the libdrm amdgpu unit tests which cover several areas of the GPU.
There are four sets of tests:”…””}”(hjâ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K+hj²  hžhubh¸)”}”(hŒRAS Basic Test”h]”hŒRAS Basic Test”…””}”(hjð  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K.hj²  hžhubh¸)”}”(hŒrThe test verifies the RAS feature enabled status and makes sure the necessary sysfs and debugfs files
are present.”h]”hŒrThe test verifies the RAS feature enabled status and makes sure the necessary sysfs and debugfs files
are present.”…””}”(hjþ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K0hj²  hžhubh¸)”}”(hŒRAS Query Test”h]”hŒRAS Query Test”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K3hj²  hžhubh¸)”}”(hŒtThis test checks the RAS availability and enablement status for each supported IP block as well as
the error counts.”h]”hŒtThis test checks the RAS availability and enablement status for each supported IP block as well as
the error counts.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K5hj²  hžhubh¸)”}”(hŒRAS Inject Test”h]”hŒRAS Inject Test”…””}”(hj(  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K8hj²  hžhubh¸)”}”(hŒ%This test injects errors for each IP.”h]”hŒ%This test injects errors for each IP.”…””}”(hj6  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K:hj²  hžhubh¸)”}”(hŒRAS Disable Test”h]”hŒRAS Disable Test”…””}”(hjD  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K<hj²  hžhubh¸)”}”(hŒ<This test tests disabling of RAS features for each IP block.”h]”hŒ<This test tests disabling of RAS features for each IP block.”…””}”(hjR  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K>hj²  hžhubeh}”(h]”Œsample-code”ah ]”h"]”Œsample code”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K'ubeh}”(h]”Œamdgpu-ras-support”ah ]”h"]”Œamdgpu ras support”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”}”(jm  jj  jê  jç  jA  j>  j¶  j³  j  j
  j¯  j¬  je  jb  uŒ	nametypes”}”(jm  ‰jê  ‰jA  ‰j¶  ‰j  ‰j¯  ‰je  ‰uh}”(jj  h£jç  hÇj>  jí  j³  jD  j
  j¹  j¬  j  jb  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.