ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/libeio/eio.h
(Generate patch)

Comparing libeio/eio.h (file contents):
Revision 1.12 by root, Sat May 17 12:17:25 2008 UTC vs.
Revision 1.18 by root, Wed Oct 22 18:15:36 2008 UTC

… …
38 */ 38 */
39 39
40#ifndef EIO_H_ 40#ifndef EIO_H_
41#define EIO_H_ 41#define EIO_H_
42 42
43#ifdef __cplusplus
44extern "C" {
45#endif
46
43#include <stddef.h> 47#include <stddef.h>
44#include <sys/types.h> 48#include <sys/types.h>
45 49
46typedef struct eio_req eio_req; 50typedef struct eio_req eio_req;
47 51
… …
54#ifndef EIO_STRUCT_STAT 58#ifndef EIO_STRUCT_STAT
55# define EIO_STRUCT_STAT struct stat 59# define EIO_STRUCT_STAT struct stat
56#endif 60#endif
57 61
58enum { 62enum {
63 EIO_CUSTOM,
59 EIO_OPEN, EIO_CLOSE, EIO_DUP2, 64 EIO_OPEN, EIO_CLOSE, EIO_DUP2,
60 EIO_READ, EIO_WRITE, 65 EIO_READ, EIO_WRITE,
61 EIO_READAHEAD, EIO_SENDFILE, 66 EIO_READAHEAD, EIO_SENDFILE,
62 EIO_STAT, EIO_LSTAT, EIO_FSTAT, 67 EIO_STAT, EIO_LSTAT, EIO_FSTAT,
63 EIO_TRUNCATE, EIO_FTRUNCATE, 68 EIO_TRUNCATE, EIO_FTRUNCATE,
64 EIO_UTIME, EIO_FUTIME, 69 EIO_UTIME, EIO_FUTIME,
65 EIO_CHMOD, EIO_FCHMOD, 70 EIO_CHMOD, EIO_FCHMOD,
66 EIO_CHOWN, EIO_FCHOWN, 71 EIO_CHOWN, EIO_FCHOWN,
67 EIO_SYNC, EIO_FSYNC, EIO_FDATASYNC, 72 EIO_SYNC, EIO_FSYNC, EIO_FDATASYNC,
73 EIO_MSYNC, EIO_MTOUCH, EIO_SYNC_FILE_RANGE,
68 EIO_UNLINK, EIO_RMDIR, EIO_MKDIR, EIO_RENAME, 74 EIO_UNLINK, EIO_RMDIR, EIO_MKDIR, EIO_RENAME,
69 EIO_MKNOD, EIO_READDIR, 75 EIO_MKNOD, EIO_READDIR,
70 EIO_LINK, EIO_SYMLINK, EIO_READLINK, 76 EIO_LINK, EIO_SYMLINK, EIO_READLINK,
71 EIO_GROUP, EIO_NOP, 77 EIO_GROUP, EIO_NOP,
72 EIO_BUSY, 78 EIO_BUSY
79};
80
81/* eio_sync_file_range flags */
82
83enum {
84 EIO_SYNC_FILE_RANGE_WAIT_BEFORE = 1,
85 EIO_SYNC_FILE_RANGE_WRITE = 2,
86 EIO_SYNC_FILE_RANGE_WAIT_AFTER = 4
73}; 87};
74 88
75typedef double eio_tstamp; /* feel free to use double in your code directly */ 89typedef double eio_tstamp; /* feel free to use double in your code directly */
76 90
77/* eio request structure */ 91/* eio request structure */
… …
79struct eio_req 93struct eio_req
80{ 94{
81 eio_req volatile *next; /* private ETP */ 95 eio_req volatile *next; /* private ETP */
82 96
83 ssize_t result; /* result of syscall, e.g. result = read (... */ 97 ssize_t result; /* result of syscall, e.g. result = read (... */
84 off_t offs; /* read, write, truncate, readahead: file offset; mknod: dev_t */ 98 off_t offs; /* read, write, truncate, readahead, sync_file_range: file offset */
85 size_t size; /* read, write, readahead, sendfile: length */ 99 size_t size; /* read, write, readahead, sendfile, msync, sync_file_range: length */
86 void *ptr1; /* all applicable requests: pathname, old name */ 100 void *ptr1; /* all applicable requests: pathname, old name */
87 void *ptr2; /* all applicable requests: new name or memory buffer */ 101 void *ptr2; /* all applicable requests: new name or memory buffer */
88 eio_tstamp nv1; /* utime, futime: atime; busy: sleep time */ 102 eio_tstamp nv1; /* utime, futime: atime; busy: sleep time */
89 eio_tstamp nv2; /* utime, futime: mtime */ 103 eio_tstamp nv2; /* utime, futime: mtime */
90 104
91 int type; /* EIO_xxx constant ETP */ 105 int type; /* EIO_xxx constant ETP */
92 int int1; /* all applicable requests: file descriptor; sendfile: output fd; open: flags */ 106 int int1; /* all applicable requests: file descriptor; sendfile: output fd; open, msync: flags */
93 long int2; /* chown, fchown: uid; sendfile: input fd; open, chmod, mkdir, mknod: file mode */ 107 long int2; /* chown, fchown: uid; sendfile: input fd; open, chmod, mkdir, mknod: file mode, sync_file_range: flags */
94 long int3; /* chown, fchown: gid */ 108 long int3; /* chown, fchown: gid; mknod: dev_t */
95 int errorno; /* errno value on syscall return */ 109 int errorno; /* errno value on syscall return */
96 110
97 unsigned char flags; /* private */ 111 unsigned char flags; /* private */
98 signed char pri; /* the priority */ 112 signed char pri; /* the priority */
99 113
… …
105 EIO_REQ_MEMBERS 119 EIO_REQ_MEMBERS
106 120
107 eio_req *grp, *grp_prev, *grp_next, *grp_first; /* private */ 121 eio_req *grp, *grp_prev, *grp_next, *grp_first; /* private */
108}; 122};
109 123
124/* _private_ flags */
110enum { 125enum {
111 EIO_FLAG_CANCELLED = 0x01, /* request was cancelled */ 126 EIO_FLAG_CANCELLED = 0x01, /* request was cancelled */
112 EIO_FLAG_PTR1_FREE = 0x02, /* need to free(ptr1) */ 127 EIO_FLAG_PTR1_FREE = 0x02, /* need to free(ptr1) */
113 EIO_FLAG_PTR2_FREE = 0x04 /* need to free(ptr2) */ 128 EIO_FLAG_PTR2_FREE = 0x04, /* need to free(ptr2) */
129 EIO_FLAG_GROUPADD = 0x08 /* some request was added to the group */
114}; 130};
115 131
116enum { 132enum {
117 EIO_PRI_MIN = -4, 133 EIO_PRI_MIN = -4,
118 EIO_PRI_MAX = 4, 134 EIO_PRI_MAX = 4,
119
120 EIO_PRI_DEFAULT = 0, 135 EIO_PRI_DEFAULT = 0,
121}; 136};
122 137
123/* returns < 0 on error, errno set 138/* returns < 0 on error, errno set
124 * need_poll, if non-zero, will be called when results are available 139 * need_poll, if non-zero, will be called when results are available
125 * and eio_poll_cb needs to be invoked (it MUST NOT call eio_poll_cb itself). 140 * and eio_poll_cb needs to be invoked (it MUST NOT call eio_poll_cb itself).
… …
155eio_req *eio_nop (int pri, eio_cb cb, void *data); /* does nothing except go through the whole process */ 170eio_req *eio_nop (int pri, eio_cb cb, void *data); /* does nothing except go through the whole process */
156eio_req *eio_busy (eio_tstamp delay, int pri, eio_cb cb, void *data); /* ties a thread for this long, simulating busyness */ 171eio_req *eio_busy (eio_tstamp delay, int pri, eio_cb cb, void *data); /* ties a thread for this long, simulating busyness */
157eio_req *eio_sync (int pri, eio_cb cb, void *data); 172eio_req *eio_sync (int pri, eio_cb cb, void *data);
158eio_req *eio_fsync (int fd, int pri, eio_cb cb, void *data); 173eio_req *eio_fsync (int fd, int pri, eio_cb cb, void *data);
159eio_req *eio_fdatasync (int fd, int pri, eio_cb cb, void *data); 174eio_req *eio_fdatasync (int fd, int pri, eio_cb cb, void *data);
175eio_req *eio_msync (void *addr, size_t length, int flags, int pri, eio_cb cb, void *data);
176eio_req *eio_mtouch (void *addr, size_t length, int flags, int pri, eio_cb cb, void *data);
177eio_req *eio_sync_file_range (int fd, off_t offset, size_t nbytes, unsigned int flags, int pri, eio_cb cb, void *data);
160eio_req *eio_close (int fd, int pri, eio_cb cb, void *data); 178eio_req *eio_close (int fd, int pri, eio_cb cb, void *data);
161eio_req *eio_readahead (int fd, off_t offset, size_t length, int pri, eio_cb cb, void *data); 179eio_req *eio_readahead (int fd, off_t offset, size_t length, int pri, eio_cb cb, void *data);
162eio_req *eio_read (int fd, void *buf, size_t length, off_t offset, int pri, eio_cb cb, void *data); 180eio_req *eio_read (int fd, void *buf, size_t length, off_t offset, int pri, eio_cb cb, void *data);
163eio_req *eio_write (int fd, void *buf, size_t length, off_t offset, int pri, eio_cb cb, void *data); 181eio_req *eio_write (int fd, void *buf, size_t length, off_t offset, int pri, eio_cb cb, void *data);
164eio_req *eio_fstat (int fd, int pri, eio_cb cb, void *data); /* stat buffer=ptr2 allocated dynamically */ 182eio_req *eio_fstat (int fd, int pri, eio_cb cb, void *data); /* stat buffer=ptr2 allocated dynamically */
… …
182eio_req *eio_lstat (const char *path, int pri, eio_cb cb, void *data); /* stat buffer=ptr2 allocated dynamically */ 200eio_req *eio_lstat (const char *path, int pri, eio_cb cb, void *data); /* stat buffer=ptr2 allocated dynamically */
183eio_req *eio_mknod (const char *path, mode_t mode, dev_t dev, int pri, eio_cb cb, void *data); 201eio_req *eio_mknod (const char *path, mode_t mode, dev_t dev, int pri, eio_cb cb, void *data);
184eio_req *eio_link (const char *path, const char *new_path, int pri, eio_cb cb, void *data); 202eio_req *eio_link (const char *path, const char *new_path, int pri, eio_cb cb, void *data);
185eio_req *eio_symlink (const char *path, const char *new_path, int pri, eio_cb cb, void *data); 203eio_req *eio_symlink (const char *path, const char *new_path, int pri, eio_cb cb, void *data);
186eio_req *eio_rename (const char *path, const char *new_path, int pri, eio_cb cb, void *data); 204eio_req *eio_rename (const char *path, const char *new_path, int pri, eio_cb cb, void *data);
205eio_req *eio_custom (eio_cb execute, int pri, eio_cb cb, void *data);
187#endif 206#endif
188 207
189/*****************************************************************************/ 208/*****************************************************************************/
190/* groups */ 209/* groups */
191 210
… …
217/*****************************************************************************/ 236/*****************************************************************************/
218/* convinience functions */ 237/* convinience functions */
219 238
220ssize_t eio_sendfile_sync (int ofd, int ifd, off_t offset, size_t count); 239ssize_t eio_sendfile_sync (int ofd, int ifd, off_t offset, size_t count);
221 240
241#ifdef __cplusplus
242}
222#endif 243#endif
223 244
245#endif
246

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines