format.c 文件参考

浏览源代码.

函数
int	format (const char *dev, int sectors, int option)
	formatting sd card 更多...
void	set_label (const char *name)

变量
char	FatLabel [LABEL_LEN]

函数说明

format()

int format	(	const char *	dev,
		int	sectors,
		int	option
	)

formatting sd card

Description:

formatting sd card.

注意

• The prefix of the parameter dev must be "/dev", and the length must be less than the value defined by PATH_MAX. There are four kind of format option: FMT_FAT16, FMT_FAT32, FMT_ANY, FMT_ERASE. If users input anything else, the default format option is FMT_ANY. Format option is decided by the number of clusters. Choosing the wrong option will cause error of format. The detailed information of (FAT16,FAT32) is ff.h.

参数

dev	[IN] Type #const char* path of the block device to format, which must be a really existing block device node.
sectors	[IN] Type int number of sectors per cluster.
option	[IN] Type int option of format.

返回值

#0	Format success.
#-1	Format failed.

Dependency:

• unistd.h: the header file that contains the API declaration.

参见

在文件 format.c 第 44 行定义.

{
    struct Vnode *device = NULL;
    INT err;
    if (dev == NULL) {
        set_errno(EINVAL);
        return -1;
    }
 
    if (strncmp(dev, "/dev", DEV_NAME_SIZE) != 0) {
        PRINTK("Usage  :\n");
        PRINTK("        format <dev_vnodename> <sectors> <option> <label>\n");
        PRINTK("        dev_vnodename : the name of dev\n");
        PRINTK("        sectors       : Size of allocation unit in unit of byte or sector, ");
        PRINTK("0 instead of default size\n");
        PRINTK("        options       : Index of filesystem. 1 for FAT filesystem, 2 for FAT32 filesystem, ");
        PRINTK("7 for any, 8 for erase\n");
        PRINTK("        label         : The volume of device. It will be emptyed when this parameter is null\n");
        PRINTK("Example:\n");
        PRINTK("        format /dev/mmcblk0 128 2\n");
 
        set_errno(EINVAL);
        return -1;
    }
    VnodeHold();
    err = VnodeLookup(dev, &device, 0);
    if (err == -ENOENT || err == -ENOSYS) {
        VnodeDrop();
        set_errno(ENODEV);
        return -1;
    } else if (err < 0) {
        VnodeDrop();
        set_errno(-err);
        return -1;
    }
    err = fatfs_mkfs(device, sectors, option);
    if (err < 0) {
        VnodeDrop();
        set_errno(-err);
        return -1;
    }
#ifdef LOSCFG_FS_FAT_VIRTUAL_PARTITION
    else if (err >= VIRERR_BASE) {
        set_errno(err);
    }
#endif
    VnodeDrop();
    return 0;
}

函数调用图:

这是这个函数的调用关系图:

set_label()

void set_label

(

const char *

name

)

Description:

The set_label() function shall set the value of a global varible, the value will be used to set the label of SD card in format().

参数

name	[IN] label to set, the length must be less than 12

注意

• The function must be called before format().

返回值

void

None.

Dependency:

• fs.h

参见

format

在文件 format.c 第 94 行定义.

{
    INT len;
    INT err;
 
    (void)memset_s(FatLabel, LABEL_LEN, 0, LABEL_LEN);
 
    if (name == NULL || *name == '\0') {
        return;
    }
 
    len = strlen(name);
    if (len >= LABEL_LEN) {
        len = LABEL_LEN - 1;
    }
 
    err = strncpy_s(FatLabel, LABEL_LEN, name, len);
    if (err != EOK) {
        PRINT_ERR("Fat set_label error");
    }
}

这是这个函数的调用关系图:

变量说明

FatLabel

char FatLabel[LABEL_LEN]

在文件 format.c 第 41 行定义.