鴻蒙輕核心原始碼分析：檔案系統LittleFS

華為雲開發者社群發表於2022-02-08

摘要：本文先介紹下LFS檔案系統結構體的結構體和全域性變數，然後分析下LFS檔案操作介面。

本文分享自華為雲社群《# 鴻蒙輕核心M核原始碼分析系列二一 02 檔案系統LittleFS》，作者：zhushy 。

LittleFS是一個小型的Flash檔案系統，它結合日誌結構（log-structured）檔案系統和COW（copy-on-write）檔案系統的思想，以日誌結構儲存後設資料，以COW結構儲存資料。這種特殊的儲存方式，使LittleFS具有強大的掉電恢復能力（power-loss resilience)。分配COW資料塊時LittleFS採用了名為統計損耗均衡的動態損耗均衡演算法，使Flash裝置的壽命得到有效保障。同時LittleFS針對資源緊缺的小型裝置進行設計，具有極其有限的ROM和RAM佔用，並且所有RAM的使用都通過一個可配置的固定大小緩衝區進行分配，不會隨檔案系統的擴大佔據更多的系統資源。當在一個資源非常緊缺的小型裝置上，尋找一個具有掉電恢復能力並支援損耗均衡的Flash檔案系統時，LittleFS是一個比較好的選擇。本文先介紹下LFS檔案系統結構體的結構體和全域性變數，然後分析下LFS檔案操作介面。文中所涉及的原始碼，均可以在開源站點https://gitee.com/openharmony/kernel_liteos_m 獲取。

1、LFS檔案系統結構體介紹

會分2部分來介紹結構體部分，先介紹LittleFS檔案系統的結構體，然後介紹LiteOS-M核心中提供的和LittleFS相關的一些結構體。

1.1 LittleFS的列舉結構體

在openharmony/third_party/littlefs/lfs.h標頭檔案中定義LittleFS的列舉、結構體，我們先簡單瞭解下，後文會使用到的。

列舉lfs_type定義檔案型別，瞭解下普通檔案LFS_TYPE_REG和目錄LFS_TYPE_DIR即可。列舉lfs_open_flags定義檔案系統的開啟標籤屬性資訊，需要熟悉常用的只讀LFS_O_RDONLY、只寫LFS_O_WRONLY、讀寫LFS_O_RDWR等等。

// File types
enum lfs_type {
    // file types
    LFS_TYPE_REG            = 0x001,
    LFS_TYPE_DIR            = 0x002,

    // internally used types
    LFS_TYPE_SPLICE         = 0x400,
    LFS_TYPE_NAME           = 0x000,
    LFS_TYPE_STRUCT         = 0x200,
    LFS_TYPE_USERATTR       = 0x300,
    LFS_TYPE_FROM           = 0x100,
    LFS_TYPE_TAIL           = 0x600,
    LFS_TYPE_GLOBALS        = 0x700,
    LFS_TYPE_CRC            = 0x500,

    // internally used type specializations
    LFS_TYPE_CREATE         = 0x401,
    LFS_TYPE_DELETE         = 0x4ff,
    LFS_TYPE_SUPERBLOCK     = 0x0ff,
    LFS_TYPE_DIRSTRUCT      = 0x200,
    LFS_TYPE_CTZSTRUCT      = 0x202,
    LFS_TYPE_INLINESTRUCT   = 0x201,
    LFS_TYPE_SOFTTAIL       = 0x600,
    LFS_TYPE_HARDTAIL       = 0x601,
    LFS_TYPE_MOVESTATE      = 0x7ff,

    // internal chip sources
    LFS_FROM_NOOP           = 0x000,
    LFS_FROM_MOVE           = 0x101,
    LFS_FROM_USERATTRS      = 0x102,
};

// File open flags
enum lfs_open_flags {
    // open flags
    LFS_O_RDONLY = 1,         // Open a file as read only
#ifndef LFS_READONLY
    LFS_O_WRONLY = 2,         // Open a file as write only
    LFS_O_RDWR   = 3,         // Open a file as read and write
    LFS_O_CREAT  = 0x0100,    // Create a file if it does not exist
    LFS_O_EXCL   = 0x0200,    // Fail if a file already exists
    LFS_O_TRUNC  = 0x0400,    // Truncate the existing file to zero size
    LFS_O_APPEND = 0x0800,    // Move to end of file on every write
#endif

