[ViewVC] Diff of: cvs/libeio/eio.h

Comparing libeio/eio.h (file contents):
Revision 1.10 by root, Tue May 13 18:54:52 2008 UTC vs.
Revision 1.55 by root, Sat Jun 13 00:06:13 2015 UTC

…		…
		1	/*
		2	* libeio API header
		3	*
		4	* Copyright (c) 2007,2008,2009,2010,2011,2012,2015 Marc Alexander Lehmann <libeio@schmorp.de>
		5	* All rights reserved.
		6	*
		7	* Redistribution and use in source and binary forms, with or without modifica-
		8	* tion, are permitted provided that the following conditions are met:
		9	*
		10	* 1. Redistributions of source code must retain the above copyright notice,
		11	* this list of conditions and the following disclaimer.
		12	*
		13	* 2. Redistributions in binary form must reproduce the above copyright
		14	* notice, this list of conditions and the following disclaimer in the
		15	* documentation and/or other materials provided with the distribution.
		16	*
		17	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
		18	* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MER-
		19	* CHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
		20	* EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPE-
		21	* CIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
		22	* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
		23	* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
		24	* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTH-
		25	* ERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
		26	* OF THE POSSIBILITY OF SUCH DAMAGE.
		27	*
		28	* Alternatively, the contents of this file may be used under the terms of
		29	* the GNU General Public License ("GPL") version 2 or any later version,
		30	* in which case the provisions of the GPL are applicable instead of
		31	* the above. If you wish to allow the use of your version of this file
		32	* only under the terms of the GPL and not to allow others to use your
		33	* version of this file under the BSD license, indicate your decision
		34	* by deleting the provisions above and replace them with the notice
		35	* and other provisions required by the GPL. If you do not delete the
		36	* provisions above, a recipient may use your version of this file under
		37	* either the BSD or the GPL.
		38	*/
		39
