>sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/dev-tools/ubsanmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/zh_TW/dev-tools/ubsanmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/it_IT/dev-tools/ubsanmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ja_JP/dev-tools/ubsanmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ko_KR/dev-tools/ubsanmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/sp_SP/dev-tools/ubsanmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Simplified)uh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhP/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/dev-tools/ubsan.rsthKubhnote)}(hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。h]h paragraph)}(hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。h]hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hh5Documentation/translations/zh_CN/disclaimer-zh_CN.rsthKhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh field_list)}(hhh](hfield)}(hhh](h field_name)}(hOriginalh]hOriginal}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh field_body)}(h"Documentation/dev-tools/ubsan.rst h]h)}(h!Documentation/dev-tools/ubsan.rsth]h!Documentation/dev-tools/ubsan.rst}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(h翻译h]h翻译}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhKubh)}(h+慕冬亮 Dongliang Mu h]h)}(h*慕冬亮 Dongliang Mu h](h慕冬亮 Dongliang Mu <}(hj hhhNhNubh reference)}(hdzm91@hust.edu.cnh]hdzm91@hust.edu.cn}(hj*hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:dzm91@hust.edu.cnuh1j(hj ubh>}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK hjubah}(h]h ]h"]h$]h&]uh1hhj ubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(h校译h]h校译}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhhhKubh)}(h,王昱力 WangYuli h]h)}(h+王昱力 WangYuli h](h王昱力 WangYuli <}(hjehhhNhNubj))}(hwangyuli@uniontech.comh]hwangyuli@uniontech.com}(hjmhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:wangyuli@uniontech.comuh1j(hjeubh>}(hjehhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK hjaubah}(h]h ]h"]h$]h&]uh1hhjPubeh}(h]h ]h"]h$]h&]uh1hhhhK hhhhubeh}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhsection)}(hhh](htitle)}(h 未定义行为消毒剂 - UBSANh]h 未定义行为消毒剂 - UBSAN}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh)}(h2UBSAN是一种动态未定义行为检查工具。h]h2UBSAN是一种动态未定义行为检查工具。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hUBSAN使用编译时插桩捕捉未定义行为。编译器在可能导致未定义行为的操作前插入特定 检测代码。如果检查失败，即检测到未定义行为，__ubsan_handle_* 函数将被调用打印 错误信息。h]hUBSAN使用编译时插桩捕捉未定义行为。编译器在可能导致未定义行为的操作前插入特定 检测代码。如果检查失败，即检测到未定义行为，__ubsan_handle_* 函数将被调用打印 错误信息。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hGCC自4.9.x [1_] （详见 ``-fsanitize=undefined`` 选项及其子选项）版本后引入这 一特性。GCC 5.x 版本实现了更多检查器 [2_]。h](h GCC自4.9.x [}(hjhhhNhNubj))}(h1_h]h1}(hjhhhNhNubah}(h]h ]h"]h$]h&]name1refuriChttps://gcc.gnu.org/onlinedocs/gcc-4.9.0/gcc/Debugging-Options.htmluh1j(hjresolvedKubh ] （详见 }(hjhhhNhNubhliteral)}(h``-fsanitize=undefined``h]h-fsanitize=undefined}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh` 选项及其子选项）版本后引入这 一特性。GCC 5.x 版本实现了更多检查器 [}(hjhhhNhNubj))}(h2_h]h2}(hjhhhNhNubah}(h]h ]h"]h$]h&]name2j9https://gcc.gnu.org/onlinedocs/gcc/Debugging-Options.htmluh1j(hjjKubh]。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hhh](j)}(h 报告样例h]h 报告样例}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh literal_block)}(hX================================================================================ UBSAN: Undefined behaviour in ../include/linux/bitops.h:110:33 shift exponent 32 is to large for 32-bit type 'unsigned int' CPU: 0 PID: 0 Comm: swapper Not tainted 4.4.0-rc1+ #26 0000000000000000 ffffffff82403cc8 ffffffff815e6cd6 0000000000000001 ffffffff82403cf8 ffffffff82403ce0 ffffffff8163a5ed 0000000000000020 ffffffff82403d78 ffffffff8163ac2b ffffffff815f0001 0000000000000002 Call Trace: [] dump_stack+0x45/0x5f [] ubsan_epilogue+0xd/0x40 [] __ubsan_handle_shift_out_of_bounds+0xeb/0x130 [] ? radix_tree_gang_lookup_slot+0x51/0x150 [] _mix_pool_bytes+0x1e6/0x480 [] ? dmi_walk_early+0x48/0x5c [] add_device_randomness+0x61/0x130 [] ? dmi_save_one_device+0xaa/0xaa [] dmi_walk_early+0x48/0x5c [] dmi_scan_machine+0x278/0x4b4 [] ? vprintk_default+0x1a/0x20 [] ? early_idt_handler_array+0x120/0x120 [] setup_arch+0x405/0xc2c [] ? early_idt_handler_array+0x120/0x120 [] start_kernel+0x83/0x49a [] ? early_idt_handler_array+0x120/0x120 [] x86_64_start_reservations+0x2a/0x2c [] x86_64_start_kernel+0x16b/0x17a ================================================================================h]hX================================================================================ UBSAN: Undefined behaviour in ../include/linux/bitops.h:110:33 shift exponent 32 is to large for 32-bit type 'unsigned int' CPU: 0 PID: 0 Comm: swapper Not tainted 4.4.0-rc1+ #26 0000000000000000 ffffffff82403cc8 ffffffff815e6cd6 0000000000000001 ffffffff82403cf8 ffffffff82403ce0 ffffffff8163a5ed 0000000000000020 ffffffff82403d78 ffffffff8163ac2b ffffffff815f0001 0000000000000002 Call Trace: [] dump_stack+0x45/0x5f [] ubsan_epilogue+0xd/0x40 [] __ubsan_handle_shift_out_of_bounds+0xeb/0x130 [] ? radix_tree_gang_lookup_slot+0x51/0x150 [] _mix_pool_bytes+0x1e6/0x480 [] ? dmi_walk_early+0x48/0x5c [] add_device_randomness+0x61/0x130 [] ? dmi_save_one_device+0xaa/0xaa [] dmi_walk_early+0x48/0x5c [] dmi_scan_machine+0x278/0x4b4 [] ? vprintk_default+0x1a/0x20 [] ? early_idt_handler_array+0x120/0x120 [] setup_arch+0x405/0xc2c [] ? early_idt_handler_array+0x120/0x120 [] start_kernel+0x83/0x49a [] ? early_idt_handler_array+0x120/0x120 [] x86_64_start_reservations+0x2a/0x2c [] x86_64_start_kernel+0x16b/0x17a ================================================================================}hj+sbah}(h]h ]h"]h$]h&]hhuh1j)hhhK hjhhubeh}(h]id1ah ]h"] 报告样例ah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(h用法h]h用法}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAhhhhhK=ubh)}(h%使用如下内核配置启用UBSAN::h]h$使用如下内核配置启用UBSAN:}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjAhhubj*)}(hCONFIG_UBSAN=yh]hCONFIG_UBSAN=y}hj`sbah}(h]h ]h"]h$]h&]hhuh1j)hhhKAhjAhhubh)}(h排除要被检测的文件::h]h排除要被检测的文件:}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChjAhhubj*)}(hUBSAN_SANITIZE_main.o := nh]hUBSAN_SANITIZE_main.o := n}hj|sbah}(h]h ]h"]h$]h&]hhuh1j)hhhKEhjAhhubh)}(h&排除一个目录中的所有文件::h]h%排除一个目录中的所有文件:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjAhhubj*)}(hUBSAN_SANITIZE := nh]hUBSAN_SANITIZE := n}hjsbah}(h]h ]h"]h$]h&]hhuh1j)hhhKIhjAhhubh)}(hJ当全部文件都被禁用，可通过如下方式为特定文件启用::h]hI当全部文件都被禁用，可通过如下方式为特定文件启用:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKKhjAhhubj*)}(hUBSAN_SANITIZE_main.o := yh]hUBSAN_SANITIZE_main.o := y}hjsbah}(h]h ]h"]h$]h&]hhuh1j)hhhKMhjAhhubh)}(hX未对齐的内存访问检测可通过开启独立选项 - CONFIG_UBSAN_ALIGNMENT 检测。 该选项在支持未对齐访问的架构上(CONFIG_HAVE_EFFICIENT_UNALIGNED_ACCESS=y) 默认为关闭。该选项仍可通过内核配置启用，但它将产生大量的UBSAN报告。h]hX未对齐的内存访问检测可通过开启独立选项 - CONFIG_UBSAN_ALIGNMENT 检测。 该选项在支持未对齐访问的架构上(CONFIG_HAVE_EFFICIENT_UNALIGNED_ACCESS=y) 默认为关闭。该选项仍可通过内核配置启用，但它将产生大量的UBSAN报告。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjAhhubeh}(h]id2ah ]h"]用法ah$]h&]uh1jhjhhhhhK=ubj)}(hhh](j)}(h 参考文献h]h 参考文献}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKTubhtarget)}(hJ.. _1: https://gcc.gnu.org/onlinedocs/gcc-4.9.0/gcc/Debugging-Options.htmlh]h}(h]id4ah ]h"]1ah$]h&]jjuh1jhKahjhhhh referencedKubj)}(h@.. _2: https://gcc.gnu.org/onlinedocs/gcc/Debugging-Options.htmlh]h}(h]id5ah ]h"]2ah$]h&]jj uh1jhKbhjhhhhjKubj)}(hB.. _3: https://clang.llvm.org/docs/UndefinedBehaviorSanitizer.htmlh]h}(h]id6ah ]h"]3ah$]h&]j;https://clang.llvm.org/docs/UndefinedBehaviorSanitizer.htmluh1jhKchjhhhhubeh}(h]id3ah ]h"] 参考文献ah$]h&]uh1jhjhhhhhKTubeh}(h]ubsanah ]h"] 未定义行为消毒剂 - ubsanah$]h&]uh1jhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(jN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjDerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}(1]ja2]jaurefids}nameids}(jjj>j;jjjjjjjjj j u nametypes}(jj>jjjjj uh}(jjj;jjjAjjjjjjj ju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jRKsRparse_messages]transform_messages]hsystem_message)}(hhh]h)}(hhh]h'Hyperlink target "3" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineKcuh1juba transformerN include_log]4Documentation/translations/zh_CN/dev-tools/ubsan.rst(NNNNta decorationNhhub.