    // internally used flags
#ifndef LFS_READONLY
    LFS_F_DIRTY   = 0x010000, // File does not match storage
    LFS_F_WRITING = 0x020000, // File has been written since last flush
#endif
    LFS_F_READING = 0x040000, // File has been read since last flush
#ifndef LFS_READONLY
    LFS_F_ERRED   = 0x080000, // An error occurred during write
#endif
    LFS_F_INLINE  = 0x100000, // Currently inlined in directory entry
};

結構體lfs_t是littlefs檔案系統型別結構體，lfs檔案系統操作介面的第一個引數一般為這個結構體。成員變數struct lfs_config *cfg下文會涉及，其他成員變數可以暫不瞭解。

// The littlefs filesystem type
typedef struct lfs {
    lfs_cache_t rcache;
    lfs_cache_t pcache;

    lfs_block_t root[2];
    struct lfs_mlist {
        struct lfs_mlist *next;
        uint16_t id;
        uint8_t type;
        lfs_mdir_t m;
    } *mlist;
    uint32_t seed;

    lfs_gstate_t gstate;
    lfs_gstate_t gdisk;
    lfs_gstate_t gdelta;

    struct lfs_free {
        lfs_block_t off;
        lfs_block_t size;
        lfs_block_t i;
        lfs_block_t ack;
        uint32_t *buffer;
    } free;

    const struct lfs_config *cfg;
    lfs_size_t name_max;
    lfs_size_t file_max;
    lfs_size_t attr_max;

#ifdef LFS_MIGRATE
    struct lfs1 *lfs1;
#endif
} lfs_t;

結構體lfs_file_t、lfs_dir_t分別是littlefs的檔案和目錄型別結構體，暫不需要關心成員變數細節，知道結構體的用途即可。

// littlefs directory type
typedef struct lfs_dir {
    struct lfs_dir *next;
    uint16_t id;
    uint8_t type;
    lfs_mdir_t m;

    lfs_off_t pos;
    lfs_block_t head[2];
} lfs_dir_t;

// littlefs file type
typedef struct lfs_file {
    struct lfs_file *next;
    uint16_t id;
    uint8_t type;
    lfs_mdir_t m;

    struct lfs_ctz {
        lfs_block_t head;
        lfs_size_t size;
    } ctz;

    uint32_t flags;
    lfs_off_t pos;
    lfs_block_t block;
    lfs_off_t off;
    lfs_cache_t cache;

    const struct lfs_file_config *cfg;
} lfs_file_t;

結構體lfs_config用於提供初始化littlefs檔案系統的一些配置。其中.read，.prog，.erase，.sync分別對應該硬體平臺上的底層的讀寫\擦除\同步等介面。

read_size 每次讀取的位元組數，可以比物理讀單元大以改善效能，這個數值決定了讀快取的大小，但值太大會帶來更多的記憶體消耗。
prog_size 每次寫入的位元組數，可以比物理寫單元大以改善效能，這個數值決定了寫快取的大小，必須是read_size的整數倍，但值太大會帶來更多的記憶體消耗。
block_size 每個擦除塊的位元組數，可以比物理擦除單元大，但此數值應儘可能小因為每個檔案至少會佔用一個塊。必須是prog_size的整數倍。
block_count 可以被擦除的塊數量，這取決於塊裝置的容量及擦除塊的大小。

// Configuration provided during initialization of the littlefs
struct lfs_config {
    // Opaque user provided context that can be used to pass
    // information to the block device operations
    void *context;

    int (*read)(const struct lfs_config *c, lfs_block_t block,
            lfs_off_t off, void *buffer, lfs_size_t size);
    int (*prog)(const struct lfs_config *c, lfs_block_t block,
            lfs_off_t off, const void *buffer, lfs_size_t size);
    int (*erase)(const struct lfs_config *c, lfs_block_t block);
    int (*sync)(const struct lfs_config *c);

#ifdef LFS_THREADSAFE
    int (*lock)(const struct lfs_config *c);
    int (*unlock)(const struct lfs_config *c);
#endif

    lfs_size_t read_size;
    lfs_size_t prog_size;
    lfs_size_t block_size;
    lfs_size_t block_count;

