1004e86ffSlogin #![allow(dead_code)] 206b09f34Skong 3004e86ffSlogin pub mod core; 4004e86ffSlogin pub mod file; 5004e86ffSlogin pub mod mount; 6004e86ffSlogin mod syscall; 7004e86ffSlogin mod utils; 8004e86ffSlogin 9004e86ffSlogin use ::core::{any::Any, fmt::Debug}; 10004e86ffSlogin 11004e86ffSlogin use alloc::{string::String, sync::Arc, vec::Vec}; 12004e86ffSlogin 13004e86ffSlogin use crate::{ 14004e86ffSlogin time::TimeSpec, 15676b8ef6SMork syscall::SystemError, 16004e86ffSlogin }; 17004e86ffSlogin 18*20e3152eSlogin use self::{core::generate_inode_id, file::FileMode}; 19004e86ffSlogin pub use self::{core::ROOT_INODE, file::FilePrivateData, mount::MountFS}; 20004e86ffSlogin 21004e86ffSlogin /// vfs容许的最大的路径名称长度 22004e86ffSlogin pub const MAX_PATHLEN: u32 = 1024; 23004e86ffSlogin 24004e86ffSlogin /// 定义inode号的类型为usize 25004e86ffSlogin pub type InodeId = usize; 26004e86ffSlogin 27004e86ffSlogin /// 文件的类型 28004e86ffSlogin #[derive(Debug, Clone, Copy, PartialEq, Eq)] 29004e86ffSlogin pub enum FileType { 30004e86ffSlogin /// 文件 31004e86ffSlogin File, 32004e86ffSlogin /// 文件夹 33004e86ffSlogin Dir, 34004e86ffSlogin /// 块设备 35004e86ffSlogin BlockDevice, 36004e86ffSlogin /// 字符设备 37004e86ffSlogin CharDevice, 38004e86ffSlogin /// 管道文件 39004e86ffSlogin Pipe, 40004e86ffSlogin /// 符号链接 41004e86ffSlogin SymLink, 42004e86ffSlogin } 43004e86ffSlogin 44004e86ffSlogin /* these are defined by POSIX and also present in glibc's dirent.h */ 45004e86ffSlogin /// 完整含义请见 http://www.gnu.org/software/libc/manual/html_node/Directory-Entries.html 46004e86ffSlogin pub const DT_UNKNOWN: u16 = 0; 47004e86ffSlogin /// 命名管道,或者FIFO 48004e86ffSlogin pub const DT_FIFO: u16 = 1; 49004e86ffSlogin // 字符设备 50004e86ffSlogin pub const DT_CHR: u16 = 2; 51004e86ffSlogin // 目录 52004e86ffSlogin pub const DT_DIR: u16 = 4; 53004e86ffSlogin // 块设备 54004e86ffSlogin pub const DT_BLK: u16 = 6; 55004e86ffSlogin // 常规文件 56004e86ffSlogin pub const DT_REG: u16 = 8; 57004e86ffSlogin // 符号链接 58004e86ffSlogin pub const DT_LNK: u16 = 10; 59004e86ffSlogin // 是一个socket 60004e86ffSlogin pub const DT_SOCK: u16 = 12; 61004e86ffSlogin // 这个是抄Linux的,还不知道含义 62004e86ffSlogin pub const DT_WHT: u16 = 14; 63004e86ffSlogin pub const DT_MAX: u16 = 16; 64004e86ffSlogin 65004e86ffSlogin impl FileType { 66004e86ffSlogin pub fn get_file_type_num(&self) -> u16 { 67004e86ffSlogin return match self { 68004e86ffSlogin FileType::File => DT_REG, 69004e86ffSlogin FileType::Dir => DT_DIR, 70004e86ffSlogin FileType::BlockDevice => DT_BLK, 71004e86ffSlogin FileType::CharDevice => DT_CHR, 72004e86ffSlogin FileType::Pipe => DT_FIFO, 73004e86ffSlogin FileType::SymLink => DT_LNK, 74004e86ffSlogin }; 75004e86ffSlogin } 76004e86ffSlogin } 77004e86ffSlogin 78004e86ffSlogin /// @brief inode的状态(由poll方法返回) 79004e86ffSlogin #[derive(Debug, Default, PartialEq)] 80004e86ffSlogin pub struct PollStatus { 81004e86ffSlogin pub flags: u8, 82004e86ffSlogin } 83004e86ffSlogin 84004e86ffSlogin impl PollStatus { 85004e86ffSlogin pub const WRITE_MASK: u8 = (1u8 << 0); 86004e86ffSlogin pub const READ_MASK: u8 = (1u8 << 1); 87004e86ffSlogin pub const ERR_MASK: u8 = (1u8 << 2); 88004e86ffSlogin } 89004e86ffSlogin 90004e86ffSlogin pub trait IndexNode: Any + Sync + Send + Debug { 91004e86ffSlogin /// @brief 打开文件 92004e86ffSlogin /// 93004e86ffSlogin /// @return 成功:Ok() 94004e86ffSlogin /// 失败:Err(错误码) 95676b8ef6SMork fn open(&self, _data: &mut FilePrivateData, _mode: &FileMode) -> Result<(), SystemError> { 96004e86ffSlogin // 若文件系统没有实现此方法,则返回“不支持” 97676b8ef6SMork return Err(SystemError::ENOTSUP); 98004e86ffSlogin } 99004e86ffSlogin 100004e86ffSlogin /// @brief 关闭文件 101004e86ffSlogin /// 102004e86ffSlogin /// @return 成功:Ok() 103004e86ffSlogin /// 失败:Err(错误码) 104676b8ef6SMork fn close(&self, _data: &mut FilePrivateData) -> Result<(), SystemError> { 105004e86ffSlogin // 若文件系统没有实现此方法,则返回“不支持” 106676b8ef6SMork return Err(SystemError::ENOTSUP); 107004e86ffSlogin } 108004e86ffSlogin 109004e86ffSlogin /// @brief 在inode的指定偏移量开始,读取指定大小的数据 110004e86ffSlogin /// 111004e86ffSlogin /// @param offset 起始位置在Inode中的偏移量 112004e86ffSlogin /// @param len 要读取的字节数 113004e86ffSlogin /// @param buf 缓冲区. 请注意,必须满足@buf.len()>=@len 114004e86ffSlogin /// @param _data 各文件系统系统所需私有信息 115004e86ffSlogin /// 116004e86ffSlogin /// @return 成功:Ok(读取的字节数) 117004e86ffSlogin /// 失败:Err(Posix错误码) 118004e86ffSlogin fn read_at( 119004e86ffSlogin &self, 120004e86ffSlogin offset: usize, 121004e86ffSlogin len: usize, 122004e86ffSlogin buf: &mut [u8], 123004e86ffSlogin _data: &mut FilePrivateData, 124676b8ef6SMork ) -> Result<usize, SystemError>; 125004e86ffSlogin 126004e86ffSlogin /// @brief 在inode的指定偏移量开始,写入指定大小的数据(从buf的第0byte开始写入) 127004e86ffSlogin /// 128004e86ffSlogin /// @param offset 起始位置在Inode中的偏移量 129004e86ffSlogin /// @param len 要写入的字节数 130004e86ffSlogin /// @param buf 缓冲区. 请注意,必须满足@buf.len()>=@len 131004e86ffSlogin /// @param _data 各文件系统系统所需私有信息 132004e86ffSlogin /// 133004e86ffSlogin /// @return 成功:Ok(写入的字节数) 134004e86ffSlogin /// 失败:Err(Posix错误码) 135004e86ffSlogin fn write_at( 136004e86ffSlogin &self, 137004e86ffSlogin offset: usize, 138004e86ffSlogin len: usize, 139004e86ffSlogin buf: &[u8], 140004e86ffSlogin _data: &mut FilePrivateData, 141676b8ef6SMork ) -> Result<usize, SystemError>; 142004e86ffSlogin 143004e86ffSlogin /// @brief 获取当前inode的状态。 144004e86ffSlogin /// 145004e86ffSlogin /// @return PollStatus结构体 146676b8ef6SMork fn poll(&self) -> Result<PollStatus, SystemError>; 147004e86ffSlogin 148004e86ffSlogin /// @brief 获取inode的元数据 149004e86ffSlogin /// 150004e86ffSlogin /// @return 成功:Ok(inode的元数据) 151004e86ffSlogin /// 失败:Err(错误码) 152676b8ef6SMork fn metadata(&self) -> Result<Metadata, SystemError> { 153004e86ffSlogin // 若文件系统没有实现此方法,则返回“不支持” 154676b8ef6SMork return Err(SystemError::ENOTSUP); 155004e86ffSlogin } 156004e86ffSlogin 157004e86ffSlogin /// @brief 设置inode的元数据 158004e86ffSlogin /// 159004e86ffSlogin /// @return 成功:Ok() 160004e86ffSlogin /// 失败:Err(错误码) 161676b8ef6SMork fn set_metadata(&self, _metadata: &Metadata) -> Result<(), SystemError> { 162004e86ffSlogin // 若文件系统没有实现此方法,则返回“不支持” 163676b8ef6SMork return Err(SystemError::ENOTSUP); 164004e86ffSlogin } 165004e86ffSlogin 166004e86ffSlogin /// @brief 重新设置文件的大小 167004e86ffSlogin /// 168004e86ffSlogin /// @return 成功:Ok() 169004e86ffSlogin /// 失败:Err(错误码) 170676b8ef6SMork fn resize(&self, _len: usize) -> Result<(), SystemError> { 171004e86ffSlogin // 若文件系统没有实现此方法,则返回“不支持” 172676b8ef6SMork return Err(SystemError::ENOTSUP); 173004e86ffSlogin } 174004e86ffSlogin 175004e86ffSlogin /// @brief 在当前目录下创建一个新的inode 176004e86ffSlogin /// 177004e86ffSlogin /// @param name 目录项的名字 178004e86ffSlogin /// @param file_type 文件类型 179004e86ffSlogin /// @param mode 权限 180004e86ffSlogin /// 181004e86ffSlogin /// @return 创建成功:返回Ok(新的inode的Arc指针) 182004e86ffSlogin /// @return 创建失败:返回Err(错误码) 183004e86ffSlogin fn create( 184004e86ffSlogin &self, 185004e86ffSlogin name: &str, 186004e86ffSlogin file_type: FileType, 187004e86ffSlogin mode: u32, 188676b8ef6SMork ) -> Result<Arc<dyn IndexNode>, SystemError> { 189004e86ffSlogin // 若文件系统没有实现此方法,则默认调用其create_with_data方法。如果仍未实现,则会得到一个Err(-ENOTSUP)的返回值 190004e86ffSlogin return self.create_with_data(name, file_type, mode, 0); 191004e86ffSlogin } 192004e86ffSlogin 193004e86ffSlogin /// @brief 在当前目录下创建一个新的inode,并传入一个简单的data字段,方便进行初始化。 194004e86ffSlogin /// 195004e86ffSlogin /// @param name 目录项的名字 196004e86ffSlogin /// @param file_type 文件类型 197004e86ffSlogin /// @param mode 权限 198004e86ffSlogin /// @param data 用于初始化该inode的数据。(为0则表示忽略此字段)对于不同的文件系统来说,代表的含义可能不同。 199004e86ffSlogin /// 200004e86ffSlogin /// @return 创建成功:返回Ok(新的inode的Arc指针) 201004e86ffSlogin /// @return 创建失败:返回Err(错误码) 202004e86ffSlogin fn create_with_data( 203004e86ffSlogin &self, 204004e86ffSlogin _name: &str, 205004e86ffSlogin _file_type: FileType, 206004e86ffSlogin _mode: u32, 207004e86ffSlogin _data: usize, 208676b8ef6SMork ) -> Result<Arc<dyn IndexNode>, SystemError> { 209004e86ffSlogin // 若文件系统没有实现此方法,则返回“不支持” 210676b8ef6SMork return Err(SystemError::ENOTSUP); 211004e86ffSlogin } 212004e86ffSlogin 213004e86ffSlogin /// @brief 在当前目录下,创建一个名为Name的硬链接,指向另一个IndexNode 214004e86ffSlogin /// 215004e86ffSlogin /// @param name 硬链接的名称 216004e86ffSlogin /// @param other 要被指向的IndexNode的Arc指针 217004e86ffSlogin /// 218004e86ffSlogin /// @return 成功:Ok() 219004e86ffSlogin /// 失败:Err(错误码) 220676b8ef6SMork fn link(&self, _name: &str, _other: &Arc<dyn IndexNode>) -> Result<(), SystemError> { 221004e86ffSlogin // 若文件系统没有实现此方法,则返回“不支持” 222676b8ef6SMork return Err(SystemError::ENOTSUP); 223004e86ffSlogin } 224004e86ffSlogin 225004e86ffSlogin /// @brief 在当前目录下,删除一个名为Name的硬链接 226004e86ffSlogin /// 227004e86ffSlogin /// @param name 硬链接的名称 228004e86ffSlogin /// 229004e86ffSlogin /// @return 成功:Ok() 230004e86ffSlogin /// 失败:Err(错误码) 231676b8ef6SMork fn unlink(&self, _name: &str) -> Result<(), SystemError> { 232004e86ffSlogin // 若文件系统没有实现此方法,则返回“不支持” 233676b8ef6SMork return Err(SystemError::ENOTSUP); 234004e86ffSlogin } 235004e86ffSlogin 236004e86ffSlogin /// @brief 删除文件夹 237004e86ffSlogin /// 238004e86ffSlogin /// @param name 文件夹名称 239004e86ffSlogin /// 240004e86ffSlogin /// @return 成功 Ok(()) 241004e86ffSlogin /// @return 失败 Err(错误码) 242676b8ef6SMork fn rmdir(&self, _name: &str) ->Result<(), SystemError>{ 243676b8ef6SMork return Err(SystemError::ENOTSUP); 244004e86ffSlogin } 245004e86ffSlogin 246004e86ffSlogin /// @brief 将指定名称的子目录项的文件内容,移动到target这个目录下。如果_old_name所指向的inode与_target的相同,那么则直接执行重命名的操作。 247004e86ffSlogin /// 248004e86ffSlogin /// @param old_name 旧的名字 249004e86ffSlogin /// 250004e86ffSlogin /// @param target 移动到指定的inode 251004e86ffSlogin /// 252004e86ffSlogin /// @param new_name 新的文件名 253004e86ffSlogin /// 254004e86ffSlogin /// @return 成功: Ok() 255004e86ffSlogin /// 失败: Err(错误码) 256004e86ffSlogin fn move_( 257004e86ffSlogin &self, 258004e86ffSlogin _old_name: &str, 259004e86ffSlogin _target: &Arc<dyn IndexNode>, 260004e86ffSlogin _new_name: &str, 261676b8ef6SMork ) -> Result<(), SystemError> { 262004e86ffSlogin // 若文件系统没有实现此方法,则返回“不支持” 263676b8ef6SMork return Err(SystemError::ENOTSUP); 264004e86ffSlogin } 265004e86ffSlogin 266004e86ffSlogin /// @brief 寻找一个名为Name的inode 267004e86ffSlogin /// 268004e86ffSlogin /// @param name 要寻找的inode的名称 269004e86ffSlogin /// 270004e86ffSlogin /// @return 成功:Ok() 271004e86ffSlogin /// 失败:Err(错误码) 272676b8ef6SMork fn find(&self, _name: &str) -> Result<Arc<dyn IndexNode>, SystemError> { 273004e86ffSlogin // 若文件系统没有实现此方法,则返回“不支持” 274676b8ef6SMork return Err(SystemError::ENOTSUP); 275004e86ffSlogin } 276004e86ffSlogin 277004e86ffSlogin /// @brief 根据inode号,获取子目录项的名字 278004e86ffSlogin /// 279004e86ffSlogin /// @param ino inode号 280004e86ffSlogin /// 281004e86ffSlogin /// @return 成功:Ok() 282004e86ffSlogin /// 失败:Err(错误码) 283676b8ef6SMork fn get_entry_name(&self, _ino: InodeId) -> Result<String, SystemError> { 284004e86ffSlogin // 若文件系统没有实现此方法,则返回“不支持” 285676b8ef6SMork return Err(SystemError::ENOTSUP); 286004e86ffSlogin } 287004e86ffSlogin 288004e86ffSlogin /// @brief 根据inode号,获取子目录项的名字和元数据 289004e86ffSlogin /// 290004e86ffSlogin /// @param ino inode号 291004e86ffSlogin /// 292004e86ffSlogin /// @return 成功:Ok(String, Metadata) 293004e86ffSlogin /// 失败:Err(错误码) 294676b8ef6SMork fn get_entry_name_and_metadata(&self, ino: InodeId) -> Result<(String, Metadata), SystemError> { 295004e86ffSlogin // 如果有条件,请在文件系统中使用高效的方式实现本接口,而不是依赖这个低效率的默认实现。 296004e86ffSlogin let name = self.get_entry_name(ino)?; 297004e86ffSlogin let entry = self.find(&name)?; 298004e86ffSlogin return Ok((name, entry.metadata()?)); 299004e86ffSlogin } 300004e86ffSlogin 301004e86ffSlogin /// @brief io control接口 302004e86ffSlogin /// 303004e86ffSlogin /// @param cmd 命令 304004e86ffSlogin /// @param data 数据 305004e86ffSlogin /// 306004e86ffSlogin /// @return 成功:Ok() 307004e86ffSlogin /// 失败:Err(错误码) 308676b8ef6SMork fn ioctl(&self, _cmd: u32, _data: usize) -> Result<usize, SystemError> { 309004e86ffSlogin // 若文件系统没有实现此方法,则返回“不支持” 310676b8ef6SMork return Err(SystemError::ENOTSUP); 311004e86ffSlogin } 312004e86ffSlogin 313004e86ffSlogin /// @brief 获取inode所在的文件系统的指针 314004e86ffSlogin fn fs(&self) -> Arc<dyn FileSystem>; 315004e86ffSlogin 316004e86ffSlogin /// @brief 本函数用于实现动态转换。 317004e86ffSlogin /// 具体的文件系统在实现本函数时,最简单的方式就是:直接返回self 318004e86ffSlogin fn as_any_ref(&self) -> &dyn Any; 319004e86ffSlogin 320004e86ffSlogin /// @brief 列出当前inode下的所有目录项的名字 321676b8ef6SMork fn list(&self) -> Result<Vec<String>, SystemError>; 322004e86ffSlogin 323004e86ffSlogin /// @brief 在当前Inode下,挂载一个新的文件系统 324004e86ffSlogin /// 请注意!该函数只能被MountFS实现,其他文件系统不应实现这个函数 325676b8ef6SMork fn mount(&self, _fs: Arc<dyn FileSystem>) -> Result<Arc<MountFS>, SystemError> { 326676b8ef6SMork return Err(SystemError::ENOTSUP); 327004e86ffSlogin } 328004e86ffSlogin 329004e86ffSlogin /// @brief 截断当前inode到指定的长度。如果当前文件长度小于len,则不操作。 330004e86ffSlogin /// 331004e86ffSlogin /// @param len 要被截断到的目标长度 332676b8ef6SMork fn truncate(&self, _len: usize) -> Result<(), SystemError> { 333676b8ef6SMork return Err(SystemError::ENOTSUP); 334004e86ffSlogin } 335*20e3152eSlogin 336*20e3152eSlogin /// @brief 将当前inode的内容同步到具体设备上 337*20e3152eSlogin fn sync(&self) -> Result<(), SystemError> { 338*20e3152eSlogin return Ok(()); 339*20e3152eSlogin } 340004e86ffSlogin } 341004e86ffSlogin 342004e86ffSlogin impl dyn IndexNode { 343004e86ffSlogin /// @brief 将当前Inode转换为一个具体的结构体(类型由T指定) 344004e86ffSlogin /// 如果类型正确,则返回Some,否则返回None 345004e86ffSlogin pub fn downcast_ref<T: IndexNode>(&self) -> Option<&T> { 346004e86ffSlogin return self.as_any_ref().downcast_ref::<T>(); 347004e86ffSlogin } 348004e86ffSlogin 349004e86ffSlogin /// @brief 查找文件(不考虑符号链接) 350004e86ffSlogin /// 351004e86ffSlogin /// @param path 文件路径 352004e86ffSlogin /// 353004e86ffSlogin /// @return Ok(Arc<dyn IndexNode>) 要寻找的目录项的inode 354676b8ef6SMork /// @return Err(SystemError) 错误码 355676b8ef6SMork pub fn lookup(&self, path: &str) -> Result<Arc<dyn IndexNode>, SystemError> { 356004e86ffSlogin return self.lookup_follow_symlink(path, 0); 357004e86ffSlogin } 358004e86ffSlogin 359004e86ffSlogin /// @brief 查找文件(考虑符号链接) 360004e86ffSlogin /// 361004e86ffSlogin /// @param path 文件路径 362004e86ffSlogin /// @param max_follow_times 最大经过的符号链接的大小 363004e86ffSlogin /// 364004e86ffSlogin /// @return Ok(Arc<dyn IndexNode>) 要寻找的目录项的inode 365676b8ef6SMork /// @return Err(SystemError) 错误码 366004e86ffSlogin pub fn lookup_follow_symlink( 367004e86ffSlogin &self, 368004e86ffSlogin path: &str, 369004e86ffSlogin max_follow_times: usize, 370676b8ef6SMork ) -> Result<Arc<dyn IndexNode>, SystemError> { 371004e86ffSlogin if self.metadata()?.file_type != FileType::Dir { 372676b8ef6SMork return Err(SystemError::ENOTDIR); 373004e86ffSlogin } 374004e86ffSlogin 375004e86ffSlogin // 处理绝对路径 376004e86ffSlogin // result: 上一个被找到的inode 377004e86ffSlogin // rest_path: 还没有查找的路径 378004e86ffSlogin let (mut result, mut rest_path) = if let Some(rest) = path.strip_prefix('/') { 379004e86ffSlogin (ROOT_INODE().clone(), String::from(rest)) 380004e86ffSlogin } else { 381004e86ffSlogin // 是相对路径 382004e86ffSlogin (self.find(".")?, String::from(path)) 383004e86ffSlogin }; 384004e86ffSlogin 385004e86ffSlogin // 逐级查找文件 386004e86ffSlogin while !rest_path.is_empty() { 387004e86ffSlogin // 当前这一级不是文件夹 388004e86ffSlogin if result.metadata()?.file_type != FileType::Dir { 389676b8ef6SMork return Err(SystemError::ENOTDIR); 390004e86ffSlogin } 391004e86ffSlogin 392004e86ffSlogin let name; 393004e86ffSlogin 394004e86ffSlogin // 寻找“/” 395004e86ffSlogin match rest_path.find('/') { 396004e86ffSlogin Some(pos) => { 397004e86ffSlogin // 找到了,设置下一个要查找的名字 398004e86ffSlogin name = String::from(&rest_path[0..pos]); 399004e86ffSlogin // 剩余的路径字符串 400004e86ffSlogin rest_path = String::from(&rest_path[pos + 1..]); 401004e86ffSlogin } 402004e86ffSlogin None => { 403004e86ffSlogin name = rest_path; 404004e86ffSlogin rest_path = String::new(); 405004e86ffSlogin } 406004e86ffSlogin } 407004e86ffSlogin 408004e86ffSlogin // 遇到连续多个"/"的情况 409004e86ffSlogin if name.is_empty() { 410004e86ffSlogin continue; 411004e86ffSlogin } 412004e86ffSlogin 413004e86ffSlogin let inode = result.find(&name)?; 414004e86ffSlogin 415004e86ffSlogin // 处理符号链接的问题 416004e86ffSlogin if inode.metadata()?.file_type == FileType::SymLink && max_follow_times > 0 { 417004e86ffSlogin let mut content = [0u8; 256]; 418004e86ffSlogin // 读取符号链接 419004e86ffSlogin let len = inode.read_at(0, 256, &mut content, &mut FilePrivateData::Unused)?; 420004e86ffSlogin 421004e86ffSlogin // 将读到的数据转换为utf8字符串(先转为str,再转为String) 422004e86ffSlogin let link_path = String::from( 423676b8ef6SMork ::core::str::from_utf8(&content[..len]).map_err(|_| SystemError::ENOTDIR)?, 424004e86ffSlogin ); 425004e86ffSlogin 426004e86ffSlogin let new_path = link_path + "/" + &rest_path; 427004e86ffSlogin // 继续查找符号链接 428004e86ffSlogin return result.lookup_follow_symlink(&new_path, max_follow_times - 1); 429004e86ffSlogin } else { 430004e86ffSlogin result = inode; 431004e86ffSlogin } 432004e86ffSlogin } 433004e86ffSlogin 434004e86ffSlogin return Ok(result); 435004e86ffSlogin } 436004e86ffSlogin } 437004e86ffSlogin 438004e86ffSlogin /// IndexNode的元数据 439004e86ffSlogin /// 440004e86ffSlogin /// 对应Posix2008中的sys/stat.h中的定义 https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/sys_stat.h.html 441004e86ffSlogin #[derive(Debug, PartialEq, Eq, Clone)] 442004e86ffSlogin pub struct Metadata { 443004e86ffSlogin /// 当前inode所在的文件系统的设备号 444004e86ffSlogin pub dev_id: usize, 445004e86ffSlogin 446004e86ffSlogin /// inode号 447004e86ffSlogin pub inode_id: InodeId, 448004e86ffSlogin 449004e86ffSlogin /// Inode的大小 450004e86ffSlogin /// 文件:文件大小(单位:字节) 451004e86ffSlogin /// 目录:目录项中的文件、文件夹数量 452004e86ffSlogin pub size: i64, 453004e86ffSlogin 454004e86ffSlogin /// Inode所在的文件系统中,每个块的大小 455004e86ffSlogin pub blk_size: usize, 456004e86ffSlogin 457004e86ffSlogin /// Inode所占的块的数目 458004e86ffSlogin pub blocks: usize, 459004e86ffSlogin 460004e86ffSlogin /// inode最后一次被访问的时间 461004e86ffSlogin pub atime: TimeSpec, 462004e86ffSlogin 463004e86ffSlogin /// inode最后一次修改的时间 464004e86ffSlogin pub mtime: TimeSpec, 465004e86ffSlogin 466004e86ffSlogin /// inode的创建时间 467004e86ffSlogin pub ctime: TimeSpec, 468004e86ffSlogin 469004e86ffSlogin /// 文件类型 470004e86ffSlogin pub file_type: FileType, 471004e86ffSlogin 472004e86ffSlogin /// 权限 473004e86ffSlogin pub mode: u32, 474004e86ffSlogin 475004e86ffSlogin /// 硬链接的数量 476004e86ffSlogin pub nlinks: usize, 477004e86ffSlogin 478004e86ffSlogin /// User ID 479004e86ffSlogin pub uid: usize, 480004e86ffSlogin 481004e86ffSlogin /// Group ID 482004e86ffSlogin pub gid: usize, 483004e86ffSlogin 484004e86ffSlogin /// 文件指向的设备的id(对于设备文件系统来说) 485004e86ffSlogin pub raw_dev: usize, 486004e86ffSlogin } 487004e86ffSlogin 488004e86ffSlogin /// @brief 所有文件系统都应该实现的trait 489004e86ffSlogin pub trait FileSystem: Any + Sync + Send + Debug { 490004e86ffSlogin /// @brief 获取当前文件系统的root inode的指针 491004e86ffSlogin fn root_inode(&self) -> Arc<dyn IndexNode>; 492004e86ffSlogin 493004e86ffSlogin /// @brief 获取当前文件系统的信息 494004e86ffSlogin fn info(&self) -> FsInfo; 495004e86ffSlogin 496004e86ffSlogin /// @brief 本函数用于实现动态转换。 497004e86ffSlogin /// 具体的文件系统在实现本函数时,最简单的方式就是:直接返回self 498004e86ffSlogin fn as_any_ref(&self) -> &dyn Any; 499004e86ffSlogin } 500004e86ffSlogin 501004e86ffSlogin #[derive(Debug)] 502004e86ffSlogin pub struct FsInfo { 503004e86ffSlogin /// 文件系统所在的块设备的id 504004e86ffSlogin pub blk_dev_id: usize, 505004e86ffSlogin /// 文件名的最大长度 506004e86ffSlogin pub max_name_len: usize, 507004e86ffSlogin } 508004e86ffSlogin 509004e86ffSlogin /// @brief 整合主设备号+次设备号 510004e86ffSlogin pub fn make_rawdev(major: usize, minor: usize) -> usize { 511004e86ffSlogin ((major & 0xffffff) << 8) | (minor & 0xff) 512004e86ffSlogin } 513004e86ffSlogin 514004e86ffSlogin /// @brief 515004e86ffSlogin #[repr(C)] 516004e86ffSlogin #[derive(Debug)] 517004e86ffSlogin pub struct Dirent { 518004e86ffSlogin d_ino: u64, // 文件序列号 519004e86ffSlogin d_off: i64, // dir偏移量 520004e86ffSlogin d_reclen: u16, // 目录下的记录数 521004e86ffSlogin d_type: u8, // entry的类型 522004e86ffSlogin d_name: u8, // 文件entry的名字(是一个零长数组), 本字段仅用于占位 523004e86ffSlogin } 524*20e3152eSlogin 525*20e3152eSlogin impl Metadata { 526*20e3152eSlogin pub fn new(file_type: FileType, mode: u32) -> Self { 527*20e3152eSlogin Metadata { 528*20e3152eSlogin dev_id: 0, 529*20e3152eSlogin inode_id: generate_inode_id(), 530*20e3152eSlogin size: 0, 531*20e3152eSlogin blk_size: 0, 532*20e3152eSlogin blocks: 0, 533*20e3152eSlogin atime: TimeSpec::default(), 534*20e3152eSlogin mtime: TimeSpec::default(), 535*20e3152eSlogin ctime: TimeSpec::default(), 536*20e3152eSlogin file_type, 537*20e3152eSlogin mode, 538*20e3152eSlogin nlinks: 1, 539*20e3152eSlogin uid: 0, 540*20e3152eSlogin gid: 0, 541*20e3152eSlogin raw_dev: 0, 542*20e3152eSlogin } 543*20e3152eSlogin } 544*20e3152eSlogin } 545