2023-07-25 11:53:09 +02:00
|
|
|
/* SPDX-License-Identifier: GPL-3.0-or-later
|
2024-03-28 16:13:51 +01:00
|
|
|
* Copyright © 2016-2024 The TokTok team.
|
2023-07-25 11:53:09 +02:00
|
|
|
* Copyright © 2013 Tox project.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef C_TOXCORE_TOXCORE_TOX_PRIVATE_H
|
|
|
|
#define C_TOXCORE_TOXCORE_TOX_PRIVATE_H
|
|
|
|
|
|
|
|
#include <stdbool.h>
|
|
|
|
#include <stddef.h>
|
|
|
|
#include <stdint.h>
|
|
|
|
|
|
|
|
#include "tox.h"
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
|
|
|
typedef uint64_t tox_mono_time_cb(void *user_data);
|
|
|
|
|
2024-03-28 16:13:51 +01:00
|
|
|
typedef struct Tox_System {
|
2023-07-25 11:53:09 +02:00
|
|
|
tox_mono_time_cb *mono_time_callback;
|
|
|
|
void *mono_time_user_data;
|
|
|
|
const struct Random *rng;
|
|
|
|
const struct Network *ns;
|
2023-10-10 19:37:39 +02:00
|
|
|
const struct Memory *mem;
|
2024-03-28 16:13:51 +01:00
|
|
|
} Tox_System;
|
2023-07-25 11:53:09 +02:00
|
|
|
|
|
|
|
Tox_System tox_default_system(void);
|
|
|
|
|
2024-03-28 16:13:51 +01:00
|
|
|
const Tox_System *tox_get_system(Tox *tox);
|
|
|
|
|
|
|
|
typedef struct Tox_Options_Testing {
|
|
|
|
const struct Tox_System *operating_system;
|
|
|
|
} Tox_Options_Testing;
|
|
|
|
|
|
|
|
typedef enum Tox_Err_New_Testing {
|
|
|
|
TOX_ERR_NEW_TESTING_OK,
|
|
|
|
TOX_ERR_NEW_TESTING_NULL,
|
|
|
|
} Tox_Err_New_Testing;
|
|
|
|
|
|
|
|
Tox *tox_new_testing(const Tox_Options *options, Tox_Err_New *error, const Tox_Options_Testing *testing, Tox_Err_New_Testing *testing_error);
|
|
|
|
|
2023-07-25 11:53:09 +02:00
|
|
|
void tox_lock(const Tox *tox);
|
|
|
|
void tox_unlock(const Tox *tox);
|
|
|
|
|
|
|
|
/**
|
2024-03-28 16:13:51 +01:00
|
|
|
* Set the callback for the `friend_lossy_packet` event for a specific packet
|
|
|
|
* ID. Pass NULL to unset.
|
2023-07-25 11:53:09 +02:00
|
|
|
*
|
|
|
|
* allowed packet ID range:
|
2024-03-28 16:13:51 +01:00
|
|
|
* from `PACKET_ID_RANGE_LOSSY_START` to `PACKET_ID_RANGE_LOSSY_END` (both
|
|
|
|
* inclusive)
|
2023-07-25 11:53:09 +02:00
|
|
|
*/
|
|
|
|
void tox_callback_friend_lossy_packet_per_pktid(Tox *tox, tox_friend_lossy_packet_cb *callback, uint8_t pktid);
|
|
|
|
|
|
|
|
/**
|
2024-03-28 16:13:51 +01:00
|
|
|
* Set the callback for the `friend_lossless_packet` event for a specific packet
|
|
|
|
* ID. Pass NULL to unset.
|
2023-07-25 11:53:09 +02:00
|
|
|
*
|
|
|
|
* allowed packet ID range:
|
2024-03-28 16:13:51 +01:00
|
|
|
* from `PACKET_ID_RANGE_LOSSLESS_CUSTOM_START` to
|
|
|
|
* `PACKET_ID_RANGE_LOSSLESS_CUSTOM_END` (both inclusive) and `PACKET_ID_MSI`
|
2023-07-25 11:53:09 +02:00
|
|
|
*/
|
|
|
|
void tox_callback_friend_lossless_packet_per_pktid(Tox *tox, tox_friend_lossless_packet_cb *callback, uint8_t pktid);
|
|
|
|
|
|
|
|
void tox_set_av_object(Tox *tox, void *object);
|
|
|
|
void *tox_get_av_object(const Tox *tox);
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* :: DHT network queries.
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The minimum size of an IP string buffer in bytes.
|
|
|
|
*/
|
|
|
|
#define TOX_DHT_NODE_IP_STRING_SIZE 96
|
|
|
|
|
|
|
|
uint32_t tox_dht_node_ip_string_size(void);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The size of a DHT node public key in bytes.
|
|
|
|
*/
|
|
|
|
#define TOX_DHT_NODE_PUBLIC_KEY_SIZE 32
|
|
|
|
|
|
|
|
uint32_t tox_dht_node_public_key_size(void);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param public_key The node's public key.
|
2024-03-28 16:13:51 +01:00
|
|
|
* @param ip The node's IP address, represented as a NUL-terminated C string.
|
2023-07-25 11:53:09 +02:00
|
|
|
* @param port The node's port.
|
|
|
|
*/
|
|
|
|
typedef void tox_dht_get_nodes_response_cb(Tox *tox, const uint8_t *public_key, const char *ip, uint16_t port,
|
|
|
|
void *user_data);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set the callback for the `dht_get_nodes_response` event. Pass NULL to unset.
|
|
|
|
*
|
|
|
|
* This event is triggered when a getnodes response is received from a DHT peer.
|
|
|
|
*/
|
|
|
|
void tox_callback_dht_get_nodes_response(Tox *tox, tox_dht_get_nodes_response_cb *callback);
|
|
|
|
|
|
|
|
typedef enum Tox_Err_Dht_Get_Nodes {
|
|
|
|
/**
|
|
|
|
* The function returned successfully.
|
|
|
|
*/
|
|
|
|
TOX_ERR_DHT_GET_NODES_OK,
|
|
|
|
|
|
|
|
/**
|
2024-03-28 16:13:51 +01:00
|
|
|
* UDP is disabled in Tox options; the DHT can only be queried when UDP is
|
|
|
|
* enabled.
|
2023-07-25 11:53:09 +02:00
|
|
|
*/
|
|
|
|
TOX_ERR_DHT_GET_NODES_UDP_DISABLED,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* One of the arguments to the function was NULL when it was not expected.
|
|
|
|
*/
|
|
|
|
TOX_ERR_DHT_GET_NODES_NULL,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The supplied port is invalid.
|
|
|
|
*/
|
|
|
|
TOX_ERR_DHT_GET_NODES_BAD_PORT,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The supplied IP address is invalid.
|
|
|
|
*/
|
|
|
|
TOX_ERR_DHT_GET_NODES_BAD_IP,
|
|
|
|
|
|
|
|
/**
|
2024-03-28 16:13:51 +01:00
|
|
|
* The getnodes request failed. This usually means the packet failed to
|
|
|
|
* send.
|
2023-07-25 11:53:09 +02:00
|
|
|
*/
|
|
|
|
TOX_ERR_DHT_GET_NODES_FAIL,
|
|
|
|
} Tox_Err_Dht_Get_Nodes;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This function sends a getnodes request to a DHT node for its peers that
|
2024-03-28 16:13:51 +01:00
|
|
|
* are "close" to the passed target public key according to the distance metric
|
|
|
|
* used by the DHT implementation.
|
2023-07-25 11:53:09 +02:00
|
|
|
*
|
2024-03-28 16:13:51 +01:00
|
|
|
* @param public_key The public key of the node that we wish to query. This key
|
|
|
|
* must be at least `TOX_DHT_NODE_PUBLIC_KEY_SIZE` bytes in length.
|
|
|
|
* @param ip A NUL-terminated C string representing the IP address of the node
|
|
|
|
* we wish to query.
|
2023-07-25 11:53:09 +02:00
|
|
|
* @param port The port of the node we wish to query.
|
2024-03-28 16:13:51 +01:00
|
|
|
* @param target_public_key The public key for which we want to find close
|
|
|
|
* nodes.
|
2023-07-25 11:53:09 +02:00
|
|
|
*
|
|
|
|
* @return true on success.
|
|
|
|
*/
|
|
|
|
bool tox_dht_get_nodes(const Tox *tox, const uint8_t *public_key, const char *ip, uint16_t port,
|
|
|
|
const uint8_t *target_public_key, Tox_Err_Dht_Get_Nodes *error);
|
|
|
|
|
2023-11-13 14:02:43 +01:00
|
|
|
/**
|
2024-11-09 13:44:30 +01:00
|
|
|
* This function returns the number of DHT nodes in the closelist.
|
2023-11-13 14:02:43 +01:00
|
|
|
*
|
|
|
|
* @return number
|
|
|
|
*/
|
|
|
|
uint16_t tox_dht_get_num_closelist(const Tox *tox);
|
|
|
|
|
|
|
|
/**
|
2024-11-09 13:44:30 +01:00
|
|
|
* This function returns the number of DHT nodes in the closelist
|
|
|
|
* that are capable of storing announce data (introduced in version 0.2.18).
|
2023-11-13 14:02:43 +01:00
|
|
|
*
|
|
|
|
* @return number
|
|
|
|
*/
|
|
|
|
uint16_t tox_dht_get_num_closelist_announce_capable(const Tox *tox);
|
|
|
|
|
2024-12-04 11:41:10 +01:00
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* :: Network profiler
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Represents all of the network packet identifiers that Toxcore uses.
|
|
|
|
*
|
|
|
|
* Notes:
|
|
|
|
* - Some packet ID's have different purposes depending on the
|
|
|
|
* packet type. These ID's are given numeral names.
|
|
|
|
*
|
|
|
|
* - Queries for invalid packet ID's return undefined results. For example,
|
|
|
|
* querying a TCP-exclusive packet ID for UDP, or querying an ID that
|
|
|
|
* doesn't exist in this enum.
|
|
|
|
*/
|
|
|
|
typedef enum Tox_Netprof_Packet_Id {
|
|
|
|
/**
|
|
|
|
* Ping request packet (UDP).
|
|
|
|
* Routing request (TCP).
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_ZERO = 0x00,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Ping response packet (UDP).
|
|
|
|
* Routing response (TCP).
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_ONE = 0x01,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get nodes request packet (UDP).
|
|
|
|
* Connection notification (TCP).
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_TWO = 0x02,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* TCP disconnect notification.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_TCP_DISCONNECT = 0x03,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Send nodes response packet (UDP).
|
|
|
|
* Ping packet (TCP).
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_FOUR = 0x04,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* TCP pong packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_TCP_PONG = 0x05,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* TCP out-of-band send packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_TCP_OOB_SEND = 0x06,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* TCP out-of-band receive packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_TCP_OOB_RECV = 0x07,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* TCP onion request packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_TCP_ONION_REQUEST = 0x08,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* TCP onion response packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_TCP_ONION_RESPONSE = 0x09,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* TCP data packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_TCP_DATA = 0x10,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Cookie request packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_COOKIE_REQUEST = 0x18,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Cookie response packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_COOKIE_RESPONSE = 0x19,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Crypto handshake packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_CRYPTO_HS = 0x1a,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Crypto data packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_CRYPTO_DATA = 0x1b,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Encrypted data packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_CRYPTO = 0x20,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* LAN discovery packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_LAN_DISCOVERY = 0x21,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* DHT groupchat packets.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_GC_HANDSHAKE = 0x5a,
|
|
|
|
TOX_NETPROF_PACKET_ID_GC_LOSSLESS = 0x5b,
|
|
|
|
TOX_NETPROF_PACKET_ID_GC_LOSSY = 0x5c,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Onion send packets.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_ONION_SEND_INITIAL = 0x80,
|
|
|
|
TOX_NETPROF_PACKET_ID_ONION_SEND_1 = 0x81,
|
|
|
|
TOX_NETPROF_PACKET_ID_ONION_SEND_2 = 0x82,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* DHT announce request packet (deprecated).
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_ANNOUNCE_REQUEST_OLD = 0x83,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* DHT announce response packet (deprecated).
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_ANNOUNCE_RESPONSE_OLD = 0x84,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Onion data request packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_ONION_DATA_REQUEST = 0x85,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Onion data response packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_ONION_DATA_RESPONSE = 0x86,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* DHT announce request packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_ANNOUNCE_REQUEST = 0x87,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* DHT announce response packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_ANNOUNCE_RESPONSE = 0x88,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Onion receive packets.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_ONION_RECV_3 = 0x8c,
|
|
|
|
TOX_NETPROF_PACKET_ID_ONION_RECV_2 = 0x8d,
|
|
|
|
TOX_NETPROF_PACKET_ID_ONION_RECV_1 = 0x8e,
|
|
|
|
|
|
|
|
TOX_NETPROF_PACKET_ID_FORWARD_REQUEST = 0x90,
|
|
|
|
TOX_NETPROF_PACKET_ID_FORWARDING = 0x91,
|
|
|
|
TOX_NETPROF_PACKET_ID_FORWARD_REPLY = 0x92,
|
|
|
|
|
|
|
|
TOX_NETPROF_PACKET_ID_DATA_SEARCH_REQUEST = 0x93,
|
|
|
|
TOX_NETPROF_PACKET_ID_DATA_SEARCH_RESPONSE = 0x94,
|
|
|
|
TOX_NETPROF_PACKET_ID_DATA_RETRIEVE_REQUEST = 0x95,
|
|
|
|
TOX_NETPROF_PACKET_ID_DATA_RETRIEVE_RESPONSE = 0x96,
|
|
|
|
TOX_NETPROF_PACKET_ID_STORE_ANNOUNCE_REQUEST = 0x97,
|
|
|
|
TOX_NETPROF_PACKET_ID_STORE_ANNOUNCE_RESPONSE = 0x98,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Bootstrap info packet.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_ID_BOOTSTRAP_INFO = 0xf0,
|
|
|
|
} Tox_Netprof_Packet_Id;
|
|
|
|
|
|
|
|
const char *tox_netprof_packet_id_to_string(Tox_Netprof_Packet_Id value);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Specifies the packet type for a given query.
|
|
|
|
*/
|
|
|
|
typedef enum Tox_Netprof_Packet_Type {
|
|
|
|
/**
|
|
|
|
* TCP client packets.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_TYPE_TCP_CLIENT,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* TCP server packets.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_TYPE_TCP_SERVER,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Combined TCP server and TCP client packets.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_TYPE_TCP,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* UDP packets.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_PACKET_TYPE_UDP,
|
|
|
|
} Tox_Netprof_Packet_Type;
|
|
|
|
|
|
|
|
const char *tox_netprof_packet_type_to_string(Tox_Netprof_Packet_Type value);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Specifies the packet direction for a given query.
|
|
|
|
*/
|
|
|
|
typedef enum Tox_Netprof_Direction {
|
|
|
|
/**
|
|
|
|
* Outbound packets.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_DIRECTION_SENT,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Inbound packets.
|
|
|
|
*/
|
|
|
|
TOX_NETPROF_DIRECTION_RECV,
|
|
|
|
} Tox_Netprof_Direction;
|
|
|
|
|
|
|
|
const char *tox_netprof_direction_to_string(Tox_Netprof_Direction value);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return the number of packets sent or received for a specific packet ID.
|
|
|
|
*
|
|
|
|
* @param type The types of packets being queried.
|
|
|
|
* @param id The packet ID being queried.
|
|
|
|
* @param direction The packet direction.
|
|
|
|
*/
|
|
|
|
uint64_t tox_netprof_get_packet_id_count(const Tox *tox, Tox_Netprof_Packet_Type type, uint8_t id,
|
|
|
|
Tox_Netprof_Direction direction);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return the total number of packets sent or received.
|
|
|
|
*
|
|
|
|
* @param type The types of packets being queried.
|
|
|
|
* @param direction The packet direction.
|
|
|
|
*/
|
|
|
|
uint64_t tox_netprof_get_packet_total_count(const Tox *tox, Tox_Netprof_Packet_Type type,
|
|
|
|
Tox_Netprof_Direction direction);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return the number of bytes sent or received for a specific packet ID.
|
|
|
|
*
|
|
|
|
* @param type The types of packets being queried.
|
|
|
|
* @param id The packet ID being queried.
|
|
|
|
* @param direction The packet direction.
|
|
|
|
*/
|
|
|
|
uint64_t tox_netprof_get_packet_id_bytes(const Tox *tox, Tox_Netprof_Packet_Type type, uint8_t id,
|
|
|
|
Tox_Netprof_Direction direction);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return the total number of bytes sent or received.
|
|
|
|
*
|
|
|
|
* @param type The types of packets being queried.
|
|
|
|
* @param direction The packet direction.
|
|
|
|
*/
|
|
|
|
uint64_t tox_netprof_get_packet_total_bytes(const Tox *tox, Tox_Netprof_Packet_Type type,
|
|
|
|
Tox_Netprof_Direction direction);
|
|
|
|
|
|
|
|
|
2023-12-24 12:21:34 +01:00
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* :: DHT groupchat queries.
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Maximum size of a peer IP address string.
|
|
|
|
*/
|
|
|
|
#define TOX_GROUP_PEER_IP_STRING_MAX_LENGTH 96
|
|
|
|
|
|
|
|
uint32_t tox_group_peer_ip_string_max_length(void);
|
|
|
|
|
|
|
|
/**
|
2024-03-28 16:13:51 +01:00
|
|
|
* Return the length of the peer's IP address in string form. If the group
|
|
|
|
* number or ID is invalid, the return value is unspecified.
|
2023-12-24 12:21:34 +01:00
|
|
|
*
|
|
|
|
* @param group_number The group number of the group we wish to query.
|
2024-03-28 16:13:51 +01:00
|
|
|
* @param peer_id The ID of the peer whose IP address length we want to
|
|
|
|
* retrieve.
|
2023-12-24 12:21:34 +01:00
|
|
|
*/
|
|
|
|
size_t tox_group_peer_get_ip_address_size(const Tox *tox, uint32_t group_number, uint32_t peer_id,
|
Squashed 'external/toxcore/c-toxcore/' changes from e2c01e457b..b03b571272
b03b571272 fix: flaky tcp test This only fixes the symptoms, not the real problem. Sometimes or consistently on some platforms a socket might need a moment before it can be written to.
32e67ab4c2 cleanup: use typedef for private message ID's in callback
7b1db6adc1 feat: add message IDs to private group messages
99e0bcc27d refactor: Observers/ignored peers can now send and receive custom packets
b3c3c49d26 fix: Disable IPv6 in Windows cross-compilation tests
e742deddff feat: Check hashes of Windows dependencies when cross-compiling
dfb9a0b02b fix: Test the current Windows Dockerfile, not an old Dockerhub image
14de93ccec chore: Use WineHQ's Wine as Debian Bookworm's crashes
ed37616249 docs: Update the Windows cross-compilation section
9bb79c174f cleanup: Remove a couple of unnecessary misc_tools dependencies
19475adb70 chore: Statically link OpenMP into the cracker fun util on Windows
1be311e51f feat: Build the fun utils when cross-compiling to Windows
88133f8446 chore: Strip Windows binaries
3cc0ae7535 refactor: Copy over all of the required static dependencies
c4fa8f7fb1 feat: Generate .def, .exp and .lib files when building for Windows
74bbac5363 feat: Let CMake create the dll instead of doing so ourselves
246642e9ae feat: Harden Windows cross-compilation
8d431c0d11 chore: Bump Windows build dependency versions
e519f7998b fix: Remove unnecessary wsock32 dependency on Windows
ed2b60c217 chore: Use a specific non-broken slimcc version.
d7f21010a1 chore: Update github actions.
e71a68b7f2 docs: Update the list of CMake options
77e08876ff chore: Remove mod and founder from group API naming scheme
12bc042767 docs: add the experimental api build option to INSTALL.md
e1fa5cae96 refactor: Rename Queries to Query to align with other enums.
be82a3ea30 fix: Correct type for conference offline peer numbers.
0627c36716 test: Add pkgsrc build.
92578afe4b test: Add FreeBSD VM action on GitHub.
52ece0f57b test: Build toxcore on NetBSD (VM).
3fe8ee2c11 chore: Only install tox_private.h on request.
9a8dfa06ab fix: save_compatibility_test failing on big-endian systems
86f5e55578 fix: Don't serve files from websockify.
710eb674a5 fix: Correctly pass extended public keys to group moderation code.
021db7031c refactor: Use `struct`s for extended public/secret keys.
a1e999fd80 chore: Compile libsodium reference implementation with compcert.
fbe3c19cf5 cleanup: correct a few nullable annotations
623e3ee5c3 cleanup: Don't use `memcpy` to cast arbitrary `struct`s to `uint8_t[]`.
c71567dc18 fix: Pass array, not array pointer, to `memcmp`.
9b46a08144 cleanup: Never pass `void*` directly to `memcpy`.
5d7b7a7bbc refactor: Use tox rng to seed the keypair generation.
961891d568 cleanup: Small improvements found by PVS Studio.
8201019f0d chore: Disable NGC saving by default, enable through Tox_Options.
5dd9ee3f65 cleanup: Replace pointer arithmetic with explicit `&arr[i]`.
ca4606d49d refactor: Use strong typedef for NGC peer id.
442213b722 cleanup: Simplify custom packet length check in NGC.
08d3393def fix: Correct a few potential null derefs in bootstrap daemon.
b9877b32b0 fix: Add missing memunlock of local variable when it goes out of scope.
dab5fe44b9 fix: Zero out stack-allocated secret key before return.
f058103299 refactor: Make prune_gc_sanctions_list more obviously correct.
3ba7a0dec9 docs: Add static analysis tool list to README.
8d0811a0f3 docs: Run prettier-markdown on markdown files.
969e3a2bfc refactor: Fix network test not using the strong typedef
93c83fbc7c refactor: Use strong typedef instead of struct for `Socket`.
9fe18b176f fix: Fix some false positive from PVS Studio.
7c44379ccb cleanup: Check that WINXP macro exists before comparing it.
5c93231bef refactor: Make tox mutex non-recursive.
aacff73939 docs: Fix up doxyfile.
d55fc85ff5 docs: Add more documentation to crypto_core.
5bdaaaedb6 refactor: Remove `Tox *` from `tox_dispatch`.
e202341e76 refactor: Don't rely on tox_dispatch passing tox in tests.
34df938f52 chore: Use C++ mode for clang-tidy.
8b05296a78 chore: Check that both gtest and gmock exist for tests.
42010660e1 test: Add slimcc compiler compatibility test.
b473630321 chore: Add some comments to the astyle config.
b7404f24f6 cleanup: Remove implicit bool conversions.
4e2dba4d9f chore: Reformat sources with astyle.
4359e3a6bc chore: Rename C++ headers to .hh suffixes.
0c05566e58 cleanup: Further `#include` cleanups.
8d29935b7a chore: Only check the bootstrap daemon checksum on release.
f70e588bc6 cleanup: Add more `const` where possible.
511bfe39c8 cleanup: Use Bazel modules to enforce proper `#include` hygiene.
1710a0d091 refactor: Move pack/unpack `IP_Port` from DHT into network module.
a975943564 chore: Really fix coverage docker image build.
c08409390f chore: Fix post-submit coverage image.
39aadf8922 fix: Don't use `memcmp` to compare `IP_Port`s.
d94246a906 fix: partially fix a bug that prevented group part messages from sending.
eeaa039222 chore: Fix rpm build; add a CI check for it.
8328449c1a chore: Speed up docker builds a bit by reducing layer count.
d6d67d56f3 cleanup: Add `const` where possible in auto tests.
6aa9e6850d cleanup: Minor cleanup of event unpack code.
bdf460a3a9 refactor: Rename `system_{memory,...}` to `os_{memory,...}`.
203e1af81e fix: a few off by one errors in group autotests
5c093c4888 cleanup: Remove all uses of `SIZEOF_VLA`.
662c2140f3 test: Add goblint static analyser.
8f07755834 cleanup: Use `memzero(x, s)` instead of `memset(x, 0, s)`.
a7258e40cf cleanup: Use explicit 0 instead of `PACKET_ID_PADDING`.
6370d0f15d cleanup: Expand the `Tox_Options` accessor macros.
14a1a0b9bd cleanup: Remove plan9 support.
a05dccad13 test: Add a simple new/delete test for Tox.
1cdcf938b9 cleanup: Add comment after every `#endif`.
ba99d4dc4b test: Fix comment I broke in the events test PR.
e07248debb refactor: Migrate auto_tests to new events API.
bdd42b5452 refactor: Add common msgpack array packer with callback.
3c659f5288 cleanup: Rename group to conference in groupav documentation.
89957be230 cleanup: Ensure handler params are named after callback params.
c650d9d345 refactor: Pass `this` pointer as first param to s11n callbacks.
e7fb91ddb8 refactor: Allow NULL pointers for byte arrays in events.
5e2c8cabc1 cleanup: make some improvements to group moderation test
259de4867e cleanup: Remove `bin_pack_{new,free}`.
21a8ff5895 cleanup: skip a do_gc iteration before removing peers marked for deletion
16809dc36e feat: Add dht_get_nodes_response event to the events system.
git-subtree-dir: external/toxcore/c-toxcore
git-subtree-split: b03b5712720de9a9901ea12fd741f177327a7021
2024-03-07 23:12:55 +01:00
|
|
|
Tox_Err_Group_Peer_Query *error);
|
2023-12-24 12:21:34 +01:00
|
|
|
/**
|
2024-03-28 16:13:51 +01:00
|
|
|
* Write the IP address associated with the designated peer_id for the
|
|
|
|
* designated group number to ip_addr.
|
2023-12-24 12:21:34 +01:00
|
|
|
*
|
2024-03-28 16:13:51 +01:00
|
|
|
* If the peer is forcing TCP connections a placeholder value will be written
|
|
|
|
* instead, indicating that their real IP address is unknown to us.
|
2023-12-24 12:21:34 +01:00
|
|
|
*
|
2024-03-28 16:13:51 +01:00
|
|
|
* If `peer_id` designates ourself, it will write either our own IP address or a
|
|
|
|
* placeholder value, depending on whether or not we're forcing TCP connections.
|
2023-12-24 12:21:34 +01:00
|
|
|
*
|
2024-03-28 16:13:51 +01:00
|
|
|
* Call tox_group_peer_get_ip_address_size to determine the allocation size for
|
|
|
|
* the `ip_addr` parameter.
|
2023-12-24 12:21:34 +01:00
|
|
|
*
|
|
|
|
* @param group_number The group number of the group we wish to query.
|
|
|
|
* @param peer_id The ID of the peer whose public key we wish to retrieve.
|
2024-03-28 16:13:51 +01:00
|
|
|
* @param ip_addr A valid memory region large enough to store the IP address
|
|
|
|
* string. If this parameter is NULL, this function call has no effect.
|
2023-12-24 12:21:34 +01:00
|
|
|
*
|
|
|
|
* @return true on success.
|
|
|
|
*/
|
|
|
|
bool tox_group_peer_get_ip_address(const Tox *tox, uint32_t group_number, uint32_t peer_id, uint8_t *ip_addr,
|
|
|
|
Tox_Err_Group_Peer_Query *error);
|
|
|
|
|
2023-07-25 11:53:09 +02:00
|
|
|
#ifdef __cplusplus
|
Squashed 'external/toxcore/c-toxcore/' changes from e2c01e457b..b03b571272
b03b571272 fix: flaky tcp test This only fixes the symptoms, not the real problem. Sometimes or consistently on some platforms a socket might need a moment before it can be written to.
32e67ab4c2 cleanup: use typedef for private message ID's in callback
7b1db6adc1 feat: add message IDs to private group messages
99e0bcc27d refactor: Observers/ignored peers can now send and receive custom packets
b3c3c49d26 fix: Disable IPv6 in Windows cross-compilation tests
e742deddff feat: Check hashes of Windows dependencies when cross-compiling
dfb9a0b02b fix: Test the current Windows Dockerfile, not an old Dockerhub image
14de93ccec chore: Use WineHQ's Wine as Debian Bookworm's crashes
ed37616249 docs: Update the Windows cross-compilation section
9bb79c174f cleanup: Remove a couple of unnecessary misc_tools dependencies
19475adb70 chore: Statically link OpenMP into the cracker fun util on Windows
1be311e51f feat: Build the fun utils when cross-compiling to Windows
88133f8446 chore: Strip Windows binaries
3cc0ae7535 refactor: Copy over all of the required static dependencies
c4fa8f7fb1 feat: Generate .def, .exp and .lib files when building for Windows
74bbac5363 feat: Let CMake create the dll instead of doing so ourselves
246642e9ae feat: Harden Windows cross-compilation
8d431c0d11 chore: Bump Windows build dependency versions
e519f7998b fix: Remove unnecessary wsock32 dependency on Windows
ed2b60c217 chore: Use a specific non-broken slimcc version.
d7f21010a1 chore: Update github actions.
e71a68b7f2 docs: Update the list of CMake options
77e08876ff chore: Remove mod and founder from group API naming scheme
12bc042767 docs: add the experimental api build option to INSTALL.md
e1fa5cae96 refactor: Rename Queries to Query to align with other enums.
be82a3ea30 fix: Correct type for conference offline peer numbers.
0627c36716 test: Add pkgsrc build.
92578afe4b test: Add FreeBSD VM action on GitHub.
52ece0f57b test: Build toxcore on NetBSD (VM).
3fe8ee2c11 chore: Only install tox_private.h on request.
9a8dfa06ab fix: save_compatibility_test failing on big-endian systems
86f5e55578 fix: Don't serve files from websockify.
710eb674a5 fix: Correctly pass extended public keys to group moderation code.
021db7031c refactor: Use `struct`s for extended public/secret keys.
a1e999fd80 chore: Compile libsodium reference implementation with compcert.
fbe3c19cf5 cleanup: correct a few nullable annotations
623e3ee5c3 cleanup: Don't use `memcpy` to cast arbitrary `struct`s to `uint8_t[]`.
c71567dc18 fix: Pass array, not array pointer, to `memcmp`.
9b46a08144 cleanup: Never pass `void*` directly to `memcpy`.
5d7b7a7bbc refactor: Use tox rng to seed the keypair generation.
961891d568 cleanup: Small improvements found by PVS Studio.
8201019f0d chore: Disable NGC saving by default, enable through Tox_Options.
5dd9ee3f65 cleanup: Replace pointer arithmetic with explicit `&arr[i]`.
ca4606d49d refactor: Use strong typedef for NGC peer id.
442213b722 cleanup: Simplify custom packet length check in NGC.
08d3393def fix: Correct a few potential null derefs in bootstrap daemon.
b9877b32b0 fix: Add missing memunlock of local variable when it goes out of scope.
dab5fe44b9 fix: Zero out stack-allocated secret key before return.
f058103299 refactor: Make prune_gc_sanctions_list more obviously correct.
3ba7a0dec9 docs: Add static analysis tool list to README.
8d0811a0f3 docs: Run prettier-markdown on markdown files.
969e3a2bfc refactor: Fix network test not using the strong typedef
93c83fbc7c refactor: Use strong typedef instead of struct for `Socket`.
9fe18b176f fix: Fix some false positive from PVS Studio.
7c44379ccb cleanup: Check that WINXP macro exists before comparing it.
5c93231bef refactor: Make tox mutex non-recursive.
aacff73939 docs: Fix up doxyfile.
d55fc85ff5 docs: Add more documentation to crypto_core.
5bdaaaedb6 refactor: Remove `Tox *` from `tox_dispatch`.
e202341e76 refactor: Don't rely on tox_dispatch passing tox in tests.
34df938f52 chore: Use C++ mode for clang-tidy.
8b05296a78 chore: Check that both gtest and gmock exist for tests.
42010660e1 test: Add slimcc compiler compatibility test.
b473630321 chore: Add some comments to the astyle config.
b7404f24f6 cleanup: Remove implicit bool conversions.
4e2dba4d9f chore: Reformat sources with astyle.
4359e3a6bc chore: Rename C++ headers to .hh suffixes.
0c05566e58 cleanup: Further `#include` cleanups.
8d29935b7a chore: Only check the bootstrap daemon checksum on release.
f70e588bc6 cleanup: Add more `const` where possible.
511bfe39c8 cleanup: Use Bazel modules to enforce proper `#include` hygiene.
1710a0d091 refactor: Move pack/unpack `IP_Port` from DHT into network module.
a975943564 chore: Really fix coverage docker image build.
c08409390f chore: Fix post-submit coverage image.
39aadf8922 fix: Don't use `memcmp` to compare `IP_Port`s.
d94246a906 fix: partially fix a bug that prevented group part messages from sending.
eeaa039222 chore: Fix rpm build; add a CI check for it.
8328449c1a chore: Speed up docker builds a bit by reducing layer count.
d6d67d56f3 cleanup: Add `const` where possible in auto tests.
6aa9e6850d cleanup: Minor cleanup of event unpack code.
bdf460a3a9 refactor: Rename `system_{memory,...}` to `os_{memory,...}`.
203e1af81e fix: a few off by one errors in group autotests
5c093c4888 cleanup: Remove all uses of `SIZEOF_VLA`.
662c2140f3 test: Add goblint static analyser.
8f07755834 cleanup: Use `memzero(x, s)` instead of `memset(x, 0, s)`.
a7258e40cf cleanup: Use explicit 0 instead of `PACKET_ID_PADDING`.
6370d0f15d cleanup: Expand the `Tox_Options` accessor macros.
14a1a0b9bd cleanup: Remove plan9 support.
a05dccad13 test: Add a simple new/delete test for Tox.
1cdcf938b9 cleanup: Add comment after every `#endif`.
ba99d4dc4b test: Fix comment I broke in the events test PR.
e07248debb refactor: Migrate auto_tests to new events API.
bdd42b5452 refactor: Add common msgpack array packer with callback.
3c659f5288 cleanup: Rename group to conference in groupav documentation.
89957be230 cleanup: Ensure handler params are named after callback params.
c650d9d345 refactor: Pass `this` pointer as first param to s11n callbacks.
e7fb91ddb8 refactor: Allow NULL pointers for byte arrays in events.
5e2c8cabc1 cleanup: make some improvements to group moderation test
259de4867e cleanup: Remove `bin_pack_{new,free}`.
21a8ff5895 cleanup: skip a do_gc iteration before removing peers marked for deletion
16809dc36e feat: Add dht_get_nodes_response event to the events system.
git-subtree-dir: external/toxcore/c-toxcore
git-subtree-split: b03b5712720de9a9901ea12fd741f177327a7021
2024-03-07 23:12:55 +01:00
|
|
|
} /* extern "C" */
|
2023-07-25 11:53:09 +02:00
|
|
|
#endif
|
|
|
|
|
Squashed 'external/toxcore/c-toxcore/' changes from e2c01e457b..b03b571272
b03b571272 fix: flaky tcp test This only fixes the symptoms, not the real problem. Sometimes or consistently on some platforms a socket might need a moment before it can be written to.
32e67ab4c2 cleanup: use typedef for private message ID's in callback
7b1db6adc1 feat: add message IDs to private group messages
99e0bcc27d refactor: Observers/ignored peers can now send and receive custom packets
b3c3c49d26 fix: Disable IPv6 in Windows cross-compilation tests
e742deddff feat: Check hashes of Windows dependencies when cross-compiling
dfb9a0b02b fix: Test the current Windows Dockerfile, not an old Dockerhub image
14de93ccec chore: Use WineHQ's Wine as Debian Bookworm's crashes
ed37616249 docs: Update the Windows cross-compilation section
9bb79c174f cleanup: Remove a couple of unnecessary misc_tools dependencies
19475adb70 chore: Statically link OpenMP into the cracker fun util on Windows
1be311e51f feat: Build the fun utils when cross-compiling to Windows
88133f8446 chore: Strip Windows binaries
3cc0ae7535 refactor: Copy over all of the required static dependencies
c4fa8f7fb1 feat: Generate .def, .exp and .lib files when building for Windows
74bbac5363 feat: Let CMake create the dll instead of doing so ourselves
246642e9ae feat: Harden Windows cross-compilation
8d431c0d11 chore: Bump Windows build dependency versions
e519f7998b fix: Remove unnecessary wsock32 dependency on Windows
ed2b60c217 chore: Use a specific non-broken slimcc version.
d7f21010a1 chore: Update github actions.
e71a68b7f2 docs: Update the list of CMake options
77e08876ff chore: Remove mod and founder from group API naming scheme
12bc042767 docs: add the experimental api build option to INSTALL.md
e1fa5cae96 refactor: Rename Queries to Query to align with other enums.
be82a3ea30 fix: Correct type for conference offline peer numbers.
0627c36716 test: Add pkgsrc build.
92578afe4b test: Add FreeBSD VM action on GitHub.
52ece0f57b test: Build toxcore on NetBSD (VM).
3fe8ee2c11 chore: Only install tox_private.h on request.
9a8dfa06ab fix: save_compatibility_test failing on big-endian systems
86f5e55578 fix: Don't serve files from websockify.
710eb674a5 fix: Correctly pass extended public keys to group moderation code.
021db7031c refactor: Use `struct`s for extended public/secret keys.
a1e999fd80 chore: Compile libsodium reference implementation with compcert.
fbe3c19cf5 cleanup: correct a few nullable annotations
623e3ee5c3 cleanup: Don't use `memcpy` to cast arbitrary `struct`s to `uint8_t[]`.
c71567dc18 fix: Pass array, not array pointer, to `memcmp`.
9b46a08144 cleanup: Never pass `void*` directly to `memcpy`.
5d7b7a7bbc refactor: Use tox rng to seed the keypair generation.
961891d568 cleanup: Small improvements found by PVS Studio.
8201019f0d chore: Disable NGC saving by default, enable through Tox_Options.
5dd9ee3f65 cleanup: Replace pointer arithmetic with explicit `&arr[i]`.
ca4606d49d refactor: Use strong typedef for NGC peer id.
442213b722 cleanup: Simplify custom packet length check in NGC.
08d3393def fix: Correct a few potential null derefs in bootstrap daemon.
b9877b32b0 fix: Add missing memunlock of local variable when it goes out of scope.
dab5fe44b9 fix: Zero out stack-allocated secret key before return.
f058103299 refactor: Make prune_gc_sanctions_list more obviously correct.
3ba7a0dec9 docs: Add static analysis tool list to README.
8d0811a0f3 docs: Run prettier-markdown on markdown files.
969e3a2bfc refactor: Fix network test not using the strong typedef
93c83fbc7c refactor: Use strong typedef instead of struct for `Socket`.
9fe18b176f fix: Fix some false positive from PVS Studio.
7c44379ccb cleanup: Check that WINXP macro exists before comparing it.
5c93231bef refactor: Make tox mutex non-recursive.
aacff73939 docs: Fix up doxyfile.
d55fc85ff5 docs: Add more documentation to crypto_core.
5bdaaaedb6 refactor: Remove `Tox *` from `tox_dispatch`.
e202341e76 refactor: Don't rely on tox_dispatch passing tox in tests.
34df938f52 chore: Use C++ mode for clang-tidy.
8b05296a78 chore: Check that both gtest and gmock exist for tests.
42010660e1 test: Add slimcc compiler compatibility test.
b473630321 chore: Add some comments to the astyle config.
b7404f24f6 cleanup: Remove implicit bool conversions.
4e2dba4d9f chore: Reformat sources with astyle.
4359e3a6bc chore: Rename C++ headers to .hh suffixes.
0c05566e58 cleanup: Further `#include` cleanups.
8d29935b7a chore: Only check the bootstrap daemon checksum on release.
f70e588bc6 cleanup: Add more `const` where possible.
511bfe39c8 cleanup: Use Bazel modules to enforce proper `#include` hygiene.
1710a0d091 refactor: Move pack/unpack `IP_Port` from DHT into network module.
a975943564 chore: Really fix coverage docker image build.
c08409390f chore: Fix post-submit coverage image.
39aadf8922 fix: Don't use `memcmp` to compare `IP_Port`s.
d94246a906 fix: partially fix a bug that prevented group part messages from sending.
eeaa039222 chore: Fix rpm build; add a CI check for it.
8328449c1a chore: Speed up docker builds a bit by reducing layer count.
d6d67d56f3 cleanup: Add `const` where possible in auto tests.
6aa9e6850d cleanup: Minor cleanup of event unpack code.
bdf460a3a9 refactor: Rename `system_{memory,...}` to `os_{memory,...}`.
203e1af81e fix: a few off by one errors in group autotests
5c093c4888 cleanup: Remove all uses of `SIZEOF_VLA`.
662c2140f3 test: Add goblint static analyser.
8f07755834 cleanup: Use `memzero(x, s)` instead of `memset(x, 0, s)`.
a7258e40cf cleanup: Use explicit 0 instead of `PACKET_ID_PADDING`.
6370d0f15d cleanup: Expand the `Tox_Options` accessor macros.
14a1a0b9bd cleanup: Remove plan9 support.
a05dccad13 test: Add a simple new/delete test for Tox.
1cdcf938b9 cleanup: Add comment after every `#endif`.
ba99d4dc4b test: Fix comment I broke in the events test PR.
e07248debb refactor: Migrate auto_tests to new events API.
bdd42b5452 refactor: Add common msgpack array packer with callback.
3c659f5288 cleanup: Rename group to conference in groupav documentation.
89957be230 cleanup: Ensure handler params are named after callback params.
c650d9d345 refactor: Pass `this` pointer as first param to s11n callbacks.
e7fb91ddb8 refactor: Allow NULL pointers for byte arrays in events.
5e2c8cabc1 cleanup: make some improvements to group moderation test
259de4867e cleanup: Remove `bin_pack_{new,free}`.
21a8ff5895 cleanup: skip a do_gc iteration before removing peers marked for deletion
16809dc36e feat: Add dht_get_nodes_response event to the events system.
git-subtree-dir: external/toxcore/c-toxcore
git-subtree-split: b03b5712720de9a9901ea12fd741f177327a7021
2024-03-07 23:12:55 +01:00
|
|
|
#endif /* C_TOXCORE_TOXCORE_TOX_PRIVATE_H */
|