2
* YAFFS: Yet another Flash File System . A NAND-flash specific file system.
4
* Copyright (C) 2002-2011 Aleph One Ltd.
5
* for Toby Churchill Ltd and Brightstar Engineering
7
* Created by Charles Manning <charles@aleph1.co.uk>
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.
13
* Note: Only YAFFS headers are LGPL, YAFFS C code is covered by GPL.
17
* Header file for using yaffs in an application via
33
#define YAFFS_MAX_FILE_SIZE (0x800000000LL - 1)
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 */
45
typedef struct opaque_structure yaffs_DIR;
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];
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 */
73
struct yaffs_utimbuf {
75
unsigned long modtime;
79
int yaffs_open(const YCHAR *path, int oflag, int mode) ;
81
int yaffs_close(int fd) ;
82
int yaffs_fsync(int fd) ;
83
int yaffs_fdatasync(int fd) ;
84
int yaffs_flush(int fd) ; /* same as yaffs_fsync() */
86
int yaffs_access(const YCHAR *path, int amode);
88
int yaffs_dup(int fd);
90
int yaffs_read(int fd, void *buf, unsigned int nbyte) ;
91
int yaffs_write(int fd, const void *buf, unsigned int nbyte) ;
93
int yaffs_pread(int fd, void *buf, unsigned int nbyte, loff_t offset);
94
int yaffs_pwrite(int fd, const void *buf, unsigned int nbyte, loff_t offset);
96
loff_t yaffs_lseek(int fd, loff_t offset, int whence) ;
98
int yaffs_truncate(const YCHAR *path, loff_t new_size);
99
int yaffs_ftruncate(int fd, loff_t new_size);
101
int yaffs_unlink(const YCHAR *path) ;
102
int yaffs_rename(const YCHAR *oldPath, const YCHAR *newPath) ;
104
int yaffs_stat(const YCHAR *path, struct yaffs_stat *buf) ;
105
int yaffs_lstat(const YCHAR *path, struct yaffs_stat *buf) ;
106
int yaffs_fstat(int fd, struct yaffs_stat *buf) ;
108
int yaffs_utime(const YCHAR *path, const struct yaffs_utimbuf *buf);
109
int yaffs_futime(int fd, const struct yaffs_utimbuf *buf);
112
int yaffs_setxattr(const char *path, const char *name,
113
const void *data, int size, int flags);
114
int yaffs_lsetxattr(const char *path, const char *name,
115
const void *data, int size, int flags);
116
int yaffs_fsetxattr(int fd, const char *name,
117
const void *data, int size, int flags);
119
int yaffs_getxattr(const char *path, const char *name,
120
void *data, int size);
121
int yaffs_lgetxattr(const char *path, const char *name,
122
void *data, int size);
123
int yaffs_fgetxattr(int fd, const char *name,
124
void *data, int size);
126
int yaffs_removexattr(const char *path, const char *name);
127
int yaffs_lremovexattr(const char *path, const char *name);
128
int yaffs_fremovexattr(int fd, const char *name);
130
int yaffs_listxattr(const char *path, char *list, int size);
131
int yaffs_llistxattr(const char *path, char *list, int size);
132
int yaffs_flistxattr(int fd, char *list, int size);
135
#ifdef CONFIG_YAFFS_WINCE
137
int yaffs_set_wince_times(int fd,
138
const unsigned *wctime,
139
const unsigned *watime,
140
const unsigned *wmtime);
141
int yaffs_get_wince_times(int fd,
148
int yaffs_chmod(const YCHAR *path, mode_t mode);
149
int yaffs_fchmod(int fd, mode_t mode);
151
int yaffs_mkdir(const YCHAR *path, mode_t mode) ;
152
int yaffs_rmdir(const YCHAR *path) ;
154
yaffs_DIR *yaffs_opendir(const YCHAR *dirname) ;
155
struct yaffs_dirent *yaffs_readdir(yaffs_DIR *dirp) ;
156
void yaffs_rewinddir(yaffs_DIR *dirp) ;
157
int yaffs_closedir(yaffs_DIR *dirp) ;
159
int yaffs_mount(const YCHAR *path) ;
160
int yaffs_mount2(const YCHAR *path, int read_only);
161
int yaffs_mount_common(const YCHAR *path, int read_only, int skip_checkpt);
163
int yaffs_unmount(const YCHAR *path) ;
164
int yaffs_unmount2(const YCHAR *path, int force);
165
int yaffs_remount(const YCHAR *path, int force, int read_only);
168
int yaffs_sync(const YCHAR *path) ;
170
int yaffs_symlink(const YCHAR *oldpath, const YCHAR *newpath);
171
int yaffs_readlink(const YCHAR *path, YCHAR *buf, int bufsiz);
173
int yaffs_link(const YCHAR *oldpath, const YCHAR *newpath);
174
int yaffs_mknod(const YCHAR *pathname, mode_t mode, dev_t dev);
176
loff_t yaffs_freespace(const YCHAR *path);
177
loff_t yaffs_totalspace(const YCHAR *path);
179
int yaffs_inodecount(const YCHAR *path);
181
int yaffs_n_handles(const YCHAR *path);
183
#define YAFFS_SHARE_READ 1
184
#define YAFFS_SHARE_WRITE 2
185
int yaffs_open_sharing(const YCHAR *path, int oflag, int mode, int shareMode);
188
void yaffs_add_device(struct yaffs_dev *dev);
190
int yaffs_start_up(void);
191
int yaffsfs_GetLastError(void);
193
/* Functions to iterate through devices. NB Use with extreme care! */
194
void yaffs_dev_rewind(void);
195
struct yaffs_dev *yaffs_next_dev(void);
197
/* Function to get the last error */
198
int yaffs_get_error(void);
199
const char *yaffs_error_to_str(int err);
201
/* Function only for debugging */
202
void *yaffs_getdev(const YCHAR *path);
203
int yaffs_dump_dev(const YCHAR *path);
204
int yaffs_set_error(int error);
206
/* Trace control functions */
207
unsigned yaffs_set_trace(unsigned tm);
208
unsigned yaffs_get_trace(void);