Merge branch 'master' of github.com:Minep/lunaix-os
authorMinep <lunaixsky@qq.com>
Mon, 11 Dec 2023 01:00:23 +0000 (01:00 +0000)
committerMinep <lunaixsky@qq.com>
Mon, 11 Dec 2023 01:00:23 +0000 (01:00 +0000)
1  2 
README.md

diff --combined README.md
index bb7f24fc627cc3b7938e88f573657d542c0d120a,c161be60757df70b038a1075f63eb282e280cb5e..f9e0e52effd95b9dbfb73dc4fa4c4fb884437637
+++ b/README.md
@@@ -14,6 -14,7 +14,7 @@@ LunaixOS - ä¸\80个ç®\80å\8d\95ç\9a\84ï¼\8c详ç»\86ç\9a\84ï
  
  如果有意研读LunaixOS的内核代码和其中的设计,以下资料可能会对此有用。
  
+ + [最新的LunaixOS源代码分析教程](docs/tutorial/0-教程介绍和环境搭建.md)
  + [内核虚拟内存的详细布局](docs/img/lunaix-os-mem.png)
  + [LunaixOS启动流程概览](docs/img/boot_sequence.jpeg)
  + LunaixOS总体架构概览(WIP)
@@@ -108,24 -109,6 +109,24 @@@ make CX_PREFIX=i686-linux-gnu- al
  
  **※:由于在`-O2`模式下,GCC会进行CSE优化,这导致LunaixOS会出现一些非常奇怪、离谱的bug,从而影响到基本运行。具体原因有待调查。**
  
 +### 4.4 设置内核启动参数
 +
 +在 make 的时候通过`CMDLINE`变量可以设置内核启动参数列表。该列表可以包含多个参数,通过一个或多个空格来分割。每个参数可以为键值对 `<key>=<val>` 或者是开关标志位 `<flag>`。目前 Lunaix 支持以下参数:
 +
 ++ `console=<dev>` 设置系统终端的输入输出设备(tty设备)。其中 `<dev>` 是设备文件路径 (注意,这里的设备文件路径是针对Lunaix,而非Linux)。关于LunaixOS设备文件系统的介绍可参考 Lunaix Wiki(WIP)
 +
 +如果`CMDLINE`未指定,则将会载入默认参数:
 +
 +```
 +console=/dev/ttyFB0
 +```
 +
 +其中,`/dev/ttyFB0` 指向基于VGA文本模式的tty设备,也就是平时启动QEMU时看到的黑色窗口。
 +
 +当然,读者也可以使用 `/dev/ttyS0` 来作为默认tty设备,来验证 Lunaix 的灵活性与兼容性。该路径指向第一个串口设备。可以通过telnet协议在`12345`端口上进行访问——端口号可以自行修改QEMU启动参数(位于:`makeinc/qemu.mkinc`)来变更。
 +
 +**注意:** 根据操作系统和键盘布局的不同,telnet客户端对一些关键键位的映射(如退格,回车)可能有所差别(如某些版本的Linux会将退格键映射为`0x7f`,也就是ASCII的`<DEL>`字符,而非我们熟知`0x08`)。如果读者想要通过串口方式把玩Lunaix,请修改`usr/init/init.c`里面的终端初始化代码,将`VERASE`设置为正确的映射(修改方式可以参考 POSIX termios 的使用方式。由于Lunaix的终端接口的实现是完全兼容POSIX的,读者可以直接去查阅Linux自带的帮助`man termios`,无需作任何的转换)
 +
  ## 5. 运行,分支以及 Issue
  
  ### 5.1 虚拟磁盘(非必须)
@@@ -175,7 -158,6 +176,6 @@@ qemu-img create -f vdi machine/disk0.vd
  + `vmrs [pid]` 列举进程`<pid>`的内存区域图(Memory Regions),如果`<pid>`未指定,则默认为正在运行的进程(smp=1)。
  + `proc [pid]` 打印进程`<pid>`的进程控制块状态,如果`<pid>`未指定,则默认为正在运行的进程(smp=1)。
  + `proc_table` 列举所有非终止的进程以及他们的状态。
- + `syslog` 打印到目前为止的系统日志。
  
  该插件可以通过运行以下命令来进行安装: