轻量级的内存文件系统，实现基本的文件、目录和设备管理 A lightweight in-memory file system implementing basic file, directory, and device management More...

#include <ramfs.hpp>

Collaboration diagram for LibXR::RamFS:

[legend]

Data Structures
class	Device
	设备类，继承自红黑树节点 DeviceNode Device class inheriting from Red-Black tree node DeviceNode More...

class	DeviceNode
	设备节点，继承自 FsNode Device node, inheriting from FsNode More...

class	Dir
	目录类，继承自 RBTree 节点，用于管理文件、子目录和设备 Directory class, inheriting from RBTree node, used for managing files, subdirectories, and devices More...

class	DirNode
	目录节点，继承自 FsNode Directory node, inheriting from FsNode More...

class	FileNode
	文件节点类，继承自 FsNode，表示文件 File node class, inheriting from FsNode, representing a file More...

class	FsNode
	文件系统节点基类，所有文件和目录均继承自该类 Base class for file system nodes; all files and directories inherit from this More...

struct	StorageBlock

Public Types
enum class	FsNodeType : uint8_t { FILE , DIR , DEVICE , STORAGE , UNKNOW }
	文件系统节点类型 Types of file system nodes More...

enum class	FileType : uint8_t { READ_ONLY , READ_WRITE , EXEC }
	文件类型 Types of files More...

typedef LibXR::RamFS::FileNode	FileNode

typedef RBTree< const char * >::Node< FileNode >	File

Public Member Functions
	RamFS (const char *name="ramfs")
	构造函数，初始化内存文件系统的根目录 Constructor that initializes the root directory of the in-memory file system

void	Add (File &file)
	向文件系统的根目录添加文件 Adds a file to the root directory of the file system

void	Add (Dir &dir)
	向文件系统的根目录添加子目录 Adds a subdirectory to the root directory of the file system

void	Add (Device &dev)
	向文件系统的根目录添加设备 Adds a device to the root directory of the file system

File *	FindFile (const char *name)
	在整个文件系统中查找文件 Finds a file in the entire file system

Dir *	FindDir (const char *name)
	在整个文件系统中查找目录 Finds a directory in the entire file system

Device *	FindDevice (const char *name)
	在整个文件系统中查找设备 Finds a device in the entire file system

Static Public Member Functions
static int	CompareStr (const char const &a, const char const &b)
	比较两个字符串 Compares two strings

template<typename DataType >
static File	CreateFile (const char *name, DataType &raw)
	创建一个新的文件 Creates a new file

template<typename ArgType >
static File	CreateFile (const char name, int(exec)(ArgType arg, int argc, char **argv), ArgType &&arg)
	创建一个可执行文件 Creates an executable file

static Dir	CreateDir (const char *name)
	创建一个新的目录 Creates a new directory

Data Fields
Dir	root_
	文件系统的根目录 Root directory of the file system

Dir	bin_
	`bin` 目录，用于存放可执行文件 `bin` directory for storing executable files

Dir	dev_
	`dev` 目录，用于存放设备文件 `dev` directory for storing device files

Detailed Description

轻量级的内存文件系统，实现基本的文件、目录和设备管理 A lightweight in-memory file system implementing basic file, directory, and device management

Definition at line 19 of file ramfs.hpp.

Member Typedef Documentation

◆ File

typedef RBTree<const char *>::Node<FileNode> LibXR::RamFS::File

Definition at line 153 of file ramfs.hpp.

Member Enumeration Documentation

◆ FileType

enum class LibXR::RamFS::FileType : uint8_t

strong

文件类型 Types of files

Enumerator
READ_ONLY	只读 Read-only
READ_WRITE	读写 Read/Write
EXEC	可执行 Executable

Definition at line 66 of file ramfs.hpp.

  {
    READ_ONLY,   
    READ_WRITE,  
    EXEC,        
  };

◆ FsNodeType

enum class LibXR::RamFS::FsNodeType : uint8_t

strong

文件系统节点类型 Types of file system nodes

Enumerator
FILE	文件 File
DIR	目录 Directory
DEVICE	设备 Device
STORAGE	存储 Storage
UNKNOW	未知 Unknown

