1 | /* |
1 | /* |
2 | * libeio API header |
2 | * libeio API header |
3 | * |
3 | * |
4 | * Copyright (c) 2007,2008,2009,2010,2011,2012,2015,2016 Marc Alexander Lehmann <libeio@schmorp.de> |
4 | * Copyright (c) 2007,2008,2009,2010,2011,2012,2015,2016,2017 Marc Alexander Lehmann <libeio@schmorp.de> |
5 | * All rights reserved. |
5 | * All rights reserved. |
6 | * |
6 | * |
7 | * Redistribution and use in source and binary forms, with or without modifica- |
7 | * Redistribution and use in source and binary forms, with or without modifica- |
8 | * tion, are permitted provided that the following conditions are met: |
8 | * tion, are permitted provided that the following conditions are met: |
9 | * |
9 | * |
… | |
… | |
172 | { |
172 | { |
173 | /* these MUST match the value in linux/falloc.h */ |
173 | /* these MUST match the value in linux/falloc.h */ |
174 | EIO_FALLOC_FL_KEEP_SIZE = 0x01, |
174 | EIO_FALLOC_FL_KEEP_SIZE = 0x01, |
175 | EIO_FALLOC_FL_PUNCH_HOLE = 0x02, |
175 | EIO_FALLOC_FL_PUNCH_HOLE = 0x02, |
176 | EIO_FALLOC_FL_COLLAPSE_RANGE = 0x08, |
176 | EIO_FALLOC_FL_COLLAPSE_RANGE = 0x08, |
177 | EIO_FALLOC_FL_ZERO_RANGE = 0x10 |
177 | EIO_FALLOC_FL_ZERO_RANGE = 0x10, |
|
|
178 | EIO_FALLOC_FL_INSERT_RANGE = 0x20, |
|
|
179 | EIO_FALLOC_FL_UNSHARE_RANGE = 0x40 |
178 | }; |
180 | }; |
179 | |
181 | |
180 | /* eio_rename flags */ |
182 | /* eio_rename flags */ |
181 | enum |
183 | enum |
182 | { |
184 | { |
… | |
… | |
218 | EIO_CHMOD, |
220 | EIO_CHMOD, |
219 | EIO_CHOWN, |
221 | EIO_CHOWN, |
220 | EIO_UNLINK, EIO_RMDIR, EIO_MKDIR, EIO_RENAME, |
222 | EIO_UNLINK, EIO_RMDIR, EIO_MKDIR, EIO_RENAME, |
221 | EIO_MKNOD, |
223 | EIO_MKNOD, |
222 | EIO_LINK, EIO_SYMLINK, EIO_READLINK, |
224 | EIO_LINK, EIO_SYMLINK, EIO_READLINK, |
|
|
225 | EIO_SLURP, /* open + read + close */ |
223 | |
226 | |
224 | EIO_REQ_TYPE_NUM |
227 | EIO_REQ_TYPE_NUM |
225 | }; |
228 | }; |
226 | |
229 | |
227 | /* seek whence modes */ |
230 | /* seek whence modes */ |
… | |
… | |
237 | |
240 | |
238 | /* mlockall constants */ |
241 | /* mlockall constants */ |
239 | enum |
242 | enum |
240 | { |
243 | { |
241 | EIO_MCL_CURRENT = 1, |
244 | EIO_MCL_CURRENT = 1, |
242 | EIO_MCL_FUTURE = 2 |
245 | EIO_MCL_FUTURE = 2, |
|
|
246 | EIO_MCL_ONFAULT = 4 |
243 | }; |
247 | }; |
244 | |
248 | |
245 | /* request priorities */ |
249 | /* request priorities */ |
246 | |
250 | |
247 | enum { |
251 | enum { |
… | |
… | |
258 | eio_req volatile *next; /* private ETP */ |
262 | eio_req volatile *next; /* private ETP */ |
259 | |
263 | |
260 | eio_wd wd; /* all applicable requests: working directory of pathname, old name; wd_open: return wd */ |
264 | eio_wd wd; /* all applicable requests: working directory of pathname, old name; wd_open: return wd */ |
261 | |
265 | |
262 | eio_ssize_t result; /* result of syscall, e.g. result = read (... */ |
266 | eio_ssize_t result; /* result of syscall, e.g. result = read (... */ |
263 | off_t offs; /* read, write, truncate, readahead, sync_file_range, fallocate: file offset, mknod: dev_t */ |
267 | off_t offs; /* read, write, truncate, readahead, sync_file_range, fallocate, slurp: file offset, mknod: dev_t */ |
264 | size_t size; /* read, write, readahead, sendfile, msync, mlock, sync_file_range, fallocate: length */ |
268 | size_t size; /* read, write, readahead, sendfile, msync, mlock, sync_file_range, fallocate, slurp: length */ |
265 | void *ptr1; /* all applicable requests: pathname, old name, readdir: optional eio_dirents */ |
269 | void *ptr1; /* all applicable requests: pathname, old name, readdir: optional eio_dirents */ |
266 | void *ptr2; /* all applicable requests: new name or memory buffer; readdir: name strings */ |
270 | void *ptr2; /* all applicable requests: new name or memory buffer; readdir: name strings */ |
267 | eio_tstamp nv1; /* utime, futime: atime; busy: sleep time */ |
271 | eio_tstamp nv1; /* utime, futime: atime; busy: sleep time */ |
268 | eio_tstamp nv2; /* utime, futime: mtime */ |
272 | eio_tstamp nv2; /* utime, futime: mtime */ |
269 | |
273 | |
… | |
… | |
330 | unsigned int eio_npending (void); /* number of finished but unhandled requests */ |
334 | unsigned int eio_npending (void); /* number of finished but unhandled requests */ |
331 | unsigned int eio_nthreads (void); /* number of worker threads in use currently */ |
335 | unsigned int eio_nthreads (void); /* number of worker threads in use currently */ |
332 | |
336 | |
333 | /*****************************************************************************/ |
337 | /*****************************************************************************/ |
334 | /* convenience wrappers */ |
338 | /* convenience wrappers */ |
|
|
339 | /* these do not expose advanced syscalls and directory fds */ |
335 | |
340 | |
336 | #ifndef EIO_NO_WRAPPERS |
341 | #ifndef EIO_NO_WRAPPERS |
337 | eio_req *eio_wd_open (const char *path, int pri, eio_cb cb, void *data); /* result=wd */ |
342 | eio_req *eio_wd_open (const char *path, int pri, eio_cb cb, void *data); /* result=wd */ |
338 | eio_req *eio_wd_close (eio_wd wd, int pri, eio_cb cb, void *data); |
343 | eio_req *eio_wd_close (eio_wd wd, int pri, eio_cb cb, void *data); |
339 | eio_req *eio_nop (int pri, eio_cb cb, void *data); /* does nothing except go through the whole process */ |
344 | eio_req *eio_nop (int pri, eio_cb cb, void *data); /* does nothing except go through the whole process */ |
… | |
… | |
379 | eio_req *eio_statvfs (const char *path, int pri, eio_cb cb, void *data); /* stat buffer=ptr2 allocated dynamically */ |
384 | eio_req *eio_statvfs (const char *path, int pri, eio_cb cb, void *data); /* stat buffer=ptr2 allocated dynamically */ |
380 | eio_req *eio_mknod (const char *path, mode_t mode, dev_t dev, int pri, eio_cb cb, void *data); |
385 | eio_req *eio_mknod (const char *path, mode_t mode, dev_t dev, int pri, eio_cb cb, void *data); |
381 | eio_req *eio_link (const char *path, const char *new_path, int pri, eio_cb cb, void *data); |
386 | eio_req *eio_link (const char *path, const char *new_path, int pri, eio_cb cb, void *data); |
382 | eio_req *eio_symlink (const char *path, const char *new_path, int pri, eio_cb cb, void *data); |
387 | eio_req *eio_symlink (const char *path, const char *new_path, int pri, eio_cb cb, void *data); |
383 | eio_req *eio_rename (const char *path, const char *new_path, int pri, eio_cb cb, void *data); |
388 | eio_req *eio_rename (const char *path, const char *new_path, int pri, eio_cb cb, void *data); |
|
|
389 | eio_req *eio_slurp (const char *path, void *buf, size_t length, off_t offset, int pri, eio_cb cb, void *data); |
384 | eio_req *eio_custom (void (*execute)(eio_req *), int pri, eio_cb cb, void *data); |
390 | eio_req *eio_custom (void (*execute)(eio_req *), int pri, eio_cb cb, void *data); |
385 | #endif |
391 | #endif |
386 | |
392 | |
387 | /*****************************************************************************/ |
393 | /*****************************************************************************/ |
388 | /* groups */ |
394 | /* groups */ |