    int32_t block_cycles;
    lfs_size_t cache_size;
    lfs_size_t lookahead_size;
    void *read_buffer;
    void *prog_buffer;
    void *lookahead_buffer;
    lfs_size_t name_max;
    lfs_size_t file_max;
    lfs_size_t attr_max;
    lfs_size_t metadata_max;
};

結構體lfs_info用於維護檔案資訊，包含檔案型別，大小和檔名資訊。

// File info structure
struct lfs_info {
    // Type of the file, either LFS_TYPE_REG or LFS_TYPE_DIR
    uint8_t type;

    // Size of the file, only valid for REG files. Limited to 32-bits.
    lfs_size_t size;

    // Name of the file stored as a null-terminated string. Limited to
    // LFS_NAME_MAX+1, which can be changed by redefining LFS_NAME_MAX to
    // reduce RAM. LFS_NAME_MAX is stored in superblock and must be
    // respected by other littlefs drivers.
    char name[LFS_NAME_MAX+1];
};

1.2 LiteOS-M LittleFS的結構體

我們來看下在檔案components\fs\littlefs\lfs_api.h裡定義的幾個結構體。結構體LittleFsHandleStruct維護檔案相關的資訊，該結構體的成員包含是否使用，檔案路徑和lfs檔案系統型別結構體lfs_t *lfsHandle和檔案型別結構體lfs_file_t file。類似的，結構體FileDirInfo維護目錄相關的資訊，該結構體成員包含包含是否使用，目錄名稱和lfs檔案系統型別結構體lfs_t *lfsHandle和目錄型別結構體lfs_dir_t dir。另外一個結構體FileOpInfo維護檔案操作資訊。

typedef struct {
    uint8_t useFlag;
    const char *pathName;
    lfs_t *lfsHandle;
    lfs_file_t file;
} LittleFsHandleStruct;

struct FileOpInfo {
    uint8_t useFlag;
    const struct FileOps *fsVops;
    char *dirName;
    lfs_t lfsInfo;
};

typedef struct {
    uint8_t useFlag;
    char *dirName;
    lfs_t *lfsHandle;
    lfs_dir_t dir;
} FileDirInfo;

2、LiteOS-M LittleFS的重要全域性變數及操作

瞭解下檔案components\fs\littlefs\lfs_api.c定義的常用全域性變數。⑴處的g_lfsDir陣列維護目錄資訊，預設支援的目錄數目為LFS_MAX_OPEN_DIRS，等於10。⑵處的g_fsOp陣列維護針對每個掛載點的檔案操作資訊，預設掛載點數目LOSCFG_LFS_MAX_MOUNT_SIZE為3個。⑶處的g_handle陣列維護檔案資訊，預設支援檔案的數量LITTLE_FS_MAX_OPEN_FILES為100個。⑷處開始的struct dirent g_nameValue是目錄項結構體變數，用於函式LfsReaddir()；pthread_mutex_t g_FslocalMutex是互斥鎖變數；g_littlefsMntName是掛載點名稱陣列。⑸處開始的掛載操作變數g_lfsMnt、檔案操作操作全域性變數g_lfsFops在虛擬檔案系統中被使用。

⑴  FileDirInfo g_lfsDir[LFS_MAX_OPEN_DIRS] = {0};

⑵  struct FileOpInfo g_fsOp[LOSCFG_LFS_MAX_MOUNT_SIZE] = {0};
⑶  static LittleFsHandleStruct g_handle[LITTLE_FS_MAX_OPEN_FILES] = {0};
⑷  struct dirent g_nameValue;
    static pthread_mutex_t g_FslocalMutex = PTHREAD_MUTEX_INITIALIZER;
    static const char *g_littlefsMntName[LOSCFG_LFS_MAX_MOUNT_SIZE] = {"/a", "/b", "/c"};
    ......
⑸  const struct MountOps g_lfsMnt = {
        .Mount = LfsMount,
        .Umount = LfsUmount,
    };

    const struct FileOps g_lfsFops = {
        .Mkdir = LfsMkdir,
        .Unlink = LfsUnlink,
        .Rmdir = LfsRmdir,
        .Opendir = LfsOpendir,
        .Readdir = LfsReaddir,
        .Closedir = LfsClosedir,
        .Open = LfsOpen,
        .Close = LfsClose,
        .Write = LfsWrite,
        .Read = LfsRead,
        .Seek = LfsSeek,
        .Rename = LfsRename,
        .Getattr = LfsStat,
        .Fsync = LfsFsync,
        .Fstat = LfsFstat,
    };

