mirror of
https://github.com/DragonOS-Community/DragonOS.git
synced 2025-06-18 08:06:32 +00:00
新增VFS文档，以及修改文档配置 (#209)
* 1.新增vfs设计文档 2.修改文档版权标志为"2022-2023, DragonOS Community" 3.修改电脑版文档页面的宽度为90% * layout.html末尾加空行
This commit is contained in:
login
GitHub
@ -1,4 +1 @@
|
||||
# VFS API文档
|
||||
|
||||
|
||||
|
||||
|
||||
58
docs/kernel/filesystem/vfs/design.md
Normal file
58
docs/kernel/filesystem/vfs/design.md
Normal file
@ -0,0 +1,58 @@
|
||||
:::{note}
|
||||
本文作者: 龙进
|
||||
|
||||
Email: <longjin@DragonOS.org>
|
||||
:::
|
||||
|
||||
# 设计
|
||||
|
||||
|
||||
  VFS的架构设计如下图所示：
|
||||
|
||||
```text
|
||||
┌─────────┐
|
||||
│ │
|
||||
│ read │
|
||||
File │ │
|
||||
│ write │
|
||||
│ │ │
|
||||
│ │ ioctl │
|
||||
│ │ │
|
||||
│ │ lseek │
|
||||
│ │ │
|
||||
│ │ etc.. │
|
||||
│ └─────────┘
|
||||
│
|
||||
▼ ┌──────────────────────────────────────────────────────────────────────────────┐
|
||||
MountFS │ Maintain the mount tree and handle the mounting of file systems. │
|
||||
│ │ In particular, it handles the "crossing file system boundaries" condition │
|
||||
│ │ while doing "lookup" or "find" operations. │
|
||||
│ └──────────────────────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
│
|
||||
│
|
||||
Filesystems: │
|
||||
│
|
||||
▼ ┌────────────────────────────────────────────────────────────────────┐
|
||||
xxxFSInode │ Implement corresponding operations based on different file systems │
|
||||
└────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
## 1. File
|
||||
  File结构体是VFS中最基本的抽象，它代表了一个打开的文件。每当进程打开了一个文件，就会创建一个File结构体，用于维护该文件的状态信息。
|
||||
|
||||
## 2. Traits
|
||||
|
||||
  对于每个具体文件系统，都需要实现以下的trait：
|
||||
|
||||
- FileSystem：表明某个struct是一个文件系统
|
||||
- IndexNode： 表明某个struct是一个索引节点
|
||||
|
||||
  一般情况下，FileSystem和IndexNode是一对一的关系，也就是，一个文件系统对应一种IndexNode。但是，对于某些特殊的文件系统，比如DevFS，根据不同的设备类型，会有不同的IndexNode，因此，FileSystem和IndexNode是一对多的关系。
|
||||
|
||||
## 3. MountFS
|
||||
|
||||
  挂载文件系统虽然实现了FileSystem和IndexNode这两个trait，但它并不是一个“文件系统”，而是一种机制，用于将不同的文件系统挂载到同一个文件系统树上.
|
||||
所有的文件系统要挂载到文件系统树上，都需要通过MountFS来完成。也就是说，挂载树上的每个文件系统结构体的外面，都套了一层MountFS结构体。
|
||||
|
||||
  对于大部分的操作，MountFS都是直接转发给具体的文件系统，而不做任何处理。同时，为了支持跨文件系统的操作，比如在目录树上查找，每次lookup操作或者是find操作，都会通过MountFSInode的对应方法，判断当前inode是否为挂载点，并对挂载点进行特殊处理。如果发现操作跨越了具体文件系统的边界，MountFS就会将操作转发给下一个文件系统，并执行Inode替换。这个功能的实现，也是通过在普通的Inode结构体外面，套一层MountFSInode结构体来实现的。
|
||||
@ -4,10 +4,20 @@ VFS虚拟文件系统
|
||||
|
||||
在DragonOS中，VFS作为适配器，遮住了具体文件系统之间的差异，对外提供统一的文件操作接口抽象。
|
||||
|
||||
VFS是DragonOS文件系统的核心，它提供了一套统一的文件系统接口，使得DragonOS可以支持多种不同的文件系统。VFS的主要功能包括：
|
||||
|
||||
- 提供统一的文件系统接口
|
||||
- 提供文件系统的挂载和卸载机制（MountFS）
|
||||
- 提供文件抽象（File）
|
||||
- 提供文件系统的抽象（FileSystem）
|
||||
- 提供IndexNode抽象
|
||||
- 提供文件系统的缓存、同步机制（尚未实现）
|
||||
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: 目录
|
||||
|
||||
overview
|
||||
design
|
||||
api
|
||||
|
||||
|
||||
@ -1,11 +0,0 @@
|
||||
# DragonOS虚拟文件系统概述
|
||||
|
||||
## 简介
|
||||
|
||||
  DragonOS的虚拟文件系统是内核中的一层适配器，为用户程序（或者是系统程序）提供了通用的文件系统接口。同时对内核中的不同文件系统提供了统一的抽象。各种具体的文件系统可以挂载到VFS的框架之中。
|
||||
|
||||
  与VFS相关的系统调用有open(), read(), write(), create()等。
|
||||
|
||||
## **TODO**
|
||||
|
||||
  VFS的设计与实现讲解
|
||||
Reference in New Issue
Block a user