diff --git a/lfs.c b/lfs.c index d5c8412..35aff4c 100644 --- a/lfs.c +++ b/lfs.c @@ -4912,377 +4912,541 @@ cleanup: #endif -#if LFS_THREAD_SAFE +#if !LFS_THREADSAFE -int lfs_format_ts(lfs_t *lfs, const struct lfs_config *config) -{ +int lfs_format (lfs_t * lfs, const struct lfs_config * config) { + return lfs_format_raw(lfs, config); +} + +int lfs_mount (lfs_t * lfs, const struct lfs_config * config) { + return lfs_mount_raw(lfs, config); +} + +int lfs_unmount (lfs_t * lfs) { + return lfs_unmount_raw(lfs); +} + +int lfs_remove (lfs_t * lfs, const char * path) { + return lfs_remove_raw(lfs, path); +} + +int lfs_rename (lfs_t * lfs, const char * oldpath, const char * newpath) { + return lfs_rename_raw(lfs, oldpath, newpath); +} + +int lfs_stat (lfs_t * lfs, const char * path, struct lfs_info * info) { + return lfs_stat_raw(lfs, path, info); +} + +lfs_ssize_t lfs_getattr (lfs_t * lfs, const char * path, uint8_t type, void * buffer, lfs_size_t size) { + return lfs_getattr_raw(lfs, path, type, buffer, size); +} + +int lfs_setattr (lfs_t * lfs, const char * path, uint8_t type, const void * buffer, lfs_size_t size) { + return lfs_setattr_raw(lfs, path, type, buffer, size); +} + +int lfs_removeattr (lfs_t * lfs, const char * path, uint8_t type) { + return lfs_removeattr_raw(lfs, path, type); +} + +int lfs_file_open (lfs_t * lfs, lfs_file_t * file, const char * path, int flags) { + return lfs_file_open_raw(lfs, file, path, flags); +} + +int lfs_file_opencfg (lfs_t * lfs, + lfs_file_t * file, + const char * path, + int flags, + const struct lfs_file_config * config) { + return lfs_file_opencfg_raw(lfs, file, path, flags, config); +} + +int lfs_file_close (lfs_t * lfs, lfs_file_t * file) { + return lfs_file_close_raw(lfs, file); +} + +int lfs_file_sync (lfs_t * lfs, lfs_file_t * file) { + return lfs_file_sync_raw(lfs, file); +} + +lfs_ssize_t lfs_file_read (lfs_t * lfs, lfs_file_t * file, void * buffer, lfs_size_t size) { + return lfs_file_read_raw(lfs, file, buffer, size); +} + +lfs_ssize_t lfs_file_write (lfs_t * lfs, lfs_file_t * file, const void * buffer, lfs_size_t size) { + return lfs_file_write_raw(lfs, file, buffer, size); +} + +lfs_soff_t lfs_file_seek (lfs_t * lfs, lfs_file_t * file, lfs_soff_t off, int whence) { + return lfs_file_seek_raw(lfs, file, off, whence); +} + +int lfs_file_truncate (lfs_t * lfs, lfs_file_t * file, lfs_off_t size) { + return lfs_file_truncate_raw(lfs, file, size); +} + +lfs_soff_t lfs_file_tell (lfs_t * lfs, lfs_file_t * file) { + return lfs_file_tell_raw(lfs, file); +} + +int lfs_file_rewind (lfs_t * lfs, lfs_file_t * file) { + return lfs_file_rewind_raw(lfs, file); +} + +lfs_soff_t lfs_file_size (lfs_t * lfs, lfs_file_t * file) { + return lfs_file_size_raw(lfs, file); +} + +int lfs_mkdir (lfs_t * lfs, const char * path) { + return lfs_mkdir_raw(lfs, path); +} + +int lfs_dir_open (lfs_t * lfs, lfs_dir_t * dir, const char * path) { + return lfs_dir_open_raw(lfs, dir, path); +} + +int lfs_dir_close (lfs_t * lfs, lfs_dir_t * dir) { + return lfs_dir_close_raw(lfs, dir); +} + +int lfs_dir_read (lfs_t * lfs, lfs_dir_t * dir, struct lfs_info * info) { + return lfs_dir_read_raw(lfs, dir, info); +} + +int lfs_dir_seek (lfs_t * lfs, lfs_dir_t * dir, lfs_off_t off) { + return lfs_dir_seek_raw(lfs, dir, off); +} + +lfs_soff_t lfs_dir_tell (lfs_t * lfs, lfs_dir_t * dir) { + return lfs_dir_tell_raw(lfs, dir); +} + +int lfs_dir_rewind (lfs_t * lfs, lfs_dir_t * dir) { + return lfs_dir_rewind_raw(lfs, dir); +} + +lfs_ssize_t lfs_fs_size (lfs_t * lfs) { + return lfs_fs_size_raw(lfs); +} + +int lfs_fs_traverse (lfs_t * lfs, int (* cb)(void *, lfs_block_t), void * data) { + return lfs_fs_traverse_raw(lfs, cb, data); +} + +#ifdef LFS_MIGRATE + +int lfs_migrate (lfs_t * lfs, const struct lfs_config * cfg) { + return lfs_migrate_raw(lfs, cfg); +} + +#endif + +#endif + +#if LFS_THREADSAFE + +int lfs_format (lfs_t * lfs, const struct lfs_config * config) { int err = config->lock(config); - if(err) + if (err) { return err; } + err = lfs_format_raw(lfs, config); config->unlock(config); return err; } -int lfs_mount_ts(lfs_t *lfs, const struct lfs_config *config) -{ + +int lfs_mount (lfs_t * lfs, const struct lfs_config * config) { int err = config->lock(config); - if(err) + if (err) { return err; } + err = lfs_mount_raw(lfs, config); config->unlock(config); return err; } -int lfs_unmount_ts(lfs_t *lfs) -{ + +int lfs_unmount (lfs_t * lfs) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_unmount_raw(lfs); lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_remove_ts(lfs_t *lfs, const char *path) -{ + +int lfs_remove (lfs_t * lfs, const char * path) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_remove_raw(lfs, path); lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_rename_ts(lfs_t *lfs, const char *oldpath, const char *newpath) -{ + +int lfs_rename (lfs_t * lfs, const char * oldpath, const char * newpath) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_rename_raw(lfs, oldpath, newpath); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_stat_ts(lfs_t *lfs, const char *path, struct lfs_info *info) -{ + +int lfs_stat (lfs_t * lfs, const char * path, struct lfs_info * info) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_stat_raw(lfs, path, info); - + lfs->cfg->unlock(lfs->cfg); return err; } -lfs_ssize_t lfs_getattr_ts(lfs_t *lfs, const char *path, uint8_t type, void *buffer, lfs_size_t size) -{ + +lfs_ssize_t lfs_getattr (lfs_t * lfs, const char * path, uint8_t type, void * buffer, lfs_size_t size) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_getattr_raw(lfs, path, type, buffer, size); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_setattr_ts(lfs_t *lfs, const char *path, uint8_t type, const void *buffer, lfs_size_t size) -{ + +int lfs_setattr (lfs_t * lfs, const char * path, uint8_t type, const void * buffer, lfs_size_t size) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_setattr_raw(lfs, path, type, buffer, size); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_removeattr_ts(lfs_t *lfs, const char *path, uint8_t type) -{ + +int lfs_removeattr (lfs_t * lfs, const char * path, uint8_t type) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_removeattr_raw(lfs, path, type); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_file_open_ts(lfs_t *lfs, lfs_file_t *file, const char *path, int flags) -{ + +int lfs_file_open (lfs_t * lfs, lfs_file_t * file, const char * path, int flags) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_file_open_raw(lfs, file, path, flags); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_file_opencfg_ts(lfs_t *lfs, lfs_file_t *file, const char *path, int flags, const struct lfs_file_config *config) -{ + +int lfs_file_opencfg (lfs_t * lfs, + lfs_file_t * file, + const char * path, + int flags, + const struct lfs_file_config * config) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_file_opencfg_raw(lfs, file, path, flags, config); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_file_close_ts(lfs_t *lfs, lfs_file_t *file) -{ + +int lfs_file_close (lfs_t * lfs, lfs_file_t * file) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_file_close_raw(lfs, file); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_file_sync_ts(lfs_t *lfs, lfs_file_t *file) -{ + +int lfs_file_sync (lfs_t * lfs, lfs_file_t * file) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_file_sync_raw(lfs, file); - + lfs->cfg->unlock(lfs->cfg); return err; } -lfs_ssize_t lfs_file_read_ts(lfs_t *lfs, lfs_file_t *file, void *buffer, lfs_size_t size) -{ + +lfs_ssize_t lfs_file_read (lfs_t * lfs, lfs_file_t * file, void * buffer, lfs_size_t size) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_file_read_raw(lfs, file, buffer, size); - + lfs->cfg->unlock(lfs->cfg); return err; } -lfs_ssize_t lfs_file_write_ts(lfs_t *lfs, lfs_file_t *file, const void *buffer, lfs_size_t size) -{ + +lfs_ssize_t lfs_file_write (lfs_t * lfs, lfs_file_t * file, const void * buffer, lfs_size_t size) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_file_write_raw(lfs, file, buffer, size); - + lfs->cfg->unlock(lfs->cfg); return err; } -lfs_soff_t lfs_file_seek_ts(lfs_t *lfs, lfs_file_t *file, lfs_soff_t off, int whence) -{ + +lfs_soff_t lfs_file_seek (lfs_t * lfs, lfs_file_t * file, lfs_soff_t off, int whence) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_file_seek_raw(lfs, file, off, whence); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_file_truncate_ts(lfs_t *lfs, lfs_file_t *file, lfs_off_t size) -{ + +int lfs_file_truncate (lfs_t * lfs, lfs_file_t * file, lfs_off_t size) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_file_truncate_raw(lfs, file, size); - + lfs->cfg->unlock(lfs->cfg); return err; } -lfs_soff_t lfs_file_tell_ts(lfs_t *lfs, lfs_file_t *file) -{ + +lfs_soff_t lfs_file_tell (lfs_t * lfs, lfs_file_t * file) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_file_tell_raw(lfs, file); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_file_rewind_ts(lfs_t *lfs, lfs_file_t *file) -{ + +int lfs_file_rewind (lfs_t * lfs, lfs_file_t * file) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_file_rewind_raw(lfs, file); - + lfs->cfg->unlock(lfs->cfg); return err; } -lfs_soff_t lfs_file_size_ts(lfs_t *lfs, lfs_file_t *file) -{ + +lfs_soff_t lfs_file_size (lfs_t * lfs, lfs_file_t * file) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_file_size_raw(lfs, file); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_mkdir_ts(lfs_t *lfs, const char *path) -{ + +int lfs_mkdir (lfs_t * lfs, const char * path) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_mkdir_raw(lfs, path); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_dir_open_ts(lfs_t *lfs, lfs_dir_t *dir, const char *path) -{ + +int lfs_dir_open (lfs_t * lfs, lfs_dir_t * dir, const char * path) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_dir_open_raw(lfs, dir, path); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_dir_close_ts(lfs_t *lfs, lfs_dir_t *dir) -{ + +int lfs_dir_close (lfs_t * lfs, lfs_dir_t * dir) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_dir_close_raw(lfs, dir); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_dir_read_ts(lfs_t *lfs, lfs_dir_t *dir, struct lfs_info *info) -{ + +int lfs_dir_read (lfs_t * lfs, lfs_dir_t * dir, struct lfs_info * info) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_dir_read_raw(lfs, dir, info); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_dir_seek_ts(lfs_t *lfs, lfs_dir_t *dir, lfs_off_t off) -{ + +int lfs_dir_seek (lfs_t * lfs, lfs_dir_t * dir, lfs_off_t off) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_dir_seek_raw(lfs, dir, off); - + lfs->cfg->unlock(lfs->cfg); return err; } -lfs_soff_t lfs_dir_tell_ts(lfs_t *lfs, lfs_dir_t *dir) -{ + +lfs_soff_t lfs_dir_tell (lfs_t * lfs, lfs_dir_t * dir) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_dir_tell_raw(lfs, dir); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_dir_rewind_ts(lfs_t *lfs, lfs_dir_t *dir) -{ + +int lfs_dir_rewind (lfs_t * lfs, lfs_dir_t * dir) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_dir_rewind_raw(lfs, dir); - + lfs->cfg->unlock(lfs->cfg); return err; } -lfs_ssize_t lfs_fs_size_ts(lfs_t *lfs) -{ + +lfs_ssize_t lfs_fs_size (lfs_t * lfs) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_fs_size_raw(lfs); - + lfs->cfg->unlock(lfs->cfg); return err; } -int lfs_fs_traverse_ts(lfs_t *lfs, int (*cb)(void*, lfs_block_t), void *data) -{ + +int lfs_fs_traverse (lfs_t * lfs, int (* cb)(void *, lfs_block_t), void * data) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_fs_traverse_raw(lfs, cb, data); - + lfs->cfg->unlock(lfs->cfg); return err; @@ -5290,15 +5454,15 @@ int lfs_fs_traverse_ts(lfs_t *lfs, int (*cb)(void*, lfs_block_t), void *data) #ifdef LFS_MIGRATE -int lfs_migrate_ts(lfs_t *lfs, const struct lfs_config *cfg) -{ +int lfs_migrate (lfs_t * lfs, const struct lfs_config * cfg) { int err = lfs->cfg->lock(lfs->cfg); - if(err) + if (err) { return err; } + err = lfs_migrate_raw(lfs, cfg); - + lfs->cfg->unlock(lfs->cfg); return err; diff --git a/lfs.h b/lfs.h index b4d65cb..19f9f67 100644 --- a/lfs.h +++ b/lfs.h @@ -16,7 +16,6 @@ extern "C" { #endif - /// Version info /// // Software library version @@ -54,7 +53,7 @@ typedef uint32_t lfs_block_t; // Maximum size of a file in bytes, may be redefined to limit to support other // drivers. Limited on disk to <= 4294967296. However, above 2147483647 the -// functions lfs_file_seek_raw, lfs_file_size_raw, and lfs_file_tell_raw will return +// functions lfs_file_seek, lfs_file_size, and lfs_file_tell will return // incorrect values due to using signed integers. Stored in superblock and // must be respected by other littlefs drivers. #ifndef LFS_FILE_MAX @@ -175,7 +174,7 @@ struct lfs_config { // are propogated to the user. int (*sync)(const struct lfs_config *c); - #if LFS_THREAD_SAFE +#if LFS_THREADSAFE // Lock the underlying block device. Negative error codes // are propogated to the user. int (*lock)(const struct lfs_config *c); @@ -183,7 +182,7 @@ struct lfs_config { // Unlock the underlying block device. Negative error codes // are propogated to the user. int (*unlock)(const struct lfs_config *c); - #endif +#endif // Minimum size of a block read. All read operations will be a // multiple of this value. @@ -417,7 +416,7 @@ typedef struct lfs { // be zeroed for defaults and backwards compatibility. // // Returns a negative error code on failure. -int lfs_format_raw(lfs_t *lfs, const struct lfs_config *config); +int lfs_format(lfs_t *lfs, const struct lfs_config *config); // Mounts a littlefs // @@ -427,13 +426,13 @@ int lfs_format_raw(lfs_t *lfs, const struct lfs_config *config); // be zeroed for defaults and backwards compatibility. // // Returns a negative error code on failure. -int lfs_mount_raw(lfs_t *lfs, const struct lfs_config *config); +int lfs_mount(lfs_t *lfs, const struct lfs_config *config); // Unmounts a littlefs // // Does nothing besides releasing any allocated resources. // Returns a negative error code on failure. -int lfs_unmount_raw(lfs_t *lfs); +int lfs_unmount(lfs_t *lfs); /// General operations /// @@ -441,7 +440,7 @@ int lfs_unmount_raw(lfs_t *lfs); // // If removing a directory, the directory must be empty. // Returns a negative error code on failure. -int lfs_remove_raw(lfs_t *lfs, const char *path); +int lfs_remove(lfs_t *lfs, const char *path); // Rename or move a file or directory // @@ -449,13 +448,13 @@ int lfs_remove_raw(lfs_t *lfs, const char *path); // If the destination is a directory, the directory must be empty. // // Returns a negative error code on failure. -int lfs_rename_raw(lfs_t *lfs, const char *oldpath, const char *newpath); +int lfs_rename(lfs_t *lfs, const char *oldpath, const char *newpath); // Find info about a file or directory // // Fills out the info structure, based on the specified file or directory. // Returns a negative error code on failure. -int lfs_stat_raw(lfs_t *lfs, const char *path, struct lfs_info *info); +int lfs_stat(lfs_t *lfs, const char *path, struct lfs_info *info); // Get a custom attribute // @@ -469,7 +468,7 @@ int lfs_stat_raw(lfs_t *lfs, const char *path, struct lfs_info *info); // Note, the returned size is the size of the attribute on disk, irrespective // of the size of the buffer. This can be used to dynamically allocate a buffer // or check for existance. -lfs_ssize_t lfs_getattr_raw(lfs_t *lfs, const char *path, +lfs_ssize_t lfs_getattr(lfs_t *lfs, const char *path, uint8_t type, void *buffer, lfs_size_t size); // Set custom attributes @@ -479,7 +478,7 @@ lfs_ssize_t lfs_getattr_raw(lfs_t *lfs, const char *path, // implicitly created. // // Returns a negative error code on failure. -int lfs_setattr_raw(lfs_t *lfs, const char *path, +int lfs_setattr(lfs_t *lfs, const char *path, uint8_t type, const void *buffer, lfs_size_t size); // Removes a custom attribute @@ -487,7 +486,7 @@ int lfs_setattr_raw(lfs_t *lfs, const char *path, // If an attribute is not found, nothing happens. // // Returns a negative error code on failure. -int lfs_removeattr_raw(lfs_t *lfs, const char *path, uint8_t type); +int lfs_removeattr(lfs_t *lfs, const char *path, uint8_t type); /// File operations /// @@ -498,7 +497,7 @@ int lfs_removeattr_raw(lfs_t *lfs, const char *path, uint8_t type); // are values from the enum lfs_open_flags that are bitwise-ored together. // // Returns a negative error code on failure. -int lfs_file_open_raw(lfs_t *lfs, lfs_file_t *file, +int lfs_file_open(lfs_t *lfs, lfs_file_t *file, const char *path, int flags); // Open a file with extra configuration @@ -511,7 +510,7 @@ int lfs_file_open_raw(lfs_t *lfs, lfs_file_t *file, // config struct must be zeroed for defaults and backwards compatibility. // // Returns a negative error code on failure. -int lfs_file_opencfg_raw(lfs_t *lfs, lfs_file_t *file, +int lfs_file_opencfg(lfs_t *lfs, lfs_file_t *file, const char *path, int flags, const struct lfs_file_config *config); @@ -521,19 +520,19 @@ int lfs_file_opencfg_raw(lfs_t *lfs, lfs_file_t *file, // sync had been called and releases any allocated resources. // // Returns a negative error code on failure. -int lfs_file_close_raw(lfs_t *lfs, lfs_file_t *file); +int lfs_file_close(lfs_t *lfs, lfs_file_t *file); // Synchronize a file on storage // // Any pending writes are written out to storage. // Returns a negative error code on failure. -int lfs_file_sync_raw(lfs_t *lfs, lfs_file_t *file); +int lfs_file_sync(lfs_t *lfs, lfs_file_t *file); // Read data from file // // Takes a buffer and size indicating where to store the read data. // Returns the number of bytes read, or a negative error code on failure. -lfs_ssize_t lfs_file_read_raw(lfs_t *lfs, lfs_file_t *file, +lfs_ssize_t lfs_file_read(lfs_t *lfs, lfs_file_t *file, void *buffer, lfs_size_t size); // Write data to file @@ -542,38 +541,38 @@ lfs_ssize_t lfs_file_read_raw(lfs_t *lfs, lfs_file_t *file, // actually be updated on the storage until either sync or close is called. // // Returns the number of bytes written, or a negative error code on failure. -lfs_ssize_t lfs_file_write_raw(lfs_t *lfs, lfs_file_t *file, +lfs_ssize_t lfs_file_write(lfs_t *lfs, lfs_file_t *file, const void *buffer, lfs_size_t size); // Change the position of the file // // The change in position is determined by the offset and whence flag. // Returns the new position of the file, or a negative error code on failure. -lfs_soff_t lfs_file_seek_raw(lfs_t *lfs, lfs_file_t *file, +lfs_soff_t lfs_file_seek(lfs_t *lfs, lfs_file_t *file, lfs_soff_t off, int whence); // Truncates the size of the file to the specified size // // Returns a negative error code on failure. -int lfs_file_truncate_raw(lfs_t *lfs, lfs_file_t *file, lfs_off_t size); +int lfs_file_truncate(lfs_t *lfs, lfs_file_t *file, lfs_off_t size); // Return the position of the file // -// Equivalent to lfs_file_seek_raw(lfs, file, 0, LFS_SEEK_CUR) +// Equivalent to lfs_file_seek(lfs, file, 0, LFS_SEEK_CUR) // Returns the position of the file, or a negative error code on failure. -lfs_soff_t lfs_file_tell_raw(lfs_t *lfs, lfs_file_t *file); +lfs_soff_t lfs_file_tell(lfs_t *lfs, lfs_file_t *file); // Change the position of the file to the beginning of the file // -// Equivalent to lfs_file_seek_raw(lfs, file, 0, LFS_SEEK_SET) +// Equivalent to lfs_file_seek(lfs, file, 0, LFS_SEEK_SET) // Returns a negative error code on failure. -int lfs_file_rewind_raw(lfs_t *lfs, lfs_file_t *file); +int lfs_file_rewind(lfs_t *lfs, lfs_file_t *file); // Return the size of the file // -// Similar to lfs_file_seek_raw(lfs, file, 0, LFS_SEEK_END) +// Similar to lfs_file_seek(lfs, file, 0, LFS_SEEK_END) // Returns the size of the file, or a negative error code on failure. -lfs_soff_t lfs_file_size_raw(lfs_t *lfs, lfs_file_t *file); +lfs_soff_t lfs_file_size(lfs_t *lfs, lfs_file_t *file); /// Directory operations /// @@ -581,26 +580,26 @@ lfs_soff_t lfs_file_size_raw(lfs_t *lfs, lfs_file_t *file); // Create a directory // // Returns a negative error code on failure. -int lfs_mkdir_raw(lfs_t *lfs, const char *path); +int lfs_mkdir(lfs_t *lfs, const char *path); // Open a directory // // Once open a directory can be used with read to iterate over files. // Returns a negative error code on failure. -int lfs_dir_open_raw(lfs_t *lfs, lfs_dir_t *dir, const char *path); +int lfs_dir_open(lfs_t *lfs, lfs_dir_t *dir, const char *path); // Close a directory // // Releases any allocated resources. // Returns a negative error code on failure. -int lfs_dir_close_raw(lfs_t *lfs, lfs_dir_t *dir); +int lfs_dir_close(lfs_t *lfs, lfs_dir_t *dir); // Read an entry in the directory // // Fills out the info structure, based on the specified file or directory. // Returns a positive value on success, 0 at the end of directory, // or a negative error code on failure. -int lfs_dir_read_raw(lfs_t *lfs, lfs_dir_t *dir, struct lfs_info *info); +int lfs_dir_read(lfs_t *lfs, lfs_dir_t *dir, struct lfs_info *info); // Change the position of the directory // @@ -608,7 +607,7 @@ int lfs_dir_read_raw(lfs_t *lfs, lfs_dir_t *dir, struct lfs_info *info); // an absolute offset in the directory seek. // // Returns a negative error code on failure. -int lfs_dir_seek_raw(lfs_t *lfs, lfs_dir_t *dir, lfs_off_t off); +int lfs_dir_seek(lfs_t *lfs, lfs_dir_t *dir, lfs_off_t off); // Return the position of the directory // @@ -616,12 +615,12 @@ int lfs_dir_seek_raw(lfs_t *lfs, lfs_dir_t *dir, lfs_off_t off); // sense, but does indicate the current position in the directory iteration. // // Returns the position of the directory, or a negative error code on failure. -lfs_soff_t lfs_dir_tell_raw(lfs_t *lfs, lfs_dir_t *dir); +lfs_soff_t lfs_dir_tell(lfs_t *lfs, lfs_dir_t *dir); // Change the position of the directory to the beginning of the directory // // Returns a negative error code on failure. -int lfs_dir_rewind_raw(lfs_t *lfs, lfs_dir_t *dir); +int lfs_dir_rewind(lfs_t *lfs, lfs_dir_t *dir); /// Filesystem-level filesystem operations @@ -632,7 +631,7 @@ int lfs_dir_rewind_raw(lfs_t *lfs, lfs_dir_t *dir); // size may be larger than the filesystem actually is. // // Returns the number of allocated blocks, or a negative error code on failure. -lfs_ssize_t lfs_fs_size_raw(lfs_t *lfs); +lfs_ssize_t lfs_fs_size(lfs_t *lfs); // Traverse through all blocks in use by the filesystem // @@ -641,12 +640,12 @@ lfs_ssize_t lfs_fs_size_raw(lfs_t *lfs); // blocks are in use or how much of the storage is available. // // Returns a negative error code on failure. -int lfs_fs_traverse_raw(lfs_t *lfs, int (*cb)(void*, lfs_block_t), void *data); +int lfs_fs_traverse(lfs_t *lfs, int (*cb)(void*, lfs_block_t), void *data); #ifdef LFS_MIGRATE // Attempts to migrate a previous version of littlefs // -// Behaves similarly to the lfs_format_raw function. Attempts to mount +// Behaves similarly to the lfs_format function. Attempts to mount // the previous version of littlefs and update the filesystem so it can be // mounted with the current version of littlefs. // @@ -655,108 +654,39 @@ int lfs_fs_traverse_raw(lfs_t *lfs, int (*cb)(void*, lfs_block_t), void *data); // be zeroed for defaults and backwards compatibility. // // Returns a negative error code on failure. +int lfs_migrate(lfs_t *lfs, const struct lfs_config *cfg); +#endif + +int lfs_format_raw(lfs_t *lfs, const struct lfs_config *config); +int lfs_mount_raw(lfs_t *lfs, const struct lfs_config *config); +int lfs_unmount_raw(lfs_t *lfs); +int lfs_remove_raw(lfs_t *lfs, const char *path); +int lfs_rename_raw(lfs_t *lfs, const char *oldpath, const char *newpath); +int lfs_stat_raw(lfs_t *lfs, const char *path, struct lfs_info *info); +lfs_ssize_t lfs_getattr_raw(lfs_t *lfs, const char *path, uint8_t type, void *buffer, lfs_size_t size); +int lfs_setattr_raw(lfs_t *lfs, const char *path, uint8_t type, const void *buffer, lfs_size_t size); +int lfs_removeattr_raw(lfs_t *lfs, const char *path, uint8_t type); +int lfs_file_open_raw(lfs_t *lfs, lfs_file_t *file, const char *path, int flags); +int lfs_file_opencfg_raw(lfs_t *lfs, lfs_file_t *file, const char *path, int flags, const struct lfs_file_config *config); +int lfs_file_close_raw(lfs_t *lfs, lfs_file_t *file); +int lfs_file_sync_raw(lfs_t *lfs, lfs_file_t *file); +lfs_ssize_t lfs_file_read_raw(lfs_t *lfs, lfs_file_t *file, void *buffer, lfs_size_t size); +lfs_ssize_t lfs_file_write_raw(lfs_t *lfs, lfs_file_t *file, const void *buffer, lfs_size_t size); +lfs_soff_t lfs_file_seek_raw(lfs_t *lfs, lfs_file_t *file, lfs_soff_t off, int whence); +int lfs_file_truncate_raw(lfs_t *lfs, lfs_file_t *file, lfs_off_t size); +lfs_soff_t lfs_file_tell_raw(lfs_t *lfs, lfs_file_t *file); +int lfs_file_rewind_raw(lfs_t *lfs, lfs_file_t *file); +lfs_soff_t lfs_file_size_raw(lfs_t *lfs, lfs_file_t *file); +int lfs_mkdir_raw(lfs_t *lfs, const char *path); +int lfs_dir_open_raw(lfs_t *lfs, lfs_dir_t *dir, const char *path); +int lfs_dir_close_raw(lfs_t *lfs, lfs_dir_t *dir); +int lfs_dir_read_raw(lfs_t *lfs, lfs_dir_t *dir, struct lfs_info *info); +int lfs_dir_seek_raw(lfs_t *lfs, lfs_dir_t *dir, lfs_off_t off); +lfs_soff_t lfs_dir_tell_raw(lfs_t *lfs, lfs_dir_t *dir); +int lfs_dir_rewind_raw(lfs_t *lfs, lfs_dir_t *dir); +lfs_ssize_t lfs_fs_size_raw(lfs_t *lfs); +int lfs_fs_traverse_raw(lfs_t *lfs, int (*cb)(void*, lfs_block_t), void *data); int lfs_migrate_raw(lfs_t *lfs, const struct lfs_config *cfg); -#endif - -#if LFS_THREAD_SAFE - -int lfs_format_ts(lfs_t *lfs, const struct lfs_config *config); -int lfs_mount_ts(lfs_t *lfs, const struct lfs_config *config); -int lfs_unmount_ts(lfs_t *lfs); -int lfs_remove_ts(lfs_t *lfs, const char *path); -int lfs_rename_ts(lfs_t *lfs, const char *oldpath, const char *newpath); -int lfs_stat_ts(lfs_t *lfs, const char *path, struct lfs_info *info); -lfs_ssize_t lfs_getattr_ts(lfs_t *lfs, const char *path, uint8_t type, void *buffer, lfs_size_t size); -int lfs_setattr_ts(lfs_t *lfs, const char *path, uint8_t type, const void *buffer, lfs_size_t size); -int lfs_removeattr_ts(lfs_t *lfs, const char *path, uint8_t type); -int lfs_file_open_ts(lfs_t *lfs, lfs_file_t *file, const char *path, int flags); -int lfs_file_opencfg_ts(lfs_t *lfs, lfs_file_t *file, const char *path, int flags, const struct lfs_file_config *config); -int lfs_file_close_ts(lfs_t *lfs, lfs_file_t *file); -int lfs_file_sync_ts(lfs_t *lfs, lfs_file_t *file); -lfs_ssize_t lfs_file_read_ts(lfs_t *lfs, lfs_file_t *file, void *buffer, lfs_size_t size); -lfs_ssize_t lfs_file_write_ts(lfs_t *lfs, lfs_file_t *file, const void *buffer, lfs_size_t size); -lfs_soff_t lfs_file_seek_ts(lfs_t *lfs, lfs_file_t *file, lfs_soff_t off, int whence); -int lfs_file_truncate_ts(lfs_t *lfs, lfs_file_t *file, lfs_off_t size); -lfs_soff_t lfs_file_tell_ts(lfs_t *lfs, lfs_file_t *file); -int lfs_file_rewind_ts(lfs_t *lfs, lfs_file_t *file); -lfs_soff_t lfs_file_size_ts(lfs_t *lfs, lfs_file_t *file); -int lfs_mkdir_ts(lfs_t *lfs, const char *path); -int lfs_dir_open_ts(lfs_t *lfs, lfs_dir_t *dir, const char *path); -int lfs_dir_close_ts(lfs_t *lfs, lfs_dir_t *dir); -int lfs_dir_read_ts(lfs_t *lfs, lfs_dir_t *dir, struct lfs_info *info); -int lfs_dir_seek_ts(lfs_t *lfs, lfs_dir_t *dir, lfs_off_t off); -lfs_soff_t lfs_dir_tell_ts(lfs_t *lfs, lfs_dir_t *dir); -int lfs_dir_rewind_ts(lfs_t *lfs, lfs_dir_t *dir); -lfs_ssize_t lfs_fs_size_ts(lfs_t *lfs); -int lfs_fs_traverse_ts(lfs_t *lfs, int (*cb)(void*, lfs_block_t), void *data); -int lfs_migrate_ts(lfs_t *lfs, const struct lfs_config *cfg); - -#define lfs_format lfs_format_ts -#define lfs_mount lfs_mount_ts -#define lfs_unmount lfs_unmount_ts -#define lfs_remove lfs_remove_ts -#define lfs_rename lfs_rename_ts -#define lfs_stat lfs_stat_ts -#define lfs_getattr lfs_getattr_ts -#define lfs_setattr lfs_setattr_ts -#define lfs_removeattr lfs_removeattr_ts -#define lfs_file_open lfs_file_open_ts -#define lfs_file_opencfg lfs_file_opencfg_ts -#define lfs_file_close lfs_file_close_ts -#define lfs_file_sync lfs_file_sync_ts -#define lfs_file_read lfs_file_read_ts -#define lfs_file_write lfs_file_write_ts -#define lfs_file_seek lfs_file_seek_ts -#define lfs_file_truncate lfs_file_truncate_ts -#define lfs_file_tell lfs_file_tell_ts -#define lfs_file_rewind lfs_file_rewind_ts -#define lfs_file_size lfs_file_size_ts -#define lfs_mkdir lfs_mkdir_ts -#define lfs_dir_open lfs_dir_open_ts -#define lfs_dir_close lfs_dir_close_ts -#define lfs_dir_read lfs_dir_read_ts -#define lfs_dir_seek lfs_dir_seek_ts -#define lfs_dir_tell lfs_dir_tell_ts -#define lfs_dir_rewind lfs_dir_rewind_ts -#define lfs_fs_size lfs_fs_size_ts -#define lfs_fs_traverse lfs_fs_traverse_ts -#define lfs_migrate lfs_migrate_ts - -#else - -#define lfs_format lfs_format_raw -#define lfs_mount lfs_mount_raw -#define lfs_unmount lfs_unmount_raw -#define lfs_remove lfs_remove_raw -#define lfs_rename lfs_rename_raw -#define lfs_stat lfs_stat_raw -#define lfs_getattr lfs_getattr_raw -#define lfs_setattr lfs_setattr_raw -#define lfs_removeattr lfs_removeattr_raw -#define lfs_file_open lfs_file_open_raw -#define lfs_file_opencfg lfs_file_opencfg_raw -#define lfs_file_close lfs_file_close_raw -#define lfs_file_sync lfs_file_sync_raw -#define lfs_file_read lfs_file_read_raw -#define lfs_file_write lfs_file_write_raw -#define lfs_file_seek lfs_file_seek_raw -#define lfs_file_truncate lfs_file_truncate_raw -#define lfs_file_tell lfs_file_tell_raw -#define lfs_file_rewind lfs_file_rewind_raw -#define lfs_file_size lfs_file_size_raw -#define lfs_mkdir lfs_mkdir_raw -#define lfs_dir_open lfs_dir_open_raw -#define lfs_dir_close lfs_dir_close_raw -#define lfs_dir_read lfs_dir_read_raw -#define lfs_dir_seek lfs_dir_seek_raw -#define lfs_dir_tell lfs_dir_tell_raw -#define lfs_dir_rewind lfs_dir_rewind_raw -#define lfs_fs_size lfs_fs_size_raw -#define lfs_fs_traverse lfs_fs_traverse_raw -#define lfs_migrate lfs_migrate_raw - -#endif - #ifdef __cplusplus } /* extern "C" */ diff --git a/lfs_util.h b/lfs_util.h index 2db2cba..84bab11 100644 --- a/lfs_util.h +++ b/lfs_util.h @@ -44,8 +44,8 @@ extern "C" #endif // Enables thread-safe wrappers using the lock/unlock callbacks in lfs_config -#ifndef LFS_THREAD_SAFE -#define LFS_THREAD_SAFE 0 +#ifndef LFS_THREADSAFE +#define LFS_THREADSAFE 0 #endif // Macros, may be replaced by system specific wrappers. Arguments to these