Definition at line 52 of file ramfs.hpp.

  {
    FILE,     
    DIR,      
    DEVICE,   
    STORAGE,  
    UNKNOW,   
  };

Constructor & Destructor Documentation

◆ RamFS()

LibXR::RamFS::RamFS ( const char * name = "ramfs" )

inline

构造函数，初始化内存文件系统的根目录 Constructor that initializes the root directory of the in-memory file system

Parameters

name	根目录的名称（默认为 "ramfs"） Name of the root directory (default: "ramfs")

Definition at line 28 of file ramfs.hpp.

      : root_(CreateDir(name)), bin_(CreateDir("bin")), dev_(CreateDir("dev"))
  {
    root_.Add(bin_);
    root_.Add(dev_);
  }

Member Function Documentation

◆ Add() [1/3]

void LibXR::RamFS::Add ( Device & dev )

inline

向文件系统的根目录添加设备 Adds a device to the root directory of the file system

Parameters

dev	要添加的设备 The device to be added

Definition at line 593 of file ramfs.hpp.

593{ root_.Add(dev); }

LibXR::min

constexpr auto min(T1 a, T2 b) -> typename std::common_type< T1, T2 >::type

计算两个数的最小值

Definition libxr_def.hpp:161

◆ Add() [2/3]

void LibXR::RamFS::Add ( Dir & dir )

inline

向文件系统的根目录添加子目录 Adds a subdirectory to the root directory of the file system

Parameters

dir	要添加的子目录 The subdirectory to be added

Definition at line 587 of file ramfs.hpp.

587{ root_.Add(dir); }

◆ Add() [3/3]

void LibXR::RamFS::Add ( File & file )

inline

向文件系统的根目录添加文件 Adds a file to the root directory of the file system

Parameters

file	要添加的文件 The file to be added

Definition at line 581 of file ramfs.hpp.

581{ root_.Add(file); }

◆ CompareStr()

static int LibXR::RamFS::CompareStr	(	const char *const &	a,
		const char *const &	b
	)

inlinestatic

比较两个字符串 Compares two strings

Parameters

a	字符串 A String A
b	字符串 B String B

Returns: int 比较结果 Comparison result

Definition at line 42 of file ramfs.hpp.

  {
    return strcmp(a, b);
  }

◆ CreateDir()

static Dir LibXR::RamFS::CreateDir ( const char * name )

inlinestatic

创建一个新的目录 Creates a new directory

Parameters

name	目录名称 The name of the directory

Returns: Dir 创建的目录对象 The created directory object

Definition at line 564 of file ramfs.hpp.

  {
    Dir dir;
 
    char *name_buff = new char[strlen(name) + 1];
    strcpy(name_buff, name);
    dir->name = name_buff;
    dir->type = FsNodeType::DIR;
 
    return dir;
  }

◆ CreateFile() [1/2]

template<typename DataType >

static File LibXR::RamFS::CreateFile	(	const char *	name,
		DataType &	raw
	)

inlinestatic

创建一个新的文件 Creates a new file

Template Parameters

DataType 文件存储的数据类型 Data type stored in the file

Parameters

name	文件名 The name of the file
raw	文件存储的数据 Data stored in the file

Returns: File 创建的文件对象 The created file object

Definition at line 493 of file ramfs.hpp.

  {
    File file;
    char *name_buff = new char[strlen(name) + 1];
    strcpy(name_buff, name);
    file->name = name_buff;
 
    if (std::is_const<DataType>())
    {
      file->type = FileType::READ_ONLY;
      file->addr_const = &raw;
    }
    else
    {
      file->type = FileType::READ_WRITE;
      file->addr = &raw;
    }
 
    file->size = sizeof(DataType);
 
    return file;
  }

◆ CreateFile() [2/2]

template<typename ArgType >

static File LibXR::RamFS::CreateFile	(	const char *	name,
		int()(ArgType arg, int argc, char *argv)	exec,
		ArgType &&	arg
	)

inlinestatic

创建一个可执行文件 Creates an executable file

