Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

Documentation:Update Documentation/zh_CN/arm64/booting.txt

This is a update of Chinese documentation: Documentation/zh_CN/arm64/booting.txt

It is based on the modifications of Documentation/arm64/booting.txt in submission:
"61bd93ce", "6c020ea8", "9d372c9f", "6d32ab2d".
And improve the format of documentation.

Signed-off-by: Fu Wei <wefu@redhat.com>
Reviewed-by: Weiwei Jia <harryxiyou@gmail.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by

Fu Wei and committed by
Jonathan Corbet
c06ffe66 5645a717

+55 -32
+55 -32
Documentation/zh_CN/arm64/booting.txt
··· 6 6 help. Contact the Chinese maintainer if this translation is outdated 7 7 or if there is a problem with the translation. 8 8 9 - Maintainer: Will Deacon <will.deacon@arm.com> 10 - Chinese maintainer: Fu Wei <wefu@redhat.com> 9 + M: Will Deacon <will.deacon@arm.com> 10 + zh_CN: Fu Wei <wefu@redhat.com> 11 + C: 1926e54f115725a9248d0c4c65c22acaf94de4c4 11 12 --------------------------------------------------------------------- 12 13 Documentation/arm64/booting.txt 的中文翻译 13 14 ··· 16 15 交流有困难的话,也可以向中文版维护者求助。如果本翻译更新不及时或者翻 17 16 译存在问题,请联系中文版维护者。 18 17 19 - 本文翻译提交时的 Git 检出点为: bc465aa9d045feb0e13b4a8f32cc33c1943f62d6 20 - 21 18 英文版维护者: Will Deacon <will.deacon@arm.com> 22 19 中文版维护者: 傅炜 Fu Wei <wefu@redhat.com> 23 20 中文版翻译者: 傅炜 Fu Wei <wefu@redhat.com> 24 21 中文版校译者: 傅炜 Fu Wei <wefu@redhat.com> 22 + 本文翻译提交时的 Git 检出点为: 1926e54f115725a9248d0c4c65c22acaf94de4c4 25 23 26 24 以下为正文 27 25 --------------------------------------------------------------------- ··· 33 33 本文档基于 Russell King 的 ARM 启动文档,且适用于所有公开发布的 34 34 AArch64 Linux 内核代码。 35 35 36 - AArch64 异常模型由多个异常级别(EL0 - EL3)组成,对于 EL0 和 EL1 37 - 异常级有对应的安全和非安全模式。EL2 是系统管理级,且仅存在于 38 - 非安全模式下。EL3 是最高特权级,且仅存在于安全模式下。 36 + AArch64 异常模型由多个异常级(EL0 - EL3)组成,对于 EL0 和 EL1 异常级 37 + 有对应的安全和非安全模式。EL2 是系统管理级,且仅存在于非安全模式下。 38 + EL3 是最高特权级,且仅存在于安全模式下。 39 39 40 40 基于本文档的目的,我们将简单地使用‘引导装载程序’(‘boot loader’) 41 41 这个术语来定义在将控制权交给 Linux 内核前 CPU 上执行的所有软件。 ··· 56 56 必要性: 强制 57 57 58 58 引导装载程序应该找到并初始化系统中所有内核用于保持系统变量数据的 RAM。 59 - 这个操作的执行是设备依赖的。(它可能使用内部算法来自动定位和计算所有 60 - RAM,或可能使用对这个设备已知的 RAM 信息,还可能使用任何引导装载程序 61 - 设计者想到的匹配方法。) 59 + 这个操作的执行方式因设备而异。(它可能使用内部算法来自动定位和计算所有 60 + RAM,或可能使用对这个设备已知的 RAM 信息,还可能是引导装载程序设计者 61 + 想到的任何合适的方法。) 62 62 63 63 64 64 2、设置设备树数据 ··· 66 66 67 67 必要性: 强制 68 68 69 - 设备树数据块(dtb)必须 8 字节对齐,并位于从内核映像起始算起第一个 512MB 70 - 内,且不得跨越 2MB 对齐边界。这使得内核可以通过初始页表中的单个节描述符来 71 - 映射此数据块。 69 + 设备树数据块(dtb)必须 8 字节对齐,且大小不能超过 2MB。由于设备树 70 + 数据块将在使能缓存的情况下以 2MB 粒度被映射,故其不能被置于带任意 71 + 特定属性被映射的 2MB 区域内。 72 72 73 + 注: v4.2 之前的版本同时要求设备树数据块被置于从内核映像以下 74 + text_offset 字节处算起第一个 512MB 内。 73 75 74 76 3、解压内核映像 75 77 ------------- ··· 80 78 81 79 AArch64 内核当前没有提供自解压代码,因此如果使用了压缩内核映像文件 82 80 (比如 Image.gz),则需要通过引导装载程序(使用 gzip 等)来进行解压。 83 - 若引导装载程序没有实现这个需求,就要使用非压缩内核映像文件。 81 + 若引导装载程序没有实现这个功能,就要使用非压缩内核映像文件。 84 82 85 83 86 84 4、调用内核映像 ··· 99 97 u64 res3 = 0; /* 保留 */ 100 98 u64 res4 = 0; /* 保留 */ 101 99 u32 magic = 0x644d5241; /* 魔数, 小端, "ARM\x64" */ 102 - u32 res5; /* 保留 (用于 PE COFF 偏移) */ 100 + u32 res5; /* 保留 (用于 PE COFF 偏移) */ 103 101 104 102 105 103 映像头注释: ··· 109 107 - code0/code1 负责跳转到 stext. 110 108 111 109 - 当通过 EFI 启动时, 最初 code0/code1 被跳过。 112 - res5 是到 PE 文件头的偏移,而 PE 文件头含有 EFI 的启动入口点 (efi_stub_entry)。 113 - 当 stub 代码完成了它的使命,它会跳转到 code0 继续正常的启动流程。 110 + res5 是到 PE 文件头的偏移,而 PE 文件头含有 EFI 的启动入口点 111 + (efi_stub_entry)。当 stub 代码完成了它的使命,它会跳转到 code0 112 + 继续正常的启动流程。 114 113 115 114 - v3.17 之前,未明确指定 text_offset 的字节序。此时,image_size 为零, 116 115 且 text_offset 依照内核字节序为 0x80000。 117 - 当 image_size 非零,text_offset 为小端模式且是有效值,应被引导加载程序使用。 118 - 当 image_size 为零,text_offset 可假定为 0x80000。 116 + 当 image_size 非零,text_offset 为小端模式且是有效值,应被引导加载 117 + 程序使用。当 image_size 为零,text_offset 可假定为 0x80000。 119 118 120 119 - flags 域 (v3.17 引入) 为 64 位小端模式,其编码如下: 121 120 位 0: 内核字节序。 1 表示大端模式,0 表示小端模式。 122 - 位 1-63: 保留。 121 + 位 1-2: 内核页大小。 122 + 0 - 未指定。 123 + 1 - 4K 124 + 2 - 16K 125 + 3 - 64K 126 + 位 3-63: 保留。 123 127 124 - - 当 image_size 为零时,引导装载程序应该试图在内核映像末尾之后尽可能多地保留空闲内存 125 - 供内核直接使用。对内存空间的需求量因所选定的内核特性而异, 且无实际限制。 128 + - 当 image_size 为零时,引导装载程序应试图在内核映像末尾之后尽可能 129 + 多地保留空闲内存供内核直接使用。对内存空间的需求量因所选定的内核 130 + 特性而异, 并无实际限制。 126 131 127 - 内核映像必须被放置在靠近可用系统内存起始的 2MB 对齐为基址的 text_offset 字节处,并从那里被调用。 128 - 当前,对 Linux 来说在此基址以下的内存是无法使用的,因此强烈建议将系统内存的起始作为这个基址。 129 - 从映像起始地址算起,最少必须为内核释放出 image_size 字节的空间。 132 + 内核映像必须被放置在靠近可用系统内存起始的 2MB 对齐为基址的 133 + text_offset 字节处,并从该处被调用。当前,对 Linux 来说在此基址以下的 134 + 内存是无法使用的,因此强烈建议将系统内存的起始作为这个基址。2MB 对齐 135 + 基址和内核映像起始地址之间的区域对于内核来说没有特殊意义,且可能被 136 + 用于其他目的。 137 + 从映像起始地址算起,最少必须准备 image_size 字节的空闲内存供内核使用。 130 138 131 - 任何提供给内核的内存(甚至在 2MB 对齐的基地址之前),若未从内核中标记为保留 139 + 任何提供给内核的内存(甚至在映像起始地址之前),若未从内核中标记为保留 132 140 (如在设备树(dtb)的 memreserve 区域),都将被认为对内核是可用。 133 141 134 142 在跳转入内核前,必须符合以下状态: ··· 159 147 160 148 - 高速缓存、MMU 161 149 MMU 必须关闭。 162 - 指令缓存开启或关闭都可以。 150 + 指令缓存开启或关闭皆可。 163 151 已载入的内核映像的相应内存区必须被清理,以达到缓存一致性点(PoC)。 164 - 当存在系统缓存或其他使能缓存的一致性主控器时,通常需使用虚拟地址维护其缓存,而非 set/way 操作。 152 + 当存在系统缓存或其他使能缓存的一致性主控器时,通常需使用虚拟地址 153 + 维护其缓存,而非 set/way 操作。 165 154 遵从通过虚拟地址操作维护构架缓存的系统缓存必须被配置,并可以被使能。 166 - 而不通过虚拟地址操作维护构架缓存的系统缓存(不推荐),必须被配置且禁用。 155 + 而不通过虚拟地址操作维护构架缓存的系统缓存(不推荐),必须被配置且 156 + 禁用。 167 157 168 - *译者注:对于 PoC 以及缓存相关内容,请参考 ARMv8 构架参考手册 ARM DDI 0487A 158 + *译者注:对于 PoC 以及缓存相关内容,请参考 ARMv8 构架参考手册 159 + ARM DDI 0487A 169 160 170 161 - 架构计时器 171 162 CNTFRQ 必须设定为计时器的频率,且 CNTVOFF 必须设定为对所有 CPU ··· 184 169 在进入内核映像的异常级中,所有构架中可写的系统寄存器必须通过软件 185 170 在一个更高的异常级别下初始化,以防止在 未知 状态下运行。 186 171 187 - 对于拥有 GICv3 中断控制器的系统: 188 - - 若当前在 EL3 : 172 + 对于拥有 GICv3 中断控制器并以 v3 模式运行的系统: 173 + - 如果 EL3 存在: 189 174 ICC_SRE_EL3.Enable (位 3) 必须初始化为 0b1。 190 175 ICC_SRE_EL3.SRE (位 0) 必须初始化为 0b1。 191 176 - 若内核运行在 EL1: 192 177 ICC_SRE_EL2.Enable (位 3) 必须初始化为 0b1。 193 178 ICC_SRE_EL2.SRE (位 0) 必须初始化为 0b1。 179 + - 设备树(DT)或 ACPI 表必须描述一个 GICv3 中断控制器。 180 + 181 + 对于拥有 GICv3 中断控制器并以兼容(v2)模式运行的系统: 182 + - 如果 EL3 存在: 183 + ICC_SRE_EL3.SRE (位 0) 必须初始化为 0b0。 184 + - 若内核运行在 EL1: 185 + ICC_SRE_EL2.SRE (位 0) 必须初始化为 0b0。 186 + - 设备树(DT)或 ACPI 表必须描述一个 GICv2 中断控制器。 194 187 195 188 以上对于 CPU 模式、高速缓存、MMU、架构计时器、一致性、系统寄存器的 196 189 必要条件描述适用于所有 CPU。所有 CPU 必须在同一异常级别跳入内核。