mirror of
https://github.com/cesanta/mongoose.git
synced 2024-12-28 23:49:44 +08:00
51 lines
2.2 KiB
C
51 lines
2.2 KiB
C
#pragma once
|
|
|
|
#include "arch.h"
|
|
#include "config.h"
|
|
|
|
enum { MG_FS_READ = 1, MG_FS_WRITE = 2, MG_FS_DIR = 4 };
|
|
|
|
// Filesystem API functions
|
|
// st() returns MG_FS_* flags and populates file size and modification time
|
|
// ls() calls fn() for every directory entry, allowing to list a directory
|
|
//
|
|
// NOTE: UNIX-style shorthand names for the API functions are deliberately
|
|
// chosen to avoid conflicts with some libraries that make macros for e.g.
|
|
// stat(), write(), read() calls.
|
|
struct mg_fs {
|
|
int (*st)(const char *path, size_t *size, time_t *mtime); // stat file
|
|
void (*ls)(const char *path, void (*fn)(const char *, void *),
|
|
void *); // List directory entries: call fn(file_name, fn_data)
|
|
// for each directory entry
|
|
void *(*op)(const char *path, int flags); // Open file
|
|
void (*cl)(void *fd); // Close file
|
|
size_t (*rd)(void *fd, void *buf, size_t len); // Read file
|
|
size_t (*wr)(void *fd, const void *buf, size_t len); // Write file
|
|
size_t (*sk)(void *fd, size_t offset); // Set file position
|
|
bool (*mv)(const char *from, const char *to); // Rename file
|
|
bool (*rm)(const char *path); // Delete file
|
|
bool (*mkd)(const char *path); // Create directory
|
|
};
|
|
|
|
extern struct mg_fs mg_fs_posix; // POSIX open/close/read/write/seek
|
|
extern struct mg_fs mg_fs_packed; // Packed FS, see examples/device-dashboard
|
|
extern struct mg_fs mg_fs_fat; // FAT FS
|
|
|
|
// File descriptor
|
|
struct mg_fd {
|
|
void *fd;
|
|
struct mg_fs *fs;
|
|
};
|
|
|
|
struct mg_fd *mg_fs_open(struct mg_fs *fs, const char *path, int flags);
|
|
void mg_fs_close(struct mg_fd *fd);
|
|
bool mg_fs_ls(struct mg_fs *fs, const char *path, char *buf, size_t len);
|
|
struct mg_str mg_file_read(struct mg_fs *fs, const char *path);
|
|
bool mg_file_write(struct mg_fs *fs, const char *path, const void *, size_t);
|
|
bool mg_file_printf(struct mg_fs *fs, const char *path, const char *fmt, ...);
|
|
|
|
// Packed API
|
|
const char *mg_unpack(const char *path, size_t *size, time_t *mtime);
|
|
const char *mg_unlist(size_t no); // Get no'th packed filename
|
|
struct mg_str mg_unpacked(const char *path); // Packed file as mg_str
|