€•ô.      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”(hhŒparent”hubaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ)/translations/zh_CN/power/drivers-testing”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”(hhhh2ubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ)/translations/zh_TW/power/drivers-testing”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”(hhhhFubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ)/translations/it_IT/power/drivers-testing”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”(hhhhZubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ)/translations/ja_JP/power/drivers-testing”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”(hhhhnubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ)/translations/ko_KR/power/drivers-testing”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”(hhhh‚ubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ)/translations/sp_SP/power/drivers-testing”Œ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Œ4Testing suspend and resume support in device drivers”h]”hŒ4Testing suspend and resume support in device drivers”…””}”(hhªhh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒC/var/lib/git/docbuild/linux/Documentation/power/drivers-testing.rst”h KubhŒblock_quote”“”)”}”(hhh]”hŒenumerated_list”“”)”}”(hhh]”hŒ	list_item”“”)”}”(hŒ*2007 Rafael J. Wysocki <rjw@sisk.pl>, GPL
”h]”hŒ	paragraph”“”)”}”(hŒ)2007 Rafael J. Wysocki <rjw@sisk.pl>, GPL”h]”(hŒ2007 Rafael J. Wysocki <”…””}”(hŒ2007 Rafael J. Wysocki <”hhÉhžhhŸNh NubhŒ	reference”“”)”}”(hŒrjw@sisk.pl”h]”hŒrjw@sisk.pl”…””}”(hhhhÔhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:rjw@sisk.pl”uh1hÒhhÉubhŒ>, GPL”…””}”(hŒ>, GPL”hhÉhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h KhhÃubah}”(h]”h ]”h"]”h$]”h&]”uh1hÁhh¾ubah}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œ
upperalpha”Œprefix”Œ(”Œsuffix”Œ)”Œstart”Kuh1h¼hh¹ubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hh£hžhhŸNh Nubh¢)”}”(hhh]”(h§)”}”(hŒ1. Preparing the test system”h]”hŒ1. Preparing the test system”…””}”(hj  hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h KubhÈ)”}”(hXå  Unfortunately, to effectively test the support for the system-wide suspend and
resume transitions in a driver, it is necessary to suspend and resume a fully
functional system with this driver loaded.  Moreover, that should be done
several times, preferably several times in a row, and separately for hibernation
(aka suspend to disk or STD) and suspend to RAM (STR), because each of these
cases involves slightly different operations and different interactions with
the machine's BIOS.”h]”hXç  Unfortunately, to effectively test the support for the system-wide suspend and
resume transitions in a driver, it is necessary to suspend and resume a fully
functional system with this driver loaded.  Moreover, that should be done
several times, preferably several times in a row, and separately for hibernation
(aka suspend to disk or STD) and suspend to RAM (STR), because each of these
cases involves slightly different operations and different interactions with
the machineâ€™s BIOS.”…””}”(hj  hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h K
hj  hžhubhÈ)”}”(hX€  Of course, for this purpose the test system has to be known to suspend and
resume without the driver being tested.  Thus, if possible, you should first
resolve all suspend/resume-related problems in the test system before you start
testing the new driver.  Please see Documentation/power/basic-pm-debugging.rst
for more information about the debugging of suspend/resume functionality.”h]”hX€  Of course, for this purpose the test system has to be known to suspend and
resume without the driver being tested.  Thus, if possible, you should first
resolve all suspend/resume-related problems in the test system before you start
testing the new driver.  Please see Documentation/power/basic-pm-debugging.rst
for more information about the debugging of suspend/resume functionality.”…””}”(hj)  hj'  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h Khj  hžhubeh}”(h]”Œpreparing-the-test-system”ah ]”h"]”Œ1. preparing the test system”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒ2. Testing the driver”h]”hŒ2. Testing the driver”…””}”(hjB  hj@  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj=  hžhhŸh¶h KubhÈ)”}”(hŒ‚Once you have resolved the suspend/resume-related problems with your test system
without the new driver, you are ready to test it:”h]”hŒ‚Once you have resolved the suspend/resume-related problems with your test system
without the new driver, you are ready to test it:”…””}”(hjP  hjN  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h Khj=  hžhubh½)”}”(hhh]”(hÂ)”}”(hŒ‚Build the driver as a module, load it and try the test modes of hibernation
(see: Documentation/power/basic-pm-debugging.rst, 1).
”h]”hÈ)”}”(hŒBuild the driver as a module, load it and try the test modes of hibernation
(see: Documentation/power/basic-pm-debugging.rst, 1).”h]”hŒBuild the driver as a module, load it and try the test modes of hibernation
(see: Documentation/power/basic-pm-debugging.rst, 1).”…””}”(hje  hjc  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h Khj_  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÁhj\  hžhhŸh¶h NubhÂ)”}”(hŒLoad the driver and attempt to hibernate in the "reboot", "shutdown" and
"platform" modes (see: Documentation/power/basic-pm-debugging.rst, 1).
”h]”hÈ)”}”(hŒLoad the driver and attempt to hibernate in the "reboot", "shutdown" and
"platform" modes (see: Documentation/power/basic-pm-debugging.rst, 1).”h]”hŒ›Load the driver and attempt to hibernate in the â€œrebootâ€, â€œshutdownâ€ and
â€œplatformâ€ modes (see: Documentation/power/basic-pm-debugging.rst, 1).”…””}”(hj}  hj{  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h K!hjw  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÁhj\  hžhhŸh¶h NubhÂ)”}”(hŒSCompile the driver directly into the kernel and try the test modes of
hibernation.
”h]”hÈ)”}”(hŒRCompile the driver directly into the kernel and try the test modes of
hibernation.”h]”hŒRCompile the driver directly into the kernel and try the test modes of
hibernation.”…””}”(hj•  hj“  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h K$hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÁhj\  hžhhŸh¶h NubhÂ)”}”(hŒyAttempt to hibernate with the driver compiled directly into the kernel
in the "reboot", "shutdown" and "platform" modes.
”h]”hÈ)”}”(hŒxAttempt to hibernate with the driver compiled directly into the kernel
in the "reboot", "shutdown" and "platform" modes.”h]”hŒ„Attempt to hibernate with the driver compiled directly into the kernel
in the â€œrebootâ€, â€œshutdownâ€ and â€œplatformâ€ modes.”…””}”(hj­  hj«  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h K'hj§  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÁhj\  hžhhŸh¶h NubhÂ)”}”(hŒÃTry the test modes of suspend (see:
Documentation/power/basic-pm-debugging.rst, 2).  [As far as the STR tests are
concerned, it should not matter whether or not the driver is built as a
module.]
”h]”hÈ)”}”(hŒÂTry the test modes of suspend (see:
Documentation/power/basic-pm-debugging.rst, 2).  [As far as the STR tests are
concerned, it should not matter whether or not the driver is built as a
module.]”h]”hŒÂTry the test modes of suspend (see:
Documentation/power/basic-pm-debugging.rst, 2).  [As far as the STR tests are
concerned, it should not matter whether or not the driver is built as a
module.]”…””}”(hjÅ  hjÃ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h K*hj¿  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÁhj\  hžhhŸh¶h NubhÂ)”}”(hŒ|Attempt to suspend to RAM using the s2ram tool with the driver loaded
(see: Documentation/power/basic-pm-debugging.rst, 2).
”h]”hÈ)”}”(hŒ{Attempt to suspend to RAM using the s2ram tool with the driver loaded
(see: Documentation/power/basic-pm-debugging.rst, 2).”h]”hŒ{Attempt to suspend to RAM using the s2ram tool with the driver loaded
(see: Documentation/power/basic-pm-debugging.rst, 2).”…””}”(hjÝ  hjÛ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h K/hj×  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÁhj\  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”hûŒ
loweralpha”hýhhÿj   uh1h¼hj=  hžhhŸh¶h KubhÈ)”}”(hŒ»Each of the above tests should be repeated several times and the STD tests
should be mixed with the STR tests.  If any of them fails, the driver cannot be
regarded as suspend/resume-safe.”h]”hŒ»Each of the above tests should be repeated several times and the STD tests
should be mixed with the STR tests.  If any of them fails, the driver cannot be
regarded as suspend/resume-safe.”…””}”(hjø  hjö  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h K2hj=  hžhubeh}”(h]”Œtesting-the-driver”ah ]”h"]”Œ2. testing the driver”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubeh}”(h]”Œ4testing-suspend-and-resume-support-in-device-drivers”ah ]”h"]”Œ4testing suspend and resume support in device drivers”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”j7  Œ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Œ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”‰Œfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œ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”‰Œembed_images”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j  j  j:  j7  j	  j  uŒ	nametypes”}”(j  Nj:  Nj	  Nuh}”(j  h£j7  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”]”hŒsystem_message”“”)”}”(hhh]”hÈ)”}”(hŒ:Enumerated list start value not ordinal-1: "C" (ordinal 3)”h]”hŒ>Enumerated list start value not ordinal-1: â€œCâ€ (ordinal 3)”…””}”(hhhjŸ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjœ  ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h¶Œline”Kuh1jš  hh¹ubaŒtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.