mirror
/
transmission
mirror of https://github.com/transmission/transmission
1
0
Fork 0
Code Issues Releases Wiki Activity
transmission/libtransmission/watchdir-common.h

50 lines
1.1 KiB
C
Raw Normal View History

#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
/*
* This file Copyright (C) 2015-2016 Mnemosyne LLC
*
* It may be used under the GNU GPL versions 2 or 3
* or any future license endorsed by Mnemosyne LLC.
*
*/
use '#pragma once' instead of #ifndef..#define..#endif guards
2016-03-29 16:37:21 +00:00
#pragma once
#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
#ifndef __LIBTRANSMISSION_WATCHDIR_MODULE__
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
#error only the libtransmission watchdir module should #include this header.
#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
#endif
struct tr_ptrArray;
typedef struct tr_watchdir_backend
{
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
void (* free_func)(struct tr_watchdir_backend*);
#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
}
tr_watchdir_backend;
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
#define BACKEND_DOWNCAST(b) ((tr_watchdir_backend*)(b))
#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
/* ... */
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
tr_watchdir_backend* tr_watchdir_get_backend(tr_watchdir_t handle);
#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
struct event_base* tr_watchdir_get_event_base(tr_watchdir_t handle);
#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
/* ... */
Align type qualifiers to the right (code style) This way all the qualifiers (`const`, `volatile`, `mutable`) are grouped together, e.g. `T const* const x` vs. `const T* const x`. Also helps reading types right-to-left, e.g. "constant pointer to constant T" vs. "constant pointer to T which is constant".
2017-04-20 16:02:19 +00:00
void tr_watchdir_process(tr_watchdir_t handle, char const* name);
#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
void tr_watchdir_scan(tr_watchdir_t handle, struct tr_ptrArray* dir_entries);
#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
/* ... */
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
tr_watchdir_backend* tr_watchdir_generic_new(tr_watchdir_t handle);
#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
#ifdef WITH_INOTIFY
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
tr_watchdir_backend* tr_watchdir_inotify_new(tr_watchdir_t handle);
#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
#endif
#ifdef WITH_KQUEUE
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
tr_watchdir_backend* tr_watchdir_kqueue_new(tr_watchdir_t handle);
#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
#endif
#ifdef _WIN32
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
tr_watchdir_backend* tr_watchdir_win32_new(tr_watchdir_t handle);
#5663: Rework directory watching in daemon Implement BSD/Darwin (kqueue) and Windows (ReadDirectoryChanges) mechanisms for receiving directory change notifications. Use events instead of polling for changes. Retry file parsing up to 3 times before giving up. Huge thanks to missionsix for preparing first two versions of the patch.
2016-01-02 14:28:59 +00:00
#endif