Template Parameters

ArgType 可执行文件的参数类型 The argument type for the executable file

Parameters

name	文件名 The name of the file
exec	可执行函数 The executable function
arg	可执行文件的参数 The argument for the executable file

Returns: File 创建的可执行文件对象 The created executable file object

Definition at line 526 of file ramfs.hpp.

  {
    typedef struct
    {
      ArgType arg;
      typeof(exec) exec_fun;
    } FileBlock;
 
    File file;
 
    char *name_buff = new char[strlen(name) + 1];
    strcpy(name_buff, name);
    file->name = name_buff;
    file->type = FileType::EXEC;
 
    auto block = new FileBlock;
    block->arg = std::forward<ArgType>(arg);
    block->exec_fun = exec;
    file->arg = block;
 
    auto fun = [](void *arg, int argc, char **argv)
    {
      auto block = reinterpret_cast<FileBlock *>(arg);
      return block->exec_fun(block->arg, argc, argv);
    };
 
    file->exec = fun;
 
    return file;
  }

◆ FindDevice()

Device * LibXR::RamFS::FindDevice ( const char * name )

inline

在整个文件系统中查找设备 Finds a device in the entire file system

Parameters

name	设备名 The name of the device

Returns: Device* 指向找到的设备的指针，如果未找到则返回 nullptr Pointer to the found device, or nullptr if not found

Definition at line 618 of file ramfs.hpp.

618{ return root_.FindDeviceRev(name); }

LibXR::RamFS::Dir::FindDeviceRev

Device * FindDeviceRev(const char *name)

递归查找设备 Recursively searches for a device

Definition ramfs.hpp:428

◆ FindDir()

Dir * LibXR::RamFS::FindDir ( const char * name )

inline

在整个文件系统中查找目录 Finds a directory in the entire file system

Parameters

name	目录名 The name of the directory

Returns: Dir* 指向找到的目录的指针，如果未找到则返回 nullptr Pointer to the found directory, or nullptr if not found

Definition at line 610 of file ramfs.hpp.

610{ return root_.FindDirRev(name); }

LibXR::RamFS::Dir::FindDirRev

Dir * FindDirRev(const char *name)

递归查找子目录 Recursively searches for a subdirectory

Definition ramfs.hpp:384

◆ FindFile()

File * LibXR::RamFS::FindFile ( const char * name )

inline

在整个文件系统中查找文件 Finds a file in the entire file system

Parameters

name	文件名 The name of the file

Returns: File* 指向找到的文件的指针，如果未找到则返回 nullptr Pointer to the found file, or nullptr if not found

Definition at line 602 of file ramfs.hpp.

602{ return root_.FindFileRev(name); }

LibXR::RamFS::Dir::FindFileRev

File * FindFileRev(const char *name)

递归查找文件 Recursively searches for a file

Definition ramfs.hpp:310

Field Documentation

◆ bin_

Dir LibXR::RamFS::bin_

bin 目录，用于存放可执行文件 bin directory for storing executable files

Definition at line 630 of file ramfs.hpp.

◆ dev_

Dir LibXR::RamFS::dev_

dev 目录，用于存放设备文件 dev directory for storing device files

Definition at line 636 of file ramfs.hpp.

◆ root_

Dir LibXR::RamFS::root_

文件系统的根目录 Root directory of the file system

Definition at line 624 of file ramfs.hpp.

The documentation for this class was generated from the following file:

src/middleware/ramfs.hpp

Data Structures

Public Types

Public Member Functions

Static Public Member Functions

Data Fields

Detailed Description

Member Typedef Documentation

◆ File

Member Enumeration Documentation

◆ FileType

◆ FsNodeType

Constructor & Destructor Documentation

◆ RamFS()

Member Function Documentation

◆ Add() [1/3]

◆ Add() [2/3]

◆ Add() [3/3]

◆ CompareStr()

◆ CreateDir()

◆ CreateFile() [1/2]

◆ CreateFile() [2/2]

◆ FindDevice()

◆ FindDir()

◆ FindFile()

Field Documentation

◆ bin_

◆ dev_

◆ root_