/// 导出devfs的模块 pub mod null_dev; pub mod zero_dev; use super::vfs::{ core::{generate_inode_id, ROOT_INODE}, file::FileMode, syscall::ModeType, FileSystem, FileType, FsInfo, IndexNode, Metadata, }; use crate::{ kerror, kinfo, libs::{ once::Once, spinlock::{SpinLock, SpinLockGuard}, }, syscall::SystemError, time::TimeSpec, }; use alloc::{ collections::BTreeMap, string::{String, ToString}, sync::{Arc, Weak}, vec::Vec, }; const DEVFS_MAX_NAMELEN: usize = 64; /// @brief dev文件系统 #[derive(Debug)] pub struct DevFS { // 文件系统根节点 root_inode: Arc, } impl FileSystem for DevFS { fn as_any_ref(&self) -> &dyn core::any::Any { self } fn root_inode(&self) -> Arc { return self.root_inode.clone(); } fn info(&self) -> super::vfs::FsInfo { return FsInfo { blk_dev_id: 0, max_name_len: DEVFS_MAX_NAMELEN, }; } } impl DevFS { pub fn new() -> Arc { // 初始化root inode let root: Arc = Arc::new(LockedDevFSInode(SpinLock::new( // /dev 的权限设置为 读+执行,root 可以读写 // root 的 parent 是空指针 DevFSInode::new(FileType::Dir, ModeType::from_bits_truncate(0o755), 0), ))); let devfs: Arc = Arc::new(DevFS { root_inode: root }); // 对root inode加锁,并继续完成初始化工作 let mut root_guard: SpinLockGuard = devfs.root_inode.0.lock(); root_guard.parent = Arc::downgrade(&devfs.root_inode); root_guard.self_ref = Arc::downgrade(&devfs.root_inode); root_guard.fs = Arc::downgrade(&devfs); // 释放锁 drop(root_guard); // 创建文件夹 let root: &Arc = &devfs.root_inode; root.add_dir("char") .expect("DevFS: Failed to create /dev/char"); root.add_dir("block") .expect("DevFS: Failed to create /dev/block"); devfs.register_bultinin_device(); // kdebug!("ls /dev: {:?}", root.list()); return devfs; } /// @brief 注册系统内部自带的设备 fn register_bultinin_device(&self) { use null_dev::LockedNullInode; use zero_dev::LockedZeroInode; let dev_root: Arc = self.root_inode.clone(); dev_root .add_dev("null", LockedNullInode::new()) .expect("DevFS: Failed to register /dev/null"); dev_root .add_dev("zero", LockedZeroInode::new()) .expect("DevFS: Failed to register /dev/zero"); } /// @brief 在devfs内注册设备 /// /// @param name 设备名称 /// @param device 设备节点的结构体 pub fn register_device( &self, name: &str, device: Arc, ) -> Result<(), SystemError> { let dev_root_inode: Arc = self.root_inode.clone(); let metadata = device.metadata()?; match metadata.file_type { // 字节设备挂载在 /dev/char FileType::CharDevice => { if let Err(_) = dev_root_inode.find("char") { dev_root_inode.create( "char", FileType::Dir, ModeType::from_bits_truncate(0o755), )?; } let any_char_inode = dev_root_inode.find("char")?; let dev_char_inode: &LockedDevFSInode = any_char_inode .as_any_ref() .downcast_ref::() .unwrap(); // 在 /dev/char 下创建设备节点 dev_char_inode.add_dev(name, device.clone())?; // 特殊处理 tty 设备,挂载在 /dev 下 if name.starts_with("tty") && name.len() > 3 { dev_root_inode.add_dev(name, device.clone())?; } device.set_fs(dev_char_inode.0.lock().fs.clone()); } FileType::BlockDevice => { if let Err(_) = dev_root_inode.find("block") { dev_root_inode.create( "block", FileType::Dir, ModeType::from_bits_truncate(0o755), )?; } let any_block_inode = dev_root_inode.find("block")?; let dev_block_inode: &LockedDevFSInode = any_block_inode .as_any_ref() .downcast_ref::() .unwrap(); dev_block_inode.add_dev(name, device.clone())?; device.set_fs(dev_block_inode.0.lock().fs.clone()); } FileType::KvmDevice => { dev_root_inode .add_dev(name, device.clone()) .expect("DevFS: Failed to register /dev/kvm"); } _ => { return Err(SystemError::EOPNOTSUPP_OR_ENOTSUP); } } return Ok(()); } /// @brief 卸载设备 pub fn unregister_device( &self, name: &str, device: Arc, ) -> Result<(), SystemError> { let dev_root_inode: Arc = self.root_inode.clone(); match device.metadata().unwrap().file_type { // 字节设备挂载在 /dev/char FileType::CharDevice => { if let Err(_) = dev_root_inode.find("char") { return Err(SystemError::ENOENT); } let any_char_inode = dev_root_inode.find("char")?; let dev_char_inode = any_char_inode .as_any_ref() .downcast_ref::() .unwrap(); // TODO: 调用设备的卸载接口(当引入卸载接口之后) dev_char_inode.remove(name)?; } FileType::BlockDevice => { if let Err(_) = dev_root_inode.find("block") { return Err(SystemError::ENOENT); } let any_block_inode = dev_root_inode.find("block")?; let dev_block_inode = any_block_inode .as_any_ref() .downcast_ref::() .unwrap(); dev_block_inode.remove(name)?; } _ => { return Err(SystemError::EOPNOTSUPP_OR_ENOTSUP); } } return Ok(()); } } /// @brief dev文件i节点(锁) #[derive(Debug)] pub struct LockedDevFSInode(SpinLock); /// @brief dev文件i节点(无锁) #[derive(Debug)] pub struct DevFSInode { /// 指向父Inode的弱引用 parent: Weak, /// 指向自身的弱引用 self_ref: Weak, /// 子Inode的B树 children: BTreeMap>, /// 指向inode所在的文件系统对象的指针 fs: Weak, /// INode 元数据 metadata: Metadata, } impl DevFSInode { pub fn new(dev_type_: FileType, mode: ModeType, data_: usize) -> Self { return Self::new_with_parent(Weak::default(), dev_type_, mode, data_); } pub fn new_with_parent( parent: Weak, dev_type_: FileType, mode: ModeType, data_: usize, ) -> Self { return DevFSInode { parent: parent, self_ref: Weak::default(), children: BTreeMap::new(), metadata: Metadata { dev_id: 1, inode_id: generate_inode_id(), size: 0, blk_size: 0, blocks: 0, atime: TimeSpec::default(), mtime: TimeSpec::default(), ctime: TimeSpec::default(), file_type: dev_type_, // 文件夹 mode, nlinks: 1, uid: 0, gid: 0, raw_dev: data_, }, fs: Weak::default(), }; } } impl LockedDevFSInode { pub fn add_dir(&self, name: &str) -> Result<(), SystemError> { let guard: SpinLockGuard = self.0.lock(); if guard.children.contains_key(name) { return Err(SystemError::EEXIST); } match self.do_create_with_data( guard, name, FileType::Dir, ModeType::from_bits_truncate(0o755), 0, ) { Ok(inode) => inode, Err(err) => { return Err(err); } }; return Ok(()); } pub fn add_dev(&self, name: &str, dev: Arc) -> Result<(), SystemError> { let mut this = self.0.lock(); if this.children.contains_key(name) { return Err(SystemError::EEXIST); } this.children.insert(name.to_string(), dev); return Ok(()); } pub fn remove(&self, name: &str) -> Result<(), SystemError> { let x = self .0 .lock() .children .remove(name) .ok_or(SystemError::ENOENT)?; drop(x); return Ok(()); } fn do_create_with_data( &self, mut guard: SpinLockGuard, name: &str, file_type: FileType, mode: ModeType, data: usize, ) -> Result, SystemError> { if guard.metadata.file_type != FileType::Dir { return Err(SystemError::ENOTDIR); } // 如果有重名的,则返回 if guard.children.contains_key(name) { return Err(SystemError::EEXIST); } // 创建inode let result: Arc = Arc::new(LockedDevFSInode(SpinLock::new(DevFSInode { parent: guard.self_ref.clone(), self_ref: Weak::default(), children: BTreeMap::new(), metadata: Metadata { dev_id: 0, inode_id: generate_inode_id(), size: 0, blk_size: 0, blocks: 0, atime: TimeSpec::default(), mtime: TimeSpec::default(), ctime: TimeSpec::default(), file_type, mode, nlinks: 1, uid: 0, gid: 0, raw_dev: data, }, fs: guard.fs.clone(), }))); // 初始化inode的自引用的weak指针 result.0.lock().self_ref = Arc::downgrade(&result); // 将子inode插入父inode的B树中 guard.children.insert(String::from(name), result.clone()); return Ok(result); } } impl IndexNode for LockedDevFSInode { fn as_any_ref(&self) -> &dyn core::any::Any { self } fn open( &self, _data: &mut super::vfs::FilePrivateData, _mode: &FileMode, ) -> Result<(), SystemError> { return Ok(()); } fn close(&self, _data: &mut super::vfs::FilePrivateData) -> Result<(), SystemError> { return Ok(()); } fn create_with_data( &self, name: &str, file_type: FileType, mode: ModeType, data: usize, ) -> Result, SystemError> { // 获取当前inode let guard: SpinLockGuard = self.0.lock(); // 如果当前inode不是文件夹,则返回 return self.do_create_with_data(guard, name, file_type, mode, data); } fn find(&self, name: &str) -> Result, SystemError> { let inode = self.0.lock(); if inode.metadata.file_type != FileType::Dir { return Err(SystemError::ENOTDIR); } match name { "" | "." => { return Ok(inode.self_ref.upgrade().ok_or(SystemError::ENOENT)?); } ".." => { return Ok(inode.parent.upgrade().ok_or(SystemError::ENOENT)?); } name => { // 在子目录项中查找 return Ok(inode.children.get(name).ok_or(SystemError::ENOENT)?.clone()); } } } fn fs(&self) -> Arc { return self.0.lock().fs.upgrade().unwrap(); } fn get_entry_name(&self, ino: super::vfs::InodeId) -> Result { let inode: SpinLockGuard = self.0.lock(); if inode.metadata.file_type != FileType::Dir { return Err(SystemError::ENOTDIR); } match ino.into() { 0 => { return Ok(String::from(".")); } 1 => { return Ok(String::from("..")); } ino => { // 暴力遍历所有的children,判断inode id是否相同 // TODO: 优化这里,这个地方性能很差! let mut key: Vec = inode .children .keys() .filter(|k| { inode .children .get(*k) .unwrap() .metadata() .unwrap() .inode_id .into() == ino }) .cloned() .collect(); match key.len() { 0=>{return Err(SystemError::ENOENT);} 1=>{return Ok(key.remove(0));} _ => panic!("Devfs get_entry_name: key.len()={key_len}>1, current inode_id={inode_id:?}, to find={to_find:?}", key_len=key.len(), inode_id = inode.metadata.inode_id, to_find=ino) } } } } fn ioctl(&self, _cmd: u32, _data: usize) -> Result { Err(SystemError::EOPNOTSUPP_OR_ENOTSUP) } fn list(&self) -> Result, SystemError> { let info = self.metadata()?; if info.file_type != FileType::Dir { return Err(SystemError::ENOTDIR); } let mut keys: Vec = Vec::new(); keys.push(String::from(".")); keys.push(String::from("..")); keys.append(&mut self.0.lock().children.keys().cloned().collect()); return Ok(keys); } fn metadata(&self) -> Result { return Ok(self.0.lock().metadata.clone()); } fn set_metadata(&self, metadata: &Metadata) -> Result<(), SystemError> { let mut inode = self.0.lock(); inode.metadata.atime = metadata.atime; inode.metadata.mtime = metadata.mtime; inode.metadata.ctime = metadata.ctime; inode.metadata.mode = metadata.mode; inode.metadata.uid = metadata.uid; inode.metadata.gid = metadata.gid; return Ok(()); } /// 读设备 - 应该调用设备的函数读写,而不是通过文件系统读写 fn read_at( &self, _offset: usize, _len: usize, _buf: &mut [u8], _data: &mut super::vfs::file::FilePrivateData, ) -> Result { kerror!("DevFS: read_at is not supported!"); Err(SystemError::EOPNOTSUPP_OR_ENOTSUP) } /// 写设备 - 应该调用设备的函数读写,而不是通过文件系统读写 fn write_at( &self, _offset: usize, _len: usize, _buf: &[u8], _data: &mut super::vfs::file::FilePrivateData, ) -> Result { Err(SystemError::EOPNOTSUPP_OR_ENOTSUP) } } /// @brief 所有的设备INode都需要额外实现这个trait pub trait DeviceINode: IndexNode { fn set_fs(&self, fs: Weak); // TODO: 增加 unregister 方法 } /// @brief 获取devfs实例的强类型不可变引用 macro_rules! devfs_exact_ref { () => {{ let devfs_inode: Result, SystemError> = ROOT_INODE().find("dev"); if let Err(e) = devfs_inode { kerror!("failed to get DevFS ref. errcode = {:?}", e); return Err(SystemError::ENOENT); } let binding = devfs_inode.unwrap(); let devfs_inode: &LockedDevFSInode = binding .as_any_ref() .downcast_ref::() .unwrap(); let binding = devfs_inode.fs(); binding } .as_any_ref() .downcast_ref::() .unwrap()}; } /// @brief devfs的设备注册函数 pub fn devfs_register(name: &str, device: Arc) -> Result<(), SystemError> { return devfs_exact_ref!().register_device(name, device); } /// @brief devfs的设备卸载函数 #[allow(dead_code)] pub fn devfs_unregister(name: &str, device: Arc) -> Result<(), SystemError> { return devfs_exact_ref!().unregister_device(name, device); } pub fn devfs_init() -> Result<(), SystemError> { static INIT: Once = Once::new(); let mut result = None; INIT.call_once(|| { kinfo!("Initializing DevFS..."); // 创建 devfs 实例 let devfs: Arc = DevFS::new(); // devfs 挂载 let _t = ROOT_INODE() .find("dev") .expect("Cannot find /dev") .mount(devfs) .expect("Failed to mount devfs"); kinfo!("DevFS mounted."); result = Some(Ok(())); }); return result.unwrap(); }