oceanic

海洋：PC桌面操作系统

中文说明

警告：该项目仍处于早期阶段，并且在操作系统中无法使用用户程序。用户应考虑到虚拟机或裸机在虚拟机或裸机中运行该软件的任何潜在风险。

目前，该项目仅支持X86_64体系结构，将来可能会支持AARCH64。

特征

• 纯微核体系结构：仅内核拥有诸如内存管理，任务调度和过程间通信之类的必要功能，将其他功能留给了用户空间任务。
• 完全异步的内核对象：每个系统呼叫都基于基于异步调度器对象的Procactor异步API，从理论上讲，它比Linux的io-uring更方便，更有资源友好。
• 完全异步驱动程序：驱动程序由动态库表示，由驱动程序主机加载并由设备管理器控制。 DDK库使驱动程序可以在驱动程序主机上作为异步任务运行，并且多个驱动程序可以按照单个驱动程序主机运行。
• 基于类型的任务管理：每个任务的状态都由Rust类型系统而不是单个状态字段表示，并且其结构不需要依靠参考分数指针。运行任务由调度程序所有，而通过futex引用或暂停令牌的阻止任务，从而降低了代码复杂性。
• 孤立和本地VFS ：（受紫红色的启发）每个过程都有自己的VF，这是任务的选择是否与子女任务共享VF。

路线图

当前工作

• 完成DDK库。
• 实施基本驱动程序（PCI，ACPI等）。

进一步的待办事项（可能会改变）

• 实施存储驱动程序。
• 实施一些存储FSE（脂肪等）。
• 完成设备管理器和程序管理器实施。
• 合并为Rust STD。

源树

• debug - 包含分解的组件文件，调试符号，对象文件信息。以及虚拟机的串行日志文件。
• h2o包含内核的源代码。
• scripts - 包含构建项目所需的脚本。
• src包含整个项目的库和可执行文件的源代码。
• target - 包含二进制文件和虚拟磁盘文件。
• xtask包含该项目的构建器。

来源建造和调试

Linux

1. 下载Rust和其他依赖项（例如Ubuntu）：

    # Select the nightly channel for rust
   curl --proto ' =https ' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   sudo apt install build-essential qemu-system-x86 llvm-14 nasm
   export LLVM_PATH= " /usr/lib/llvm-14 "

2. 添加以下目标：

   rustup target add nightly-x86_64-unknown-linux-gnu

3. 更改为项目的根目录并运行以下命令：

   cargo xtask dist img

4. 要使用QEMU运行操作系统，请运行以下命令：

   sh scripts/run.sh qemu N # N for the number of CPUs

   并检查debug/qemu.log文件，您应该看到OS的输出。

5. 要与Qemu进行调试，请运行以下命令：

   sh scripts/run.sh qdbg N # Same as above

   并打开一个新的终端：

    # cd to the working directory
   gdb debug/FOO.sym
   # FOO for the binary you want to debug;
   # you may check it in the directory first.
   
   # In the gdb:
   target remote :1234

   然后，您可以设置断点（例如kernel.sym）：

   b kmain
   c

6. 如果要使用其他VM软件运行OS，请先检查Run.SH，然后根据需要手动创建VM配置文件。不要忘记添加虚拟磁盘和串行日志，或者不会出现输出！

贡献

如果您想做出贡献，请务必先与我联系。

• 电子邮件：[email protected]
• QQ：2534027071