transmission/libtransmission/trevent.h

// This file Copyright © 2007-2022 Mnemosyne LLC.
// It may be used under GPLv2 (SPDX: GPL-2.0), GPLv3 (SPDX: GPL-3.0),
// or any future license endorsed by Mnemosyne LLC.
// License text can be found in the licenses/ folder.

#pragma once

#ifndef __TRANSMISSION__
#error only libtransmission should #include this header.
#endif

#include "tr-macros.h"

void tr_eventInit(tr_session*);

void tr_eventClose(tr_session*);

bool tr_amInEventThread(tr_session const*);

void tr_runInEventThread(tr_session*, void (*func)(void*), void* user_data);
chore: update copyright years, make notices consistent (#2463) 2022-01-20 18:27:56 +00:00			`// This file Copyright © 2007-2022 Mnemosyne LLC.`
			`// It may be used under GPLv2 (SPDX: GPL-2.0), GPLv3 (SPDX: GPL-3.0),`
			`// or any future license endorsed by Mnemosyne LLC.`
			`// License text can be found in the licenses/ folder.`
do all the libevent enqueuing from a single thread. 2007-08-18 03:02:32 +00:00
Ensure include guard is the first non-comment line 2017-11-14 20:21:28 +00:00			`#pragma once`

(libT) add #ifdefs to ensure that client apps don't #include private libtransmission headers. 2008-11-24 20:17:36 +00:00			`#ifndef __TRANSMISSION__`
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 libtransmission should #include this header.`
(libT) add #ifdefs to ensure that client apps don't #include private libtransmission headers. 2008-11-24 20:17:36 +00:00			`#endif`

refactor: use GTest for running tests (#1383) * refactor: use google-test on libtransmission tests 2020-08-11 18:11:55 +00:00			`#include "tr-macros.h"`

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_eventInit(tr_session*);`
do all the libevent enqueuing from a single thread. 2007-08-18 03:02:32 +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_eventClose(tr_session*);`
do all the libevent enqueuing from a single thread. 2007-08-18 03:02:32 +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			`bool tr_amInEventThread(tr_session const*);`
merge encryption branch to trunk (xcode project is still out of date) 2007-09-20 16:32:01 +00:00
Switch to clang-format for code formatting, include Mac client 2021-08-15 09:41:48 +00:00			`void tr_runInEventThread(tr_session, void (func)(void), void user_data);`