1
0
Fork 0
mirror of https://github.com/transmission/transmission synced 2024-12-25 01:03:01 +00:00
transmission/libtransmission/peer-io.h
Charles Kerr 62372602b4
refactor: run clang-tidy on bandwidth.h, .cc (#1930)
* chore: allow vararg calls in qt/.clang-tidy

An awkward PR since this isn't intended for the qt/ codebase at all, but
rather for use with libtransmission instead. But libtransmission is *so*
noncompilant at this point that this config can't be promoted higher up
the tree yet. Instead, it needs to be callable on-request by devs.

* refactor: make clang-tidy happy with bandwidth.h, .cc

* refactor: use getFooSpeedBytesPerSecond()
2021-10-12 01:04:22 -05:00

370 lines
8.7 KiB
C++

/*
* This file Copyright (C) 2007-2014 Mnemosyne LLC
*
* It may be used under the GNU GPL versions 2 or 3
* or any future license endorsed by Mnemosyne LLC.
*
*/
#pragma once
#ifndef __TRANSMISSION__
#error only libtransmission should #include this header.
#endif
/**
***
**/
#include <assert.h>
#include <event2/buffer.h>
#include "transmission.h"
#include "bandwidth.h"
#include "crypto.h"
#include "net.h" /* tr_address */
#include "peer-socket.h"
#include "utils.h" /* tr_time() */
class tr_peerIo;
struct Bandwidth;
struct evbuffer;
struct tr_datatype;
/**
* @addtogroup networked_io Networked IO
* @{
*/
enum ReadState
{
READ_NOW,
READ_LATER,
READ_ERR
};
enum tr_encryption_type
{
/* these match the values in MSE's crypto_select */
PEER_ENCRYPTION_NONE = (1 << 0),
PEER_ENCRYPTION_RC4 = (1 << 1)
};
using tr_can_read_cb = ReadState (*)(tr_peerIo* io, void* user_data, size_t* setme_piece_byte_count);
using tr_did_write_cb = void (*)(tr_peerIo* io, size_t bytesWritten, bool wasPieceData, void* userData);
using tr_net_error_cb = void (*)(tr_peerIo* io, short what, void* userData);
auto inline constexpr PEER_IO_MAGIC_NUMBER = 206745;
class tr_peerIo
{
public:
tr_peerIo(tr_session* session_in, tr_address const& addr_in, tr_port port_in, bool is_seed_in)
: addr{ addr_in }
, session{ session_in }
, inbuf{ evbuffer_new() }
, outbuf{ evbuffer_new() }
, port{ port_in }
, isSeed{ is_seed_in }
{
}
~tr_peerIo()
{
evbuffer_free(outbuf);
evbuffer_free(inbuf);
}
tr_crypto crypto = {};
tr_address const addr;
// TODO(ckerr): yikes, unlike other class' magic_numbers it looks
// like this one isn't being used just for assertions, but also in
// didWriteWrapper() to see if the tr_peerIo got freed during the
// notify-consumed events. Fix this before removing this field.
int magic_number = PEER_IO_MAGIC_NUMBER;
struct tr_peer_socket socket = {};
time_t const timeCreated = tr_time();
tr_session* const session;
tr_can_read_cb canRead = nullptr;
tr_did_write_cb didWrite = nullptr;
tr_net_error_cb gotError = nullptr;
void* userData = nullptr;
// Changed to non-owning pointer temporarily till tr_peerIo becomes C++-constructible and destructible
// TODO: change tr_bandwidth* to owning pointer to the bandwidth, or remove * and own the value
Bandwidth* bandwidth = nullptr;
evbuffer* const inbuf;
evbuffer* const outbuf;
struct tr_datatype* outbuf_datatypes = nullptr;
struct event* event_read = nullptr;
struct event* event_write = nullptr;
// TODO(ckerr): this could be narrowed to 1 byte
tr_encryption_type encryption_type = PEER_ENCRYPTION_NONE;
// TODO: use std::shared_ptr instead of manual refcounting?
int refCount = 1;
// TODO(ckerr): I think this can be moved to tr_handshake
uint8_t peerId[SHA_DIGEST_LENGTH] = {};
short int pendingEvents = 0;
tr_port const port;
tr_priority_t priority = TR_PRI_NORMAL;
bool const isSeed;
bool dhtSupported = false;
bool extendedProtocolSupported = false;
bool fastExtensionSupported = false;
bool isEncrypted = false;
// TODO(ckerr): I think this can be moved to tr_handshake
bool peerIdIsSet = false;
bool utpSupported = false;
};
/**
***
**/
tr_peerIo* tr_peerIoNewOutgoing(
tr_session* session,
Bandwidth* parent,
struct tr_address const* addr,
tr_port port,
uint8_t const* torrentHash,
bool isSeed,
bool utp);
tr_peerIo* tr_peerIoNewIncoming(
tr_session* session,
Bandwidth* parent,
struct tr_address const* addr,
tr_port port,
struct tr_peer_socket const socket);
void tr_peerIoRefImpl(char const* file, int line, tr_peerIo* io);
#define tr_peerIoRef(io) tr_peerIoRefImpl(__FILE__, __LINE__, (io))
void tr_peerIoUnrefImpl(char const* file, int line, tr_peerIo* io);
#define tr_peerIoUnref(io) tr_peerIoUnrefImpl(__FILE__, __LINE__, (io))
constexpr bool tr_isPeerIo(tr_peerIo const* io)
{
return io != nullptr && io->magic_number == PEER_IO_MAGIC_NUMBER && io->refCount >= 0 && tr_address_is_valid(&io->addr);
}
/**
***
**/
constexpr void tr_peerIoEnableFEXT(tr_peerIo* io, bool flag)
{
io->fastExtensionSupported = flag;
}
constexpr bool tr_peerIoSupportsFEXT(tr_peerIo const* io)
{
return io->fastExtensionSupported;
}
constexpr void tr_peerIoEnableLTEP(tr_peerIo* io, bool flag)
{
io->extendedProtocolSupported = flag;
}
constexpr bool tr_peerIoSupportsLTEP(tr_peerIo const* io)
{
return io->extendedProtocolSupported;
}
constexpr void tr_peerIoEnableDHT(tr_peerIo* io, bool flag)
{
io->dhtSupported = flag;
}
constexpr bool tr_peerIoSupportsDHT(tr_peerIo const* io)
{
return io->dhtSupported;
}
constexpr bool tr_peerIoSupportsUTP(tr_peerIo const* io)
{
return io->utpSupported;
}
/**
***
**/
constexpr tr_session* tr_peerIoGetSession(tr_peerIo* io)
{
TR_ASSERT(tr_isPeerIo(io));
TR_ASSERT(io->session != nullptr);
return io->session;
}
char const* tr_peerIoGetAddrStr(tr_peerIo const* io, char* buf, size_t buflen);
struct tr_address const* tr_peerIoGetAddress(tr_peerIo const* io, tr_port* port);
uint8_t const* tr_peerIoGetTorrentHash(tr_peerIo* io);
bool tr_peerIoHasTorrentHash(tr_peerIo const* io);
void tr_peerIoSetTorrentHash(tr_peerIo* io, uint8_t const* hash);
int tr_peerIoReconnect(tr_peerIo* io);
constexpr bool tr_peerIoIsIncoming(tr_peerIo const* io)
{
return io->crypto.isIncoming;
}
// TODO: remove this func; let caller get the current time instead
static inline int tr_peerIoGetAge(tr_peerIo const* io)
{
return tr_time() - io->timeCreated;
}
/**
***
**/
void tr_peerIoSetPeersId(tr_peerIo* io, uint8_t const* peer_id);
constexpr uint8_t const* tr_peerIoGetPeersId(tr_peerIo const* io)
{
TR_ASSERT(tr_isPeerIo(io));
TR_ASSERT(io->peerIdIsSet);
return io->peerId;
}
/**
***
**/
void tr_peerIoSetIOFuncs(tr_peerIo* io, tr_can_read_cb readcb, tr_did_write_cb writecb, tr_net_error_cb errcb, void* user_data);
void tr_peerIoClear(tr_peerIo* io);
/**
***
**/
void tr_peerIoWriteBytes(tr_peerIo* io, void const* writeme, size_t writemeLen, bool isPieceData);
void tr_peerIoWriteBuf(tr_peerIo* io, struct evbuffer* buf, bool isPieceData);
/**
***
**/
constexpr tr_crypto* tr_peerIoGetCrypto(tr_peerIo* io)
{
return &io->crypto;
}
void tr_peerIoSetEncryption(tr_peerIo* io, tr_encryption_type encryption_type);
constexpr bool tr_peerIoIsEncrypted(tr_peerIo const* io)
{
return io != nullptr && io->encryption_type == PEER_ENCRYPTION_RC4;
}
void evbuffer_add_uint8(struct evbuffer* outbuf, uint8_t byte);
void evbuffer_add_uint16(struct evbuffer* outbuf, uint16_t hs);
void evbuffer_add_uint32(struct evbuffer* outbuf, uint32_t hl);
void evbuffer_add_uint64(struct evbuffer* outbuf, uint64_t hll);
static inline void evbuffer_add_hton_16(struct evbuffer* buf, uint16_t val)
{
evbuffer_add_uint16(buf, val);
}
static inline void evbuffer_add_hton_32(struct evbuffer* buf, uint32_t val)
{
evbuffer_add_uint32(buf, val);
}
static inline void evbuffer_add_hton_64(struct evbuffer* buf, uint64_t val)
{
evbuffer_add_uint64(buf, val);
}
void tr_peerIoReadBytesToBuf(tr_peerIo* io, struct evbuffer* inbuf, struct evbuffer* outbuf, size_t byteCount);
void tr_peerIoReadBytes(tr_peerIo* io, struct evbuffer* inbuf, void* bytes, size_t byteCount);
static inline void tr_peerIoReadUint8(tr_peerIo* io, struct evbuffer* inbuf, uint8_t* setme)
{
tr_peerIoReadBytes(io, inbuf, setme, sizeof(uint8_t));
}
void tr_peerIoReadUint16(tr_peerIo* io, struct evbuffer* inbuf, uint16_t* setme);
void tr_peerIoReadUint32(tr_peerIo* io, struct evbuffer* inbuf, uint32_t* setme);
void tr_peerIoDrain(tr_peerIo* io, struct evbuffer* inbuf, size_t byteCount);
/**
***
**/
size_t tr_peerIoGetWriteBufferSpace(tr_peerIo const* io, uint64_t now);
static inline void tr_peerIoSetParent(tr_peerIo* io, Bandwidth* parent)
{
TR_ASSERT(tr_isPeerIo(io));
io->bandwidth->setParent(parent);
}
void tr_peerIoBandwidthUsed(tr_peerIo* io, tr_direction direction, size_t byteCount, int isPieceData);
static inline bool tr_peerIoHasBandwidthLeft(tr_peerIo const* io, tr_direction dir)
{
return io->bandwidth->clamp(dir, 1024) > 0;
}
static inline unsigned int tr_peerIoGetPieceSpeed_Bps(tr_peerIo const* io, uint64_t now, tr_direction dir)
{
return io->bandwidth->getPieceSpeedBytesPerSecond(now, dir);
}
/**
***
**/
void tr_peerIoSetEnabled(tr_peerIo* io, tr_direction dir, bool isEnabled);
int tr_peerIoFlush(tr_peerIo* io, tr_direction dir, size_t byteLimit);
int tr_peerIoFlushOutgoingProtocolMsgs(tr_peerIo* io);
/**
***
**/
constexpr struct evbuffer* tr_peerIoGetReadBuffer(tr_peerIo* io)
{
return io->inbuf;
}
/* @} */