mirror of
https://github.com/espressif/esp-idf.git
synced 2026-05-30 01:26:31 +03:00
128 lines
4.0 KiB
C
128 lines
4.0 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2015-2025 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
#include "sdkconfig.h"
|
|
#include "esp_vfs.h"
|
|
#include <stddef.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#if CONFIG_VFS_SELECT_IN_RAM
|
|
#define VFS_MALLOC_FLAGS (MALLOC_CAP_INTERNAL | MALLOC_CAP_8BIT)
|
|
#else
|
|
#define VFS_MALLOC_FLAGS MALLOC_CAP_DEFAULT
|
|
#endif
|
|
|
|
#ifdef CONFIG_IDF_TARGET_LINUX
|
|
typedef uint16_t local_fd_t;
|
|
#else
|
|
typedef uint8_t local_fd_t;
|
|
#endif
|
|
|
|
typedef int8_t vfs_index_t;
|
|
|
|
typedef struct vfs_entry_ {
|
|
int flags; /*!< ESP_VFS_FLAG_CONTEXT_PTR and/or ESP_VFS_FLAG_READONLY_FS or ESP_VFS_FLAG_DEFAULT */
|
|
const esp_vfs_fs_ops_t *vfs; /*!< contains pointers to VFS functions */
|
|
void *ctx; /*!< optional pointer which can be passed to VFS */
|
|
int offset; /*!< index of this structure in s_vfs array */
|
|
size_t path_prefix_len; /*!< micro-optimization to avoid doing extra strlen, contains length of the string, not the size of path_prefix array */
|
|
const char path_prefix[]; /*!< path prefix mapped to this VFS */
|
|
} vfs_entry_t;
|
|
|
|
typedef struct {
|
|
bool permanent :1;
|
|
bool has_pending_close :1;
|
|
bool has_pending_select :1;
|
|
uint8_t _reserved :5;
|
|
vfs_index_t vfs_index;
|
|
local_fd_t local_fd;
|
|
} fd_table_t;
|
|
|
|
typedef struct {
|
|
bool isset; // none or at least one bit is set in the following 3 fd sets
|
|
fd_set readfds;
|
|
fd_set writefds;
|
|
fd_set errorfds;
|
|
} fds_triple_t;
|
|
|
|
/**
|
|
* Register a virtual filesystem.
|
|
*
|
|
* @param base_path file path prefix associated with the filesystem.
|
|
* Must be a zero-terminated C string, may be empty.
|
|
* If not empty, must be up to ESP_VFS_PATH_MAX
|
|
* characters long, and at least 2 characters long.
|
|
* Name must start with a "/" and must not end with "/".
|
|
* For example, "/data" or "/dev/spi" are valid.
|
|
* These VFSes would then be called to handle file paths such as
|
|
* "/data/myfile.txt" or "/dev/spi/0".
|
|
* In the special case of an empty base_path, a "fallback"
|
|
* VFS is registered. Such VFS will handle paths which are not
|
|
* matched by any other registered VFS.
|
|
* @param len Length of the base_path.
|
|
* @param vfs Pointer to esp_vfs_t, a structure which maps syscalls to
|
|
* the filesystem driver functions. VFS component doesn't
|
|
* assume ownership of this pointer.
|
|
* @param ctx If vfs->flags has ESP_VFS_FLAG_CONTEXT_PTR set, a pointer
|
|
* which should be passed to VFS functions. Otherwise, NULL.
|
|
* @param vfs_index Index for getting the vfs content.
|
|
*
|
|
* @return ESP_OK if successful.
|
|
* ESP_ERR_NO_MEM if too many VFSes are registered.
|
|
* ESP_ERR_INVALID_ARG if given an invalid parameter.
|
|
*/
|
|
esp_err_t esp_vfs_register_common(const char *base_path, size_t len, const esp_vfs_t *vfs, void *ctx, int *vfs_index);
|
|
|
|
/**
|
|
* Get vfs fd with given path.
|
|
*
|
|
* @param path file path prefix associated with the filesystem.
|
|
*
|
|
* @return Pointer to the `vfs_entry_t` corresponding to the given path, which cannot be NULL.
|
|
*/
|
|
const vfs_entry_t *get_vfs_for_path(const char *path);
|
|
|
|
/**
|
|
* Get vfs fd with given vfs index.
|
|
*
|
|
* @param index VFS index.
|
|
*
|
|
* @return Pointer to the `vfs_entry_t` corresponding to the given path, which cannot be NULL.
|
|
*/
|
|
const vfs_entry_t *get_vfs_for_index(int index);
|
|
|
|
const char* translate_path(const vfs_entry_t* vfs, const char* src_path);
|
|
|
|
const vfs_entry_t* get_vfs_for_path(const char* path);
|
|
|
|
const vfs_entry_t *get_vfs_for_fd(int fd);
|
|
|
|
int register_fd(int vfs_index, int local_fd, bool permanent);
|
|
|
|
void unregister_fd(int fd);
|
|
|
|
int get_local_fd(const vfs_entry_t *vfs, int fd);
|
|
|
|
const fd_table_t *get_fd_entry(int fd);
|
|
|
|
size_t get_vfs_count(void);
|
|
|
|
void close_pending(int nfds);
|
|
|
|
static inline bool esp_vfs_safe_fd_isset(int fd, const fd_set *fds)
|
|
{
|
|
return fds && FD_ISSET(fd, fds);
|
|
}
|
|
|
|
fd_table_t start_select(int fd, fd_set *errorfds);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|