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 */ |
… | |
… | |
258 | eio_req volatile *next; /* private ETP */ |
261 | eio_req volatile *next; /* private ETP */ |
259 | |
262 | |
260 | eio_wd wd; /* all applicable requests: working directory of pathname, old name; wd_open: return wd */ |
263 | eio_wd wd; /* all applicable requests: working directory of pathname, old name; wd_open: return wd */ |
261 | |
264 | |
262 | eio_ssize_t result; /* result of syscall, e.g. result = read (... */ |
265 | 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 */ |
266 | 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 */ |
267 | 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 */ |
268 | 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 */ |
269 | void *ptr2; /* all applicable requests: new name or memory buffer; readdir: name strings */ |
267 | eio_tstamp nv1; /* utime, futime: atime; busy: sleep time */ |
270 | eio_tstamp nv1; /* utime, futime: atime; busy: sleep time */ |
268 | eio_tstamp nv2; /* utime, futime: mtime */ |
271 | eio_tstamp nv2; /* utime, futime: mtime */ |
269 | |
272 | |
… | |
… | |
330 | unsigned int eio_npending (void); /* number of finished but unhandled requests */ |
333 | unsigned int eio_npending (void); /* number of finished but unhandled requests */ |
331 | unsigned int eio_nthreads (void); /* number of worker threads in use currently */ |
334 | unsigned int eio_nthreads (void); /* number of worker threads in use currently */ |
332 | |
335 | |
333 | /*****************************************************************************/ |
336 | /*****************************************************************************/ |
334 | /* convenience wrappers */ |
337 | /* convenience wrappers */ |
|
|
338 | /* these do not expose advanced syscalls and directory fds */ |
335 | |
339 | |
336 | #ifndef EIO_NO_WRAPPERS |
340 | #ifndef EIO_NO_WRAPPERS |
337 | eio_req *eio_wd_open (const char *path, int pri, eio_cb cb, void *data); /* result=wd */ |
341 | 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); |
342 | 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 */ |
343 | 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 */ |
383 | 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); |
384 | 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); |
385 | 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); |
386 | 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); |
387 | eio_req *eio_rename (const char *path, const char *new_path, int pri, eio_cb cb, void *data); |
|
|
388 | 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); |
389 | eio_req *eio_custom (void (*execute)(eio_req *), int pri, eio_cb cb, void *data); |
385 | #endif |
390 | #endif |
386 | |
391 | |
387 | /*****************************************************************************/ |
392 | /*****************************************************************************/ |
388 | /* groups */ |
393 | /* groups */ |