transmission/libtransmission/port-forwarding.h

// This file Copyright © 2008-2022 Mnemosyne LLC.
// It may be used under GPLv2 (SPDX: GPL-2.0-only), GPLv3 (SPDX: GPL-3.0-only),
// 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 "net.h" // tr_port

struct tr_bindsockets;
struct tr_session;
struct tr_shared;

tr_shared* tr_sharedInit(tr_session&);

void tr_sharedClose(tr_session&);

void tr_sharedPortChanged(tr_session&);

void tr_sharedTraversalEnable(tr_shared*, bool is_enabled);

tr_port tr_sharedGetPeerPort(tr_shared const* s);

bool tr_sharedTraversalIsEnabled(tr_shared const* s);

int tr_sharedTraversalStatus(tr_shared const*);
chore: update copyright years, make notices consistent (#2463) 2022-01-20 18:27:56 +00:00			`// This file Copyright © 2008-2022 Mnemosyne LLC.`
chore: fix spdx abbreviations (#3602) 2022-08-08 18:05:39 +00:00			`// It may be used under GPLv2 (SPDX: GPL-2.0-only), GPLv3 (SPDX: GPL-3.0-only),`
chore: update copyright years, make notices consistent (#2463) 2022-01-20 18:27:56 +00:00			`// or any future license endorsed by Mnemosyne LLC.`
			`// License text can be found in the licenses/ folder.`
Split transmission.c: everything related to the accept/upnp/choking thread was moved to shared.c 2007-01-19 04:42:31 +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: add a tr_port safety class (#2952) 2022-04-21 15:58:13 +00:00			`#include "net.h" // tr_port`
(trunk libT) re-start work on making libT doxygen friendly. still a long ways to go on this. 2009-05-29 19:17:12 +00:00
(trunk libT) #2035: Transmission causes wakeups by unnecessary polling. 2009-05-14 13:42:29 +00:00			`struct tr_bindsockets;`
refactor: add a tr_port safety class (#2952) 2022-04-21 15:58:13 +00:00			`struct tr_session;`
refactor: prefer "using" over "typedef" (#1883) * refactor: prefer "using" over "typedef" 2021-10-06 14:26:07 +00:00			`struct tr_shared;`
add portability wrapper for in_port_t... 2007-07-30 18:04:10 +00:00
refactor: remove tr_new, tr_free pt. 1 (#3626) * refactor: tr_torrentGetMetadataPiece() returns an optional vector * refactor: use tr_pathbuf in create_temp_path() * refactor: use tr_pathbuf in win32 create_temp_path() * refactor: use std::vector in isPeerInteresting() * refactor: remove tr_new0 from tr_peerMgrPeerStats() * refactor: remove tr_new0 from rechokeUploads() * refactor: silence clang nullptr dereference warning * refactor: make tr_natpmp a C++ class * refactor: use std::string in tr_log_message 2022-08-12 00:59:58 +00:00			`tr_shared* tr_sharedInit(tr_session&);`
run libT, cli, daemon, gtk through the source-code formatter "uncrustify" as promised/threatened 2008-09-23 19:11:04 +00:00
refactor: remove tr_new, tr_free pt. 1 (#3626) * refactor: tr_torrentGetMetadataPiece() returns an optional vector * refactor: use tr_pathbuf in create_temp_path() * refactor: use tr_pathbuf in win32 create_temp_path() * refactor: use std::vector in isPeerInteresting() * refactor: remove tr_new0 from tr_peerMgrPeerStats() * refactor: remove tr_new0 from rechokeUploads() * refactor: silence clang nullptr dereference warning * refactor: make tr_natpmp a C++ class * refactor: use std::string in tr_log_message 2022-08-12 00:59:58 +00:00			`void tr_sharedClose(tr_session&);`
run libT, cli, daemon, gtk through the source-code formatter "uncrustify" as promised/threatened 2008-09-23 19:11:04 +00:00
refactor: remove tr_new, tr_free pt. 1 (#3626) * refactor: tr_torrentGetMetadataPiece() returns an optional vector * refactor: use tr_pathbuf in create_temp_path() * refactor: use tr_pathbuf in win32 create_temp_path() * refactor: use std::vector in isPeerInteresting() * refactor: remove tr_new0 from tr_peerMgrPeerStats() * refactor: remove tr_new0 from rechokeUploads() * refactor: silence clang nullptr dereference warning * refactor: make tr_natpmp a C++ class * refactor: use std::string in tr_log_message 2022-08-12 00:59:58 +00:00			`void tr_sharedPortChanged(tr_session&);`
run libT, cli, daemon, gtk through the source-code formatter "uncrustify" as promised/threatened 2008-09-23 19:11:04 +00:00
fix: readability-inconsistent-declaration-parameter-name warnings in libtransmission (#3572) 2022-08-03 06:15:37 +00:00			`void tr_sharedTraversalEnable(tr_shared*, bool is_enabled);`
run libT, cli, daemon, gtk through the source-code formatter "uncrustify" as promised/threatened 2008-09-23 19:11:04 +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			`tr_port tr_sharedGetPeerPort(tr_shared const* s);`
run libT, cli, daemon, gtk through the source-code formatter "uncrustify" as promised/threatened 2008-09-23 19:11:04 +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_sharedTraversalIsEnabled(tr_shared const* s);`
run libT, cli, daemon, gtk through the source-code formatter "uncrustify" as promised/threatened 2008-09-23 19:11:04 +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			`int tr_sharedTraversalStatus(tr_shared const*);`