Esphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/arch/riscv/boot-image-headermodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget0/translations/zh_TW/arch/riscv/boot-image-headermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget0/translations/it_IT/arch/riscv/boot-image-headermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget0/translations/ja_JP/arch/riscv/boot-image-headermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget0/translations/ko_KR/arch/riscv/boot-image-headermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget0/translations/sp_SP/arch/riscv/boot-image-headermodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Simplified)uh1h hh _documenthsourceNlineNubhnote)}(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&]uh1hhhh]/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/arch/riscv/boot-image-header.rsthKubh field_body)}(h/Documentation/arch/riscv/boot-image-header.rst h]h)}(h.Documentation/arch/riscv/boot-image-header.rsth]h.Documentation/arch/riscv/boot-image-header.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翻译}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh)}(h-司延腾 Yanteng Si h]h)}(h,司延腾 Yanteng Si h](h司延腾 Yanteng Si <}(hjhhhNhNubh reference)}(hsiyanteng@loongson.cnh]hsiyanteng@loongson.cn}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:siyanteng@loongson.cnuh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhtarget)}(h.. _cn_boot-image-header.rst:h]h}(h]h ]h"]h$]h&]refidcn-boot-image-header-rstuh1jDhKhhhhhhubhsection)}(hhh](htitle)}(h!RISC-V Linux启动镜像文件头h]h!RISC-V Linux启动镜像文件头}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jWhjThhhhhK ubh)}(hhh](h)}(hhh](h)}(hAuthorh]hAuthor}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjhhhKubh)}(h!Atish Patra h]h)}(hj}h](h Atish Patra <}(hjhhhNhNubj)}(hatish.patra@wdc.comh]hatish.patra@wdc.com}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:atish.patra@wdc.comuh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj{ubah}(h]h ]h"]h$]h&]uh1hhjjubeh}(h]h ]h"]h$]h&]uh1hhhhKhjghhubh)}(hhh](h)}(hDateh]hDate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhKubh)}(h 20 May 2019 h]h)}(h 20 May 2019h]h 20 May 2019}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]uh1hhhhKhjghhubeh}(h]h ]h"]h$]h&]uh1hhjThhhhhKubh)}(h:此文档仅描述RISC-V Linux 启动文件头的详情。h]h:此文档仅描述RISC-V Linux 启动文件头的详情。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjThhubhdefinition_list)}(hhh]hdefinition_list_item)}(h(TODO: 写一个完整的启动指南。 h](hterm)}(hTODO:h]hTODO:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhjubh definition)}(hhh]h)}(h!写一个完整的启动指南。h]h!写一个完整的启动指南。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjThhhhhNubh)}(hE在解压后的Linux内核镜像中存在以下64字节的文件头::h]hD在解压后的Linux内核镜像中存在以下64字节的文件头:}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjThhubh literal_block)}(hXsu32 code0; /* Executable code */ u32 code1; /* Executable code */ u64 text_offset; /* Image load offset, little endian */ u64 image_size; /* Effective Image size, little endian */ u64 flags; /* kernel flags, little endian */ u32 version; /* Version of this header */ u32 res1 = 0; /* Reserved */ u64 res2 = 0; /* Reserved */ u64 magic = 0x5643534952; /* Magic number, little endian, "RISCV" */ u32 magic2 = 0x05435352; /* Magic number 2, little endian, "RSC\x05" */ u32 res3; /* Reserved for PE COFF offset */h]hXsu32 code0; /* Executable code */ u32 code1; /* Executable code */ u64 text_offset; /* Image load offset, little endian */ u64 image_size; /* Effective Image size, little endian */ u64 flags; /* kernel flags, little endian */ u32 version; /* Version of this header */ u32 res1 = 0; /* Reserved */ u64 res2 = 0; /* Reserved */ u64 magic = 0x5643534952; /* Magic number, little endian, "RISCV" */ u32 magic2 = 0x05435352; /* Magic number 2, little endian, "RSC\x05" */ u32 res3; /* Reserved for PE COFF offset */}hj?sbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1j=hhhKhjThhubh)}(h这种头格式与PE/COFF文件头兼容，并在很大程度上受到ARM64文件头的启发。因此，ARM64 和RISC-V文件头可以在未来合并为一个共同的头。h]h这种头格式与PE/COFF文件头兼容，并在很大程度上受到ARM64文件头的启发。因此，ARM64 和RISC-V文件头可以在未来合并为一个共同的头。}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK%hjThhubjS)}(hhh](jX)}(h注意h]h注意}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jWhj]hhhhhK)ubh bullet_list)}(hhh](h list_item)}(hXf将来也可以复用这个文件头，用来对RISC-V的EFI桩提供支持。为了使内核镜像如同一个 EFI应用程序一样加载，EFI规范中规定在内核镜像的开始需要PE/COFF镜像文件头。为了 支持EFI桩，应该用“MZ”魔术字符替换掉code0，并且res3（偏移量未0x3c）应指向PE/COFF 文件头的其余部分. h]h)}(hXe将来也可以复用这个文件头，用来对RISC-V的EFI桩提供支持。为了使内核镜像如同一个 EFI应用程序一样加载，EFI规范中规定在内核镜像的开始需要PE/COFF镜像文件头。为了 支持EFI桩，应该用“MZ”魔术字符替换掉code0，并且res3（偏移量未0x3c）应指向PE/COFF 文件头的其余部分.h]hXe将来也可以复用这个文件头，用来对RISC-V的EFI桩提供支持。为了使内核镜像如同一个 EFI应用程序一样加载，EFI规范中规定在内核镜像的开始需要PE/COFF镜像文件头。为了 支持EFI桩，应该用“MZ”魔术字符替换掉code0，并且res3（偏移量未0x3c）应指向PE/COFF 文件头的其余部分.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hjuubah}(h]h ]h"]h$]h&]uh1jshjphhhhhNubjt)}(h表示文件头版本号的Drop-bit位域 ========== ========== Bits 0:15 次要 版本 Bits 16:31 主要 版本 ========== ========== 这保持了新旧版本之间的兼容性。 当前版本被定义为0.2。 h](h)}(h)表示文件头版本号的Drop-bit位域h]h)表示文件头版本号的Drop-bit位域}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjubh block_quote)}(hd========== ========== Bits 0:15 次要 版本 Bits 16:31 主要 版本 ========== ========== h]htable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jhjubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(h Bits 0:15h]h Bits 0:15}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h次要 版本h]h次要 版本}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h Bits 16:31h]h Bits 16:31}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK4hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h主要 版本h]h主要 版本}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK4hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhK2hjubh)}(hL这保持了新旧版本之间的兼容性。 当前版本被定义为0.2。h]hL这保持了新旧版本之间的兼容性。 当前版本被定义为0.2。}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK7hjubeh}(h]h ]h"]h$]h&]uh1jshjphhhhhNubjt)}(hX从版本0.2开始，结构体成员“magic”就已经被弃用，在之后的版本中，可能会移除掉它。 最初，该成员应该与ARM64头的“magic”成员匹配，但遗憾的是并没有。 “magic2”成员代替“magic”成员与ARM64头相匹配。 h]h)}(hX从版本0.2开始，结构体成员“magic”就已经被弃用，在之后的版本中，可能会移除掉它。 最初，该成员应该与ARM64头的“magic”成员匹配，但遗憾的是并没有。 “magic2”成员代替“magic”成员与ARM64头相匹配。h]hX从版本0.2开始，结构体成员“magic”就已经被弃用，在之后的版本中，可能会移除掉它。 最初，该成员应该与ARM64头的“magic”成员匹配，但遗憾的是并没有。 “magic2”成员代替“magic”成员与ARM64头相匹配。}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hjiubah}(h]h ]h"]h$]h&]uh1jshjphhhhhNubjt)}(h在当前的文件头，标志位域只剩下了一个位。 ===== ============================== Bit 0 内核字节序。1 if BE, 0 if LE. ===== ============================== h](h)}(h<在当前的文件头，标志位域只剩下了一个位。h]h<在当前的文件头，标志位域只剩下了一个位。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK>hjubj)}(hw===== ============================== Bit 0 内核字节序。1 if BE, 0 if LE. ===== ============================== h]j)}(hhh]j)}(hhh](j)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]j)}(hhh](j)}(hhh]h)}(hBit 0h]hBit 0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h#内核字节序。1 if BE, 0 if LE.h]h#内核字节序。1 if BE, 0 if LE.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhK@hjubeh}(h]h ]h"]h$]h&]uh1jshjphhhhhNubjt)}(h对于引导加载程序加载内核映像来说，image_size成员对引导加载程序而言是必须的，否 则将引导失败。h]h)}(h对于引导加载程序加载内核映像来说，image_size成员对引导加载程序而言是必须的，否 则将引导失败。h]h对于引导加载程序加载内核映像来说，image_size成员对引导加载程序而言是必须的，否 则将引导失败。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhj ubah}(h]h ]h"]h$]h&]uh1jshjphhhhhNubeh}(h]h ]h"]h$]h&]bullet-uh1jnhhhK+hj]hhubeh}(h]id1ah ]h"]注意ah$]h&]uh1jRhjThhhhhK)ubeh}(h]( risc-v-linuxjQeh ]h"](!risc-v linux启动镜像文件头cn_boot-image-header.rsteh$]h&]uh1jRhhhhhhhK expect_referenced_by_name}j8jFsexpect_referenced_by_id}jQjFsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(jWN generatorN datestampN source_linkN source_urlN toc_backlinksjfootnote_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_handlerjaerror_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}refids}jQ]jFasnameids}(j8jQj7j4j/j,u nametypes}(j8j7j/uh}(jQjTj4jTj,j]u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}joKsRparse_messages]transform_messages]hsystem_message)}(hhh]h)}(hhh]h>Hyperlink target "cn-boot-image-header-rst" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOsourceh،lineKuh1juba transformerN include_log]ADocumentation/translations/zh_CN/arch/riscv/boot-image-header.rst(NNNNta decorationNhhub.