From 63d917addb3e088502c503323353c0d4600d435a Mon Sep 17 00:00:00 2001 From: xianghengliang Date: Wed, 5 Jan 2022 11:26:27 +0800 Subject: [PATCH 1/2] update readme 2022.01.05 Signed-off-by: xianghengliang --- README.md | 40 +++++++++++++++++++++++++--------------- 1 file changed, 25 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index c10b77ab9..b38af4579 100644 --- a/README.md +++ b/README.md @@ -2,21 +2,21 @@ [TOC] -## 简介 +## **简介** 分布式文件管理提供跨设备的、符合POSIX规范的文件访问能力。其在分布式软总线动态组网的基础上，为网络上各个设备结点提供一个统一的、逻辑的、树形的文件系统层次结构。 分布式文件管理的架构如下图所示： -![架构图](https://images.gitee.com/uploads/images/2021/1230/144700_951a1fe5_7809790.png "hmdfs架构图update_20211230.png") +![架构图](https://images.gitee.com/uploads/images/2022/0105/105537_8b6a7bbc_7809790.png "hmdfs架构图update20220105.png") 其包括如下几个核心模块： -- distributed_file_daemon：分布式文件管理常驻用户态服务，负责接入设备组网、数据传输能力，并负责挂载hmdfs -- distributed_file_service：分布式文件管理服务进程，对应用提供分布式扩展能力 +- distributed_file_daemon：分布式文件管理常驻用户态服务，负责接入设备组网、数据传输能力，并负责挂载hmdfs。 +- distributed_file_service：分布式文件管理服务进程，对应用提供分布式扩展能力。 - hmdfs(Harmony Distributed File System)：分布式文件管理核心模块，是一种面向移动分布式场景的、高性能的、基于内核实现的、堆叠式文件系统。 -## 目录 +## **目录** ```raw //foundation/storage/distributed_file_manager @@ -40,7 +40,7 @@ └── system // 平台相关组件 ``` -## 约束 +## **约束** ### 接口支持情况 @@ -50,26 +50,36 @@ - mmap：仅支持读 - rename：仅支持同目录操作 -### 目录项规格 +### 规格 - 最大目录层级 - - 与被堆叠文件系统，即data分区所用文件系统，如 ext4，f2fs等，保持一致 + + 与被堆叠文件系统，即data分区所用文件系统，如ext4，f2fs等，保持一致。 - 最大文件名长度 - 取决于680字节与被堆叠文件支持长度的最小值。f2fs和ext4均为255字节。 -- 单文件最大大小 - 取决于2^64字节与被堆叠文件系统的最小值。ext4单文件最大为16TB, f2fs单文件最大为3.94T。 + + 取决于680B与被堆叠文件支持长度的最小值。f2fs和ext4均为255B。 +- 单文件大小限制 + + 取决于2^64B与被堆叠文件系统的最小值。ext4单文件最大为16TB, f2fs单文件最大为3.94TB。 - 单目录下最大目录项数 + 取决于被堆叠文件系统单文件大小。当堆叠f2fs时，假设平均目录长度放大系数为3，则为`3.94TB/4KB*85/3=29,966,344,738`个。 -## 说明 +## **说明** ### 使用说明 可以使用终端调试分布式文件管理能力。 +- 环境准备 + +1) 设备A和设备B连接同一局域网 +2) 设备A和设备B登录同一华为账号 +- 分布式文件系统能力使用 + +经过以上环境准备后，即建立了设备间分布式文件互相访问的能力。 +可以在应用内通过```Context.distributedFileDir()```接口获取本应用沙箱内的分布式路径， -多台设备在已经组网（同一局域网）, 并且经过hichian模块可信认证，可以建立设备间分布式文件互相访问的能力。 -可以在应用内通过```Context.distributedFileDir()```接口获取本应用沙箱内的分布式路径，然后在此目录下可以进行创建、删除、读写文件和目录。 +然后在此目录下可以像操作本地文件或目录一样，操作远端设备的文件，比如可以进行创建、删除、读写文件和目录。 ## 相关 -- Gitee From b67e5f0aba636c332d9019682ae88436d35058de Mon Sep 17 00:00:00 2001 From: xianghengliang Date: Wed, 5 Jan 2022 11:30:05 +0800 Subject: [PATCH 2/2] update readme Signed-off-by: xianghengliang --- README.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index b38af4579..747f9a9a4 100644 --- a/README.md +++ b/README.md @@ -53,14 +53,14 @@ ### 规格 - 最大目录层级 - + 与被堆叠文件系统，即data分区所用文件系统，如ext4，f2fs等，保持一致。 - 最大文件名长度 - + 取决于680B与被堆叠文件支持长度的最小值。f2fs和ext4均为255B。 - 单文件大小限制 - - 取决于2^64B与被堆叠文件系统的最小值。ext4单文件最大为16TB, f2fs单文件最大为3.94TB。 + + 取决于$2^{64}$B与被堆叠文件系统的最小值。ext4单文件最大为16TB, f2fs单文件最大为3.94TB。 - 单目录下最大目录项数 取决于被堆叠文件系统单文件大小。当堆叠f2fs时，假设平均目录长度放大系数为3，则为`3.94TB/4KB*85/3=29,966,344,738`个。 @@ -75,10 +75,9 @@ 1) 设备A和设备B连接同一局域网 2) 设备A和设备B登录同一华为账号 - 分布式文件系统能力使用 - + 经过以上环境准备后，即建立了设备间分布式文件互相访问的能力。 可以在应用内通过```Context.distributedFileDir()```接口获取本应用沙箱内的分布式路径， - 然后在此目录下可以像操作本地文件或目录一样，操作远端设备的文件，比如可以进行创建、删除、读写文件和目录。 ## 相关 -- Gitee