下文繼續介紹下和這些變數相關的內部操作介面。

2.1 目錄資訊陣列操作

GetFreeDir()設定目錄資訊陣列元素資訊。引數dirName為目錄名稱。遍歷目錄資訊陣列，遍歷到第一個未使用的元素標記其為已使用狀態，設定目錄名稱，返回目錄資訊元素指標地址。如果遍歷失敗，返回NULL。函式FreeDirInfo()為函式GetFreeDir()的反向操作，根據目錄名稱設定對應的陣列元素為未使用狀態，並把GetFreeDir設定為NULL。

函式CheckDirIsOpen()用於檢測目錄是否已經開啟。如果目錄資訊陣列中記錄著對應的目錄資訊，則標誌著該目錄已經開啟。

FileDirInfo *GetFreeDir(const char *dirName)
{
    pthread_mutex_lock(&g_FslocalMutex);
    for (int i = 0; i < LFS_MAX_OPEN_DIRS; i++) {
        if (g_lfsDir[i].useFlag == 0) {
            g_lfsDir[i].useFlag = 1;
            g_lfsDir[i].dirName = strdup(dirName);
            pthread_mutex_unlock(&g_FslocalMutex);
            return &(g_lfsDir[i]);
        }
    }
    pthread_mutex_unlock(&g_FslocalMutex);
    return NULL;
}

void FreeDirInfo(const char *dirName)
{
    pthread_mutex_lock(&g_FslocalMutex);
    for (int i = 0; i < LFS_MAX_OPEN_DIRS; i++) {
        if (g_lfsDir[i].useFlag == 1 && strcmp(g_lfsDir[i].dirName, dirName) == 0) {
            g_lfsDir[i].useFlag = 0;
            if (g_lfsDir[i].dirName) {
                free(g_lfsDir[i].dirName);
                g_lfsDir[i].dirName = NULL;
            }
            pthread_mutex_unlock(&g_FslocalMutex);
        }
    }
    pthread_mutex_unlock(&g_FslocalMutex);
}

BOOL CheckDirIsOpen(const char *dirName)
{
    pthread_mutex_lock(&g_FslocalMutex);
    for (int i = 0; i < LFS_MAX_OPEN_DIRS; i++) {
        if (g_lfsDir[i].useFlag == 1) {
            if (strcmp(g_lfsDir[i].dirName, dirName) == 0) {
                pthread_mutex_unlock(&g_FslocalMutex);
                return TRUE;
            }
        }
    }
    pthread_mutex_unlock(&g_FslocalMutex);
    return FALSE;
}

2.2 檔案資訊陣列操作

函式LfsAllocFd()設定檔案資訊陣列元素資訊。引數fileName為檔案路徑資訊，傳出引數fd為檔案描述符即陣列索引。遍歷檔案資訊陣列，遍歷到第一個未使用的元素標記其為已使用狀態，設定檔案路徑資訊，把陣列索引賦值給檔案描述符fd，返回檔案資訊元素指標地址。如果遍歷失敗，返回NULL。函式LfsFreeFd()為函式LfsAllocFd()的反向操作，根據檔案描述符設定對應的陣列元素為未使用狀態，並把路徑資訊等設定為NULL。

函式CheckFileIsOpen()用於檢測檔案是否已經開啟，檔案如果開啟過，則表示獲取過該檔案的檔案描述符，根據對應的fd檔案描述符，可以對檔案進行更多的操作。如果檔案資訊陣列中記錄著對應的檔案路徑資訊，則標誌著該檔案已經開啟。函式LfsFdIsValid()用於判斷檔案描述符是否有效。

LittleFsHandleStruct *LfsAllocFd(const char *fileName, int *fd)
{
    pthread_mutex_lock(&g_FslocalMutex);
    for (int i = 0; i < LITTLE_FS_MAX_OPEN_FILES; i++) {
        if (g_handle[i].useFlag == 0) {
            *fd = i;
            g_handle[i].useFlag = 1;
            g_handle[i].pathName = strdup(fileName);
            pthread_mutex_unlock(&g_FslocalMutex);
            return &(g_handle[i]);
        }
    }
    pthread_mutex_unlock(&g_FslocalMutex);
    *fd = INVALID_FD;
    return NULL;
}

