Most functions return -1 or NULL on error and set errno.
Disk image is represented by opaque
DRIVE* type returned by
an open function and supplied as argument to other functions.
DRIVE *fat_open_virt(struct fat_dops *dops, void *priv, int rw)
DRIVE *fat_open_image(const char *path, int rw)
Fat_dops structure contains user's methods (read, write...)
providing image abstraction. They operate on series of bytes not organized
in sectors, it is expected that a user will reorganize and buffer disk accesses.
Forward slash (
/) is a separator in paths (Unix convention).
File names use UTF-8.
For file i/o generic
FILE* interface is used (
It can be obtained by:
FILE *fat_fopen(DRIVE*, const char *path, const char *mode)
If something has been written to a file, it should be explicitly fclosed on exit
to ensure that stdio buffers are flushed.
Directory operations use
FDIR* pointer (similar to libc's
FDIR *fat_opendir(DRIVE*, const char *path)
int fat_readdir(FDIR*, struct fat_dirent*)
See fatlib.h for more...