README_zh.md · dapaodexiaoyu2/filemanagement_dfs_service

# 分布式文件服务

## **简介**

分布式文件服务提供跨设备的、符合POSIX规范的文件访问能力。其在分布式软总线动态组网的基础上，为网络上各个设备结点提供一个统一的、逻辑的、树形的文件系统层次结构。

<br>**图1**. 分布式文件系统架构图</br>
![架构图](https://images.gitee.com/uploads/images/2022/0107/113135_1cef6c44_7809790.png "hmdfs架构图update20220107.png")

其包括如下几个核心模块:

- distributed_file_daemon：分布式文件管理常驻用户态服务，负责接入设备组网、数据传输能力，并负责挂载hmdfs。
- distributed_file_service：分布式文件访问能力服务，对应用提供分布式扩展能力。
- hmdfs(Harmony Distributed File System)：分布式文件系统核心模块，是一种面向移动分布式场景的、高性能的、基于内核实现的、堆叠式文件系统。

## **目录**

```raw
/foundation/filemanagement/dfs_service
├── frameworks                      // 接口实现
│   └── native                      // c/c++ 接口实现
├── interfaces                      // 接口声明
│   └── inner_API                   // 对内接口声明
├── services                        // 服务实现
│   └── distributed_file_daemon     // daemon常驻服务实现
|       └── include                 // daemon常驻服务头文件,类声明
|       └── src                     // daemon常驻服务源文件
|           └── device              // 设备上下线管理
|           └── ipc                 // daemon进程拉起退出流程以及ipc接口实现
|           └── mount_point         // hmdfs挂载管理
|           └── network             // 软总线和内核会话session交互相关
|       └── test                    // 测试代码
|   └── distributed_file_service    // 对应用提供扩展能力的服务实现
├── utils                           // 公共组件
|    ├── log                        // 日志组件
|    └── system                     // 平台相关组件
```

## **约束**

### 接口支持情况

分布式文件管理当前不支持或有限支持如下 VFS 系统调用：

- symlink：不支持
- mmap：仅支持读
- rename：仅支持同目录操作

### 规格

- 最大目录层级

与被堆叠文件系统，即data分区所用文件系统，如ext4，f2fs等保持一致。
- 最大文件名长度
 
    取决于680B与被堆叠文件支持长度的最小值。f2fs和ext4均为255B。
- 最大单文件大小

取决于$2^{64}$B与被堆叠文件系统支持最大单文件大小的最小值。ext4单文件最大为16TB，f2fs单文件最大为3.94TB。

## **说明**

### 使用说明

可以使用终端调试分布式文件管理能力。
-   环境准备

1) 设备A和设备B连接同一局域网
2) 设备A和设备B登录同一华为账号
-   分布式文件系统能力使用
 
1) 经过以上环境准备后，即建立了设备间分布式文件互相访问的能力。
2) 可以在应用内通过```context.distributedFileDir()```接口获取本应用沙箱内的分布式路径。
3) 在此路径下可以像操作本地文件一样,操作远端设备的文件，比如可以进行创建、删除、读写文件和目录。
4) 在一端设备上进行步骤3的文件操作后，在组网的所有分布式设备上都可以查看相应的修改。

## 相关仓

- [分布式软总线-SoftBus](https://gitee.com/openharmony/communication_dsoftbus)
- [分布式硬件-设备管理](https://gitee.com/openharmony/device_manager)
- [用户程序框架](https://gitee.com/openharmony/appexecfwk_standard)

dapaodexiaoyu2/filemanagement_dfs_service

简介

发行版

贡献者

近期动态

dapaodexiaoyu2/filemanagement_dfs_service .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

dapaodexiaoyu2/filemanagement_dfs_service