xref: /DragonOS/kernel/src/filesystem/vfs/core.rs (revision 676b8ef62e1a0a1e52d65b40c53c1636a2954040)
1004e86ffSlogin use core::{
2004e86ffSlogin     hint::spin_loop,
3004e86ffSlogin     ptr::null_mut,
4004e86ffSlogin     sync::atomic::{AtomicUsize, Ordering},
5004e86ffSlogin };
6004e86ffSlogin 
7004e86ffSlogin use alloc::{boxed::Box, format, string::ToString, sync::Arc};
8004e86ffSlogin 
9004e86ffSlogin use crate::{
10004e86ffSlogin     arch::asm::current::current_pcb,
11004e86ffSlogin     driver::disk::ahci::{self},
12004e86ffSlogin     filesystem::{
13004e86ffSlogin         devfs::DevFS,
14004e86ffSlogin         fat::fs::FATFileSystem,
15004e86ffSlogin         procfs::ProcFS,
16004e86ffSlogin         ramfs::RamFS,
17004e86ffSlogin         vfs::{file::File, mount::MountFS, FileSystem, FileType},
18004e86ffSlogin     },
19*676b8ef6SMork     include::bindings::bindings::{PAGE_4K_SIZE},
20004e86ffSlogin     io::SeekFrom,
21*676b8ef6SMork     kerror, kinfo, syscall::SystemError,
22004e86ffSlogin };
23004e86ffSlogin 
24004e86ffSlogin use super::{file::FileMode, utils::rsplit_path, IndexNode, InodeId};
25004e86ffSlogin 
26004e86ffSlogin /// @brief 原子地生成新的Inode号。
27004e86ffSlogin /// 请注意,所有的inode号都需要通过该函数来生成.全局的inode号,除了以下两个特殊的以外,都是唯一的
28004e86ffSlogin /// 特殊的两个inode号:
29004e86ffSlogin /// [0]: 对应'.'目录项
30004e86ffSlogin /// [1]: 对应'..'目录项
31004e86ffSlogin pub fn generate_inode_id() -> InodeId {
32004e86ffSlogin     static INO: AtomicUsize = AtomicUsize::new(1);
33004e86ffSlogin     return INO.fetch_add(1, Ordering::SeqCst);
34004e86ffSlogin }
35004e86ffSlogin 
36004e86ffSlogin static mut __ROOT_INODE: *mut Arc<dyn IndexNode> = null_mut();
37004e86ffSlogin 
38004e86ffSlogin /// @brief 获取全局的根节点
39004e86ffSlogin #[inline(always)]
40004e86ffSlogin #[allow(non_snake_case)]
41004e86ffSlogin pub fn ROOT_INODE() -> Arc<dyn IndexNode> {
42004e86ffSlogin     unsafe {
43004e86ffSlogin         return __ROOT_INODE.as_ref().unwrap().clone();
44004e86ffSlogin     }
45004e86ffSlogin }
46004e86ffSlogin 
47004e86ffSlogin #[no_mangle]
48004e86ffSlogin pub extern "C" fn vfs_init() -> i32 {
49004e86ffSlogin     // 使用Ramfs作为默认的根文件系统
50004e86ffSlogin     let ramfs = RamFS::new();
51004e86ffSlogin     let mount_fs = MountFS::new(ramfs, None);
52004e86ffSlogin     let root_inode = Box::leak(Box::new(mount_fs.root_inode()));
53004e86ffSlogin 
54004e86ffSlogin     unsafe {
55004e86ffSlogin         __ROOT_INODE = root_inode;
56004e86ffSlogin     }
57004e86ffSlogin 
58004e86ffSlogin     // 创建文件夹
59004e86ffSlogin     root_inode
60004e86ffSlogin         .create("proc", FileType::Dir, 0o777)
61004e86ffSlogin         .expect("Failed to create /proc");
62004e86ffSlogin     root_inode
63004e86ffSlogin         .create("dev", FileType::Dir, 0o777)
64004e86ffSlogin         .expect("Failed to create /dev");
65004e86ffSlogin 
66004e86ffSlogin     // // 创建procfs实例
67004e86ffSlogin     let procfs: Arc<ProcFS> = ProcFS::new();
68004e86ffSlogin 
69004e86ffSlogin     // procfs挂载
70004e86ffSlogin     let _t = root_inode
71004e86ffSlogin         .find("proc")
72004e86ffSlogin         .expect("Cannot find /proc")
73004e86ffSlogin         .mount(procfs)
74004e86ffSlogin         .expect("Failed to mount procfs.");
75004e86ffSlogin     kinfo!("ProcFS mounted.");
76004e86ffSlogin 
77004e86ffSlogin     // 创建 devfs 实例
78004e86ffSlogin     let devfs: Arc<DevFS> = DevFS::new();
79004e86ffSlogin     // devfs 挂载
80004e86ffSlogin     let _t = root_inode
81004e86ffSlogin         .find("dev")
82004e86ffSlogin         .expect("Cannot find /dev")
83004e86ffSlogin         .mount(devfs)
84004e86ffSlogin         .expect("Failed to mount devfs");
85004e86ffSlogin     kinfo!("DevFS mounted.");
86004e86ffSlogin 
87004e86ffSlogin     let root_inode = ROOT_INODE().list().expect("VFS init failed");
88004e86ffSlogin     if root_inode.len() > 0 {
89004e86ffSlogin         kinfo!("Successfully initialized VFS!");
90004e86ffSlogin     }
91004e86ffSlogin     return 0;
92004e86ffSlogin }
93004e86ffSlogin 
94004e86ffSlogin /// @brief 真正执行伪文件系统迁移的过程
95004e86ffSlogin ///
96004e86ffSlogin /// @param mountpoint_name 在根目录下的挂载点的名称
97004e86ffSlogin /// @param inode 原本的挂载点的inode
98004e86ffSlogin fn do_migrate(
99004e86ffSlogin     new_root_inode: Arc<dyn IndexNode>,
100004e86ffSlogin     mountpoint_name: &str,
101004e86ffSlogin     fs: &MountFS,
102*676b8ef6SMork ) -> Result<(), SystemError> {
103004e86ffSlogin     let r = new_root_inode.find(mountpoint_name);
104004e86ffSlogin     let mountpoint = if r.is_err() {
105004e86ffSlogin         new_root_inode
106004e86ffSlogin             .create(mountpoint_name, FileType::Dir, 0o777)
107004e86ffSlogin             .expect(format!("Failed to create '/{mountpoint_name}'").as_str())
108004e86ffSlogin     } else {
109004e86ffSlogin         r.unwrap()
110004e86ffSlogin     };
111004e86ffSlogin     // 迁移挂载点
112004e86ffSlogin     mountpoint
113004e86ffSlogin         .mount(fs.inner_filesystem())
114004e86ffSlogin         .expect(format!("Failed to migrate {mountpoint_name}").as_str());
115004e86ffSlogin     return Ok(());
116004e86ffSlogin }
117004e86ffSlogin 
118004e86ffSlogin /// @brief 迁移伪文件系统的inode
119004e86ffSlogin /// 请注意,为了避免删掉了伪文件系统内的信息,因此没有在原root inode那里调用unlink.
120*676b8ef6SMork fn migrate_virtual_filesystem(new_fs: Arc<dyn FileSystem>) -> Result<(), SystemError> {
121004e86ffSlogin     kinfo!("VFS: Migrating filesystems...");
122004e86ffSlogin 
123004e86ffSlogin     // ==== 在这里获取要被迁移的文件系统的inode ===
124004e86ffSlogin     let binding = ROOT_INODE().find("proc").expect("ProcFS not mounted!").fs();
125004e86ffSlogin     let proc: &MountFS = binding.as_any_ref().downcast_ref::<MountFS>().unwrap();
126004e86ffSlogin     let binding = ROOT_INODE().find("dev").expect("DevFS not mounted!").fs();
127004e86ffSlogin     let dev: &MountFS = binding.as_any_ref().downcast_ref::<MountFS>().unwrap();
128004e86ffSlogin 
129004e86ffSlogin     let new_fs = MountFS::new(new_fs, None);
130004e86ffSlogin     // 获取新的根文件系统的根节点的引用
131004e86ffSlogin     let new_root_inode = Box::leak(Box::new(new_fs.root_inode()));
132004e86ffSlogin 
133004e86ffSlogin     // 把上述文件系统,迁移到新的文件系统下
134004e86ffSlogin     do_migrate(new_root_inode.clone(), "proc", proc)?;
135004e86ffSlogin     do_migrate(new_root_inode.clone(), "dev", dev)?;
136004e86ffSlogin 
137004e86ffSlogin     unsafe {
138004e86ffSlogin         // drop旧的Root inode
139004e86ffSlogin         let old_root_inode: Box<Arc<dyn IndexNode>> = Box::from_raw(__ROOT_INODE);
140004e86ffSlogin         __ROOT_INODE = null_mut();
141004e86ffSlogin         drop(old_root_inode);
142004e86ffSlogin 
143004e86ffSlogin         // 设置全局的新的ROOT Inode
144004e86ffSlogin         __ROOT_INODE = new_root_inode;
145004e86ffSlogin     }
146004e86ffSlogin 
147004e86ffSlogin     kinfo!("VFS: Migrate filesystems done!");
148004e86ffSlogin 
149004e86ffSlogin     return Ok(());
150004e86ffSlogin }
151004e86ffSlogin 
152004e86ffSlogin #[no_mangle]
153004e86ffSlogin pub extern "C" fn mount_root_fs() -> i32 {
154004e86ffSlogin     kinfo!("Try to mount FAT32 as root fs...");
155004e86ffSlogin     let partiton: Arc<crate::io::disk_info::Partition> =
156004e86ffSlogin         ahci::get_disks_by_name("ahci_disk_0".to_string())
157004e86ffSlogin             .unwrap()
158004e86ffSlogin             .0
159004e86ffSlogin             .lock()
160004e86ffSlogin             .partitions[0]
161004e86ffSlogin             .clone();
162004e86ffSlogin 
163*676b8ef6SMork     let fatfs: Result<Arc<FATFileSystem>, SystemError> = FATFileSystem::new(partiton);
164004e86ffSlogin     if fatfs.is_err() {
165004e86ffSlogin         kerror!(
166004e86ffSlogin             "Failed to initialize fatfs, code={:?}",
167004e86ffSlogin             fatfs.as_ref().err()
168004e86ffSlogin         );
169004e86ffSlogin         loop {
170004e86ffSlogin             spin_loop();
171004e86ffSlogin         }
172004e86ffSlogin     }
173004e86ffSlogin     let fatfs: Arc<FATFileSystem> = fatfs.unwrap();
174004e86ffSlogin     let r = migrate_virtual_filesystem(fatfs);
175004e86ffSlogin     if r.is_err() {
176004e86ffSlogin         kerror!("Failed to migrate virtual filesystem to FAT32!");
177004e86ffSlogin         loop {
178004e86ffSlogin             spin_loop();
179004e86ffSlogin         }
180004e86ffSlogin     }
181004e86ffSlogin     kinfo!("Successfully migrate rootfs to FAT32!");
182004e86ffSlogin 
183004e86ffSlogin     return 0;
184004e86ffSlogin }
185004e86ffSlogin 
186004e86ffSlogin /// @brief 为当前进程打开一个文件
187*676b8ef6SMork pub fn do_open(path: &str, mode: FileMode) -> Result<i32, SystemError> {
188004e86ffSlogin     // 文件名过长
189004e86ffSlogin     if path.len() > PAGE_4K_SIZE as usize {
190*676b8ef6SMork         return Err(SystemError::ENAMETOOLONG);
191004e86ffSlogin     }
192004e86ffSlogin 
193*676b8ef6SMork     let inode: Result<Arc<dyn IndexNode>, SystemError> = ROOT_INODE().lookup(path);
194004e86ffSlogin 
195004e86ffSlogin     let inode: Arc<dyn IndexNode> = if inode.is_err() {
196004e86ffSlogin         let errno = inode.unwrap_err();
197004e86ffSlogin         // 文件不存在,且需要创建
198004e86ffSlogin         if mode.contains(FileMode::O_CREAT)
199004e86ffSlogin             && !mode.contains(FileMode::O_DIRECTORY)
200*676b8ef6SMork             && errno == SystemError::ENOENT
201004e86ffSlogin         {
202004e86ffSlogin             let (filename, parent_path) = rsplit_path(path);
203004e86ffSlogin             // 查找父目录
204004e86ffSlogin             let parent_inode: Arc<dyn IndexNode> =
205004e86ffSlogin                 ROOT_INODE().lookup(parent_path.unwrap_or("/"))?;
206004e86ffSlogin             // 创建文件
207004e86ffSlogin             let inode: Arc<dyn IndexNode> = parent_inode.create(filename, FileType::File, 0o777)?;
208004e86ffSlogin             inode
209004e86ffSlogin         } else {
210004e86ffSlogin             // 不需要创建文件,因此返回错误码
211004e86ffSlogin             return Err(errno);
212004e86ffSlogin         }
213004e86ffSlogin     } else {
214004e86ffSlogin         inode.unwrap()
215004e86ffSlogin     };
216004e86ffSlogin 
217004e86ffSlogin     let file_type: FileType = inode.metadata()?.file_type;
218004e86ffSlogin     // 如果要打开的是文件夹,而目标不是文件夹
219004e86ffSlogin     if mode.contains(FileMode::O_DIRECTORY) && file_type != FileType::Dir {
220*676b8ef6SMork         return Err(SystemError::ENOTDIR);
221004e86ffSlogin     }
222004e86ffSlogin 
223004e86ffSlogin     // 如果O_TRUNC,并且,打开模式包含O_RDWR或O_WRONLY,清空文件
224004e86ffSlogin     if mode.contains(FileMode::O_TRUNC)
225004e86ffSlogin         && (mode.contains(FileMode::O_RDWR) || mode.contains(FileMode::O_WRONLY))
226004e86ffSlogin         && file_type == FileType::File
227004e86ffSlogin     {
228004e86ffSlogin         inode.truncate(0)?;
229004e86ffSlogin     }
230004e86ffSlogin 
231004e86ffSlogin     // 创建文件对象
232004e86ffSlogin     let mut file: File = File::new(inode, mode)?;
233004e86ffSlogin 
234004e86ffSlogin     // 打开模式为“追加”
235004e86ffSlogin     if mode.contains(FileMode::O_APPEND) {
236004e86ffSlogin         file.lseek(SeekFrom::SeekEnd(0))?;
237004e86ffSlogin     }
238004e86ffSlogin 
239004e86ffSlogin     // 把文件对象存入pcb
240004e86ffSlogin     return current_pcb().alloc_fd(file);
241004e86ffSlogin }
242004e86ffSlogin 
243004e86ffSlogin /// @brief 根据文件描述符,读取文件数据。尝试读取的数据长度与buf的长度相同。
244004e86ffSlogin ///
245004e86ffSlogin /// @param fd 文件描述符编号
246004e86ffSlogin /// @param buf 输出缓冲区。
247004e86ffSlogin ///
248004e86ffSlogin /// @return Ok(usize) 成功读取的数据的字节数
249*676b8ef6SMork /// @return Err(SystemError) 读取失败,返回posix错误码
250*676b8ef6SMork pub fn do_read(fd: i32, buf: &mut [u8]) -> Result<usize, SystemError> {
251004e86ffSlogin     let file: Option<&mut File> = current_pcb().get_file_mut_by_fd(fd);
252004e86ffSlogin     if file.is_none() {
253*676b8ef6SMork         return Err(SystemError::EBADF);
254004e86ffSlogin     }
255004e86ffSlogin     let file: &mut File = file.unwrap();
256004e86ffSlogin 
257004e86ffSlogin     return file.read(buf.len(), buf);
258004e86ffSlogin }
259004e86ffSlogin 
260004e86ffSlogin /// @brief 根据文件描述符,向文件写入数据。尝试写入的数据长度与buf的长度相同。
261004e86ffSlogin ///
262004e86ffSlogin /// @param fd 文件描述符编号
263004e86ffSlogin /// @param buf 输入缓冲区。
264004e86ffSlogin ///
265004e86ffSlogin /// @return Ok(usize) 成功写入的数据的字节数
266*676b8ef6SMork /// @return Err(SystemError) 写入失败,返回posix错误码
267*676b8ef6SMork pub fn do_write(fd: i32, buf: &[u8]) -> Result<usize, SystemError> {
268004e86ffSlogin     let file: Option<&mut File> = current_pcb().get_file_mut_by_fd(fd);
269004e86ffSlogin     if file.is_none() {
270*676b8ef6SMork         return Err(SystemError::EBADF);
271004e86ffSlogin     }
272004e86ffSlogin     let file: &mut File = file.unwrap();
273004e86ffSlogin 
274004e86ffSlogin     return file.write(buf.len(), buf);
275004e86ffSlogin }
276004e86ffSlogin 
277004e86ffSlogin /// @brief 调整文件操作指针的位置
278004e86ffSlogin ///
279004e86ffSlogin /// @param fd 文件描述符编号
280004e86ffSlogin /// @param seek 调整的方式
281004e86ffSlogin ///
282004e86ffSlogin /// @return Ok(usize) 调整后,文件访问指针相对于文件头部的偏移量
283*676b8ef6SMork /// @return Err(SystemError) 调整失败,返回posix错误码
284*676b8ef6SMork pub fn do_lseek(fd: i32, seek: SeekFrom) -> Result<usize, SystemError> {
285004e86ffSlogin     let file: Option<&mut File> = current_pcb().get_file_mut_by_fd(fd);
286004e86ffSlogin     if file.is_none() {
287*676b8ef6SMork         return Err(SystemError::EBADF);
288004e86ffSlogin     }
289004e86ffSlogin     let file: &mut File = file.unwrap();
290004e86ffSlogin     return file.lseek(seek);
291004e86ffSlogin }
292004e86ffSlogin 
293004e86ffSlogin /// @brief 创建文件/文件夹
294*676b8ef6SMork pub fn do_mkdir(path: &str, _mode: FileMode) -> Result<u64, SystemError> {
295004e86ffSlogin     // 文件名过长
296004e86ffSlogin     if path.len() > PAGE_4K_SIZE as usize {
297*676b8ef6SMork         return Err(SystemError::ENAMETOOLONG);
298004e86ffSlogin     }
299004e86ffSlogin 
300*676b8ef6SMork     let inode: Result<Arc<dyn IndexNode>, SystemError> = ROOT_INODE().lookup(path);
301004e86ffSlogin 
302004e86ffSlogin     if inode.is_err() {
303004e86ffSlogin         let errno = inode.unwrap_err();
304004e86ffSlogin         // 文件不存在,且需要创建
305*676b8ef6SMork         if errno == SystemError::ENOENT {
306004e86ffSlogin             let (filename, parent_path) = rsplit_path(path);
307004e86ffSlogin             // 查找父目录
308004e86ffSlogin             let parent_inode: Arc<dyn IndexNode> =
309004e86ffSlogin                 ROOT_INODE().lookup(parent_path.unwrap_or("/"))?;
310004e86ffSlogin             // 创建文件夹
311004e86ffSlogin             let _create_inode: Arc<dyn IndexNode> =
312004e86ffSlogin                 parent_inode.create(filename, FileType::Dir, 0o777)?;
313004e86ffSlogin         } else {
314004e86ffSlogin             // 不需要创建文件,因此返回错误码
315004e86ffSlogin             return Err(errno);
316004e86ffSlogin         }
317004e86ffSlogin     }
318004e86ffSlogin 
319004e86ffSlogin     return Ok(0);
320004e86ffSlogin }
321004e86ffSlogin 
322004e86ffSlogin /// @breif 删除文件夹
323*676b8ef6SMork pub fn do_remove_dir(path: &str) -> Result<u64, SystemError> {
324004e86ffSlogin     // 文件名过长
325004e86ffSlogin     if path.len() > PAGE_4K_SIZE as usize {
326*676b8ef6SMork         return Err(SystemError::ENAMETOOLONG);
327004e86ffSlogin     }
328004e86ffSlogin 
329*676b8ef6SMork     let inode: Result<Arc<dyn IndexNode>, SystemError> = ROOT_INODE().lookup(path);
330004e86ffSlogin 
331004e86ffSlogin     if inode.is_err() {
332004e86ffSlogin         let errno = inode.unwrap_err();
333004e86ffSlogin         // 文件不存在
334*676b8ef6SMork         if errno == SystemError::ENOENT {
335*676b8ef6SMork             return Err(SystemError::ENOENT);
336004e86ffSlogin         }
337004e86ffSlogin     }
338004e86ffSlogin 
339004e86ffSlogin     let (filename, parent_path) = rsplit_path(path);
340004e86ffSlogin     // 查找父目录
341004e86ffSlogin     let parent_inode: Arc<dyn IndexNode> = ROOT_INODE().lookup(parent_path.unwrap_or("/"))?;
342004e86ffSlogin 
343004e86ffSlogin     if parent_inode.metadata()?.file_type != FileType::Dir {
344*676b8ef6SMork         return Err(SystemError::ENOTDIR);
345004e86ffSlogin     }
346004e86ffSlogin 
347004e86ffSlogin     let target_inode: Arc<dyn IndexNode> = parent_inode.find(filename)?;
348004e86ffSlogin     if target_inode.metadata()?.file_type != FileType::Dir {
349*676b8ef6SMork         return Err(SystemError::ENOTDIR);
350004e86ffSlogin     }
351004e86ffSlogin 
352004e86ffSlogin     // 删除文件夹
353004e86ffSlogin     parent_inode.rmdir(filename)?;
354004e86ffSlogin 
355004e86ffSlogin     return Ok(0);
356004e86ffSlogin }
357004e86ffSlogin 
358004e86ffSlogin /// @brief 删除文件
359*676b8ef6SMork pub fn do_unlink_at(path: &str, _mode: FileMode) -> Result<u64, SystemError> {
360004e86ffSlogin     // 文件名过长
361004e86ffSlogin     if path.len() > PAGE_4K_SIZE as usize {
362*676b8ef6SMork         return Err(SystemError::ENAMETOOLONG);
363004e86ffSlogin     }
364004e86ffSlogin 
365*676b8ef6SMork     let inode: Result<Arc<dyn IndexNode>, SystemError> = ROOT_INODE().lookup(path);
366004e86ffSlogin 
367004e86ffSlogin     if inode.is_err() {
368004e86ffSlogin         let errno = inode.clone().unwrap_err();
369004e86ffSlogin         // 文件不存在,且需要创建
370*676b8ef6SMork         if errno == SystemError::ENOENT {
371*676b8ef6SMork             return Err(SystemError::ENOENT);
372004e86ffSlogin         }
373004e86ffSlogin     }
374004e86ffSlogin     // 禁止在目录上unlink
375004e86ffSlogin     if inode.unwrap().metadata()?.file_type == FileType::Dir {
376*676b8ef6SMork         return Err(SystemError::EPERM);
377004e86ffSlogin     }
378004e86ffSlogin 
379004e86ffSlogin     let (filename, parent_path) = rsplit_path(path);
380004e86ffSlogin     // 查找父目录
381004e86ffSlogin     let parent_inode: Arc<dyn IndexNode> = ROOT_INODE().lookup(parent_path.unwrap_or("/"))?;
382004e86ffSlogin 
383004e86ffSlogin     if parent_inode.metadata()?.file_type != FileType::Dir {
384*676b8ef6SMork         return Err(SystemError::ENOTDIR);
385004e86ffSlogin     }
386004e86ffSlogin 
387004e86ffSlogin     // 删除文件
388004e86ffSlogin     parent_inode.unlink(filename)?;
389004e86ffSlogin 
390004e86ffSlogin     return Ok(0);
391004e86ffSlogin }
392