kernel_liteos_a_note: A C repository from cr1106

将 HarmonyOS | 鸿蒙研究到底 < 国内 | 国外 >

百篇博客系列篇.本篇为:

v13.xx 鸿蒙内核源码分析(源码注释篇) | 鸿蒙必定成功，也必然成功 | 51 .c .h .o

同步官方源码历史

每月至少同步一次
2021/5/28 -- 本次官方改动不大,主要针对一些错误单词拼写纠正
2021/5/13 -- 本次官方对系统调用，任务切换，信号处理，异常接管，汇编文件，文件管理，shell 做了较大更新，代码结构更清晰，部分代码需重新加注.
2021/4/21 -- 官方优化了很多之前吐槽的地方，点赞.
2020/9/16 -- 中文注解版起点.

几点说明

kernel_liteos_a_note 是在 OpenHarmony 的 kernel_liteos_a (鸿蒙轻内核项目)基础上给源码加上中文注解的版本.加注版与官方版本保持每月同步.
注解分析博客地址:
- 国内: https://weharmony.gitee.io/weharmony
- 国外: https://weharmony.github.io/weharmony
博客站点更新速度:
- 注解分析地址
- oschina
- 51cto
- csdn
OpenHarmony开发者文档是对官方文档 docs 做的非常炫酷的静态站点，支持侧边栏/面包屑/搜索/中英文，非常方便的查看官方文档，大大提高学习和开发效率.
- 国内: https://weharmony.gitee.io/openharmony
- 国外: https://weharmony.github.io/openharmony
OpenHarmony全量代码仓库是 OpenHarmony 的110+个子项目的所有代码. OpenHarmony 使用repo管理众多git项目，repo在linux下很方便，但在windows上谁用谁知道，使用会有相当的困难，所以将所有项目整合成一个.git工程，如此使用git便能下载整个鸿蒙系统源码，方便学习使用.与官方仓库保持每周同步.OpenHarmony全量代码仓库已编译通过.
```
....
[OHOS INFO] [1587/1590] STAMP obj/test/xts/acts/build_lite/acts_generate_module_data.stamp
[OHOS INFO] [1588/1590] ACTION //test/xts/acts/build_lite:acts(//build/lite/toolchain:linux_x86_64_ohos_clang)
[OHOS INFO] [1589/1590] STAMP obj/test/xts/acts/build_lite/acts.stamp
[OHOS INFO] [1590/1590] STAMP obj/build/lite/ohos.stamp
[OHOS INFO] ipcamera_hispark_aries build success
root@5e3abe332c5a:/home/harmony#
```
下载.鸿蒙源码分析.离线文档
- 国内: https://weharmony.gitee.io/history/
- 国外: https://weharmony.github.io/history/

为何要精读内核源码?

码农的学职生涯，都应精读一遍内核源码.以浇筑好计算机知识大厦的地基，地基纵深的坚固程度，很大程度能决定未来大厦能盖多高.那为何一定要精读细品呢?
因为内核代码本身并不太多，都是浓缩的精华，精读是让各个知识点高频出现，不孤立成点状记忆，没有足够连接点的知识点是很容易忘的，点点成线，线面成体，连接越多，记得越牢，如此短时间内容易结成一张高浓度，高密度的系统化知识网，训练大脑肌肉记忆，驻入大脑直觉区，想抹都抹不掉，终生携带，随时调取.跟骑单车一样，一旦学会，即便多年不骑，照样跨上就走，游刃有余.

热爱是所有的理由和答案

因大学时阅读 linux 2.6 内核痛并快乐的经历，一直有个心愿，如何让更多对内核感兴趣的朋友减少阅读时间，加速对计算机系统级的理解，而不至于过早的放弃.但因过程种种，多年一直没有行动，基本要放弃这件事了.恰逢 2020/9/10 鸿蒙正式开源，重新激活了多年的心愿，就有那么点如黄河之水一发不可收拾了.
到 2021/3/10 刚好半年，对内核源码的注解已完成了 70% ，对内核源码的博客分析已完成了40篇，每天都很充实，很兴奋，连做梦内核代码都在鱼贯而入.如此疯狂地做一件事还是当年谈恋爱的时候，只因热爱，热爱是所有的理由和答案. :P

(〃･ิ‿･ิ)ゞ鸿蒙内核开发者

