address review comments

This commit is contained in:
Bill Gesner
2020-11-19 19:01:52 +00:00
parent b477e0d8e8
commit 1f831e234a
3 changed files with 351 additions and 257 deletions

346
lfs.c
View File

@@ -4912,375 +4912,539 @@ 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);
@@ -5290,13 +5454,13 @@ 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);

206
lfs.h
View File

@@ -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" */

View File

@@ -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