static void LfsFreeFd(int fd)
{
    pthread_mutex_lock(&g_FslocalMutex);
    g_handle[fd].useFlag = 0;
    if (g_handle[fd].pathName != NULL) {
        free((void *)g_handle[fd].pathName);
        g_handle[fd].pathName = NULL;
    }

    if (g_handle[fd].lfsHandle != NULL) {
        g_handle[fd].lfsHandle = NULL;
    }
    pthread_mutex_unlock(&g_FslocalMutex);
}

BOOL CheckFileIsOpen(const char *fileName)
{
    pthread_mutex_lock(&g_FslocalMutex);
    for (int i = 0; i < LITTLE_FS_MAX_OPEN_FILES; i++) {
        if (g_handle[i].useFlag == 1) {
            if (strcmp(g_handle[i].pathName, fileName) == 0) {
                pthread_mutex_unlock(&g_FslocalMutex);
                return TRUE;
            }
        }
    }
    pthread_mutex_unlock(&g_FslocalMutex);
    return FALSE;
}

static BOOL LfsFdIsValid(int fd)
{
    if (fd >= LITTLE_FS_MAX_OPEN_FILES || fd < 0) {
        return FALSE;
    }
    if (g_handle[fd].lfsHandle == NULL) {
        return FALSE;
    }
    return TRUE;
}

2.3 掛載點檔案操作資訊相關操作

函式AllocMountRes()用於設定掛載點檔案操作資訊。引數target為掛載點名稱，引數fileOps為檔案操作資訊。遍歷每個掛載點，如果遍歷到的掛載點未使用，並且掛載點名稱相等，則設定其使用標記為已使用，設定目錄名稱，設定檔案操作資訊，然後返回檔案操作資訊指標。如果沒有遍歷到，返回NULL。掛載點陣列g_littlefsMntName的元素預設為/a,/b,/c等，可以使用函式SetDefaultMountPath()設定指定位置的掛載點名稱。

struct FileOpInfo *AllocMountRes(const char* target, const struct FileOps *fileOps)
{
    pthread_mutex_lock(&g_FslocalMutex);
    for (int i = 0; i < LOSCFG_LFS_MAX_MOUNT_SIZE; i++) {
        if (g_fsOp[i].useFlag == 0 && strcmp(target, g_littlefsMntName[i]) == 0) {
            g_fsOp[i].useFlag = 1;
            g_fsOp[i].fsVops = fileOps;
            g_fsOp[i].dirName = strdup(target);
            pthread_mutex_unlock(&g_FslocalMutex);
            return &(g_fsOp[i]);
        }
    }

    pthread_mutex_unlock(&g_FslocalMutex);
    return NULL;
}

int SetDefaultMountPath(int pathNameIndex, const char* target)
{
    if (pathNameIndex >= LOSCFG_LFS_MAX_MOUNT_SIZE) {
        return VFS_ERROR;
    }

    pthread_mutex_lock(&g_FslocalMutex);
    g_littlefsMntName[pathNameIndex] = strdup(target);
    pthread_mutex_unlock(&g_FslocalMutex);
    return VFS_OK;
}

函式GetMountRes()用於獲取給定掛載點在掛載點檔案操作資訊陣列中的索引值。引數target為掛載點名稱，引數mountIndex用於輸出檔案操作資訊陣列索引值。遍歷每個掛載點，如果遍歷到的掛載點已使用，並且掛載點名稱相等，則返回相應的陣列索引，否則返回NULL。

struct FileOpInfo *GetMountRes(const char *target, int *mountIndex)
{
    pthread_mutex_lock(&g_FslocalMutex);
    for (int i = 0; i < LOSCFG_LFS_MAX_MOUNT_SIZE; i++) {
        if (g_fsOp[i].useFlag == 1) {
            if (g_fsOp[i].dirName && strcmp(target, g_fsOp[i].dirName) == 0) {
                *mountIndex = i;
                pthread_mutex_unlock(&g_FslocalMutex);
                return &(g_fsOp[i]);
            }
        }
    }

    pthread_mutex_unlock(&g_FslocalMutex);
    return NULL;
}

