1e41f4b71Sopenharmony_ci# format
2e41f4b71Sopenharmony_ci
3e41f4b71Sopenharmony_ci
4e41f4b71Sopenharmony_ci## 命令功能
5e41f4b71Sopenharmony_ci
6e41f4b71Sopenharmony_ciformat指令用于格式化磁盘。
7e41f4b71Sopenharmony_ci
8e41f4b71Sopenharmony_ci
9e41f4b71Sopenharmony_ci## 命令格式
10e41f4b71Sopenharmony_ci
11e41f4b71Sopenharmony_ciformat <_dev_inodename_> <_sectors_> <_option_> [_label_]
12e41f4b71Sopenharmony_ci
13e41f4b71Sopenharmony_ci
14e41f4b71Sopenharmony_ci## 参数说明
15e41f4b71Sopenharmony_ci
16e41f4b71Sopenharmony_ci**表1** 参数说明
17e41f4b71Sopenharmony_ci
18e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 
19e41f4b71Sopenharmony_ci| -------- | -------- |
20e41f4b71Sopenharmony_ci| dev_inodename | 设备名。 | 
21e41f4b71Sopenharmony_ci| sectors | 分配的单元内存或扇区大小,如果输入0表示参数为空。(取值必须为0或2的幂,fat32下最大值为128,取值0表示自动选择合适的簇大小,不同size的分区,可用的簇大小范围不同,错误的簇大小指定可能导致格式化失败)。 | 
22e41f4b71Sopenharmony_ci| option | &nbsp;&nbsp;格式化选项,用来选择文件系统的类型,有如下几种参数选择:<br/>-&nbsp;0x01:FMT_FAT<br/>-&nbsp;0x02:FMT_FAT32<br/>-&nbsp;0x07:FMT_ANY<br/>-&nbsp;0x08:FMT_ERASE&nbsp;(USB不支持该选项)<br/>传入其他值皆为非法值,将由系统自动选择格式化方式。若格式化U盘时低格位为&nbsp;1,会出现错误打印。 | 
23e41f4b71Sopenharmony_ci| label | 该参数为可选参数,输入值应为字符串,用来指定卷标名。当输入字符串"null"时,则把之前设置的卷标名清空。 | 
24e41f4b71Sopenharmony_ci
25e41f4b71Sopenharmony_ci
26e41f4b71Sopenharmony_ci## 使用指南
27e41f4b71Sopenharmony_ci
28e41f4b71Sopenharmony_ci- format指令用于格式化磁盘,设备名可以在dev目录下查找。format时必须安装存储卡。
29e41f4b71Sopenharmony_ci
30e41f4b71Sopenharmony_ci- format只能格式化U盘、sd和mmc卡,对Nand flash和Nor flash格式化不起作用。
31e41f4b71Sopenharmony_ci
32e41f4b71Sopenharmony_ci- sectors参数必须传入合法值,传入非法参数可能引发异常。
33e41f4b71Sopenharmony_ci
34e41f4b71Sopenharmony_ci
35e41f4b71Sopenharmony_ci## 使用实例
36e41f4b71Sopenharmony_ci
37e41f4b71Sopenharmony_ci举例:输入format /dev/mmcblk0 128 2
38e41f4b71Sopenharmony_ci
39e41f4b71Sopenharmony_ci
40e41f4b71Sopenharmony_ci## 输出说明
41e41f4b71Sopenharmony_ci
42e41f4b71Sopenharmony_ci**示例** 格式化mmc卡
43e41f4b71Sopenharmony_ci
44e41f4b71Sopenharmony_ci```
45e41f4b71Sopenharmony_ciOHOS # format /dev/mmcblk1 128 2
46e41f4b71Sopenharmony_ciFormat to FAT32, 128 sectors per cluster.
47e41f4b71Sopenharmony_ciformat /dev/mmcblk1 Success 
48e41f4b71Sopenharmony_ci```
49