Zephyr Project API 3.7.0
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
fs.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2016 Intel Corporation.
3 * Copyright (c) 2020-2024 Nordic Semiconductor ASA
4 *
5 * SPDX-License-Identifier: Apache-2.0
6 */
7
8#ifndef ZEPHYR_INCLUDE_FS_FS_H_
9#define ZEPHYR_INCLUDE_FS_FS_H_
10
11#include <sys/types.h>
12
13#include <zephyr/sys/dlist.h>
15
16#ifdef __cplusplus
17extern "C" {
18#endif
19
28struct fs_file_system_t;
29
39
54enum {
57
60
63
66};
67
69#define FS_MOUNT_FLAG_NO_FORMAT BIT(0)
71#define FS_MOUNT_FLAG_READ_ONLY BIT(1)
77#define FS_MOUNT_FLAG_AUTOMOUNT BIT(2)
86#define FS_MOUNT_FLAG_USE_DISK_ACCESS BIT(3)
87
91struct fs_mount_t {
95 int type;
97 const char *mnt_point;
99 void *fs_data;
102 /* The following fields are filled by file system core */
106 const struct fs_file_system_t *fs;
109};
110
117struct fs_dirent {
125 size_t size;
126};
127
136 unsigned long f_bsize;
138 unsigned long f_frsize;
140 unsigned long f_blocks;
142 unsigned long f_bfree;
143};
144
145
151#define FS_O_READ 0x01
153#define FS_O_WRITE 0x02
155#define FS_O_RDWR (FS_O_READ | FS_O_WRITE)
157#define FS_O_MODE_MASK 0x03
158
160#define FS_O_CREATE 0x10
162#define FS_O_APPEND 0x20
164#define FS_O_TRUNC 0x40
166#define FS_O_FLAGS_MASK 0x70
167
168
170#define FS_O_MASK (FS_O_MODE_MASK | FS_O_FLAGS_MASK)
179#ifndef FS_SEEK_SET
181#define FS_SEEK_SET 0
182#endif
183#ifndef FS_SEEK_CUR
185#define FS_SEEK_CUR 1
186#endif
187#ifndef FS_SEEK_END
189#define FS_SEEK_END 2
190#endif
203#define FSTAB_ENTRY_DT_MOUNT_FLAGS(node_id) \
204 ((DT_PROP(node_id, automount) ? FS_MOUNT_FLAG_AUTOMOUNT : 0) \
205 | (DT_PROP(node_id, read_only) ? FS_MOUNT_FLAG_READ_ONLY : 0) \
206 | (DT_PROP(node_id, no_format) ? FS_MOUNT_FLAG_NO_FORMAT : 0) \
207 | (DT_PROP(node_id, disk_access) ? FS_MOUNT_FLAG_USE_DISK_ACCESS : 0))
208
215#define FS_FSTAB_ENTRY(node_id) _CONCAT(z_fsmp_, node_id)
216
225#define FS_FSTAB_DECLARE_ENTRY(node_id) \
226 extern struct fs_mount_t FS_FSTAB_ENTRY(node_id)
227
237static inline void fs_file_t_init(struct fs_file_t *zfp)
238{
239 zfp->filep = NULL;
240 zfp->mp = NULL;
241 zfp->flags = 0;
242}
243
253static inline void fs_dir_t_init(struct fs_dir_t *zdp)
254{
255 zdp->dirp = NULL;
256 zdp->mp = NULL;
257}
258
294int fs_open(struct fs_file_t *zfp, const char *file_name, fs_mode_t flags);
295
307int fs_close(struct fs_file_t *zfp);
308
323int fs_unlink(const char *path);
324
350int fs_rename(const char *from, const char *to);
351
368ssize_t fs_read(struct fs_file_t *zfp, void *ptr, size_t size);
369
389ssize_t fs_write(struct fs_file_t *zfp, const void *ptr, size_t size);
390
409int fs_seek(struct fs_file_t *zfp, off_t offset, int whence);
410
426
447int fs_truncate(struct fs_file_t *zfp, off_t length);
448
465int fs_sync(struct fs_file_t *zfp);
466
481int fs_mkdir(const char *path);
482
497int fs_opendir(struct fs_dir_t *zdp, const char *path);
498
518int fs_readdir(struct fs_dir_t *zdp, struct fs_dirent *entry);
519
531int fs_closedir(struct fs_dir_t *zdp);
532
560int fs_mount(struct fs_mount_t *mp);
561
576int fs_unmount(struct fs_mount_t *mp);
577
593int fs_readmount(int *index, const char **name);
594
611int fs_stat(const char *path, struct fs_dirent *entry);
612
627int fs_statvfs(const char *path, struct fs_statvfs *stat);
628
640int fs_mkfs(int fs_type, uintptr_t dev_id, void *cfg, int flags);
641
657int fs_register(int type, const struct fs_file_system_t *fs);
658
670int fs_unregister(int type, const struct fs_file_system_t *fs);
671
677#ifdef __cplusplus
678}
679#endif
680
681#endif /* ZEPHYR_INCLUDE_FS_FS_H_ */
ZTEST_BMEM int index[(3)]
Definition main.c:32
uint8_t fs_mode_t
Definition fs_interface.h:62
#define MAX_FILE_NAME
Definition fs_interface.h:55
struct _dnode sys_dnode_t
Doubly-linked list node structure.
Definition dlist.h:54
int fs_opendir(struct fs_dir_t *zdp, const char *path)
Directory open.
int fs_unregister(int type, const struct fs_file_system_t *fs)
Unregister a file system.
int fs_mkdir(const char *path)
Directory create.
int fs_rename(const char *from, const char *to)
Rename file or directory.
int fs_mount(struct fs_mount_t *mp)
Mount filesystem.
int fs_close(struct fs_file_t *zfp)
Close file.
off_t fs_tell(struct fs_file_t *zfp)
Get current file position.
fs_dir_entry_type
Enumeration for directory entry types.
Definition fs.h:33
int fs_mkfs(int fs_type, uintptr_t dev_id, void *cfg, int flags)
Create fresh file system.
int fs_seek(struct fs_file_t *zfp, off_t offset, int whence)
Seek file.
int fs_stat(const char *path, struct fs_dirent *entry)
File or directory status.
int fs_register(int type, const struct fs_file_system_t *fs)
Register a file system.
int fs_open(struct fs_file_t *zfp, const char *file_name, fs_mode_t flags)
Open or create file.
ssize_t fs_write(struct fs_file_t *zfp, const void *ptr, size_t size)
Write file.
int fs_closedir(struct fs_dir_t *zdp)
Directory close.
int fs_readmount(int *index, const char **name)
Get path of mount point at index.
int fs_readdir(struct fs_dir_t *zdp, struct fs_dirent *entry)
Directory read entry.
int fs_unlink(const char *path)
Unlink file.
ssize_t fs_read(struct fs_file_t *zfp, void *ptr, size_t size)
Read file.
int fs_unmount(struct fs_mount_t *mp)
Unmount filesystem.
int fs_sync(struct fs_file_t *zfp)
Flush cached write data buffers of an open file.
static void fs_dir_t_init(struct fs_dir_t *zdp)
Initialize fs_dir_t object.
Definition fs.h:253
static void fs_file_t_init(struct fs_file_t *zfp)
Initialize fs_file_t object.
Definition fs.h:237
int fs_truncate(struct fs_file_t *zfp, off_t length)
Truncate or extend an open file to a given size.
@ FS_DIR_ENTRY_DIR
Identifier for directory entry.
Definition fs.h:37
@ FS_DIR_ENTRY_FILE
Identifier for file entry.
Definition fs.h:35
@ FS_EXT2
Identifier for in-tree Ext2 file system.
Definition fs.h:62
@ FS_LITTLEFS
Identifier for in-tree LittleFS file system.
Definition fs.h:59
@ FS_TYPE_EXTERNAL_BASE
Base identifier for external file systems.
Definition fs.h:65
@ FS_FATFS
Identifier for in-tree FatFS file system.
Definition fs.h:56
__SIZE_TYPE__ ssize_t
Definition types.h:28
__INTPTR_TYPE__ off_t
Definition types.h:36
flags
Definition parser.h:96
void * ptr
Definition printk.c:177
__UINT8_TYPE__ uint8_t
Definition stdint.h:88
__UINTPTR_TYPE__ uintptr_t
Definition stdint.h:105
Directory object representing an open directory.
Definition fs_interface.h:90
const struct fs_mount_t * mp
Pointer to mount point structure.
Definition fs_interface.h:94
void * dirp
Pointer to directory object structure.
Definition fs_interface.h:92
Structure to receive file or directory information.
Definition fs.h:117
enum fs_dir_entry_type type
File/directory type (FS_DIR_ENTRY_FILE or FS_DIR_ENTRY_DIR)
Definition fs.h:121
size_t size
Size of file (0 if directory).
Definition fs.h:125
char name[MAX_FILE_NAME+1]
Name of file or directory.
Definition fs.h:123
File System interface structure.
Definition fs_sys.h:22
File object representing an open file.
Definition fs_interface.h:76
fs_mode_t flags
Open/create flags.
Definition fs_interface.h:82
void * filep
Pointer to file object structure.
Definition fs_interface.h:78
const struct fs_mount_t * mp
Pointer to mount point structure.
Definition fs_interface.h:80
File system mount info structure.
Definition fs.h:91
const struct fs_file_system_t * fs
Pointer to File system interface of the mount point.
Definition fs.h:106
const char * mnt_point
Mount point directory name (ex: "/fatfs")
Definition fs.h:97
void * storage_dev
Pointer to backend storage device.
Definition fs.h:101
void * fs_data
Pointer to file system specific data.
Definition fs.h:99
int type
File system type.
Definition fs.h:95
size_t mountp_len
Length of Mount point string.
Definition fs.h:104
uint8_t flags
Mount flags.
Definition fs.h:108
sys_dnode_t node
Entry for the fs_mount_list list.
Definition fs.h:93
Structure to receive volume statistics.
Definition fs.h:134
unsigned long f_bsize
Optimal transfer block size.
Definition fs.h:136
unsigned long f_frsize
Allocation unit size.
Definition fs.h:138
unsigned long f_blocks
Size of FS in f_frsize units.
Definition fs.h:140
unsigned long f_bfree
Number of free blocks.
Definition fs.h:142
Definition stat.h:57