1/* 2 * YAFFS: Yet another Flash File System . A NAND-flash specific file system. 3 * 4 * Copyright (C) 2002-2011 Aleph One Ltd. 5 * for Toby Churchill Ltd and Brightstar Engineering 6 * 7 * Created by Charles Manning <charles@aleph1.co.uk> 8 * 9 * This program is free software; you can redistribute it and/or modify 10 * it under the terms of the GNU Lesser General Public License version 2.1 as 11 * published by the Free Software Foundation. 12 * 13 * Note: Only YAFFS headers are LGPL, YAFFS C code is covered by GPL. 14 */ 15 16/* 17 * Header file for using yaffs in an application via 18 * a direct interface. 19 */ 20 21 22#ifndef __YAFFSFS_H__ 23#define __YAFFSFS_H__ 24 25#include "yaffscfg.h" 26#include "yportenv.h" 27 28 29#ifndef NAME_MAX 30#define NAME_MAX 256 31#endif 32 33#define YAFFS_MAX_FILE_SIZE (0x800000000LL - 1) 34 35 36struct yaffs_dirent { 37 long d_ino; /* inode number */ 38 off_t d_off; /* offset to this dirent */ 39 unsigned short d_reclen; /* length of this dirent */ 40 YUCHAR d_type; /* type of this record */ 41 YCHAR d_name[NAME_MAX+1]; /* file name (null-terminated) */ 42 unsigned d_dont_use; /* debug: not for public consumption */ 43}; 44 45typedef struct opaque_structure yaffs_DIR; 46 47 48 49struct yaffs_stat { 50 int st_dev; /* device */ 51 int st_ino; /* inode */ 52 unsigned st_mode; /* protection */ 53 int st_nlink; /* number of hard links */ 54 int st_uid; /* user ID of owner */ 55 int st_gid; /* group ID of owner */ 56 unsigned st_rdev; /* device type (if inode device) */ 57 loff_t st_size; /* total size, in bytes */ 58 unsigned long st_blksize; /* blocksize for filesystem I/O */ 59 unsigned long st_blocks; /* number of blocks allocated */ 60#ifdef CONFIG_YAFFS_WINCE 61 /* Special 64-bit times for WinCE */ 62 unsigned long yst_wince_atime[2]; 63 unsigned long yst_wince_mtime[2]; 64 unsigned long yst_wince_ctime[2]; 65#else 66 unsigned long yst_atime; /* time of last access */ 67 unsigned long yst_mtime; /* time of last modification */ 68 unsigned long yst_ctime; /* time of last change */ 69#endif 70}; 71 72 73struct yaffs_utimbuf { 74 unsigned long actime; 75 unsigned long modtime; 76}; 77 78 79int yaffs_open(const YCHAR *path, int oflag, int mode) ; 80 81int yaffs_close(int fd) ; 82int yaffs_fsync(int fd) ; 83int yaffs_fdatasync(int fd) ; 84int yaffs_flush(int fd) ; /* same as yaffs_fsync() */ 85 86int yaffs_access(const YCHAR *path, int amode); 87 88int yaffs_dup(int fd); 89 90int yaffs_read(int fd, void *buf, unsigned int nbyte) ; 91int yaffs_write(int fd, const void *buf, unsigned int nbyte) ; 92 93int yaffs_pread(int fd, void *buf, unsigned int nbyte, loff_t offset); 94int yaffs_pwrite(int fd, const void *buf, unsigned int nbyte, loff_t offset); 95 96loff_t yaffs_lseek(int fd, loff_t offset, int whence) ; 97 98int yaffs_truncate(const YCHAR *path, loff_t new_size); 99int yaffs_ftruncate(int fd, loff_t new_size); 100 101int yaffs_unlink(const YCHAR *path) ; 102int yaffs_rename(const YCHAR *oldPath, const YCHAR *newPath) ; 103 104int yaffs_stat(const YCHAR *path, struct yaffs_stat *buf) ; 105int yaffs_lstat(const YCHAR *path, struct yaffs_stat *buf) ; 106int yaffs_fstat(int fd, struct yaffs_stat *buf) ; 107 108int yaffs_utime(const YCHAR *path, const struct yaffs_utimbuf *buf); 109int yaffs_futime(int fd, const struct yaffs_utimbuf *buf); 110 111 112int yaffs_setxattr(const char *path, const char *name, 113 const void *data, int size, int flags); 114int yaffs_lsetxattr(const char *path, const char *name, 115 const void *data, int size, int flags); 116int yaffs_fsetxattr(int fd, const char *name, 117 const void *data, int size, int flags); 118 119int yaffs_getxattr(const char *path, const char *name, 120 void *data, int size); 121int yaffs_lgetxattr(const char *path, const char *name, 122 void *data, int size); 123int yaffs_fgetxattr(int fd, const char *name, 124 void *data, int size); 125 126int yaffs_removexattr(const char *path, const char *name); 127int yaffs_lremovexattr(const char *path, const char *name); 128int yaffs_fremovexattr(int fd, const char *name); 129 130int yaffs_listxattr(const char *path, char *list, int size); 131int yaffs_llistxattr(const char *path, char *list, int size); 132int yaffs_flistxattr(int fd, char *list, int size); 133 134 135#ifdef CONFIG_YAFFS_WINCE 136 137int yaffs_set_wince_times(int fd, 138 const unsigned *wctime, 139 const unsigned *watime, 140 const unsigned *wmtime); 141int yaffs_get_wince_times(int fd, 142 unsigned *wctime, 143 unsigned *watime, 144 unsigned *wmtime); 145 146#endif 147 148int yaffs_chmod(const YCHAR *path, mode_t mode); 149int yaffs_fchmod(int fd, mode_t mode); 150 151int yaffs_mkdir(const YCHAR *path, mode_t mode) ; 152int yaffs_rmdir(const YCHAR *path) ; 153 154yaffs_DIR *yaffs_opendir(const YCHAR *dirname) ; 155struct yaffs_dirent *yaffs_readdir(yaffs_DIR *dirp) ; 156void yaffs_rewinddir(yaffs_DIR *dirp) ; 157int yaffs_closedir(yaffs_DIR *dirp) ; 158 159int yaffs_mount(const YCHAR *path) ; 160int yaffs_mount2(const YCHAR *path, int read_only); 161int yaffs_mount_common(const YCHAR *path, int read_only, int skip_checkpt); 162 163int yaffs_unmount(const YCHAR *path) ; 164int yaffs_unmount2(const YCHAR *path, int force); 165int yaffs_remount(const YCHAR *path, int force, int read_only); 166 167 168int yaffs_sync(const YCHAR *path) ; 169 170int yaffs_symlink(const YCHAR *oldpath, const YCHAR *newpath); 171int yaffs_readlink(const YCHAR *path, YCHAR *buf, int bufsiz); 172 173int yaffs_link(const YCHAR *oldpath, const YCHAR *newpath); 174int yaffs_mknod(const YCHAR *pathname, mode_t mode, dev_t dev); 175 176loff_t yaffs_freespace(const YCHAR *path); 177loff_t yaffs_totalspace(const YCHAR *path); 178 179int yaffs_inodecount(const YCHAR *path); 180 181int yaffs_n_handles(const YCHAR *path); 182 183#define YAFFS_SHARE_READ 1 184#define YAFFS_SHARE_WRITE 2 185int yaffs_open_sharing(const YCHAR *path, int oflag, int mode, int shareMode); 186 187struct yaffs_dev; 188void yaffs_add_device(struct yaffs_dev *dev); 189 190int yaffs_start_up(void); 191int yaffsfs_GetLastError(void); 192 193/* Functions to iterate through devices. NB Use with extreme care! */ 194void yaffs_dev_rewind(void); 195struct yaffs_dev *yaffs_next_dev(void); 196 197/* Function to get the last error */ 198int yaffs_get_error(void); 199const char *yaffs_error_to_str(int err); 200 201/* Function only for debugging */ 202void *yaffs_getdev(const YCHAR *path); 203int yaffs_dump_dev(const YCHAR *path); 204int yaffs_set_error(int error); 205 206/* Trace control functions */ 207unsigned yaffs_set_trace(unsigned tm); 208unsigned yaffs_get_trace(void); 209#endif 210