感谢开放原子开源基金会，致敬鸿蒙内核开发者提供了如此优秀的源码，一了多年的夙愿，津津乐道于此.精读内核源码加注并整理成档是件很有挑战的事，时间上要以月甚至年为单位，但正因为很难才值得去做! 干困难事，方有所得;专注聚焦，必有所获.
从内核一行行的代码中能深深感受到开发者各中艰辛与坚持，及鸿蒙生态对未来的价值，这些是张嘴就来的网络喷子们永远不能体会到的.可以毫不夸张的说鸿蒙内核源码可作为大学 C语言，数据结构，操作系统，汇编语言，计算机组成原理 五门课程的教学项目.如此宝库，不深入研究实在是暴殄天物，于心不忍，注者坚信鸿蒙大势所趋，未来可期，其必定成功，也必然成功，誓做其坚定的追随者和传播者.

理解内核的三个层级

普通概念映射级: 这一级不涉及专业知识，用大众所熟知的公共认知就能听明白是个什么概念，也就是说用一个普通人都懂的概念去诠释或者映射一个他们从没听过的概念.让陌生的知识点与大脑中烂熟于心的知识点建立多重链接，加深记忆.说别人能听得懂的话这很重要!!! 一个没学过计算机知识的卖菜大妈就不可能知道内核的基本运作了吗? 不一定!在系列篇中试图用 鸿蒙内核源码分析(总目录)之故事篇 去引导这一层级的认知，希望能卷入更多的人来关注基础软件，尤其是那些资本大鳄，加大对基础软件的投入.
专业概念抽象级: 对抽象的专业逻辑概念具体化认知，比如虚拟内存，老百姓是听不懂的，学过计算机的人都懂，具体怎么实现的很多人又都不懂了，但这并不妨碍成为一个优秀的上层应用开发者，因为虚拟内存已经被抽象出来，目的是要屏蔽上层对它具体实现的认知.试图用 鸿蒙内核源码分析(总目录)百篇博客 去拆解那些已经被抽象出来的专业概念，希望能卷入更多对内核感兴趣的应用软件人才流入基础软硬件生态，应用软件咱们是无敌宇宙，但基础软件却很薄弱.
具体微观代码级: 这一级是具体到每一行代码的实现，到了用代码指令级的地步，这段代码是什么意思?为什么要这么设计?有没有更好的方案? 鸿蒙内核源码注解分析 试图从细微处去解释代码实现层，英文真的是天生适合设计成编程语言的人类语言，计算机的01码映射到人类世界的26个字母，诞生了太多的伟大奇迹.但我们的母语注定了很大部分人存在着自然语言层级的理解映射，希望鸿蒙内核源码注解分析能让更多爱好者快速的理解内核，共同进步.

加注方式是怎样的？

因鸿蒙内核6W+代码量，本身只有较少的注释，中文注解以不对原有代码侵入为前提，源码中所有英文部分都是原有注释，所有中文部分都是中文版的注释，同时为方便同步官方版本的更新，尽量不去增加代码的行数，不破坏文件的结构，注释多类似以下的方式:

在重要模块的.c/.h文件开始位置先对模块功能做整体的介绍，例如异常接管模块注解如图所示:

注解过程中查阅了很多的资料和书籍，在具体代码处都附上了参考链接.
而函数级注解会详细到重点行，甚至每一行，例如申请互斥锁的主体函数，不可谓不重要，而官方注释仅有一行，如图所示
另外画了一些字符图方便理解，直接嵌入到头文件中，比如虚拟内存的全景图，因没有这些图是很难理解虚拟内存是如何管理的.

有哪些特殊的记号

搜索 @note_pic 可查看绘制的全部字符图
搜索 @note_why 是尚未看明白的地方，有看明白的，请Pull Request完善
搜索 @note_thinking 是一些的思考和建议
搜索 @note_#if0 是由第三方项目提供不在内核源码中定义的极为重要结构体，为方便理解而添加的。
搜索 @note_good 是给源码点赞的地方

新增zzz目录

中文加注版比官方版无新增文件，只多了一个zzz的目录，里面放了一些文件，它与内核代码无关，大家可以忽略它，取名zzz是为了排在最后，减少对原有代码目录级的侵入，zzz的想法源于微信中名称为AAA的那帮朋友，你的微信里应该也有他们熟悉的身影吧 :|P

百篇博客.往期回顾

在加注过程中，整理出以下文章。内容立足源码，常以生活场景打比方尽可能多的将内核知识点置入某种场景，具有画面感，容易理解记忆。说别人能听得懂的话很重要! 百篇博客绝不是百度教条式的在说一堆诘屈聱牙的概念，那没什么意思。更希望让内核变得栩栩如生，倍感亲切.确实有难度，自不量力，但已经出发，回头已是不可能的了。 :P

与代码有bug需不断debug一样，文章和注解内容会存在不少错漏之处，请多包涵，但会反复修正，持续更新，.xx代表修改的次数，精雕细琢，言简意赅，力求打造精品内容。