107 lines
3.2 KiB
C++
107 lines
3.2 KiB
C++
// This file Copyright © 2017-2023 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
|
|
|
|
#include <array>
|
|
#include <cstddef> // size_t
|
|
#include <cstdint> // uint32_t
|
|
|
|
// ---
|
|
|
|
#ifdef _MSVC_LANG
|
|
#define TR_CPLUSPLUS _MSVC_LANG
|
|
#else
|
|
#define TR_CPLUSPLUS __cplusplus
|
|
#endif
|
|
|
|
#if ((TR_CPLUSPLUS >= 202002L) && (!defined(_GLIBCXX_RELEASE) || _GLIBCXX_RELEASE > 9)) || \
|
|
(TR_CPLUSPLUS >= 201709L && TR_GCC_VERSION >= 1002)
|
|
#define TR_CONSTEXPR20 constexpr
|
|
#else
|
|
#define TR_CONSTEXPR20
|
|
#endif
|
|
|
|
// Placeholder for future use.
|
|
// Can't implement right now because __cplusplus version for C++23 is currently TBD
|
|
#define TR_CONSTEXPR23
|
|
|
|
// ---
|
|
|
|
#ifndef __has_builtin
|
|
#define __has_builtin(x) 0
|
|
#endif
|
|
|
|
#ifdef _WIN32
|
|
#define TR_IF_WIN32(ThenValue, ElseValue) ThenValue
|
|
#else
|
|
#define TR_IF_WIN32(ThenValue, ElseValue) ElseValue
|
|
#endif
|
|
|
|
#ifdef __GNUC__
|
|
#define TR_GNUC_CHECK_VERSION(major, minor) (__GNUC__ > (major) || (__GNUC__ == (major) && __GNUC_MINOR__ >= (minor)))
|
|
#else
|
|
#define TR_GNUC_CHECK_VERSION(major, minor) 0
|
|
#endif
|
|
|
|
#ifdef __UCLIBC__
|
|
#define TR_UCLIBC_CHECK_VERSION(major, minor, micro) \
|
|
(__UCLIBC_MAJOR__ > (major) || (__UCLIBC_MAJOR__ == (major) && __UCLIBC_MINOR__ > (minor)) || \
|
|
(__UCLIBC_MAJOR__ == (major) && __UCLIBC_MINOR__ == (minor) && __UCLIBC_SUBLEVEL__ >= (micro)))
|
|
#else
|
|
#define TR_UCLIBC_CHECK_VERSION(major, minor, micro) 0
|
|
#endif
|
|
|
|
// ---
|
|
|
|
#if __has_builtin(__builtin_expect) || TR_GNUC_CHECK_VERSION(3, 0)
|
|
#define TR_LIKELY(x) __builtin_expect((x) ? 1L : 0L, 1L)
|
|
#define TR_UNLIKELY(x) __builtin_expect((x) ? 1L : 0L, 0L)
|
|
#else
|
|
#define TR_LIKELY(x) (x)
|
|
#define TR_UNLIKELY(x) (x)
|
|
#endif
|
|
|
|
#define TR_DISABLE_COPY_MOVE(Class) \
|
|
Class& operator=(Class const&) = delete; \
|
|
Class& operator=(Class&&) = delete; \
|
|
Class(Class const&) = delete; \
|
|
Class(Class&&) = delete;
|
|
|
|
// ---
|
|
|
|
#define TR_PATH_DELIMITER '/'
|
|
|
|
#define TR_INET6_ADDRSTRLEN 46
|
|
|
|
#define TR_ADDRSTRLEN 64
|
|
|
|
// Mostly to enforce better formatting
|
|
#define TR_ARG_TUPLE(...) __VA_ARGS__
|
|
|
|
// https://www.bittorrent.org/beps/bep_0007.html
|
|
// "The client SHOULD include a key parameter in its announces. The key
|
|
// should remain the same for a particular infohash during a torrent
|
|
// session. Together with the peer_id this allows trackers to uniquely
|
|
// identify clients for the purpose of statistics-keeping when they
|
|
// announce from multiple IP.
|
|
// The key should be generated so it has at least 32bits worth of entropy."
|
|
//
|
|
// https://www.bittorrent.org/beps/bep_0015.html
|
|
// "Clients that resolve hostnames to v4 and v6 and then announce to both
|
|
// should use the same [32-bit integer] key for both so that trackers that
|
|
// care about accurate statistics-keeping can match the two announces."
|
|
using tr_announce_key_t = uint32_t;
|
|
|
|
// https://www.bittorrent.org/beps/bep_0003.html
|
|
// A string of length 20 which this downloader uses as its id. Each
|
|
// downloader generates its own id at random at the start of a new
|
|
// download. This value will also almost certainly have to be escaped.
|
|
using tr_peer_id_t = std::array<char, 20>;
|
|
|
|
using tr_sha1_digest_t = std::array<std::byte, 20>;
|
|
|
|
using tr_sha256_digest_t = std::array<std::byte, 32>;
|