函式FreeMountResByIndex()屬於函式AllocMountRes()的反向操作，用於釋放掛載點檔案操作資訊。傳入引數mountIndex對應的檔案操作資訊標記為未使用狀態，釋放掛載點名稱佔用的記憶體。函式FreeMountRes()實現的功能一樣，傳入引數為掛載點名稱。遍歷每一個掛載點，如果存在和傳入引數相同的掛載點，則進行釋放。

int FreeMountResByIndex(int mountIndex)
{
    if (mountIndex < 0 || mountIndex >= LOSCFG_LFS_MAX_MOUNT_SIZE) {
        return VFS_ERROR;
    }

    pthread_mutex_lock(&g_FslocalMutex);
    if (g_fsOp[mountIndex].useFlag == 1 && g_fsOp[mountIndex].dirName != NULL) {
        g_fsOp[mountIndex].useFlag = 0;
        free(g_fsOp[mountIndex].dirName);
        g_fsOp[mountIndex].dirName = NULL;
    }
    pthread_mutex_unlock(&g_FslocalMutex);

    return VFS_OK;
}

int FreeMountRes(const char *target)
{
    pthread_mutex_lock(&g_FslocalMutex);
    for (int i = 0; i < LOSCFG_LFS_MAX_MOUNT_SIZE; i++) {
        if (g_fsOp[i].useFlag == 1) {
            if (g_fsOp[i].dirName && strcmp(target, g_fsOp[i].dirName) == 0) {
                g_fsOp[i].useFlag = 0;
                free(g_fsOp[i].dirName);
                g_fsOp[i].dirName = NULL;
                pthread_mutex_unlock(&g_FslocalMutex);
                return VFS_OK;
            }
        }
    }

    pthread_mutex_unlock(&g_FslocalMutex);
    return VFS_ERROR;
}

2.4 路徑是否已掛載CheckPathIsMounted

函式CheckPathIsMounted()用於檢查給定的路徑是否已經掛載，如果掛載上把對應掛載點的檔案操作資訊由引數struct FileOpInfo **fileOpInfo輸出。⑴處先獲取路徑的第一級目錄的長度。⑵處遍歷每一個掛載點的檔案運算元組，如果檔案操作處於使用狀態，則執行⑶比對相應的掛載點名稱和路徑的第一級目錄名稱是否相等。如果相等，則輸出檔案操作資訊，並返回TRUE。否則返回FALSE。

int GetFirstLevelPathLen(const char *pathName)
{
    int len = 1;
    for (int i = 1; i < strlen(pathName) + 1; i++) {
        if (pathName[i] == '/') {
            break;
        }
        len++;
    }

    return len;
}

BOOL CheckPathIsMounted(const char *pathName, struct FileOpInfo **fileOpInfo)
{
    char tmpName[LITTLEFS_MAX_LFN_LEN] = {0};
⑴  int len = GetFirstLevelPathLen(pathName);

    pthread_mutex_lock(&g_FslocalMutex);
    for (int i = 0; i < LOSCFG_LFS_MAX_MOUNT_SIZE; i++) {
⑵      if (g_fsOp[i].useFlag == 1) {
            (void)strncpy_s(tmpName, LITTLEFS_MAX_LFN_LEN, pathName, len);
⑶          if (strcmp(tmpName, g_fsOp[i].dirName) == 0) {
                *fileOpInfo = &(g_fsOp[i]);
                pthread_mutex_unlock(&g_FslocalMutex);
                return TRUE;
            }
        }
    }
    pthread_mutex_unlock(&g_FslocalMutex);
    return FALSE;
}

3、LiteOS-M LittleFS的檔案系統操作介面

快速記錄下各個操作介面，對每個介面的用途用法不再描述。可以參考之前的系列文章，《鴻蒙輕核心M核原始碼分析系列十九 Musl LibC》中介紹了相關的介面，那些介面會呼叫VFS檔案系統中操作介面，然後進一步呼叫LFS檔案操作介面。

3.1 掛載LfsMount和解除安裝LfsUmounts操作