1	#ifndef EIO_H_	40	#ifndef EIO_H_
2	#define EIO_H_	41	#define EIO_H_
3		42
		43	#ifdef __cplusplus
		44	extern "C" {
		45	#endif
		46
4	#include <stddef.h>	47	#include <stddef.h>
		48	#include <signal.h>
5	#include <sys/types.h>	49	#include <sys/types.h>
6		50
7	typedef struct eio_req eio_req;	51	typedef struct eio_req eio_req;
		52	typedef struct eio_dirent eio_dirent;
8		53
9	typedef int (eio_cb)(eio_req req);	54	typedef int (eio_cb)(eio_req req);
10		55
11	#ifndef EIO_REQ_MEMBERS	56	#ifndef EIO_REQ_MEMBERS
12	# define EIO_REQ_MEMBERS	57	# define EIO_REQ_MEMBERS
13	#endif	58	#endif
14		59
15	#ifndef EIO_STRUCT_STAT	60	#ifndef EIO_STRUCT_STAT
		61	# ifdef _WIN32
		62	# define EIO_STRUCT_STAT struct _stati64
		63	# define EIO_STRUCT_STATI64
		64	# else
16	# define EIO_STRUCT_STAT struct stat	65	# define EIO_STRUCT_STAT struct stat
17	#endif	66	# endif
		67	#endif
18		68
		69	#ifdef _WIN32
		70	typedef int eio_uid_t;
		71	typedef int eio_gid_t;
		72	#ifdef __MINGW32__ /* no intptr_t */
		73	typedef ssize_t eio_ssize_t;
		74	#else
		75	typedef intptr_t eio_ssize_t; /* or SSIZE_T */
		76	#endif
		77	#if __GNUC__
		78	typedef long long eio_ino_t; /* signed for compatibility to msvc */
		79	#else
		80	typedef __int64 eio_ino_t; /* unsigned not supported by msvc */
		81	#endif
		82	#else
		83	typedef uid_t eio_uid_t;
		84	typedef gid_t eio_gid_t;
		85	typedef ssize_t eio_ssize_t;
		86	typedef ino_t eio_ino_t;
		87	#endif
		88
		89	#ifndef EIO_STRUCT_STATVFS
		90	# define EIO_STRUCT_STATVFS struct statvfs
		91	#endif
		92
		93	/* managing working directories */
		94
		95	typedef struct eio_pwd *eio_wd;
		96
		97	#define EIO_CWD 0 /* the current working directory of the process, guaranteed to be a null pointer */
		98	#define EIO_INVALID_WD ((eio_wd)(int)-1) /* failure return for eio_wd_open */
		99
		100	eio_wd eio_wd_open_sync (eio_wd wd, const char *path);
		101	void eio_wd_close_sync (eio_wd wd);
		102
		103	/* for readdir */
		104
		105	/* eio_readdir flags */
19	enum {	106	enum
		107	{
		108	EIO_READDIR_DENTS = 0x01, /* ptr2 contains eio_dirents, not just the (unsorted) names */
		109	EIO_READDIR_DIRS_FIRST = 0x02, /* dirents gets sorted into a good stat() ing order to find directories first */
		110	EIO_READDIR_STAT_ORDER = 0x04, /* dirents gets sorted into a good stat() ing order to quickly stat all files */
		111	EIO_READDIR_FOUND_UNKNOWN = 0x80, /* set by eio_readdir when _ARRAY was set and any TYPE=UNKNOWN's were found /
		112
		113	EIO_READDIR_CUSTOM1 = 0x100, /* for use by apps */
		114	EIO_READDIR_CUSTOM2 = 0x200 /* for use by apps */
		115	};
		116
		117	/* using "typical" values in the hope that the compiler will do something sensible */
		118	enum eio_dtype
		119	{
		120	EIO_DT_UNKNOWN = 0,
		121	EIO_DT_FIFO = 1,
		122	EIO_DT_CHR = 2,
		123	EIO_DT_MPC = 3, /* multiplexed char device (v7+coherent) */
		124	EIO_DT_DIR = 4,
		125	EIO_DT_NAM = 5, /* xenix special named file */
		126	EIO_DT_BLK = 6,
		127	EIO_DT_MPB = 7, /* multiplexed block device (v7+coherent) */
		128	EIO_DT_REG = 8,
		129	EIO_DT_NWK = 9, /* HP-UX network special */
		130	EIO_DT_CMP = 9, /* VxFS compressed */
		131	EIO_DT_LNK = 10,
		132	/* DT_SHAD = 11,*/
		133	EIO_DT_SOCK = 12,
		134	EIO_DT_DOOR = 13, /* solaris door */
		135	EIO_DT_WHT = 14,
		136	EIO_DT_MAX = 15 /* highest DT_VALUE ever, hopefully */
		137	};
		138
		139	struct eio_dirent
		140	{
		141	int nameofs; /* offset of null-terminated name string in (char )req->ptr2 /
		142	unsigned short namelen; /* size of filename without trailing 0 */
		143	unsigned char type; /* one of EIO_DT_* */
		144	signed char score; /* internal use */
		145	eio_ino_t inode; /* the inode number, if available, otherwise unspecified */
		146	};
		147
		148	/* eio_msync flags */
		149	enum
		150	{
		151	EIO_MS_ASYNC = 1,
		152	EIO_MS_INVALIDATE = 2,
		153	EIO_MS_SYNC = 4
		154	};
		155
		156	/* eio_mtouch flags */
		157	enum
		158	{
		159	EIO_MT_MODIFY = 1
		160	};
		161
		162	/* eio_sync_file_range flags */
		163	enum
		164	{
		165	EIO_SYNC_FILE_RANGE_WAIT_BEFORE = 1,
		166	EIO_SYNC_FILE_RANGE_WRITE = 2,
		167	EIO_SYNC_FILE_RANGE_WAIT_AFTER = 4
		168	};
		169
		170	/* eio_fallocate flags */
		171	enum
		172	{
		173	/* these MUST match the value in linux/falloc.h */
		174	EIO_FALLOC_FL_KEEP_SIZE = 0x01,
		175	EIO_FALLOC_FL_PUNCH_HOLE = 0x02,
		176	EIO_FALLOC_FL_COLLAPSE_RANGE = 0x08,
		177	EIO_FALLOC_FL_ZERO_RANGE = 0x10
		178	};
		179
		180	/* timestamps and differences - feel free to use double in your code directly */
		181	typedef double eio_tstamp;
		182
		183	/* the eio request structure */
		184	enum
		185	{
20	EIO_QUIT,	186	EIO_CUSTOM,
		187	EIO_WD_OPEN, EIO_WD_CLOSE,
		188
21	EIO_OPEN, EIO_CLOSE, EIO_DUP2,	189	EIO_CLOSE, EIO_DUP2,
22	EIO_READ, EIO_WRITE,	190	EIO_SEEK, EIO_READ, EIO_WRITE,
23	EIO_READAHEAD, EIO_SENDFILE,	191	EIO_READAHEAD, EIO_SENDFILE,
24	EIO_STAT, EIO_LSTAT, EIO_FSTAT,	192	EIO_FSTAT, EIO_FSTATVFS,
25	EIO_TRUNCATE, EIO_FTRUNCATE,	193	EIO_FTRUNCATE, EIO_FUTIME, EIO_FCHMOD, EIO_FCHOWN,
26	EIO_UTIME, EIO_FUTIME,
27	EIO_CHMOD, EIO_FCHMOD,
28	EIO_CHOWN, EIO_FCHOWN,
29	EIO_SYNC, EIO_FSYNC, EIO_FDATASYNC,	194	EIO_SYNC, EIO_FSYNC, EIO_FDATASYNC, EIO_SYNCFS,
30	EIO_UNLINK, EIO_RMDIR, EIO_MKDIR, EIO_RENAME,	195	EIO_MSYNC, EIO_MTOUCH, EIO_SYNC_FILE_RANGE, EIO_FALLOCATE,
31	EIO_MKNOD, EIO_READDIR,	196	EIO_MLOCK, EIO_MLOCKALL,
32	EIO_LINK, EIO_SYMLINK, EIO_READLINK,
33	EIO_GROUP, EIO_NOP,	197	EIO_GROUP, EIO_NOP,
34	EIO_BUSY,	198	EIO_BUSY,
35	};
36		199
37	typedef double eio_tstamp; /* feel free to use double in your code directly */	200	/* these use wd + ptr1, but are emulated */
		201	EIO_REALPATH,
		202	EIO_READDIR,
38		203
39	/* eio request structure */	204	/* all the following requests use wd + ptr1 as path in xxxat functions */
40	/* this structure is mostly read-only */	205	EIO_OPEN,
41	struct eio_req	206	EIO_STAT, EIO_LSTAT, EIO_STATVFS,
42	{	207	EIO_TRUNCATE,
43	eio_req volatile next; / private */	208	EIO_UTIME,
		209	EIO_CHMOD,
		210	EIO_CHOWN,
		211	EIO_UNLINK, EIO_RMDIR, EIO_MKDIR, EIO_RENAME,
		212	EIO_MKNOD,
		213	EIO_LINK, EIO_SYMLINK, EIO_READLINK,
44		214
45	ssize_t result; /* result of syscall, e.g. result = read (... */	215	EIO_REQ_TYPE_NUM
46	off_t offs; /* read, write, truncate, readahead: file offset; mknod: dev_t */
47	size_t size; /* read, write, readahead, sendfile: length */
48	void ptr1; / all applicable requests: pathname, old name */
49	void ptr2; / all applicable requests: new name or memory buffer */
50	eio_tstamp nv1; /* utime, futime: atime; busy: sleep time */
51	eio_tstamp nv2; /* utime, futime: mtime */
52
53	int type; /* EIO_xxx constant */
54	int int1; /* all applicable requests: file descriptor; sendfile: output fd; open: flags */
55	long int2; /* chown, fchown: uid; sendfile: input fd; open, chmod, mkdir, mknod: file mode */
56	long int3; /* chown, fchown: gid */
57	int errorno; /* errno value on syscall return */
58
59	unsigned char flags; /* private */
60	signed char pri; /* the priority */
61
62	void *data;
63	eio_cb finish;
64	void (destroy)(eio_req req); /* called when requets no longer needed */
65	void (feed)(eio_req req); /* only used for group requests */
66
67	EIO_REQ_MEMBERS
68
69	eio_req grp, grp_prev, grp_next, grp_first; /* private */
70	};	216	};
71		217
		218	/* seek whence modes */
		219	/* these are guaranteed to hasve the traditional 0, 1, 2 values, */
		220	/* so you might as wlel use those */
72	enum {	221	enum
73	EIO_FLAG_CANCELLED = 0x01, /* request was cancelled */	222	{
74	EIO_FLAG_PTR1_FREE = 0x02, /* need to free(ptr1) */	223	EIO_SEEK_SET = 0,
75	EIO_FLAG_PTR2_FREE = 0x04 /* need to free(ptr2) */	224	EIO_SEEK_CUR = 1,
		225	EIO_SEEK_END = 2
76	};	226	};
		227
		228
		229	/* mlockall constants */
		230	enum
		231	{
		232	EIO_MCL_CURRENT = 1,
		233	EIO_MCL_FUTURE = 2
		234	};
		235
		236	/* request priorities */
77		237
78	enum {	238	enum {
79	EIO_PRI_MIN = -4,	239	EIO_PRI_MIN = -4,
80	EIO_PRI_MAX = 4,	240	EIO_PRI_MAX = 4,
81
82	EIO_PRI_DEFAULT = 0,	241	EIO_PRI_DEFAULT = 0
83	EIO_PRI_BIAS = -EIO_PRI_MIN,
84	EIO_NUM_PRI = EIO_PRI_MAX + EIO_PRI_BIAS + 1
85	};	242	};
		243
		244	/* eio request structure */
		245	/* this structure is mostly read-only */
		246	/* when initialising it, all members must be zero-initialised */
		247	struct eio_req
		248	{
		249	eio_req volatile next; / private ETP */
		250
		251	eio_wd wd; /* all applicable requests: working directory of pathname, old name; wd_open: return wd */
		252
		253	eio_ssize_t result; /* result of syscall, e.g. result = read (... */
		254	off_t offs; /* read, write, truncate, readahead, sync_file_range, fallocate: file offset, mknod: dev_t */
		255	size_t size; /* read, write, readahead, sendfile, msync, mlock, sync_file_range, fallocate: length */
		256	void ptr1; / all applicable requests: pathname, old name; readdir: optional eio_dirents */
		257	void ptr2; / all applicable requests: new name or memory buffer; readdir: name strings */
		258	eio_tstamp nv1; /* utime, futime: atime; busy: sleep time */
		259	eio_tstamp nv2; /* utime, futime: mtime */
		260
		261	int int1; /* all applicable requests: file descriptor; sendfile: output fd; open, msync, mlockall, readdir: flags */
		262	long int2; /* chown, fchown: uid; sendfile: input fd; open, chmod, mkdir, mknod: file mode, seek: whence, sync_file_range, fallocate: flags */
		263	long int3; /* chown, fchown: gid; rename, link: working directory of new name */
		264	int errorno; /* errno value on syscall return */
		265
		266	unsigned char flags; /* private */
		267
		268	signed char type;/* EIO_xxx constant ETP */
		269	signed char pri; /* the priority ETP */
		270	#if __i386 \|\| __amd64
		271	unsigned char cancelled; /* ETP */
		272	#else
		273	sig_atomic_t cancelled; /* ETP */
		274	#endif
		275
		276	void *data;
		277	eio_cb finish;
		278	void (destroy)(eio_req req); /* called when request no longer needed */
		279	void (feed)(eio_req req); /* only used for group requests */
		280
		281	EIO_REQ_MEMBERS
		282
		283	eio_req grp, grp_prev, grp_next, grp_first; /* private ETP */
		284	};
		285
		286	/* _private_ request flags */
		287	enum {
		288	EIO_FLAG_PTR1_FREE = 0x01, /* need to free(ptr1) */
		289	EIO_FLAG_PTR2_FREE = 0x02, /* need to free(ptr2) */
		290	EIO_FLAG_GROUPADD = 0x04 /* some request was added to the group */
		291	};
		292
		293	/* undocumented/unsupported/private helper */
		294	/void eio_page_align (void addr, size_t length);*/
86		295
87	/* returns < 0 on error, errno set	296	/* returns < 0 on error, errno set
88	* need_poll, if non-zero, will be called when results are available	297	* need_poll, if non-zero, will be called when results are available
89	* and eio_poll_cb needs to be invoked (it MUST NOT call eio_poll_cb itself).	298	* and eio_poll_cb needs to be invoked (it MUST NOT call eio_poll_cb itself).
90	* done_poll is called when the need to poll is gone.	299	* done_poll is called when the need to poll is gone.
104	* maximum wanted number	313	* maximum wanted number
105	* or maximum idle number of threads */	314	* or maximum idle number of threads */
106	void eio_set_min_parallel (unsigned int nthreads);	315	void eio_set_min_parallel (unsigned int nthreads);
107	void eio_set_max_parallel (unsigned int nthreads);	316	void eio_set_max_parallel (unsigned int nthreads);
108	void eio_set_max_idle (unsigned int nthreads);	317	void eio_set_max_idle (unsigned int nthreads);
		318	void eio_set_idle_timeout (unsigned int seconds);
109		319
110	unsigned int eio_nreqs (void); /* number of requests in-flight */	320	unsigned int eio_nreqs (void); /* number of requests in-flight */
111	unsigned int eio_nready (void); /* number of not-yet handled requests */	321	unsigned int eio_nready (void); /* number of not-yet handled requests */
112	unsigned int eio_npending (void); /* numbe rof finished but unhandled requests */	322	unsigned int eio_npending (void); /* number of finished but unhandled requests */
113	unsigned int eio_nthreads (void); /* number of worker threads in use currently */	323	unsigned int eio_nthreads (void); /* number of worker threads in use currently */
114		324
115	/*****************************************************************************/	325	/*****************************************************************************/
116	/* high-level request API */	326	/* convenience wrappers */
117		327
118	#ifndef EIO_NO_WRAPPERS	328	#ifndef EIO_NO_WRAPPERS
		329	eio_req eio_wd_open (const char path, int pri, eio_cb cb, void data); / result=wd */
		330	eio_req eio_wd_close (eio_wd wd, int pri, eio_cb cb, void data);
119	eio_req eio_nop (int pri, eio_cb cb, void data); /* does nothing except go through the whole process */	331	eio_req eio_nop (int pri, eio_cb cb, void data); /* does nothing except go through the whole process */
120	eio_req eio_busy (eio_tstamp delay, int pri, eio_cb cb, void data); /* ties a thread for this long, simulating busyness */	332	eio_req eio_busy (eio_tstamp delay, int pri, eio_cb cb, void data); /* ties a thread for this long, simulating busyness */
121	eio_req eio_sync (int pri, eio_cb cb, void data);	333	eio_req eio_sync (int pri, eio_cb cb, void data);
122	eio_req eio_fsync (int fd, int pri, eio_cb cb, void data);	334	eio_req eio_fsync (int fd, int pri, eio_cb cb, void data);
123	eio_req eio_fdatasync (int fd, int pri, eio_cb cb, void data);	335	eio_req eio_fdatasync (int fd, int pri, eio_cb cb, void data);
		336	eio_req eio_syncfs (int fd, int pri, eio_cb cb, void data);
		337	eio_req eio_msync (void addr, size_t length, int flags, int pri, eio_cb cb, void *data);
		338	eio_req eio_mtouch (void addr, size_t length, int flags, int pri, eio_cb cb, void *data);
		339	eio_req eio_mlock (void addr, size_t length, int pri, eio_cb cb, void *data);
		340	eio_req eio_mlockall (int flags, int pri, eio_cb cb, void data);
		341	eio_req eio_sync_file_range (int fd, off_t offset, size_t nbytes, unsigned int flags, int pri, eio_cb cb, void data);
		342	eio_req eio_fallocate (int fd, int mode, off_t offset, size_t len, int pri, eio_cb cb, void data);
124	eio_req eio_close (int fd, int pri, eio_cb cb, void data);	343	eio_req eio_close (int fd, int pri, eio_cb cb, void data);
125	eio_req eio_readahead (int fd, off_t offset, size_t length, int pri, eio_cb cb, void data);	344	eio_req eio_readahead (int fd, off_t offset, size_t length, int pri, eio_cb cb, void data);
		345	eio_req eio_seek (int fd, off_t offset, int whence, int pri, eio_cb cb, void data);
126	eio_req eio_read (int fd, void buf, size_t length, off_t offset, int pri, eio_cb cb, void *data);	346	eio_req eio_read (int fd, void buf, size_t length, off_t offset, int pri, eio_cb cb, void *data);
127	eio_req eio_write (int fd, void buf, size_t length, off_t offset, int pri, eio_cb cb, void *data);	347	eio_req eio_write (int fd, void buf, size_t length, off_t offset, int pri, eio_cb cb, void *data);
128	eio_req eio_fstat (int fd, int pri, eio_cb cb, void data); /* stat buffer=ptr2 allocated dynamically */	348	eio_req eio_fstat (int fd, int pri, eio_cb cb, void data); /* stat buffer=ptr2 allocated dynamically */
		349	eio_req eio_fstatvfs (int fd, int pri, eio_cb cb, void data); /* stat buffer=ptr2 allocated dynamically */
129	eio_req eio_futime (int fd, eio_tstamp atime, eio_tstamp mtime, int pri, eio_cb cb, void data);	350	eio_req eio_futime (int fd, eio_tstamp atime, eio_tstamp mtime, int pri, eio_cb cb, void data);
130	eio_req eio_ftruncate (int fd, off_t offset, int pri, eio_cb cb, void data);	351	eio_req eio_ftruncate (int fd, off_t offset, int pri, eio_cb cb, void data);
131	eio_req eio_fchmod (int fd, mode_t mode, int pri, eio_cb cb, void data);	352	eio_req eio_fchmod (int fd, mode_t mode, int pri, eio_cb cb, void data);
132	eio_req eio_fchown (int fd, uid_t uid, gid_t gid, int pri, eio_cb cb, void data);	353	eio_req eio_fchown (int fd, eio_uid_t uid, eio_gid_t gid, int pri, eio_cb cb, void data);
133	eio_req eio_dup2 (int fd, int fd2, int pri, eio_cb cb, void data);	354	eio_req eio_dup2 (int fd, int fd2, int pri, eio_cb cb, void data);
134	eio_req eio_sendfile (int out_fd, int in_fd, off_t in_offset, size_t length, int pri, eio_cb cb, void data);	355	eio_req eio_sendfile (int out_fd, int in_fd, off_t in_offset, size_t length, int pri, eio_cb cb, void data);
135	eio_req eio_open (const char path, int flags, mode_t mode, int pri, eio_cb cb, void *data);	356	eio_req eio_open (const char path, int flags, mode_t mode, int pri, eio_cb cb, void *data);
136	eio_req eio_utime (const char path, eio_tstamp atime, eio_tstamp mtime, int pri, eio_cb cb, void *data);	357	eio_req eio_utime (const char path, eio_tstamp atime, eio_tstamp mtime, int pri, eio_cb cb, void *data);
137	eio_req eio_truncate (const char path, off_t offset, int pri, eio_cb cb, void *data);	358	eio_req eio_truncate (const char path, off_t offset, int pri, eio_cb cb, void *data);
138	eio_req eio_chown (const char path, uid_t uid, gid_t gid, int pri, eio_cb cb, void *data);	359	eio_req eio_chown (const char path, eio_uid_t uid, eio_gid_t gid, int pri, eio_cb cb, void *data);
139	eio_req eio_chmod (const char path, mode_t mode, int pri, eio_cb cb, void *data);	360	eio_req eio_chmod (const char path, mode_t mode, int pri, eio_cb cb, void *data);
140	eio_req eio_mkdir (const char path, mode_t mode, int pri, eio_cb cb, void *data);	361	eio_req eio_mkdir (const char path, mode_t mode, int pri, eio_cb cb, void *data);
141	eio_req eio_readdir (const char path, int pri, eio_cb cb, void data); / result=ptr2 allocated dynamically */	362	eio_req eio_readdir (const char path, int flags, int pri, eio_cb cb, void data); / result=ptr2 allocated dynamically */
142	eio_req eio_rmdir (const char path, int pri, eio_cb cb, void *data);	363	eio_req eio_rmdir (const char path, int pri, eio_cb cb, void *data);
143	eio_req eio_unlink (const char path, int pri, eio_cb cb, void *data);	364	eio_req eio_unlink (const char path, int pri, eio_cb cb, void *data);
144	eio_req eio_readlink (const char path, int pri, eio_cb cb, void data); / result=ptr2 allocated dynamically */	365	eio_req eio_readlink (const char path, int pri, eio_cb cb, void data); / result=ptr2 allocated dynamically */
		366	eio_req eio_realpath (const char path, int pri, eio_cb cb, void data); / result=ptr2 allocated dynamically */
145	eio_req eio_stat (const char path, int pri, eio_cb cb, void data); / stat buffer=ptr2 allocated dynamically */	367	eio_req eio_stat (const char path, int pri, eio_cb cb, void data); / stat buffer=ptr2 allocated dynamically */
146	eio_req eio_lstat (const char path, int pri, eio_cb cb, void data); / stat buffer=ptr2 allocated dynamically */	368	eio_req eio_lstat (const char path, int pri, eio_cb cb, void data); / stat buffer=ptr2 allocated dynamically */
		369	eio_req eio_statvfs (const char path, int pri, eio_cb cb, void data); / stat buffer=ptr2 allocated dynamically */
147	eio_req eio_mknod (const char path, mode_t mode, dev_t dev, int pri, eio_cb cb, void *data);	370	eio_req eio_mknod (const char path, mode_t mode, dev_t dev, int pri, eio_cb cb, void *data);
148	eio_req eio_link (const char path, const char new_path, int pri, eio_cb cb, void data);	371	eio_req eio_link (const char path, const char new_path, int pri, eio_cb cb, void data);
149	eio_req eio_symlink (const char path, const char new_path, int pri, eio_cb cb, void data);	372	eio_req eio_symlink (const char path, const char new_path, int pri, eio_cb cb, void data);
150	eio_req eio_rename (const char path, const char new_path, int pri, eio_cb cb, void data);	373	eio_req eio_rename (const char path, const char new_path, int pri, eio_cb cb, void data);
		374	eio_req eio_custom (void (execute)(eio_req ), int pri, eio_cb cb, void data);
151	#endif	375	#endif
152		376
		377	/*****************************************************************************/
153	/* for groups */	378	/* groups */
		379
154	eio_req eio_grp (eio_cb cb, void data);	380	eio_req eio_grp (eio_cb cb, void data);
155	void eio_grp_feed (eio_req grp, void (feed)(eio_req *req), int limit);	381	void eio_grp_feed (eio_req grp, void (feed)(eio_req *req), int limit);
156	void eio_grp_limit (eio_req *grp, int limit);	382	void eio_grp_limit (eio_req *grp, int limit);
157	void eio_grp_add (eio_req grp, eio_req req);	383	void eio_grp_add (eio_req grp, eio_req req);
158	void eio_grp_cancel (eio_req grp); / cancels all sub requests but not the group */	384	void eio_grp_cancel (eio_req grp); / cancels all sub requests but not the group */
159		385
160	/* cancel a request as soon fast as possible */	386	/*****************************************************************************/
161	void eio_cancel (eio_req *req);	387	/* request api */
162	/* destroy a request that has never been submitted */
163	void eio_destroy (eio_req *req);
164		388
165	/* true if the request was cancelled, useful in the invoke callback */	389	/* true if the request was cancelled, useful in the invoke callback */
166	#define EIO_CANCELLED(req) ((req)->flags & EIO_FLAG_CANCELLED)	390	#define EIO_CANCELLED(req) ((req)->cancelled)
167		391
168	#define EIO_RESULT(req) ((req)->result)	392	#define EIO_RESULT(req) ((req)->result)
169	/* returns a pointer to the result buffer allocated by eio */	393	/* returns a pointer to the result buffer allocated by eio */
170	#define EIO_BUF(req) ((req)->ptr2)	394	#define EIO_BUF(req) ((req)->ptr2)
171	#define EIO_STAT_BUF(req) ((EIO_STRUCT_STAT *)EIO_BUF(req))	395	#define EIO_STAT_BUF(req) ((EIO_STRUCT_STAT *)EIO_BUF(req))
		396	#define EIO_STATVFS_BUF(req) ((EIO_STRUCT_STATVFS *)EIO_BUF(req))
172	#define EIO_PATH(req) ((char *)(req)->ptr1)	397	#define EIO_PATH(req) ((char *)(req)->ptr1)
173
174	/*****************************************************************************/
175	/* low-level request API */
176
177	/* must be used to initialise eio_req's */
178	#define EIO_INIT(req,prio,finish_cb, destroy_cb) \
179	memset ((req), 0, sizeof (eio_req)); \
180	(req)->pri = (prio) + EIO_PRI_BIAS; \
181	(req)->finish = (finish_cb); \
182	(req)->destroy = (destroy_cb)
183		398
184	/* submit a request for execution */	399	/* submit a request for execution */
185	void eio_submit (eio_req *req);	400	void eio_submit (eio_req *req);
		401	/* cancel a request as soon fast as possible, if possible */
		402	void eio_cancel (eio_req *req);
186		403
187	/*****************************************************************************/	404	/*****************************************************************************/
188	/* convinience functions */	405	/* convenience functions */
189		406
190	ssize_t eio_sendfile_sync (int ofd, int ifd, off_t offset, size_t count);	407	eio_ssize_t eio_sendfile_sync (int ofd, int ifd, off_t offset, size_t count);
191		408
		409	#ifdef __cplusplus
		410	}
192	#endif	411	#endif
193		412
		413	#endif
		414

Diff Legend

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

Comparing libeio/eio.h (file contents): Revision 1.10 by root, Tue May 13 18:54:52 2008 UTC vs. Revision 1.55 by root, Sat Jun 13 00:06:13 2015 UTC

Diff Legend

Comparing libeio/eio.h (file contents):
Revision 1.10 by root, Tue May 13 18:54:52 2008 UTC vs.
Revision 1.55 by root, Sat Jun 13 00:06:13 2015 UTC