掛載解除安裝操作包含LfsMount、LfsUmounts等2個操作。對於函式LfsMount()，需要注意下引數const void *data，這個需要是struct lfs_config指標型別變數。⑴處在掛載檔案系統之前，對輸入引數進行檢測。⑵處判斷是否已經掛載，不允許重複掛載。⑶處設定掛載點資訊，⑷處呼叫LFS的函式實現掛載，如果掛載失敗，則執行⑸嘗試格式化，然後重新掛載。

對於函式LfsUmount()，⑹處根據掛載點獲取檔案操作資訊和掛載點索引值。⑺處呼叫LFS函式實現解除安裝，然後執行⑻釋放掛載點檔案操作資訊。

int LfsMount(const char *source, const char *target, const char *fileSystemType, unsigned long mountflags,
    const void *data)
{
    int ret;
    struct FileOpInfo *fileOpInfo = NULL;

⑴  if (target == NULL || fileSystemType == NULL || data == NULL) {
        errno = EFAULT;
        ret = VFS_ERROR;
        goto errout;
    }

    if (strcmp(fileSystemType, "littlefs") != 0) {
        errno = ENODEV;
        ret = VFS_ERROR;
        goto errout;
    }

⑵  if (CheckPathIsMounted(target, &fileOpInfo)) {
        errno = EBUSY;
        ret = VFS_ERROR;
        goto errout;
    }

    // select free mount resource
⑶  fileOpInfo = AllocMountRes(target, &g_lfsFops);
    if (fileOpInfo == NULL) {
        errno = ENODEV;
        ret = VFS_ERROR;
        goto errout;
    }

⑷  ret = lfs_mount(&(fileOpInfo->lfsInfo), (struct lfs_config*)data);
    if (ret != 0) {
⑸      ret = lfs_format(&(fileOpInfo->lfsInfo), (struct lfs_config*)data);
        if (ret == 0) {
            ret = lfs_mount(&(fileOpInfo->lfsInfo), (struct lfs_config*)data);
        }
    }

    if (ret != 0) {
        errno = LittlefsErrno(ret);
        ret = VFS_ERROR;
    }

errout:
    return ret;
}

int LfsUmount(const char *target)
{
    int ret;
    int mountIndex = -1;
    struct FileOpInfo *fileOpInfo = NULL;

    if (target == NULL) {
        errno = EFAULT;
        return VFS_ERROR;
    }

⑹  fileOpInfo = GetMountRes(target, &mountIndex);
    if (fileOpInfo == NULL) {
        errno = ENOENT;
        return VFS_ERROR;
    }

⑺  ret = lfs_unmount(&(fileOpInfo->lfsInfo));
    if (ret != 0) {
        errno = LittlefsErrno(ret);
        ret = VFS_ERROR;
    }

⑻  (void)FreeMountResByIndex(mountIndex);
    return ret;
}

3.2 檔案目錄操作介面

檔案目錄操作介面包含LfsMkdir、LfsUnlink、LfsRmdir、LfsReaddir、LfsClosedir、LfsOpen、LfsClose等等，會進一步呼叫LFS的檔案目錄操作介面進行封裝，程式碼比較簡單，自行閱讀即可，部分程式碼片段如下。

......
int LfsUnlink(const char *fileName)
{
    int ret;
    struct FileOpInfo *fileOpInfo = NULL;

    if (fileName == NULL) {
        errno = EFAULT;
        return VFS_ERROR;
    }

    if (CheckPathIsMounted(fileName, &fileOpInfo) == FALSE || fileOpInfo == NULL) {
        errno = ENOENT;
        return VFS_ERROR;
    }

    ret = lfs_remove(&(fileOpInfo->lfsInfo), fileName);
    if (ret != 0) {
        errno = LittlefsErrno(ret);
        ret = VFS_ERROR;
    }

    return ret;
}

int LfsMkdir(const char *dirName, mode_t mode)
{
    int ret;
    struct FileOpInfo *fileOpInfo = NULL;

    if (dirName == NULL) {
        errno = EFAULT;
        return VFS_ERROR;
    }

    if (CheckPathIsMounted(dirName, &fileOpInfo) == FALSE || fileOpInfo == NULL) {
        errno = ENOENT;
        return VFS_ERROR;
    }

    ret = lfs_mkdir(&(fileOpInfo->lfsInfo), dirName);
    if (ret != 0) {
        errno = LittlefsErrno(ret);
        ret = VFS_ERROR;
    }

    return ret;
}
......

參考資料

HarmonyOS Device>文件指南>基礎能力-LittleFS

點選關注，第一時間瞭解華為雲新鮮技術~

鴻蒙輕核心原始碼分析：Newlib C
2022-01-25
鴻蒙原始碼
鴻蒙輕核心原始碼分析：虛實對映
2021-11-26
鴻蒙原始碼
鴻蒙輕核心原始碼分析：虛擬記憶體
2021-11-12
鴻蒙原始碼記憶體
鴻蒙輕核心M核原始碼分析：LibC實現之Musl LibC
2022-01-24
鴻蒙原始碼
掌握鴻蒙輕核心靜態記憶體的使用，從原始碼分析開始
2021-06-21
鴻蒙記憶體原始碼
鴻蒙OS的系統呼叫是如何實現的？ | 解讀鴻蒙原始碼
2020-11-25
鴻蒙原始碼
鴻蒙系統系列教程6-鴻蒙系統專案結構解析
2021-07-14
鴻蒙
逐行分析鴻蒙系統的 JavaScript 框架
2020-09-15
鴻蒙JavaScript框架
華為鴻蒙系統HarmonyOS學習之十：鴻蒙HarmonyOS微核心技術
2020-10-27
鴻蒙
鴻蒙核心原始碼分析(雙向連結串列篇) | 誰是核心最重要結構體 ?
2021-01-19
鴻蒙原始碼結構體
【核心檔案系統】原始碼閱讀stat.h
2020-12-14
原始碼
帶你熟悉鴻蒙輕核心Kconfig使用指南
2021-12-28
鴻蒙
鴻蒙原始碼目錄整理
2020-10-26
鴻蒙原始碼
鴻蒙系統系列教程1-鴻蒙系統的發展史
2021-07-05
鴻蒙
鴻蒙系統嚐鮮
2021-01-14
鴻蒙
鴻蒙系統系列教程2-鴻蒙OS系統分散式操作講解
2021-07-06
鴻蒙分散式
PHP檔案分享系統原始碼
2021-12-08
PHP原始碼
LiteOS-A核心中的procfs檔案系統分析
2022-12-08
鴻蒙輕核心M核的故障管家：Fault異常處理
2021-10-29
鴻蒙
鴻蒙系統什麼時候能用鴻蒙系統有什麼特別之處
2021-06-04
鴻蒙
鴻蒙系統和安卓的區別鴻蒙系統是基於安卓嗎
2021-06-04
鴻蒙安卓
鴻蒙作業系統特點
2024-03-02
鴻蒙作業系統
鴻蒙系統中Intent的使用
2020-11-17
鴻蒙Intent
鴻蒙系統freeModbusTcp移植簡介
2020-11-23
鴻蒙TCP
鴻蒙系統系列教程5-鴻蒙開發環境的搭建
2021-07-09
鴻蒙開發環境
MPU：鴻蒙輕核心的任務棧的溢位檢察官
2021-10-05
鴻蒙
萬字解讀鴻蒙輕核心實體記憶體模組
2021-11-05
鴻蒙記憶體
鴻蒙移植樹莓派（下）修改原始碼
2021-01-22
鴻蒙樹莓派原始碼
Hadoop3.2.1 【 HDFS 】原始碼分析 : 檔案系統資料集 [一]
2020-11-10
Hadoop原始碼
ext2檔案系統super.c原始碼分析（Linux 2.6.24）
2020-11-10
原始碼Linux
Abp原始碼分析之虛擬檔案系統Volo.Abp.VirtualFileSystem
2024-11-12
原始碼
鴻蒙系統超級終端怎麼使用？鴻蒙系統超級終端開啟教程
2021-12-09
鴻蒙
鴻蒙系統系列教程3-鴻蒙OS的技術特徵講解
2021-07-06
鴻蒙特徵
Linux無系統核心原始碼
2020-10-30
Linux原始碼
鴻蒙系統學習路線和專案實戰分享！
2021-09-16
鴻蒙
解讀鴻蒙輕核心的監控器：異常鉤子函式
2021-10-14
鴻蒙函式
線上直播系統原始碼，前後端大檔案上傳程式碼分析
2024-04-13
原始碼後端
華為鴻蒙系統怎麼補電？華為鴻蒙系統手機補電的操作方法
2021-12-09
鴻蒙