From 40b3f0b46380f79219301d71bf7bb52fda2831de Mon Sep 17 00:00:00 2001 From: iphydf Date: Sat, 12 Jul 2025 23:29:48 +0000 Subject: [PATCH] refactor: Use clang's nullability qualifiers instead of attributes. --- .circleci/config.yml | 9 +- .github/scripts/flags-clang.sh | 7 + other/analysis/run-clang | 7 +- other/analysis/run-clang-tidy | 5 + other/event_tooling/generate_event_c.cpp | 14 +- toxav/toxav_hacks.h | 12 +- toxcore/DHT.c | 138 ++--- toxcore/DHT.h | 122 ++--- toxcore/LAN_discovery.c | 14 +- toxcore/LAN_discovery.h | 10 +- toxcore/Messenger.c | 190 +++---- toxcore/Messenger.h | 306 ++++++------ toxcore/TCP_client.c | 54 +- toxcore/TCP_client.h | 68 +-- toxcore/TCP_common.c | 4 +- toxcore/TCP_common.h | 32 +- toxcore/TCP_connection.c | 70 +-- toxcore/TCP_connection.h | 78 +-- toxcore/TCP_server.c | 68 +-- toxcore/TCP_server.h | 16 +- toxcore/announce.c | 66 +-- toxcore/announce.h | 18 +- toxcore/attributes.h | 9 +- toxcore/bin_pack.c | 8 +- toxcore/bin_pack.h | 42 +- toxcore/bin_unpack.c | 8 +- toxcore/bin_unpack.h | 38 +- toxcore/crypto_core.c | 8 +- toxcore/crypto_core.h | 106 ++-- toxcore/crypto_core_pack.c | 8 +- toxcore/crypto_core_pack.h | 8 +- toxcore/events/conference_connected.c | 12 +- toxcore/events/conference_invite.c | 18 +- toxcore/events/conference_message.c | 20 +- toxcore/events/conference_peer_list_changed.c | 12 +- toxcore/events/conference_peer_name.c | 18 +- toxcore/events/conference_title.c | 18 +- toxcore/events/dht_nodes_response.c | 18 +- toxcore/events/events_alloc.h | 12 +- toxcore/events/file_chunk_request.c | 18 +- toxcore/events/file_recv.c | 22 +- toxcore/events/file_recv_chunk.c | 20 +- toxcore/events/file_recv_control.c | 16 +- toxcore/events/friend_connection_status.c | 14 +- toxcore/events/friend_lossless_packet.c | 16 +- toxcore/events/friend_lossy_packet.c | 16 +- toxcore/events/friend_message.c | 18 +- toxcore/events/friend_name.c | 16 +- toxcore/events/friend_read_receipt.c | 14 +- toxcore/events/friend_request.c | 14 +- toxcore/events/friend_status.c | 14 +- toxcore/events/friend_status_message.c | 16 +- toxcore/events/friend_typing.c | 14 +- toxcore/events/group_custom_packet.c | 18 +- toxcore/events/group_custom_private_packet.c | 18 +- toxcore/events/group_invite.c | 20 +- toxcore/events/group_join_fail.c | 14 +- toxcore/events/group_message.c | 22 +- toxcore/events/group_moderation.c | 18 +- toxcore/events/group_password.c | 16 +- toxcore/events/group_peer_exit.c | 24 +- toxcore/events/group_peer_join.c | 14 +- toxcore/events/group_peer_limit.c | 14 +- toxcore/events/group_peer_name.c | 18 +- toxcore/events/group_peer_status.c | 16 +- toxcore/events/group_privacy_state.c | 14 +- toxcore/events/group_private_message.c | 22 +- toxcore/events/group_self_join.c | 12 +- toxcore/events/group_topic.c | 18 +- toxcore/events/group_topic_lock.c | 14 +- toxcore/events/group_voice_state.c | 14 +- toxcore/events/self_connection_status.c | 12 +- toxcore/forwarding.c | 28 +- toxcore/forwarding.h | 36 +- toxcore/friend_connection.c | 40 +- toxcore/friend_connection.h | 58 +-- toxcore/friend_requests.c | 8 +- toxcore/friend_requests.h | 22 +- toxcore/group.c | 200 ++++---- toxcore/group.h | 118 ++--- toxcore/group_announce.c | 8 +- toxcore/group_announce.h | 38 +- toxcore/group_announce_test.cc | 16 +- toxcore/group_chats.c | 470 +++++++++--------- toxcore/group_chats.h | 182 +++---- toxcore/group_common.h | 124 ++--- toxcore/group_connection.c | 24 +- toxcore/group_connection.h | 54 +- toxcore/group_moderation.c | 80 +-- toxcore/group_moderation.h | 62 +-- toxcore/group_onion_announce.c | 4 +- toxcore/group_onion_announce.h | 8 +- toxcore/group_pack.c | 28 +- toxcore/group_pack.h | 8 +- toxcore/list.c | 6 +- toxcore/list.h | 20 +- toxcore/logger.h | 12 +- toxcore/mem.c | 8 +- toxcore/mem.h | 34 +- toxcore/mono_time.c | 6 +- toxcore/mono_time.h | 20 +- toxcore/net_crypto.c | 148 +++--- toxcore/net_crypto.h | 84 ++-- toxcore/net_profile.c | 4 +- toxcore/net_profile.h | 14 +- toxcore/network.c | 90 ++-- toxcore/network.h | 186 +++---- toxcore/onion.c | 22 +- toxcore/onion.h | 48 +- toxcore/onion_announce.c | 44 +- toxcore/onion_announce.h | 34 +- toxcore/onion_client.c | 92 ++-- toxcore/onion_client.h | 66 +-- toxcore/ping.c | 8 +- toxcore/ping.h | 10 +- toxcore/ping_array.c | 4 +- toxcore/ping_array.h | 8 +- toxcore/shared_key_cache.c | 4 +- toxcore/shared_key_cache.h | 8 +- toxcore/sort.c | 12 +- toxcore/sort.h | 28 +- toxcore/state.c | 18 +- toxcore/state.h | 18 +- toxcore/timed_auth.c | 4 +- toxcore/timed_auth.h | 8 +- toxcore/tox.c | 166 +++---- toxcore/tox_dispatch.c | 2 +- toxcore/tox_event.c | 10 +- toxcore/tox_event.h | 410 +++++++-------- toxcore/tox_events.c | 8 +- toxcore/tox_pack.h | 22 +- toxcore/tox_unpack.c | 22 +- toxcore/tox_unpack.h | 22 +- toxcore/util.h | 14 +- 134 files changed, 2793 insertions(+), 2784 deletions(-) diff --git a/.circleci/config.yml b/.circleci/config.yml index 2b64161b3..dfb76b5ef 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -125,15 +125,12 @@ jobs: cimple: working_directory: /tmp/cirrus-ci-build docker: - - image: toxchat/toktok-stack:latest-release + - image: toxchat/toktok-stack:latest steps: - checkout - - run: git submodule update --init --recursive - - run: /src/workspace/tools/inject-repo c-toxcore - - run: cd /src/workspace && - bazel test - -k + - run: + CIRCLE_JOB=release bash <(curl -s https://raw.githubusercontent.com/TokTok/ci-tools/refs/heads/master/tools/circleci-bazel-test) --build_tag_filters=haskell --test_tag_filters=haskell -- diff --git a/.github/scripts/flags-clang.sh b/.github/scripts/flags-clang.sh index 02fbd766e..22ea2eee9 100644 --- a/.github/scripts/flags-clang.sh +++ b/.github/scripts/flags-clang.sh @@ -9,6 +9,11 @@ add_flag -Weverything # Disable specific warning flags for both C and C++. +# We're not checking nullability, yet. +# TODO(iphydf): Remove. +add_flag -Wno-nullable-to-nonnull-conversion +add_flag -Wno-nullability-completeness + # Very verbose, not very useful. This warns about things like int -> uint # conversions that change sign without a cast and narrowing conversions. add_flag -Wno-conversion @@ -30,6 +35,8 @@ add_flag -Wno-missing-braces add_flag -Wno-missing-field-initializers # We don't use this attribute. It appears in the non-NDEBUG stderr logger. add_flag -Wno-missing-noreturn +# We want to use this extension. +add_flag -Wno-nullability-extension # Useful sometimes, but we accept padding in structs for clarity. # Reordering fields to avoid padding will reduce readability. add_flag -Wno-padded diff --git a/other/analysis/run-clang b/other/analysis/run-clang index 3f7113b49..157ddbeea 100755 --- a/other/analysis/run-clang +++ b/other/analysis/run-clang @@ -25,15 +25,18 @@ run() { -Wno-missing-braces \ -Wno-missing-field-initializers \ -Wno-missing-noreturn \ + -Wno-nullability-completeness \ + -Wno-nullability-extension \ + -Wno-nullable-to-nonnull-conversion \ -Wno-old-style-cast \ -Wno-padded \ + -Wno-source-uses-openmp \ -Wno-switch-default \ -Wno-tautological-pointer-compare \ -Wno-unreachable-code-return \ -Wno-unsafe-buffer-usage \ -Wno-unused-parameter \ - -Wno-used-but-marked-unused \ - -Wno-source-uses-openmp + -Wno-used-but-marked-unused } . other/analysis/variants.sh diff --git a/other/analysis/run-clang-tidy b/other/analysis/run-clang-tidy index bcdb78f5b..b48419f7d 100755 --- a/other/analysis/run-clang-tidy +++ b/other/analysis/run-clang-tidy @@ -7,6 +7,11 @@ ERRORS="*" # Still good to occasionally look at. ERRORS="$ERRORS,-google-readability-casting" +# TODO(iphydf): Fix these. +CHECKS="$CHECKS,-clang-analyzer-nullability.NullableDereferenced" +CHECKS="$CHECKS,-clang-analyzer-nullability.NullablePassedToNonnull" +CHECKS="$CHECKS,-clang-analyzer-nullability.NullPassedToNonnull" + # Need to investigate or disable and document these. # ========================================================= diff --git a/other/event_tooling/generate_event_c.cpp b/other/event_tooling/generate_event_c.cpp index 157356a88..3583b4f62 100644 --- a/other/event_tooling/generate_event_c.cpp +++ b/other/event_tooling/generate_event_c.cpp @@ -228,14 +228,14 @@ void generate_event_impl(const std::string& event_name, const std::vector 1) { f << " if (!bin_unpack_array_fixed(bu, " << event_types.size() << ", nullptr)) {\n return false;\n }\n\n"; @@ -421,7 +421,7 @@ void generate_event_impl(const std::string& event_name, const std::vectorevents == nullptr) {\n return nullptr;\n }\n\n"; diff --git a/toxav/toxav_hacks.h b/toxav/toxav_hacks.h index 04671b642..84819beb4 100644 --- a/toxav/toxav_hacks.h +++ b/toxav/toxav_hacks.h @@ -14,16 +14,16 @@ typedef struct ToxAVCall ToxAVCall; #endif /* TOXAV_CALL_DEFINED */ -ToxAVCall *call_get(non_null() ToxAV *av, uint32_t friend_number); +ToxAVCall *_Nullable call_get(ToxAV *_Nonnull av, uint32_t friend_number); -RTPSession *rtp_session_get(non_null() ToxAVCall *call, int payload_type); +RTPSession *_Nullable rtp_session_get(ToxAVCall *_Nonnull call, int payload_type); -MSISession *tox_av_msi_get(non_null() const ToxAV *av); +MSISession *_Nullable tox_av_msi_get(const ToxAV *_Nonnull av); -BWController *bwc_controller_get(non_null() const ToxAVCall *call); +BWController *_Nullable bwc_controller_get(const ToxAVCall *_Nonnull call); -Mono_Time *toxav_get_av_mono_time(non_null() const ToxAV *av); +Mono_Time *_Nullable toxav_get_av_mono_time(const ToxAV *_Nonnull av); -const Logger *toxav_get_logger(non_null() const ToxAV *av); +const Logger *_Nonnull toxav_get_logger(const ToxAV *_Nonnull av); #endif /* C_TOXCORE_TOXAV_HACKS_H */ diff --git a/toxcore/DHT.c b/toxcore/DHT.c index ba580414f..7f420ba00 100644 --- a/toxcore/DHT.c +++ b/toxcore/DHT.c @@ -194,7 +194,7 @@ const uint8_t *dht_get_friend_public_key(const DHT *dht, uint32_t friend_num) return dht->friends_list[friend_num].public_key; } -static bool assoc_timeout(uint64_t cur_time, non_null() const IPPTsPng *assoc) +static bool assoc_timeout(uint64_t cur_time, const IPPTsPng *_Nonnull assoc) { return (assoc->timestamp + BAD_NODE_TIMEOUT) <= cur_time; } @@ -203,7 +203,7 @@ static bool assoc_timeout(uint64_t cur_time, non_null() const IPPTsPng *assoc) * * If the ip_port is already IPv4 this function returns a copy of the original ip_port. */ -static IP_Port ip_port_normalize(non_null() const IP_Port *ip_port) +static IP_Port ip_port_normalize(const IP_Port *_Nonnull ip_port) { IP_Port res = *ip_port; @@ -402,7 +402,7 @@ int dht_create_packet(const Memory *mem, const Random *rng, * * @retval true on success. */ -static bool bin_pack_node_handler(non_null() const void *arr, uint32_t index, non_null() const Logger *logger, non_null() Bin_Pack *bp) +static bool bin_pack_node_handler(const void *_Nonnull arr, uint32_t index, const Logger *_Nonnull logger, Bin_Pack *_Nonnull bp) { const Node_format *nodes = (const Node_format *)arr; return bin_pack_ip_port(bp, logger, &nodes[index].ip_port) @@ -462,7 +462,7 @@ int unpack_nodes(Node_format *nodes, uint16_t max_num_nodes, uint16_t *processed * * @return index or UINT32_MAX if not found. */ -static uint32_t index_of_client_pk(nullable() const Client_data *array, uint32_t size, non_null() const uint8_t *pk) +static uint32_t index_of_client_pk(const Client_data *_Nullable array, uint32_t size, const uint8_t *_Nonnull pk) { assert(size == 0 || array != nullptr); for (uint32_t i = 0; i < size; ++i) { @@ -474,7 +474,7 @@ static uint32_t index_of_client_pk(nullable() const Client_data *array, uint32_t return UINT32_MAX; } -static uint32_t index_of_friend_pk(nullable() const DHT_Friend *array, uint32_t size, non_null() const uint8_t *pk) +static uint32_t index_of_friend_pk(const DHT_Friend *_Nullable array, uint32_t size, const uint8_t *_Nonnull pk) { assert(size == 0 || array != nullptr); for (uint32_t i = 0; i < size; ++i) { @@ -486,7 +486,7 @@ static uint32_t index_of_friend_pk(nullable() const DHT_Friend *array, uint32_t return UINT32_MAX; } -static uint32_t index_of_node_pk(nullable() const Node_format *array, uint32_t size, non_null() const uint8_t *pk) +static uint32_t index_of_node_pk(const Node_format *_Nullable array, uint32_t size, const uint8_t *_Nonnull pk) { assert(size == 0 || array != nullptr); for (uint32_t i = 0; i < size; ++i) { @@ -502,7 +502,7 @@ static uint32_t index_of_node_pk(nullable() const Node_format *array, uint32_t s * * @return index or UINT32_MAX if not found. */ -static uint32_t index_of_client_ip_port(nullable() const Client_data *array, uint32_t size, non_null() const IP_Port *ip_port) +static uint32_t index_of_client_ip_port(const Client_data *_Nullable array, uint32_t size, const IP_Port *_Nonnull ip_port) { assert(size == 0 || array != nullptr); for (uint32_t i = 0; i < size; ++i) { @@ -516,7 +516,7 @@ static uint32_t index_of_client_ip_port(nullable() const Client_data *array, uin } /** Update ip_port of client if it's needed. */ -static void update_client(non_null() const Logger *log, non_null() const Mono_Time *mono_time, int index, non_null() Client_data *client, non_null() const IP_Port *ip_port) +static void update_client(const Logger *_Nonnull log, const Mono_Time *_Nonnull mono_time, int index, Client_data *_Nonnull client, const IP_Port *_Nonnull ip_port) { IPPTsPng *assoc; int ip_version; @@ -556,8 +556,8 @@ static void update_client(non_null() const Logger *log, non_null() const Mono_Ti * If the id is already in the list with a different ip_port, update it. * TODO(irungentoo): Maybe optimize this. */ -static bool client_or_ip_port_in_list(non_null() const Logger *log, non_null() const Mono_Time *mono_time, non_null() Client_data *list, uint16_t length, non_null() const uint8_t *public_key, - non_null() const IP_Port *ip_port) +static bool client_or_ip_port_in_list(const Logger *_Nonnull log, const Mono_Time *_Nonnull mono_time, Client_data *_Nonnull list, uint16_t length, const uint8_t *_Nonnull public_key, + const IP_Port *_Nonnull ip_port) { const uint64_t temp_time = mono_time_get(mono_time); uint32_t index = index_of_client_pk(list, length, public_key); @@ -632,8 +632,8 @@ bool add_to_list( /** * helper for `get_close_nodes()`. argument list is a monster :D */ -static void get_close_nodes_inner(uint64_t cur_time, non_null() const uint8_t *public_key, non_null() Node_format *nodes_list, non_null() uint32_t *num_nodes_ptr, Family sa_family, - non_null() const Client_data *client_list, uint32_t client_list_length, bool is_lan, bool want_announce) +static void get_close_nodes_inner(uint64_t cur_time, const uint8_t *_Nonnull public_key, Node_format *_Nonnull nodes_list, uint32_t *_Nonnull num_nodes_ptr, Family sa_family, + const Client_data *_Nonnull client_list, uint32_t client_list_length, bool is_lan, bool want_announce) { if (!net_family_is_ipv4(sa_family) && !net_family_is_ipv6(sa_family) && !net_family_is_unspec(sa_family)) { return; @@ -699,8 +699,8 @@ static void get_close_nodes_inner(uint64_t cur_time, non_null() const uint8_t *p * * want_announce: return only nodes which implement the dht announcements protocol. */ -static int get_somewhat_close_nodes(uint64_t cur_time, non_null() const uint8_t *public_key, non_null() Node_format nodes_list[MAX_SENT_NODES], Family sa_family, - non_null() const Client_data *close_clientlist, non_null() const DHT_Friend *friends_list, uint16_t friends_list_size, bool is_lan, bool want_announce) +static int get_somewhat_close_nodes(uint64_t cur_time, const uint8_t *_Nonnull public_key, Node_format nodes_list[_Nonnull MAX_SENT_NODES], Family sa_family, + const Client_data *_Nonnull close_clientlist, const DHT_Friend *_Nonnull friends_list, uint16_t friends_list_size, bool is_lan, bool want_announce) { for (uint16_t i = 0; i < MAX_SENT_NODES; ++i) { nodes_list[i] = empty_node_format; @@ -739,7 +739,7 @@ int get_close_nodes( } #ifdef CHECK_ANNOUNCE_NODE -static void set_announce_node_in_list(non_null() Client_data *list, uint32_t list_len, non_null() const uint8_t *public_key) +static void set_announce_node_in_list(Client_data *_Nonnull list, uint32_t list_len, const uint8_t *_Nonnull public_key) { const uint32_t index = index_of_client_pk(list, list_len, public_key); @@ -764,7 +764,7 @@ void set_announce_node(DHT *dht, const uint8_t *public_key) } /** @brief Send data search request, searching for a random key. */ -static bool send_announce_ping(non_null() DHT *dht, non_null() const uint8_t *public_key, non_null() const IP_Port *ip_port) +static bool send_announce_ping(DHT *_Nonnull dht, const uint8_t *_Nonnull public_key, const IP_Port *_Nonnull ip_port) { uint8_t plain[CRYPTO_PUBLIC_KEY_SIZE + sizeof(uint64_t)]; @@ -791,9 +791,9 @@ static bool send_announce_ping(non_null() DHT *dht, non_null() const uint8_t *pu } /** @brief If the response is valid, set the sender as an announce node. */ -static int handle_data_search_response(non_null() void *object, non_null() const IP_Port *source, - non_null() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int handle_data_search_response(void *_Nonnull object, const IP_Port *_Nonnull source, + const uint8_t *_Nonnull packet, uint16_t length, + void *_Nullable userdata) { DHT *dht = (DHT *) object; const int32_t plain_len = (int32_t)length - (1 + CRYPTO_PUBLIC_KEY_SIZE + CRYPTO_NONCE_SIZE + CRYPTO_MAC_SIZE); @@ -841,7 +841,7 @@ static int handle_data_search_response(non_null() void *object, non_null() const * return false if node can't be stored. * return true if it can. */ -static bool store_node_ok(non_null() const Client_data *client, uint64_t cur_time, non_null() const uint8_t *public_key, non_null() const uint8_t *comp_public_key) +static bool store_node_ok(const Client_data *_Nonnull client, uint64_t cur_time, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull comp_public_key) { return (assoc_timeout(cur_time, &client->assoc4) && assoc_timeout(cur_time, &client->assoc6)) @@ -854,7 +854,7 @@ typedef struct Client_data_Cmp { const uint8_t *comp_public_key; } Client_data_Cmp; -static int client_data_cmp(non_null() const Client_data_Cmp *cmp, non_null() const Client_data *entry1, non_null() const Client_data *entry2) +static int client_data_cmp(const Client_data_Cmp *_Nonnull cmp, const Client_data *_Nonnull entry1, const Client_data *_Nonnull entry2) { const bool t1 = assoc_timeout(cmp->cur_time, &entry1->assoc4) && assoc_timeout(cmp->cur_time, &entry1->assoc6); const bool t2 = assoc_timeout(cmp->cur_time, &entry2->assoc4) && assoc_timeout(cmp->cur_time, &entry2->assoc6); @@ -884,7 +884,7 @@ static int client_data_cmp(non_null() const Client_data_Cmp *cmp, non_null() con return 0; } -static bool client_data_less_handler(non_null() const void *object, non_null() const void *a, non_null() const void *b) +static bool client_data_less_handler(const void *_Nonnull object, const void *_Nonnull a, const void *_Nonnull b) { const Client_data_Cmp *cmp = (const Client_data_Cmp *)object; const Client_data *entry1 = (const Client_data *)a; @@ -893,26 +893,26 @@ static bool client_data_less_handler(non_null() const void *object, non_null() c return client_data_cmp(cmp, entry1, entry2) < 0; } -static const void *client_data_get_handler(non_null() const void *arr, uint32_t index) +static const void *client_data_get_handler(const void *_Nonnull arr, uint32_t index) { const Client_data *entries = (const Client_data *)arr; return &entries[index]; } -static void client_data_set_handler(non_null() void *arr, uint32_t index, non_null() const void *val) +static void client_data_set_handler(void *_Nonnull arr, uint32_t index, const void *_Nonnull val) { Client_data *entries = (Client_data *)arr; const Client_data *entry = (const Client_data *)val; entries[index] = *entry; } -static void *client_data_subarr_handler(non_null() void *arr, uint32_t index, uint32_t size) +static void *client_data_subarr_handler(void *_Nonnull arr, uint32_t index, uint32_t size) { Client_data *entries = (Client_data *)arr; return &entries[index]; } -static void *client_data_alloc_handler(non_null() const void *object, uint32_t size) +static void *client_data_alloc_handler(const void *_Nonnull object, uint32_t size) { const Client_data_Cmp *cmp = (const Client_data_Cmp *)object; Client_data *tmp = (Client_data *)mem_valloc(cmp->mem, size, sizeof(Client_data)); @@ -924,7 +924,7 @@ static void *client_data_alloc_handler(non_null() const void *object, uint32_t s return tmp; } -static void client_data_delete_handler(non_null() const void *object, non_null() void *arr, uint32_t size) +static void client_data_delete_handler(const void *_Nonnull object, void *_Nonnull arr, uint32_t size) { const Client_data_Cmp *cmp = (const Client_data_Cmp *)object; mem_delete(cmp->mem, arr); @@ -939,7 +939,7 @@ static const Sort_Funcs client_data_cmp_funcs = { client_data_delete_handler, }; -static void sort_client_list(non_null() const Memory *mem, non_null() Client_data *list, uint64_t cur_time, unsigned int length, non_null() const uint8_t *comp_public_key) +static void sort_client_list(const Memory *_Nonnull mem, Client_data *_Nonnull list, uint64_t cur_time, unsigned int length, const uint8_t *_Nonnull comp_public_key) { // Pass comp_public_key to merge_sort with each Client_data entry, so the // comparison function can use it as the base of comparison. @@ -952,7 +952,7 @@ static void sort_client_list(non_null() const Memory *mem, non_null() Client_dat merge_sort(list, length, &cmp, &client_data_cmp_funcs); } -static void update_client_with_reset(non_null() const Mono_Time *mono_time, non_null() Client_data *client, non_null() const IP_Port *ip_port) +static void update_client_with_reset(const Mono_Time *_Nonnull mono_time, Client_data *_Nonnull client, const IP_Port *_Nonnull ip_port) { IPPTsPng *ipptp_write = nullptr; IPPTsPng *ipptp_clear = nullptr; @@ -993,8 +993,8 @@ static void update_client_with_reset(non_null() const Mono_Time *mono_time, non_ * * @return true when the item was stored, false otherwise */ -static bool replace_all(non_null() const DHT *dht, non_null() Client_data *list, uint16_t length, non_null() const uint8_t *public_key, non_null() const IP_Port *ip_port, - non_null() const uint8_t *comp_public_key) +static bool replace_all(const DHT *_Nonnull dht, Client_data *_Nonnull list, uint16_t length, const uint8_t *_Nonnull public_key, const IP_Port *_Nonnull ip_port, + const uint8_t *_Nonnull comp_public_key) { if (!net_family_is_ipv4(ip_port->ip.family) && !net_family_is_ipv6(ip_port->ip.family)) { return false; @@ -1021,7 +1021,7 @@ static bool replace_all(non_null() const DHT *dht, non_null() Client_data *list, * return false on failure. * return true on success. */ -static bool add_to_close(non_null() DHT *dht, non_null() const uint8_t *public_key, non_null() const IP_Port *ip_port, bool simulate) +static bool add_to_close(DHT *_Nonnull dht, const uint8_t *_Nonnull public_key, const IP_Port *_Nonnull ip_port, bool simulate) { unsigned int index = bit_by_bit_cmp(public_key, dht->self_public_key); @@ -1061,7 +1061,7 @@ bool node_addable_to_close_list(DHT *dht, const uint8_t *public_key, const IP_Po return add_to_close(dht, public_key, ip_port, true); } -static bool is_pk_in_client_list(non_null() const Client_data *list, unsigned int client_list_length, uint64_t cur_time, non_null() const uint8_t *public_key, non_null() const IP_Port *ip_port) +static bool is_pk_in_client_list(const Client_data *_Nonnull list, unsigned int client_list_length, uint64_t cur_time, const uint8_t *_Nonnull public_key, const IP_Port *_Nonnull ip_port) { const uint32_t index = index_of_client_pk(list, client_list_length, public_key); @@ -1076,7 +1076,7 @@ static bool is_pk_in_client_list(non_null() const Client_data *list, unsigned in return !assoc_timeout(cur_time, assoc); } -static bool is_pk_in_close_list(non_null() const DHT *dht, non_null() const uint8_t *public_key, non_null() const IP_Port *ip_port) +static bool is_pk_in_close_list(const DHT *_Nonnull dht, const uint8_t *_Nonnull public_key, const IP_Port *_Nonnull ip_port) { unsigned int index = bit_by_bit_cmp(public_key, dht->self_public_key); @@ -1095,7 +1095,7 @@ static bool is_pk_in_close_list(non_null() const DHT *dht, non_null() const uint * return false if the node should not be pinged. * return true if it should. */ -static bool ping_node_from_nodes_response_ok(non_null() DHT *dht, non_null() const uint8_t *public_key, non_null() const IP_Port *ip_port) +static bool ping_node_from_nodes_response_ok(DHT *_Nonnull dht, const uint8_t *_Nonnull public_key, const IP_Port *_Nonnull ip_port) { bool ret = false; @@ -1212,7 +1212,7 @@ uint32_t addto_lists(DHT *dht, const IP_Port *ip_port, const uint8_t *public_key return used; } -static bool update_client_data(non_null() const Mono_Time *mono_time, non_null() Client_data *array, size_t size, non_null() const IP_Port *ip_port, non_null() const uint8_t *pk, bool node_is_self) +static bool update_client_data(const Mono_Time *_Nonnull mono_time, Client_data *_Nonnull array, size_t size, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull pk, bool node_is_self) { const uint64_t temp_time = mono_time_get(mono_time); const uint32_t index = index_of_client_pk(array, size, pk); @@ -1243,7 +1243,7 @@ static bool update_client_data(non_null() const Mono_Time *mono_time, non_null() * If public_key is a friend or us, update ret_ip_port * nodepublic_key is the id of the node that sent us this info. */ -static void returnedip_ports(non_null() DHT *dht, non_null() const IP_Port *ip_port, non_null() const uint8_t *public_key, non_null() const uint8_t *nodepublic_key) +static void returnedip_ports(DHT *_Nonnull dht, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull nodepublic_key) { const IP_Port ipp_copy = ip_port_normalize(ip_port); @@ -1310,8 +1310,8 @@ bool dht_send_nodes_request(DHT *dht, const IP_Port *ip_port, const uint8_t *pub } /** Send a nodes response */ -static int send_nodes_response(non_null() const DHT *dht, non_null() const IP_Port *ip_port, non_null() const uint8_t *public_key, non_null() const uint8_t *client_id, - non_null() const uint8_t *sendback_data, uint16_t length, non_null() const uint8_t *shared_encryption_key) +static int send_nodes_response(const DHT *_Nonnull dht, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull client_id, + const uint8_t *_Nonnull sendback_data, uint16_t length, const uint8_t *_Nonnull shared_encryption_key) { /* Check if packet is going to be sent to ourself. */ if (pk_equal(public_key, dht->self_public_key)) { @@ -1360,7 +1360,7 @@ static int send_nodes_response(non_null() const DHT *dht, non_null() const IP_Po #define CRYPTO_NODE_SIZE (CRYPTO_PUBLIC_KEY_SIZE + sizeof(uint64_t)) -static int handle_nodes_request(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int handle_nodes_request(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { DHT *const dht = (DHT *)object; @@ -1395,7 +1395,7 @@ static int handle_nodes_request(non_null() void *object, non_null() const IP_Por } /** Return true if we sent a nodes request packet to the peer associated with the supplied info. */ -static bool sent_nodes_request_to_node(non_null() DHT *dht, non_null() const uint8_t *public_key, non_null() const IP_Port *node_ip_port, uint64_t ping_id) +static bool sent_nodes_request_to_node(DHT *_Nonnull dht, const uint8_t *_Nonnull public_key, const IP_Port *_Nonnull node_ip_port, uint64_t ping_id) { uint8_t data[sizeof(Node_format) * 2]; @@ -1412,8 +1412,8 @@ static bool sent_nodes_request_to_node(non_null() DHT *dht, non_null() const uin return ipport_equal(&test.ip_port, node_ip_port) && pk_equal(test.public_key, public_key); } -static bool handle_nodes_response_core(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() Node_format *plain_nodes, - uint16_t size_plain_nodes, non_null() uint32_t *num_nodes_out) +static bool handle_nodes_response_core(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, Node_format *_Nonnull plain_nodes, + uint16_t size_plain_nodes, uint32_t *_Nonnull num_nodes_out) { DHT *const dht = (DHT *)object; const uint32_t cid_size = 1 + CRYPTO_PUBLIC_KEY_SIZE + CRYPTO_NONCE_SIZE + 1 + sizeof(uint64_t) + CRYPTO_MAC_SIZE; @@ -1481,7 +1481,7 @@ static bool handle_nodes_response_core(non_null() void *object, non_null() const return true; } -static int handle_nodes_response(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int handle_nodes_response(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { DHT *const dht = (DHT *)object; Node_format plain_nodes[MAX_SENT_NODES]; @@ -1512,8 +1512,8 @@ static int handle_nodes_response(non_null() void *object, non_null() const IP_Po /*----------------------------------------------------------------------------------*/ /*------------------------END of packet handling functions--------------------------*/ -static uint32_t dht_friend_lock(non_null() DHT_Friend *const dht_friend, nullable() dht_ip_cb *ip_callback, - nullable() void *data, int32_t number) +static uint32_t dht_friend_lock(DHT_Friend *_Nonnull const dht_friend, dht_ip_cb *_Nullable ip_callback, + void *_Nullable data, int32_t number) { // find first free slot uint8_t lock_num; @@ -1540,7 +1540,7 @@ static uint32_t dht_friend_lock(non_null() DHT_Friend *const dht_friend, nullabl return lock_token; } -static void dht_friend_unlock(non_null() DHT_Friend *const dht_friend, uint32_t lock_token) +static void dht_friend_unlock(DHT_Friend *_Nonnull const dht_friend, uint32_t lock_token) { // If this triggers, there was a double free assert((lock_token & dht_friend->lock_flags) > 0); @@ -1677,8 +1677,8 @@ int dht_getfriendip(const DHT *dht, const uint8_t *public_key, IP_Port *ip_port) } /** returns number of nodes not in kill-timeout */ -static uint8_t do_ping_and_sendnode_requests(non_null() DHT *dht, non_null() uint64_t *lastgetnode, non_null() const uint8_t *public_key, non_null() Client_data *list, uint32_t list_count, - non_null() uint32_t *bootstrap_times, bool sortable) +static uint8_t do_ping_and_sendnode_requests(DHT *_Nonnull dht, uint64_t *_Nonnull lastgetnode, const uint8_t *_Nonnull public_key, Client_data *_Nonnull list, uint32_t list_count, + uint32_t *_Nonnull bootstrap_times, bool sortable) { uint8_t not_kill = 0; const uint64_t temp_time = mono_time_get(dht->mono_time); @@ -1762,7 +1762,7 @@ static uint8_t do_ping_and_sendnode_requests(non_null() DHT *dht, non_null() uin * Send a nodes request every NODES_REQUEST_INTERVAL seconds to a random good * node for each "friend" in our "friends" list. */ -static void do_dht_friends(non_null() DHT *dht) +static void do_dht_friends(DHT *_Nonnull dht) { for (size_t i = 0; i < dht->num_friends; ++i) { DHT_Friend *const dht_friend = &dht->friends_list[i]; @@ -1782,7 +1782,7 @@ static void do_dht_friends(non_null() DHT *dht) * * Send a nodes request every NODES_REQUEST_INTERVAL seconds to a random good node in the list. */ -static void do_close(non_null() DHT *dht) +static void do_close(DHT *_Nonnull dht) { for (size_t i = 0; i < dht->num_to_bootstrap; ++i) { dht_send_nodes_request(dht, &dht->to_bootstrap[i].ip_port, dht->to_bootstrap[i].public_key, dht->self_public_key); @@ -1888,7 +1888,7 @@ int route_packet(const DHT *dht, const uint8_t *public_key, const uint8_t *packe * @retval 0 if we are connected to friend or if no ips were found. * @retval -1 if no such friend. */ -static int friend_iplist(non_null() const DHT *dht, non_null() IP_Port *ip_portlist, uint16_t friend_num) +static int friend_iplist(const DHT *_Nonnull dht, IP_Port *_Nonnull ip_portlist, uint16_t friend_num) { if (friend_num >= dht->num_friends) { return -1; @@ -1968,7 +1968,7 @@ static int friend_iplist(non_null() const DHT *dht, non_null() IP_Port *ip_portl * @param n A pointer to the number that will be returned from `foreach_ip_port`. * @param userdata The `userdata` pointer passed to `foreach_ip_port`. */ -typedef bool foreach_ip_port_cb(const DHT *dht, const IP_Port *ip_port, uint32_t *n, void *userdata); +typedef bool foreach_ip_port_cb(const DHT *_Nonnull dht, const IP_Port *_Nonnull ip_port, uint32_t *_Nonnull n, void *_Nonnull userdata); /** * Runs a callback on every active connection for a given DHT friend. @@ -1981,7 +1981,7 @@ typedef bool foreach_ip_port_cb(const DHT *dht, const IP_Port *ip_port, uint32_t * @param callback The callback to invoke for each IP/port. * @param userdata Extra pointer passed to the callback. */ -static uint32_t foreach_ip_port(non_null() const DHT *dht, non_null() const DHT_Friend *dht_friend, non_null() foreach_ip_port_cb *callback, non_null() void *userdata) +static uint32_t foreach_ip_port(const DHT *_Nonnull dht, const DHT_Friend *_Nonnull dht_friend, foreach_ip_port_cb *_Nonnull callback, void *_Nonnull userdata) { uint32_t n = 0; @@ -2011,7 +2011,7 @@ static uint32_t foreach_ip_port(non_null() const DHT *dht, non_null() const DHT_ return n; } -static bool send_packet_to_friend(non_null() const DHT *dht, non_null() const IP_Port *ip_port, non_null() uint32_t *n, non_null() void *userdata) +static bool send_packet_to_friend(const DHT *_Nonnull dht, const IP_Port *_Nonnull ip_port, uint32_t *_Nonnull n, void *_Nonnull userdata) { const Packet *packet = (const Packet *)userdata; const int retval = send_packet(dht->net, ip_port, *packet); @@ -2052,7 +2052,7 @@ uint32_t route_to_friend(const DHT *dht, const uint8_t *friend_id, const Packet return foreach_ip_port(dht, dht_friend, send_packet_to_friend, &packet_userdata); } -static bool get_ip_port(non_null() const DHT *dht, non_null() const IP_Port *ip_port, non_null() uint32_t *n, non_null() void *userdata) +static bool get_ip_port(const DHT *_Nonnull dht, const IP_Port *_Nonnull ip_port, uint32_t *_Nonnull n, void *_Nonnull userdata) { IP_Port *ip_list = (IP_Port *)userdata; ip_list[*n] = *ip_port; @@ -2064,7 +2064,7 @@ static bool get_ip_port(non_null() const DHT *dht, non_null() const IP_Port *ip_ * * @return number of nodes the packet was sent to. */ -static uint32_t routeone_to_friend(non_null() const DHT *dht, non_null() const uint8_t *friend_id, non_null() const Packet *packet) +static uint32_t routeone_to_friend(const DHT *_Nonnull dht, const uint8_t *_Nonnull friend_id, const Packet *_Nonnull packet) { const uint32_t num = index_of_friend_pk(dht->friends_list, dht->num_friends, friend_id); @@ -2095,7 +2095,7 @@ static uint32_t routeone_to_friend(non_null() const DHT *dht, non_null() const u /*----------------------------------------------------------------------------------*/ /*---------------------BEGINNING OF NAT PUNCHING FUNCTIONS--------------------------*/ -static int send_nat_ping(non_null() const DHT *dht, non_null() const uint8_t *public_key, uint64_t ping_id, uint8_t type) +static int send_nat_ping(const DHT *_Nonnull dht, const uint8_t *_Nonnull public_key, uint64_t ping_id, uint8_t type) { uint8_t data[sizeof(uint64_t) + 1]; uint8_t packet_data[MAX_CRYPTO_REQUEST_SIZE]; @@ -2129,8 +2129,8 @@ static int send_nat_ping(non_null() const DHT *dht, non_null() const uint8_t *pu } /** Handle a received ping request for. */ -static int handle_nat_ping(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *source_pubkey, non_null() const uint8_t *packet, uint16_t length, - non_null() void *userdata) +static int handle_nat_ping(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull source_pubkey, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nonnull userdata) { DHT *const dht = (DHT *)object; @@ -2173,7 +2173,7 @@ static int handle_nat_ping(non_null() void *object, non_null() const IP_Port *so * * @return ip of 0 if failure. */ -static IP nat_commonip(non_null() const IP_Port *ip_portlist, uint16_t len, uint16_t min_num) +static IP nat_commonip(const IP_Port *_Nonnull ip_portlist, uint16_t len, uint16_t min_num) { IP zero; ip_reset(&zero); @@ -2205,7 +2205,7 @@ static IP nat_commonip(non_null() const IP_Port *ip_portlist, uint16_t len, uint * * @return number of ports and puts the list of ports in portlist. */ -static uint16_t nat_getports(non_null() uint16_t *portlist, non_null() const IP_Port *ip_portlist, uint16_t len, non_null() const IP *ip) +static uint16_t nat_getports(uint16_t *_Nonnull portlist, const IP_Port *_Nonnull ip_portlist, uint16_t len, const IP *_Nonnull ip) { uint16_t num = 0; @@ -2219,7 +2219,7 @@ static uint16_t nat_getports(non_null() uint16_t *portlist, non_null() const IP_ return num; } -static void punch_holes(non_null() DHT *dht, non_null() const IP *ip, non_null() const uint16_t *port_list, uint16_t numports, uint16_t friend_num) +static void punch_holes(DHT *_Nonnull dht, const IP *_Nonnull ip, const uint16_t *_Nonnull port_list, uint16_t numports, uint16_t friend_num) { if (!dht->hole_punching_enabled) { return; @@ -2279,7 +2279,7 @@ static void punch_holes(non_null() DHT *dht, non_null() const IP *ip, non_null() ++dht->friends_list[friend_num].nat.tries; } -static void do_nat(non_null() DHT *dht) +static void do_nat(DHT *_Nonnull dht) { const uint64_t temp_time = mono_time_get(dht->mono_time); @@ -2330,7 +2330,7 @@ static void do_nat(non_null() DHT *dht) * * @return the number of nodes. */ -static uint16_t list_nodes(non_null() const Random *rng, non_null() const Client_data *list, size_t length, uint64_t cur_time, non_null() Node_format *nodes, uint16_t max_num) +static uint16_t list_nodes(const Random *_Nonnull rng, const Client_data *_Nonnull list, size_t length, uint64_t cur_time, Node_format *_Nonnull nodes, uint16_t max_num) { if (max_num == 0) { return 0; @@ -2414,7 +2414,7 @@ void cryptopacket_registerhandler(DHT *dht, uint8_t byte, cryptopacket_handler_c dht->cryptopackethandlers[byte].object = object; } -static int cryptopacket_handle(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int cryptopacket_handle(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { DHT *const dht = (DHT *)object; @@ -2461,8 +2461,8 @@ void dht_callback_nodes_response(DHT *dht, dht_nodes_response_cb *function) dht->nodes_response_callback = function; } -static int handle_lan_discovery(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int handle_lan_discovery(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nullable userdata) { DHT *dht = (DHT *)object; if (!dht->lan_discovery_enabled) { @@ -2746,7 +2746,7 @@ int dht_connect_after_load(DHT *dht) return 0; } -static State_Load_Status dht_load_state_callback(non_null() void *outer, non_null() const uint8_t *data, uint32_t length, uint16_t type) +static State_Load_Status dht_load_state_callback(void *_Nonnull outer, const uint8_t *_Nonnull data, uint32_t length, uint16_t type) { DHT *dht = (DHT *)outer; diff --git a/toxcore/DHT.h b/toxcore/DHT.h index 36622f8eb..43ddbadb0 100644 --- a/toxcore/DHT.h +++ b/toxcore/DHT.h @@ -98,8 +98,8 @@ extern "C" { * @retval -1 on failure. * @return the length of the created packet on success. */ -int create_request(non_null() const Memory *mem, non_null() const Random *rng, non_null() const uint8_t *send_public_key, non_null() const uint8_t *send_secret_key, non_null() uint8_t *packet, - non_null() const uint8_t *recv_public_key, non_null() const uint8_t *data, uint32_t data_length, uint8_t request_id); +int create_request(const Memory *_Nonnull mem, const Random *_Nonnull rng, const uint8_t *_Nonnull send_public_key, const uint8_t *_Nonnull send_secret_key, uint8_t *_Nonnull packet, + const uint8_t *_Nonnull recv_public_key, const uint8_t *_Nonnull data, uint32_t data_length, uint8_t request_id); /** * @brief Decrypts and unpacks a DHT request packet. @@ -123,8 +123,8 @@ int create_request(non_null() const Memory *mem, non_null() const Random *rng, n * @retval -1 if not valid request. * @return the length of the unpacked data. */ -int handle_request(non_null() const Memory *mem, non_null() const uint8_t *self_public_key, non_null() const uint8_t *self_secret_key, non_null() uint8_t *public_key, non_null() uint8_t *data, - non_null() uint8_t *request_id, non_null() const uint8_t *packet, uint16_t packet_length); +int handle_request(const Memory *_Nonnull mem, const uint8_t *_Nonnull self_public_key, const uint8_t *_Nonnull self_secret_key, uint8_t *_Nonnull public_key, uint8_t *_Nonnull data, + uint8_t *_Nonnull request_id, const uint8_t *_Nonnull packet, uint16_t packet_length); typedef struct IPPTs { IP_Port ip_port; @@ -178,8 +178,8 @@ extern const Node_format empty_node_format; typedef struct DHT_Friend DHT_Friend; -const uint8_t *dht_friend_public_key(non_null() const DHT_Friend *dht_friend); -const Client_data *dht_friend_client(non_null() const DHT_Friend *dht_friend, size_t index); +const uint8_t *_Nonnull dht_friend_public_key(const DHT_Friend *_Nonnull dht_friend); +const Client_data *_Nonnull dht_friend_client(const DHT_Friend *_Nonnull dht_friend, size_t index); /** @return packet size of packed node with ip_family on success. * @retval -1 on failure. @@ -191,15 +191,15 @@ int packed_node_size(Family ip_family); * @return size of packet on success. * @retval -1 on failure. */ -int dht_create_packet(non_null() const Memory *mem, non_null() const Random *rng, non_null() const uint8_t public_key[CRYPTO_PUBLIC_KEY_SIZE], non_null() const uint8_t *shared_key, uint8_t type, - non_null() const uint8_t *plain, size_t plain_length, non_null() uint8_t *packet, size_t length); +int dht_create_packet(const Memory *_Nonnull mem, const Random *_Nonnull rng, const uint8_t public_key[_Nonnull CRYPTO_PUBLIC_KEY_SIZE], const uint8_t *_Nonnull shared_key, uint8_t type, + const uint8_t *_Nonnull plain, size_t plain_length, uint8_t *_Nonnull packet, size_t length); /** @brief Pack number of nodes into data of maxlength length. * * @return length of packed nodes on success. * @retval -1 on failure. */ -int pack_nodes(non_null() const Logger *logger, non_null() uint8_t *data, uint16_t length, non_null() const Node_format *nodes, uint16_t number); +int pack_nodes(const Logger *_Nonnull logger, uint8_t *_Nonnull data, uint16_t length, const Node_format *_Nonnull nodes, uint16_t number); /** @brief Unpack data of length into nodes of size max_num_nodes. * Put the length of the data processed in processed_data_len. @@ -208,28 +208,28 @@ int pack_nodes(non_null() const Logger *logger, non_null() uint8_t *data, uint16 * @return number of unpacked nodes on success. * @retval -1 on failure. */ -int unpack_nodes(non_null() Node_format *nodes, uint16_t max_num_nodes, nullable() uint16_t *processed_data_len, non_null() const uint8_t *data, +int unpack_nodes(Node_format *_Nonnull nodes, uint16_t max_num_nodes, uint16_t *_Nullable processed_data_len, const uint8_t *_Nonnull data, uint16_t length, bool tcp_enabled); /*----------------------------------------------------------------------------------*/ -typedef int cryptopacket_handler_cb(void *object, const IP_Port *source, const uint8_t *source_pubkey, - const uint8_t *packet, uint16_t length, void *userdata); +typedef int cryptopacket_handler_cb(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull source_pubkey, + const uint8_t *_Nonnull packet, uint16_t length, void *_Nullable userdata); typedef struct DHT DHT; -const uint8_t *dht_get_self_public_key(non_null() const DHT *dht); -const uint8_t *dht_get_self_secret_key(non_null() const DHT *dht); -void dht_set_self_public_key(non_null() DHT *dht, non_null() const uint8_t *key); -void dht_set_self_secret_key(non_null() DHT *dht, non_null() const uint8_t *key); +const uint8_t *_Nonnull dht_get_self_public_key(const DHT *_Nonnull dht); +const uint8_t *_Nonnull dht_get_self_secret_key(const DHT *_Nonnull dht); +void dht_set_self_public_key(DHT *_Nonnull dht, const uint8_t *_Nonnull key); +void dht_set_self_secret_key(DHT *_Nonnull dht, const uint8_t *_Nonnull key); -Networking_Core *dht_get_net(non_null() const DHT *dht); -struct Ping *dht_get_ping(non_null() const DHT *dht); -const Client_data *dht_get_close_clientlist(non_null() const DHT *dht); -const Client_data *dht_get_close_client(non_null() const DHT *dht, uint32_t client_num); -uint16_t dht_get_num_friends(non_null() const DHT *dht); +Networking_Core *_Nonnull dht_get_net(const DHT *_Nonnull dht); +struct Ping *_Nonnull dht_get_ping(const DHT *_Nonnull dht); +const Client_data *_Nonnull dht_get_close_clientlist(const DHT *_Nonnull dht); +const Client_data *_Nonnull dht_get_close_client(const DHT *_Nonnull dht, uint32_t client_num); +uint16_t dht_get_num_friends(const DHT *_Nonnull dht); -DHT_Friend *dht_get_friend(non_null() DHT *dht, uint32_t friend_num); -const uint8_t *dht_get_friend_public_key(non_null() const DHT *dht, uint32_t friend_num); +DHT_Friend *_Nonnull dht_get_friend(DHT *_Nonnull dht, uint32_t friend_num); +const uint8_t *_Nonnull dht_get_friend_public_key(const DHT *_Nonnull dht, uint32_t friend_num); /*----------------------------------------------------------------------------------*/ @@ -237,13 +237,13 @@ const uint8_t *dht_get_friend_public_key(non_null() const DHT *dht, uint32_t fri * Copy shared_key to encrypt/decrypt DHT packet from public_key into shared_key * for packets that we receive. */ -const uint8_t *dht_get_shared_key_recv(non_null() DHT *dht, non_null() const uint8_t *public_key); +const uint8_t *_Nullable dht_get_shared_key_recv(DHT *_Nonnull dht, const uint8_t *_Nonnull public_key); /** * Copy shared_key to encrypt/decrypt DHT packet from public_key into shared_key * for packets that we send. */ -const uint8_t *dht_get_shared_key_sent(non_null() DHT *dht, non_null() const uint8_t *public_key); +const uint8_t *_Nullable dht_get_shared_key_sent(DHT *_Nonnull dht, const uint8_t *_Nonnull public_key); /** * Sends a nodes request to `ip_port` with the public key `public_key` for nodes @@ -251,14 +251,14 @@ const uint8_t *dht_get_shared_key_sent(non_null() DHT *dht, non_null() const uin * * @retval true on success. */ -bool dht_send_nodes_request(non_null() DHT *dht, non_null() const IP_Port *ip_port, non_null() const uint8_t *public_key, non_null() const uint8_t *client_id); +bool dht_send_nodes_request(DHT *_Nonnull dht, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull client_id); -typedef void dht_ip_cb(void *object, int32_t number, const IP_Port *ip_port); +typedef void dht_ip_cb(void *_Nullable object, int32_t number, const IP_Port *_Nonnull ip_port); -typedef void dht_nodes_response_cb(const DHT *dht, const Node_format *node, void *user_data); +typedef void dht_nodes_response_cb(const DHT *_Nonnull dht, const Node_format *_Nonnull node, void *_Nullable user_data); /** Sets the callback to be triggered on a nodes response. */ -void dht_callback_nodes_response(non_null() DHT *dht, nullable() dht_nodes_response_cb *function); +void dht_callback_nodes_response(DHT *_Nonnull dht, dht_nodes_response_cb *_Nullable function); /** @brief Add a new friend to the friends list. * @param public_key must be CRYPTO_PUBLIC_KEY_SIZE bytes long. * @@ -273,8 +273,8 @@ void dht_callback_nodes_response(non_null() DHT *dht, nullable() dht_nodes_respo * @retval 0 if success. * @retval -1 if failure (friends list is full). */ -int dht_addfriend(non_null() DHT *dht, non_null() const uint8_t *public_key, nullable() dht_ip_cb *ip_callback, - nullable() void *data, int32_t number, non_null() uint32_t *lock_token); +int dht_addfriend(DHT *_Nonnull dht, const uint8_t *_Nonnull public_key, dht_ip_cb *_Nullable ip_callback, + void *_Nullable data, int32_t number, uint32_t *_Nonnull lock_token); /** @brief Delete a friend from the friends list. * public_key must be CRYPTO_PUBLIC_KEY_SIZE bytes long. * @param dht The DHT object @@ -284,7 +284,7 @@ int dht_addfriend(non_null() DHT *dht, non_null() const uint8_t *public_key, nul * @retval 0 if success. * @retval -1 if failure (public_key not in friends list). */ -int dht_delfriend(non_null() DHT *dht, non_null() const uint8_t *public_key, uint32_t lock_token); +int dht_delfriend(DHT *_Nonnull dht, const uint8_t *_Nonnull public_key, uint32_t lock_token); /** @brief Get ip of friend. * @@ -294,7 +294,7 @@ int dht_delfriend(non_null() DHT *dht, non_null() const uint8_t *public_key, uin * @retval 0 if public_key refers to a friend and we failed to find the friend (yet) * @retval 1 if public_key refers to a friend and we found him */ -int dht_getfriendip(non_null() const DHT *dht, non_null() const uint8_t *public_key, non_null() IP_Port *ip_port); +int dht_getfriendip(const DHT *_Nonnull dht, const uint8_t *_Nonnull public_key, IP_Port *_Nonnull ip_port); /** @brief Compares pk1 and pk2 with pk. * @@ -302,25 +302,25 @@ int dht_getfriendip(non_null() const DHT *dht, non_null() const uint8_t *public_ * @retval 1 if pk1 is closer. * @retval 2 if pk2 is closer. */ -int id_closest(non_null() const uint8_t *pk, non_null() const uint8_t *pk1, non_null() const uint8_t *pk2); +int id_closest(const uint8_t *_Nonnull pk, const uint8_t *_Nonnull pk1, const uint8_t *_Nonnull pk2); /** Return index of first unequal bit number between public keys pk1 and pk2. */ -unsigned int bit_by_bit_cmp(non_null() const uint8_t *pk1, non_null() const uint8_t *pk2); +unsigned int bit_by_bit_cmp(const uint8_t *_Nonnull pk1, const uint8_t *_Nonnull pk2); /** * Add node to the node list making sure only the nodes closest to cmp_pk are in the list. * * @return true iff the node was added to the list. */ -bool add_to_list(non_null() Node_format *nodes_list, uint32_t length, non_null() const uint8_t pk[CRYPTO_PUBLIC_KEY_SIZE], non_null() const IP_Port *ip_port, - non_null() const uint8_t cmp_pk[CRYPTO_PUBLIC_KEY_SIZE]); +bool add_to_list(Node_format *_Nonnull nodes_list, uint32_t length, const uint8_t pk[_Nonnull CRYPTO_PUBLIC_KEY_SIZE], const IP_Port *_Nonnull ip_port, + const uint8_t cmp_pk[_Nonnull CRYPTO_PUBLIC_KEY_SIZE]); /** Return 1 if node can be added to close list, 0 if it can't. */ -bool node_addable_to_close_list(non_null() DHT *dht, non_null() const uint8_t *public_key, non_null() const IP_Port *ip_port); +bool node_addable_to_close_list(DHT *_Nonnull dht, const uint8_t *_Nonnull public_key, const IP_Port *_Nonnull ip_port); #ifdef CHECK_ANNOUNCE_NODE /** Set node as announce node. */ -void set_announce_node(non_null() DHT *dht, non_null() const uint8_t *public_key); +void set_announce_node(DHT *_Nonnull dht, const uint8_t *_Nonnull public_key); #endif /* CHECK_ANNOUNCE_NODE */ /** @@ -333,7 +333,7 @@ void set_announce_node(non_null() DHT *dht, non_null() const uint8_t *public_key * * @return the number of nodes returned. */ -int get_close_nodes(non_null() const DHT *dht, non_null() const uint8_t *public_key, non_null() Node_format nodes_list[MAX_SENT_NODES], Family sa_family, bool is_lan, bool want_announce); +int get_close_nodes(const DHT *_Nonnull dht, const uint8_t *_Nonnull public_key, Node_format nodes_list[_Nonnull MAX_SENT_NODES], Family sa_family, bool is_lan, bool want_announce); /** @brief Put up to max_num nodes in nodes from the random friends. * @@ -342,16 +342,16 @@ int get_close_nodes(non_null() const DHT *dht, non_null() const uint8_t *public_ * * @return the number of nodes. */ -uint16_t randfriends_nodes(non_null() const DHT *dht, non_null() Node_format *nodes, uint16_t max_num); +uint16_t randfriends_nodes(const DHT *_Nonnull dht, Node_format *_Nonnull nodes, uint16_t max_num); /** @brief Put up to max_num nodes in nodes from the closelist. * * @return the number of nodes. */ -uint16_t closelist_nodes(non_null() const DHT *dht, non_null() Node_format *nodes, uint16_t max_num); +uint16_t closelist_nodes(const DHT *_Nonnull dht, Node_format *_Nonnull nodes, uint16_t max_num); /** Run this function at least a couple times per second (It's the main loop). */ -void do_dht(non_null() DHT *dht); +void do_dht(DHT *_Nonnull dht); /* * Use these two functions to bootstrap the client. @@ -360,7 +360,7 @@ void do_dht(non_null() DHT *dht); * @brief Sends a "nodes request" to the given node with ip, port and public_key * to setup connections */ -bool dht_bootstrap(non_null() DHT *dht, non_null() const IP_Port *ip_port, non_null() const uint8_t *public_key); +bool dht_bootstrap(DHT *_Nonnull dht, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key); /** @brief Resolves address into an IP address. * @@ -375,14 +375,14 @@ bool dht_bootstrap(non_null() DHT *dht, non_null() const IP_Port *ip_port, non_n * @retval true if the address could be converted into an IP address * @retval false otherwise */ -bool dht_bootstrap_from_address(non_null() DHT *dht, non_null() const char *address, bool ipv6enabled, bool dns_enabled, uint16_t port, non_null() const uint8_t *public_key); +bool dht_bootstrap_from_address(DHT *_Nonnull dht, const char *_Nonnull address, bool ipv6enabled, bool dns_enabled, uint16_t port, const uint8_t *_Nonnull public_key); /** @brief Start sending packets after DHT loaded_friends_list and loaded_clients_list are set. * * @retval 0 if successful * @retval -1 otherwise */ -int dht_connect_after_load(non_null() DHT *dht); +int dht_connect_after_load(DHT *_Nonnull dht); /* ROUTING FUNCTIONS */ @@ -391,7 +391,7 @@ int dht_connect_after_load(non_null() DHT *dht); * @return number of bytes sent. * @retval -1 if failure. */ -int route_packet(non_null() const DHT *dht, non_null() const uint8_t *public_key, non_null() const uint8_t *packet, uint16_t length); +int route_packet(const DHT *_Nonnull dht, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull packet, uint16_t length); /** * Send the following packet to everyone who tells us they are connected to friend_id. @@ -399,41 +399,41 @@ int route_packet(non_null() const DHT *dht, non_null() const uint8_t *public_key * @return ip for friend. * @return number of nodes the packet was sent to. (Only works if more than (MAX_FRIEND_CLIENTS / 4). */ -uint32_t route_to_friend(non_null() const DHT *dht, non_null() const uint8_t *friend_id, non_null() const Packet *packet); +uint32_t route_to_friend(const DHT *_Nonnull dht, const uint8_t *_Nonnull friend_id, const Packet *_Nonnull packet); /** Function to handle crypto packets. */ -void cryptopacket_registerhandler(non_null() DHT *dht, uint8_t byte, nullable() cryptopacket_handler_cb *cb, nullable() void *object); +void cryptopacket_registerhandler(DHT *_Nonnull dht, uint8_t byte, cryptopacket_handler_cb *_Nullable cb, void *_Nullable object); /* SAVE/LOAD functions */ /** Get the size of the DHT (for saving). */ -uint32_t dht_size(non_null() const DHT *dht); +uint32_t dht_size(const DHT *_Nonnull dht); /** Save the DHT in data where data is an array of size `dht_size()`. */ -void dht_save(non_null() const DHT *dht, non_null() uint8_t *data); +void dht_save(const DHT *_Nonnull dht, uint8_t *_Nonnull data); /** @brief Load the DHT from data of size size. * * @retval -1 if failure. * @retval 0 if success. */ -int dht_load(non_null() DHT *dht, non_null() const uint8_t *data, uint32_t length); +int dht_load(DHT *_Nonnull dht, const uint8_t *_Nonnull data, uint32_t length); /** Initialize DHT. */ -DHT *new_dht(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Random *rng, non_null() const Network *ns, non_null() Mono_Time *mono_time, non_null() Networking_Core *net, - bool hole_punching_enabled, bool lan_discovery_enabled); +DHT *_Nullable new_dht(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Random *_Nonnull rng, const Network *_Nonnull ns, Mono_Time *_Nonnull mono_time, Networking_Core *_Nonnull net, + bool hole_punching_enabled, bool lan_discovery_enabled); -void kill_dht(nullable() DHT *dht); +void kill_dht(DHT *_Nullable dht); /** * @retval false if we are not connected to the DHT. * @retval true if we are. */ -bool dht_isconnected(non_null() const DHT *dht); +bool dht_isconnected(const DHT *_Nonnull dht); /** * @retval false if we are not connected or only connected to lan peers with the DHT. * @retval true if we are. */ -bool dht_non_lan_connected(non_null() const DHT *dht); +bool dht_non_lan_connected(const DHT *_Nonnull dht); /** * This function returns the ratio of close dht nodes that are known to support announce/store. @@ -441,7 +441,7 @@ bool dht_non_lan_connected(non_null() const DHT *dht); * * @return number */ -uint16_t dht_get_num_closelist(non_null() const DHT *dht); +uint16_t dht_get_num_closelist(const DHT *_Nonnull dht); /** * This function returns the number of DHT nodes in the closelist, @@ -449,14 +449,14 @@ uint16_t dht_get_num_closelist(non_null() const DHT *dht); * * @return number */ -uint16_t dht_get_num_closelist_announce_capable(non_null() const DHT *dht); +uint16_t dht_get_num_closelist_announce_capable(const DHT *_Nonnull dht); /** @brief Attempt to add client with ip_port and public_key to the friends client list * and close_clientlist. * * @return 1+ if the item is used in any list, 0 else */ -uint32_t addto_lists(non_null() DHT *dht, non_null() const IP_Port *ip_port, non_null() const uint8_t *public_key); +uint32_t addto_lists(DHT *_Nonnull dht, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key); /** @brief Copies our own ip_port structure to `dest`. * @@ -468,7 +468,7 @@ uint32_t addto_lists(non_null() DHT *dht, non_null() const IP_Port *ip_port, non * @retval 1 if IP is a WAN address. * @retval 2 if IP is a LAN address. */ -unsigned int ipport_self_copy(non_null() const DHT *dht, non_null() IP_Port *dest); +unsigned int ipport_self_copy(const DHT *_Nonnull dht, IP_Port *_Nonnull dest); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/LAN_discovery.c b/toxcore/LAN_discovery.c index e970d9566..39eb36bb3 100644 --- a/toxcore/LAN_discovery.c +++ b/toxcore/LAN_discovery.c @@ -53,7 +53,7 @@ struct Broadcast_Info { #if defined(_WIN32) || defined(__WIN32__) || defined(WIN32) -static Broadcast_Info *fetch_broadcast_info(non_null() const Memory *mem, non_null() const Network *ns) +static Broadcast_Info *fetch_broadcast_info(const Memory *_Nonnull mem, const Network *_Nonnull ns) { Broadcast_Info *broadcast = (Broadcast_Info *)mem_alloc(mem, sizeof(Broadcast_Info)); @@ -123,9 +123,9 @@ static Broadcast_Info *fetch_broadcast_info(non_null() const Memory *mem, non_nu #elif !defined(FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION) && (defined(__linux__) || defined(__FreeBSD__) || defined(__DragonFly__)) -static bool ip4_is_local(non_null() const IP4 *ip4); +static bool ip4_is_local(const IP4 *_Nonnull ip4); -static Broadcast_Info *fetch_broadcast_info(non_null() const Memory *mem, non_null() const Network *ns) +static Broadcast_Info *fetch_broadcast_info(const Memory *_Nonnull mem, const Network *_Nonnull ns) { Broadcast_Info *broadcast = (Broadcast_Info *)mem_alloc(mem, sizeof(Broadcast_Info)); @@ -219,7 +219,7 @@ static Broadcast_Info *fetch_broadcast_info(non_null() const Memory *mem, non_nu #else // TODO(irungentoo): Other platforms? -static Broadcast_Info *fetch_broadcast_info(non_null() const Memory *mem, non_null() const Network *ns) +static Broadcast_Info *fetch_broadcast_info(const Memory *_Nonnull mem, const Network *_Nonnull ns) { Broadcast_Info *broadcast = (Broadcast_Info *)mem_alloc(mem, sizeof(Broadcast_Info)); @@ -239,7 +239,7 @@ static Broadcast_Info *fetch_broadcast_info(non_null() const Memory *mem, non_nu * @retval true if sent to at least one broadcast target. * @retval false on failure to find any valid broadcast target. */ -static bool send_broadcasts(non_null() const Networking_Core *net, non_null() const Broadcast_Info *broadcast, uint16_t port, non_null() const uint8_t *data, uint16_t length) +static bool send_broadcasts(const Networking_Core *_Nonnull net, const Broadcast_Info *_Nonnull broadcast, uint16_t port, const uint8_t *_Nonnull data, uint16_t length) { if (broadcast->count == 0) { return false; @@ -282,7 +282,7 @@ static IP broadcast_ip(Family family_socket, Family family_broadcast) return ip; } -static bool ip4_is_local(non_null() const IP4 *ip4) +static bool ip4_is_local(const IP4 *_Nonnull ip4) { /* Loopback. */ return ip4->uint8[0] == 127; @@ -308,7 +308,7 @@ bool ip_is_local(const IP *ip) return ip->ip.v6.uint64[0] == 0 && ip->ip.v6.uint32[2] == 0 && ip->ip.v6.uint32[3] == net_htonl(1); } -static bool ip4_is_lan(non_null() const IP4 *ip4) +static bool ip4_is_lan(const IP4 *_Nonnull ip4) { /* 10.0.0.0 to 10.255.255.255 range. */ if (ip4->uint8[0] == 10) { diff --git a/toxcore/LAN_discovery.h b/toxcore/LAN_discovery.h index df486de2d..765c67d8b 100644 --- a/toxcore/LAN_discovery.h +++ b/toxcore/LAN_discovery.h @@ -25,27 +25,27 @@ typedef struct Broadcast_Info Broadcast_Info; * * @return true on success, false on failure. */ -bool lan_discovery_send(non_null() const Networking_Core *net, non_null() const Broadcast_Info *broadcast, non_null() const uint8_t *dht_pk, uint16_t port); +bool lan_discovery_send(const Networking_Core *_Nonnull net, const Broadcast_Info *_Nonnull broadcast, const uint8_t *_Nonnull dht_pk, uint16_t port); /** * Discovers broadcast devices and IP addresses. */ -Broadcast_Info *lan_discovery_init(non_null() const Memory *mem, non_null() const Network *ns); +Broadcast_Info *_Nullable lan_discovery_init(const Memory *_Nonnull mem, const Network *_Nonnull ns); /** * Free all resources associated with the broadcast info. */ -void lan_discovery_kill(nullable() Broadcast_Info *broadcast); +void lan_discovery_kill(Broadcast_Info *_Nullable broadcast); /** * Is IP a local ip or not. */ -bool ip_is_local(non_null() const IP *ip); +bool ip_is_local(const IP *_Nonnull ip); /** * Checks if a given IP isn't routable. * * @return true if ip is a LAN ip, false if it is not. */ -bool ip_is_lan(non_null() const IP *ip); +bool ip_is_lan(const IP *_Nonnull ip); #endif /* C_TOXCORE_TOXCORE_LAN_DISCOVERY_H */ diff --git a/toxcore/Messenger.c b/toxcore/Messenger.c index 01c9ba4a0..fcb272cb0 100644 --- a/toxcore/Messenger.c +++ b/toxcore/Messenger.c @@ -61,7 +61,7 @@ bool friend_is_valid(const Messenger *m, int32_t friendnumber) * * @retval -1 if mem_vrealloc fails. */ -static int realloc_friendlist(non_null() Messenger *m, uint32_t num) +static int realloc_friendlist(Messenger *_Nonnull m, uint32_t num) { if (num == 0) { mem_delete(m->mem, m->friendlist); @@ -136,25 +136,25 @@ void getaddress(const Messenger *m, uint8_t *address) memcpy(address + CRYPTO_PUBLIC_KEY_SIZE + sizeof(nospam), &checksum, sizeof(checksum)); } -static bool send_online_packet(non_null() const Messenger *m, int friendcon_id) +static bool send_online_packet(const Messenger *_Nonnull m, int friendcon_id) { const uint8_t packet[1] = {PACKET_ID_ONLINE}; return write_cryptpacket(m->net_crypto, friend_connection_crypt_connection_id(m->fr_c, friendcon_id), packet, sizeof(packet), false) != -1; } -static bool send_offline_packet(non_null() const Messenger *m, int friendcon_id) +static bool send_offline_packet(const Messenger *_Nonnull m, int friendcon_id) { const uint8_t packet[1] = {PACKET_ID_OFFLINE}; return write_cryptpacket(m->net_crypto, friend_connection_crypt_connection_id(m->fr_c, friendcon_id), packet, sizeof(packet), false) != -1; } -static int m_handle_status(non_null() void *object, int friendcon_id, bool status, nullable() void *userdata); -static int m_handle_packet(non_null() void *object, int friendcon_id, non_null() const uint8_t *data, uint16_t length, nullable() void *userdata); -static int m_handle_lossy_packet(non_null() void *object, int friendcon_id, non_null() const uint8_t *data, uint16_t length, - nullable() void *userdata); -static int32_t init_new_friend(non_null() Messenger *m, non_null() const uint8_t *real_pk, uint8_t status) +static int m_handle_status(void *_Nonnull object, int friendcon_id, bool status, void *_Nullable userdata); +static int m_handle_packet(void *_Nonnull object, int friendcon_id, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata); +static int m_handle_lossy_packet(void *_Nonnull object, int friendcon_id, const uint8_t *_Nonnull data, uint16_t length, + void *_Nullable userdata); +static int32_t init_new_friend(Messenger *_Nonnull m, const uint8_t *_Nonnull real_pk, uint8_t status) { if (m->numfriends == UINT32_MAX) { LOGGER_ERROR(m->log, "Friend list full: we have more than 4 billion friends"); @@ -203,7 +203,7 @@ static int32_t init_new_friend(non_null() Messenger *m, non_null() const uint8_t return FAERR_NOMEM; } -static int32_t m_add_friend_contact_norequest(non_null() Messenger *m, non_null() const uint8_t *real_pk) +static int32_t m_add_friend_contact_norequest(Messenger *_Nonnull m, const uint8_t *_Nonnull real_pk) { if (getfriend_id(m, real_pk) != -1) { return FAERR_ALREADYSENT; @@ -311,7 +311,7 @@ int32_t m_addfriend_norequest(Messenger *m, const uint8_t *real_pk) return m_add_friend_contact_norequest(m, real_pk); } -static int clear_receipts(non_null() Messenger *m, int32_t friendnumber) +static int clear_receipts(Messenger *_Nonnull m, int32_t friendnumber) { if (!m_friend_exists(m, friendnumber)) { return -1; @@ -330,7 +330,7 @@ static int clear_receipts(non_null() Messenger *m, int32_t friendnumber) return 0; } -static int add_receipt(non_null() Messenger *m, int32_t friendnumber, uint32_t packet_num, uint32_t msg_id) +static int add_receipt(Messenger *_Nonnull m, int32_t friendnumber, uint32_t packet_num, uint32_t msg_id) { if (!m_friend_exists(m, friendnumber)) { return -1; @@ -359,7 +359,7 @@ static int add_receipt(non_null() Messenger *m, int32_t friendnumber, uint32_t p * return -1 on failure. * return 0 if packet was received. */ -static int friend_received_packet(non_null() const Messenger *m, int32_t friendnumber, uint32_t number) +static int friend_received_packet(const Messenger *_Nonnull m, int32_t friendnumber, uint32_t number) { if (!m_friend_exists(m, friendnumber)) { return -1; @@ -416,7 +416,7 @@ void m_kill_group_connection(Messenger *m, const GC_Chat *chat) kill_friend_connection(m->fr_c, chat->friend_connection_id); } -static int do_receipts(non_null() Messenger *m, int32_t friendnumber, nullable() void *userdata) +static int do_receipts(Messenger *_Nonnull m, int32_t friendnumber, void *_Nullable userdata) { if (!m_friend_exists(m, friendnumber)) { return -1; @@ -593,7 +593,7 @@ int m_send_message_generic(Messenger *m, int32_t friendnumber, uint8_t type, con return 0; } -static bool write_cryptpacket_id(non_null() const Messenger *m, int32_t friendnumber, uint8_t packet_id, non_null() const uint8_t *data, uint32_t length, bool congestion_control) +static bool write_cryptpacket_id(const Messenger *_Nonnull m, int32_t friendnumber, uint8_t packet_id, const uint8_t *_Nonnull data, uint32_t length, bool congestion_control) { if (!m_friend_exists(m, friendnumber)) { return false; @@ -616,7 +616,7 @@ static bool write_cryptpacket_id(non_null() const Messenger *m, int32_t friendnu /** @brief Send a name packet to friendnumber. * length is the length with the NULL terminator. */ -static bool m_sendname(non_null() const Messenger *m, int32_t friendnumber, non_null() const uint8_t *name, uint16_t length) +static bool m_sendname(const Messenger *_Nonnull m, int32_t friendnumber, const uint8_t *_Nonnull name, uint16_t length) { if (length > MAX_NAME_LENGTH) { return false; @@ -755,7 +755,7 @@ int m_set_statusmessage(Messenger *m, const uint8_t *status, uint16_t length) return 0; } -static bool userstatus_from_int(uint8_t status, non_null() Userstatus *out_enum) +static bool userstatus_from_int(uint8_t status, Userstatus *_Nonnull out_enum) { switch (status) { case USERSTATUS_NONE: { @@ -910,23 +910,23 @@ int m_get_istyping(const Messenger *m, int32_t friendnumber) return m->friendlist[friendnumber].is_typing ? 1 : 0; } -static bool send_statusmessage(non_null() const Messenger *m, int32_t friendnumber, non_null() const uint8_t *status, uint16_t length) +static bool send_statusmessage(const Messenger *_Nonnull m, int32_t friendnumber, const uint8_t *_Nonnull status, uint16_t length) { return write_cryptpacket_id(m, friendnumber, PACKET_ID_STATUSMESSAGE, status, length, false); } -static bool send_userstatus(non_null() const Messenger *m, int32_t friendnumber, uint8_t status) +static bool send_userstatus(const Messenger *_Nonnull m, int32_t friendnumber, uint8_t status) { return write_cryptpacket_id(m, friendnumber, PACKET_ID_USERSTATUS, &status, sizeof(status), false); } -static bool send_user_istyping(non_null() const Messenger *m, int32_t friendnumber, bool is_typing) +static bool send_user_istyping(const Messenger *_Nonnull m, int32_t friendnumber, bool is_typing) { const uint8_t typing = is_typing ? 1 : 0; return write_cryptpacket_id(m, friendnumber, PACKET_ID_TYPING, &typing, sizeof(typing), false); } -static int set_friend_statusmessage(non_null() const Messenger *m, int32_t friendnumber, non_null() const uint8_t *status, uint16_t length) +static int set_friend_statusmessage(const Messenger *_Nonnull m, int32_t friendnumber, const uint8_t *_Nonnull status, uint16_t length) { if (!m_friend_exists(m, friendnumber)) { return -1; @@ -944,12 +944,12 @@ static int set_friend_statusmessage(non_null() const Messenger *m, int32_t frien return 0; } -static void set_friend_userstatus(non_null() const Messenger *m, int32_t friendnumber, uint8_t status) +static void set_friend_userstatus(const Messenger *_Nonnull m, int32_t friendnumber, uint8_t status) { userstatus_from_int(status, &m->friendlist[friendnumber].userstatus); } -static void set_friend_typing(non_null() const Messenger *m, int32_t friendnumber, bool is_typing) +static void set_friend_typing(const Messenger *_Nonnull m, int32_t friendnumber, bool is_typing) { m->friendlist[friendnumber].is_typing = is_typing; } @@ -1001,7 +1001,7 @@ void m_callback_core_connection(Messenger *m, m_self_connection_status_cb *funct m->core_connection_change = function; } -static void check_friend_tcp_udp(non_null() Messenger *m, int32_t friendnumber, nullable() void *userdata) +static void check_friend_tcp_udp(Messenger *_Nonnull m, int32_t friendnumber, void *_Nullable userdata) { const int last_connection_udp_tcp = m->friendlist[friendnumber].last_connection_udp_tcp; const int ret = m_get_friend_connectionstatus(m, friendnumber); @@ -1019,9 +1019,9 @@ static void check_friend_tcp_udp(non_null() Messenger *m, int32_t friendnumber, m->friendlist[friendnumber].last_connection_udp_tcp = (Connection_Status)ret; } -static void break_files(non_null() const Messenger *m, int32_t friendnumber); +static void break_files(const Messenger *_Nonnull m, int32_t friendnumber); -static void check_friend_connectionstatus(non_null() Messenger *m, int32_t friendnumber, uint8_t status, nullable() void *userdata) +static void check_friend_connectionstatus(Messenger *_Nonnull m, int32_t friendnumber, uint8_t status, void *_Nullable userdata) { if (status == NOFRIEND) { return; @@ -1047,7 +1047,7 @@ static void check_friend_connectionstatus(non_null() Messenger *m, int32_t frien } } -static void set_friend_status(non_null() Messenger *m, int32_t friendnumber, uint8_t status, nullable() void *userdata) +static void set_friend_status(Messenger *_Nonnull m, int32_t friendnumber, uint8_t status, void *_Nullable userdata) { check_friend_connectionstatus(m, friendnumber, status, userdata); m->friendlist[friendnumber].status = status; @@ -1165,8 +1165,8 @@ int file_get_id(const Messenger *m, int32_t friendnumber, uint32_t filenumber, u * @retval 1 on success * @retval 0 on failure */ -static bool file_sendrequest(non_null() const Messenger *m, int32_t friendnumber, uint8_t filenumber, uint32_t file_type, uint64_t filesize, non_null() const uint8_t *file_id, - non_null() const uint8_t *filename, uint16_t filename_length) +static bool file_sendrequest(const Messenger *_Nonnull m, int32_t friendnumber, uint8_t filenumber, uint32_t file_type, uint64_t filesize, const uint8_t *_Nonnull file_id, + const uint8_t *_Nonnull filename, uint16_t filename_length) { if (!m_friend_exists(m, friendnumber)) { return false; @@ -1245,8 +1245,8 @@ long int new_filesender(const Messenger *m, int32_t friendnumber, uint32_t file_ return i; } -static bool send_file_control_packet(non_null() const Messenger *m, int32_t friendnumber, bool inbound, uint8_t filenumber, - uint8_t control_type, nullable() const uint8_t *data, uint16_t data_length) +static bool send_file_control_packet(const Messenger *_Nonnull m, int32_t friendnumber, bool inbound, uint8_t filenumber, + uint8_t control_type, const uint8_t *_Nullable data, uint16_t data_length) { assert(data_length == 0 || data != nullptr); if ((unsigned int)(1 + 3 + data_length) > MAX_CRYPTO_DATA_SIZE) { @@ -1444,7 +1444,7 @@ int file_seek(const Messenger *m, int32_t friendnumber, uint32_t filenumber, uin /** @return packet number on success. * @retval -1 on failure. */ -static int64_t send_file_data_packet(non_null() const Messenger *m, int32_t friendnumber, uint8_t filenumber, nullable() const uint8_t *data, +static int64_t send_file_data_packet(const Messenger *_Nonnull m, int32_t friendnumber, uint8_t filenumber, const uint8_t *_Nullable data, uint16_t length) { assert(length == 0 || data != nullptr); @@ -1555,7 +1555,7 @@ int send_file_data(const Messenger *m, int32_t friendnumber, uint32_t filenumber * @return true if there's still work to do, false otherwise. * */ -static bool do_all_filetransfers(non_null() Messenger *m, int32_t friendnumber, non_null() void *userdata, non_null() uint32_t *free_slots) +static bool do_all_filetransfers(Messenger *_Nonnull m, int32_t friendnumber, void *_Nonnull userdata, uint32_t *_Nonnull free_slots) { Friend *const friendcon = &m->friendlist[friendnumber]; @@ -1622,7 +1622,7 @@ static bool do_all_filetransfers(non_null() Messenger *m, int32_t friendnumber, return true; } -static void do_reqchunk_filecb(non_null() Messenger *m, int32_t friendnumber, nullable() void *userdata) +static void do_reqchunk_filecb(Messenger *_Nonnull m, int32_t friendnumber, void *_Nullable userdata) { // We're not currently doing any file transfers. if (m->friendlist[friendnumber].num_sending_files == 0) { @@ -1676,7 +1676,7 @@ static void break_files(const Messenger *m, int32_t friendnumber) } } -static struct File_Transfers *get_file_transfer(bool outbound, uint8_t filenumber, non_null() uint32_t *real_filenumber, non_null() Friend *sender) +static struct File_Transfers *get_file_transfer(bool outbound, uint8_t filenumber, uint32_t *_Nonnull real_filenumber, Friend *_Nonnull sender) { struct File_Transfers *ft; @@ -1698,8 +1698,8 @@ static struct File_Transfers *get_file_transfer(bool outbound, uint8_t filenumbe /** @retval -1 on failure * @retval 0 on success. */ -static int handle_filecontrol(non_null() Messenger *m, int32_t friendnumber, bool outbound, uint8_t filenumber, - uint8_t control_type, non_null() const uint8_t *data, uint16_t length, nullable() void *userdata) +static int handle_filecontrol(Messenger *_Nonnull m, int32_t friendnumber, bool outbound, uint8_t filenumber, + uint8_t control_type, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata) { uint32_t real_filenumber; struct File_Transfers *ft = get_file_transfer(outbound, filenumber, &real_filenumber, &m->friendlist[friendnumber]); @@ -1849,8 +1849,8 @@ int m_send_custom_lossy_packet(const Messenger *m, int32_t friendnumber, const u return 0; } -static int handle_custom_lossless_packet(non_null() void *object, int friend_num, non_null() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int handle_custom_lossless_packet(void *_Nonnull object, int friend_num, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nullable userdata) { Messenger *m = (Messenger *)object; if (!m_friend_exists(m, friend_num)) { @@ -1904,7 +1904,7 @@ int send_custom_lossless_packet(const Messenger *m, int32_t friendnumber, const } /** Function to filter out some friend requests*/ -static int friend_already_added(non_null() void *object, non_null() const uint8_t *public_key) +static int friend_already_added(void *_Nonnull object, const uint8_t *_Nonnull public_key) { const Messenger *m = (const Messenger *)object; @@ -1921,7 +1921,7 @@ static int friend_already_added(non_null() void *object, non_null() const uint8_ * @param friendcon_id friendlist index of the timed-out friend * @param t time */ -static void check_friend_request_timed_out(non_null() Messenger *m, uint32_t friendcon_id, uint64_t t, nullable() void *userdata) +static void check_friend_request_timed_out(Messenger *_Nonnull m, uint32_t friendcon_id, uint64_t t, void *_Nullable userdata) { Friend *f = &m->friendlist[friendcon_id]; if (f->friendrequest_lastsent + f->friendrequest_timeout < t) { @@ -1933,7 +1933,7 @@ static void check_friend_request_timed_out(non_null() Messenger *m, uint32_t fri } } -static int m_handle_status(non_null() void *object, int friendcon_id, bool status, nullable() void *userdata) +static int m_handle_status(void *_Nonnull object, int friendcon_id, bool status, void *_Nullable userdata) { Messenger *m = (Messenger *)object; if (status) { /* Went online. */ @@ -1947,7 +1947,7 @@ static int m_handle_status(non_null() void *object, int friendcon_id, bool statu return 0; } -static int m_handle_packet_offline(non_null() Messenger *m, const int friendcon_id, non_null() const uint8_t *data, const uint16_t data_length, nullable() void *userdata) +static int m_handle_packet_offline(Messenger *_Nonnull m, const int friendcon_id, const uint8_t *_Nonnull data, const uint16_t data_length, void *_Nullable userdata) { if (data_length == 0) { set_friend_status(m, friendcon_id, FRIEND_CONFIRMED, userdata); @@ -1956,7 +1956,7 @@ static int m_handle_packet_offline(non_null() Messenger *m, const int friendcon_ return 0; } -static int m_handle_packet_nickname(non_null() Messenger *m, const int friendcon_id, non_null() const uint8_t *data, const uint16_t data_length, nullable() void *userdata) +static int m_handle_packet_nickname(Messenger *_Nonnull m, const int friendcon_id, const uint8_t *_Nonnull data, const uint16_t data_length, void *_Nullable userdata) { if (data_length > MAX_NAME_LENGTH) { return 0; @@ -1978,7 +1978,7 @@ static int m_handle_packet_nickname(non_null() Messenger *m, const int friendcon return 0; } -static int m_handle_packet_statusmessage(non_null() Messenger *m, const int friendcon_id, non_null() const uint8_t *data, const uint16_t data_length, nullable() void *userdata) +static int m_handle_packet_statusmessage(Messenger *_Nonnull m, const int friendcon_id, const uint8_t *_Nonnull data, const uint16_t data_length, void *_Nullable userdata) { if (data_length > MAX_STATUSMESSAGE_LENGTH) { return 0; @@ -1998,7 +1998,7 @@ static int m_handle_packet_statusmessage(non_null() Messenger *m, const int frie return 0; } -static int m_handle_packet_userstatus(non_null() Messenger *m, const int friendcon_id, non_null() const uint8_t *data, const uint16_t data_length, nullable() void *userdata) +static int m_handle_packet_userstatus(Messenger *_Nonnull m, const int friendcon_id, const uint8_t *_Nonnull data, const uint16_t data_length, void *_Nullable userdata) { if (data_length != 1) { return 0; @@ -2018,7 +2018,7 @@ static int m_handle_packet_userstatus(non_null() Messenger *m, const int friendc return 0; } -static int m_handle_packet_typing(non_null() Messenger *m, const int friendcon_id, non_null() const uint8_t *data, const uint16_t data_length, nullable() void *userdata) +static int m_handle_packet_typing(Messenger *_Nonnull m, const int friendcon_id, const uint8_t *_Nonnull data, const uint16_t data_length, void *_Nullable userdata) { if (data_length != 1) { return 0; @@ -2035,8 +2035,8 @@ static int m_handle_packet_typing(non_null() Messenger *m, const int friendcon_i return 0; } -static int m_handle_packet_message(non_null() Messenger *m, const int friendcon_id, non_null() const uint8_t *data, const uint16_t data_length, const Message_Type message_type, - nullable() void *userdata) +static int m_handle_packet_message(Messenger *_Nonnull m, const int friendcon_id, const uint8_t *_Nonnull data, const uint16_t data_length, const Message_Type message_type, + void *_Nullable userdata) { if (data_length == 0) { return 0; @@ -2057,7 +2057,7 @@ static int m_handle_packet_message(non_null() Messenger *m, const int friendcon_ return 0; } -static int m_handle_packet_invite_conference(non_null() Messenger *m, const int friendcon_id, non_null() const uint8_t *data, const uint16_t data_length, nullable() void *userdata) +static int m_handle_packet_invite_conference(Messenger *_Nonnull m, const int friendcon_id, const uint8_t *_Nonnull data, const uint16_t data_length, void *_Nullable userdata) { if (data_length == 0) { return 0; @@ -2070,7 +2070,7 @@ static int m_handle_packet_invite_conference(non_null() Messenger *m, const int return 0; } -static int m_handle_packet_file_sendrequest(non_null() Messenger *m, const int friendcon_id, non_null() const uint8_t *data, const uint16_t data_length, nullable() void *userdata) +static int m_handle_packet_file_sendrequest(Messenger *_Nonnull m, const int friendcon_id, const uint8_t *_Nonnull data, const uint16_t data_length, void *_Nullable userdata) { const unsigned int head_length = 1 + sizeof(uint32_t) + sizeof(uint64_t) + FILE_ID_LENGTH; if (data_length < head_length) { @@ -2133,7 +2133,7 @@ static int m_handle_packet_file_sendrequest(non_null() Messenger *m, const int f return 0; } -static int m_handle_packet_file_control(non_null() Messenger *m, const int friendcon_id, non_null() const uint8_t *data, const uint16_t data_length, nullable() void *userdata) +static int m_handle_packet_file_control(Messenger *_Nonnull m, const int friendcon_id, const uint8_t *_Nonnull data, const uint16_t data_length, void *_Nullable userdata) { if (data_length < 3) { return 0; @@ -2163,7 +2163,7 @@ static int m_handle_packet_file_control(non_null() Messenger *m, const int frien return 0; } -static int m_handle_packet_file_data(non_null() Messenger *m, const int friendcon_id, non_null() const uint8_t *data, const uint16_t data_length, nullable() void *userdata) +static int m_handle_packet_file_data(Messenger *_Nonnull m, const int friendcon_id, const uint8_t *_Nonnull data, const uint16_t data_length, void *_Nullable userdata) { if (data_length < 1) { return 0; @@ -2228,7 +2228,7 @@ static int m_handle_packet_file_data(non_null() Messenger *m, const int friendco return 0; } -static int m_handle_packet_invite_groupchat(non_null() Messenger *m, const int friendcon_id, non_null() const uint8_t *data, const uint16_t data_length, nullable() void *userdata) +static int m_handle_packet_invite_groupchat(Messenger *_Nonnull m, const int friendcon_id, const uint8_t *_Nonnull data, const uint16_t data_length, void *_Nullable userdata) { // first two bytes are messenger packet type and group invite type if (data_length < 2 + GC_JOIN_DATA_LENGTH) { @@ -2253,7 +2253,7 @@ static int m_handle_packet_invite_groupchat(non_null() Messenger *m, const int f return 0; } -static int m_handle_packet(non_null() void *object, int friendcon_id, non_null() const uint8_t *data, uint16_t length, nullable() void *userdata) +static int m_handle_packet(void *_Nonnull object, int friendcon_id, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata) { Messenger *m = (Messenger *)object; if (length == 0) { @@ -2306,7 +2306,7 @@ static int m_handle_packet(non_null() void *object, int friendcon_id, non_null() return handle_custom_lossless_packet(object, friendcon_id, data, length, userdata); } -static void do_friends(non_null() Messenger *m, nullable() void *userdata) +static void do_friends(Messenger *_Nonnull m, void *_Nullable userdata) { const uint64_t temp_time = mono_time_get(m->mono_time); for (uint32_t i = 0; i < m->numfriends; ++i) { @@ -2363,7 +2363,7 @@ static void do_friends(non_null() Messenger *m, nullable() void *userdata) } } -static void m_connection_status_callback(non_null() Messenger *m, nullable() void *userdata) +static void m_connection_status_callback(Messenger *_Nonnull m, void *_Nullable userdata) { const Onion_Connection_Status conn_status = onion_connection_status(m->onion_c); if (conn_status != m->last_connection_status) { @@ -2379,7 +2379,7 @@ static void m_connection_status_callback(non_null() Messenger *m, nullable() voi #define IDSTRING_LEN (CRYPTO_PUBLIC_KEY_SIZE * 2 + 1) /** id_str should be of length at least IDSTRING_LEN */ -static char *id_to_string(non_null() const uint8_t *pk, non_null() char *id_str, size_t length) +static char *id_to_string(const uint8_t *_Nonnull pk, char *_Nonnull id_str, size_t length) { if (length < IDSTRING_LEN) { snprintf(id_str, length, "Bad buf length"); @@ -2421,7 +2421,7 @@ uint32_t messenger_run_interval(const Messenger *m) * * @retval true if success. */ -static bool self_announce_group(non_null() const Messenger *m, non_null() GC_Chat *chat, non_null() Onion_Friend *onion_friend) +static bool self_announce_group(const Messenger *_Nonnull m, GC_Chat *_Nonnull chat, Onion_Friend *_Nonnull onion_friend) { GC_Public_Announce announce = {{{{{0}}}}}; @@ -2472,7 +2472,7 @@ static bool self_announce_group(non_null() const Messenger *m, non_null() GC_Cha return true; } -static void do_gc_onion_friends(non_null() const Messenger *m) +static void do_gc_onion_friends(const Messenger *_Nonnull m) { const uint16_t num_friends = onion_get_friend_count(m->onion_c); @@ -2694,7 +2694,7 @@ static uint32_t friend_size(void) return data; } -static uint8_t *friend_save(non_null() const struct Saved_Friend *temp, non_null() uint8_t *data) +static uint8_t *friend_save(const struct Saved_Friend *_Nonnull temp, uint8_t *_Nonnull data) { #define VALUE_MEMBER(data, name) \ do { \ @@ -2730,7 +2730,7 @@ static uint8_t *friend_save(non_null() const struct Saved_Friend *temp, non_null return data; } -static const uint8_t *friend_load(non_null() struct Saved_Friend *temp, non_null() const uint8_t *data) +static const uint8_t *friend_load(struct Saved_Friend *_Nonnull temp, const uint8_t *_Nonnull data) { #define VALUE_MEMBER(data, name) \ do { \ @@ -2766,7 +2766,7 @@ static const uint8_t *friend_load(non_null() struct Saved_Friend *temp, non_null return data; } -static uint32_t m_state_plugins_size(non_null() const Messenger *m) +static uint32_t m_state_plugins_size(const Messenger *_Nonnull m) { const uint32_t size32 = sizeof(uint32_t); const uint32_t sizesubhead = size32 * 2; @@ -2811,7 +2811,7 @@ bool m_register_state_plugin(Messenger *m, State_Type type, m_state_size_cb *siz return true; } -static uint32_t m_plugin_size(non_null() const Messenger *m, State_Type type) +static uint32_t m_plugin_size(const Messenger *_Nonnull m, State_Type type) { for (uint8_t i = 0; i < m->options.state_plugins_length; ++i) { const Messenger_State_Plugin plugin = m->options.state_plugins[i]; @@ -2844,12 +2844,12 @@ uint8_t *messenger_save(const Messenger *m, uint8_t *data) } // nospam state plugin -static uint32_t nospam_keys_size(non_null() const Messenger *m) +static uint32_t nospam_keys_size(const Messenger *_Nonnull m) { return sizeof(uint32_t) + CRYPTO_PUBLIC_KEY_SIZE + CRYPTO_SECRET_KEY_SIZE; } -static State_Load_Status load_nospam_keys(non_null() Messenger *m, non_null() const uint8_t *data, uint32_t length) +static State_Load_Status load_nospam_keys(Messenger *_Nonnull m, const uint8_t *_Nonnull data, uint32_t length) { if (length != m_plugin_size(m, STATE_TYPE_NOSPAMKEYS)) { return STATE_LOAD_STATUS_ERROR; @@ -2868,7 +2868,7 @@ static State_Load_Status load_nospam_keys(non_null() Messenger *m, non_null() co return STATE_LOAD_STATUS_CONTINUE; } -static uint8_t *save_nospam_keys(non_null() const Messenger *m, non_null() uint8_t *data) +static uint8_t *save_nospam_keys(const Messenger *_Nonnull m, uint8_t *_Nonnull data) { const uint32_t len = m_plugin_size(m, STATE_TYPE_NOSPAMKEYS); static_assert(sizeof(get_nospam(m->fr)) == sizeof(uint32_t), "nospam doesn't fit in a 32 bit int"); @@ -2881,12 +2881,12 @@ static uint8_t *save_nospam_keys(non_null() const Messenger *m, non_null() uint8 } // DHT state plugin -static uint32_t m_dht_size(non_null() const Messenger *m) +static uint32_t m_dht_size(const Messenger *_Nonnull m) { return dht_size(m->dht); } -static uint8_t *save_dht(non_null() const Messenger *m, non_null() uint8_t *data) +static uint8_t *save_dht(const Messenger *_Nonnull m, uint8_t *_Nonnull data) { const uint32_t len = m_plugin_size(m, STATE_TYPE_DHT); data = state_write_section_header(data, STATE_COOKIE_TYPE, len, STATE_TYPE_DHT); @@ -2895,19 +2895,19 @@ static uint8_t *save_dht(non_null() const Messenger *m, non_null() uint8_t *data return data; } -static State_Load_Status m_dht_load(non_null() Messenger *m, non_null() const uint8_t *data, uint32_t length) +static State_Load_Status m_dht_load(Messenger *_Nonnull m, const uint8_t *_Nonnull data, uint32_t length) { dht_load(m->dht, data, length); // TODO(endoffile78): Should we throw an error if dht_load fails? return STATE_LOAD_STATUS_CONTINUE; } // friendlist state plugin -static uint32_t saved_friendslist_size(non_null() const Messenger *m) +static uint32_t saved_friendslist_size(const Messenger *_Nonnull m) { return count_friendlist(m) * friend_size(); } -static uint8_t *friends_list_save(non_null() const Messenger *m, non_null() uint8_t *data) +static uint8_t *friends_list_save(const Messenger *_Nonnull m, uint8_t *_Nonnull data) { const uint32_t len = m_plugin_size(m, STATE_TYPE_FRIENDS); data = state_write_section_header(data, STATE_COOKIE_TYPE, len, STATE_TYPE_FRIENDS); @@ -2957,7 +2957,7 @@ static uint8_t *friends_list_save(non_null() const Messenger *m, non_null() uint return data; } -static State_Load_Status friends_list_load(non_null() Messenger *m, non_null() const uint8_t *data, uint32_t length) +static State_Load_Status friends_list_load(Messenger *_Nonnull m, const uint8_t *_Nonnull data, uint32_t length) { const uint32_t l_friend_size = friend_size(); @@ -3000,7 +3000,7 @@ static State_Load_Status friends_list_load(non_null() Messenger *m, non_null() c return STATE_LOAD_STATUS_CONTINUE; } -static void pack_groupchats(non_null() const GC_Session *c, non_null() Bin_Pack *bp) +static void pack_groupchats(const GC_Session *_Nonnull c, Bin_Pack *_Nonnull bp) { assert(bp != nullptr && c != nullptr); bin_pack_array(bp, gc_count_groups(c)); @@ -3016,20 +3016,20 @@ static void pack_groupchats(non_null() const GC_Session *c, non_null() Bin_Pack } } -static bool pack_groupchats_handler(non_null() const void *obj, non_null() const Logger *logger, non_null() Bin_Pack *bp) +static bool pack_groupchats_handler(const void *_Nonnull obj, const Logger *_Nonnull logger, Bin_Pack *_Nonnull bp) { const GC_Session *session = (const GC_Session *)obj; pack_groupchats(session, bp); return true; // TODO(iphydf): Return bool from pack functions. } -static uint32_t saved_groups_size(non_null() const Messenger *m) +static uint32_t saved_groups_size(const Messenger *_Nonnull m) { const GC_Session *session = m->group_handler; return bin_pack_obj_size(pack_groupchats_handler, session, m->log); } -static uint8_t *groups_save(non_null() const Messenger *m, non_null() uint8_t *data) +static uint8_t *groups_save(const Messenger *_Nonnull m, uint8_t *_Nonnull data) { const GC_Session *c = m->group_handler; @@ -3059,7 +3059,7 @@ static uint8_t *groups_save(non_null() const Messenger *m, non_null() uint8_t *d return data; } -static bool handle_groups_load(non_null() void *obj, non_null() Bin_Unpack *bu) +static bool handle_groups_load(void *_Nonnull obj, Bin_Unpack *_Nonnull bu) { Messenger *m = (Messenger *)obj; @@ -3086,7 +3086,7 @@ static bool handle_groups_load(non_null() void *obj, non_null() Bin_Unpack *bu) return true; } -static State_Load_Status groups_load(non_null() Messenger *m, non_null() const uint8_t *data, uint32_t length) +static State_Load_Status groups_load(Messenger *_Nonnull m, const uint8_t *_Nonnull data, uint32_t length) { if (!bin_unpack_obj(m->mem, handle_groups_load, m, data, length)) { LOGGER_ERROR(m->log, "msgpack failed to unpack groupchats array"); @@ -3097,12 +3097,12 @@ static State_Load_Status groups_load(non_null() Messenger *m, non_null() const u } // name state plugin -static uint32_t name_size(non_null() const Messenger *m) +static uint32_t name_size(const Messenger *_Nonnull m) { return m->name_length; } -static uint8_t *save_name(non_null() const Messenger *m, non_null() uint8_t *data) +static uint8_t *save_name(const Messenger *_Nonnull m, uint8_t *_Nonnull data) { const uint32_t len = m_plugin_size(m, STATE_TYPE_NAME); data = state_write_section_header(data, STATE_COOKIE_TYPE, len, STATE_TYPE_NAME); @@ -3111,7 +3111,7 @@ static uint8_t *save_name(non_null() const Messenger *m, non_null() uint8_t *dat return data; } -static State_Load_Status load_name(non_null() Messenger *m, non_null() const uint8_t *data, uint32_t length) +static State_Load_Status load_name(Messenger *_Nonnull m, const uint8_t *_Nonnull data, uint32_t length) { if (length > 0 && length <= MAX_NAME_LENGTH) { setname(m, data, length); @@ -3121,12 +3121,12 @@ static State_Load_Status load_name(non_null() Messenger *m, non_null() const uin } // status message state plugin -static uint32_t status_message_size(non_null() const Messenger *m) +static uint32_t status_message_size(const Messenger *_Nonnull m) { return m->statusmessage_length; } -static uint8_t *save_status_message(non_null() const Messenger *m, non_null() uint8_t *data) +static uint8_t *save_status_message(const Messenger *_Nonnull m, uint8_t *_Nonnull data) { const uint32_t len = m_plugin_size(m, STATE_TYPE_STATUSMESSAGE); data = state_write_section_header(data, STATE_COOKIE_TYPE, len, STATE_TYPE_STATUSMESSAGE); @@ -3135,7 +3135,7 @@ static uint8_t *save_status_message(non_null() const Messenger *m, non_null() ui return data; } -static State_Load_Status load_status_message(non_null() Messenger *m, non_null() const uint8_t *data, uint32_t length) +static State_Load_Status load_status_message(Messenger *_Nonnull m, const uint8_t *_Nonnull data, uint32_t length) { if (length > 0 && length <= MAX_STATUSMESSAGE_LENGTH) { m_set_statusmessage(m, data, length); @@ -3145,12 +3145,12 @@ static State_Load_Status load_status_message(non_null() Messenger *m, non_null() } // status state plugin -static uint32_t status_size(non_null() const Messenger *m) +static uint32_t status_size(const Messenger *_Nonnull m) { return 1; } -static uint8_t *save_status(non_null() const Messenger *m, non_null() uint8_t *data) +static uint8_t *save_status(const Messenger *_Nonnull m, uint8_t *_Nonnull data) { const uint32_t len = m_plugin_size(m, STATE_TYPE_STATUS); data = state_write_section_header(data, STATE_COOKIE_TYPE, len, STATE_TYPE_STATUS); @@ -3159,7 +3159,7 @@ static uint8_t *save_status(non_null() const Messenger *m, non_null() uint8_t *d return data; } -static State_Load_Status load_status(non_null() Messenger *m, non_null() const uint8_t *data, uint32_t length) +static State_Load_Status load_status(Messenger *_Nonnull m, const uint8_t *_Nonnull data, uint32_t length) { if (length == 1) { m_set_userstatus(m, *data); @@ -3169,12 +3169,12 @@ static State_Load_Status load_status(non_null() Messenger *m, non_null() const u } // TCP Relay state plugin -static uint32_t tcp_relay_size(non_null() const Messenger *m) +static uint32_t tcp_relay_size(const Messenger *_Nonnull m) { return NUM_SAVED_TCP_RELAYS * packed_node_size(net_family_tcp_ipv6()); } -static uint8_t *save_tcp_relays(non_null() const Messenger *m, non_null() uint8_t *data) +static uint8_t *save_tcp_relays(const Messenger *_Nonnull m, uint8_t *_Nonnull data) { Node_format relays[NUM_SAVED_TCP_RELAYS] = {{{0}}}; uint8_t *temp_data = data; @@ -3198,7 +3198,7 @@ static uint8_t *save_tcp_relays(non_null() const Messenger *m, non_null() uint8_ return data; } -static State_Load_Status load_tcp_relays(non_null() Messenger *m, non_null() const uint8_t *data, uint32_t length) +static State_Load_Status load_tcp_relays(Messenger *_Nonnull m, const uint8_t *_Nonnull data, uint32_t length) { if (length > 0) { const int num = unpack_nodes(m->loaded_relays, NUM_SAVED_TCP_RELAYS, nullptr, data, length, true); @@ -3216,12 +3216,12 @@ static State_Load_Status load_tcp_relays(non_null() Messenger *m, non_null() con } // path node state plugin -static uint32_t path_node_size(non_null() const Messenger *m) +static uint32_t path_node_size(const Messenger *_Nonnull m) { return NUM_SAVED_PATH_NODES * packed_node_size(net_family_tcp_ipv6()); } -static uint8_t *save_path_nodes(non_null() const Messenger *m, non_null() uint8_t *data) +static uint8_t *save_path_nodes(const Messenger *_Nonnull m, uint8_t *_Nonnull data) { Node_format nodes[NUM_SAVED_PATH_NODES] = {{{0}}}; uint8_t *temp_data = data; @@ -3238,7 +3238,7 @@ static uint8_t *save_path_nodes(non_null() const Messenger *m, non_null() uint8_ return data; } -static State_Load_Status load_path_nodes(non_null() Messenger *m, non_null() const uint8_t *data, uint32_t length) +static State_Load_Status load_path_nodes(Messenger *_Nonnull m, const uint8_t *_Nonnull data, uint32_t length) { if (length > 0) { Node_format nodes[NUM_SAVED_PATH_NODES]; @@ -3256,7 +3256,7 @@ static State_Load_Status load_path_nodes(non_null() Messenger *m, non_null() con return STATE_LOAD_STATUS_CONTINUE; } -static void m_register_default_plugins(non_null() Messenger *m) +static void m_register_default_plugins(Messenger *_Nonnull m) { m_register_state_plugin(m, STATE_TYPE_NOSPAMKEYS, nospam_keys_size, load_nospam_keys, save_nospam_keys); m_register_state_plugin(m, STATE_TYPE_DHT, m_dht_size, m_dht_load, save_dht); @@ -3339,7 +3339,7 @@ uint32_t copy_friendlist(Messenger const *m, uint32_t *out_list, uint32_t list_s static fr_friend_request_cb m_handle_friend_request; static void m_handle_friend_request( - non_null() void *object, non_null() const uint8_t *public_key, non_null() const uint8_t *message, size_t length, nullable() void *user_data) + void *_Nonnull object, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull message, size_t length, void *_Nullable user_data) { Messenger *m = (Messenger *)object; assert(m != nullptr); diff --git a/toxcore/Messenger.h b/toxcore/Messenger.h index 20781848c..b45c1dd33 100644 --- a/toxcore/Messenger.h +++ b/toxcore/Messenger.h @@ -54,19 +54,19 @@ typedef struct Messenger Messenger; #endif /* MESSENGER_DEFINED */ // Returns the size of the data -typedef uint32_t m_state_size_cb(const Messenger *m); +typedef uint32_t m_state_size_cb(const Messenger *_Nonnull m); // Returns the new pointer to data -typedef uint8_t *m_state_save_cb(const Messenger *m, uint8_t *data); +typedef uint8_t *m_state_save_cb(const Messenger *_Nonnull m, uint8_t *_Nonnull data); // Returns if there were any erros during loading -typedef State_Load_Status m_state_load_cb(Messenger *m, const uint8_t *data, uint32_t length); +typedef State_Load_Status m_state_load_cb(Messenger *_Nonnull m, const uint8_t *_Nonnull data, uint32_t length); typedef struct Messenger_State_Plugin { State_Type type; - m_state_size_cb *size; - m_state_save_cb *save; - m_state_load_cb *load; + m_state_size_cb *_Nullable size; + m_state_save_cb *_Nullable save; + m_state_load_cb *_Nullable load; } Messenger_State_Plugin; typedef struct Messenger_Options { @@ -81,11 +81,11 @@ typedef struct Messenger_Options { bool dht_announcements_enabled; bool groups_persistence_enabled; - logger_cb *log_callback; - void *log_context; - void *log_user_data; + logger_cb *_Nullable log_callback; + void *_Nullable log_context; + void *_Nullable log_user_data; - Messenger_State_Plugin *state_plugins; + Messenger_State_Plugin *_Nullable state_plugins; uint8_t state_plugins_length; bool dns_enabled; @@ -94,7 +94,7 @@ typedef struct Messenger_Options { struct Receipts { uint32_t packet_num; uint32_t msg_id; - struct Receipts *next; + struct Receipts *_Nullable next; }; /** Status definitions. */ @@ -177,36 +177,36 @@ typedef enum Filekind { FILEKIND_AVATAR, } Filekind; -typedef void m_self_connection_status_cb(Messenger *m, Onion_Connection_Status connection_status, void *user_data); -typedef void m_friend_status_cb(Messenger *m, uint32_t friend_number, unsigned int status, void *user_data); -typedef void m_friend_connection_status_cb(Messenger *m, uint32_t friend_number, unsigned int connection_status, - void *user_data); -typedef void m_friend_message_cb(Messenger *m, uint32_t friend_number, unsigned int message_type, - const uint8_t *message, size_t length, void *user_data); -typedef void m_file_recv_control_cb(Messenger *m, uint32_t friend_number, uint32_t file_number, unsigned int control, - void *user_data); -typedef void m_friend_request_cb(Messenger *m, const uint8_t *public_key, const uint8_t *message, size_t length, - void *user_data); -typedef void m_friend_name_cb(Messenger *m, uint32_t friend_number, const uint8_t *name, size_t length, - void *user_data); -typedef void m_friend_status_message_cb(Messenger *m, uint32_t friend_number, const uint8_t *message, size_t length, - void *user_data); -typedef void m_friend_typing_cb(Messenger *m, uint32_t friend_number, bool is_typing, void *user_data); -typedef void m_friend_read_receipt_cb(Messenger *m, uint32_t friend_number, uint32_t message_id, void *user_data); -typedef void m_file_recv_cb(Messenger *m, uint32_t friend_number, uint32_t file_number, uint32_t kind, - uint64_t file_size, const uint8_t *filename, size_t filename_length, void *user_data); -typedef void m_file_chunk_request_cb(Messenger *m, uint32_t friend_number, uint32_t file_number, uint64_t position, - size_t length, void *user_data); -typedef void m_file_recv_chunk_cb(Messenger *m, uint32_t friend_number, uint32_t file_number, uint64_t position, - const uint8_t *data, size_t length, void *user_data); -typedef void m_friend_lossy_packet_cb(Messenger *m, uint32_t friend_number, uint8_t packet_id, const uint8_t *data, - size_t length, void *user_data); -typedef void m_friend_lossless_packet_cb(Messenger *m, uint32_t friend_number, uint8_t packet_id, const uint8_t *data, - size_t length, void *user_data); -typedef void m_conference_invite_cb(Messenger *m, uint32_t friend_number, const uint8_t *cookie, uint16_t length, - void *user_data); -typedef void m_group_invite_cb(const Messenger *m, uint32_t friend_number, const uint8_t *invite_data, size_t length, - const uint8_t *group_name, size_t group_name_length, void *user_data); +typedef void m_self_connection_status_cb(Messenger *_Nonnull m, Onion_Connection_Status connection_status, void *_Nullable user_data); +typedef void m_friend_status_cb(Messenger *_Nonnull m, uint32_t friend_number, unsigned int status, void *_Nullable user_data); +typedef void m_friend_connection_status_cb(Messenger *_Nonnull m, uint32_t friend_number, unsigned int connection_status, + void *_Nullable user_data); +typedef void m_friend_message_cb(Messenger *_Nonnull m, uint32_t friend_number, unsigned int message_type, + const uint8_t *_Nonnull message, size_t length, void *_Nullable user_data); +typedef void m_file_recv_control_cb(Messenger *_Nonnull m, uint32_t friend_number, uint32_t file_number, unsigned int control, + void *_Nullable user_data); +typedef void m_friend_request_cb(Messenger *_Nonnull m, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull message, size_t length, + void *_Nullable user_data); +typedef void m_friend_name_cb(Messenger *_Nonnull m, uint32_t friend_number, const uint8_t *_Nonnull name, size_t length, + void *_Nullable user_data); +typedef void m_friend_status_message_cb(Messenger *_Nonnull m, uint32_t friend_number, const uint8_t *_Nonnull message, size_t length, + void *_Nullable user_data); +typedef void m_friend_typing_cb(Messenger *_Nonnull m, uint32_t friend_number, bool is_typing, void *_Nullable user_data); +typedef void m_friend_read_receipt_cb(Messenger *_Nonnull m, uint32_t friend_number, uint32_t message_id, void *_Nullable user_data); +typedef void m_file_recv_cb(Messenger *_Nonnull m, uint32_t friend_number, uint32_t file_number, uint32_t kind, + uint64_t file_size, const uint8_t *_Nonnull filename, size_t filename_length, void *_Nullable user_data); +typedef void m_file_chunk_request_cb(Messenger *_Nonnull m, uint32_t friend_number, uint32_t file_number, uint64_t position, + size_t length, void *_Nullable user_data); +typedef void m_file_recv_chunk_cb(Messenger *_Nonnull m, uint32_t friend_number, uint32_t file_number, uint64_t position, + const uint8_t *_Nullable data, size_t length, void *_Nullable user_data); +typedef void m_friend_lossy_packet_cb(Messenger *_Nonnull m, uint32_t friend_number, uint8_t packet_id, const uint8_t *_Nonnull data, + size_t length, void *_Nullable user_data); +typedef void m_friend_lossless_packet_cb(Messenger *_Nonnull m, uint32_t friend_number, uint8_t packet_id, const uint8_t *_Nonnull data, + size_t length, void *_Nullable user_data); +typedef void m_conference_invite_cb(Messenger *_Nonnull m, uint32_t friend_number, const uint8_t *_Nonnull cookie, uint16_t length, + void *_Nullable user_data); +typedef void m_group_invite_cb(const Messenger *_Nonnull m, uint32_t friend_number, const uint8_t *_Nonnull invite_data, size_t length, + const uint8_t *_Nullable group_name, size_t group_name_length, void *_Nullable user_data); typedef struct Friend { uint8_t real_pk[CRYPTO_PUBLIC_KEY_SIZE]; @@ -236,33 +236,33 @@ typedef struct Friend { uint32_t num_sending_files; struct File_Transfers file_receiving[MAX_CONCURRENT_FILE_PIPES]; - struct Receipts *receipts_start; - struct Receipts *receipts_end; + struct Receipts *_Nullable receipts_start; + struct Receipts *_Nullable receipts_end; } Friend; struct Messenger { - Logger *log; - Mono_Time *mono_time; - const Memory *mem; - const Random *rng; - const Network *ns; + Logger *_Nullable log; + Mono_Time *_Nullable mono_time; + const Memory *_Nullable mem; + const Random *_Nullable rng; + const Network *_Nullable ns; - Networking_Core *net; - Net_Crypto *net_crypto; - Net_Profile *tcp_np; - DHT *dht; + Networking_Core *_Nonnull net; + Net_Crypto *_Nonnull net_crypto; + Net_Profile *_Nullable tcp_np; + DHT *_Nonnull dht; - Forwarding *forwarding; - Announcements *announce; + Forwarding *_Nullable forwarding; + Announcements *_Nullable announce; - Onion *onion; - Onion_Announce *onion_a; - Onion_Client *onion_c; + Onion *_Nullable onion; + Onion_Announce *_Nullable onion_a; + Onion_Client *_Nullable onion_c; - Friend_Connections *fr_c; + Friend_Connections *_Nullable fr_c; - TCP_Server *tcp_server; - Friend_Requests *fr; + TCP_Server *_Nullable tcp_server; + Friend_Requests *_Nullable fr; uint8_t name[MAX_NAME_LENGTH]; uint16_t name_length; @@ -271,43 +271,43 @@ struct Messenger { Userstatus userstatus; - Friend *friendlist; + Friend *_Nullable friendlist; uint32_t numfriends; uint64_t lastdump; uint8_t is_receiving_file; - GC_Session *group_handler; - GC_Announces_List *group_announce; + GC_Session *_Nonnull group_handler; + GC_Announces_List *_Nonnull group_announce; bool has_added_relays; // If the first connection has occurred in do_messenger uint16_t num_loaded_relays; Node_format loaded_relays[NUM_SAVED_TCP_RELAYS]; // Relays loaded from config - m_friend_request_cb *friend_request; - m_friend_message_cb *friend_message; - m_friend_name_cb *friend_namechange; - m_friend_status_message_cb *friend_statusmessagechange; - m_friend_status_cb *friend_userstatuschange; - m_friend_typing_cb *friend_typingchange; - m_friend_read_receipt_cb *read_receipt; - m_friend_connection_status_cb *friend_connectionstatuschange; + m_friend_request_cb *_Nullable friend_request; + m_friend_message_cb *_Nullable friend_message; + m_friend_name_cb *_Nullable friend_namechange; + m_friend_status_message_cb *_Nullable friend_statusmessagechange; + m_friend_status_cb *_Nullable friend_userstatuschange; + m_friend_typing_cb *_Nullable friend_typingchange; + m_friend_read_receipt_cb *_Nullable read_receipt; + m_friend_connection_status_cb *_Nullable friend_connectionstatuschange; - struct Group_Chats *conferences_object; - m_conference_invite_cb *conference_invite; + struct Group_Chats *_Nullable conferences_object; + m_conference_invite_cb *_Nullable conference_invite; - m_group_invite_cb *group_invite; + m_group_invite_cb *_Nullable group_invite; - m_file_recv_cb *file_sendrequest; - m_file_recv_control_cb *file_filecontrol; - m_file_recv_chunk_cb *file_filedata; - m_file_chunk_request_cb *file_reqchunk; + m_file_recv_cb *_Nullable file_sendrequest; + m_file_recv_control_cb *_Nullable file_filecontrol; + m_file_recv_chunk_cb *_Nullable file_filedata; + m_file_chunk_request_cb *_Nullable file_reqchunk; - m_friend_lossy_packet_cb *lossy_packethandler; - m_friend_lossless_packet_cb *lossless_packethandler; + m_friend_lossy_packet_cb *_Nullable lossy_packethandler; + m_friend_lossless_packet_cb *_Nullable lossless_packethandler; - m_self_connection_status_cb *core_connection_change; + m_self_connection_status_cb *_Nullable core_connection_change; Onion_Connection_Status last_connection_status; Messenger_Options options; @@ -318,14 +318,14 @@ struct Messenger { * * @param friendnumber The index in the friend list. */ -bool friend_is_valid(non_null() const Messenger *m, int32_t friendnumber); +bool friend_is_valid(const Messenger *_Nonnull m, int32_t friendnumber); /** * Format: `[real_pk (32 bytes)][nospam number (4 bytes)][checksum (2 bytes)]` * * @param[out] address FRIEND_ADDRESS_SIZE byte address to give to others. */ -void getaddress(non_null() const Messenger *m, non_null() uint8_t *address); +void getaddress(const Messenger *_Nonnull m, uint8_t *_Nonnull address); /** * Add a friend. @@ -348,7 +348,7 @@ void getaddress(non_null() const Messenger *m, non_null() uint8_t *address); * (the nospam for that friend was set to the new one). * @retval FAERR_NOMEM if increasing the friend list size fails. */ -int32_t m_addfriend(non_null() Messenger *m, non_null() const uint8_t *address, non_null() const uint8_t *data, uint16_t length); +int32_t m_addfriend(Messenger *_Nonnull m, const uint8_t *_Nonnull address, const uint8_t *_Nonnull data, uint16_t length); /** @brief Add a friend without sending a friendrequest. * @return the friend number if success. @@ -357,23 +357,23 @@ int32_t m_addfriend(non_null() Messenger *m, non_null() const uint8_t *address, * @retval -6 if bad checksum in address. * @retval -8 if increasing the friend list size fails. */ -int32_t m_addfriend_norequest(non_null() Messenger *m, non_null() const uint8_t *real_pk); +int32_t m_addfriend_norequest(Messenger *_Nonnull m, const uint8_t *_Nonnull real_pk); /** @brief Initializes the friend connection and onion connection for a groupchat. * * @retval true on success. */ -bool m_create_group_connection(non_null() Messenger *m, non_null() GC_Chat *chat); +bool m_create_group_connection(Messenger *_Nonnull m, GC_Chat *_Nonnull chat); /* * Kills the friend connection for a groupchat. */ -void m_kill_group_connection(non_null() Messenger *m, non_null() const GC_Chat *chat); +void m_kill_group_connection(Messenger *_Nonnull m, const GC_Chat *_Nonnull chat); /** @return the friend number associated to that public key. * @retval -1 if no such friend. */ -int32_t getfriend_id(non_null() const Messenger *m, non_null() const uint8_t *real_pk); +int32_t getfriend_id(const Messenger *_Nonnull m, const uint8_t *_Nonnull real_pk); /** @brief Copies the public key associated to that friend id into real_pk buffer. * @@ -382,19 +382,19 @@ int32_t getfriend_id(non_null() const Messenger *m, non_null() const uint8_t *re * @retval 0 if success. * @retval -1 if failure. */ -int get_real_pk(non_null() const Messenger *m, int32_t friendnumber, non_null() uint8_t *real_pk); +int get_real_pk(const Messenger *_Nonnull m, int32_t friendnumber, uint8_t *_Nonnull real_pk); /** @return friend connection id on success. * @retval -1 if failure. */ -int getfriendcon_id(non_null() const Messenger *m, int32_t friendnumber); +int getfriendcon_id(const Messenger *_Nonnull m, int32_t friendnumber); /** @brief Remove a friend. * * @retval 0 if success. * @retval -1 if failure. */ -int m_delfriend(non_null() Messenger *m, int32_t friendnumber); +int m_delfriend(Messenger *_Nonnull m, int32_t friendnumber); /** @brief Checks friend's connection status. * @@ -403,7 +403,7 @@ int m_delfriend(non_null() Messenger *m, int32_t friendnumber); * @retval CONNECTION_NONE (0) if friend is not connected to us (Offline). * @retval -1 on failure. */ -int m_get_friend_connectionstatus(non_null() const Messenger *m, int32_t friendnumber); +int m_get_friend_connectionstatus(const Messenger *_Nonnull m, int32_t friendnumber); /** * Checks if there exists a friend with given friendnumber. @@ -413,7 +413,7 @@ int m_get_friend_connectionstatus(non_null() const Messenger *m, int32_t friendn * @retval true if friend exists. * @retval false if friend doesn't exist. */ -bool m_friend_exists(non_null() const Messenger *m, int32_t friendnumber); +bool m_friend_exists(const Messenger *_Nonnull m, int32_t friendnumber); /** @brief Send a message of type to an online friend. * @@ -426,8 +426,8 @@ bool m_friend_exists(non_null() const Messenger *m, int32_t friendnumber); * * The value in message_id will be passed to your read_receipt callback when the other receives the message. */ -int m_send_message_generic(non_null() Messenger *m, int32_t friendnumber, uint8_t type, non_null() const uint8_t *message, uint32_t length, - nullable() uint32_t *message_id); +int m_send_message_generic(Messenger *_Nonnull m, int32_t friendnumber, uint8_t type, const uint8_t *_Nonnull message, uint32_t length, + uint32_t *_Nullable message_id); /** @brief Set the name and name_length of a friend. * * name must be a string of maximum MAX_NAME_LENGTH length. @@ -437,7 +437,7 @@ int m_send_message_generic(non_null() Messenger *m, int32_t friendnumber, uint8_ * @retval 0 if success. * @retval -1 if failure. */ -int setfriendname(non_null() Messenger *m, int32_t friendnumber, non_null() const uint8_t *name, uint16_t length); +int setfriendname(Messenger *_Nonnull m, int32_t friendnumber, const uint8_t *_Nonnull name, uint16_t length); /** @brief Set our nickname. * @@ -448,7 +448,7 @@ int setfriendname(non_null() Messenger *m, int32_t friendnumber, non_null() cons * @retval 0 if success. * @retval -1 if failure. */ -int setname(non_null() Messenger *m, non_null() const uint8_t *name, uint16_t length); +int setname(Messenger *_Nonnull m, const uint8_t *_Nonnull name, uint16_t length); /** * @brief Get your nickname. @@ -459,7 +459,7 @@ int setname(non_null() Messenger *m, non_null() const uint8_t *name, uint16_t le * @return length of the name. * @retval 0 on error. */ -uint16_t getself_name(non_null() const Messenger *m, non_null() uint8_t *name); +uint16_t getself_name(const Messenger *_Nonnull m, uint8_t *_Nonnull name); /** @brief Get name of friendnumber and put it in name. * @@ -468,22 +468,22 @@ uint16_t getself_name(non_null() const Messenger *m, non_null() uint8_t *name); * @return length of name if success. * @retval -1 if failure. */ -int getname(non_null() const Messenger *m, int32_t friendnumber, non_null() uint8_t *name); +int getname(const Messenger *_Nonnull m, int32_t friendnumber, uint8_t *_Nonnull name); /** @return the length of name, including null on success. * @retval -1 on failure. */ -int m_get_name_size(non_null() const Messenger *m, int32_t friendnumber); -int m_get_self_name_size(non_null() const Messenger *m); +int m_get_name_size(const Messenger *_Nonnull m, int32_t friendnumber); +int m_get_self_name_size(const Messenger *_Nonnull m); /** @brief Set our user status. * You are responsible for freeing status after. * - * @retval 0 on success. - * @retval -1 on failure. + * @retval 0 if success. + * @retval -1 if failure. */ -int m_set_statusmessage(non_null() Messenger *m, non_null() const uint8_t *status, uint16_t length); -int m_set_userstatus(non_null() Messenger *m, uint8_t status); +int m_set_statusmessage(Messenger *_Nonnull m, const uint8_t *_Nonnull status, uint16_t length); +int m_set_userstatus(Messenger *_Nonnull m, uint8_t status); /** * Guaranteed to be at most MAX_STATUSMESSAGE_LENGTH. @@ -491,8 +491,8 @@ int m_set_userstatus(non_null() Messenger *m, uint8_t status); * @return the length of friendnumber's status message, including null on success. * @retval -1 on failure. */ -int m_get_statusmessage_size(non_null() const Messenger *m, int32_t friendnumber); -int m_get_self_statusmessage_size(non_null() const Messenger *m); +int m_get_statusmessage_size(const Messenger *_Nonnull m, int32_t friendnumber); +int m_get_self_statusmessage_size(const Messenger *_Nonnull m); /** @brief Copy friendnumber's status message into buf, truncating if size is over maxlen. * @@ -502,8 +502,8 @@ int m_get_self_statusmessage_size(non_null() const Messenger *m); * @return the length of the copied data on success * @retval -1 on failure. */ -int m_copy_statusmessage(non_null() const Messenger *m, int32_t friendnumber, non_null() uint8_t *buf, uint32_t maxlen); -int m_copy_self_statusmessage(non_null() const Messenger *m, non_null() uint8_t *buf); +int m_copy_statusmessage(const Messenger *_Nonnull m, int32_t friendnumber, uint8_t *_Nonnull buf, uint32_t maxlen); +int m_copy_self_statusmessage(const Messenger *_Nonnull m, uint8_t *_Nonnull buf); /** @brief return one of Userstatus values. * @@ -511,13 +511,13 @@ int m_copy_self_statusmessage(non_null() const Messenger *m, non_null() uint8_t * As above, the self variant will return our own Userstatus. * If friendnumber is invalid, this shall return USERSTATUS_INVALID. */ -uint8_t m_get_userstatus(non_null() const Messenger *m, int32_t friendnumber); -uint8_t m_get_self_userstatus(non_null() const Messenger *m); +uint8_t m_get_userstatus(const Messenger *_Nonnull m, int32_t friendnumber); +uint8_t m_get_self_userstatus(const Messenger *_Nonnull m); /** @brief returns timestamp of last time friendnumber was seen online or 0 if never seen. * if friendnumber is invalid this function will return UINT64_MAX. */ -uint64_t m_get_last_online(non_null() const Messenger *m, int32_t friendnumber); +uint64_t m_get_last_online(const Messenger *_Nonnull m, int32_t friendnumber); /** @brief Set our typing status for a friend. * You are responsible for turning it on or off. @@ -525,7 +525,7 @@ uint64_t m_get_last_online(non_null() const Messenger *m, int32_t friendnumber); * @retval 0 on success. * @retval -1 on failure. */ -int m_set_usertyping(non_null() Messenger *m, int32_t friendnumber, bool is_typing); +int m_set_usertyping(Messenger *_Nonnull m, int32_t friendnumber, bool is_typing); /** @brief Get the typing status of a friend. * @@ -533,29 +533,29 @@ int m_set_usertyping(non_null() Messenger *m, int32_t friendnumber, bool is_typi * @retval 0 if friend is not typing. * @retval 1 if friend is typing. */ -int m_get_istyping(non_null() const Messenger *m, int32_t friendnumber); +int m_get_istyping(const Messenger *_Nonnull m, int32_t friendnumber); /** Set the function that will be executed when a friend request is received. */ -void m_callback_friendrequest(non_null() Messenger *m, nullable() m_friend_request_cb *function); +void m_callback_friendrequest(Messenger *_Nonnull m, m_friend_request_cb *_Nullable function); /** Set the function that will be executed when a message from a friend is received. */ -void m_callback_friendmessage(non_null() Messenger *m, non_null() m_friend_message_cb *function); +void m_callback_friendmessage(Messenger *_Nonnull m, m_friend_message_cb *_Nonnull function); /** @brief Set the callback for name changes. * You are not responsible for freeing newname. */ -void m_callback_namechange(non_null() Messenger *m, non_null() m_friend_name_cb *function); +void m_callback_namechange(Messenger *_Nonnull m, m_friend_name_cb *_Nonnull function); /** @brief Set the callback for status message changes. * * You are not responsible for freeing newstatus */ -void m_callback_statusmessage(non_null() Messenger *m, non_null() m_friend_status_message_cb *function); +void m_callback_statusmessage(Messenger *_Nonnull m, m_friend_status_message_cb *_Nonnull function); /** @brief Set the callback for status type changes. */ -void m_callback_userstatus(non_null() Messenger *m, non_null() m_friend_status_cb *function); +void m_callback_userstatus(Messenger *_Nonnull m, m_friend_status_cb *_Nonnull function); /** @brief Set the callback for typing changes. */ -void m_callback_typingchange(non_null() Messenger *m, non_null() m_friend_typing_cb *function); +void m_callback_typingchange(Messenger *_Nonnull m, m_friend_typing_cb *_Nonnull function); /** @brief Set the callback for read receipts. * @@ -565,7 +565,7 @@ void m_callback_typingchange(non_null() Messenger *m, non_null() m_friend_typing * Since core doesn't track ids for you, receipt may not correspond to any message. * In that case, you should discard it. */ -void m_callback_read_receipt(non_null() Messenger *m, non_null() m_friend_read_receipt_cb *function); +void m_callback_read_receipt(Messenger *_Nonnull m, m_friend_read_receipt_cb *_Nonnull function); /** @brief Set the callback for connection status changes. * @@ -577,24 +577,24 @@ void m_callback_read_receipt(non_null() Messenger *m, non_null() m_friend_read_r * "after being previously online" part. * It's assumed that when adding friends, their connection status is offline. */ -void m_callback_connectionstatus(non_null() Messenger *m, non_null() m_friend_connection_status_cb *function); +void m_callback_connectionstatus(Messenger *_Nonnull m, m_friend_connection_status_cb *_Nonnull function); /** @brief Set the callback for typing changes. */ -void m_callback_core_connection(non_null() Messenger *m, non_null() m_self_connection_status_cb *function); +void m_callback_core_connection(Messenger *_Nonnull m, m_self_connection_status_cb *_Nonnull function); /*** CONFERENCES */ /** @brief Set the callback for conference invites. */ -void m_callback_conference_invite(non_null() Messenger *m, nullable() m_conference_invite_cb *function); +void m_callback_conference_invite(Messenger *_Nonnull m, m_conference_invite_cb *_Nullable function); /* Set the callback for group invites. */ -void m_callback_group_invite(non_null() Messenger *m, nullable() m_group_invite_cb *function); +void m_callback_group_invite(Messenger *_Nonnull m, m_group_invite_cb *_Nullable function); /** @brief Send a conference invite packet. * * return true on success * return false on failure */ -bool send_conference_invite_packet(non_null() const Messenger *m, int32_t friendnumber, non_null() const uint8_t *data, uint16_t length); +bool send_conference_invite_packet(const Messenger *_Nonnull m, int32_t friendnumber, const uint8_t *_Nonnull data, uint16_t length); /* Send a group invite packet. * @@ -603,21 +603,21 @@ bool send_conference_invite_packet(non_null() const Messenger *m, int32_t friend * * return true on success */ -bool send_group_invite_packet(non_null() const Messenger *m, uint32_t friendnumber, non_null() const uint8_t *packet, uint16_t length); +bool send_group_invite_packet(const Messenger *_Nonnull m, uint32_t friendnumber, const uint8_t *_Nonnull packet, uint16_t length); /*** FILE SENDING */ /** @brief Set the callback for file send requests. */ -void callback_file_sendrequest(non_null() Messenger *m, non_null() m_file_recv_cb *function); +void callback_file_sendrequest(Messenger *_Nonnull m, m_file_recv_cb *_Nonnull function); /** @brief Set the callback for file control requests. */ -void callback_file_control(non_null() Messenger *m, non_null() m_file_recv_control_cb *function); +void callback_file_control(Messenger *_Nonnull m, m_file_recv_control_cb *_Nonnull function); /** @brief Set the callback for file data. */ -void callback_file_data(non_null() Messenger *m, non_null() m_file_recv_chunk_cb *function); +void callback_file_data(Messenger *_Nonnull m, m_file_recv_chunk_cb *_Nonnull function); /** @brief Set the callback for file request chunk. */ -void callback_file_reqchunk(non_null() Messenger *m, non_null() m_file_chunk_request_cb *function); +void callback_file_reqchunk(Messenger *_Nonnull m, m_file_chunk_request_cb *_Nonnull function); /** @brief Copy the file transfer file id to file_id * @@ -625,7 +625,7 @@ void callback_file_reqchunk(non_null() Messenger *m, non_null() m_file_chunk_req * @retval -1 if friend not valid. * @retval -2 if filenumber not valid */ -int file_get_id(non_null() const Messenger *m, int32_t friendnumber, uint32_t filenumber, non_null() uint8_t *file_id); +int file_get_id(const Messenger *_Nonnull m, int32_t friendnumber, uint32_t filenumber, uint8_t *_Nonnull file_id); /** @brief Send a file send request. * @@ -637,7 +637,7 @@ int file_get_id(non_null() const Messenger *m, int32_t friendnumber, uint32_t fi * @retval -3 if no more file sending slots left. * @retval -4 if could not send packet (friend offline). */ -long int new_filesender(non_null() const Messenger *m, int32_t friendnumber, uint32_t file_type, uint64_t filesize, non_null() const uint8_t *file_id, non_null() const uint8_t *filename, +long int new_filesender(const Messenger *_Nonnull m, int32_t friendnumber, uint32_t file_type, uint64_t filesize, const uint8_t *_Nonnull file_id, const uint8_t *_Nonnull filename, uint16_t filename_length); /** @brief Send a file control request. @@ -652,7 +652,7 @@ long int new_filesender(non_null() const Messenger *m, int32_t friendnumber, uin * @retval -7 if resume file failed because it wasn't paused. * @retval -8 if packet failed to send. */ -int file_control(non_null() const Messenger *m, int32_t friendnumber, uint32_t filenumber, unsigned int control); +int file_control(const Messenger *_Nonnull m, int32_t friendnumber, uint32_t filenumber, unsigned int control); /** @brief Send a seek file control request. * @@ -665,7 +665,7 @@ int file_control(non_null() const Messenger *m, int32_t friendnumber, uint32_t f * @retval -6 if position bad. * @retval -8 if packet failed to send. */ -int file_seek(non_null() const Messenger *m, int32_t friendnumber, uint32_t filenumber, uint64_t position); +int file_seek(const Messenger *_Nonnull m, int32_t friendnumber, uint32_t filenumber, uint64_t position); /** @brief Send file data. * @@ -678,12 +678,12 @@ int file_seek(non_null() const Messenger *m, int32_t friendnumber, uint32_t file * @retval -6 if packet queue full. * @retval -7 if wrong position. */ -int send_file_data(non_null() const Messenger *m, int32_t friendnumber, uint32_t filenumber, uint64_t position, - nullable() const uint8_t *data, uint16_t length); +int send_file_data(const Messenger *_Nonnull m, int32_t friendnumber, uint32_t filenumber, uint64_t position, + const uint8_t *_Nullable data, uint16_t length); /*** CUSTOM PACKETS */ /** @brief Set handlers for custom lossy packets. */ -void custom_lossy_packet_registerhandler(non_null() Messenger *m, non_null() m_friend_lossy_packet_cb *lossy_packethandler); +void custom_lossy_packet_registerhandler(Messenger *_Nonnull m, m_friend_lossy_packet_cb *_Nonnull lossy_packethandler); /** @brief High level function to send custom lossy packets. * @@ -694,10 +694,10 @@ void custom_lossy_packet_registerhandler(non_null() Messenger *m, non_null() m_f * @retval -5 if packet failed to send because of other error. * @retval 0 on success. */ -int m_send_custom_lossy_packet(non_null() const Messenger *m, int32_t friendnumber, non_null() const uint8_t *data, uint32_t length); +int m_send_custom_lossy_packet(const Messenger *_Nonnull m, int32_t friendnumber, const uint8_t *_Nonnull data, uint32_t length); /** @brief Set handlers for custom lossless packets. */ -void custom_lossless_packet_registerhandler(non_null() Messenger *m, non_null() m_friend_lossless_packet_cb *lossless_packethandler); +void custom_lossless_packet_registerhandler(Messenger *_Nonnull m, m_friend_lossless_packet_cb *_Nonnull lossless_packethandler); /** @brief High level function to send custom lossless packets. * @@ -708,7 +708,7 @@ void custom_lossless_packet_registerhandler(non_null() Messenger *m, non_null() * @retval -5 if packet failed to send because of other error. * @retval 0 on success. */ -int send_custom_lossless_packet(non_null() const Messenger *m, int32_t friendnumber, non_null() const uint8_t *data, uint32_t length); +int send_custom_lossless_packet(const Messenger *_Nonnull m, int32_t friendnumber, const uint8_t *_Nonnull data, uint32_t length); /*** Messenger constructor/destructor/operations. */ @@ -726,23 +726,23 @@ typedef enum Messenger_Error { * * if error is not NULL it will be set to one of the values in the enum above. */ -Messenger *new_messenger(non_null() Mono_Time *mono_time, non_null() const Memory *mem, non_null() const Random *rng, non_null() const Network *ns, non_null() Messenger_Options *options, - non_null() Messenger_Error *error); +Messenger *_Nullable new_messenger(Mono_Time *_Nonnull mono_time, const Memory *_Nonnull mem, const Random *_Nonnull rng, const Network *_Nonnull ns, Messenger_Options *_Nonnull options, + Messenger_Error *_Nonnull error); /** @brief Run this before closing shop. * * Free all datastructures. */ -void kill_messenger(nullable() Messenger *m); +void kill_messenger(Messenger *_Nullable m); /** @brief The main loop that needs to be run at least 20 times per second. */ -void do_messenger(non_null() Messenger *m, nullable() void *userdata); +void do_messenger(Messenger *_Nonnull m, void *_Nullable userdata); /** * @brief Return the time in milliseconds before `do_messenger()` should be called again * for optimal performance. * * @return time (in ms) before the next `do_messenger()` needs to be run on success. */ -uint32_t messenger_run_interval(non_null() const Messenger *m); +uint32_t messenger_run_interval(const Messenger *_Nonnull m); /* SAVING AND LOADING FUNCTIONS: */ @@ -751,13 +751,13 @@ uint32_t messenger_run_interval(non_null() const Messenger *m); * @retval true on success * @retval false on error */ -bool m_register_state_plugin(non_null() Messenger *m, State_Type type, non_null() m_state_size_cb *size_callback, non_null() m_state_load_cb *load_callback, non_null() m_state_save_cb *save_callback); +bool m_register_state_plugin(Messenger *_Nonnull m, State_Type type, m_state_size_cb *_Nonnull size_callback, m_state_load_cb *_Nonnull load_callback, m_state_save_cb *_Nonnull save_callback); /** return size of the messenger data (for saving). */ -uint32_t messenger_size(non_null() const Messenger *m); +uint32_t messenger_size(const Messenger *_Nonnull m); /** Save the messenger in data (must be allocated memory of size at least `Messenger_size()`) */ -uint8_t *messenger_save(non_null() const Messenger *m, non_null() uint8_t *data); +uint8_t *_Nonnull messenger_save(const Messenger *_Nonnull m, uint8_t *_Nonnull data); /** @brief Load a state section. * @@ -767,14 +767,14 @@ uint8_t *messenger_save(non_null() const Messenger *m, non_null() uint8_t *data) * @param status Result of loading section is stored here if the section is handled. * @return true iff section handled. */ -bool messenger_load_state_section(non_null() Messenger *m, non_null() const uint8_t *data, uint32_t length, uint16_t type, non_null() State_Load_Status *status); +bool messenger_load_state_section(Messenger *_Nonnull m, const uint8_t *_Nonnull data, uint32_t length, uint16_t type, State_Load_Status *_Nonnull status); /** @brief Return the number of friends in the instance m. * * You should use this to determine how much memory to allocate * for copy_friendlist. */ -uint32_t count_friendlist(non_null() const Messenger *m); +uint32_t count_friendlist(const Messenger *_Nonnull m); /** @brief Copy a list of valid friend IDs into the array out_list. * If out_list is NULL, returns 0. @@ -782,8 +782,8 @@ uint32_t count_friendlist(non_null() const Messenger *m); * If the array was too small, the contents * of out_list will be truncated to list_size. */ -uint32_t copy_friendlist(non_null() const Messenger *m, non_null() uint32_t *out_list, uint32_t list_size); +uint32_t copy_friendlist(const Messenger *_Nonnull m, uint32_t *_Nonnull out_list, uint32_t list_size); -bool m_is_receiving_file(non_null() Messenger *m); +bool m_is_receiving_file(Messenger *_Nonnull m); #endif /* C_TOXCORE_TOXCORE_MESSENGER_H */ diff --git a/toxcore/TCP_client.c b/toxcore/TCP_client.c index eda1a35bb..4defce7a0 100644 --- a/toxcore/TCP_client.c +++ b/toxcore/TCP_client.c @@ -107,8 +107,8 @@ void tcp_con_set_custom_uint(TCP_Client_Connection *con, uint32_t value) * @retval true on success * @retval false on failure */ -static bool connect_sock_to(non_null() const Network *ns, non_null() const Logger *logger, non_null() const Memory *mem, Socket sock, non_null() const IP_Port *ip_port, - non_null() const TCP_Proxy_Info *proxy_info) +static bool connect_sock_to(const Network *_Nonnull ns, const Logger *_Nonnull logger, const Memory *_Nonnull mem, Socket sock, const IP_Port *_Nonnull ip_port, + const TCP_Proxy_Info *_Nonnull proxy_info) { Net_Err_Connect err; if (proxy_info->proxy_type != TCP_PROXY_NONE) { @@ -133,7 +133,7 @@ static bool connect_sock_to(non_null() const Network *ns, non_null() const Logge * @retval 1 on success. * @retval 0 on failure. */ -static int proxy_http_generate_connection_request(non_null() TCP_Client_Connection *tcp_conn) +static int proxy_http_generate_connection_request(TCP_Client_Connection *_Nonnull tcp_conn) { const char one[] = "CONNECT "; const char two[] = " HTTP/1.1\nHost: "; @@ -163,7 +163,7 @@ static int proxy_http_generate_connection_request(non_null() TCP_Client_Connecti * @retval 0 if no data received. * @retval -1 on failure (connection refused). */ -static int proxy_http_read_connection_response(non_null() const Logger *logger, non_null() const TCP_Client_Connection *tcp_conn) +static int proxy_http_read_connection_response(const Logger *_Nonnull logger, const TCP_Client_Connection *_Nonnull tcp_conn) { const char success[] = "200"; uint8_t data[16]; // draining works the best if the length is a power of 2 @@ -212,7 +212,7 @@ enum Tcp_Socks5_Proxy_Hs { TCP_SOCKS5_PROXY_HS_ADDR_TYPE_IPV6 = 0x04, }; -static void proxy_socks5_generate_greetings(non_null() TCP_Client_Connection *tcp_conn) +static void proxy_socks5_generate_greetings(TCP_Client_Connection *_Nonnull tcp_conn) { tcp_conn->con.last_packet[0] = TCP_SOCKS5_PROXY_HS_VERSION_SOCKS5; tcp_conn->con.last_packet[1] = TCP_SOCKS5_PROXY_HS_AUTH_METHODS_SUPPORTED; @@ -227,7 +227,7 @@ static void proxy_socks5_generate_greetings(non_null() TCP_Client_Connection *tc * @retval 0 if no data received. * @retval -1 on failure (connection refused). */ -static int socks5_read_handshake_response(non_null() const Logger *logger, non_null() const TCP_Client_Connection *tcp_conn) +static int socks5_read_handshake_response(const Logger *_Nonnull logger, const TCP_Client_Connection *_Nonnull tcp_conn) { uint8_t data[2]; const TCP_Connection *con = &tcp_conn->con; @@ -244,7 +244,7 @@ static int socks5_read_handshake_response(non_null() const Logger *logger, non_n return -1; } -static void proxy_socks5_generate_connection_request(non_null() TCP_Client_Connection *tcp_conn) +static void proxy_socks5_generate_connection_request(TCP_Client_Connection *_Nonnull tcp_conn) { tcp_conn->con.last_packet[0] = TCP_SOCKS5_PROXY_HS_VERSION_SOCKS5; tcp_conn->con.last_packet[1] = TCP_SOCKS5_PROXY_HS_COMM_ESTABLISH_REQUEST; @@ -275,7 +275,7 @@ static void proxy_socks5_generate_connection_request(non_null() TCP_Client_Conne * @retval 0 if no data received. * @retval -1 on failure (connection refused). */ -static int proxy_socks5_read_connection_response(non_null() const Logger *logger, non_null() const TCP_Client_Connection *tcp_conn) +static int proxy_socks5_read_connection_response(const Logger *_Nonnull logger, const TCP_Client_Connection *_Nonnull tcp_conn) { if (net_family_is_ipv4(tcp_conn->ip_port.ip.family)) { uint8_t data[4 + sizeof(IP4) + sizeof(uint16_t)]; @@ -310,7 +310,7 @@ static int proxy_socks5_read_connection_response(non_null() const Logger *logger * @retval 0 on success. * @retval -1 on failure. */ -static int generate_handshake(non_null() TCP_Client_Connection *tcp_conn) +static int generate_handshake(TCP_Client_Connection *_Nonnull tcp_conn) { uint8_t plain[CRYPTO_PUBLIC_KEY_SIZE + CRYPTO_NONCE_SIZE]; crypto_new_keypair(tcp_conn->con.rng, plain, tcp_conn->temp_secret_key); @@ -336,7 +336,7 @@ static int generate_handshake(non_null() TCP_Client_Connection *tcp_conn) * @retval 0 on success. * @retval -1 on failure. */ -static int handle_handshake(non_null() TCP_Client_Connection *tcp_conn, non_null() const uint8_t *data) +static int handle_handshake(TCP_Client_Connection *_Nonnull tcp_conn, const uint8_t *_Nonnull data) { uint8_t plain[CRYPTO_PUBLIC_KEY_SIZE + CRYPTO_NONCE_SIZE]; const int len = decrypt_data_symmetric(tcp_conn->con.mem, tcp_conn->con.shared_key, data, data + CRYPTO_NONCE_SIZE, @@ -377,8 +377,8 @@ void routing_status_handler(TCP_Client_Connection *con, tcp_routing_status_cb *s con->status_callback_object = object; } -static int tcp_send_ping_response(non_null() const Logger *logger, non_null() TCP_Client_Connection *con); -static int tcp_send_ping_request(non_null() const Logger *logger, non_null() TCP_Client_Connection *con); +static int tcp_send_ping_response(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull con); +static int tcp_send_ping_request(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull con); /** * @retval 1 on success. @@ -464,7 +464,7 @@ void oob_data_handler(TCP_Client_Connection *con, tcp_oob_data_cb *oob_data_call * @retval 0 if could not send packet. * @retval -1 on failure (connection must be killed). */ -static int client_send_disconnect_notification(non_null() const Logger *logger, non_null() TCP_Client_Connection *con, uint8_t id) +static int client_send_disconnect_notification(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull con, uint8_t id) { uint8_t packet[1 + 1]; packet[0] = TCP_PACKET_DISCONNECT_NOTIFICATION; @@ -477,7 +477,7 @@ static int client_send_disconnect_notification(non_null() const Logger *logger, * @retval 0 if could not send packet. * @retval -1 on failure (connection must be killed). */ -static int tcp_send_ping_request(const Logger *logger, TCP_Client_Connection *con) +static int tcp_send_ping_request(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull con) { if (con->ping_request_id == 0) { return 1; @@ -500,7 +500,7 @@ static int tcp_send_ping_request(const Logger *logger, TCP_Client_Connection *co * @retval 0 if could not send packet. * @retval -1 on failure (connection must be killed). */ -static int tcp_send_ping_response(const Logger *logger, TCP_Client_Connection *con) +static int tcp_send_ping_response(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull con) { if (con->ping_response_id == 0) { return 1; @@ -586,7 +586,7 @@ void forwarding_handler(TCP_Client_Connection *con, forwarded_response_cb *forwa TCP_Client_Connection *new_tcp_connection( const Logger *logger, const Memory *mem, const Mono_Time *mono_time, const Random *rng, const Network *ns, const IP_Port *ip_port, const uint8_t *public_key, const uint8_t *self_public_key, const uint8_t *self_secret_key, - const TCP_Proxy_Info *proxy_info, Net_Profile *net_profile) + const TCP_Proxy_Info *proxy_info, Net_Profile *_Nullable net_profile) { assert(logger != nullptr); assert(mem != nullptr); @@ -690,7 +690,7 @@ TCP_Client_Connection *new_tcp_connection( return temp; } -static int handle_tcp_client_routing_response(non_null() TCP_Client_Connection *conn, non_null() const uint8_t *data, uint16_t length) +static int handle_tcp_client_routing_response(TCP_Client_Connection *_Nonnull conn, const uint8_t *_Nonnull data, uint16_t length) { if (length != 1 + 1 + CRYPTO_PUBLIC_KEY_SIZE) { return -1; @@ -717,7 +717,7 @@ static int handle_tcp_client_routing_response(non_null() TCP_Client_Connection * return 0; } -static int handle_tcp_client_connection_notification(non_null() TCP_Client_Connection *conn, non_null() const uint8_t *data, uint16_t length) +static int handle_tcp_client_connection_notification(TCP_Client_Connection *_Nonnull conn, const uint8_t *_Nonnull data, uint16_t length) { if (length != 1 + 1) { return -1; @@ -743,7 +743,7 @@ static int handle_tcp_client_connection_notification(non_null() TCP_Client_Conne return 0; } -static int handle_tcp_client_disconnect_notification(non_null() TCP_Client_Connection *conn, non_null() const uint8_t *data, uint16_t length) +static int handle_tcp_client_disconnect_notification(TCP_Client_Connection *_Nonnull conn, const uint8_t *_Nonnull data, uint16_t length) { if (length != 1 + 1) { return -1; @@ -773,7 +773,7 @@ static int handle_tcp_client_disconnect_notification(non_null() TCP_Client_Conne return 0; } -static int handle_tcp_client_ping(non_null() const Logger *logger, non_null() TCP_Client_Connection *conn, non_null() const uint8_t *data, uint16_t length) +static int handle_tcp_client_ping(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull conn, const uint8_t *_Nonnull data, uint16_t length) { if (length != 1 + sizeof(uint64_t)) { return -1; @@ -786,7 +786,7 @@ static int handle_tcp_client_ping(non_null() const Logger *logger, non_null() TC return 0; } -static int handle_tcp_client_pong(non_null() TCP_Client_Connection *conn, non_null() const uint8_t *data, uint16_t length) +static int handle_tcp_client_pong(TCP_Client_Connection *_Nonnull conn, const uint8_t *_Nonnull data, uint16_t length) { if (length != 1 + sizeof(uint64_t)) { return -1; @@ -806,7 +806,7 @@ static int handle_tcp_client_pong(non_null() TCP_Client_Connection *conn, non_nu return -1; } -static int handle_tcp_client_oob_recv(non_null() TCP_Client_Connection *conn, non_null() const uint8_t *data, uint16_t length, nullable() void *userdata) +static int handle_tcp_client_oob_recv(TCP_Client_Connection *_Nonnull conn, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata) { if (length <= 1 + CRYPTO_PUBLIC_KEY_SIZE) { return -1; @@ -824,8 +824,8 @@ static int handle_tcp_client_oob_recv(non_null() TCP_Client_Connection *conn, no * @retval 0 on success * @retval -1 on failure */ -static int handle_tcp_client_packet(non_null() const Logger *logger, non_null() TCP_Client_Connection *conn, non_null() const uint8_t *data, - uint16_t length, nullable() void *userdata) +static int handle_tcp_client_packet(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull conn, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata) { if (length <= 1) { return -1; @@ -883,7 +883,7 @@ static int handle_tcp_client_packet(non_null() const Logger *logger, non_null() return 0; } -static bool tcp_process_packet(non_null() const Logger *logger, non_null() TCP_Client_Connection *conn, nullable() void *userdata) +static bool tcp_process_packet(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull conn, void *_Nullable userdata) { uint8_t packet[MAX_PACKET_SIZE]; const int len = read_packet_tcp_secure_connection(logger, conn->con.mem, conn->con.ns, conn->con.sock, &conn->next_packet_length, conn->con.shared_key, conn->recv_nonce, packet, sizeof(packet), @@ -906,8 +906,8 @@ static bool tcp_process_packet(non_null() const Logger *logger, non_null() TCP_C return true; } -static int do_confirmed_tcp(non_null() const Logger *logger, non_null() TCP_Client_Connection *conn, non_null() const Mono_Time *mono_time, - nullable() void *userdata) +static int do_confirmed_tcp(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull conn, const Mono_Time *_Nonnull mono_time, + void *_Nullable userdata) { send_pending_data(logger, &conn->con); tcp_send_ping_response(logger, conn); diff --git a/toxcore/TCP_client.h b/toxcore/TCP_client.h index 3f29c02a3..08c782d4c 100644 --- a/toxcore/TCP_client.h +++ b/toxcore/TCP_client.h @@ -44,56 +44,56 @@ typedef enum TCP_Client_Status { typedef struct TCP_Client_Connection TCP_Client_Connection; -const uint8_t *tcp_con_public_key(non_null() const TCP_Client_Connection *con); -IP_Port tcp_con_ip_port(non_null() const TCP_Client_Connection *con); -TCP_Client_Status tcp_con_status(non_null() const TCP_Client_Connection *con); +const uint8_t *_Nonnull tcp_con_public_key(const TCP_Client_Connection *_Nonnull con); +IP_Port tcp_con_ip_port(const TCP_Client_Connection *_Nonnull con); +TCP_Client_Status tcp_con_status(const TCP_Client_Connection *_Nonnull con); -void *tcp_con_custom_object(non_null() const TCP_Client_Connection *con); -uint32_t tcp_con_custom_uint(non_null() const TCP_Client_Connection *con); -void tcp_con_set_custom_object(non_null() TCP_Client_Connection *con, non_null() void *object); -void tcp_con_set_custom_uint(non_null() TCP_Client_Connection *con, uint32_t value); +void *_Nullable tcp_con_custom_object(const TCP_Client_Connection *_Nonnull con); +uint32_t tcp_con_custom_uint(const TCP_Client_Connection *_Nonnull con); +void tcp_con_set_custom_object(TCP_Client_Connection *_Nonnull con, void *_Nonnull object); +void tcp_con_set_custom_uint(TCP_Client_Connection *_Nonnull con, uint32_t value); /** Create new TCP connection to ip_port/public_key */ -TCP_Client_Connection *new_tcp_connection( - non_null() const Logger *logger, non_null() const Memory *mem, non_null() const Mono_Time *mono_time, non_null() const Random *rng, non_null() const Network *ns, - non_null() const IP_Port *ip_port, non_null() const uint8_t *public_key, non_null() const uint8_t *self_public_key, non_null() const uint8_t *self_secret_key, - nullable() const TCP_Proxy_Info *proxy_info, nullable() Net_Profile *net_profile); +TCP_Client_Connection *_Nullable new_tcp_connection( + const Logger *_Nonnull logger, const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, const Random *_Nonnull rng, const Network *_Nonnull ns, + const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull self_public_key, const uint8_t *_Nonnull self_secret_key, + const TCP_Proxy_Info *_Nullable proxy_info, Net_Profile *_Nullable net_profile); /** Run the TCP connection */ -void do_tcp_connection(non_null() const Logger *logger, non_null() const Mono_Time *mono_time, - non_null() TCP_Client_Connection *tcp_connection, nullable() void *userdata); +void do_tcp_connection(const Logger *_Nonnull logger, const Mono_Time *_Nonnull mono_time, + TCP_Client_Connection *_Nonnull tcp_connection, void *_Nullable userdata); /** Kill the TCP connection */ -void kill_tcp_connection(nullable() TCP_Client_Connection *tcp_connection); -typedef int tcp_onion_response_cb(void *object, const uint8_t *data, uint16_t length, void *userdata); +void kill_tcp_connection(TCP_Client_Connection *_Nullable tcp_connection); +typedef int tcp_onion_response_cb(void *_Nonnull object, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata); /** * @retval 1 on success. * @retval 0 if could not send packet. * @retval -1 on failure (connection must be killed). */ -int send_onion_request(non_null() const Logger *logger, non_null() TCP_Client_Connection *con, non_null() const uint8_t *data, uint16_t length); -void onion_response_handler(non_null() TCP_Client_Connection *con, non_null() tcp_onion_response_cb *onion_callback, non_null() void *object); +int send_onion_request(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull con, const uint8_t *_Nonnull data, uint16_t length); +void onion_response_handler(TCP_Client_Connection *_Nonnull con, tcp_onion_response_cb *_Nonnull onion_callback, void *_Nonnull object); -int send_forward_request_tcp(non_null() const Logger *logger, non_null() TCP_Client_Connection *con, non_null() const IP_Port *dest, non_null() const uint8_t *data, uint16_t length); -void forwarding_handler(non_null() TCP_Client_Connection *con, non_null() forwarded_response_cb *forwarded_response_callback, non_null() void *object); +int send_forward_request_tcp(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull con, const IP_Port *_Nonnull dest, const uint8_t *_Nonnull data, uint16_t length); +void forwarding_handler(TCP_Client_Connection *_Nonnull con, forwarded_response_cb *_Nonnull forwarded_response_callback, void *_Nonnull object); -typedef int tcp_routing_response_cb(void *object, uint8_t connection_id, const uint8_t *public_key); -typedef int tcp_routing_status_cb(void *object, uint32_t number, uint8_t connection_id, uint8_t status); +typedef int tcp_routing_response_cb(void *_Nonnull object, uint8_t connection_id, const uint8_t *_Nonnull public_key); +typedef int tcp_routing_status_cb(void *_Nonnull object, uint32_t number, uint8_t connection_id, uint8_t status); /** * @retval 1 on success. * @retval 0 if could not send packet. * @retval -1 on failure (connection must be killed). */ -int send_routing_request(non_null() const Logger *logger, non_null() TCP_Client_Connection *con, non_null() const uint8_t *public_key); -void routing_response_handler(non_null() TCP_Client_Connection *con, non_null() tcp_routing_response_cb *response_callback, non_null() void *object); -void routing_status_handler(non_null() TCP_Client_Connection *con, non_null() tcp_routing_status_cb *status_callback, non_null() void *object); +int send_routing_request(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull con, const uint8_t *_Nonnull public_key); +void routing_response_handler(TCP_Client_Connection *_Nonnull con, tcp_routing_response_cb *_Nonnull response_callback, void *_Nonnull object); +void routing_status_handler(TCP_Client_Connection *_Nonnull con, tcp_routing_status_cb *_Nonnull status_callback, void *_Nonnull object); /** * @retval 1 on success. * @retval 0 if could not send packet. * @retval -1 on failure (connection must be killed). */ -int send_disconnect_request(non_null() const Logger *logger, non_null() TCP_Client_Connection *con, uint8_t con_id); +int send_disconnect_request(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull con, uint8_t con_id); /** @brief Set the number that will be used as an argument in the callbacks related to con_id. * @@ -102,28 +102,28 @@ int send_disconnect_request(non_null() const Logger *logger, non_null() TCP_Clie * return 0 on success. * return -1 on failure. */ -int set_tcp_connection_number(non_null() TCP_Client_Connection *con, uint8_t con_id, uint32_t number); +int set_tcp_connection_number(TCP_Client_Connection *_Nonnull con, uint8_t con_id, uint32_t number); -typedef int tcp_routing_data_cb(void *object, uint32_t number, uint8_t connection_id, const uint8_t *data, - uint16_t length, void *userdata); +typedef int tcp_routing_data_cb(void *_Nonnull object, uint32_t number, uint8_t connection_id, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata); /** * @retval 1 on success. * @retval 0 if could not send packet. * @retval -1 on failure. */ -int send_data(non_null() const Logger *logger, non_null() TCP_Client_Connection *con, uint8_t con_id, non_null() const uint8_t *data, uint16_t length); -void routing_data_handler(non_null() TCP_Client_Connection *con, non_null() tcp_routing_data_cb *data_callback, non_null() void *object); +int send_data(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull con, uint8_t con_id, const uint8_t *_Nonnull data, uint16_t length); +void routing_data_handler(TCP_Client_Connection *_Nonnull con, tcp_routing_data_cb *_Nonnull data_callback, void *_Nonnull object); -typedef int tcp_oob_data_cb(void *object, const uint8_t *public_key, const uint8_t *data, uint16_t length, - void *userdata); +typedef int tcp_oob_data_cb(void *_Nonnull object, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull data, uint16_t length, + void *_Nullable userdata); /** * @retval 1 on success. * @retval 0 if could not send packet. * @retval -1 on failure. */ -int send_oob_packet(non_null() const Logger *logger, non_null() TCP_Client_Connection *con, non_null() const uint8_t *public_key, non_null() const uint8_t *data, uint16_t length); -void oob_data_handler(non_null() TCP_Client_Connection *con, non_null() tcp_oob_data_cb *oob_data_callback, non_null() void *object); +int send_oob_packet(const Logger *_Nonnull logger, TCP_Client_Connection *_Nonnull con, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull data, uint16_t length); +void oob_data_handler(TCP_Client_Connection *_Nonnull con, tcp_oob_data_cb *_Nonnull oob_data_callback, void *_Nonnull object); #endif /* C_TOXCORE_TOXCORE_TCP_CLIENT_H */ diff --git a/toxcore/TCP_common.c b/toxcore/TCP_common.c index ed02c2c4f..7e358af96 100644 --- a/toxcore/TCP_common.c +++ b/toxcore/TCP_common.c @@ -97,7 +97,7 @@ int send_pending_data(const Logger *logger, TCP_Connection *con) * @retval false on failure (only if mem_alloc fails) * @retval true on success */ -static bool add_priority(non_null() TCP_Connection *con, non_null() const uint8_t *packet, uint16_t size, uint16_t sent) +static bool add_priority(TCP_Connection *_Nonnull con, const uint8_t *_Nonnull packet, uint16_t size, uint16_t sent) { TCP_Priority_List *p = con->priority_queue_end; TCP_Priority_List *new_list = (TCP_Priority_List *)mem_alloc(con->mem, sizeof(TCP_Priority_List)); @@ -234,7 +234,7 @@ int read_tcp_packet( * return 0 if nothing has been read from socket. * return -1 on failure. */ -static uint16_t read_tcp_length(non_null() const Logger *logger, non_null() const Network *ns, Socket sock, non_null() const IP_Port *ip_port) +static uint16_t read_tcp_length(const Logger *_Nonnull logger, const Network *_Nonnull ns, Socket sock, const IP_Port *_Nonnull ip_port) { const uint16_t count = net_socket_data_recv_buffer(ns, sock); diff --git a/toxcore/TCP_common.h b/toxcore/TCP_common.h index 22e23b483..1d4c3d495 100644 --- a/toxcore/TCP_common.h +++ b/toxcore/TCP_common.h @@ -15,13 +15,13 @@ typedef struct TCP_Priority_List TCP_Priority_List; struct TCP_Priority_List { - TCP_Priority_List *next; + TCP_Priority_List *_Nullable next; uint16_t size; uint16_t sent; - uint8_t *data; + uint8_t *_Nonnull data; }; -void wipe_priority_list(non_null() const Memory *mem, nullable() TCP_Priority_List *p); +void wipe_priority_list(const Memory *_Nonnull mem, TCP_Priority_List *_Nullable p); #define NUM_RESERVED_PORTS 16 #define NUM_CLIENT_CONNECTIONS (256 - NUM_RESERVED_PORTS) @@ -52,9 +52,9 @@ typedef enum Tcp_Packet { #define MAX_PACKET_SIZE 2048 typedef struct TCP_Connection { - const Memory *mem; - const Random *rng; - const Network *ns; + const Memory *_Nonnull mem; + const Random *_Nonnull rng; + const Network *_Nonnull ns; Socket sock; IP_Port ip_port; // for debugging. uint8_t sent_nonce[CRYPTO_NONCE_SIZE]; /* Nonce of sent packets. */ @@ -63,47 +63,47 @@ typedef struct TCP_Connection { uint16_t last_packet_length; uint16_t last_packet_sent; - TCP_Priority_List *priority_queue_start; - TCP_Priority_List *priority_queue_end; + TCP_Priority_List *_Nullable priority_queue_start; + TCP_Priority_List *_Nullable priority_queue_end; // This is a shared pointer to the parent's respective Net_Profile object // (either TCP_Server for TCP server packets or TCP_Connections for TCP client packets). - Net_Profile *net_profile; + Net_Profile *_Nullable net_profile; } TCP_Connection; /** * @retval 0 if pending data was sent completely * @retval -1 if it wasn't */ -int send_pending_data_nonpriority(non_null() const Logger *logger, non_null() TCP_Connection *con); +int send_pending_data_nonpriority(const Logger *_Nonnull logger, TCP_Connection *_Nonnull con); /** * @retval 0 if pending data was sent completely * @retval -1 if it wasn't */ -int send_pending_data(non_null() const Logger *logger, non_null() TCP_Connection *con); +int send_pending_data(const Logger *_Nonnull logger, TCP_Connection *_Nonnull con); /** * @retval 1 on success. * @retval 0 if could not send packet. * @retval -1 on failure (connection must be killed). */ -int write_packet_tcp_secure_connection(non_null() const Logger *logger, non_null() TCP_Connection *con, non_null() const uint8_t *data, uint16_t length, bool priority); +int write_packet_tcp_secure_connection(const Logger *_Nonnull logger, TCP_Connection *_Nonnull con, const uint8_t *_Nonnull data, uint16_t length, bool priority); /** @brief Read length bytes from socket. * * return length on success * return -1 on failure/no data in buffer. */ -int read_tcp_packet(non_null() const Logger *logger, non_null() const Memory *mem, non_null() const Network *ns, Socket sock, non_null() uint8_t *data, uint16_t length, - non_null() const IP_Port *ip_port); +int read_tcp_packet(const Logger *_Nonnull logger, const Memory *_Nonnull mem, const Network *_Nonnull ns, Socket sock, uint8_t *_Nonnull data, uint16_t length, + const IP_Port *_Nonnull ip_port); /** * @return length of received packet on success. * @retval 0 if could not read any packet. * @retval -1 on failure (connection must be killed). */ -int read_packet_tcp_secure_connection(non_null() const Logger *logger, non_null() const Memory *mem, non_null() const Network *ns, Socket sock, non_null() uint16_t *next_packet_length, - non_null() const uint8_t *shared_key, non_null() uint8_t *recv_nonce, non_null() uint8_t *data, uint16_t max_len, non_null() const IP_Port *ip_port); +int read_packet_tcp_secure_connection(const Logger *_Nonnull logger, const Memory *_Nonnull mem, const Network *_Nonnull ns, Socket sock, uint16_t *_Nonnull next_packet_length, + const uint8_t *_Nonnull shared_key, uint8_t *_Nonnull recv_nonce, uint8_t *_Nonnull data, uint16_t max_len, const IP_Port *_Nonnull ip_port); #endif /* C_TOXCORE_TOXCORE_TCP_COMMON_H */ diff --git a/toxcore/TCP_connection.c b/toxcore/TCP_connection.c index 5b99467dc..6b2f99462 100644 --- a/toxcore/TCP_connection.c +++ b/toxcore/TCP_connection.c @@ -80,7 +80,7 @@ uint32_t tcp_connections_count(const TCP_Connections *tcp_c) * @retval -1 if mem_vrealloc fails. * @retval 0 if it succeeds. */ -static int realloc_tcp_connection_to(non_null() const Memory *mem, non_null() TCP_Connection_to **array, size_t num) +static int realloc_tcp_connection_to(const Memory *_Nonnull mem, TCP_Connection_to *_Nullable *_Nonnull array, size_t num) { if (num == 0) { mem_delete(mem, *array); @@ -100,7 +100,7 @@ static int realloc_tcp_connection_to(non_null() const Memory *mem, non_null() TC return 0; } -static int realloc_tcp_con(non_null() const Memory *mem, non_null() TCP_con **array, size_t num) +static int realloc_tcp_con(const Memory *_Nonnull mem, TCP_con *_Nullable *_Nonnull array, size_t num) { if (num == 0) { mem_delete(mem, *array); @@ -122,7 +122,7 @@ static int realloc_tcp_con(non_null() const Memory *mem, non_null() TCP_con **ar /** * Return true if the connections_number is valid. */ -static bool connections_number_is_valid(non_null() const TCP_Connections *tcp_c, int connections_number) +static bool connections_number_is_valid(const TCP_Connections *_Nonnull tcp_c, int connections_number) { if ((unsigned int)connections_number >= tcp_c->connections_length) { return false; @@ -138,7 +138,7 @@ static bool connections_number_is_valid(non_null() const TCP_Connections *tcp_c, /** * Return true if the tcp_connections_number is valid. */ -static bool tcp_connections_number_is_valid(non_null() const TCP_Connections *tcp_c, int tcp_connections_number) +static bool tcp_connections_number_is_valid(const TCP_Connections *_Nonnull tcp_c, int tcp_connections_number) { if ((uint32_t)tcp_connections_number >= tcp_c->tcp_connections_length) { return false; @@ -156,7 +156,7 @@ static bool tcp_connections_number_is_valid(non_null() const TCP_Connections *tc * return -1 on failure. * return connections_number on success. */ -static int create_connection(non_null() TCP_Connections *tcp_c) +static int create_connection(TCP_Connections *_Nonnull tcp_c) { for (uint32_t i = 0; i < tcp_c->connections_length; ++i) { if (tcp_c->connections[i].status == TCP_CONN_NONE) { @@ -180,7 +180,7 @@ static int create_connection(non_null() TCP_Connections *tcp_c) * return -1 on failure. * return tcp_connections_number on success. */ -static int create_tcp_connection(non_null() TCP_Connections *tcp_c) +static int create_tcp_connection(TCP_Connections *_Nonnull tcp_c) { for (uint32_t i = 0; i < tcp_c->tcp_connections_length; ++i) { if (tcp_c->tcp_connections[i].status == TCP_CONN_NONE) { @@ -204,7 +204,7 @@ static int create_tcp_connection(non_null() TCP_Connections *tcp_c) * return -1 on failure. * return 0 on success. */ -static int wipe_connection(non_null() TCP_Connections *tcp_c, int connections_number) +static int wipe_connection(TCP_Connections *_Nonnull tcp_c, int connections_number) { if (!connections_number_is_valid(tcp_c, connections_number)) { return -1; @@ -234,7 +234,7 @@ static int wipe_connection(non_null() TCP_Connections *tcp_c, int connections_nu * return -1 on failure. * return 0 on success. */ -static int wipe_tcp_connection(non_null() TCP_Connections *tcp_c, int tcp_connections_number) +static int wipe_tcp_connection(TCP_Connections *_Nonnull tcp_c, int tcp_connections_number) { if (!tcp_connections_number_is_valid(tcp_c, tcp_connections_number)) { return -1; @@ -260,7 +260,7 @@ static int wipe_tcp_connection(non_null() TCP_Connections *tcp_c, int tcp_connec return 0; } -static TCP_Connection_to *get_connection(non_null() const TCP_Connections *tcp_c, int connections_number) +static TCP_Connection_to *get_connection(const TCP_Connections *_Nonnull tcp_c, int connections_number) { if (!connections_number_is_valid(tcp_c, connections_number)) { return nullptr; @@ -269,7 +269,7 @@ static TCP_Connection_to *get_connection(non_null() const TCP_Connections *tcp_c return &tcp_c->connections[connections_number]; } -static TCP_con *get_tcp_connection(non_null() const TCP_Connections *tcp_c, int tcp_connections_number) +static TCP_con *get_tcp_connection(const TCP_Connections *_Nonnull tcp_c, int tcp_connections_number) { if (!tcp_connections_number_is_valid(tcp_c, tcp_connections_number)) { return nullptr; @@ -403,7 +403,7 @@ int get_random_tcp_onion_conn_number(const TCP_Connections *tcp_c) * return TCP connection number on success. * return -1 on failure. */ -static int get_conn_number_by_ip_port(non_null() const TCP_Connections *tcp_c, non_null() const IP_Port *ip_port) +static int get_conn_number_by_ip_port(const TCP_Connections *_Nonnull tcp_c, const IP_Port *_Nonnull ip_port) { for (uint32_t i = 0; i < tcp_c->tcp_connections_length; ++i) { const IP_Port conn_ip_port = tcp_con_ip_port(tcp_c->tcp_connections[i].connection); @@ -515,7 +515,7 @@ int tcp_send_oob_packet(const TCP_Connections *tcp_c, unsigned int tcp_connectio return -1; } -static int find_tcp_connection_relay(non_null() const TCP_Connections *tcp_c, non_null() const uint8_t *relay_pk); +static int find_tcp_connection_relay(const TCP_Connections *_Nonnull tcp_c, const uint8_t *_Nonnull relay_pk); /** @brief Send an oob packet via the TCP relay corresponding to relay_pk. * @@ -592,7 +592,7 @@ bool ip_port_to_tcp_connections_number(const IP_Port *ip_port, unsigned int *tcp * return connections_number on success. * return -1 on failure. */ -static int find_tcp_connection_to(non_null() const TCP_Connections *tcp_c, non_null() const uint8_t *public_key) +static int find_tcp_connection_to(const TCP_Connections *_Nonnull tcp_c, const uint8_t *_Nonnull public_key) { for (uint32_t i = 0; i < tcp_c->connections_length; ++i) { const TCP_Connection_to *con_to = get_connection(tcp_c, i); @@ -773,7 +773,7 @@ int set_tcp_connection_to_status(const TCP_Connections *tcp_c, int connections_n return 0; } -static bool tcp_connection_in_conn(non_null() const TCP_Connection_to *con_to, unsigned int tcp_connections_number) +static bool tcp_connection_in_conn(const TCP_Connection_to *_Nonnull con_to, unsigned int tcp_connections_number) { for (uint32_t i = 0; i < MAX_FRIEND_TCP_CONNECTIONS; ++i) { if (con_to->connections[i].tcp_connection == (tcp_connections_number + 1)) { @@ -788,7 +788,7 @@ static bool tcp_connection_in_conn(non_null() const TCP_Connection_to *con_to, u * @return index on success. * @retval -1 on failure. */ -static int add_tcp_connection_to_conn(non_null() TCP_Connection_to *con_to, unsigned int tcp_connections_number) +static int add_tcp_connection_to_conn(TCP_Connection_to *_Nonnull con_to, unsigned int tcp_connections_number) { if (tcp_connection_in_conn(con_to, tcp_connections_number)) { return -1; @@ -810,7 +810,7 @@ static int add_tcp_connection_to_conn(non_null() TCP_Connection_to *con_to, unsi * @return index on success. * @retval -1 on failure. */ -static int rm_tcp_connection_from_conn(non_null() TCP_Connection_to *con_to, unsigned int tcp_connections_number) +static int rm_tcp_connection_from_conn(TCP_Connection_to *_Nonnull con_to, unsigned int tcp_connections_number) { for (uint32_t i = 0; i < MAX_FRIEND_TCP_CONNECTIONS; ++i) { if (con_to->connections[i].tcp_connection == (tcp_connections_number + 1)) { @@ -828,7 +828,7 @@ static int rm_tcp_connection_from_conn(non_null() TCP_Connection_to *con_to, uns * @return number of online connections on success. * @retval -1 on failure. */ -static uint32_t online_tcp_connection_from_conn(non_null() const TCP_Connection_to *con_to) +static uint32_t online_tcp_connection_from_conn(const TCP_Connection_to *_Nonnull con_to) { uint32_t count = 0; @@ -847,7 +847,7 @@ static uint32_t online_tcp_connection_from_conn(non_null() const TCP_Connection_ * @return index on success. * @retval -1 on failure. */ -static int set_tcp_connection_status(non_null() TCP_Connection_to *con_to, unsigned int tcp_connections_number, uint8_t status, uint8_t connection_id) +static int set_tcp_connection_status(TCP_Connection_to *_Nonnull con_to, unsigned int tcp_connections_number, uint8_t status, uint8_t connection_id) { for (uint32_t i = 0; i < MAX_FRIEND_TCP_CONNECTIONS; ++i) { if (con_to->connections[i].tcp_connection == (tcp_connections_number + 1)) { @@ -895,7 +895,7 @@ int kill_tcp_relay_connection(TCP_Connections *tcp_c, int tcp_connections_number return wipe_tcp_connection(tcp_c, tcp_connections_number); } -static int reconnect_tcp_relay_connection(non_null() TCP_Connections *tcp_c, int tcp_connections_number) +static int reconnect_tcp_relay_connection(TCP_Connections *_Nonnull tcp_c, int tcp_connections_number) { TCP_con *tcp_con = get_tcp_connection(tcp_c, tcp_connections_number); @@ -941,7 +941,7 @@ static int reconnect_tcp_relay_connection(non_null() TCP_Connections *tcp_c, int return 0; } -static int sleep_tcp_relay_connection(non_null() TCP_Connections *tcp_c, int tcp_connections_number) +static int sleep_tcp_relay_connection(TCP_Connections *_Nonnull tcp_c, int tcp_connections_number) { TCP_con *tcp_con = get_tcp_connection(tcp_c, tcp_connections_number); @@ -985,7 +985,7 @@ static int sleep_tcp_relay_connection(non_null() TCP_Connections *tcp_c, int tcp return 0; } -static int unsleep_tcp_relay_connection(non_null() TCP_Connections *tcp_c, int tcp_connections_number) +static int unsleep_tcp_relay_connection(TCP_Connections *_Nonnull tcp_c, int tcp_connections_number) { TCP_con *tcp_con = get_tcp_connection(tcp_c, tcp_connections_number); @@ -1020,7 +1020,7 @@ static int unsleep_tcp_relay_connection(non_null() TCP_Connections *tcp_c, int t * return 0 on success. * return -1 on failure. */ -static int send_tcp_relay_routing_request(non_null() const TCP_Connections *tcp_c, int tcp_connections_number, non_null() const uint8_t *public_key) +static int send_tcp_relay_routing_request(const TCP_Connections *_Nonnull tcp_c, int tcp_connections_number, const uint8_t *_Nonnull public_key) { TCP_con *tcp_con = get_tcp_connection(tcp_c, tcp_connections_number); @@ -1039,7 +1039,7 @@ static int send_tcp_relay_routing_request(non_null() const TCP_Connections *tcp_ return 0; } -static int tcp_response_callback(non_null() void *object, uint8_t connection_id, non_null() const uint8_t *public_key) +static int tcp_response_callback(void *_Nonnull object, uint8_t connection_id, const uint8_t *_Nonnull public_key) { const TCP_Client_Connection *tcp_client_con = (const TCP_Client_Connection *)object; const TCP_Connections *tcp_c = (const TCP_Connections *)tcp_con_custom_object(tcp_client_con); @@ -1072,7 +1072,7 @@ static int tcp_response_callback(non_null() void *object, uint8_t connection_id, return 0; } -static int tcp_status_callback(non_null() void *object, uint32_t number, uint8_t connection_id, uint8_t status) +static int tcp_status_callback(void *_Nonnull object, uint32_t number, uint8_t connection_id, uint8_t status) { const TCP_Client_Connection *tcp_client_con = (const TCP_Client_Connection *)object; const TCP_Connections *tcp_c = (const TCP_Connections *)tcp_con_custom_object(tcp_client_con); @@ -1110,8 +1110,8 @@ static int tcp_status_callback(non_null() void *object, uint32_t number, uint8_t return 0; } -static int tcp_conn_data_callback(non_null() void *object, uint32_t number, uint8_t connection_id, non_null() const uint8_t *data, - uint16_t length, nullable() void *userdata) +static int tcp_conn_data_callback(void *_Nonnull object, uint32_t number, uint8_t connection_id, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata) { const TCP_Client_Connection *tcp_client_con = (TCP_Client_Connection *)object; if (length == 0) { @@ -1140,7 +1140,7 @@ static int tcp_conn_data_callback(non_null() void *object, uint32_t number, uint return 0; } -static int tcp_conn_oob_callback(non_null() void *object, non_null() const uint8_t *public_key, non_null() const uint8_t *data, uint16_t length, non_null() void *userdata) +static int tcp_conn_oob_callback(void *_Nonnull object, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull data, uint16_t length, void *_Nonnull userdata) { const TCP_Client_Connection *tcp_client_con = (const TCP_Client_Connection *)object; @@ -1173,7 +1173,7 @@ static int tcp_conn_oob_callback(non_null() void *object, non_null() const uint8 return 0; } -static int tcp_onion_callback(non_null() void *object, non_null() const uint8_t *data, uint16_t length, non_null() void *userdata) +static int tcp_onion_callback(void *_Nonnull object, const uint8_t *_Nonnull data, uint16_t length, void *_Nonnull userdata) { TCP_Connections *tcp_c = (TCP_Connections *)object; @@ -1184,7 +1184,7 @@ static int tcp_onion_callback(non_null() void *object, non_null() const uint8_t return 0; } -static void tcp_forwarding_callback(non_null() void *object, non_null() const uint8_t *data, uint16_t length, non_null() void *userdata) +static void tcp_forwarding_callback(void *_Nonnull object, const uint8_t *_Nonnull data, uint16_t length, void *_Nonnull userdata) { TCP_Connections *tcp_c = (TCP_Connections *)object; @@ -1198,7 +1198,7 @@ static void tcp_forwarding_callback(non_null() void *object, non_null() const ui * return 0 on success. * return -1 on failure. */ -static int tcp_relay_set_callbacks(non_null() TCP_Connections *tcp_c, int tcp_connections_number) +static int tcp_relay_set_callbacks(TCP_Connections *_Nonnull tcp_c, int tcp_connections_number) { TCP_con *tcp_con = get_tcp_connection(tcp_c, tcp_connections_number); @@ -1220,7 +1220,7 @@ static int tcp_relay_set_callbacks(non_null() TCP_Connections *tcp_c, int tcp_co return 0; } -static int tcp_relay_on_online(non_null() TCP_Connections *tcp_c, int tcp_connections_number) +static int tcp_relay_on_online(TCP_Connections *_Nonnull tcp_c, int tcp_connections_number) { TCP_con *tcp_con = get_tcp_connection(tcp_c, tcp_connections_number); @@ -1260,7 +1260,7 @@ static int tcp_relay_on_online(non_null() TCP_Connections *tcp_c, int tcp_connec return 0; } -static int add_tcp_relay_instance(non_null() TCP_Connections *tcp_c, non_null() const IP_Port *ip_port, non_null() const uint8_t *relay_pk) +static int add_tcp_relay_instance(TCP_Connections *_Nonnull tcp_c, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull relay_pk) { IP_Port ipp_copy = *ip_port; @@ -1415,7 +1415,7 @@ uint32_t tcp_connection_to_online_tcp_relays(const TCP_Connections *tcp_c, int c * Returns true if the relay was successfully copied. * Returns false if the connection index is invalid, or if the relay is not connected. */ -static bool copy_tcp_relay_conn(non_null() const TCP_Connections *tcp_c, non_null() Node_format *tcp_relay, uint16_t idx) +static bool copy_tcp_relay_conn(const TCP_Connections *_Nonnull tcp_c, Node_format *_Nonnull tcp_relay, uint16_t idx) { const TCP_con *tcp_con = get_tcp_connection(tcp_c, idx); @@ -1591,7 +1591,7 @@ TCP_Connections *new_tcp_connections(const Logger *logger, const Memory *mem, co return temp; } -static void do_tcp_conns(non_null() const Logger *logger, non_null() TCP_Connections *tcp_c, nullable() void *userdata) +static void do_tcp_conns(const Logger *_Nonnull logger, TCP_Connections *_Nonnull tcp_c, void *_Nullable userdata) { for (uint32_t i = 0; i < tcp_c->tcp_connections_length; ++i) { TCP_con *tcp_con = get_tcp_connection(tcp_c, i); @@ -1636,7 +1636,7 @@ static void do_tcp_conns(non_null() const Logger *logger, non_null() TCP_Connect } } -static void kill_nonused_tcp(nullable() TCP_Connections *tcp_c) +static void kill_nonused_tcp(TCP_Connections *_Nullable tcp_c) { if (tcp_c == nullptr) { return; diff --git a/toxcore/TCP_connection.h b/toxcore/TCP_connection.h index f97e25fa1..b77d502e0 100644 --- a/toxcore/TCP_connection.h +++ b/toxcore/TCP_connection.h @@ -67,7 +67,7 @@ typedef struct TCP_Connection_to { typedef struct TCP_con { uint8_t status; - TCP_Client_Connection *connection; + TCP_Client_Connection *_Nullable connection; uint64_t connected_time; uint32_t lock_count; uint32_t sleep_count; @@ -81,22 +81,22 @@ typedef struct TCP_con { typedef struct TCP_Connections TCP_Connections; -const uint8_t *tcp_connections_public_key(non_null() const TCP_Connections *tcp_c); +const uint8_t *_Nonnull tcp_connections_public_key(const TCP_Connections *_Nonnull tcp_c); -uint32_t tcp_connections_count(non_null() const TCP_Connections *tcp_c); +uint32_t tcp_connections_count(const TCP_Connections *_Nonnull tcp_c); /** @brief Returns the number of connected TCP relays. */ -uint32_t tcp_connected_relays_count(non_null() const TCP_Connections *tcp_c); +uint32_t tcp_connected_relays_count(const TCP_Connections *_Nonnull tcp_c); /** @brief Returns true if we know of a valid TCP relay with the passed public key. */ -bool tcp_relay_is_valid(non_null() const TCP_Connections *tcp_c, non_null() const uint8_t *relay_pk); +bool tcp_relay_is_valid(const TCP_Connections *_Nonnull tcp_c, const uint8_t *_Nonnull relay_pk); /** @brief Send a packet to the TCP connection. * * return -1 on failure. * return 0 on success. */ -int send_packet_tcp_connection(non_null() const TCP_Connections *tcp_c, int connections_number, non_null() const uint8_t *packet, uint16_t length); +int send_packet_tcp_connection(const TCP_Connections *_Nonnull tcp_c, int connections_number, const uint8_t *_Nonnull packet, uint16_t length); /** @brief Return a TCP connection number for use in send_tcp_onion_request. * @@ -106,21 +106,21 @@ int send_packet_tcp_connection(non_null() const TCP_Connections *tcp_c, int conn * return TCP connection number on success. * return -1 on failure. */ -int get_random_tcp_onion_conn_number(non_null() const TCP_Connections *tcp_c); +int get_random_tcp_onion_conn_number(const TCP_Connections *_Nonnull tcp_c); /** @brief Put IP_Port of a random onion TCP connection in ip_port. * * return true on success. * return false on failure. */ -bool tcp_get_random_conn_ip_port(non_null() const TCP_Connections *tcp_c, non_null() IP_Port *ip_port); +bool tcp_get_random_conn_ip_port(const TCP_Connections *_Nonnull tcp_c, IP_Port *_Nonnull ip_port); /** @brief Send an onion packet via the TCP relay corresponding to tcp_connections_number. * * return 0 on success. * return -1 on failure. */ -int tcp_send_onion_request(non_null() TCP_Connections *tcp_c, uint32_t tcp_connections_number, non_null() const uint8_t *data, uint16_t length); +int tcp_send_onion_request(TCP_Connections *_Nonnull tcp_c, uint32_t tcp_connections_number, const uint8_t *_Nonnull data, uint16_t length); /** @brief Set if we want TCP_connection to allocate some connection for onion use. * @@ -129,7 +129,7 @@ int tcp_send_onion_request(non_null() TCP_Connections *tcp_c, uint32_t tcp_conne * return 0 on success. * return -1 on failure. */ -int set_tcp_onion_status(non_null() TCP_Connections *tcp_c, bool status); +int set_tcp_onion_status(TCP_Connections *_Nonnull tcp_c, bool status); /** * Send a forward request to the TCP relay with IP_Port tcp_forwarder, @@ -139,37 +139,37 @@ int set_tcp_onion_status(non_null() TCP_Connections *tcp_c, bool status); * return 0 on success. * return -1 on failure. */ -int tcp_send_forward_request(non_null() const Logger *logger, non_null() TCP_Connections *tcp_c, non_null() const IP_Port *tcp_forwarder, non_null() const IP_Port *dht_node, - non_null() const uint8_t *chain_keys, uint16_t chain_length, non_null() const uint8_t *data, uint16_t data_length); +int tcp_send_forward_request(const Logger *_Nonnull logger, TCP_Connections *_Nonnull tcp_c, const IP_Port *_Nonnull tcp_forwarder, const IP_Port *_Nonnull dht_node, + const uint8_t *_Nonnull chain_keys, uint16_t chain_length, const uint8_t *_Nonnull data, uint16_t data_length); /** @brief Send an oob packet via the TCP relay corresponding to tcp_connections_number. * * return 0 on success. * return -1 on failure. */ -int tcp_send_oob_packet(non_null() const TCP_Connections *tcp_c, unsigned int tcp_connections_number, non_null() const uint8_t *public_key, non_null() const uint8_t *packet, uint16_t length); +int tcp_send_oob_packet(const TCP_Connections *_Nonnull tcp_c, unsigned int tcp_connections_number, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull packet, uint16_t length); -typedef int tcp_data_cb(void *object, int crypt_connection_id, const uint8_t *packet, uint16_t length, void *userdata); +typedef int tcp_data_cb(void *_Nonnull object, int crypt_connection_id, const uint8_t *_Nonnull packet, uint16_t length, void *_Nullable userdata); -int tcp_send_oob_packet_using_relay(non_null() const TCP_Connections *tcp_c, non_null() const uint8_t *relay_pk, non_null() const uint8_t *public_key, non_null() const uint8_t *packet, +int tcp_send_oob_packet_using_relay(const TCP_Connections *_Nonnull tcp_c, const uint8_t *_Nonnull relay_pk, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull packet, uint16_t length); /** @brief Set the callback for TCP data packets. */ -void set_packet_tcp_connection_callback(non_null() TCP_Connections *tcp_c, non_null() tcp_data_cb *tcp_data_callback, non_null() void *object); +void set_packet_tcp_connection_callback(TCP_Connections *_Nonnull tcp_c, tcp_data_cb *_Nonnull tcp_data_callback, void *_Nonnull object); -typedef int tcp_onion_cb(void *object, const uint8_t *data, uint16_t length, void *userdata); +typedef int tcp_onion_cb(void *_Nullable object, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata); /** @brief Set the callback for TCP onion packets. */ -void set_onion_packet_tcp_connection_callback(non_null() TCP_Connections *tcp_c, nullable() tcp_onion_cb *tcp_onion_callback, nullable() void *object); +void set_onion_packet_tcp_connection_callback(TCP_Connections *_Nonnull tcp_c, tcp_onion_cb *_Nullable tcp_onion_callback, void *_Nullable object); /** @brief Set the callback for TCP forwarding packets. */ -void set_forwarding_packet_tcp_connection_callback(non_null() TCP_Connections *tcp_c, - nullable() forwarded_response_cb *tcp_forwarded_response_callback, - nullable() void *object); -typedef int tcp_oob_cb(void *object, const uint8_t *public_key, unsigned int tcp_connections_number, - const uint8_t *packet, uint16_t length, void *userdata); +void set_forwarding_packet_tcp_connection_callback(TCP_Connections *_Nonnull tcp_c, + forwarded_response_cb *_Nullable tcp_forwarded_response_callback, + void *_Nullable object); +typedef int tcp_oob_cb(void *_Nonnull object, const uint8_t *_Nonnull public_key, unsigned int tcp_connections_number, + const uint8_t *_Nonnull packet, uint16_t length, void *_Nullable userdata); /** @brief Set the callback for TCP oob data packets. */ -void set_oob_packet_tcp_connection_callback(non_null() TCP_Connections *tcp_c, non_null() tcp_oob_cb *tcp_oob_callback, non_null() void *object); +void set_oob_packet_tcp_connection_callback(TCP_Connections *_Nonnull tcp_c, tcp_oob_cb *_Nonnull tcp_oob_callback, void *_Nonnull object); /** @brief Encode tcp_connections_number as a custom ip_port. * @@ -182,7 +182,7 @@ IP_Port tcp_connections_number_to_ip_port(unsigned int tcp_connections_number); * return true on success. * return false if ip_port is invalid. */ -bool ip_port_to_tcp_connections_number(non_null() const IP_Port *ip_port, non_null() unsigned int *tcp_connections_number); +bool ip_port_to_tcp_connections_number(const IP_Port *_Nonnull ip_port, unsigned int *_Nonnull tcp_connections_number); /** @brief Create a new TCP connection to public_key. * @@ -193,13 +193,13 @@ bool ip_port_to_tcp_connections_number(non_null() const IP_Port *ip_port, non_nu * return connections_number on success. * return -1 on failure. */ -int new_tcp_connection_to(non_null() TCP_Connections *tcp_c, non_null() const uint8_t *public_key, int id); +int new_tcp_connection_to(TCP_Connections *_Nonnull tcp_c, const uint8_t *_Nonnull public_key, int id); /** * @retval 0 on success. * @retval -1 on failure. */ -int kill_tcp_connection_to(non_null() TCP_Connections *tcp_c, int connections_number); +int kill_tcp_connection_to(TCP_Connections *_Nonnull tcp_c, int connections_number); /** @brief Set connection status. * @@ -211,13 +211,13 @@ int kill_tcp_connection_to(non_null() TCP_Connections *tcp_c, int connections_nu * return 0 on success. * return -1 on failure. */ -int set_tcp_connection_to_status(non_null() const TCP_Connections *tcp_c, int connections_number, bool status); +int set_tcp_connection_to_status(const TCP_Connections *_Nonnull tcp_c, int connections_number, bool status); /** * @return number of online tcp relays tied to the connection on success. * @retval 0 on failure. */ -uint32_t tcp_connection_to_online_tcp_relays(non_null() const TCP_Connections *tcp_c, int connections_number); +uint32_t tcp_connection_to_online_tcp_relays(const TCP_Connections *_Nonnull tcp_c, int connections_number); /** @brief Add a TCP relay tied to a connection. * @@ -226,7 +226,7 @@ uint32_t tcp_connection_to_online_tcp_relays(non_null() const TCP_Connections *t * return 0 on success. * return -1 on failure. */ -int add_tcp_number_relay_connection(non_null() const TCP_Connections *tcp_c, int connections_number, unsigned int tcp_connections_number); +int add_tcp_number_relay_connection(const TCP_Connections *_Nonnull tcp_c, int connections_number, unsigned int tcp_connections_number); /** @brief Add a TCP relay tied to a connection. * @@ -235,14 +235,14 @@ int add_tcp_number_relay_connection(non_null() const TCP_Connections *tcp_c, int * return 0 on success. * return -1 on failure. */ -int add_tcp_relay_connection(non_null() TCP_Connections *tcp_c, int connections_number, non_null() const IP_Port *ip_port, non_null() const uint8_t *relay_pk); +int add_tcp_relay_connection(TCP_Connections *_Nonnull tcp_c, int connections_number, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull relay_pk); /** @brief Add a TCP relay to the TCP_Connections instance. * * return 0 on success. * return -1 on failure. */ -int add_tcp_relay_global(non_null() TCP_Connections *tcp_c, non_null() const IP_Port *ip_port, non_null() const uint8_t *relay_pk); +int add_tcp_relay_global(TCP_Connections *_Nonnull tcp_c, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull relay_pk); /** @brief Copy a maximum of max_num TCP relays we are connected to to tcp_relays. * @@ -251,7 +251,7 @@ int add_tcp_relay_global(non_null() TCP_Connections *tcp_c, non_null() const IP_ * return number of relays copied to tcp_relays on success. * return 0 on failure. */ -uint32_t tcp_copy_connected_relays(non_null() const TCP_Connections *tcp_c, non_null() Node_format *tcp_relays, uint16_t max_num); +uint32_t tcp_copy_connected_relays(const TCP_Connections *_Nonnull tcp_c, Node_format *_Nonnull tcp_relays, uint16_t max_num); /** @brief Copy a maximum of `max_num` TCP relays we are connected to starting at idx. * @@ -260,7 +260,7 @@ uint32_t tcp_copy_connected_relays(non_null() const TCP_Connections *tcp_c, non_ * * Returns the number of relays successfully copied. */ -uint32_t tcp_copy_connected_relays_index(non_null() const TCP_Connections *tcp_c, non_null() Node_format *tcp_relays, uint16_t max_num, uint32_t idx); +uint32_t tcp_copy_connected_relays_index(const TCP_Connections *_Nonnull tcp_c, Node_format *_Nonnull tcp_relays, uint16_t max_num, uint32_t idx); /** @brief Returns a new TCP_Connections object associated with the secret_key. * @@ -269,11 +269,11 @@ uint32_t tcp_copy_connected_relays_index(non_null() const TCP_Connections *tcp_c * * Returns NULL on failure. */ -TCP_Connections *new_tcp_connections(non_null() const Logger *logger, non_null() const Memory *mem, non_null() const Random *rng, non_null() const Network *ns, non_null() Mono_Time *mono_time, - non_null() const uint8_t *secret_key, non_null() const TCP_Proxy_Info *proxy_info, non_null() Net_Profile *tcp_np); +TCP_Connections *_Nullable new_tcp_connections(const Logger *_Nonnull logger, const Memory *_Nonnull mem, const Random *_Nonnull rng, const Network *_Nonnull ns, Mono_Time *_Nonnull mono_time, + const uint8_t *_Nonnull secret_key, const TCP_Proxy_Info *_Nonnull proxy_info, Net_Profile *_Nonnull tcp_np); -int kill_tcp_relay_connection(non_null() TCP_Connections *tcp_c, int tcp_connections_number); +int kill_tcp_relay_connection(TCP_Connections *_Nonnull tcp_c, int tcp_connections_number); -void do_tcp_connections(non_null() const Logger *logger, non_null() TCP_Connections *tcp_c, nullable() void *userdata); -void kill_tcp_connections(nullable() TCP_Connections *tcp_c); +void do_tcp_connections(const Logger *_Nonnull logger, TCP_Connections *_Nonnull tcp_c, void *_Nullable userdata); +void kill_tcp_connections(TCP_Connections *_Nullable tcp_c); #endif /* C_TOXCORE_TOXCORE_TCP_CONNECTION_H */ diff --git a/toxcore/TCP_server.c b/toxcore/TCP_server.c index 7e0e62f17..ce2550b4d 100644 --- a/toxcore/TCP_server.c +++ b/toxcore/TCP_server.c @@ -122,7 +122,7 @@ size_t tcp_server_listen_count(const TCP_Server *tcp_server) * @retval -1 on failure * @retval 0 on success. */ -static int alloc_new_connections(non_null() TCP_Server *tcp_server, uint32_t num) +static int alloc_new_connections(TCP_Server *_Nonnull tcp_server, uint32_t num) { const uint32_t new_size = tcp_server->size_accepted_connections + num; @@ -148,7 +148,7 @@ static int alloc_new_connections(non_null() TCP_Server *tcp_server, uint32_t num return 0; } -static void wipe_secure_connection(non_null() TCP_Secure_Connection *con) +static void wipe_secure_connection(TCP_Secure_Connection *_Nonnull con) { if (con->status != 0) { wipe_priority_list(con->con.mem, con->con.priority_queue_start); @@ -156,13 +156,13 @@ static void wipe_secure_connection(non_null() TCP_Secure_Connection *con) } } -static void move_secure_connection(non_null() TCP_Secure_Connection *con_new, non_null() TCP_Secure_Connection *con_old) +static void move_secure_connection(TCP_Secure_Connection *_Nonnull con_new, TCP_Secure_Connection *_Nonnull con_old) { *con_new = *con_old; crypto_memzero(con_old, sizeof(TCP_Secure_Connection)); } -static void free_accepted_connection_array(non_null() TCP_Server *tcp_server) +static void free_accepted_connection_array(TCP_Server *_Nonnull tcp_server) { if (tcp_server->accepted_connection_array == nullptr) { return; @@ -181,19 +181,19 @@ static void free_accepted_connection_array(non_null() TCP_Server *tcp_server) * @return index corresponding to connection with peer on success * @retval -1 on failure. */ -static int get_tcp_connection_index(non_null() const TCP_Server *tcp_server, non_null() const uint8_t *public_key) +static int get_tcp_connection_index(const TCP_Server *_Nonnull tcp_server, const uint8_t *_Nonnull public_key) { return bs_list_find(&tcp_server->accepted_key_list, public_key); } -static int kill_accepted(non_null() TCP_Server *tcp_server, int index); +static int kill_accepted(TCP_Server *_Nonnull tcp_server, int index); /** @brief Add accepted TCP connection to the list. * * @return index on success * @retval -1 on failure */ -static int add_accepted(non_null() TCP_Server *tcp_server, non_null() const Mono_Time *mono_time, non_null() TCP_Secure_Connection *con) +static int add_accepted(TCP_Server *_Nonnull tcp_server, const Mono_Time *_Nonnull mono_time, TCP_Secure_Connection *_Nonnull con) { int index = get_tcp_connection_index(tcp_server, con->public_key); @@ -243,7 +243,7 @@ static int add_accepted(non_null() TCP_Server *tcp_server, non_null() const Mono * @retval 0 on success * @retval -1 on failure */ -static int del_accepted(non_null() TCP_Server *tcp_server, int index) +static int del_accepted(TCP_Server *_Nonnull tcp_server, int index) { if ((uint32_t)index >= tcp_server->size_accepted_connections) { return -1; @@ -268,7 +268,7 @@ static int del_accepted(non_null() TCP_Server *tcp_server, int index) } /** Kill a TCP_Secure_Connection */ -static void kill_tcp_secure_connection(nullable() TCP_Secure_Connection *con) +static void kill_tcp_secure_connection(TCP_Secure_Connection *_Nullable con) { if (con == nullptr) { return; @@ -278,7 +278,7 @@ static void kill_tcp_secure_connection(nullable() TCP_Secure_Connection *con) wipe_secure_connection(con); } -static int rm_connection_index(non_null() TCP_Server *tcp_server, non_null() TCP_Secure_Connection *con, uint8_t con_number); +static int rm_connection_index(TCP_Server *_Nonnull tcp_server, TCP_Secure_Connection *_Nonnull con, uint8_t con_number); /** @brief Kill an accepted TCP_Secure_Connection * @@ -309,7 +309,7 @@ static int kill_accepted(TCP_Server *tcp_server, int index) * @retval 1 if everything went well. * @retval -1 if the connection must be killed. */ -static int handle_tcp_handshake(non_null() const Logger *logger, non_null() TCP_Secure_Connection *con, non_null() const uint8_t *data, uint16_t length, non_null() const uint8_t *self_secret_key) +static int handle_tcp_handshake(const Logger *_Nonnull logger, TCP_Secure_Connection *_Nonnull con, const uint8_t *_Nonnull data, uint16_t length, const uint8_t *_Nonnull self_secret_key) { if (length != TCP_CLIENT_HANDSHAKE_SIZE) { LOGGER_ERROR(logger, "invalid handshake length: %d != %d", length, TCP_CLIENT_HANDSHAKE_SIZE); @@ -372,7 +372,7 @@ static int handle_tcp_handshake(non_null() const Logger *logger, non_null() TCP_ * @retval 0 if we didn't get it yet. * @retval -1 if the connection must be killed. */ -static int read_connection_handshake(non_null() const Logger *logger, non_null() TCP_Secure_Connection *con, non_null() const uint8_t *self_secret_key) +static int read_connection_handshake(const Logger *_Nonnull logger, TCP_Secure_Connection *_Nonnull con, const uint8_t *_Nonnull self_secret_key) { uint8_t data[TCP_CLIENT_HANDSHAKE_SIZE]; const int len = read_tcp_packet(logger, con->con.mem, con->con.ns, con->con.sock, data, TCP_CLIENT_HANDSHAKE_SIZE, &con->con.ip_port); @@ -390,7 +390,7 @@ static int read_connection_handshake(non_null() const Logger *logger, non_null() * @retval 0 if could not send packet. * @retval -1 on failure (connection must be killed). */ -static int send_routing_response(non_null() const Logger *logger, non_null() TCP_Secure_Connection *con, uint8_t rpid, non_null() const uint8_t *public_key) +static int send_routing_response(const Logger *_Nonnull logger, TCP_Secure_Connection *_Nonnull con, uint8_t rpid, const uint8_t *_Nonnull public_key) { uint8_t data[2 + CRYPTO_PUBLIC_KEY_SIZE]; data[0] = TCP_PACKET_ROUTING_RESPONSE; @@ -405,7 +405,7 @@ static int send_routing_response(non_null() const Logger *logger, non_null() TCP * @retval 0 if could not send packet. * @retval -1 on failure (connection must be killed). */ -static int send_connect_notification(non_null() const Logger *logger, non_null() TCP_Secure_Connection *con, uint8_t id) +static int send_connect_notification(const Logger *_Nonnull logger, TCP_Secure_Connection *_Nonnull con, uint8_t id) { uint8_t data[2] = {TCP_PACKET_CONNECTION_NOTIFICATION, (uint8_t)(id + NUM_RESERVED_PORTS)}; return write_packet_tcp_secure_connection(logger, &con->con, data, sizeof(data), true); @@ -416,7 +416,7 @@ static int send_connect_notification(non_null() const Logger *logger, non_null() * @retval 0 if could not send packet. * @retval -1 on failure (connection must be killed). */ -static int send_disconnect_notification(non_null() const Logger *logger, non_null() TCP_Secure_Connection *con, uint8_t id) +static int send_disconnect_notification(const Logger *_Nonnull logger, TCP_Secure_Connection *_Nonnull con, uint8_t id) { uint8_t data[2] = {TCP_PACKET_DISCONNECT_NOTIFICATION, (uint8_t)(id + NUM_RESERVED_PORTS)}; return write_packet_tcp_secure_connection(logger, &con->con, data, sizeof(data), true); @@ -426,7 +426,7 @@ static int send_disconnect_notification(non_null() const Logger *logger, non_nul * @retval 0 on success. * @retval -1 on failure (connection must be killed). */ -static int handle_tcp_routing_req(non_null() TCP_Server *tcp_server, uint32_t con_id, non_null() const uint8_t *public_key) +static int handle_tcp_routing_req(TCP_Server *_Nonnull tcp_server, uint32_t con_id, const uint8_t *_Nonnull public_key) { uint32_t index = -1; TCP_Secure_Connection *con = &tcp_server->accepted_connection_array[con_id]; @@ -508,7 +508,7 @@ static int handle_tcp_routing_req(non_null() TCP_Server *tcp_server, uint32_t co * @retval 0 on success. * @retval -1 on failure (connection must be killed). */ -static int handle_tcp_oob_send(non_null() TCP_Server *tcp_server, uint32_t con_id, non_null() const uint8_t *public_key, non_null() const uint8_t *data, uint16_t length) +static int handle_tcp_oob_send(TCP_Server *_Nonnull tcp_server, uint32_t con_id, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull data, uint16_t length) { if (length == 0 || length > TCP_MAX_OOB_DATA_LENGTH) { return -1; @@ -586,7 +586,7 @@ static IP_Port con_id_to_ip_port(uint32_t con_id, uint64_t identifier) * @retval true on success. * @retval false if ip_port is invalid. */ -static bool ip_port_to_con_id(non_null() const TCP_Server *tcp_server, non_null() const IP_Port *ip_port, non_null() uint32_t *con_id) +static bool ip_port_to_con_id(const TCP_Server *_Nonnull tcp_server, const IP_Port *_Nonnull ip_port, uint32_t *_Nonnull con_id) { *con_id = ip_port->ip.ip.v6.uint32[0]; @@ -595,7 +595,7 @@ static bool ip_port_to_con_id(non_null() const TCP_Server *tcp_server, non_null( tcp_server->accepted_connection_array[*con_id].identifier == ip_port->ip.ip.v6.uint64[1]; } -static int handle_onion_recv_1(non_null() void *object, non_null() const IP_Port *dest, non_null() const uint8_t *data, uint16_t length) +static int handle_onion_recv_1(void *_Nonnull object, const IP_Port *_Nonnull dest, const uint8_t *_Nonnull data, uint16_t length) { TCP_Server *tcp_server = (TCP_Server *)object; uint32_t index; @@ -618,7 +618,7 @@ static int handle_onion_recv_1(non_null() void *object, non_null() const IP_Port return 0; } -static bool handle_forward_reply_tcp(non_null() void *object, non_null() const uint8_t *sendback_data, uint16_t sendback_data_len, non_null() const uint8_t *data, uint16_t length) +static bool handle_forward_reply_tcp(void *_Nonnull object, const uint8_t *_Nonnull sendback_data, uint16_t sendback_data_len, const uint8_t *_Nonnull data, uint16_t length) { TCP_Server *tcp_server = (TCP_Server *)object; @@ -657,7 +657,7 @@ static bool handle_forward_reply_tcp(non_null() void *object, non_null() const u * @retval 0 on success * @retval -1 on failure */ -static int handle_tcp_packet(non_null() TCP_Server *tcp_server, uint32_t con_id, non_null() const uint8_t *data, uint16_t length) +static int handle_tcp_packet(TCP_Server *_Nonnull tcp_server, uint32_t con_id, const uint8_t *_Nonnull data, uint16_t length) { if (length == 0) { return -1; @@ -833,7 +833,7 @@ static int handle_tcp_packet(non_null() TCP_Server *tcp_server, uint32_t con_id, return 0; } -static int confirm_tcp_connection(non_null() TCP_Server *tcp_server, non_null() const Mono_Time *mono_time, non_null() TCP_Secure_Connection *con, non_null() const uint8_t *data, uint16_t length) +static int confirm_tcp_connection(TCP_Server *_Nonnull tcp_server, const Mono_Time *_Nonnull mono_time, TCP_Secure_Connection *_Nonnull con, const uint8_t *_Nonnull data, uint16_t length) { const int index = add_accepted(tcp_server, mono_time, con); @@ -859,7 +859,7 @@ static int confirm_tcp_connection(non_null() TCP_Server *tcp_server, non_null() * @return index on success * @retval -1 on failure */ -static int accept_connection(non_null() TCP_Server *tcp_server, Socket sock) +static int accept_connection(TCP_Server *_Nonnull tcp_server, Socket sock) { if (!sock_valid(sock)) { return -1; @@ -895,7 +895,7 @@ static int accept_connection(non_null() TCP_Server *tcp_server, Socket sock) return index; } -static Socket new_listening_tcp_socket(non_null() const Logger *logger, non_null() const Memory *mem, non_null() const Network *ns, Family family, uint16_t port) +static Socket new_listening_tcp_socket(const Logger *_Nonnull logger, const Memory *_Nonnull mem, const Network *_Nonnull ns, Family family, uint16_t port) { const Socket sock = net_socket(ns, family, TOX_SOCK_STREAM, TOX_PROTO_TCP); @@ -1037,7 +1037,7 @@ TCP_Server *new_tcp_server(const Logger *logger, const Memory *mem, const Random } #ifndef TCP_SERVER_USE_EPOLL -static void do_tcp_accept_new(non_null() TCP_Server *tcp_server) +static void do_tcp_accept_new(TCP_Server *_Nonnull tcp_server) { for (uint32_t sock_idx = 0; sock_idx < tcp_server->num_listening_socks; ++sock_idx) { @@ -1052,7 +1052,7 @@ static void do_tcp_accept_new(non_null() TCP_Server *tcp_server) } #endif /* TCP_SERVER_USE_EPOLL */ -static int do_incoming(non_null() TCP_Server *tcp_server, uint32_t i) +static int do_incoming(TCP_Server *_Nonnull tcp_server, uint32_t i) { TCP_Secure_Connection *const conn = &tcp_server->incoming_connection_queue[i]; @@ -1089,7 +1089,7 @@ static int do_incoming(non_null() TCP_Server *tcp_server, uint32_t i) return index_new; } -static int do_unconfirmed(non_null() TCP_Server *tcp_server, non_null() const Mono_Time *mono_time, uint32_t i) +static int do_unconfirmed(TCP_Server *_Nonnull tcp_server, const Mono_Time *_Nonnull mono_time, uint32_t i) { TCP_Secure_Connection *const conn = &tcp_server->unconfirmed_connection_queue[i]; @@ -1115,7 +1115,7 @@ static int do_unconfirmed(non_null() TCP_Server *tcp_server, non_null() const Mo return confirm_tcp_connection(tcp_server, mono_time, conn, packet, len); } -static bool tcp_process_secure_packet(non_null() TCP_Server *tcp_server, uint32_t i) +static bool tcp_process_secure_packet(TCP_Server *_Nonnull tcp_server, uint32_t i) { TCP_Secure_Connection *const conn = &tcp_server->accepted_connection_array[i]; @@ -1142,7 +1142,7 @@ static bool tcp_process_secure_packet(non_null() TCP_Server *tcp_server, uint32_ return true; } -static void do_confirmed_recv(non_null() TCP_Server *tcp_server, uint32_t i) +static void do_confirmed_recv(TCP_Server *_Nonnull tcp_server, uint32_t i) { while (tcp_process_secure_packet(tcp_server, i)) { /* Keep reading until an error occurs or there is no more data to read. */ @@ -1150,14 +1150,14 @@ static void do_confirmed_recv(non_null() TCP_Server *tcp_server, uint32_t i) } #ifndef TCP_SERVER_USE_EPOLL -static void do_tcp_incoming(non_null() TCP_Server *tcp_server) +static void do_tcp_incoming(TCP_Server *_Nonnull tcp_server) { for (uint32_t i = 0; i < MAX_INCOMING_CONNECTIONS; ++i) { do_incoming(tcp_server, i); } } -static void do_tcp_unconfirmed(non_null() TCP_Server *tcp_server, non_null() const Mono_Time *mono_time) +static void do_tcp_unconfirmed(TCP_Server *_Nonnull tcp_server, const Mono_Time *_Nonnull mono_time) { for (uint32_t i = 0; i < MAX_INCOMING_CONNECTIONS; ++i) { do_unconfirmed(tcp_server, mono_time, i); @@ -1165,7 +1165,7 @@ static void do_tcp_unconfirmed(non_null() TCP_Server *tcp_server, non_null() con } #endif /* TCP_SERVER_USE_EPOLL */ -static void do_tcp_confirmed(non_null() TCP_Server *tcp_server, non_null() const Mono_Time *mono_time) +static void do_tcp_confirmed(TCP_Server *_Nonnull tcp_server, const Mono_Time *_Nonnull mono_time) { #ifdef TCP_SERVER_USE_EPOLL @@ -1222,7 +1222,7 @@ static void do_tcp_confirmed(non_null() TCP_Server *tcp_server, non_null() const } #ifdef TCP_SERVER_USE_EPOLL -static bool tcp_epoll_process(non_null() TCP_Server *tcp_server, non_null() const Mono_Time *mono_time) +static bool tcp_epoll_process(TCP_Server *_Nonnull tcp_server, const Mono_Time *_Nonnull mono_time) { #define MAX_EVENTS 16 struct epoll_event events[MAX_EVENTS]; @@ -1347,7 +1347,7 @@ static bool tcp_epoll_process(non_null() TCP_Server *tcp_server, non_null() cons return nfds > 0; } -static void do_tcp_epoll(non_null() TCP_Server *tcp_server, non_null() const Mono_Time *mono_time) +static void do_tcp_epoll(TCP_Server *_Nonnull tcp_server, const Mono_Time *_Nonnull mono_time) { while (tcp_epoll_process(tcp_server, mono_time)) { // Keep processing packets until there are no more FDs ready for reading. diff --git a/toxcore/TCP_server.h b/toxcore/TCP_server.h index 05071a36e..088c0f896 100644 --- a/toxcore/TCP_server.h +++ b/toxcore/TCP_server.h @@ -34,21 +34,21 @@ typedef enum TCP_Status { typedef struct TCP_Server TCP_Server; -const uint8_t *tcp_server_public_key(non_null() const TCP_Server *tcp_server); -size_t tcp_server_listen_count(non_null() const TCP_Server *tcp_server); +const uint8_t *_Nonnull tcp_server_public_key(const TCP_Server *_Nonnull tcp_server); +size_t tcp_server_listen_count(const TCP_Server *_Nonnull tcp_server); /** Create new TCP server instance. */ -TCP_Server *new_tcp_server(non_null() const Logger *logger, non_null() const Memory *mem, non_null() const Random *rng, non_null() const Network *ns, - bool ipv6_enabled, uint16_t num_sockets, non_null() const uint16_t *ports, - non_null() const uint8_t *secret_key, nullable() Onion *onion, nullable() Forwarding *forwarding); +TCP_Server *_Nullable new_tcp_server(const Logger *_Nonnull logger, const Memory *_Nonnull mem, const Random *_Nonnull rng, const Network *_Nonnull ns, + bool ipv6_enabled, uint16_t num_sockets, const uint16_t *_Nonnull ports, + const uint8_t *_Nonnull secret_key, Onion *_Nullable onion, Forwarding *_Nullable forwarding); /** Run the TCP_server */ -void do_tcp_server(non_null() TCP_Server *tcp_server, non_null() const Mono_Time *mono_time); +void do_tcp_server(TCP_Server *_Nonnull tcp_server, const Mono_Time *_Nonnull mono_time); /** Kill the TCP server */ -void kill_tcp_server(nullable() TCP_Server *tcp_server); +void kill_tcp_server(TCP_Server *_Nullable tcp_server); /** @brief Returns a pointer to the net profile associated with `tcp_server`. * * Returns null if `tcp_server` is null. */ -const Net_Profile *tcp_server_get_net_profile(nullable() const TCP_Server *tcp_server); +const Net_Profile *_Nullable tcp_server_get_net_profile(const TCP_Server *_Nullable tcp_server); #endif /* C_TOXCORE_TOXCORE_TCP_SERVER_H */ diff --git a/toxcore/announce.c b/toxcore/announce.c index 90718656e..b8dfb5662 100644 --- a/toxcore/announce.c +++ b/toxcore/announce.c @@ -85,18 +85,18 @@ void announce_set_synch_offset(Announcements *announce, int32_t synch_offset) * An entry is considered to be "deleted" for the purposes of the protocol * once it has timed out. */ -static bool entry_is_empty(non_null() const Announcements *announce, non_null() const Announce_Entry *entry) +static bool entry_is_empty(const Announcements *_Nonnull announce, const Announce_Entry *_Nonnull entry) { return mono_time_get(announce->mono_time) >= entry->store_until; } -static void delete_entry(non_null() Announce_Entry *entry) +static void delete_entry(Announce_Entry *_Nonnull entry) { entry->store_until = 0; } /** Return bits (at most 8) from pk starting at index as uint8_t */ -static uint8_t truncate_pk_at_index(non_null() const uint8_t *pk, uint16_t index, uint16_t bits) +static uint8_t truncate_pk_at_index(const uint8_t *_Nonnull pk, uint16_t index, uint16_t bits) { assert(bits < 8); const uint8_t i = index / 8; @@ -113,12 +113,12 @@ uint16_t announce_get_bucketnum(const uint8_t *base, const uint8_t *pk) truncate_pk_at_index(pk, index + 1, ANNOUNCE_BUCKET_PREFIX_LENGTH); } -static Announce_Entry *bucket_of_key(non_null() Announcements *announce, non_null() const uint8_t *pk) +static Announce_Entry *bucket_of_key(Announcements *_Nonnull announce, const uint8_t *_Nonnull pk) { return &announce->entries[announce_get_bucketnum(announce->public_key, pk) * ANNOUNCE_BUCKET_SIZE]; } -static Announce_Entry *get_stored(non_null() Announcements *announce, non_null() const uint8_t *data_public_key) +static Announce_Entry *get_stored(Announcements *_Nonnull announce, const uint8_t *_Nonnull data_public_key) { Announce_Entry *const bucket = bucket_of_key(announce, data_public_key); @@ -135,12 +135,12 @@ static Announce_Entry *get_stored(non_null() Announcements *announce, non_null() return nullptr; } -static const Announce_Entry *bucket_of_key_const(non_null() const Announcements *announce, non_null() const uint8_t *pk) +static const Announce_Entry *bucket_of_key_const(const Announcements *_Nonnull announce, const uint8_t *_Nonnull pk) { return &announce->entries[announce_get_bucketnum(announce->public_key, pk) * ANNOUNCE_BUCKET_SIZE]; } -static const Announce_Entry *get_stored_const(non_null() const Announcements *announce, non_null() const uint8_t *data_public_key) +static const Announce_Entry *get_stored_const(const Announcements *_Nonnull announce, const uint8_t *_Nonnull data_public_key) { const Announce_Entry *const bucket = bucket_of_key_const(announce, data_public_key); @@ -179,7 +179,7 @@ bool announce_on_stored(const Announcements *announce, const uint8_t *data_publi * of greatest 2-adic distance greater than that of the key bucket if one * exists, else nullptr. */ -static Announce_Entry *find_entry_slot(non_null() Announcements *announce, non_null() const uint8_t *data_public_key) +static Announce_Entry *find_entry_slot(Announcements *_Nonnull announce, const uint8_t *_Nonnull data_public_key) { Announce_Entry *const bucket = bucket_of_key(announce, data_public_key); @@ -208,7 +208,7 @@ static Announce_Entry *find_entry_slot(non_null() Announcements *announce, non_n return slot; } -static bool would_accept_store_request(non_null() Announcements *announce, non_null() const uint8_t *data_public_key) +static bool would_accept_store_request(Announcements *_Nonnull announce, const uint8_t *_Nonnull data_public_key) { return find_entry_slot(announce, data_public_key) != nullptr; } @@ -249,7 +249,7 @@ bool announce_store_data(Announcements *announce, const uint8_t *data_public_key return true; } -static uint32_t calculate_timeout(non_null() const Announcements *announce, uint32_t requested_timeout) +static uint32_t calculate_timeout(const Announcements *_Nonnull announce, uint32_t requested_timeout) { const uint64_t uptime = mono_time_get(announce->mono_time) - announce->start_time; const uint32_t max_announcement_timeout = max_u32( @@ -263,10 +263,10 @@ static uint32_t calculate_timeout(non_null() const Announcements *announce, uint #define DATA_SEARCH_TO_AUTH_MAX_SIZE (CRYPTO_PUBLIC_KEY_SIZE * 2 + MAX_PACKED_IPPORT_SIZE + MAX_SENDBACK_SIZE) -static int create_data_search_to_auth(non_null() const Logger *logger, non_null() const uint8_t *data_public_key, - non_null() const uint8_t *requester_key, - non_null() const IP_Port *source, nullable() const uint8_t *sendback, uint16_t sendback_length, - non_null() uint8_t *dest, uint16_t max_length) +static int create_data_search_to_auth(const Logger *_Nonnull logger, const uint8_t *_Nonnull data_public_key, + const uint8_t *_Nonnull requester_key, + const IP_Port *_Nonnull source, const uint8_t *_Nullable sendback, uint16_t sendback_length, + uint8_t *_Nonnull dest, uint16_t max_length) { if (max_length < DATA_SEARCH_TO_AUTH_MAX_SIZE || sendback_length > MAX_SENDBACK_SIZE) { @@ -292,8 +292,8 @@ static int create_data_search_to_auth(non_null() const Logger *logger, non_null( #define DATA_SEARCH_TIMEOUT 60 -static int create_reply_plain_data_search_request(non_null() Announcements *announce, non_null() const IP_Port *source, non_null() const uint8_t *data, uint16_t length, non_null() uint8_t *reply, - uint16_t reply_max_length, non_null() const uint8_t *to_auth, uint16_t to_auth_length) +static int create_reply_plain_data_search_request(Announcements *_Nonnull announce, const IP_Port *_Nonnull source, const uint8_t *_Nonnull data, uint16_t length, uint8_t *_Nonnull reply, + uint16_t reply_max_length, const uint8_t *_Nonnull to_auth, uint16_t to_auth_length) { if (length != CRYPTO_PUBLIC_KEY_SIZE && length != CRYPTO_PUBLIC_KEY_SIZE + CRYPTO_SHA256_SIZE) { @@ -367,8 +367,8 @@ static int create_reply_plain_data_search_request(non_null() Announcements *anno return reply_len; } -static int create_reply_plain_data_retrieve_request(non_null() const Announcements *announce, non_null() const IP_Port *source, non_null() const uint8_t *data, uint16_t length, - non_null() uint8_t *reply, uint16_t reply_max_length, non_null() const uint8_t *to_auth, uint16_t to_auth_length) +static int create_reply_plain_data_retrieve_request(const Announcements *_Nonnull announce, const IP_Port *_Nonnull source, const uint8_t *_Nonnull data, uint16_t length, + uint8_t *_Nonnull reply, uint16_t reply_max_length, const uint8_t *_Nonnull to_auth, uint16_t to_auth_length) { if (length != CRYPTO_PUBLIC_KEY_SIZE + 1 + TIMED_AUTH_SIZE) { return -1; @@ -405,8 +405,8 @@ static int create_reply_plain_data_retrieve_request(non_null() const Announcemen return reply_len; } -static int create_reply_plain_store_announce_request(non_null() Announcements *announce, non_null() const IP_Port *source, non_null() const uint8_t *data, uint16_t length, non_null() uint8_t *reply, - uint16_t reply_max_length, non_null() const uint8_t *to_auth, uint16_t to_auth_length) +static int create_reply_plain_store_announce_request(Announcements *_Nonnull announce, const IP_Port *_Nonnull source, const uint8_t *_Nonnull data, uint16_t length, uint8_t *_Nonnull reply, + uint16_t reply_max_length, const uint8_t *_Nonnull to_auth, uint16_t to_auth_length) { const int plain_len = (int)length - (CRYPTO_PUBLIC_KEY_SIZE + CRYPTO_NONCE_SIZE + CRYPTO_MAC_SIZE); const int announcement_len = plain_len - (TIMED_AUTH_SIZE + sizeof(uint32_t) + 1); @@ -489,11 +489,11 @@ static int create_reply_plain_store_announce_request(non_null() Announcements *a return reply_len; } -static int create_reply_plain(non_null() Announcements *announce, - non_null() const uint8_t *requester_key, non_null() const IP_Port *source, uint8_t type, - nullable() const uint8_t *sendback, uint16_t sendback_length, - non_null() const uint8_t *data, uint16_t length, - non_null() uint8_t *reply, uint16_t reply_max_length) +static int create_reply_plain(Announcements *_Nonnull announce, + const uint8_t *_Nonnull requester_key, const IP_Port *_Nonnull source, uint8_t type, + const uint8_t *_Nullable sendback, uint16_t sendback_length, + const uint8_t *_Nonnull data, uint16_t length, + uint8_t *_Nonnull reply, uint16_t reply_max_length) { if (length < CRYPTO_PUBLIC_KEY_SIZE) { return -1; @@ -527,10 +527,10 @@ static int create_reply_plain(non_null() Announcements *announce, } } -static int create_reply(non_null() Announcements *announce, non_null() const IP_Port *source, - nullable() const uint8_t *sendback, uint16_t sendback_length, - non_null() const uint8_t *data, uint16_t length, - non_null() uint8_t *reply, uint16_t reply_max_length) +static int create_reply(Announcements *_Nonnull announce, const IP_Port *_Nonnull source, + const uint8_t *_Nullable sendback, uint16_t sendback_length, + const uint8_t *_Nonnull data, uint16_t length, + uint8_t *_Nonnull reply, uint16_t reply_max_length) { const int plain_len = (int)length - (1 + CRYPTO_PUBLIC_KEY_SIZE + CRYPTO_NONCE_SIZE + CRYPTO_MAC_SIZE); if (plain_len < (int)sizeof(uint64_t)) { @@ -578,9 +578,9 @@ static int create_reply(non_null() Announcements *announce, non_null() const IP_ response_type, plain_reply, plain_reply_len, reply, reply_max_length); } -static void forwarded_request_callback(non_null() void *object, non_null() const IP_Port *forwarder, - non_null() const uint8_t *sendback, uint16_t sendback_length, - non_null() const uint8_t *data, uint16_t length, nullable() void *userdata) +static void forwarded_request_callback(void *_Nonnull object, const IP_Port *_Nonnull forwarder, + const uint8_t *_Nonnull sendback, uint16_t sendback_length, + const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata) { Announcements *announce = (Announcements *) object; uint8_t reply[MAX_FORWARD_DATA_SIZE]; @@ -597,7 +597,7 @@ static void forwarded_request_callback(non_null() void *object, non_null() const } static int handle_dht_announce_request( - non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, nullable() void *userdata) + void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nullable userdata) { Announcements *announce = (Announcements *)object; uint8_t reply[MAX_FORWARD_DATA_SIZE]; diff --git a/toxcore/announce.h b/toxcore/announce.h index 3ca7a6fee..27b2f7855 100644 --- a/toxcore/announce.h +++ b/toxcore/announce.h @@ -16,35 +16,35 @@ #define MAX_ANNOUNCEMENT_SIZE 512 -typedef void announce_on_retrieve_cb(void *object, const uint8_t *data, uint16_t length); +typedef void announce_on_retrieve_cb(void *_Nullable object, const uint8_t *_Nullable data, uint16_t length); uint8_t announce_response_of_request_type(uint8_t request_type); typedef struct Announcements Announcements; -Announcements *new_announcements(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Random *rng, non_null() const Mono_Time *mono_time, non_null() Forwarding *forwarding); +Announcements *_Nullable new_announcements(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Random *_Nonnull rng, const Mono_Time *_Nonnull mono_time, Forwarding *_Nonnull forwarding); /** * @brief If data is stored, run `on_retrieve_callback` on it. * * @return true if data is stored, false otherwise. */ -bool announce_on_stored(non_null() const Announcements *announce, non_null() const uint8_t *data_public_key, - nullable() announce_on_retrieve_cb *on_retrieve_callback, nullable() void *object); -void announce_set_synch_offset(non_null() Announcements *announce, int32_t synch_offset); +bool announce_on_stored(const Announcements *_Nonnull announce, const uint8_t *_Nonnull data_public_key, + announce_on_retrieve_cb *_Nullable on_retrieve_callback, void *_Nullable object); +void announce_set_synch_offset(Announcements *_Nonnull announce, int32_t synch_offset); -void kill_announcements(nullable() Announcements *announce); +void kill_announcements(Announcements *_Nullable announce); /* The declarations below are not public, they are exposed only for tests. */ /** @private * Return xor of first ANNOUNCE_BUCKET_PREFIX_LENGTH bits from one bit after * base and pk first differ */ -uint16_t announce_get_bucketnum(non_null() const uint8_t *base, non_null() const uint8_t *pk); +uint16_t announce_get_bucketnum(const uint8_t *_Nonnull base, const uint8_t *_Nonnull pk); /** @private */ -bool announce_store_data(non_null() Announcements *announce, non_null() const uint8_t *data_public_key, - nullable() const uint8_t *data, uint32_t length, uint32_t timeout); +bool announce_store_data(Announcements *_Nonnull announce, const uint8_t *_Nonnull data_public_key, + const uint8_t *_Nullable data, uint32_t length, uint32_t timeout); /** @private */ #define MAX_MAX_ANNOUNCEMENT_TIMEOUT 900 #define MIN_MAX_ANNOUNCEMENT_TIMEOUT 10 diff --git a/toxcore/attributes.h b/toxcore/attributes.h index 009dfa359..76d2366a4 100644 --- a/toxcore/attributes.h +++ b/toxcore/attributes.h @@ -18,14 +18,11 @@ #define GNU_PRINTF(f, a) #endif -#if defined(__GNUC__) && defined(_DEBUG) -#define non_null(...) __attribute__((__nonnull__(__VA_ARGS__))) -#else -#define non_null(...) +#ifndef __clang__ +#define _Nonnull +#define _Nullable #endif -#define nullable(...) - #ifdef SPARSE #define bitwise __attribute__((bitwise)) #define force __attribute__((force)) diff --git a/toxcore/bin_pack.c b/toxcore/bin_pack.c index e7ad47952..595bb0dcd 100644 --- a/toxcore/bin_pack.c +++ b/toxcore/bin_pack.c @@ -19,19 +19,19 @@ struct Bin_Pack { cmp_ctx_t ctx; }; -static bool null_reader(non_null() cmp_ctx_t *ctx, non_null() void *data, size_t limit) +static bool null_reader(cmp_ctx_t *_Nonnull ctx, void *_Nonnull data, size_t limit) { assert(limit == 0); return false; } -static bool null_skipper(non_null() cmp_ctx_t *ctx, size_t count) +static bool null_skipper(cmp_ctx_t *_Nonnull ctx, size_t count) { assert(count == 0); return false; } -static size_t buf_writer(non_null() cmp_ctx_t *ctx, non_null() const void *data, size_t count) +static size_t buf_writer(cmp_ctx_t *_Nonnull ctx, const void *_Nonnull data, size_t count) { const uint8_t *bytes = (const uint8_t *)data; Bin_Pack *bp = (Bin_Pack *)ctx->buf; @@ -52,7 +52,7 @@ static size_t buf_writer(non_null() cmp_ctx_t *ctx, non_null() const void *data, return count; } -static void bin_pack_init(non_null() Bin_Pack *bp, nullable() uint8_t *buf, uint32_t buf_size) +static void bin_pack_init(Bin_Pack *_Nonnull bp, uint8_t *_Nullable buf, uint32_t buf_size) { bp->bytes = buf; bp->bytes_size = buf_size; diff --git a/toxcore/bin_pack.h b/toxcore/bin_pack.h index 0ee45a079..83c3cfaa3 100644 --- a/toxcore/bin_pack.h +++ b/toxcore/bin_pack.h @@ -44,7 +44,7 @@ typedef struct Bin_Pack Bin_Pack; * This function would typically cast the `void *` to the actual object pointer type and then call * more appropriately typed packing functions. */ -typedef bool bin_pack_cb(const void *obj, const Logger *logger, Bin_Pack *bp); +typedef bool bin_pack_cb(const void *_Nullable obj, const Logger *_Nullable logger, Bin_Pack *_Nonnull bp); /** @brief Function used to pack an array of objects. * @@ -54,7 +54,7 @@ typedef bool bin_pack_cb(const void *obj, const Logger *logger, Bin_Pack *bp); * @param arr is the object array as void pointer. * @param index is the index in the object array that is currently being packed. */ -typedef bool bin_pack_array_cb(const void *arr, uint32_t index, const Logger *logger, Bin_Pack *bp); +typedef bool bin_pack_array_cb(const void *_Nullable arr, uint32_t index, const Logger *_Nullable logger, Bin_Pack *_Nonnull bp); /** @brief Determine the serialised size of an object. * @@ -65,7 +65,7 @@ typedef bool bin_pack_array_cb(const void *arr, uint32_t index, const Logger *lo * @return The packed size of the passed object according to the callback. * @retval UINT32_MAX in case of errors such as buffer overflow. */ -uint32_t bin_pack_obj_size(non_null() bin_pack_cb *callback, nullable() const void *obj, nullable() const Logger *logger); +uint32_t bin_pack_obj_size(bin_pack_cb *_Nonnull callback, const void *_Nullable obj, const Logger *_Nullable logger); /** @brief Pack an object into a buffer of a given size. * * This function creates and initialises a `Bin_Pack` packer object, calls the callback with the @@ -86,7 +86,7 @@ uint32_t bin_pack_obj_size(non_null() bin_pack_cb *callback, nullable() const vo * * @retval false if an error occurred (e.g. buffer overflow). */ -bool bin_pack_obj(non_null() bin_pack_cb *callback, nullable() const void *obj, nullable() const Logger *logger, non_null() uint8_t *buf, uint32_t buf_size); +bool bin_pack_obj(bin_pack_cb *_Nonnull callback, const void *_Nullable obj, const Logger *_Nullable logger, uint8_t *_Nonnull buf, uint32_t buf_size); /** @brief Determine the serialised size of an object array. * * Behaves exactly like `bin_pack_obj_b_array` but doesn't write. @@ -100,7 +100,7 @@ bool bin_pack_obj(non_null() bin_pack_cb *callback, nullable() const void *obj, * @return The packed size of the passed object array according to the callback. * @retval UINT32_MAX in case of errors such as buffer overflow. */ -uint32_t bin_pack_obj_array_b_size(non_null() bin_pack_array_cb *callback, nullable() const void *arr, uint32_t arr_size, nullable() const Logger *logger); +uint32_t bin_pack_obj_array_b_size(bin_pack_array_cb *_Nonnull callback, const void *_Nullable arr, uint32_t arr_size, const Logger *_Nullable logger); /** @brief Pack an object array into a buffer of a given size. * * Similar to `bin_pack_obj_array` but does not write the array length, so @@ -118,7 +118,7 @@ uint32_t bin_pack_obj_array_b_size(non_null() bin_pack_array_cb *callback, nulla * * @retval false if an error occurred (e.g. buffer overflow). */ -bool bin_pack_obj_array_b(non_null() bin_pack_array_cb *callback, nullable() const void *arr, uint32_t arr_size, nullable() const Logger *logger, non_null() uint8_t *buf, uint32_t buf_size); +bool bin_pack_obj_array_b(bin_pack_array_cb *_Nonnull callback, const void *_Nullable arr, uint32_t arr_size, const Logger *_Nullable logger, uint8_t *_Nonnull buf, uint32_t buf_size); /** @brief Encode an object array as MessagePack array into a bin packer. * * Calls the callback `arr_size` times with increasing `index` argument from 0 to @@ -142,48 +142,48 @@ bool bin_pack_obj_array_b(non_null() bin_pack_array_cb *callback, nullable() con * * @retval false if an error occurred (e.g. buffer overflow). */ -bool bin_pack_obj_array(non_null() Bin_Pack *bp, non_null() bin_pack_array_cb *callback, nullable() const void *arr, uint32_t arr_size, nullable() const Logger *logger); +bool bin_pack_obj_array(Bin_Pack *_Nonnull bp, bin_pack_array_cb *_Nonnull callback, const void *_Nullable arr, uint32_t arr_size, const Logger *_Nullable logger); /** @brief Start packing a MessagePack array. * * A call to this function must be followed by exactly `size` calls to other functions below. */ -bool bin_pack_array(non_null() Bin_Pack *bp, uint32_t size); +bool bin_pack_array(Bin_Pack *_Nonnull bp, uint32_t size); /** @brief Pack a MessagePack bool. */ -bool bin_pack_bool(non_null() Bin_Pack *bp, bool val); +bool bin_pack_bool(Bin_Pack *_Nonnull bp, bool val); /** @brief Pack a `uint8_t` as MessagePack positive integer. */ -bool bin_pack_u08(non_null() Bin_Pack *bp, uint8_t val); +bool bin_pack_u08(Bin_Pack *_Nonnull bp, uint8_t val); /** @brief Pack a `uint16_t` as MessagePack positive integer. */ -bool bin_pack_u16(non_null() Bin_Pack *bp, uint16_t val); +bool bin_pack_u16(Bin_Pack *_Nonnull bp, uint16_t val); /** @brief Pack a `uint32_t` as MessagePack positive integer. */ -bool bin_pack_u32(non_null() Bin_Pack *bp, uint32_t val); +bool bin_pack_u32(Bin_Pack *_Nonnull bp, uint32_t val); /** @brief Pack a `uint64_t` as MessagePack positive integer. */ -bool bin_pack_u64(non_null() Bin_Pack *bp, uint64_t val); +bool bin_pack_u64(Bin_Pack *_Nonnull bp, uint64_t val); /** @brief Pack an empty array member as a MessagePack nil value. */ -bool bin_pack_nil(non_null() Bin_Pack *bp); +bool bin_pack_nil(Bin_Pack *_Nonnull bp); /** @brief Pack a byte array as MessagePack bin. */ -bool bin_pack_bin(non_null() Bin_Pack *bp, non_null() const uint8_t *data, uint32_t length); +bool bin_pack_bin(Bin_Pack *_Nonnull bp, const uint8_t *_Nonnull data, uint32_t length); /** @brief Start packing a custom binary representation. * * A call to this function must be followed by exactly `size` bytes packed by functions below. */ -bool bin_pack_bin_marker(non_null() Bin_Pack *bp, uint32_t size); +bool bin_pack_bin_marker(Bin_Pack *_Nonnull bp, uint32_t size); /** @brief Write a `uint8_t` directly to the packer in 1 byte. */ -bool bin_pack_u08_b(non_null() Bin_Pack *bp, uint8_t val); +bool bin_pack_u08_b(Bin_Pack *_Nonnull bp, uint8_t val); /** @brief Write a `uint16_t` as big endian 16 bit int in 2 bytes. */ -bool bin_pack_u16_b(non_null() Bin_Pack *bp, uint16_t val); +bool bin_pack_u16_b(Bin_Pack *_Nonnull bp, uint16_t val); /** @brief Write a `uint32_t` as big endian 32 bit int in 4 bytes. */ -bool bin_pack_u32_b(non_null() Bin_Pack *bp, uint32_t val); +bool bin_pack_u32_b(Bin_Pack *_Nonnull bp, uint32_t val); /** @brief Write a `uint64_t` as big endian 64 bit int in 8 bytes. */ -bool bin_pack_u64_b(non_null() Bin_Pack *bp, uint64_t val); +bool bin_pack_u64_b(Bin_Pack *_Nonnull bp, uint64_t val); /** @brief Write a byte array directly to the packer in `length` bytes. * * Note that unless you prepend the array length manually, there is no record of it in the resulting * serialised representation. */ -bool bin_pack_bin_b(non_null() Bin_Pack *bp, non_null() const uint8_t *data, uint32_t length); +bool bin_pack_bin_b(Bin_Pack *_Nonnull bp, const uint8_t *_Nonnull data, uint32_t length); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/bin_unpack.c b/toxcore/bin_unpack.c index a52e37d25..dfbb8cc7a 100644 --- a/toxcore/bin_unpack.c +++ b/toxcore/bin_unpack.c @@ -20,7 +20,7 @@ struct Bin_Unpack { cmp_ctx_t ctx; }; -static bool buf_reader(non_null() cmp_ctx_t *ctx, non_null() void *data, size_t limit) +static bool buf_reader(cmp_ctx_t *_Nonnull ctx, void *_Nonnull data, size_t limit) { uint8_t *bytes = (uint8_t *)data; Bin_Unpack *reader = (Bin_Unpack *)ctx->buf; @@ -34,7 +34,7 @@ static bool buf_reader(non_null() cmp_ctx_t *ctx, non_null() void *data, size_t return true; } -static bool buf_skipper(non_null() cmp_ctx_t *ctx, size_t count) +static bool buf_skipper(cmp_ctx_t *_Nonnull ctx, size_t count) { Bin_Unpack *reader = (Bin_Unpack *)ctx->buf; assert(reader != nullptr && reader->bytes != nullptr); @@ -46,13 +46,13 @@ static bool buf_skipper(non_null() cmp_ctx_t *ctx, size_t count) return true; } -static size_t null_writer(non_null() cmp_ctx_t *ctx, non_null() const void *data, size_t count) +static size_t null_writer(cmp_ctx_t *_Nonnull ctx, const void *_Nonnull data, size_t count) { assert(count == 0); return 0; } -static void bin_unpack_init(non_null() Bin_Unpack *bu, non_null() const Memory *mem, non_null() const uint8_t *buf, uint32_t buf_size) +static void bin_unpack_init(Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem, const uint8_t *_Nonnull buf, uint32_t buf_size) { bu->mem = mem; bu->bytes = buf; diff --git a/toxcore/bin_unpack.h b/toxcore/bin_unpack.h index 4f050cc91..44bf0c934 100644 --- a/toxcore/bin_unpack.h +++ b/toxcore/bin_unpack.h @@ -29,7 +29,7 @@ typedef struct Bin_Unpack Bin_Unpack; * This function would typically cast the `void *` to the actual object pointer type and then call * more appropriately typed unpacking functions. */ -typedef bool bin_unpack_cb(void *obj, Bin_Unpack *bu); +typedef bool bin_unpack_cb(void *_Nonnull obj, Bin_Unpack *_Nonnull bu); /** @brief Unpack an object from a buffer of a given size. * @@ -46,7 +46,7 @@ typedef bool bin_unpack_cb(void *obj, Bin_Unpack *bu); * * @retval false if an error occurred (e.g. buffer overrun). */ -bool bin_unpack_obj(non_null() const Memory *mem, non_null() bin_unpack_cb *callback, non_null() void *obj, non_null() const uint8_t *buf, uint32_t buf_size); +bool bin_unpack_obj(const Memory *_Nonnull mem, bin_unpack_cb *_Nonnull callback, void *_Nonnull obj, const uint8_t *_Nonnull buf, uint32_t buf_size); /** @brief Start unpacking a MessagePack array. * @@ -54,7 +54,7 @@ bool bin_unpack_obj(non_null() const Memory *mem, non_null() bin_unpack_cb *call * * @param size Will contain the number of array elements following the array marker. */ -bool bin_unpack_array(non_null() Bin_Unpack *bu, non_null() uint32_t *size); +bool bin_unpack_array(Bin_Unpack *_Nonnull bu, uint32_t *_Nonnull size); /** @brief Start unpacking a fixed size MessagePack array. * @@ -63,19 +63,19 @@ bool bin_unpack_array(non_null() Bin_Unpack *bu, non_null() uint32_t *size); * * @retval false if the packed array size is not exactly the required size. */ -bool bin_unpack_array_fixed(non_null() Bin_Unpack *bu, uint32_t required_size, nullable() uint32_t *actual_size); +bool bin_unpack_array_fixed(Bin_Unpack *_Nonnull bu, uint32_t required_size, uint32_t *_Nullable actual_size); /** @brief Unpack a MessagePack bool. */ -bool bin_unpack_bool(non_null() Bin_Unpack *bu, non_null() bool *val); +bool bin_unpack_bool(Bin_Unpack *_Nonnull bu, bool *_Nonnull val); /** @brief Unpack a MessagePack positive int into a `uint8_t`. */ -bool bin_unpack_u08(non_null() Bin_Unpack *bu, non_null() uint8_t *val); +bool bin_unpack_u08(Bin_Unpack *_Nonnull bu, uint8_t *_Nonnull val); /** @brief Unpack a MessagePack positive int into a `uint16_t`. */ -bool bin_unpack_u16(non_null() Bin_Unpack *bu, non_null() uint16_t *val); +bool bin_unpack_u16(Bin_Unpack *_Nonnull bu, uint16_t *_Nonnull val); /** @brief Unpack a MessagePack positive int into a `uint32_t`. */ -bool bin_unpack_u32(non_null() Bin_Unpack *bu, non_null() uint32_t *val); +bool bin_unpack_u32(Bin_Unpack *_Nonnull bu, uint32_t *_Nonnull val); /** @brief Unpack a MessagePack positive int into a `uint64_t`. */ -bool bin_unpack_u64(non_null() Bin_Unpack *bu, non_null() uint64_t *val); +bool bin_unpack_u64(Bin_Unpack *_Nonnull bu, uint64_t *_Nonnull val); /** @brief Unpack a Messagepack nil value. */ -bool bin_unpack_nil(non_null() Bin_Unpack *bu); +bool bin_unpack_nil(Bin_Unpack *_Nonnull bu); /** @brief Unpack a MessagePack bin into a newly allocated byte array. * @@ -84,37 +84,37 @@ bool bin_unpack_nil(non_null() Bin_Unpack *bu); * remaining to be unpacked as the bin claims to need, so it's not possible to cause an arbitrarily * large allocation unless the input array was already that large. */ -bool bin_unpack_bin(non_null() Bin_Unpack *bu, non_null() uint8_t **data_ptr, non_null() uint32_t *data_length_ptr); +bool bin_unpack_bin(Bin_Unpack *_Nonnull bu, uint8_t *_Nonnull *_Nonnull data_ptr, uint32_t *_Nonnull data_length_ptr); /** @brief Unpack a variable size MessagePack bin into a fixed size byte array. * * Stores unpacked data into `data` with its length stored in `data_length_ptr`. This function does * not allocate memory and requires that `max_data_length` is less than or equal to `sizeof(arr)` * when `arr` is passed as `data` pointer. */ -bool bin_unpack_bin_max(non_null() Bin_Unpack *bu, non_null() uint8_t *data, non_null() uint16_t *data_length_ptr, uint16_t max_data_length); +bool bin_unpack_bin_max(Bin_Unpack *_Nonnull bu, uint8_t *_Nonnull data, uint16_t *_Nonnull data_length_ptr, uint16_t max_data_length); /** @brief Unpack a MessagePack bin of a fixed length into a pre-allocated byte array. * * Similar to the function above, but doesn't output the data length. */ -bool bin_unpack_bin_fixed(non_null() Bin_Unpack *bu, non_null() uint8_t *data, uint32_t data_length); +bool bin_unpack_bin_fixed(Bin_Unpack *_Nonnull bu, uint8_t *_Nonnull data, uint32_t data_length); /** @brief Start unpacking a custom binary representation. * * A call to this function must be followed by exactly `size` bytes packed by functions below. */ -bool bin_unpack_bin_size(non_null() Bin_Unpack *bu, non_null() uint32_t *size); +bool bin_unpack_bin_size(Bin_Unpack *_Nonnull bu, uint32_t *_Nonnull size); /** @brief Read a `uint8_t` directly from the unpacker, consuming 1 byte. */ -bool bin_unpack_u08_b(non_null() Bin_Unpack *bu, non_null() uint8_t *val); +bool bin_unpack_u08_b(Bin_Unpack *_Nonnull bu, uint8_t *_Nonnull val); /** @brief Read a `uint16_t` as big endian 16 bit int, consuming 2 bytes. */ -bool bin_unpack_u16_b(non_null() Bin_Unpack *bu, non_null() uint16_t *val); +bool bin_unpack_u16_b(Bin_Unpack *_Nonnull bu, uint16_t *_Nonnull val); /** @brief Read a `uint32_t` as big endian 32 bit int, consuming 4 bytes. */ -bool bin_unpack_u32_b(non_null() Bin_Unpack *bu, non_null() uint32_t *val); +bool bin_unpack_u32_b(Bin_Unpack *_Nonnull bu, uint32_t *_Nonnull val); /** @brief Read a `uint64_t` as big endian 64 bit int, consuming 8 bytes. */ -bool bin_unpack_u64_b(non_null() Bin_Unpack *bu, non_null() uint64_t *val); +bool bin_unpack_u64_b(Bin_Unpack *_Nonnull bu, uint64_t *_Nonnull val); /** @brief Read a byte array directly from the packer, consuming `length` bytes. */ -bool bin_unpack_bin_b(non_null() Bin_Unpack *bu, non_null() uint8_t *data, uint32_t length); +bool bin_unpack_bin_b(Bin_Unpack *_Nonnull bu, uint8_t *_Nonnull data, uint32_t length); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/crypto_core.c b/toxcore/crypto_core.c index f3e6d25e3..9f140aca1 100644 --- a/toxcore/crypto_core.c +++ b/toxcore/crypto_core.c @@ -88,7 +88,7 @@ const uint8_t *get_chat_id(const Extended_Public_Key *key) } #if !defined(FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION) -static uint8_t *crypto_malloc(non_null() const Memory *mem, size_t bytes) +static uint8_t *crypto_malloc(const Memory *_Nonnull mem, size_t bytes) { uint8_t *ptr = (uint8_t *)mem_balloc(mem, bytes); @@ -99,7 +99,7 @@ static uint8_t *crypto_malloc(non_null() const Memory *mem, size_t bytes) return ptr; } -static void crypto_free(non_null() const Memory *mem, nullable() uint8_t *ptr, size_t bytes) +static void crypto_free(const Memory *_Nonnull mem, uint8_t *_Nullable ptr, size_t bytes) { if (ptr != nullptr) { crypto_memzero(ptr, bytes); @@ -493,12 +493,12 @@ void crypto_sha512(uint8_t hash[CRYPTO_SHA512_SIZE], const uint8_t *data, size_t #endif /* FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION */ } -static void sys_random_bytes(non_null() void *obj, non_null() uint8_t *bytes, size_t length) +static void sys_random_bytes(void *_Nonnull obj, uint8_t *_Nonnull bytes, size_t length) { randombytes(bytes, length); } -static uint32_t sys_random_uniform(non_null() void *obj, uint32_t upper_bound) +static uint32_t sys_random_uniform(void *_Nonnull obj, uint32_t upper_bound) { return randombytes_uniform(upper_bound); } diff --git a/toxcore/crypto_core.h b/toxcore/crypto_core.h index c2784ae99..82b31e393 100644 --- a/toxcore/crypto_core.h +++ b/toxcore/crypto_core.h @@ -84,19 +84,19 @@ extern "C" { * secure pseudo-random number generator (CSPRNG). The security of Tox heavily * depends on the security of this RNG. */ -typedef void crypto_random_bytes_cb(void *obj, uint8_t *bytes, size_t length); +typedef void crypto_random_bytes_cb(void *_Nullable obj, uint8_t *_Nonnull bytes, size_t length); /** @brief Generate a random integer between 0 and @p upper_bound. * * Should produce a uniform random distribution, but Tox security does not * depend on this being correct. In principle, it could even be a non-CSPRNG. */ -typedef uint32_t crypto_random_uniform_cb(void *obj, uint32_t upper_bound); +typedef uint32_t crypto_random_uniform_cb(void *_Nullable obj, uint32_t upper_bound); /** @brief Virtual function table for Random. */ typedef struct Random_Funcs { - crypto_random_bytes_cb *random_bytes; - crypto_random_uniform_cb *random_uniform; + crypto_random_bytes_cb *_Nullable random_bytes; + crypto_random_uniform_cb *_Nullable random_uniform; } Random_Funcs; /** @brief Random number generator object. @@ -106,15 +106,15 @@ typedef struct Random_Funcs { * CSPRNG and use `os_random` below. */ typedef struct Random { - const Random_Funcs *funcs; - void *obj; + const Random_Funcs *_Nullable funcs; + void *_Nullable obj; } Random; /** @brief System random number generator. * * Uses libsodium's CSPRNG (on Linux, `/dev/urandom`). */ -const Random *os_random(void); +const Random *_Nullable os_random(void); /** * @brief The number of bytes in an encryption public key used by DHT group chats. @@ -168,21 +168,21 @@ const Random *os_random(void); * will be no reads to the written data. Use this function if you want to be * sure the memory is indeed zeroed. */ -void crypto_memzero(non_null() void *data, size_t length); +void crypto_memzero(void *_Nonnull data, size_t length); /** * @brief Compute a SHA256 hash (32 bytes). * * @param[out] hash The SHA256 hash of @p data will be written to this byte array. */ -void crypto_sha256(non_null() uint8_t hash[CRYPTO_SHA256_SIZE], non_null() const uint8_t *data, size_t length); +void crypto_sha256(uint8_t hash[_Nonnull CRYPTO_SHA256_SIZE], const uint8_t *_Nonnull data, size_t length); /** * @brief Compute a SHA512 hash (64 bytes). * * @param[out] hash The SHA512 hash of @p data will be written to this byte array. */ -void crypto_sha512(non_null() uint8_t hash[CRYPTO_SHA512_SIZE], non_null() const uint8_t *data, size_t length); +void crypto_sha512(uint8_t hash[_Nonnull CRYPTO_SHA512_SIZE], const uint8_t *_Nonnull data, size_t length); /** * @brief Compute an HMAC authenticator (32 bytes). @@ -190,12 +190,12 @@ void crypto_sha512(non_null() uint8_t hash[CRYPTO_SHA512_SIZE], non_null() const * @param[out] auth Resulting authenticator. * @param key Secret key, as generated by `new_hmac_key()`. */ -void crypto_hmac(non_null() uint8_t auth[CRYPTO_HMAC_SIZE], non_null() const uint8_t key[CRYPTO_HMAC_KEY_SIZE], non_null() const uint8_t *data, size_t length); +void crypto_hmac(uint8_t auth[_Nonnull CRYPTO_HMAC_SIZE], const uint8_t key[_Nonnull CRYPTO_HMAC_KEY_SIZE], const uint8_t *_Nonnull data, size_t length); /** * @brief Verify an HMAC authenticator. */ -bool crypto_hmac_verify(non_null() const uint8_t auth[CRYPTO_HMAC_SIZE], non_null() const uint8_t key[CRYPTO_HMAC_KEY_SIZE], non_null() const uint8_t *data, size_t length); +bool crypto_hmac_verify(const uint8_t auth[_Nonnull CRYPTO_HMAC_SIZE], const uint8_t key[_Nonnull CRYPTO_HMAC_KEY_SIZE], const uint8_t *_Nonnull data, size_t length); /** * @brief Compare 2 public keys of length @ref CRYPTO_PUBLIC_KEY_SIZE, not vulnerable to @@ -204,12 +204,12 @@ bool crypto_hmac_verify(non_null() const uint8_t auth[CRYPTO_HMAC_SIZE], non_nul * @retval true if both mem locations of length are equal * @retval false if they are not */ -bool pk_equal(non_null() const uint8_t pk1[CRYPTO_PUBLIC_KEY_SIZE], non_null() const uint8_t pk2[CRYPTO_PUBLIC_KEY_SIZE]); +bool pk_equal(const uint8_t pk1[_Nonnull CRYPTO_PUBLIC_KEY_SIZE], const uint8_t pk2[_Nonnull CRYPTO_PUBLIC_KEY_SIZE]); /** * @brief Copy a public key from `src` to `dest`. */ -void pk_copy(non_null() uint8_t dest[CRYPTO_PUBLIC_KEY_SIZE], non_null() const uint8_t src[CRYPTO_PUBLIC_KEY_SIZE]); +void pk_copy(uint8_t dest[_Nonnull CRYPTO_PUBLIC_KEY_SIZE], const uint8_t src[_Nonnull CRYPTO_PUBLIC_KEY_SIZE]); /** * @brief Compare 2 SHA512 checksums of length CRYPTO_SHA512_SIZE, not vulnerable to @@ -217,7 +217,7 @@ void pk_copy(non_null() uint8_t dest[CRYPTO_PUBLIC_KEY_SIZE], non_null() const u * * @return true if both mem locations of length are equal, false if they are not. */ -bool crypto_sha512_eq(non_null() const uint8_t cksum1[CRYPTO_SHA512_SIZE], non_null() const uint8_t cksum2[CRYPTO_SHA512_SIZE]); +bool crypto_sha512_eq(const uint8_t cksum1[_Nonnull CRYPTO_SHA512_SIZE], const uint8_t cksum2[_Nonnull CRYPTO_SHA512_SIZE]); /** * @brief Compare 2 SHA256 checksums of length CRYPTO_SHA256_SIZE, not vulnerable to @@ -225,34 +225,34 @@ bool crypto_sha512_eq(non_null() const uint8_t cksum1[CRYPTO_SHA512_SIZE], non_n * * @return true if both mem locations of length are equal, false if they are not. */ -bool crypto_sha256_eq(non_null() const uint8_t cksum1[CRYPTO_SHA256_SIZE], non_null() const uint8_t cksum2[CRYPTO_SHA256_SIZE]); +bool crypto_sha256_eq(const uint8_t cksum1[_Nonnull CRYPTO_SHA256_SIZE], const uint8_t cksum2[_Nonnull CRYPTO_SHA256_SIZE]); /** * @brief Return a random 8 bit integer. */ -uint8_t random_u08(non_null() const Random *rng); +uint8_t random_u08(const Random *_Nonnull rng); /** * @brief Return a random 16 bit integer. */ -uint16_t random_u16(non_null() const Random *rng); +uint16_t random_u16(const Random *_Nonnull rng); /** * @brief Return a random 32 bit integer. */ -uint32_t random_u32(non_null() const Random *rng); +uint32_t random_u32(const Random *_Nonnull rng); /** * @brief Return a random 64 bit integer. */ -uint64_t random_u64(non_null() const Random *rng); +uint64_t random_u64(const Random *_Nonnull rng); /** * @brief Return a random 32 bit integer between 0 and upper_bound (excluded). * * This function guarantees a uniform distribution of possible outputs. */ -uint32_t random_range_u32(non_null() const Random *rng, uint32_t upper_bound); +uint32_t random_range_u32(const Random *_Nonnull rng, uint32_t upper_bound); /** * @brief Cryptographically signs a message using the supplied secret key and puts the resulting signature @@ -267,7 +267,7 @@ uint32_t random_range_u32(non_null() const Random *rng, uint32_t upper_bound); * * @retval true on success. */ -bool crypto_signature_create(non_null() uint8_t signature[CRYPTO_SIGNATURE_SIZE], non_null() const uint8_t *message, uint64_t message_length, non_null() const uint8_t secret_key[SIG_SECRET_KEY_SIZE]); +bool crypto_signature_create(uint8_t signature[_Nonnull CRYPTO_SIGNATURE_SIZE], const uint8_t *_Nonnull message, uint64_t message_length, const uint8_t secret_key[_Nonnull SIG_SECRET_KEY_SIZE]); /** @brief Verifies that the given signature was produced by a given message and public key. * @@ -279,18 +279,18 @@ bool crypto_signature_create(non_null() uint8_t signature[CRYPTO_SIGNATURE_SIZE] * * @retval true on success. */ -bool crypto_signature_verify(non_null() const uint8_t signature[CRYPTO_SIGNATURE_SIZE], non_null() const uint8_t *message, uint64_t message_length, - non_null() const uint8_t public_key[SIG_PUBLIC_KEY_SIZE]); +bool crypto_signature_verify(const uint8_t signature[_Nonnull CRYPTO_SIGNATURE_SIZE], const uint8_t *_Nonnull message, uint64_t message_length, + const uint8_t public_key[_Nonnull SIG_PUBLIC_KEY_SIZE]); /** * @brief Fill the given nonce with random bytes. */ -void random_nonce(non_null() const Random *rng, non_null() uint8_t nonce[CRYPTO_NONCE_SIZE]); +void random_nonce(const Random *_Nonnull rng, uint8_t nonce[_Nonnull CRYPTO_NONCE_SIZE]); /** * @brief Fill an array of bytes with random values. */ -void random_bytes(non_null() const Random *rng, non_null() uint8_t *bytes, size_t length); +void random_bytes(const Random *_Nonnull rng, uint8_t *_Nonnull bytes, size_t length); /** * @brief Check if a Tox public key CRYPTO_PUBLIC_KEY_SIZE is valid or not. @@ -299,7 +299,7 @@ void random_bytes(non_null() const Random *rng, non_null() uint8_t *bytes, size_ * * @return false if it isn't, true if it is. */ -bool public_key_valid(non_null() const uint8_t public_key[CRYPTO_PUBLIC_KEY_SIZE]); +bool public_key_valid(const uint8_t public_key[_Nonnull CRYPTO_PUBLIC_KEY_SIZE]); typedef struct Extended_Public_Key { uint8_t enc[CRYPTO_PUBLIC_KEY_SIZE]; @@ -324,26 +324,26 @@ typedef struct Extended_Secret_Key { * * @retval true on success. */ -bool create_extended_keypair(non_null() Extended_Public_Key *pk, non_null() Extended_Secret_Key *sk, non_null() const Random *rng); +bool create_extended_keypair(Extended_Public_Key *_Nonnull pk, Extended_Secret_Key *_Nonnull sk, const Random *_Nonnull rng); /** Functions for groupchat extended keys */ -const uint8_t *get_enc_key(non_null() const Extended_Public_Key *key); -const uint8_t *get_sig_pk(non_null() const Extended_Public_Key *key); -void set_sig_pk(non_null() Extended_Public_Key *key, non_null() const uint8_t *sig_pk); -const uint8_t *get_sig_sk(non_null() const Extended_Secret_Key *key); -const uint8_t *get_chat_id(non_null() const Extended_Public_Key *key); +const uint8_t *_Nonnull get_enc_key(const Extended_Public_Key *_Nonnull key); +const uint8_t *_Nonnull get_sig_pk(const Extended_Public_Key *_Nonnull key); +void set_sig_pk(Extended_Public_Key *_Nonnull key, const uint8_t *_Nonnull sig_pk); +const uint8_t *_Nonnull get_sig_sk(const Extended_Secret_Key *_Nonnull key); +const uint8_t *_Nonnull get_chat_id(const Extended_Public_Key *_Nonnull key); /** * @brief Generate a new random keypair. * * Every call to this function is likely to generate a different keypair. */ -int32_t crypto_new_keypair(non_null() const Random *rng, uint8_t public_key[CRYPTO_PUBLIC_KEY_SIZE], uint8_t secret_key[CRYPTO_SECRET_KEY_SIZE]); +int32_t crypto_new_keypair(const Random *_Nonnull rng, uint8_t public_key[_Nonnull CRYPTO_PUBLIC_KEY_SIZE], uint8_t secret_key[_Nonnull CRYPTO_SECRET_KEY_SIZE]); /** * @brief Derive the public key from a given secret key. */ -void crypto_derive_public_key(non_null() uint8_t public_key[CRYPTO_PUBLIC_KEY_SIZE], non_null() const uint8_t secret_key[CRYPTO_SECRET_KEY_SIZE]); +void crypto_derive_public_key(uint8_t public_key[_Nonnull CRYPTO_PUBLIC_KEY_SIZE], const uint8_t secret_key[_Nonnull CRYPTO_SECRET_KEY_SIZE]); /** * @brief Encrypt message to send from secret key to public key. @@ -356,8 +356,8 @@ void crypto_derive_public_key(non_null() uint8_t public_key[CRYPTO_PUBLIC_KEY_SI * @retval -1 if there was a problem. * @return length of encrypted data if everything was fine. */ -int32_t encrypt_data(non_null() const Memory *mem, non_null() const uint8_t public_key[CRYPTO_PUBLIC_KEY_SIZE], non_null() const uint8_t secret_key[CRYPTO_SECRET_KEY_SIZE], - non_null() const uint8_t nonce[CRYPTO_NONCE_SIZE], non_null() const uint8_t *plain, size_t length, non_null() uint8_t *encrypted); +int32_t encrypt_data(const Memory *_Nonnull mem, const uint8_t public_key[_Nonnull CRYPTO_PUBLIC_KEY_SIZE], const uint8_t secret_key[_Nonnull CRYPTO_SECRET_KEY_SIZE], + const uint8_t nonce[_Nonnull CRYPTO_NONCE_SIZE], const uint8_t *_Nonnull plain, size_t length, uint8_t *_Nonnull encrypted); /** * @brief Decrypt message from public key to secret key. @@ -370,8 +370,8 @@ int32_t encrypt_data(non_null() const Memory *mem, non_null() const uint8_t publ * @retval -1 if there was a problem (decryption failed). * @return length of plain text data if everything was fine. */ -int32_t decrypt_data(non_null() const Memory *mem, non_null() const uint8_t public_key[CRYPTO_PUBLIC_KEY_SIZE], non_null() const uint8_t secret_key[CRYPTO_SECRET_KEY_SIZE], - non_null() const uint8_t nonce[CRYPTO_NONCE_SIZE], non_null() const uint8_t *encrypted, size_t length, non_null() uint8_t *plain); +int32_t decrypt_data(const Memory *_Nonnull mem, const uint8_t public_key[_Nonnull CRYPTO_PUBLIC_KEY_SIZE], const uint8_t secret_key[_Nonnull CRYPTO_SECRET_KEY_SIZE], + const uint8_t nonce[_Nonnull CRYPTO_NONCE_SIZE], const uint8_t *_Nonnull encrypted, size_t length, uint8_t *_Nonnull plain); /** * @brief Fast encrypt/decrypt operations. @@ -380,51 +380,51 @@ int32_t decrypt_data(non_null() const Memory *mem, non_null() const uint8_t publ * shared-key generation once so it does not have to be performed on every * encrypt/decrypt. */ -int32_t encrypt_precompute(non_null() const uint8_t public_key[CRYPTO_PUBLIC_KEY_SIZE], non_null() const uint8_t secret_key[CRYPTO_SECRET_KEY_SIZE], - non_null() uint8_t shared_key[CRYPTO_SHARED_KEY_SIZE]); +int32_t encrypt_precompute(const uint8_t public_key[_Nonnull CRYPTO_PUBLIC_KEY_SIZE], const uint8_t secret_key[_Nonnull CRYPTO_SECRET_KEY_SIZE], + uint8_t shared_key[_Nonnull CRYPTO_SHARED_KEY_SIZE]); /** * @brief Encrypt message with precomputed shared key. * * Encrypts plain of length length to encrypted of length + @ref CRYPTO_MAC_SIZE - * using a shared key @ref CRYPTO_SHARED_KEY_SIZE big and a @ref CRYPTO_NONCE_SIZE + * using a shared key @ref CRYPTO_SYMMETRIC_KEY_SIZE big and a @ref CRYPTO_NONCE_SIZE * byte nonce. * * @retval -1 if there was a problem. * @return length of encrypted data if everything was fine. */ -int32_t encrypt_data_symmetric(non_null() const Memory *mem, non_null() const uint8_t shared_key[CRYPTO_SHARED_KEY_SIZE], non_null() const uint8_t nonce[CRYPTO_NONCE_SIZE], - non_null() const uint8_t *plain, size_t length, non_null() uint8_t *encrypted); +int32_t encrypt_data_symmetric(const Memory *_Nonnull mem, const uint8_t shared_key[_Nonnull CRYPTO_SHARED_KEY_SIZE], const uint8_t nonce[_Nonnull CRYPTO_NONCE_SIZE], + const uint8_t *_Nonnull plain, size_t length, uint8_t *_Nonnull encrypted); /** * @brief Decrypt message with precomputed shared key. * * Decrypts encrypted of length length to plain of length - * `length - CRYPTO_MAC_SIZE` using a shared key @ref CRYPTO_SHARED_KEY_SIZE + * `length - CRYPTO_MAC_SIZE` using a shared key @ref CRYPTO_SYMMETRIC_KEY_SIZE * big and a @ref CRYPTO_NONCE_SIZE byte nonce. * * @retval -1 if there was a problem (decryption failed). * @return length of plain data if everything was fine. */ -int32_t decrypt_data_symmetric(non_null() const Memory *mem, non_null() const uint8_t shared_key[CRYPTO_SHARED_KEY_SIZE], non_null() const uint8_t nonce[CRYPTO_NONCE_SIZE], - non_null() const uint8_t *encrypted, size_t length, non_null() uint8_t *plain); +int32_t decrypt_data_symmetric(const Memory *_Nonnull mem, const uint8_t shared_key[_Nonnull CRYPTO_SHARED_KEY_SIZE], const uint8_t nonce[_Nonnull CRYPTO_NONCE_SIZE], + const uint8_t *_Nonnull encrypted, size_t length, uint8_t *_Nonnull plain); /** * @brief Increment the given nonce by 1 in big endian (rightmost byte incremented first). */ -void increment_nonce(non_null() uint8_t nonce[CRYPTO_NONCE_SIZE]); +void increment_nonce(uint8_t nonce[_Nonnull CRYPTO_NONCE_SIZE]); /** * @brief Increment the given nonce by a given number. * * The number should be in host byte order. */ -void increment_nonce_number(non_null() uint8_t nonce[CRYPTO_NONCE_SIZE], uint32_t increment); +void increment_nonce_number(uint8_t nonce[_Nonnull CRYPTO_NONCE_SIZE], uint32_t increment); /** * @brief Fill a key @ref CRYPTO_SYMMETRIC_KEY_SIZE big with random bytes. */ -void new_symmetric_key(non_null() const Random *rng, non_null() uint8_t key[CRYPTO_SYMMETRIC_KEY_SIZE]); +void new_symmetric_key(const Random *_Nonnull rng, uint8_t key[_Nonnull CRYPTO_SYMMETRIC_KEY_SIZE]); /** * @brief Locks `length` bytes of memory pointed to by `data`. @@ -434,7 +434,7 @@ void new_symmetric_key(non_null() const Random *rng, non_null() uint8_t key[CRYP * * @return true on success. */ -bool crypto_memlock(non_null() void *data, size_t length); +bool crypto_memlock(void *_Nonnull data, size_t length); /** * @brief Unlocks `length` bytes of memory pointed to by `data`. @@ -447,12 +447,12 @@ bool crypto_memlock(non_null() void *data, size_t length); * * @return true on success. */ -bool crypto_memunlock(non_null() void *data, size_t length); +bool crypto_memunlock(void *_Nonnull data, size_t length); /** * @brief Generate a random secret HMAC key. */ -void new_hmac_key(non_null() const Random *rng, non_null() uint8_t key[CRYPTO_HMAC_KEY_SIZE]); +void new_hmac_key(const Random *_Nonnull rng, uint8_t key[_Nonnull CRYPTO_HMAC_KEY_SIZE]); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/crypto_core_pack.c b/toxcore/crypto_core_pack.c index 4c08fc7d2..89a1c4d0d 100644 --- a/toxcore/crypto_core_pack.c +++ b/toxcore/crypto_core_pack.c @@ -12,7 +12,7 @@ #include "ccompat.h" #include "crypto_core.h" -bool pack_extended_public_key(const Extended_Public_Key *key, Bin_Pack *bp) +bool pack_extended_public_key(const Extended_Public_Key *_Nonnull key, Bin_Pack *_Nonnull bp) { uint8_t ext_key[EXT_PUBLIC_KEY_SIZE]; static_assert(sizeof(ext_key) == sizeof(key->enc) + sizeof(key->sig), @@ -23,7 +23,7 @@ bool pack_extended_public_key(const Extended_Public_Key *key, Bin_Pack *bp) return bin_pack_bin(bp, ext_key, sizeof(ext_key)); } -bool pack_extended_secret_key(const Extended_Secret_Key *key, Bin_Pack *bp) +bool pack_extended_secret_key(const Extended_Secret_Key *_Nonnull key, Bin_Pack *_Nonnull bp) { uint8_t ext_key[EXT_SECRET_KEY_SIZE]; static_assert(sizeof(ext_key) == sizeof(key->enc) + sizeof(key->sig), @@ -36,7 +36,7 @@ bool pack_extended_secret_key(const Extended_Secret_Key *key, Bin_Pack *bp) return result; } -bool unpack_extended_public_key(Extended_Public_Key *key, Bin_Unpack *bu) +bool unpack_extended_public_key(Extended_Public_Key *_Nonnull key, Bin_Unpack *_Nonnull bu) { uint8_t ext_key[EXT_PUBLIC_KEY_SIZE]; @@ -50,7 +50,7 @@ bool unpack_extended_public_key(Extended_Public_Key *key, Bin_Unpack *bu) return true; } -bool unpack_extended_secret_key(Extended_Secret_Key *key, Bin_Unpack *bu) +bool unpack_extended_secret_key(Extended_Secret_Key *_Nonnull key, Bin_Unpack *_Nonnull bu) { uint8_t ext_key[EXT_SECRET_KEY_SIZE]; diff --git a/toxcore/crypto_core_pack.h b/toxcore/crypto_core_pack.h index 31ac29015..073feb07e 100644 --- a/toxcore/crypto_core_pack.h +++ b/toxcore/crypto_core_pack.h @@ -19,10 +19,10 @@ extern "C" { #endif -bool pack_extended_public_key(non_null() const Extended_Public_Key *key, non_null() Bin_Pack *bp); -bool pack_extended_secret_key(non_null() const Extended_Secret_Key *key, non_null() Bin_Pack *bp); -bool unpack_extended_public_key(non_null() Extended_Public_Key *key, non_null() Bin_Unpack *bu); -bool unpack_extended_secret_key(non_null() Extended_Secret_Key *key, non_null() Bin_Unpack *bu); +bool pack_extended_public_key(const Extended_Public_Key *_Nonnull key, Bin_Pack *_Nonnull bp); +bool pack_extended_secret_key(const Extended_Secret_Key *_Nonnull key, Bin_Pack *_Nonnull bp); +bool unpack_extended_public_key(Extended_Public_Key *_Nonnull key, Bin_Unpack *_Nonnull bu); +bool unpack_extended_secret_key(Extended_Secret_Key *_Nonnull key, Bin_Unpack *_Nonnull bu); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/events/conference_connected.c b/toxcore/events/conference_connected.c index 9c98426a2..bf1f9e3ad 100644 --- a/toxcore/events/conference_connected.c +++ b/toxcore/events/conference_connected.c @@ -25,7 +25,7 @@ struct Tox_Event_Conference_Connected { uint32_t conference_number; }; -static void tox_event_conference_connected_set_conference_number(non_null() Tox_Event_Conference_Connected *conference_connected, uint32_t conference_number) +static void tox_event_conference_connected_set_conference_number(Tox_Event_Conference_Connected *_Nonnull conference_connected, uint32_t conference_number) { assert(conference_connected != nullptr); conference_connected->conference_number = conference_number; @@ -36,13 +36,13 @@ uint32_t tox_event_conference_connected_get_conference_number(const Tox_Event_Co return conference_connected->conference_number; } -static void tox_event_conference_connected_construct(non_null() Tox_Event_Conference_Connected *conference_connected) +static void tox_event_conference_connected_construct(Tox_Event_Conference_Connected *_Nonnull conference_connected) { *conference_connected = (Tox_Event_Conference_Connected) { 0 }; } -static void tox_event_conference_connected_destruct(non_null() Tox_Event_Conference_Connected *conference_connected, non_null() const Memory *mem) +static void tox_event_conference_connected_destruct(Tox_Event_Conference_Connected *_Nonnull conference_connected, const Memory *_Nonnull mem) { return; } @@ -53,7 +53,7 @@ bool tox_event_conference_connected_pack( return bin_pack_u32(bp, event->conference_number); } -static bool tox_event_conference_connected_unpack_into(non_null() Tox_Event_Conference_Connected *event, non_null() Bin_Unpack *bu) +static bool tox_event_conference_connected_unpack_into(Tox_Event_Conference_Connected *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); return bin_unpack_u32(bu, &event->conference_number); @@ -91,7 +91,7 @@ void tox_event_conference_connected_free(Tox_Event_Conference_Connected *confere mem_delete(mem, conference_connected); } -static Tox_Event_Conference_Connected *tox_events_add_conference_connected(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Conference_Connected *tox_events_add_conference_connected(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Conference_Connected *const conference_connected = tox_event_conference_connected_new(mem); @@ -124,7 +124,7 @@ bool tox_event_conference_connected_unpack( return tox_event_conference_connected_unpack_into(*event, bu); } -static Tox_Event_Conference_Connected *tox_event_conference_connected_alloc(non_null() void *user_data) +static Tox_Event_Conference_Connected *tox_event_conference_connected_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/conference_invite.c b/toxcore/events/conference_invite.c index ec506a8b3..01523f966 100644 --- a/toxcore/events/conference_invite.c +++ b/toxcore/events/conference_invite.c @@ -32,7 +32,7 @@ struct Tox_Event_Conference_Invite { uint32_t cookie_length; }; -static void tox_event_conference_invite_set_friend_number(non_null() Tox_Event_Conference_Invite *conference_invite, uint32_t friend_number) +static void tox_event_conference_invite_set_friend_number(Tox_Event_Conference_Invite *_Nonnull conference_invite, uint32_t friend_number) { assert(conference_invite != nullptr); conference_invite->friend_number = friend_number; @@ -43,7 +43,7 @@ uint32_t tox_event_conference_invite_get_friend_number(const Tox_Event_Conferenc return conference_invite->friend_number; } -static void tox_event_conference_invite_set_type(non_null() Tox_Event_Conference_Invite *conference_invite, Tox_Conference_Type type) +static void tox_event_conference_invite_set_type(Tox_Event_Conference_Invite *_Nonnull conference_invite, Tox_Conference_Type type) { assert(conference_invite != nullptr); conference_invite->type = type; @@ -54,8 +54,8 @@ Tox_Conference_Type tox_event_conference_invite_get_type(const Tox_Event_Confere return conference_invite->type; } -static bool tox_event_conference_invite_set_cookie(non_null() Tox_Event_Conference_Invite *conference_invite, - nullable() const uint8_t *cookie, uint32_t cookie_length) +static bool tox_event_conference_invite_set_cookie(Tox_Event_Conference_Invite *_Nonnull conference_invite, + const uint8_t *_Nullable cookie, uint32_t cookie_length) { assert(conference_invite != nullptr); if (conference_invite->cookie != nullptr) { @@ -91,13 +91,13 @@ const uint8_t *tox_event_conference_invite_get_cookie(const Tox_Event_Conference return conference_invite->cookie; } -static void tox_event_conference_invite_construct(non_null() Tox_Event_Conference_Invite *conference_invite) +static void tox_event_conference_invite_construct(Tox_Event_Conference_Invite *_Nonnull conference_invite) { *conference_invite = (Tox_Event_Conference_Invite) { 0 }; } -static void tox_event_conference_invite_destruct(non_null() Tox_Event_Conference_Invite *conference_invite, non_null() const Memory *mem) +static void tox_event_conference_invite_destruct(Tox_Event_Conference_Invite *_Nonnull conference_invite, const Memory *_Nonnull mem) { free(conference_invite->cookie); } @@ -111,7 +111,7 @@ bool tox_event_conference_invite_pack( && bin_pack_bin(bp, event->cookie, event->cookie_length); } -static bool tox_event_conference_invite_unpack_into(non_null() Tox_Event_Conference_Invite *event, non_null() Bin_Unpack *bu) +static bool tox_event_conference_invite_unpack_into(Tox_Event_Conference_Invite *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 3, nullptr)) { @@ -155,7 +155,7 @@ void tox_event_conference_invite_free(Tox_Event_Conference_Invite *conference_in mem_delete(mem, conference_invite); } -static Tox_Event_Conference_Invite *tox_events_add_conference_invite(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Conference_Invite *tox_events_add_conference_invite(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Conference_Invite *const conference_invite = tox_event_conference_invite_new(mem); @@ -188,7 +188,7 @@ bool tox_event_conference_invite_unpack( return tox_event_conference_invite_unpack_into(*event, bu); } -static Tox_Event_Conference_Invite *tox_event_conference_invite_alloc(non_null() void *user_data) +static Tox_Event_Conference_Invite *tox_event_conference_invite_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/conference_message.c b/toxcore/events/conference_message.c index c57db6715..3ee530e8e 100644 --- a/toxcore/events/conference_message.c +++ b/toxcore/events/conference_message.c @@ -33,7 +33,7 @@ struct Tox_Event_Conference_Message { uint32_t message_length; }; -static void tox_event_conference_message_set_conference_number(non_null() Tox_Event_Conference_Message *conference_message, uint32_t conference_number) +static void tox_event_conference_message_set_conference_number(Tox_Event_Conference_Message *_Nonnull conference_message, uint32_t conference_number) { assert(conference_message != nullptr); conference_message->conference_number = conference_number; @@ -44,7 +44,7 @@ uint32_t tox_event_conference_message_get_conference_number(const Tox_Event_Conf return conference_message->conference_number; } -static void tox_event_conference_message_set_peer_number(non_null() Tox_Event_Conference_Message *conference_message, uint32_t peer_number) +static void tox_event_conference_message_set_peer_number(Tox_Event_Conference_Message *_Nonnull conference_message, uint32_t peer_number) { assert(conference_message != nullptr); conference_message->peer_number = peer_number; @@ -55,7 +55,7 @@ uint32_t tox_event_conference_message_get_peer_number(const Tox_Event_Conference return conference_message->peer_number; } -static void tox_event_conference_message_set_type(non_null() Tox_Event_Conference_Message *conference_message, Tox_Message_Type type) +static void tox_event_conference_message_set_type(Tox_Event_Conference_Message *_Nonnull conference_message, Tox_Message_Type type) { assert(conference_message != nullptr); conference_message->type = type; @@ -66,8 +66,8 @@ Tox_Message_Type tox_event_conference_message_get_type(const Tox_Event_Conferenc return conference_message->type; } -static bool tox_event_conference_message_set_message(non_null() Tox_Event_Conference_Message *conference_message, - nullable() const uint8_t *message, uint32_t message_length) +static bool tox_event_conference_message_set_message(Tox_Event_Conference_Message *_Nonnull conference_message, + const uint8_t *_Nullable message, uint32_t message_length) { assert(conference_message != nullptr); if (conference_message->message != nullptr) { @@ -103,13 +103,13 @@ const uint8_t *tox_event_conference_message_get_message(const Tox_Event_Conferen return conference_message->message; } -static void tox_event_conference_message_construct(non_null() Tox_Event_Conference_Message *conference_message) +static void tox_event_conference_message_construct(Tox_Event_Conference_Message *_Nonnull conference_message) { *conference_message = (Tox_Event_Conference_Message) { 0 }; } -static void tox_event_conference_message_destruct(non_null() Tox_Event_Conference_Message *conference_message, non_null() const Memory *mem) +static void tox_event_conference_message_destruct(Tox_Event_Conference_Message *_Nonnull conference_message, const Memory *_Nonnull mem) { free(conference_message->message); } @@ -124,7 +124,7 @@ bool tox_event_conference_message_pack( && bin_pack_bin(bp, event->message, event->message_length); } -static bool tox_event_conference_message_unpack_into(non_null() Tox_Event_Conference_Message *event, non_null() Bin_Unpack *bu) +static bool tox_event_conference_message_unpack_into(Tox_Event_Conference_Message *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 4, nullptr)) { @@ -169,7 +169,7 @@ void tox_event_conference_message_free(Tox_Event_Conference_Message *conference_ mem_delete(mem, conference_message); } -static Tox_Event_Conference_Message *tox_events_add_conference_message(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Conference_Message *tox_events_add_conference_message(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Conference_Message *const conference_message = tox_event_conference_message_new(mem); @@ -202,7 +202,7 @@ bool tox_event_conference_message_unpack( return tox_event_conference_message_unpack_into(*event, bu); } -static Tox_Event_Conference_Message *tox_event_conference_message_alloc(non_null() void *user_data) +static Tox_Event_Conference_Message *tox_event_conference_message_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/conference_peer_list_changed.c b/toxcore/events/conference_peer_list_changed.c index bdea76159..d05dda828 100644 --- a/toxcore/events/conference_peer_list_changed.c +++ b/toxcore/events/conference_peer_list_changed.c @@ -25,7 +25,7 @@ struct Tox_Event_Conference_Peer_List_Changed { uint32_t conference_number; }; -static void tox_event_conference_peer_list_changed_set_conference_number(non_null() Tox_Event_Conference_Peer_List_Changed *conference_peer_list_changed, uint32_t conference_number) +static void tox_event_conference_peer_list_changed_set_conference_number(Tox_Event_Conference_Peer_List_Changed *_Nonnull conference_peer_list_changed, uint32_t conference_number) { assert(conference_peer_list_changed != nullptr); conference_peer_list_changed->conference_number = conference_number; @@ -36,13 +36,13 @@ uint32_t tox_event_conference_peer_list_changed_get_conference_number(const Tox_ return conference_peer_list_changed->conference_number; } -static void tox_event_conference_peer_list_changed_construct(non_null() Tox_Event_Conference_Peer_List_Changed *conference_peer_list_changed) +static void tox_event_conference_peer_list_changed_construct(Tox_Event_Conference_Peer_List_Changed *_Nonnull conference_peer_list_changed) { *conference_peer_list_changed = (Tox_Event_Conference_Peer_List_Changed) { 0 }; } -static void tox_event_conference_peer_list_changed_destruct(non_null() Tox_Event_Conference_Peer_List_Changed *conference_peer_list_changed, non_null() const Memory *mem) +static void tox_event_conference_peer_list_changed_destruct(Tox_Event_Conference_Peer_List_Changed *_Nonnull conference_peer_list_changed, const Memory *_Nonnull mem) { return; } @@ -53,7 +53,7 @@ bool tox_event_conference_peer_list_changed_pack( return bin_pack_u32(bp, event->conference_number); } -static bool tox_event_conference_peer_list_changed_unpack_into(non_null() Tox_Event_Conference_Peer_List_Changed *event, non_null() Bin_Unpack *bu) +static bool tox_event_conference_peer_list_changed_unpack_into(Tox_Event_Conference_Peer_List_Changed *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); return bin_unpack_u32(bu, &event->conference_number); @@ -91,7 +91,7 @@ void tox_event_conference_peer_list_changed_free(Tox_Event_Conference_Peer_List_ mem_delete(mem, conference_peer_list_changed); } -static Tox_Event_Conference_Peer_List_Changed *tox_events_add_conference_peer_list_changed(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Conference_Peer_List_Changed *tox_events_add_conference_peer_list_changed(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Conference_Peer_List_Changed *const conference_peer_list_changed = tox_event_conference_peer_list_changed_new(mem); @@ -124,7 +124,7 @@ bool tox_event_conference_peer_list_changed_unpack( return tox_event_conference_peer_list_changed_unpack_into(*event, bu); } -static Tox_Event_Conference_Peer_List_Changed *tox_event_conference_peer_list_changed_alloc(non_null() void *user_data) +static Tox_Event_Conference_Peer_List_Changed *tox_event_conference_peer_list_changed_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/conference_peer_name.c b/toxcore/events/conference_peer_name.c index a1495d34f..285d7a48b 100644 --- a/toxcore/events/conference_peer_name.c +++ b/toxcore/events/conference_peer_name.c @@ -30,7 +30,7 @@ struct Tox_Event_Conference_Peer_Name { uint32_t name_length; }; -static void tox_event_conference_peer_name_set_conference_number(non_null() Tox_Event_Conference_Peer_Name *conference_peer_name, uint32_t conference_number) +static void tox_event_conference_peer_name_set_conference_number(Tox_Event_Conference_Peer_Name *_Nonnull conference_peer_name, uint32_t conference_number) { assert(conference_peer_name != nullptr); conference_peer_name->conference_number = conference_number; @@ -41,7 +41,7 @@ uint32_t tox_event_conference_peer_name_get_conference_number(const Tox_Event_Co return conference_peer_name->conference_number; } -static void tox_event_conference_peer_name_set_peer_number(non_null() Tox_Event_Conference_Peer_Name *conference_peer_name, uint32_t peer_number) +static void tox_event_conference_peer_name_set_peer_number(Tox_Event_Conference_Peer_Name *_Nonnull conference_peer_name, uint32_t peer_number) { assert(conference_peer_name != nullptr); conference_peer_name->peer_number = peer_number; @@ -52,8 +52,8 @@ uint32_t tox_event_conference_peer_name_get_peer_number(const Tox_Event_Conferen return conference_peer_name->peer_number; } -static bool tox_event_conference_peer_name_set_name(non_null() Tox_Event_Conference_Peer_Name *conference_peer_name, - nullable() const uint8_t *name, uint32_t name_length) +static bool tox_event_conference_peer_name_set_name(Tox_Event_Conference_Peer_Name *_Nonnull conference_peer_name, + const uint8_t *_Nullable name, uint32_t name_length) { assert(conference_peer_name != nullptr); if (conference_peer_name->name != nullptr) { @@ -89,13 +89,13 @@ const uint8_t *tox_event_conference_peer_name_get_name(const Tox_Event_Conferenc return conference_peer_name->name; } -static void tox_event_conference_peer_name_construct(non_null() Tox_Event_Conference_Peer_Name *conference_peer_name) +static void tox_event_conference_peer_name_construct(Tox_Event_Conference_Peer_Name *_Nonnull conference_peer_name) { *conference_peer_name = (Tox_Event_Conference_Peer_Name) { 0 }; } -static void tox_event_conference_peer_name_destruct(non_null() Tox_Event_Conference_Peer_Name *conference_peer_name, non_null() const Memory *mem) +static void tox_event_conference_peer_name_destruct(Tox_Event_Conference_Peer_Name *_Nonnull conference_peer_name, const Memory *_Nonnull mem) { free(conference_peer_name->name); } @@ -109,7 +109,7 @@ bool tox_event_conference_peer_name_pack( && bin_pack_bin(bp, event->name, event->name_length); } -static bool tox_event_conference_peer_name_unpack_into(non_null() Tox_Event_Conference_Peer_Name *event, non_null() Bin_Unpack *bu) +static bool tox_event_conference_peer_name_unpack_into(Tox_Event_Conference_Peer_Name *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 3, nullptr)) { @@ -153,7 +153,7 @@ void tox_event_conference_peer_name_free(Tox_Event_Conference_Peer_Name *confere mem_delete(mem, conference_peer_name); } -static Tox_Event_Conference_Peer_Name *tox_events_add_conference_peer_name(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Conference_Peer_Name *tox_events_add_conference_peer_name(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Conference_Peer_Name *const conference_peer_name = tox_event_conference_peer_name_new(mem); @@ -186,7 +186,7 @@ bool tox_event_conference_peer_name_unpack( return tox_event_conference_peer_name_unpack_into(*event, bu); } -static Tox_Event_Conference_Peer_Name *tox_event_conference_peer_name_alloc(non_null() void *user_data) +static Tox_Event_Conference_Peer_Name *tox_event_conference_peer_name_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/conference_title.c b/toxcore/events/conference_title.c index 939b4e5f7..7baeaee8f 100644 --- a/toxcore/events/conference_title.c +++ b/toxcore/events/conference_title.c @@ -30,7 +30,7 @@ struct Tox_Event_Conference_Title { uint32_t title_length; }; -static void tox_event_conference_title_set_conference_number(non_null() Tox_Event_Conference_Title *conference_title, uint32_t conference_number) +static void tox_event_conference_title_set_conference_number(Tox_Event_Conference_Title *_Nonnull conference_title, uint32_t conference_number) { assert(conference_title != nullptr); conference_title->conference_number = conference_number; @@ -41,7 +41,7 @@ uint32_t tox_event_conference_title_get_conference_number(const Tox_Event_Confer return conference_title->conference_number; } -static void tox_event_conference_title_set_peer_number(non_null() Tox_Event_Conference_Title *conference_title, uint32_t peer_number) +static void tox_event_conference_title_set_peer_number(Tox_Event_Conference_Title *_Nonnull conference_title, uint32_t peer_number) { assert(conference_title != nullptr); conference_title->peer_number = peer_number; @@ -52,8 +52,8 @@ uint32_t tox_event_conference_title_get_peer_number(const Tox_Event_Conference_T return conference_title->peer_number; } -static bool tox_event_conference_title_set_title(non_null() Tox_Event_Conference_Title *conference_title, - nullable() const uint8_t *title, uint32_t title_length) +static bool tox_event_conference_title_set_title(Tox_Event_Conference_Title *_Nonnull conference_title, + const uint8_t *_Nullable title, uint32_t title_length) { assert(conference_title != nullptr); if (conference_title->title != nullptr) { @@ -89,13 +89,13 @@ const uint8_t *tox_event_conference_title_get_title(const Tox_Event_Conference_T return conference_title->title; } -static void tox_event_conference_title_construct(non_null() Tox_Event_Conference_Title *conference_title) +static void tox_event_conference_title_construct(Tox_Event_Conference_Title *_Nonnull conference_title) { *conference_title = (Tox_Event_Conference_Title) { 0 }; } -static void tox_event_conference_title_destruct(non_null() Tox_Event_Conference_Title *conference_title, non_null() const Memory *mem) +static void tox_event_conference_title_destruct(Tox_Event_Conference_Title *_Nonnull conference_title, const Memory *_Nonnull mem) { free(conference_title->title); } @@ -109,7 +109,7 @@ bool tox_event_conference_title_pack( && bin_pack_bin(bp, event->title, event->title_length); } -static bool tox_event_conference_title_unpack_into(non_null() Tox_Event_Conference_Title *event, non_null() Bin_Unpack *bu) +static bool tox_event_conference_title_unpack_into(Tox_Event_Conference_Title *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 3, nullptr)) { @@ -153,7 +153,7 @@ void tox_event_conference_title_free(Tox_Event_Conference_Title *conference_titl mem_delete(mem, conference_title); } -static Tox_Event_Conference_Title *tox_events_add_conference_title(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Conference_Title *tox_events_add_conference_title(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Conference_Title *const conference_title = tox_event_conference_title_new(mem); @@ -186,7 +186,7 @@ bool tox_event_conference_title_unpack( return tox_event_conference_title_unpack_into(*event, bu); } -static Tox_Event_Conference_Title *tox_event_conference_title_alloc(non_null() void *user_data) +static Tox_Event_Conference_Title *tox_event_conference_title_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/dht_nodes_response.c b/toxcore/events/dht_nodes_response.c index dea499d82..a4b9dc152 100644 --- a/toxcore/events/dht_nodes_response.c +++ b/toxcore/events/dht_nodes_response.c @@ -30,17 +30,17 @@ struct Tox_Event_Dht_Nodes_Response { uint16_t port; }; -static bool tox_event_dht_nodes_response_set_public_key(non_null() Tox_Event_Dht_Nodes_Response *dht_nodes_response, non_null() const uint8_t public_key[TOX_PUBLIC_KEY_SIZE]) +static bool tox_event_dht_nodes_response_set_public_key(Tox_Event_Dht_Nodes_Response *_Nonnull dht_nodes_response, const uint8_t public_key[TOX_PUBLIC_KEY_SIZE]) { memcpy(dht_nodes_response->public_key, public_key, TOX_PUBLIC_KEY_SIZE); return true; } -const uint8_t *tox_event_dht_nodes_response_get_public_key(const Tox_Event_Dht_Nodes_Response *dht_nodes_response) +const uint8_t *_Nonnull tox_event_dht_nodes_response_get_public_key(const Tox_Event_Dht_Nodes_Response *dht_nodes_response) { return dht_nodes_response->public_key; } -static bool tox_event_dht_nodes_response_set_ip(non_null() Tox_Event_Dht_Nodes_Response *dht_nodes_response, non_null() const char *ip, uint32_t ip_length, non_null() const Memory *mem) +static bool tox_event_dht_nodes_response_set_ip(Tox_Event_Dht_Nodes_Response *_Nonnull dht_nodes_response, const char *_Nonnull ip, uint32_t ip_length, const Memory *_Nonnull mem) { if (dht_nodes_response->ip != nullptr) { mem_delete(mem, dht_nodes_response->ip); @@ -68,7 +68,7 @@ const uint8_t *tox_event_dht_nodes_response_get_ip(const Tox_Event_Dht_Nodes_Res return dht_nodes_response->ip; } -static bool tox_event_dht_nodes_response_set_port(non_null() Tox_Event_Dht_Nodes_Response *dht_nodes_response, uint16_t port) +static bool tox_event_dht_nodes_response_set_port(Tox_Event_Dht_Nodes_Response *_Nonnull dht_nodes_response, uint16_t port) { dht_nodes_response->port = port; return true; @@ -78,7 +78,7 @@ uint16_t tox_event_dht_nodes_response_get_port(const Tox_Event_Dht_Nodes_Respons return dht_nodes_response->port; } -static void tox_event_dht_nodes_response_construct(non_null() Tox_Event_Dht_Nodes_Response *dht_nodes_response) +static void tox_event_dht_nodes_response_construct(Tox_Event_Dht_Nodes_Response *_Nonnull dht_nodes_response) { *dht_nodes_response = (Tox_Event_Dht_Nodes_Response) { { @@ -86,7 +86,7 @@ static void tox_event_dht_nodes_response_construct(non_null() Tox_Event_Dht_Node } }; } -static void tox_event_dht_nodes_response_destruct(non_null() Tox_Event_Dht_Nodes_Response *dht_nodes_response, non_null() const Memory *mem) +static void tox_event_dht_nodes_response_destruct(Tox_Event_Dht_Nodes_Response *_Nonnull dht_nodes_response, const Memory *_Nonnull mem) { mem_delete(mem, dht_nodes_response->ip); } @@ -100,7 +100,7 @@ bool tox_event_dht_nodes_response_pack( && bin_pack_u16(bp, event->port); } -static bool tox_event_dht_nodes_response_unpack_into(non_null() Tox_Event_Dht_Nodes_Response *event, non_null() Bin_Unpack *bu) +static bool tox_event_dht_nodes_response_unpack_into(Tox_Event_Dht_Nodes_Response *_Nonnull event, Bin_Unpack *_Nonnull bu) { if (!bin_unpack_array_fixed(bu, 3, nullptr)) { return false; @@ -138,7 +138,7 @@ void tox_event_dht_nodes_response_free(Tox_Event_Dht_Nodes_Response *dht_nodes_r mem_delete(mem, dht_nodes_response); } -static Tox_Event_Dht_Nodes_Response *tox_events_add_dht_nodes_response(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Dht_Nodes_Response *tox_events_add_dht_nodes_response(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Dht_Nodes_Response *const dht_nodes_response = tox_event_dht_nodes_response_new(mem); @@ -169,7 +169,7 @@ bool tox_event_dht_nodes_response_unpack( return tox_event_dht_nodes_response_unpack_into(*event, bu); } -static Tox_Event_Dht_Nodes_Response *tox_event_dht_nodes_response_alloc(non_null() void *user_data) +static Tox_Event_Dht_Nodes_Response *tox_event_dht_nodes_response_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/events_alloc.h b/toxcore/events/events_alloc.h index f86f9f1ad..ce0518380 100644 --- a/toxcore/events/events_alloc.h +++ b/toxcore/events/events_alloc.h @@ -16,17 +16,17 @@ extern "C" { #endif struct Tox_Events { - Tox_Event *events; + Tox_Event *_Nonnull events; uint32_t events_size; uint32_t events_capacity; - const Memory *mem; + const Memory *_Nonnull mem; }; typedef struct Tox_Events_State { Tox_Err_Events_Iterate error; - const Memory *mem; - Tox_Events *events; + const Memory *_Nonnull mem; + Tox_Events *_Nonnull events; } Tox_Events_State; tox_conference_connected_cb tox_events_handle_conference_connected; @@ -70,9 +70,9 @@ tox_group_self_join_cb tox_events_handle_group_self_join; tox_group_join_fail_cb tox_events_handle_group_join_fail; tox_group_moderation_cb tox_events_handle_group_moderation; -Tox_Events_State *tox_events_alloc(non_null() void *user_data); +Tox_Events_State *_Nonnull tox_events_alloc(void *_Nonnull user_data); -bool tox_events_add(non_null() Tox_Events *events, non_null() const Tox_Event *event); +bool tox_events_add(Tox_Events *_Nonnull events, const Tox_Event *_Nonnull event); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/events/file_chunk_request.c b/toxcore/events/file_chunk_request.c index 8f9f5c8bd..5562e5539 100644 --- a/toxcore/events/file_chunk_request.c +++ b/toxcore/events/file_chunk_request.c @@ -28,7 +28,7 @@ struct Tox_Event_File_Chunk_Request { uint16_t length; }; -static void tox_event_file_chunk_request_set_friend_number(non_null() Tox_Event_File_Chunk_Request *file_chunk_request, uint32_t friend_number) +static void tox_event_file_chunk_request_set_friend_number(Tox_Event_File_Chunk_Request *_Nonnull file_chunk_request, uint32_t friend_number) { assert(file_chunk_request != nullptr); file_chunk_request->friend_number = friend_number; @@ -39,7 +39,7 @@ uint32_t tox_event_file_chunk_request_get_friend_number(const Tox_Event_File_Chu return file_chunk_request->friend_number; } -static void tox_event_file_chunk_request_set_file_number(non_null() Tox_Event_File_Chunk_Request *file_chunk_request, uint32_t file_number) +static void tox_event_file_chunk_request_set_file_number(Tox_Event_File_Chunk_Request *_Nonnull file_chunk_request, uint32_t file_number) { assert(file_chunk_request != nullptr); file_chunk_request->file_number = file_number; @@ -50,7 +50,7 @@ uint32_t tox_event_file_chunk_request_get_file_number(const Tox_Event_File_Chunk return file_chunk_request->file_number; } -static void tox_event_file_chunk_request_set_position(non_null() Tox_Event_File_Chunk_Request *file_chunk_request, uint64_t position) +static void tox_event_file_chunk_request_set_position(Tox_Event_File_Chunk_Request *_Nonnull file_chunk_request, uint64_t position) { assert(file_chunk_request != nullptr); file_chunk_request->position = position; @@ -61,7 +61,7 @@ uint64_t tox_event_file_chunk_request_get_position(const Tox_Event_File_Chunk_Re return file_chunk_request->position; } -static void tox_event_file_chunk_request_set_length(non_null() Tox_Event_File_Chunk_Request *file_chunk_request, uint16_t length) +static void tox_event_file_chunk_request_set_length(Tox_Event_File_Chunk_Request *_Nonnull file_chunk_request, uint16_t length) { assert(file_chunk_request != nullptr); file_chunk_request->length = length; @@ -72,13 +72,13 @@ uint16_t tox_event_file_chunk_request_get_length(const Tox_Event_File_Chunk_Requ return file_chunk_request->length; } -static void tox_event_file_chunk_request_construct(non_null() Tox_Event_File_Chunk_Request *file_chunk_request) +static void tox_event_file_chunk_request_construct(Tox_Event_File_Chunk_Request *_Nonnull file_chunk_request) { *file_chunk_request = (Tox_Event_File_Chunk_Request) { 0 }; } -static void tox_event_file_chunk_request_destruct(non_null() Tox_Event_File_Chunk_Request *file_chunk_request, non_null() const Memory *mem) +static void tox_event_file_chunk_request_destruct(Tox_Event_File_Chunk_Request *_Nonnull file_chunk_request, const Memory *_Nonnull mem) { return; } @@ -93,7 +93,7 @@ bool tox_event_file_chunk_request_pack( && bin_pack_u16(bp, event->length); } -static bool tox_event_file_chunk_request_unpack_into(non_null() Tox_Event_File_Chunk_Request *event, non_null() Bin_Unpack *bu) +static bool tox_event_file_chunk_request_unpack_into(Tox_Event_File_Chunk_Request *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 4, nullptr)) { @@ -138,7 +138,7 @@ void tox_event_file_chunk_request_free(Tox_Event_File_Chunk_Request *file_chunk_ mem_delete(mem, file_chunk_request); } -static Tox_Event_File_Chunk_Request *tox_events_add_file_chunk_request(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_File_Chunk_Request *tox_events_add_file_chunk_request(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_File_Chunk_Request *const file_chunk_request = tox_event_file_chunk_request_new(mem); @@ -171,7 +171,7 @@ bool tox_event_file_chunk_request_unpack( return tox_event_file_chunk_request_unpack_into(*event, bu); } -static Tox_Event_File_Chunk_Request *tox_event_file_chunk_request_alloc(non_null() void *user_data) +static Tox_Event_File_Chunk_Request *tox_event_file_chunk_request_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/file_recv.c b/toxcore/events/file_recv.c index cafdbff86..00b015da0 100644 --- a/toxcore/events/file_recv.c +++ b/toxcore/events/file_recv.c @@ -32,7 +32,7 @@ struct Tox_Event_File_Recv { uint32_t filename_length; }; -static void tox_event_file_recv_set_friend_number(non_null() Tox_Event_File_Recv *file_recv, uint32_t friend_number) +static void tox_event_file_recv_set_friend_number(Tox_Event_File_Recv *_Nonnull file_recv, uint32_t friend_number) { assert(file_recv != nullptr); file_recv->friend_number = friend_number; @@ -43,7 +43,7 @@ uint32_t tox_event_file_recv_get_friend_number(const Tox_Event_File_Recv *file_r return file_recv->friend_number; } -static void tox_event_file_recv_set_file_number(non_null() Tox_Event_File_Recv *file_recv, uint32_t file_number) +static void tox_event_file_recv_set_file_number(Tox_Event_File_Recv *_Nonnull file_recv, uint32_t file_number) { assert(file_recv != nullptr); file_recv->file_number = file_number; @@ -54,7 +54,7 @@ uint32_t tox_event_file_recv_get_file_number(const Tox_Event_File_Recv *file_rec return file_recv->file_number; } -static void tox_event_file_recv_set_kind(non_null() Tox_Event_File_Recv *file_recv, uint32_t kind) +static void tox_event_file_recv_set_kind(Tox_Event_File_Recv *_Nonnull file_recv, uint32_t kind) { assert(file_recv != nullptr); file_recv->kind = kind; @@ -65,7 +65,7 @@ uint32_t tox_event_file_recv_get_kind(const Tox_Event_File_Recv *file_recv) return file_recv->kind; } -static void tox_event_file_recv_set_file_size(non_null() Tox_Event_File_Recv *file_recv, uint64_t file_size) +static void tox_event_file_recv_set_file_size(Tox_Event_File_Recv *_Nonnull file_recv, uint64_t file_size) { assert(file_recv != nullptr); file_recv->file_size = file_size; @@ -76,8 +76,8 @@ uint64_t tox_event_file_recv_get_file_size(const Tox_Event_File_Recv *file_recv) return file_recv->file_size; } -static bool tox_event_file_recv_set_filename(non_null() Tox_Event_File_Recv *file_recv, - nullable() const uint8_t *filename, uint32_t filename_length) +static bool tox_event_file_recv_set_filename(Tox_Event_File_Recv *_Nonnull file_recv, + const uint8_t *_Nullable filename, uint32_t filename_length) { assert(file_recv != nullptr); if (file_recv->filename != nullptr) { @@ -113,13 +113,13 @@ const uint8_t *tox_event_file_recv_get_filename(const Tox_Event_File_Recv *file_ return file_recv->filename; } -static void tox_event_file_recv_construct(non_null() Tox_Event_File_Recv *file_recv) +static void tox_event_file_recv_construct(Tox_Event_File_Recv *_Nonnull file_recv) { *file_recv = (Tox_Event_File_Recv) { 0 }; } -static void tox_event_file_recv_destruct(non_null() Tox_Event_File_Recv *file_recv, non_null() const Memory *mem) +static void tox_event_file_recv_destruct(Tox_Event_File_Recv *_Nonnull file_recv, const Memory *_Nonnull mem) { free(file_recv->filename); } @@ -135,7 +135,7 @@ bool tox_event_file_recv_pack( && bin_pack_bin(bp, event->filename, event->filename_length); } -static bool tox_event_file_recv_unpack_into(non_null() Tox_Event_File_Recv *event, non_null() Bin_Unpack *bu) +static bool tox_event_file_recv_unpack_into(Tox_Event_File_Recv *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 5, nullptr)) { @@ -181,7 +181,7 @@ void tox_event_file_recv_free(Tox_Event_File_Recv *file_recv, const Memory *mem) mem_delete(mem, file_recv); } -static Tox_Event_File_Recv *tox_events_add_file_recv(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_File_Recv *tox_events_add_file_recv(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_File_Recv *const file_recv = tox_event_file_recv_new(mem); @@ -214,7 +214,7 @@ bool tox_event_file_recv_unpack( return tox_event_file_recv_unpack_into(*event, bu); } -static Tox_Event_File_Recv *tox_event_file_recv_alloc(non_null() void *user_data) +static Tox_Event_File_Recv *tox_event_file_recv_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/file_recv_chunk.c b/toxcore/events/file_recv_chunk.c index b3233debd..09a1eda8c 100644 --- a/toxcore/events/file_recv_chunk.c +++ b/toxcore/events/file_recv_chunk.c @@ -31,7 +31,7 @@ struct Tox_Event_File_Recv_Chunk { uint32_t data_length; }; -static void tox_event_file_recv_chunk_set_friend_number(non_null() Tox_Event_File_Recv_Chunk *file_recv_chunk, uint32_t friend_number) +static void tox_event_file_recv_chunk_set_friend_number(Tox_Event_File_Recv_Chunk *_Nonnull file_recv_chunk, uint32_t friend_number) { assert(file_recv_chunk != nullptr); file_recv_chunk->friend_number = friend_number; @@ -42,7 +42,7 @@ uint32_t tox_event_file_recv_chunk_get_friend_number(const Tox_Event_File_Recv_C return file_recv_chunk->friend_number; } -static void tox_event_file_recv_chunk_set_file_number(non_null() Tox_Event_File_Recv_Chunk *file_recv_chunk, uint32_t file_number) +static void tox_event_file_recv_chunk_set_file_number(Tox_Event_File_Recv_Chunk *_Nonnull file_recv_chunk, uint32_t file_number) { assert(file_recv_chunk != nullptr); file_recv_chunk->file_number = file_number; @@ -53,7 +53,7 @@ uint32_t tox_event_file_recv_chunk_get_file_number(const Tox_Event_File_Recv_Chu return file_recv_chunk->file_number; } -static void tox_event_file_recv_chunk_set_position(non_null() Tox_Event_File_Recv_Chunk *file_recv_chunk, uint64_t position) +static void tox_event_file_recv_chunk_set_position(Tox_Event_File_Recv_Chunk *_Nonnull file_recv_chunk, uint64_t position) { assert(file_recv_chunk != nullptr); file_recv_chunk->position = position; @@ -64,8 +64,8 @@ uint64_t tox_event_file_recv_chunk_get_position(const Tox_Event_File_Recv_Chunk return file_recv_chunk->position; } -static bool tox_event_file_recv_chunk_set_data(non_null() Tox_Event_File_Recv_Chunk *file_recv_chunk, - nullable() const uint8_t *data, uint32_t data_length) +static bool tox_event_file_recv_chunk_set_data(Tox_Event_File_Recv_Chunk *_Nonnull file_recv_chunk, + const uint8_t *_Nullable data, uint32_t data_length) { assert(file_recv_chunk != nullptr); if (file_recv_chunk->data != nullptr) { @@ -101,13 +101,13 @@ const uint8_t *tox_event_file_recv_chunk_get_data(const Tox_Event_File_Recv_Chun return file_recv_chunk->data; } -static void tox_event_file_recv_chunk_construct(non_null() Tox_Event_File_Recv_Chunk *file_recv_chunk) +static void tox_event_file_recv_chunk_construct(Tox_Event_File_Recv_Chunk *_Nonnull file_recv_chunk) { *file_recv_chunk = (Tox_Event_File_Recv_Chunk) { 0 }; } -static void tox_event_file_recv_chunk_destruct(non_null() Tox_Event_File_Recv_Chunk *file_recv_chunk, non_null() const Memory *mem) +static void tox_event_file_recv_chunk_destruct(Tox_Event_File_Recv_Chunk *_Nonnull file_recv_chunk, const Memory *_Nonnull mem) { free(file_recv_chunk->data); } @@ -122,7 +122,7 @@ bool tox_event_file_recv_chunk_pack( && bin_pack_bin(bp, event->data, event->data_length); } -static bool tox_event_file_recv_chunk_unpack_into(non_null() Tox_Event_File_Recv_Chunk *event, non_null() Bin_Unpack *bu) +static bool tox_event_file_recv_chunk_unpack_into(Tox_Event_File_Recv_Chunk *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 4, nullptr)) { @@ -167,7 +167,7 @@ void tox_event_file_recv_chunk_free(Tox_Event_File_Recv_Chunk *file_recv_chunk, mem_delete(mem, file_recv_chunk); } -static Tox_Event_File_Recv_Chunk *tox_events_add_file_recv_chunk(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_File_Recv_Chunk *tox_events_add_file_recv_chunk(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_File_Recv_Chunk *const file_recv_chunk = tox_event_file_recv_chunk_new(mem); @@ -200,7 +200,7 @@ bool tox_event_file_recv_chunk_unpack( return tox_event_file_recv_chunk_unpack_into(*event, bu); } -static Tox_Event_File_Recv_Chunk *tox_event_file_recv_chunk_alloc(non_null() void *user_data) +static Tox_Event_File_Recv_Chunk *tox_event_file_recv_chunk_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/file_recv_control.c b/toxcore/events/file_recv_control.c index 016591961..e5a650e19 100644 --- a/toxcore/events/file_recv_control.c +++ b/toxcore/events/file_recv_control.c @@ -29,7 +29,7 @@ struct Tox_Event_File_Recv_Control { Tox_File_Control control; }; -static void tox_event_file_recv_control_set_friend_number(non_null() Tox_Event_File_Recv_Control *file_recv_control, uint32_t friend_number) +static void tox_event_file_recv_control_set_friend_number(Tox_Event_File_Recv_Control *_Nonnull file_recv_control, uint32_t friend_number) { assert(file_recv_control != nullptr); file_recv_control->friend_number = friend_number; @@ -40,7 +40,7 @@ uint32_t tox_event_file_recv_control_get_friend_number(const Tox_Event_File_Recv return file_recv_control->friend_number; } -static void tox_event_file_recv_control_set_file_number(non_null() Tox_Event_File_Recv_Control *file_recv_control, uint32_t file_number) +static void tox_event_file_recv_control_set_file_number(Tox_Event_File_Recv_Control *_Nonnull file_recv_control, uint32_t file_number) { assert(file_recv_control != nullptr); file_recv_control->file_number = file_number; @@ -51,7 +51,7 @@ uint32_t tox_event_file_recv_control_get_file_number(const Tox_Event_File_Recv_C return file_recv_control->file_number; } -static void tox_event_file_recv_control_set_control(non_null() Tox_Event_File_Recv_Control *file_recv_control, Tox_File_Control control) +static void tox_event_file_recv_control_set_control(Tox_Event_File_Recv_Control *_Nonnull file_recv_control, Tox_File_Control control) { assert(file_recv_control != nullptr); file_recv_control->control = control; @@ -62,13 +62,13 @@ Tox_File_Control tox_event_file_recv_control_get_control(const Tox_Event_File_Re return file_recv_control->control; } -static void tox_event_file_recv_control_construct(non_null() Tox_Event_File_Recv_Control *file_recv_control) +static void tox_event_file_recv_control_construct(Tox_Event_File_Recv_Control *_Nonnull file_recv_control) { *file_recv_control = (Tox_Event_File_Recv_Control) { 0 }; } -static void tox_event_file_recv_control_destruct(non_null() Tox_Event_File_Recv_Control *file_recv_control, non_null() const Memory *mem) +static void tox_event_file_recv_control_destruct(Tox_Event_File_Recv_Control *_Nonnull file_recv_control, const Memory *_Nonnull mem) { return; } @@ -82,7 +82,7 @@ bool tox_event_file_recv_control_pack( && tox_file_control_pack(event->control, bp); } -static bool tox_event_file_recv_control_unpack_into(non_null() Tox_Event_File_Recv_Control *event, non_null() Bin_Unpack *bu) +static bool tox_event_file_recv_control_unpack_into(Tox_Event_File_Recv_Control *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 3, nullptr)) { @@ -126,7 +126,7 @@ void tox_event_file_recv_control_free(Tox_Event_File_Recv_Control *file_recv_con mem_delete(mem, file_recv_control); } -static Tox_Event_File_Recv_Control *tox_events_add_file_recv_control(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_File_Recv_Control *tox_events_add_file_recv_control(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_File_Recv_Control *const file_recv_control = tox_event_file_recv_control_new(mem); @@ -159,7 +159,7 @@ bool tox_event_file_recv_control_unpack( return tox_event_file_recv_control_unpack_into(*event, bu); } -static Tox_Event_File_Recv_Control *tox_event_file_recv_control_alloc(non_null() void *user_data) +static Tox_Event_File_Recv_Control *tox_event_file_recv_control_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/friend_connection_status.c b/toxcore/events/friend_connection_status.c index c50dfb90b..64b04ab45 100644 --- a/toxcore/events/friend_connection_status.c +++ b/toxcore/events/friend_connection_status.c @@ -28,7 +28,7 @@ struct Tox_Event_Friend_Connection_Status { Tox_Connection connection_status; }; -static void tox_event_friend_connection_status_set_friend_number(non_null() Tox_Event_Friend_Connection_Status *friend_connection_status, uint32_t friend_number) +static void tox_event_friend_connection_status_set_friend_number(Tox_Event_Friend_Connection_Status *_Nonnull friend_connection_status, uint32_t friend_number) { assert(friend_connection_status != nullptr); friend_connection_status->friend_number = friend_number; @@ -39,7 +39,7 @@ uint32_t tox_event_friend_connection_status_get_friend_number(const Tox_Event_Fr return friend_connection_status->friend_number; } -static void tox_event_friend_connection_status_set_connection_status(non_null() Tox_Event_Friend_Connection_Status *friend_connection_status, Tox_Connection connection_status) +static void tox_event_friend_connection_status_set_connection_status(Tox_Event_Friend_Connection_Status *_Nonnull friend_connection_status, Tox_Connection connection_status) { assert(friend_connection_status != nullptr); friend_connection_status->connection_status = connection_status; @@ -50,13 +50,13 @@ Tox_Connection tox_event_friend_connection_status_get_connection_status(const To return friend_connection_status->connection_status; } -static void tox_event_friend_connection_status_construct(non_null() Tox_Event_Friend_Connection_Status *friend_connection_status) +static void tox_event_friend_connection_status_construct(Tox_Event_Friend_Connection_Status *_Nonnull friend_connection_status) { *friend_connection_status = (Tox_Event_Friend_Connection_Status) { 0 }; } -static void tox_event_friend_connection_status_destruct(non_null() Tox_Event_Friend_Connection_Status *friend_connection_status, non_null() const Memory *mem) +static void tox_event_friend_connection_status_destruct(Tox_Event_Friend_Connection_Status *_Nonnull friend_connection_status, const Memory *_Nonnull mem) { return; } @@ -69,7 +69,7 @@ bool tox_event_friend_connection_status_pack( && tox_connection_pack(event->connection_status, bp); } -static bool tox_event_friend_connection_status_unpack_into(non_null() Tox_Event_Friend_Connection_Status *event, non_null() Bin_Unpack *bu) +static bool tox_event_friend_connection_status_unpack_into(Tox_Event_Friend_Connection_Status *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -112,7 +112,7 @@ void tox_event_friend_connection_status_free(Tox_Event_Friend_Connection_Status mem_delete(mem, friend_connection_status); } -static Tox_Event_Friend_Connection_Status *tox_events_add_friend_connection_status(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Friend_Connection_Status *tox_events_add_friend_connection_status(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Friend_Connection_Status *const friend_connection_status = tox_event_friend_connection_status_new(mem); @@ -145,7 +145,7 @@ bool tox_event_friend_connection_status_unpack( return tox_event_friend_connection_status_unpack_into(*event, bu); } -static Tox_Event_Friend_Connection_Status *tox_event_friend_connection_status_alloc(non_null() void *user_data) +static Tox_Event_Friend_Connection_Status *tox_event_friend_connection_status_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/friend_lossless_packet.c b/toxcore/events/friend_lossless_packet.c index 390de9d82..7b9e6e918 100644 --- a/toxcore/events/friend_lossless_packet.c +++ b/toxcore/events/friend_lossless_packet.c @@ -29,7 +29,7 @@ struct Tox_Event_Friend_Lossless_Packet { uint32_t data_length; }; -static void tox_event_friend_lossless_packet_set_friend_number(non_null() Tox_Event_Friend_Lossless_Packet *friend_lossless_packet, uint32_t friend_number) +static void tox_event_friend_lossless_packet_set_friend_number(Tox_Event_Friend_Lossless_Packet *_Nonnull friend_lossless_packet, uint32_t friend_number) { assert(friend_lossless_packet != nullptr); friend_lossless_packet->friend_number = friend_number; @@ -40,8 +40,8 @@ uint32_t tox_event_friend_lossless_packet_get_friend_number(const Tox_Event_Frie return friend_lossless_packet->friend_number; } -static bool tox_event_friend_lossless_packet_set_data(non_null() Tox_Event_Friend_Lossless_Packet *friend_lossless_packet, - nullable() const uint8_t *data, uint32_t data_length) +static bool tox_event_friend_lossless_packet_set_data(Tox_Event_Friend_Lossless_Packet *_Nonnull friend_lossless_packet, + const uint8_t *_Nullable data, uint32_t data_length) { assert(friend_lossless_packet != nullptr); if (friend_lossless_packet->data != nullptr) { @@ -77,13 +77,13 @@ const uint8_t *tox_event_friend_lossless_packet_get_data(const Tox_Event_Friend_ return friend_lossless_packet->data; } -static void tox_event_friend_lossless_packet_construct(non_null() Tox_Event_Friend_Lossless_Packet *friend_lossless_packet) +static void tox_event_friend_lossless_packet_construct(Tox_Event_Friend_Lossless_Packet *_Nonnull friend_lossless_packet) { *friend_lossless_packet = (Tox_Event_Friend_Lossless_Packet) { 0 }; } -static void tox_event_friend_lossless_packet_destruct(non_null() Tox_Event_Friend_Lossless_Packet *friend_lossless_packet, non_null() const Memory *mem) +static void tox_event_friend_lossless_packet_destruct(Tox_Event_Friend_Lossless_Packet *_Nonnull friend_lossless_packet, const Memory *_Nonnull mem) { free(friend_lossless_packet->data); } @@ -96,7 +96,7 @@ bool tox_event_friend_lossless_packet_pack( && bin_pack_bin(bp, event->data, event->data_length); } -static bool tox_event_friend_lossless_packet_unpack_into(non_null() Tox_Event_Friend_Lossless_Packet *event, non_null() Bin_Unpack *bu) +static bool tox_event_friend_lossless_packet_unpack_into(Tox_Event_Friend_Lossless_Packet *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -139,7 +139,7 @@ void tox_event_friend_lossless_packet_free(Tox_Event_Friend_Lossless_Packet *fri mem_delete(mem, friend_lossless_packet); } -static Tox_Event_Friend_Lossless_Packet *tox_events_add_friend_lossless_packet(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Friend_Lossless_Packet *tox_events_add_friend_lossless_packet(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Friend_Lossless_Packet *const friend_lossless_packet = tox_event_friend_lossless_packet_new(mem); @@ -172,7 +172,7 @@ bool tox_event_friend_lossless_packet_unpack( return tox_event_friend_lossless_packet_unpack_into(*event, bu); } -static Tox_Event_Friend_Lossless_Packet *tox_event_friend_lossless_packet_alloc(non_null() void *user_data) +static Tox_Event_Friend_Lossless_Packet *tox_event_friend_lossless_packet_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/friend_lossy_packet.c b/toxcore/events/friend_lossy_packet.c index ea84e4ef4..22096d4bd 100644 --- a/toxcore/events/friend_lossy_packet.c +++ b/toxcore/events/friend_lossy_packet.c @@ -29,7 +29,7 @@ struct Tox_Event_Friend_Lossy_Packet { uint32_t data_length; }; -static void tox_event_friend_lossy_packet_set_friend_number(non_null() Tox_Event_Friend_Lossy_Packet *friend_lossy_packet, uint32_t friend_number) +static void tox_event_friend_lossy_packet_set_friend_number(Tox_Event_Friend_Lossy_Packet *_Nonnull friend_lossy_packet, uint32_t friend_number) { assert(friend_lossy_packet != nullptr); friend_lossy_packet->friend_number = friend_number; @@ -40,8 +40,8 @@ uint32_t tox_event_friend_lossy_packet_get_friend_number(const Tox_Event_Friend_ return friend_lossy_packet->friend_number; } -static bool tox_event_friend_lossy_packet_set_data(non_null() Tox_Event_Friend_Lossy_Packet *friend_lossy_packet, - nullable() const uint8_t *data, uint32_t data_length) +static bool tox_event_friend_lossy_packet_set_data(Tox_Event_Friend_Lossy_Packet *_Nonnull friend_lossy_packet, + const uint8_t *_Nullable data, uint32_t data_length) { assert(friend_lossy_packet != nullptr); if (friend_lossy_packet->data != nullptr) { @@ -77,13 +77,13 @@ const uint8_t *tox_event_friend_lossy_packet_get_data(const Tox_Event_Friend_Los return friend_lossy_packet->data; } -static void tox_event_friend_lossy_packet_construct(non_null() Tox_Event_Friend_Lossy_Packet *friend_lossy_packet) +static void tox_event_friend_lossy_packet_construct(Tox_Event_Friend_Lossy_Packet *_Nonnull friend_lossy_packet) { *friend_lossy_packet = (Tox_Event_Friend_Lossy_Packet) { 0 }; } -static void tox_event_friend_lossy_packet_destruct(non_null() Tox_Event_Friend_Lossy_Packet *friend_lossy_packet, non_null() const Memory *mem) +static void tox_event_friend_lossy_packet_destruct(Tox_Event_Friend_Lossy_Packet *_Nonnull friend_lossy_packet, const Memory *_Nonnull mem) { free(friend_lossy_packet->data); } @@ -96,7 +96,7 @@ bool tox_event_friend_lossy_packet_pack( && bin_pack_bin(bp, event->data, event->data_length); } -static bool tox_event_friend_lossy_packet_unpack_into(non_null() Tox_Event_Friend_Lossy_Packet *event, non_null() Bin_Unpack *bu) +static bool tox_event_friend_lossy_packet_unpack_into(Tox_Event_Friend_Lossy_Packet *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -139,7 +139,7 @@ void tox_event_friend_lossy_packet_free(Tox_Event_Friend_Lossy_Packet *friend_lo mem_delete(mem, friend_lossy_packet); } -static Tox_Event_Friend_Lossy_Packet *tox_events_add_friend_lossy_packet(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Friend_Lossy_Packet *tox_events_add_friend_lossy_packet(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Friend_Lossy_Packet *const friend_lossy_packet = tox_event_friend_lossy_packet_new(mem); @@ -172,7 +172,7 @@ bool tox_event_friend_lossy_packet_unpack( return tox_event_friend_lossy_packet_unpack_into(*event, bu); } -static Tox_Event_Friend_Lossy_Packet *tox_event_friend_lossy_packet_alloc(non_null() void *user_data) +static Tox_Event_Friend_Lossy_Packet *tox_event_friend_lossy_packet_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/friend_message.c b/toxcore/events/friend_message.c index eaf27dd11..0d59a6bc0 100644 --- a/toxcore/events/friend_message.c +++ b/toxcore/events/friend_message.c @@ -32,7 +32,7 @@ struct Tox_Event_Friend_Message { uint32_t message_length; }; -static void tox_event_friend_message_set_friend_number(non_null() Tox_Event_Friend_Message *friend_message, uint32_t friend_number) +static void tox_event_friend_message_set_friend_number(Tox_Event_Friend_Message *_Nonnull friend_message, uint32_t friend_number) { assert(friend_message != nullptr); friend_message->friend_number = friend_number; @@ -43,7 +43,7 @@ uint32_t tox_event_friend_message_get_friend_number(const Tox_Event_Friend_Messa return friend_message->friend_number; } -static void tox_event_friend_message_set_type(non_null() Tox_Event_Friend_Message *friend_message, Tox_Message_Type type) +static void tox_event_friend_message_set_type(Tox_Event_Friend_Message *_Nonnull friend_message, Tox_Message_Type type) { assert(friend_message != nullptr); friend_message->type = type; @@ -54,8 +54,8 @@ Tox_Message_Type tox_event_friend_message_get_type(const Tox_Event_Friend_Messag return friend_message->type; } -static bool tox_event_friend_message_set_message(non_null() Tox_Event_Friend_Message *friend_message, - nullable() const uint8_t *message, uint32_t message_length) +static bool tox_event_friend_message_set_message(Tox_Event_Friend_Message *_Nonnull friend_message, + const uint8_t *_Nullable message, uint32_t message_length) { assert(friend_message != nullptr); if (friend_message->message != nullptr) { @@ -91,13 +91,13 @@ const uint8_t *tox_event_friend_message_get_message(const Tox_Event_Friend_Messa return friend_message->message; } -static void tox_event_friend_message_construct(non_null() Tox_Event_Friend_Message *friend_message) +static void tox_event_friend_message_construct(Tox_Event_Friend_Message *_Nonnull friend_message) { *friend_message = (Tox_Event_Friend_Message) { 0 }; } -static void tox_event_friend_message_destruct(non_null() Tox_Event_Friend_Message *friend_message, non_null() const Memory *mem) +static void tox_event_friend_message_destruct(Tox_Event_Friend_Message *_Nonnull friend_message, const Memory *_Nonnull mem) { free(friend_message->message); } @@ -111,7 +111,7 @@ bool tox_event_friend_message_pack( && bin_pack_bin(bp, event->message, event->message_length); } -static bool tox_event_friend_message_unpack_into(non_null() Tox_Event_Friend_Message *event, non_null() Bin_Unpack *bu) +static bool tox_event_friend_message_unpack_into(Tox_Event_Friend_Message *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 3, nullptr)) { @@ -155,7 +155,7 @@ void tox_event_friend_message_free(Tox_Event_Friend_Message *friend_message, con mem_delete(mem, friend_message); } -static Tox_Event_Friend_Message *tox_events_add_friend_message(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Friend_Message *tox_events_add_friend_message(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Friend_Message *const friend_message = tox_event_friend_message_new(mem); @@ -188,7 +188,7 @@ bool tox_event_friend_message_unpack( return tox_event_friend_message_unpack_into(*event, bu); } -static Tox_Event_Friend_Message *tox_event_friend_message_alloc(non_null() void *user_data) +static Tox_Event_Friend_Message *tox_event_friend_message_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/friend_name.c b/toxcore/events/friend_name.c index 8092c7353..4f1c6e228 100644 --- a/toxcore/events/friend_name.c +++ b/toxcore/events/friend_name.c @@ -29,7 +29,7 @@ struct Tox_Event_Friend_Name { uint32_t name_length; }; -static void tox_event_friend_name_set_friend_number(non_null() Tox_Event_Friend_Name *friend_name, uint32_t friend_number) +static void tox_event_friend_name_set_friend_number(Tox_Event_Friend_Name *_Nonnull friend_name, uint32_t friend_number) { assert(friend_name != nullptr); friend_name->friend_number = friend_number; @@ -40,8 +40,8 @@ uint32_t tox_event_friend_name_get_friend_number(const Tox_Event_Friend_Name *fr return friend_name->friend_number; } -static bool tox_event_friend_name_set_name(non_null() Tox_Event_Friend_Name *friend_name, - nullable() const uint8_t *name, uint32_t name_length) +static bool tox_event_friend_name_set_name(Tox_Event_Friend_Name *_Nonnull friend_name, + const uint8_t *_Nullable name, uint32_t name_length) { assert(friend_name != nullptr); if (friend_name->name != nullptr) { @@ -77,13 +77,13 @@ const uint8_t *tox_event_friend_name_get_name(const Tox_Event_Friend_Name *frien return friend_name->name; } -static void tox_event_friend_name_construct(non_null() Tox_Event_Friend_Name *friend_name) +static void tox_event_friend_name_construct(Tox_Event_Friend_Name *_Nonnull friend_name) { *friend_name = (Tox_Event_Friend_Name) { 0 }; } -static void tox_event_friend_name_destruct(non_null() Tox_Event_Friend_Name *friend_name, non_null() const Memory *mem) +static void tox_event_friend_name_destruct(Tox_Event_Friend_Name *_Nonnull friend_name, const Memory *_Nonnull mem) { free(friend_name->name); } @@ -96,7 +96,7 @@ bool tox_event_friend_name_pack( && bin_pack_bin(bp, event->name, event->name_length); } -static bool tox_event_friend_name_unpack_into(non_null() Tox_Event_Friend_Name *event, non_null() Bin_Unpack *bu) +static bool tox_event_friend_name_unpack_into(Tox_Event_Friend_Name *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -139,7 +139,7 @@ void tox_event_friend_name_free(Tox_Event_Friend_Name *friend_name, const Memory mem_delete(mem, friend_name); } -static Tox_Event_Friend_Name *tox_events_add_friend_name(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Friend_Name *tox_events_add_friend_name(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Friend_Name *const friend_name = tox_event_friend_name_new(mem); @@ -172,7 +172,7 @@ bool tox_event_friend_name_unpack( return tox_event_friend_name_unpack_into(*event, bu); } -static Tox_Event_Friend_Name *tox_event_friend_name_alloc(non_null() void *user_data) +static Tox_Event_Friend_Name *tox_event_friend_name_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/friend_read_receipt.c b/toxcore/events/friend_read_receipt.c index b4b7e010a..b4443bd38 100644 --- a/toxcore/events/friend_read_receipt.c +++ b/toxcore/events/friend_read_receipt.c @@ -26,7 +26,7 @@ struct Tox_Event_Friend_Read_Receipt { uint32_t message_id; }; -static void tox_event_friend_read_receipt_set_friend_number(non_null() Tox_Event_Friend_Read_Receipt *friend_read_receipt, uint32_t friend_number) +static void tox_event_friend_read_receipt_set_friend_number(Tox_Event_Friend_Read_Receipt *_Nonnull friend_read_receipt, uint32_t friend_number) { assert(friend_read_receipt != nullptr); friend_read_receipt->friend_number = friend_number; @@ -37,7 +37,7 @@ uint32_t tox_event_friend_read_receipt_get_friend_number(const Tox_Event_Friend_ return friend_read_receipt->friend_number; } -static void tox_event_friend_read_receipt_set_message_id(non_null() Tox_Event_Friend_Read_Receipt *friend_read_receipt, uint32_t message_id) +static void tox_event_friend_read_receipt_set_message_id(Tox_Event_Friend_Read_Receipt *_Nonnull friend_read_receipt, uint32_t message_id) { assert(friend_read_receipt != nullptr); friend_read_receipt->message_id = message_id; @@ -48,13 +48,13 @@ uint32_t tox_event_friend_read_receipt_get_message_id(const Tox_Event_Friend_Rea return friend_read_receipt->message_id; } -static void tox_event_friend_read_receipt_construct(non_null() Tox_Event_Friend_Read_Receipt *friend_read_receipt) +static void tox_event_friend_read_receipt_construct(Tox_Event_Friend_Read_Receipt *_Nonnull friend_read_receipt) { *friend_read_receipt = (Tox_Event_Friend_Read_Receipt) { 0 }; } -static void tox_event_friend_read_receipt_destruct(non_null() Tox_Event_Friend_Read_Receipt *friend_read_receipt, non_null() const Memory *mem) +static void tox_event_friend_read_receipt_destruct(Tox_Event_Friend_Read_Receipt *_Nonnull friend_read_receipt, const Memory *_Nonnull mem) { return; } @@ -67,7 +67,7 @@ bool tox_event_friend_read_receipt_pack( && bin_pack_u32(bp, event->message_id); } -static bool tox_event_friend_read_receipt_unpack_into(non_null() Tox_Event_Friend_Read_Receipt *event, non_null() Bin_Unpack *bu) +static bool tox_event_friend_read_receipt_unpack_into(Tox_Event_Friend_Read_Receipt *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -110,7 +110,7 @@ void tox_event_friend_read_receipt_free(Tox_Event_Friend_Read_Receipt *friend_re mem_delete(mem, friend_read_receipt); } -static Tox_Event_Friend_Read_Receipt *tox_events_add_friend_read_receipt(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Friend_Read_Receipt *tox_events_add_friend_read_receipt(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Friend_Read_Receipt *const friend_read_receipt = tox_event_friend_read_receipt_new(mem); @@ -143,7 +143,7 @@ bool tox_event_friend_read_receipt_unpack( return tox_event_friend_read_receipt_unpack_into(*event, bu); } -static Tox_Event_Friend_Read_Receipt *tox_event_friend_read_receipt_alloc(non_null() void *user_data) +static Tox_Event_Friend_Read_Receipt *tox_event_friend_read_receipt_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/friend_request.c b/toxcore/events/friend_request.c index e29b23f57..b331d11ef 100644 --- a/toxcore/events/friend_request.c +++ b/toxcore/events/friend_request.c @@ -29,7 +29,7 @@ struct Tox_Event_Friend_Request { uint32_t message_length; }; -static bool tox_event_friend_request_set_public_key(non_null() Tox_Event_Friend_Request *friend_request, non_null() const uint8_t *public_key) +static bool tox_event_friend_request_set_public_key(Tox_Event_Friend_Request *_Nonnull friend_request, const uint8_t *_Nonnull public_key) { assert(friend_request != nullptr); @@ -42,7 +42,7 @@ const uint8_t *tox_event_friend_request_get_public_key(const Tox_Event_Friend_Re return friend_request->public_key; } -static bool tox_event_friend_request_set_message(non_null() Tox_Event_Friend_Request *friend_request, non_null() const uint8_t *message, uint32_t message_length, non_null() const Memory *mem) +static bool tox_event_friend_request_set_message(Tox_Event_Friend_Request *_Nonnull friend_request, const uint8_t *_Nonnull message, uint32_t message_length, const Memory *_Nonnull mem) { assert(friend_request != nullptr); @@ -74,7 +74,7 @@ const uint8_t *tox_event_friend_request_get_message(const Tox_Event_Friend_Reque return friend_request->message; } -static void tox_event_friend_request_construct(non_null() Tox_Event_Friend_Request *friend_request) +static void tox_event_friend_request_construct(Tox_Event_Friend_Request *_Nonnull friend_request) { *friend_request = (Tox_Event_Friend_Request) { { @@ -82,7 +82,7 @@ static void tox_event_friend_request_construct(non_null() Tox_Event_Friend_Reque } }; } -static void tox_event_friend_request_destruct(non_null() Tox_Event_Friend_Request *friend_request, non_null() const Memory *mem) +static void tox_event_friend_request_destruct(Tox_Event_Friend_Request *_Nonnull friend_request, const Memory *_Nonnull mem) { mem_delete(mem, friend_request->message); } @@ -95,7 +95,7 @@ bool tox_event_friend_request_pack( && bin_pack_bin(bp, event->message, event->message_length); } -static bool tox_event_friend_request_unpack_into(non_null() Tox_Event_Friend_Request *event, non_null() Bin_Unpack *bu) +static bool tox_event_friend_request_unpack_into(Tox_Event_Friend_Request *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -133,7 +133,7 @@ void tox_event_friend_request_free(Tox_Event_Friend_Request *friend_request, con mem_delete(mem, friend_request); } -static Tox_Event_Friend_Request *tox_events_add_friend_request(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Friend_Request *tox_events_add_friend_request(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Friend_Request *const friend_request = tox_event_friend_request_new(mem); @@ -166,7 +166,7 @@ bool tox_event_friend_request_unpack( return tox_event_friend_request_unpack_into(*event, bu); } -static Tox_Event_Friend_Request *tox_event_friend_request_alloc(non_null() void *user_data) +static Tox_Event_Friend_Request *tox_event_friend_request_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/friend_status.c b/toxcore/events/friend_status.c index c8d7cd199..99d39bc87 100644 --- a/toxcore/events/friend_status.c +++ b/toxcore/events/friend_status.c @@ -28,7 +28,7 @@ struct Tox_Event_Friend_Status { Tox_User_Status status; }; -static void tox_event_friend_status_set_friend_number(non_null() Tox_Event_Friend_Status *friend_status, uint32_t friend_number) +static void tox_event_friend_status_set_friend_number(Tox_Event_Friend_Status *_Nonnull friend_status, uint32_t friend_number) { assert(friend_status != nullptr); friend_status->friend_number = friend_number; @@ -39,7 +39,7 @@ uint32_t tox_event_friend_status_get_friend_number(const Tox_Event_Friend_Status return friend_status->friend_number; } -static void tox_event_friend_status_set_status(non_null() Tox_Event_Friend_Status *friend_status, Tox_User_Status status) +static void tox_event_friend_status_set_status(Tox_Event_Friend_Status *_Nonnull friend_status, Tox_User_Status status) { assert(friend_status != nullptr); friend_status->status = status; @@ -50,13 +50,13 @@ Tox_User_Status tox_event_friend_status_get_status(const Tox_Event_Friend_Status return friend_status->status; } -static void tox_event_friend_status_construct(non_null() Tox_Event_Friend_Status *friend_status) +static void tox_event_friend_status_construct(Tox_Event_Friend_Status *_Nonnull friend_status) { *friend_status = (Tox_Event_Friend_Status) { 0 }; } -static void tox_event_friend_status_destruct(non_null() Tox_Event_Friend_Status *friend_status, non_null() const Memory *mem) +static void tox_event_friend_status_destruct(Tox_Event_Friend_Status *_Nonnull friend_status, const Memory *_Nonnull mem) { return; } @@ -69,7 +69,7 @@ bool tox_event_friend_status_pack( && tox_user_status_pack(event->status, bp); } -static bool tox_event_friend_status_unpack_into(non_null() Tox_Event_Friend_Status *event, non_null() Bin_Unpack *bu) +static bool tox_event_friend_status_unpack_into(Tox_Event_Friend_Status *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -112,7 +112,7 @@ void tox_event_friend_status_free(Tox_Event_Friend_Status *friend_status, const mem_delete(mem, friend_status); } -static Tox_Event_Friend_Status *tox_events_add_friend_status(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Friend_Status *tox_events_add_friend_status(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Friend_Status *const friend_status = tox_event_friend_status_new(mem); @@ -145,7 +145,7 @@ bool tox_event_friend_status_unpack( return tox_event_friend_status_unpack_into(*event, bu); } -static Tox_Event_Friend_Status *tox_event_friend_status_alloc(non_null() void *user_data) +static Tox_Event_Friend_Status *tox_event_friend_status_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/friend_status_message.c b/toxcore/events/friend_status_message.c index 2cc364742..c2e77d9cd 100644 --- a/toxcore/events/friend_status_message.c +++ b/toxcore/events/friend_status_message.c @@ -29,7 +29,7 @@ struct Tox_Event_Friend_Status_Message { uint32_t message_length; }; -static void tox_event_friend_status_message_set_friend_number(non_null() Tox_Event_Friend_Status_Message *friend_status_message, uint32_t friend_number) +static void tox_event_friend_status_message_set_friend_number(Tox_Event_Friend_Status_Message *_Nonnull friend_status_message, uint32_t friend_number) { assert(friend_status_message != nullptr); friend_status_message->friend_number = friend_number; @@ -40,8 +40,8 @@ uint32_t tox_event_friend_status_message_get_friend_number(const Tox_Event_Frien return friend_status_message->friend_number; } -static bool tox_event_friend_status_message_set_message(non_null() Tox_Event_Friend_Status_Message *friend_status_message, - nullable() const uint8_t *message, uint32_t message_length) +static bool tox_event_friend_status_message_set_message(Tox_Event_Friend_Status_Message *_Nonnull friend_status_message, + const uint8_t *_Nullable message, uint32_t message_length) { assert(friend_status_message != nullptr); if (friend_status_message->message != nullptr) { @@ -77,13 +77,13 @@ const uint8_t *tox_event_friend_status_message_get_message(const Tox_Event_Frien return friend_status_message->message; } -static void tox_event_friend_status_message_construct(non_null() Tox_Event_Friend_Status_Message *friend_status_message) +static void tox_event_friend_status_message_construct(Tox_Event_Friend_Status_Message *_Nonnull friend_status_message) { *friend_status_message = (Tox_Event_Friend_Status_Message) { 0 }; } -static void tox_event_friend_status_message_destruct(non_null() Tox_Event_Friend_Status_Message *friend_status_message, non_null() const Memory *mem) +static void tox_event_friend_status_message_destruct(Tox_Event_Friend_Status_Message *_Nonnull friend_status_message, const Memory *_Nonnull mem) { free(friend_status_message->message); } @@ -96,7 +96,7 @@ bool tox_event_friend_status_message_pack( && bin_pack_bin(bp, event->message, event->message_length); } -static bool tox_event_friend_status_message_unpack_into(non_null() Tox_Event_Friend_Status_Message *event, non_null() Bin_Unpack *bu) +static bool tox_event_friend_status_message_unpack_into(Tox_Event_Friend_Status_Message *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -139,7 +139,7 @@ void tox_event_friend_status_message_free(Tox_Event_Friend_Status_Message *frien mem_delete(mem, friend_status_message); } -static Tox_Event_Friend_Status_Message *tox_events_add_friend_status_message(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Friend_Status_Message *tox_events_add_friend_status_message(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Friend_Status_Message *const friend_status_message = tox_event_friend_status_message_new(mem); @@ -172,7 +172,7 @@ bool tox_event_friend_status_message_unpack( return tox_event_friend_status_message_unpack_into(*event, bu); } -static Tox_Event_Friend_Status_Message *tox_event_friend_status_message_alloc(non_null() void *user_data) +static Tox_Event_Friend_Status_Message *tox_event_friend_status_message_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/friend_typing.c b/toxcore/events/friend_typing.c index d4ee8ac70..fda20baf9 100644 --- a/toxcore/events/friend_typing.c +++ b/toxcore/events/friend_typing.c @@ -26,7 +26,7 @@ struct Tox_Event_Friend_Typing { bool typing; }; -static void tox_event_friend_typing_set_friend_number(non_null() Tox_Event_Friend_Typing *friend_typing, uint32_t friend_number) +static void tox_event_friend_typing_set_friend_number(Tox_Event_Friend_Typing *_Nonnull friend_typing, uint32_t friend_number) { assert(friend_typing != nullptr); friend_typing->friend_number = friend_number; @@ -37,7 +37,7 @@ uint32_t tox_event_friend_typing_get_friend_number(const Tox_Event_Friend_Typing return friend_typing->friend_number; } -static void tox_event_friend_typing_set_typing(non_null() Tox_Event_Friend_Typing *friend_typing, bool typing) +static void tox_event_friend_typing_set_typing(Tox_Event_Friend_Typing *_Nonnull friend_typing, bool typing) { assert(friend_typing != nullptr); friend_typing->typing = typing; @@ -48,13 +48,13 @@ bool tox_event_friend_typing_get_typing(const Tox_Event_Friend_Typing *friend_ty return friend_typing->typing; } -static void tox_event_friend_typing_construct(non_null() Tox_Event_Friend_Typing *friend_typing) +static void tox_event_friend_typing_construct(Tox_Event_Friend_Typing *_Nonnull friend_typing) { *friend_typing = (Tox_Event_Friend_Typing) { 0 }; } -static void tox_event_friend_typing_destruct(non_null() Tox_Event_Friend_Typing *friend_typing, non_null() const Memory *mem) +static void tox_event_friend_typing_destruct(Tox_Event_Friend_Typing *_Nonnull friend_typing, const Memory *_Nonnull mem) { return; } @@ -67,7 +67,7 @@ bool tox_event_friend_typing_pack( && bin_pack_bool(bp, event->typing); } -static bool tox_event_friend_typing_unpack_into(non_null() Tox_Event_Friend_Typing *event, non_null() Bin_Unpack *bu) +static bool tox_event_friend_typing_unpack_into(Tox_Event_Friend_Typing *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -110,7 +110,7 @@ void tox_event_friend_typing_free(Tox_Event_Friend_Typing *friend_typing, const mem_delete(mem, friend_typing); } -static Tox_Event_Friend_Typing *tox_events_add_friend_typing(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Friend_Typing *tox_events_add_friend_typing(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Friend_Typing *const friend_typing = tox_event_friend_typing_new(mem); @@ -143,7 +143,7 @@ bool tox_event_friend_typing_unpack( return tox_event_friend_typing_unpack_into(*event, bu); } -static Tox_Event_Friend_Typing *tox_event_friend_typing_alloc(non_null() void *user_data) +static Tox_Event_Friend_Typing *tox_event_friend_typing_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_custom_packet.c b/toxcore/events/group_custom_packet.c index b2de1ffce..65af4d489 100644 --- a/toxcore/events/group_custom_packet.c +++ b/toxcore/events/group_custom_packet.c @@ -30,7 +30,7 @@ struct Tox_Event_Group_Custom_Packet { uint32_t data_length; }; -static void tox_event_group_custom_packet_set_group_number(non_null() Tox_Event_Group_Custom_Packet *group_custom_packet, uint32_t group_number) +static void tox_event_group_custom_packet_set_group_number(Tox_Event_Group_Custom_Packet *_Nonnull group_custom_packet, uint32_t group_number) { assert(group_custom_packet != nullptr); group_custom_packet->group_number = group_number; @@ -41,7 +41,7 @@ uint32_t tox_event_group_custom_packet_get_group_number(const Tox_Event_Group_Cu return group_custom_packet->group_number; } -static void tox_event_group_custom_packet_set_peer_id(non_null() Tox_Event_Group_Custom_Packet *group_custom_packet, uint32_t peer_id) +static void tox_event_group_custom_packet_set_peer_id(Tox_Event_Group_Custom_Packet *_Nonnull group_custom_packet, uint32_t peer_id) { assert(group_custom_packet != nullptr); group_custom_packet->peer_id = peer_id; @@ -52,8 +52,8 @@ uint32_t tox_event_group_custom_packet_get_peer_id(const Tox_Event_Group_Custom_ return group_custom_packet->peer_id; } -static bool tox_event_group_custom_packet_set_data(non_null() Tox_Event_Group_Custom_Packet *group_custom_packet, - nullable() const uint8_t *data, uint32_t data_length) +static bool tox_event_group_custom_packet_set_data(Tox_Event_Group_Custom_Packet *_Nonnull group_custom_packet, + const uint8_t *_Nullable data, uint32_t data_length) { assert(group_custom_packet != nullptr); if (group_custom_packet->data != nullptr) { @@ -89,13 +89,13 @@ const uint8_t *tox_event_group_custom_packet_get_data(const Tox_Event_Group_Cust return group_custom_packet->data; } -static void tox_event_group_custom_packet_construct(non_null() Tox_Event_Group_Custom_Packet *group_custom_packet) +static void tox_event_group_custom_packet_construct(Tox_Event_Group_Custom_Packet *_Nonnull group_custom_packet) { *group_custom_packet = (Tox_Event_Group_Custom_Packet) { 0 }; } -static void tox_event_group_custom_packet_destruct(non_null() Tox_Event_Group_Custom_Packet *group_custom_packet, non_null() const Memory *mem) +static void tox_event_group_custom_packet_destruct(Tox_Event_Group_Custom_Packet *_Nonnull group_custom_packet, const Memory *_Nonnull mem) { free(group_custom_packet->data); } @@ -109,7 +109,7 @@ bool tox_event_group_custom_packet_pack( && bin_pack_bin(bp, event->data, event->data_length); } -static bool tox_event_group_custom_packet_unpack_into(non_null() Tox_Event_Group_Custom_Packet *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_custom_packet_unpack_into(Tox_Event_Group_Custom_Packet *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 3, nullptr)) { @@ -153,7 +153,7 @@ void tox_event_group_custom_packet_free(Tox_Event_Group_Custom_Packet *group_cus mem_delete(mem, group_custom_packet); } -static Tox_Event_Group_Custom_Packet *tox_events_add_group_custom_packet(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Custom_Packet *tox_events_add_group_custom_packet(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Custom_Packet *const group_custom_packet = tox_event_group_custom_packet_new(mem); @@ -186,7 +186,7 @@ bool tox_event_group_custom_packet_unpack( return tox_event_group_custom_packet_unpack_into(*event, bu); } -static Tox_Event_Group_Custom_Packet *tox_event_group_custom_packet_alloc(non_null() void *user_data) +static Tox_Event_Group_Custom_Packet *tox_event_group_custom_packet_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_custom_private_packet.c b/toxcore/events/group_custom_private_packet.c index 5558b904f..eb5810088 100644 --- a/toxcore/events/group_custom_private_packet.c +++ b/toxcore/events/group_custom_private_packet.c @@ -30,7 +30,7 @@ struct Tox_Event_Group_Custom_Private_Packet { uint32_t data_length; }; -static void tox_event_group_custom_private_packet_set_group_number(non_null() Tox_Event_Group_Custom_Private_Packet *group_custom_private_packet, uint32_t group_number) +static void tox_event_group_custom_private_packet_set_group_number(Tox_Event_Group_Custom_Private_Packet *_Nonnull group_custom_private_packet, uint32_t group_number) { assert(group_custom_private_packet != nullptr); group_custom_private_packet->group_number = group_number; @@ -41,7 +41,7 @@ uint32_t tox_event_group_custom_private_packet_get_group_number(const Tox_Event_ return group_custom_private_packet->group_number; } -static void tox_event_group_custom_private_packet_set_peer_id(non_null() Tox_Event_Group_Custom_Private_Packet *group_custom_private_packet, uint32_t peer_id) +static void tox_event_group_custom_private_packet_set_peer_id(Tox_Event_Group_Custom_Private_Packet *_Nonnull group_custom_private_packet, uint32_t peer_id) { assert(group_custom_private_packet != nullptr); group_custom_private_packet->peer_id = peer_id; @@ -52,8 +52,8 @@ uint32_t tox_event_group_custom_private_packet_get_peer_id(const Tox_Event_Group return group_custom_private_packet->peer_id; } -static bool tox_event_group_custom_private_packet_set_data(non_null() Tox_Event_Group_Custom_Private_Packet *group_custom_private_packet, - nullable() const uint8_t *data, uint32_t data_length) +static bool tox_event_group_custom_private_packet_set_data(Tox_Event_Group_Custom_Private_Packet *_Nonnull group_custom_private_packet, + const uint8_t *_Nullable data, uint32_t data_length) { assert(group_custom_private_packet != nullptr); if (group_custom_private_packet->data != nullptr) { @@ -89,13 +89,13 @@ const uint8_t *tox_event_group_custom_private_packet_get_data(const Tox_Event_Gr return group_custom_private_packet->data; } -static void tox_event_group_custom_private_packet_construct(non_null() Tox_Event_Group_Custom_Private_Packet *group_custom_private_packet) +static void tox_event_group_custom_private_packet_construct(Tox_Event_Group_Custom_Private_Packet *_Nonnull group_custom_private_packet) { *group_custom_private_packet = (Tox_Event_Group_Custom_Private_Packet) { 0 }; } -static void tox_event_group_custom_private_packet_destruct(non_null() Tox_Event_Group_Custom_Private_Packet *group_custom_private_packet, non_null() const Memory *mem) +static void tox_event_group_custom_private_packet_destruct(Tox_Event_Group_Custom_Private_Packet *_Nonnull group_custom_private_packet, const Memory *_Nonnull mem) { free(group_custom_private_packet->data); } @@ -109,7 +109,7 @@ bool tox_event_group_custom_private_packet_pack( && bin_pack_bin(bp, event->data, event->data_length); } -static bool tox_event_group_custom_private_packet_unpack_into(non_null() Tox_Event_Group_Custom_Private_Packet *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_custom_private_packet_unpack_into(Tox_Event_Group_Custom_Private_Packet *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 3, nullptr)) { @@ -153,7 +153,7 @@ void tox_event_group_custom_private_packet_free(Tox_Event_Group_Custom_Private_P mem_delete(mem, group_custom_private_packet); } -static Tox_Event_Group_Custom_Private_Packet *tox_events_add_group_custom_private_packet(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Custom_Private_Packet *tox_events_add_group_custom_private_packet(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Custom_Private_Packet *const group_custom_private_packet = tox_event_group_custom_private_packet_new(mem); @@ -186,7 +186,7 @@ bool tox_event_group_custom_private_packet_unpack( return tox_event_group_custom_private_packet_unpack_into(*event, bu); } -static Tox_Event_Group_Custom_Private_Packet *tox_event_group_custom_private_packet_alloc(non_null() void *user_data) +static Tox_Event_Group_Custom_Private_Packet *tox_event_group_custom_private_packet_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_invite.c b/toxcore/events/group_invite.c index de6cf6fd3..47959e5de 100644 --- a/toxcore/events/group_invite.c +++ b/toxcore/events/group_invite.c @@ -31,7 +31,7 @@ struct Tox_Event_Group_Invite { uint32_t group_name_length; }; -static void tox_event_group_invite_set_friend_number(non_null() Tox_Event_Group_Invite *group_invite, uint32_t friend_number) +static void tox_event_group_invite_set_friend_number(Tox_Event_Group_Invite *_Nonnull group_invite, uint32_t friend_number) { assert(group_invite != nullptr); group_invite->friend_number = friend_number; @@ -42,8 +42,8 @@ uint32_t tox_event_group_invite_get_friend_number(const Tox_Event_Group_Invite * return group_invite->friend_number; } -static bool tox_event_group_invite_set_invite_data(non_null() Tox_Event_Group_Invite *group_invite, - nullable() const uint8_t *invite_data, uint32_t invite_data_length) +static bool tox_event_group_invite_set_invite_data(Tox_Event_Group_Invite *_Nonnull group_invite, + const uint8_t *_Nullable invite_data, uint32_t invite_data_length) { assert(group_invite != nullptr); if (group_invite->invite_data != nullptr) { @@ -79,8 +79,8 @@ const uint8_t *tox_event_group_invite_get_invite_data(const Tox_Event_Group_Invi return group_invite->invite_data; } -static bool tox_event_group_invite_set_group_name(non_null() Tox_Event_Group_Invite *group_invite, - nullable() const uint8_t *group_name, uint32_t group_name_length) +static bool tox_event_group_invite_set_group_name(Tox_Event_Group_Invite *_Nonnull group_invite, + const uint8_t *_Nullable group_name, uint32_t group_name_length) { assert(group_invite != nullptr); if (group_invite->group_name != nullptr) { @@ -116,13 +116,13 @@ const uint8_t *tox_event_group_invite_get_group_name(const Tox_Event_Group_Invit return group_invite->group_name; } -static void tox_event_group_invite_construct(non_null() Tox_Event_Group_Invite *group_invite) +static void tox_event_group_invite_construct(Tox_Event_Group_Invite *_Nonnull group_invite) { *group_invite = (Tox_Event_Group_Invite) { 0 }; } -static void tox_event_group_invite_destruct(non_null() Tox_Event_Group_Invite *group_invite, non_null() const Memory *mem) +static void tox_event_group_invite_destruct(Tox_Event_Group_Invite *_Nonnull group_invite, const Memory *_Nonnull mem) { free(group_invite->invite_data); free(group_invite->group_name); @@ -137,7 +137,7 @@ bool tox_event_group_invite_pack( && bin_pack_bin(bp, event->group_name, event->group_name_length); } -static bool tox_event_group_invite_unpack_into(non_null() Tox_Event_Group_Invite *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_invite_unpack_into(Tox_Event_Group_Invite *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 3, nullptr)) { @@ -181,7 +181,7 @@ void tox_event_group_invite_free(Tox_Event_Group_Invite *group_invite, const Mem mem_delete(mem, group_invite); } -static Tox_Event_Group_Invite *tox_events_add_group_invite(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Invite *tox_events_add_group_invite(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Invite *const group_invite = tox_event_group_invite_new(mem); @@ -214,7 +214,7 @@ bool tox_event_group_invite_unpack( return tox_event_group_invite_unpack_into(*event, bu); } -static Tox_Event_Group_Invite *tox_event_group_invite_alloc(non_null() void *user_data) +static Tox_Event_Group_Invite *tox_event_group_invite_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_join_fail.c b/toxcore/events/group_join_fail.c index d0c2ff267..8931f7b74 100644 --- a/toxcore/events/group_join_fail.c +++ b/toxcore/events/group_join_fail.c @@ -28,7 +28,7 @@ struct Tox_Event_Group_Join_Fail { Tox_Group_Join_Fail fail_type; }; -static void tox_event_group_join_fail_set_group_number(non_null() Tox_Event_Group_Join_Fail *group_join_fail, uint32_t group_number) +static void tox_event_group_join_fail_set_group_number(Tox_Event_Group_Join_Fail *_Nonnull group_join_fail, uint32_t group_number) { assert(group_join_fail != nullptr); group_join_fail->group_number = group_number; @@ -39,7 +39,7 @@ uint32_t tox_event_group_join_fail_get_group_number(const Tox_Event_Group_Join_F return group_join_fail->group_number; } -static void tox_event_group_join_fail_set_fail_type(non_null() Tox_Event_Group_Join_Fail *group_join_fail, Tox_Group_Join_Fail fail_type) +static void tox_event_group_join_fail_set_fail_type(Tox_Event_Group_Join_Fail *_Nonnull group_join_fail, Tox_Group_Join_Fail fail_type) { assert(group_join_fail != nullptr); group_join_fail->fail_type = fail_type; @@ -50,13 +50,13 @@ Tox_Group_Join_Fail tox_event_group_join_fail_get_fail_type(const Tox_Event_Grou return group_join_fail->fail_type; } -static void tox_event_group_join_fail_construct(non_null() Tox_Event_Group_Join_Fail *group_join_fail) +static void tox_event_group_join_fail_construct(Tox_Event_Group_Join_Fail *_Nonnull group_join_fail) { *group_join_fail = (Tox_Event_Group_Join_Fail) { 0 }; } -static void tox_event_group_join_fail_destruct(non_null() Tox_Event_Group_Join_Fail *group_join_fail, non_null() const Memory *mem) +static void tox_event_group_join_fail_destruct(Tox_Event_Group_Join_Fail *_Nonnull group_join_fail, const Memory *_Nonnull mem) { return; } @@ -69,7 +69,7 @@ bool tox_event_group_join_fail_pack( && tox_group_join_fail_pack(event->fail_type, bp); } -static bool tox_event_group_join_fail_unpack_into(non_null() Tox_Event_Group_Join_Fail *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_join_fail_unpack_into(Tox_Event_Group_Join_Fail *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -112,7 +112,7 @@ void tox_event_group_join_fail_free(Tox_Event_Group_Join_Fail *group_join_fail, mem_delete(mem, group_join_fail); } -static Tox_Event_Group_Join_Fail *tox_events_add_group_join_fail(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Join_Fail *tox_events_add_group_join_fail(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Join_Fail *const group_join_fail = tox_event_group_join_fail_new(mem); @@ -145,7 +145,7 @@ bool tox_event_group_join_fail_unpack( return tox_event_group_join_fail_unpack_into(*event, bu); } -static Tox_Event_Group_Join_Fail *tox_event_group_join_fail_alloc(non_null() void *user_data) +static Tox_Event_Group_Join_Fail *tox_event_group_join_fail_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_message.c b/toxcore/events/group_message.c index 28386b0d7..b8da841f5 100644 --- a/toxcore/events/group_message.c +++ b/toxcore/events/group_message.c @@ -34,7 +34,7 @@ struct Tox_Event_Group_Message { uint32_t message_id; }; -static void tox_event_group_message_set_group_number(non_null() Tox_Event_Group_Message *group_message, uint32_t group_number) +static void tox_event_group_message_set_group_number(Tox_Event_Group_Message *_Nonnull group_message, uint32_t group_number) { assert(group_message != nullptr); group_message->group_number = group_number; @@ -45,7 +45,7 @@ uint32_t tox_event_group_message_get_group_number(const Tox_Event_Group_Message return group_message->group_number; } -static void tox_event_group_message_set_peer_id(non_null() Tox_Event_Group_Message *group_message, uint32_t peer_id) +static void tox_event_group_message_set_peer_id(Tox_Event_Group_Message *_Nonnull group_message, uint32_t peer_id) { assert(group_message != nullptr); group_message->peer_id = peer_id; @@ -56,7 +56,7 @@ uint32_t tox_event_group_message_get_peer_id(const Tox_Event_Group_Message *grou return group_message->peer_id; } -static void tox_event_group_message_set_message_type(non_null() Tox_Event_Group_Message *group_message, Tox_Message_Type message_type) +static void tox_event_group_message_set_message_type(Tox_Event_Group_Message *_Nonnull group_message, Tox_Message_Type message_type) { assert(group_message != nullptr); group_message->message_type = message_type; @@ -67,8 +67,8 @@ Tox_Message_Type tox_event_group_message_get_message_type(const Tox_Event_Group_ return group_message->message_type; } -static bool tox_event_group_message_set_message(non_null() Tox_Event_Group_Message *group_message, - nullable() const uint8_t *message, uint32_t message_length) +static bool tox_event_group_message_set_message(Tox_Event_Group_Message *_Nonnull group_message, + const uint8_t *_Nullable message, uint32_t message_length) { assert(group_message != nullptr); if (group_message->message != nullptr) { @@ -104,7 +104,7 @@ const uint8_t *tox_event_group_message_get_message(const Tox_Event_Group_Message return group_message->message; } -static void tox_event_group_message_set_message_id(non_null() Tox_Event_Group_Message *group_message, uint32_t message_id) +static void tox_event_group_message_set_message_id(Tox_Event_Group_Message *_Nonnull group_message, uint32_t message_id) { assert(group_message != nullptr); group_message->message_id = message_id; @@ -115,13 +115,13 @@ uint32_t tox_event_group_message_get_message_id(const Tox_Event_Group_Message *g return group_message->message_id; } -static void tox_event_group_message_construct(non_null() Tox_Event_Group_Message *group_message) +static void tox_event_group_message_construct(Tox_Event_Group_Message *_Nonnull group_message) { *group_message = (Tox_Event_Group_Message) { 0 }; } -static void tox_event_group_message_destruct(non_null() Tox_Event_Group_Message *group_message, non_null() const Memory *mem) +static void tox_event_group_message_destruct(Tox_Event_Group_Message *_Nonnull group_message, const Memory *_Nonnull mem) { free(group_message->message); } @@ -137,7 +137,7 @@ bool tox_event_group_message_pack( && bin_pack_u32(bp, event->message_id); } -static bool tox_event_group_message_unpack_into(non_null() Tox_Event_Group_Message *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_message_unpack_into(Tox_Event_Group_Message *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 5, nullptr)) { @@ -183,7 +183,7 @@ void tox_event_group_message_free(Tox_Event_Group_Message *group_message, const mem_delete(mem, group_message); } -static Tox_Event_Group_Message *tox_events_add_group_message(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Message *tox_events_add_group_message(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Message *const group_message = tox_event_group_message_new(mem); @@ -216,7 +216,7 @@ bool tox_event_group_message_unpack( return tox_event_group_message_unpack_into(*event, bu); } -static Tox_Event_Group_Message *tox_event_group_message_alloc(non_null() void *user_data) +static Tox_Event_Group_Message *tox_event_group_message_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_moderation.c b/toxcore/events/group_moderation.c index f268943c8..d6224796b 100644 --- a/toxcore/events/group_moderation.c +++ b/toxcore/events/group_moderation.c @@ -30,7 +30,7 @@ struct Tox_Event_Group_Moderation { Tox_Group_Mod_Event mod_type; }; -static void tox_event_group_moderation_set_group_number(non_null() Tox_Event_Group_Moderation *group_moderation, uint32_t group_number) +static void tox_event_group_moderation_set_group_number(Tox_Event_Group_Moderation *_Nonnull group_moderation, uint32_t group_number) { assert(group_moderation != nullptr); group_moderation->group_number = group_number; @@ -41,7 +41,7 @@ uint32_t tox_event_group_moderation_get_group_number(const Tox_Event_Group_Moder return group_moderation->group_number; } -static void tox_event_group_moderation_set_source_peer_id(non_null() Tox_Event_Group_Moderation *group_moderation, uint32_t source_peer_id) +static void tox_event_group_moderation_set_source_peer_id(Tox_Event_Group_Moderation *_Nonnull group_moderation, uint32_t source_peer_id) { assert(group_moderation != nullptr); group_moderation->source_peer_id = source_peer_id; @@ -52,7 +52,7 @@ uint32_t tox_event_group_moderation_get_source_peer_id(const Tox_Event_Group_Mod return group_moderation->source_peer_id; } -static void tox_event_group_moderation_set_target_peer_id(non_null() Tox_Event_Group_Moderation *group_moderation, uint32_t target_peer_id) +static void tox_event_group_moderation_set_target_peer_id(Tox_Event_Group_Moderation *_Nonnull group_moderation, uint32_t target_peer_id) { assert(group_moderation != nullptr); group_moderation->target_peer_id = target_peer_id; @@ -63,7 +63,7 @@ uint32_t tox_event_group_moderation_get_target_peer_id(const Tox_Event_Group_Mod return group_moderation->target_peer_id; } -static void tox_event_group_moderation_set_mod_type(non_null() Tox_Event_Group_Moderation *group_moderation, Tox_Group_Mod_Event mod_type) +static void tox_event_group_moderation_set_mod_type(Tox_Event_Group_Moderation *_Nonnull group_moderation, Tox_Group_Mod_Event mod_type) { assert(group_moderation != nullptr); group_moderation->mod_type = mod_type; @@ -74,13 +74,13 @@ Tox_Group_Mod_Event tox_event_group_moderation_get_mod_type(const Tox_Event_Grou return group_moderation->mod_type; } -static void tox_event_group_moderation_construct(non_null() Tox_Event_Group_Moderation *group_moderation) +static void tox_event_group_moderation_construct(Tox_Event_Group_Moderation *_Nonnull group_moderation) { *group_moderation = (Tox_Event_Group_Moderation) { 0 }; } -static void tox_event_group_moderation_destruct(non_null() Tox_Event_Group_Moderation *group_moderation, non_null() const Memory *mem) +static void tox_event_group_moderation_destruct(Tox_Event_Group_Moderation *_Nonnull group_moderation, const Memory *_Nonnull mem) { return; } @@ -95,7 +95,7 @@ bool tox_event_group_moderation_pack( && tox_group_mod_event_pack(event->mod_type, bp); } -static bool tox_event_group_moderation_unpack_into(non_null() Tox_Event_Group_Moderation *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_moderation_unpack_into(Tox_Event_Group_Moderation *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 4, nullptr)) { @@ -140,7 +140,7 @@ void tox_event_group_moderation_free(Tox_Event_Group_Moderation *group_moderatio mem_delete(mem, group_moderation); } -static Tox_Event_Group_Moderation *tox_events_add_group_moderation(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Moderation *tox_events_add_group_moderation(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Moderation *const group_moderation = tox_event_group_moderation_new(mem); @@ -173,7 +173,7 @@ bool tox_event_group_moderation_unpack( return tox_event_group_moderation_unpack_into(*event, bu); } -static Tox_Event_Group_Moderation *tox_event_group_moderation_alloc(non_null() void *user_data) +static Tox_Event_Group_Moderation *tox_event_group_moderation_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_password.c b/toxcore/events/group_password.c index 02665579a..5c692339e 100644 --- a/toxcore/events/group_password.c +++ b/toxcore/events/group_password.c @@ -29,7 +29,7 @@ struct Tox_Event_Group_Password { uint32_t password_length; }; -static void tox_event_group_password_set_group_number(non_null() Tox_Event_Group_Password *group_password, uint32_t group_number) +static void tox_event_group_password_set_group_number(Tox_Event_Group_Password *_Nonnull group_password, uint32_t group_number) { assert(group_password != nullptr); group_password->group_number = group_number; @@ -40,8 +40,8 @@ uint32_t tox_event_group_password_get_group_number(const Tox_Event_Group_Passwor return group_password->group_number; } -static bool tox_event_group_password_set_password(non_null() Tox_Event_Group_Password *group_password, - nullable() const uint8_t *password, uint32_t password_length) +static bool tox_event_group_password_set_password(Tox_Event_Group_Password *_Nonnull group_password, + const uint8_t *_Nullable password, uint32_t password_length) { assert(group_password != nullptr); if (group_password->password != nullptr) { @@ -77,13 +77,13 @@ const uint8_t *tox_event_group_password_get_password(const Tox_Event_Group_Passw return group_password->password; } -static void tox_event_group_password_construct(non_null() Tox_Event_Group_Password *group_password) +static void tox_event_group_password_construct(Tox_Event_Group_Password *_Nonnull group_password) { *group_password = (Tox_Event_Group_Password) { 0 }; } -static void tox_event_group_password_destruct(non_null() Tox_Event_Group_Password *group_password, non_null() const Memory *mem) +static void tox_event_group_password_destruct(Tox_Event_Group_Password *_Nonnull group_password, const Memory *_Nonnull mem) { free(group_password->password); } @@ -96,7 +96,7 @@ bool tox_event_group_password_pack( && bin_pack_bin(bp, event->password, event->password_length); } -static bool tox_event_group_password_unpack_into(non_null() Tox_Event_Group_Password *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_password_unpack_into(Tox_Event_Group_Password *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -139,7 +139,7 @@ void tox_event_group_password_free(Tox_Event_Group_Password *group_password, con mem_delete(mem, group_password); } -static Tox_Event_Group_Password *tox_events_add_group_password(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Password *tox_events_add_group_password(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Password *const group_password = tox_event_group_password_new(mem); @@ -172,7 +172,7 @@ bool tox_event_group_password_unpack( return tox_event_group_password_unpack_into(*event, bu); } -static Tox_Event_Group_Password *tox_event_group_password_alloc(non_null() void *user_data) +static Tox_Event_Group_Password *tox_event_group_password_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_peer_exit.c b/toxcore/events/group_peer_exit.c index 65b12e9b0..764426660 100644 --- a/toxcore/events/group_peer_exit.c +++ b/toxcore/events/group_peer_exit.c @@ -35,7 +35,7 @@ struct Tox_Event_Group_Peer_Exit { uint32_t part_message_length; }; -static void tox_event_group_peer_exit_set_group_number(non_null() Tox_Event_Group_Peer_Exit *group_peer_exit, uint32_t group_number) +static void tox_event_group_peer_exit_set_group_number(Tox_Event_Group_Peer_Exit *_Nonnull group_peer_exit, uint32_t group_number) { assert(group_peer_exit != nullptr); group_peer_exit->group_number = group_number; @@ -46,7 +46,7 @@ uint32_t tox_event_group_peer_exit_get_group_number(const Tox_Event_Group_Peer_E return group_peer_exit->group_number; } -static void tox_event_group_peer_exit_set_peer_id(non_null() Tox_Event_Group_Peer_Exit *group_peer_exit, uint32_t peer_id) +static void tox_event_group_peer_exit_set_peer_id(Tox_Event_Group_Peer_Exit *_Nonnull group_peer_exit, uint32_t peer_id) { assert(group_peer_exit != nullptr); group_peer_exit->peer_id = peer_id; @@ -57,7 +57,7 @@ uint32_t tox_event_group_peer_exit_get_peer_id(const Tox_Event_Group_Peer_Exit * return group_peer_exit->peer_id; } -static void tox_event_group_peer_exit_set_exit_type(non_null() Tox_Event_Group_Peer_Exit *group_peer_exit, Tox_Group_Exit_Type exit_type) +static void tox_event_group_peer_exit_set_exit_type(Tox_Event_Group_Peer_Exit *_Nonnull group_peer_exit, Tox_Group_Exit_Type exit_type) { assert(group_peer_exit != nullptr); group_peer_exit->exit_type = exit_type; @@ -68,8 +68,8 @@ Tox_Group_Exit_Type tox_event_group_peer_exit_get_exit_type(const Tox_Event_Grou return group_peer_exit->exit_type; } -static bool tox_event_group_peer_exit_set_name(non_null() Tox_Event_Group_Peer_Exit *group_peer_exit, - nullable() const uint8_t *name, uint32_t name_length) +static bool tox_event_group_peer_exit_set_name(Tox_Event_Group_Peer_Exit *_Nonnull group_peer_exit, + const uint8_t *_Nullable name, uint32_t name_length) { assert(group_peer_exit != nullptr); if (group_peer_exit->name != nullptr) { @@ -105,8 +105,8 @@ const uint8_t *tox_event_group_peer_exit_get_name(const Tox_Event_Group_Peer_Exi return group_peer_exit->name; } -static bool tox_event_group_peer_exit_set_part_message(non_null() Tox_Event_Group_Peer_Exit *group_peer_exit, - nullable() const uint8_t *part_message, uint32_t part_message_length) +static bool tox_event_group_peer_exit_set_part_message(Tox_Event_Group_Peer_Exit *_Nonnull group_peer_exit, + const uint8_t *_Nullable part_message, uint32_t part_message_length) { assert(group_peer_exit != nullptr); if (group_peer_exit->part_message != nullptr) { @@ -142,13 +142,13 @@ const uint8_t *tox_event_group_peer_exit_get_part_message(const Tox_Event_Group_ return group_peer_exit->part_message; } -static void tox_event_group_peer_exit_construct(non_null() Tox_Event_Group_Peer_Exit *group_peer_exit) +static void tox_event_group_peer_exit_construct(Tox_Event_Group_Peer_Exit *_Nonnull group_peer_exit) { *group_peer_exit = (Tox_Event_Group_Peer_Exit) { 0 }; } -static void tox_event_group_peer_exit_destruct(non_null() Tox_Event_Group_Peer_Exit *group_peer_exit, non_null() const Memory *mem) +static void tox_event_group_peer_exit_destruct(Tox_Event_Group_Peer_Exit *_Nonnull group_peer_exit, const Memory *_Nonnull mem) { free(group_peer_exit->name); free(group_peer_exit->part_message); @@ -165,7 +165,7 @@ bool tox_event_group_peer_exit_pack( && bin_pack_bin(bp, event->part_message, event->part_message_length); } -static bool tox_event_group_peer_exit_unpack_into(non_null() Tox_Event_Group_Peer_Exit *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_peer_exit_unpack_into(Tox_Event_Group_Peer_Exit *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 5, nullptr)) { @@ -211,7 +211,7 @@ void tox_event_group_peer_exit_free(Tox_Event_Group_Peer_Exit *group_peer_exit, mem_delete(mem, group_peer_exit); } -static Tox_Event_Group_Peer_Exit *tox_events_add_group_peer_exit(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Peer_Exit *tox_events_add_group_peer_exit(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Peer_Exit *const group_peer_exit = tox_event_group_peer_exit_new(mem); @@ -244,7 +244,7 @@ bool tox_event_group_peer_exit_unpack( return tox_event_group_peer_exit_unpack_into(*event, bu); } -static Tox_Event_Group_Peer_Exit *tox_event_group_peer_exit_alloc(non_null() void *user_data) +static Tox_Event_Group_Peer_Exit *tox_event_group_peer_exit_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_peer_join.c b/toxcore/events/group_peer_join.c index 024acb66d..4fd13f9af 100644 --- a/toxcore/events/group_peer_join.c +++ b/toxcore/events/group_peer_join.c @@ -26,7 +26,7 @@ struct Tox_Event_Group_Peer_Join { uint32_t peer_id; }; -static void tox_event_group_peer_join_set_group_number(non_null() Tox_Event_Group_Peer_Join *group_peer_join, uint32_t group_number) +static void tox_event_group_peer_join_set_group_number(Tox_Event_Group_Peer_Join *_Nonnull group_peer_join, uint32_t group_number) { assert(group_peer_join != nullptr); group_peer_join->group_number = group_number; @@ -37,7 +37,7 @@ uint32_t tox_event_group_peer_join_get_group_number(const Tox_Event_Group_Peer_J return group_peer_join->group_number; } -static void tox_event_group_peer_join_set_peer_id(non_null() Tox_Event_Group_Peer_Join *group_peer_join, uint32_t peer_id) +static void tox_event_group_peer_join_set_peer_id(Tox_Event_Group_Peer_Join *_Nonnull group_peer_join, uint32_t peer_id) { assert(group_peer_join != nullptr); group_peer_join->peer_id = peer_id; @@ -48,13 +48,13 @@ uint32_t tox_event_group_peer_join_get_peer_id(const Tox_Event_Group_Peer_Join * return group_peer_join->peer_id; } -static void tox_event_group_peer_join_construct(non_null() Tox_Event_Group_Peer_Join *group_peer_join) +static void tox_event_group_peer_join_construct(Tox_Event_Group_Peer_Join *_Nonnull group_peer_join) { *group_peer_join = (Tox_Event_Group_Peer_Join) { 0 }; } -static void tox_event_group_peer_join_destruct(non_null() Tox_Event_Group_Peer_Join *group_peer_join, non_null() const Memory *mem) +static void tox_event_group_peer_join_destruct(Tox_Event_Group_Peer_Join *_Nonnull group_peer_join, const Memory *_Nonnull mem) { return; } @@ -67,7 +67,7 @@ bool tox_event_group_peer_join_pack( && bin_pack_u32(bp, event->peer_id); } -static bool tox_event_group_peer_join_unpack_into(non_null() Tox_Event_Group_Peer_Join *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_peer_join_unpack_into(Tox_Event_Group_Peer_Join *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -110,7 +110,7 @@ void tox_event_group_peer_join_free(Tox_Event_Group_Peer_Join *group_peer_join, mem_delete(mem, group_peer_join); } -static Tox_Event_Group_Peer_Join *tox_events_add_group_peer_join(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Peer_Join *tox_events_add_group_peer_join(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Peer_Join *const group_peer_join = tox_event_group_peer_join_new(mem); @@ -143,7 +143,7 @@ bool tox_event_group_peer_join_unpack( return tox_event_group_peer_join_unpack_into(*event, bu); } -static Tox_Event_Group_Peer_Join *tox_event_group_peer_join_alloc(non_null() void *user_data) +static Tox_Event_Group_Peer_Join *tox_event_group_peer_join_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_peer_limit.c b/toxcore/events/group_peer_limit.c index a36460229..e652f7a7c 100644 --- a/toxcore/events/group_peer_limit.c +++ b/toxcore/events/group_peer_limit.c @@ -26,7 +26,7 @@ struct Tox_Event_Group_Peer_Limit { uint32_t peer_limit; }; -static void tox_event_group_peer_limit_set_group_number(non_null() Tox_Event_Group_Peer_Limit *group_peer_limit, uint32_t group_number) +static void tox_event_group_peer_limit_set_group_number(Tox_Event_Group_Peer_Limit *_Nonnull group_peer_limit, uint32_t group_number) { assert(group_peer_limit != nullptr); group_peer_limit->group_number = group_number; @@ -37,7 +37,7 @@ uint32_t tox_event_group_peer_limit_get_group_number(const Tox_Event_Group_Peer_ return group_peer_limit->group_number; } -static void tox_event_group_peer_limit_set_peer_limit(non_null() Tox_Event_Group_Peer_Limit *group_peer_limit, uint32_t peer_limit) +static void tox_event_group_peer_limit_set_peer_limit(Tox_Event_Group_Peer_Limit *_Nonnull group_peer_limit, uint32_t peer_limit) { assert(group_peer_limit != nullptr); group_peer_limit->peer_limit = peer_limit; @@ -48,13 +48,13 @@ uint32_t tox_event_group_peer_limit_get_peer_limit(const Tox_Event_Group_Peer_Li return group_peer_limit->peer_limit; } -static void tox_event_group_peer_limit_construct(non_null() Tox_Event_Group_Peer_Limit *group_peer_limit) +static void tox_event_group_peer_limit_construct(Tox_Event_Group_Peer_Limit *_Nonnull group_peer_limit) { *group_peer_limit = (Tox_Event_Group_Peer_Limit) { 0 }; } -static void tox_event_group_peer_limit_destruct(non_null() Tox_Event_Group_Peer_Limit *group_peer_limit, non_null() const Memory *mem) +static void tox_event_group_peer_limit_destruct(Tox_Event_Group_Peer_Limit *_Nonnull group_peer_limit, const Memory *_Nonnull mem) { return; } @@ -67,7 +67,7 @@ bool tox_event_group_peer_limit_pack( && bin_pack_u32(bp, event->peer_limit); } -static bool tox_event_group_peer_limit_unpack_into(non_null() Tox_Event_Group_Peer_Limit *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_peer_limit_unpack_into(Tox_Event_Group_Peer_Limit *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -110,7 +110,7 @@ void tox_event_group_peer_limit_free(Tox_Event_Group_Peer_Limit *group_peer_limi mem_delete(mem, group_peer_limit); } -static Tox_Event_Group_Peer_Limit *tox_events_add_group_peer_limit(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Peer_Limit *tox_events_add_group_peer_limit(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Peer_Limit *const group_peer_limit = tox_event_group_peer_limit_new(mem); @@ -143,7 +143,7 @@ bool tox_event_group_peer_limit_unpack( return tox_event_group_peer_limit_unpack_into(*event, bu); } -static Tox_Event_Group_Peer_Limit *tox_event_group_peer_limit_alloc(non_null() void *user_data) +static Tox_Event_Group_Peer_Limit *tox_event_group_peer_limit_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_peer_name.c b/toxcore/events/group_peer_name.c index b12922213..6009fd751 100644 --- a/toxcore/events/group_peer_name.c +++ b/toxcore/events/group_peer_name.c @@ -30,7 +30,7 @@ struct Tox_Event_Group_Peer_Name { uint32_t name_length; }; -static void tox_event_group_peer_name_set_group_number(non_null() Tox_Event_Group_Peer_Name *group_peer_name, uint32_t group_number) +static void tox_event_group_peer_name_set_group_number(Tox_Event_Group_Peer_Name *_Nonnull group_peer_name, uint32_t group_number) { assert(group_peer_name != nullptr); group_peer_name->group_number = group_number; @@ -41,7 +41,7 @@ uint32_t tox_event_group_peer_name_get_group_number(const Tox_Event_Group_Peer_N return group_peer_name->group_number; } -static void tox_event_group_peer_name_set_peer_id(non_null() Tox_Event_Group_Peer_Name *group_peer_name, uint32_t peer_id) +static void tox_event_group_peer_name_set_peer_id(Tox_Event_Group_Peer_Name *_Nonnull group_peer_name, uint32_t peer_id) { assert(group_peer_name != nullptr); group_peer_name->peer_id = peer_id; @@ -52,8 +52,8 @@ uint32_t tox_event_group_peer_name_get_peer_id(const Tox_Event_Group_Peer_Name * return group_peer_name->peer_id; } -static bool tox_event_group_peer_name_set_name(non_null() Tox_Event_Group_Peer_Name *group_peer_name, - nullable() const uint8_t *name, uint32_t name_length) +static bool tox_event_group_peer_name_set_name(Tox_Event_Group_Peer_Name *_Nonnull group_peer_name, + const uint8_t *_Nullable name, uint32_t name_length) { assert(group_peer_name != nullptr); if (group_peer_name->name != nullptr) { @@ -89,13 +89,13 @@ const uint8_t *tox_event_group_peer_name_get_name(const Tox_Event_Group_Peer_Nam return group_peer_name->name; } -static void tox_event_group_peer_name_construct(non_null() Tox_Event_Group_Peer_Name *group_peer_name) +static void tox_event_group_peer_name_construct(Tox_Event_Group_Peer_Name *_Nonnull group_peer_name) { *group_peer_name = (Tox_Event_Group_Peer_Name) { 0 }; } -static void tox_event_group_peer_name_destruct(non_null() Tox_Event_Group_Peer_Name *group_peer_name, non_null() const Memory *mem) +static void tox_event_group_peer_name_destruct(Tox_Event_Group_Peer_Name *_Nonnull group_peer_name, const Memory *_Nonnull mem) { free(group_peer_name->name); } @@ -109,7 +109,7 @@ bool tox_event_group_peer_name_pack( && bin_pack_bin(bp, event->name, event->name_length); } -static bool tox_event_group_peer_name_unpack_into(non_null() Tox_Event_Group_Peer_Name *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_peer_name_unpack_into(Tox_Event_Group_Peer_Name *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 3, nullptr)) { @@ -153,7 +153,7 @@ void tox_event_group_peer_name_free(Tox_Event_Group_Peer_Name *group_peer_name, mem_delete(mem, group_peer_name); } -static Tox_Event_Group_Peer_Name *tox_events_add_group_peer_name(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Peer_Name *tox_events_add_group_peer_name(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Peer_Name *const group_peer_name = tox_event_group_peer_name_new(mem); @@ -186,7 +186,7 @@ bool tox_event_group_peer_name_unpack( return tox_event_group_peer_name_unpack_into(*event, bu); } -static Tox_Event_Group_Peer_Name *tox_event_group_peer_name_alloc(non_null() void *user_data) +static Tox_Event_Group_Peer_Name *tox_event_group_peer_name_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_peer_status.c b/toxcore/events/group_peer_status.c index 3ef7ce108..f193e2b76 100644 --- a/toxcore/events/group_peer_status.c +++ b/toxcore/events/group_peer_status.c @@ -29,7 +29,7 @@ struct Tox_Event_Group_Peer_Status { Tox_User_Status status; }; -static void tox_event_group_peer_status_set_group_number(non_null() Tox_Event_Group_Peer_Status *group_peer_status, uint32_t group_number) +static void tox_event_group_peer_status_set_group_number(Tox_Event_Group_Peer_Status *_Nonnull group_peer_status, uint32_t group_number) { assert(group_peer_status != nullptr); group_peer_status->group_number = group_number; @@ -40,7 +40,7 @@ uint32_t tox_event_group_peer_status_get_group_number(const Tox_Event_Group_Peer return group_peer_status->group_number; } -static void tox_event_group_peer_status_set_peer_id(non_null() Tox_Event_Group_Peer_Status *group_peer_status, uint32_t peer_id) +static void tox_event_group_peer_status_set_peer_id(Tox_Event_Group_Peer_Status *_Nonnull group_peer_status, uint32_t peer_id) { assert(group_peer_status != nullptr); group_peer_status->peer_id = peer_id; @@ -51,7 +51,7 @@ uint32_t tox_event_group_peer_status_get_peer_id(const Tox_Event_Group_Peer_Stat return group_peer_status->peer_id; } -static void tox_event_group_peer_status_set_status(non_null() Tox_Event_Group_Peer_Status *group_peer_status, Tox_User_Status status) +static void tox_event_group_peer_status_set_status(Tox_Event_Group_Peer_Status *_Nonnull group_peer_status, Tox_User_Status status) { assert(group_peer_status != nullptr); group_peer_status->status = status; @@ -62,13 +62,13 @@ Tox_User_Status tox_event_group_peer_status_get_status(const Tox_Event_Group_Pee return group_peer_status->status; } -static void tox_event_group_peer_status_construct(non_null() Tox_Event_Group_Peer_Status *group_peer_status) +static void tox_event_group_peer_status_construct(Tox_Event_Group_Peer_Status *_Nonnull group_peer_status) { *group_peer_status = (Tox_Event_Group_Peer_Status) { 0 }; } -static void tox_event_group_peer_status_destruct(non_null() Tox_Event_Group_Peer_Status *group_peer_status, non_null() const Memory *mem) +static void tox_event_group_peer_status_destruct(Tox_Event_Group_Peer_Status *_Nonnull group_peer_status, const Memory *_Nonnull mem) { return; } @@ -82,7 +82,7 @@ bool tox_event_group_peer_status_pack( && tox_user_status_pack(event->status, bp); } -static bool tox_event_group_peer_status_unpack_into(non_null() Tox_Event_Group_Peer_Status *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_peer_status_unpack_into(Tox_Event_Group_Peer_Status *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 3, nullptr)) { @@ -126,7 +126,7 @@ void tox_event_group_peer_status_free(Tox_Event_Group_Peer_Status *group_peer_st mem_delete(mem, group_peer_status); } -static Tox_Event_Group_Peer_Status *tox_events_add_group_peer_status(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Peer_Status *tox_events_add_group_peer_status(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Peer_Status *const group_peer_status = tox_event_group_peer_status_new(mem); @@ -159,7 +159,7 @@ bool tox_event_group_peer_status_unpack( return tox_event_group_peer_status_unpack_into(*event, bu); } -static Tox_Event_Group_Peer_Status *tox_event_group_peer_status_alloc(non_null() void *user_data) +static Tox_Event_Group_Peer_Status *tox_event_group_peer_status_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_privacy_state.c b/toxcore/events/group_privacy_state.c index fcae1da4e..9d50e5052 100644 --- a/toxcore/events/group_privacy_state.c +++ b/toxcore/events/group_privacy_state.c @@ -28,7 +28,7 @@ struct Tox_Event_Group_Privacy_State { Tox_Group_Privacy_State privacy_state; }; -static void tox_event_group_privacy_state_set_group_number(non_null() Tox_Event_Group_Privacy_State *group_privacy_state, uint32_t group_number) +static void tox_event_group_privacy_state_set_group_number(Tox_Event_Group_Privacy_State *_Nonnull group_privacy_state, uint32_t group_number) { assert(group_privacy_state != nullptr); group_privacy_state->group_number = group_number; @@ -39,7 +39,7 @@ uint32_t tox_event_group_privacy_state_get_group_number(const Tox_Event_Group_Pr return group_privacy_state->group_number; } -static void tox_event_group_privacy_state_set_privacy_state(non_null() Tox_Event_Group_Privacy_State *group_privacy_state, Tox_Group_Privacy_State privacy_state) +static void tox_event_group_privacy_state_set_privacy_state(Tox_Event_Group_Privacy_State *_Nonnull group_privacy_state, Tox_Group_Privacy_State privacy_state) { assert(group_privacy_state != nullptr); group_privacy_state->privacy_state = privacy_state; @@ -50,13 +50,13 @@ Tox_Group_Privacy_State tox_event_group_privacy_state_get_privacy_state(const To return group_privacy_state->privacy_state; } -static void tox_event_group_privacy_state_construct(non_null() Tox_Event_Group_Privacy_State *group_privacy_state) +static void tox_event_group_privacy_state_construct(Tox_Event_Group_Privacy_State *_Nonnull group_privacy_state) { *group_privacy_state = (Tox_Event_Group_Privacy_State) { 0 }; } -static void tox_event_group_privacy_state_destruct(non_null() Tox_Event_Group_Privacy_State *group_privacy_state, non_null() const Memory *mem) +static void tox_event_group_privacy_state_destruct(Tox_Event_Group_Privacy_State *_Nonnull group_privacy_state, const Memory *_Nonnull mem) { return; } @@ -69,7 +69,7 @@ bool tox_event_group_privacy_state_pack( && tox_group_privacy_state_pack(event->privacy_state, bp); } -static bool tox_event_group_privacy_state_unpack_into(non_null() Tox_Event_Group_Privacy_State *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_privacy_state_unpack_into(Tox_Event_Group_Privacy_State *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -112,7 +112,7 @@ void tox_event_group_privacy_state_free(Tox_Event_Group_Privacy_State *group_pri mem_delete(mem, group_privacy_state); } -static Tox_Event_Group_Privacy_State *tox_events_add_group_privacy_state(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Privacy_State *tox_events_add_group_privacy_state(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Privacy_State *const group_privacy_state = tox_event_group_privacy_state_new(mem); @@ -145,7 +145,7 @@ bool tox_event_group_privacy_state_unpack( return tox_event_group_privacy_state_unpack_into(*event, bu); } -static Tox_Event_Group_Privacy_State *tox_event_group_privacy_state_alloc(non_null() void *user_data) +static Tox_Event_Group_Privacy_State *tox_event_group_privacy_state_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_private_message.c b/toxcore/events/group_private_message.c index c7dd13dd5..d36e4c01d 100644 --- a/toxcore/events/group_private_message.c +++ b/toxcore/events/group_private_message.c @@ -34,7 +34,7 @@ struct Tox_Event_Group_Private_Message { uint32_t message_id; }; -static void tox_event_group_private_message_set_group_number(non_null() Tox_Event_Group_Private_Message *group_private_message, uint32_t group_number) +static void tox_event_group_private_message_set_group_number(Tox_Event_Group_Private_Message *_Nonnull group_private_message, uint32_t group_number) { assert(group_private_message != nullptr); group_private_message->group_number = group_number; @@ -45,7 +45,7 @@ uint32_t tox_event_group_private_message_get_group_number(const Tox_Event_Group_ return group_private_message->group_number; } -static void tox_event_group_private_message_set_peer_id(non_null() Tox_Event_Group_Private_Message *group_private_message, uint32_t peer_id) +static void tox_event_group_private_message_set_peer_id(Tox_Event_Group_Private_Message *_Nonnull group_private_message, uint32_t peer_id) { assert(group_private_message != nullptr); group_private_message->peer_id = peer_id; @@ -56,7 +56,7 @@ uint32_t tox_event_group_private_message_get_peer_id(const Tox_Event_Group_Priva return group_private_message->peer_id; } -static void tox_event_group_private_message_set_message_type(non_null() Tox_Event_Group_Private_Message *group_private_message, Tox_Message_Type message_type) +static void tox_event_group_private_message_set_message_type(Tox_Event_Group_Private_Message *_Nonnull group_private_message, Tox_Message_Type message_type) { assert(group_private_message != nullptr); group_private_message->message_type = message_type; @@ -67,8 +67,8 @@ Tox_Message_Type tox_event_group_private_message_get_message_type(const Tox_Even return group_private_message->message_type; } -static bool tox_event_group_private_message_set_message(non_null() Tox_Event_Group_Private_Message *group_private_message, - nullable() const uint8_t *message, uint32_t message_length) +static bool tox_event_group_private_message_set_message(Tox_Event_Group_Private_Message *_Nonnull group_private_message, + const uint8_t *_Nullable message, uint32_t message_length) { assert(group_private_message != nullptr); if (group_private_message->message != nullptr) { @@ -104,7 +104,7 @@ const uint8_t *tox_event_group_private_message_get_message(const Tox_Event_Group return group_private_message->message; } -static void tox_event_group_private_message_set_message_id(non_null() Tox_Event_Group_Private_Message *group_private_message, uint32_t message_id) +static void tox_event_group_private_message_set_message_id(Tox_Event_Group_Private_Message *_Nonnull group_private_message, uint32_t message_id) { assert(group_private_message != nullptr); group_private_message->message_id = message_id; @@ -115,13 +115,13 @@ uint32_t tox_event_group_private_message_get_message_id(const Tox_Event_Group_Pr return group_private_message->message_id; } -static void tox_event_group_private_message_construct(non_null() Tox_Event_Group_Private_Message *group_private_message) +static void tox_event_group_private_message_construct(Tox_Event_Group_Private_Message *_Nonnull group_private_message) { *group_private_message = (Tox_Event_Group_Private_Message) { 0 }; } -static void tox_event_group_private_message_destruct(non_null() Tox_Event_Group_Private_Message *group_private_message, non_null() const Memory *mem) +static void tox_event_group_private_message_destruct(Tox_Event_Group_Private_Message *_Nonnull group_private_message, const Memory *_Nonnull mem) { free(group_private_message->message); } @@ -137,7 +137,7 @@ bool tox_event_group_private_message_pack( && bin_pack_u32(bp, event->message_id); } -static bool tox_event_group_private_message_unpack_into(non_null() Tox_Event_Group_Private_Message *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_private_message_unpack_into(Tox_Event_Group_Private_Message *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 5, nullptr)) { @@ -183,7 +183,7 @@ void tox_event_group_private_message_free(Tox_Event_Group_Private_Message *group mem_delete(mem, group_private_message); } -static Tox_Event_Group_Private_Message *tox_events_add_group_private_message(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Private_Message *tox_events_add_group_private_message(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Private_Message *const group_private_message = tox_event_group_private_message_new(mem); @@ -216,7 +216,7 @@ bool tox_event_group_private_message_unpack( return tox_event_group_private_message_unpack_into(*event, bu); } -static Tox_Event_Group_Private_Message *tox_event_group_private_message_alloc(non_null() void *user_data) +static Tox_Event_Group_Private_Message *tox_event_group_private_message_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_self_join.c b/toxcore/events/group_self_join.c index d444e1338..1fc7b96d9 100644 --- a/toxcore/events/group_self_join.c +++ b/toxcore/events/group_self_join.c @@ -25,7 +25,7 @@ struct Tox_Event_Group_Self_Join { uint32_t group_number; }; -static void tox_event_group_self_join_set_group_number(non_null() Tox_Event_Group_Self_Join *group_self_join, uint32_t group_number) +static void tox_event_group_self_join_set_group_number(Tox_Event_Group_Self_Join *_Nonnull group_self_join, uint32_t group_number) { assert(group_self_join != nullptr); group_self_join->group_number = group_number; @@ -36,13 +36,13 @@ uint32_t tox_event_group_self_join_get_group_number(const Tox_Event_Group_Self_J return group_self_join->group_number; } -static void tox_event_group_self_join_construct(non_null() Tox_Event_Group_Self_Join *group_self_join) +static void tox_event_group_self_join_construct(Tox_Event_Group_Self_Join *_Nonnull group_self_join) { *group_self_join = (Tox_Event_Group_Self_Join) { 0 }; } -static void tox_event_group_self_join_destruct(non_null() Tox_Event_Group_Self_Join *group_self_join, non_null() const Memory *mem) +static void tox_event_group_self_join_destruct(Tox_Event_Group_Self_Join *_Nonnull group_self_join, const Memory *_Nonnull mem) { return; } @@ -53,7 +53,7 @@ bool tox_event_group_self_join_pack( return bin_pack_u32(bp, event->group_number); } -static bool tox_event_group_self_join_unpack_into(non_null() Tox_Event_Group_Self_Join *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_self_join_unpack_into(Tox_Event_Group_Self_Join *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); return bin_unpack_u32(bu, &event->group_number); @@ -91,7 +91,7 @@ void tox_event_group_self_join_free(Tox_Event_Group_Self_Join *group_self_join, mem_delete(mem, group_self_join); } -static Tox_Event_Group_Self_Join *tox_events_add_group_self_join(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Self_Join *tox_events_add_group_self_join(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Self_Join *const group_self_join = tox_event_group_self_join_new(mem); @@ -124,7 +124,7 @@ bool tox_event_group_self_join_unpack( return tox_event_group_self_join_unpack_into(*event, bu); } -static Tox_Event_Group_Self_Join *tox_event_group_self_join_alloc(non_null() void *user_data) +static Tox_Event_Group_Self_Join *tox_event_group_self_join_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_topic.c b/toxcore/events/group_topic.c index 124c6e05f..396a423e9 100644 --- a/toxcore/events/group_topic.c +++ b/toxcore/events/group_topic.c @@ -30,7 +30,7 @@ struct Tox_Event_Group_Topic { uint32_t topic_length; }; -static void tox_event_group_topic_set_group_number(non_null() Tox_Event_Group_Topic *group_topic, uint32_t group_number) +static void tox_event_group_topic_set_group_number(Tox_Event_Group_Topic *_Nonnull group_topic, uint32_t group_number) { assert(group_topic != nullptr); group_topic->group_number = group_number; @@ -41,7 +41,7 @@ uint32_t tox_event_group_topic_get_group_number(const Tox_Event_Group_Topic *gro return group_topic->group_number; } -static void tox_event_group_topic_set_peer_id(non_null() Tox_Event_Group_Topic *group_topic, uint32_t peer_id) +static void tox_event_group_topic_set_peer_id(Tox_Event_Group_Topic *_Nonnull group_topic, uint32_t peer_id) { assert(group_topic != nullptr); group_topic->peer_id = peer_id; @@ -52,8 +52,8 @@ uint32_t tox_event_group_topic_get_peer_id(const Tox_Event_Group_Topic *group_to return group_topic->peer_id; } -static bool tox_event_group_topic_set_topic(non_null() Tox_Event_Group_Topic *group_topic, - nullable() const uint8_t *topic, uint32_t topic_length) +static bool tox_event_group_topic_set_topic(Tox_Event_Group_Topic *_Nonnull group_topic, + const uint8_t *_Nullable topic, uint32_t topic_length) { assert(group_topic != nullptr); if (group_topic->topic != nullptr) { @@ -89,13 +89,13 @@ const uint8_t *tox_event_group_topic_get_topic(const Tox_Event_Group_Topic *grou return group_topic->topic; } -static void tox_event_group_topic_construct(non_null() Tox_Event_Group_Topic *group_topic) +static void tox_event_group_topic_construct(Tox_Event_Group_Topic *_Nonnull group_topic) { *group_topic = (Tox_Event_Group_Topic) { 0 }; } -static void tox_event_group_topic_destruct(non_null() Tox_Event_Group_Topic *group_topic, non_null() const Memory *mem) +static void tox_event_group_topic_destruct(Tox_Event_Group_Topic *_Nonnull group_topic, const Memory *_Nonnull mem) { free(group_topic->topic); } @@ -109,7 +109,7 @@ bool tox_event_group_topic_pack( && bin_pack_bin(bp, event->topic, event->topic_length); } -static bool tox_event_group_topic_unpack_into(non_null() Tox_Event_Group_Topic *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_topic_unpack_into(Tox_Event_Group_Topic *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 3, nullptr)) { @@ -153,7 +153,7 @@ void tox_event_group_topic_free(Tox_Event_Group_Topic *group_topic, const Memory mem_delete(mem, group_topic); } -static Tox_Event_Group_Topic *tox_events_add_group_topic(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Topic *tox_events_add_group_topic(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Topic *const group_topic = tox_event_group_topic_new(mem); @@ -186,7 +186,7 @@ bool tox_event_group_topic_unpack( return tox_event_group_topic_unpack_into(*event, bu); } -static Tox_Event_Group_Topic *tox_event_group_topic_alloc(non_null() void *user_data) +static Tox_Event_Group_Topic *tox_event_group_topic_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_topic_lock.c b/toxcore/events/group_topic_lock.c index 39c619b68..4c0003179 100644 --- a/toxcore/events/group_topic_lock.c +++ b/toxcore/events/group_topic_lock.c @@ -28,7 +28,7 @@ struct Tox_Event_Group_Topic_Lock { Tox_Group_Topic_Lock topic_lock; }; -static void tox_event_group_topic_lock_set_group_number(non_null() Tox_Event_Group_Topic_Lock *group_topic_lock, uint32_t group_number) +static void tox_event_group_topic_lock_set_group_number(Tox_Event_Group_Topic_Lock *_Nonnull group_topic_lock, uint32_t group_number) { assert(group_topic_lock != nullptr); group_topic_lock->group_number = group_number; @@ -39,7 +39,7 @@ uint32_t tox_event_group_topic_lock_get_group_number(const Tox_Event_Group_Topic return group_topic_lock->group_number; } -static void tox_event_group_topic_lock_set_topic_lock(non_null() Tox_Event_Group_Topic_Lock *group_topic_lock, Tox_Group_Topic_Lock topic_lock) +static void tox_event_group_topic_lock_set_topic_lock(Tox_Event_Group_Topic_Lock *_Nonnull group_topic_lock, Tox_Group_Topic_Lock topic_lock) { assert(group_topic_lock != nullptr); group_topic_lock->topic_lock = topic_lock; @@ -50,13 +50,13 @@ Tox_Group_Topic_Lock tox_event_group_topic_lock_get_topic_lock(const Tox_Event_G return group_topic_lock->topic_lock; } -static void tox_event_group_topic_lock_construct(non_null() Tox_Event_Group_Topic_Lock *group_topic_lock) +static void tox_event_group_topic_lock_construct(Tox_Event_Group_Topic_Lock *_Nonnull group_topic_lock) { *group_topic_lock = (Tox_Event_Group_Topic_Lock) { 0 }; } -static void tox_event_group_topic_lock_destruct(non_null() Tox_Event_Group_Topic_Lock *group_topic_lock, non_null() const Memory *mem) +static void tox_event_group_topic_lock_destruct(Tox_Event_Group_Topic_Lock *_Nonnull group_topic_lock, const Memory *_Nonnull mem) { return; } @@ -69,7 +69,7 @@ bool tox_event_group_topic_lock_pack( && tox_group_topic_lock_pack(event->topic_lock, bp); } -static bool tox_event_group_topic_lock_unpack_into(non_null() Tox_Event_Group_Topic_Lock *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_topic_lock_unpack_into(Tox_Event_Group_Topic_Lock *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -112,7 +112,7 @@ void tox_event_group_topic_lock_free(Tox_Event_Group_Topic_Lock *group_topic_loc mem_delete(mem, group_topic_lock); } -static Tox_Event_Group_Topic_Lock *tox_events_add_group_topic_lock(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Topic_Lock *tox_events_add_group_topic_lock(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Topic_Lock *const group_topic_lock = tox_event_group_topic_lock_new(mem); @@ -145,7 +145,7 @@ bool tox_event_group_topic_lock_unpack( return tox_event_group_topic_lock_unpack_into(*event, bu); } -static Tox_Event_Group_Topic_Lock *tox_event_group_topic_lock_alloc(non_null() void *user_data) +static Tox_Event_Group_Topic_Lock *tox_event_group_topic_lock_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/group_voice_state.c b/toxcore/events/group_voice_state.c index 44d856a54..98602549f 100644 --- a/toxcore/events/group_voice_state.c +++ b/toxcore/events/group_voice_state.c @@ -28,7 +28,7 @@ struct Tox_Event_Group_Voice_State { Tox_Group_Voice_State voice_state; }; -static void tox_event_group_voice_state_set_group_number(non_null() Tox_Event_Group_Voice_State *group_voice_state, uint32_t group_number) +static void tox_event_group_voice_state_set_group_number(Tox_Event_Group_Voice_State *_Nonnull group_voice_state, uint32_t group_number) { assert(group_voice_state != nullptr); group_voice_state->group_number = group_number; @@ -39,7 +39,7 @@ uint32_t tox_event_group_voice_state_get_group_number(const Tox_Event_Group_Voic return group_voice_state->group_number; } -static void tox_event_group_voice_state_set_voice_state(non_null() Tox_Event_Group_Voice_State *group_voice_state, Tox_Group_Voice_State voice_state) +static void tox_event_group_voice_state_set_voice_state(Tox_Event_Group_Voice_State *_Nonnull group_voice_state, Tox_Group_Voice_State voice_state) { assert(group_voice_state != nullptr); group_voice_state->voice_state = voice_state; @@ -50,13 +50,13 @@ Tox_Group_Voice_State tox_event_group_voice_state_get_voice_state(const Tox_Even return group_voice_state->voice_state; } -static void tox_event_group_voice_state_construct(non_null() Tox_Event_Group_Voice_State *group_voice_state) +static void tox_event_group_voice_state_construct(Tox_Event_Group_Voice_State *_Nonnull group_voice_state) { *group_voice_state = (Tox_Event_Group_Voice_State) { 0 }; } -static void tox_event_group_voice_state_destruct(non_null() Tox_Event_Group_Voice_State *group_voice_state, non_null() const Memory *mem) +static void tox_event_group_voice_state_destruct(Tox_Event_Group_Voice_State *_Nonnull group_voice_state, const Memory *_Nonnull mem) { return; } @@ -69,7 +69,7 @@ bool tox_event_group_voice_state_pack( && tox_group_voice_state_pack(event->voice_state, bp); } -static bool tox_event_group_voice_state_unpack_into(non_null() Tox_Event_Group_Voice_State *event, non_null() Bin_Unpack *bu) +static bool tox_event_group_voice_state_unpack_into(Tox_Event_Group_Voice_State *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); if (!bin_unpack_array_fixed(bu, 2, nullptr)) { @@ -112,7 +112,7 @@ void tox_event_group_voice_state_free(Tox_Event_Group_Voice_State *group_voice_s mem_delete(mem, group_voice_state); } -static Tox_Event_Group_Voice_State *tox_events_add_group_voice_state(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Group_Voice_State *tox_events_add_group_voice_state(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Group_Voice_State *const group_voice_state = tox_event_group_voice_state_new(mem); @@ -145,7 +145,7 @@ bool tox_event_group_voice_state_unpack( return tox_event_group_voice_state_unpack_into(*event, bu); } -static Tox_Event_Group_Voice_State *tox_event_group_voice_state_alloc(non_null() void *user_data) +static Tox_Event_Group_Voice_State *tox_event_group_voice_state_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/events/self_connection_status.c b/toxcore/events/self_connection_status.c index 90c9a397c..223aca58b 100644 --- a/toxcore/events/self_connection_status.c +++ b/toxcore/events/self_connection_status.c @@ -27,7 +27,7 @@ struct Tox_Event_Self_Connection_Status { Tox_Connection connection_status; }; -static void tox_event_self_connection_status_set_connection_status(non_null() Tox_Event_Self_Connection_Status *self_connection_status, Tox_Connection connection_status) +static void tox_event_self_connection_status_set_connection_status(Tox_Event_Self_Connection_Status *_Nonnull self_connection_status, Tox_Connection connection_status) { assert(self_connection_status != nullptr); self_connection_status->connection_status = connection_status; @@ -38,13 +38,13 @@ Tox_Connection tox_event_self_connection_status_get_connection_status(const Tox_ return self_connection_status->connection_status; } -static void tox_event_self_connection_status_construct(non_null() Tox_Event_Self_Connection_Status *self_connection_status) +static void tox_event_self_connection_status_construct(Tox_Event_Self_Connection_Status *_Nonnull self_connection_status) { *self_connection_status = (Tox_Event_Self_Connection_Status) { TOX_CONNECTION_NONE }; } -static void tox_event_self_connection_status_destruct(non_null() Tox_Event_Self_Connection_Status *self_connection_status, non_null() const Memory *mem) +static void tox_event_self_connection_status_destruct(Tox_Event_Self_Connection_Status *_Nonnull self_connection_status, const Memory *_Nonnull mem) { return; } @@ -55,7 +55,7 @@ bool tox_event_self_connection_status_pack( return tox_connection_pack(event->connection_status, bp); } -static bool tox_event_self_connection_status_unpack_into(non_null() Tox_Event_Self_Connection_Status *event, non_null() Bin_Unpack *bu) +static bool tox_event_self_connection_status_unpack_into(Tox_Event_Self_Connection_Status *_Nonnull event, Bin_Unpack *_Nonnull bu) { assert(event != nullptr); return tox_connection_unpack(&event->connection_status, bu); @@ -93,7 +93,7 @@ void tox_event_self_connection_status_free(Tox_Event_Self_Connection_Status *sel mem_delete(mem, self_connection_status); } -static Tox_Event_Self_Connection_Status *tox_events_add_self_connection_status(non_null() Tox_Events *events, non_null() const Memory *mem) +static Tox_Event_Self_Connection_Status *tox_events_add_self_connection_status(Tox_Events *_Nonnull events, const Memory *_Nonnull mem) { Tox_Event_Self_Connection_Status *const self_connection_status = tox_event_self_connection_status_new(mem); @@ -126,7 +126,7 @@ bool tox_event_self_connection_status_unpack( return tox_event_self_connection_status_unpack_into(*event, bu); } -static Tox_Event_Self_Connection_Status *tox_event_self_connection_status_alloc(non_null() void *user_data) +static Tox_Event_Self_Connection_Status *tox_event_self_connection_status_alloc(void *_Nonnull user_data) { Tox_Events_State *state = tox_events_alloc(user_data); assert(state != nullptr); diff --git a/toxcore/forwarding.c b/toxcore/forwarding.c index 424342779..4c7cf9117 100644 --- a/toxcore/forwarding.c +++ b/toxcore/forwarding.c @@ -93,10 +93,10 @@ static uint16_t forwarding_packet_length(uint16_t sendback_data_len, uint16_t da return 1 + 1 + sendback_len + data_length; } -static bool create_forwarding_packet(non_null() const Forwarding *forwarding, - nullable() const uint8_t *sendback_data, uint16_t sendback_data_len, - non_null() const uint8_t *data, uint16_t length, - non_null() uint8_t *packet) +static bool create_forwarding_packet(const Forwarding *_Nonnull forwarding, + const uint8_t *_Nullable sendback_data, uint16_t sendback_data_len, + const uint8_t *_Nonnull data, uint16_t length, + uint8_t *_Nonnull packet) { packet[0] = NET_PACKET_FORWARDING; if (sendback_data_len == 0) { @@ -140,9 +140,9 @@ bool send_forwarding(const Forwarding *forwarding, const IP_Port *dest, #define FORWARD_REQUEST_MIN_PACKET_SIZE (1 + CRYPTO_PUBLIC_KEY_SIZE) -static bool handle_forward_request_dht(non_null() const Forwarding *forwarding, - nullable() const uint8_t *sendback_data, uint16_t sendback_data_len, - nullable() const uint8_t *packet, uint16_t length) +static bool handle_forward_request_dht(const Forwarding *_Nonnull forwarding, + const uint8_t *_Nullable sendback_data, uint16_t sendback_data_len, + const uint8_t *_Nullable packet, uint16_t length) { if (length < FORWARD_REQUEST_MIN_PACKET_SIZE) { return false; @@ -166,8 +166,8 @@ static bool handle_forward_request_dht(non_null() const Forwarding *forwarding, return route_packet(forwarding->dht, public_key, forwarding_packet, len) == len; } -static int handle_forward_request(non_null() void *object, non_null() const IP_Port *source, nullable() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int handle_forward_request(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nullable packet, uint16_t length, + void *_Nullable userdata) { const Forwarding *forwarding = (const Forwarding *)object; uint8_t sendback_data[1 + MAX_PACKED_IPPORT_SIZE]; @@ -185,8 +185,8 @@ static int handle_forward_request(non_null() void *object, non_null() const IP_P #define MIN_NONEMPTY_SENDBACK_SIZE TIMED_AUTH_SIZE #define FORWARD_REPLY_MIN_PACKET_SIZE (1 + 1 + MIN_NONEMPTY_SENDBACK_SIZE) -static int handle_forward_reply(non_null() void *object, non_null() const IP_Port *source, nullable() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int handle_forward_reply(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nullable packet, uint16_t length, + void *_Nullable userdata) { const Forwarding *forwarding = (const Forwarding *)object; if (length < FORWARD_REPLY_MIN_PACKET_SIZE) { @@ -257,8 +257,8 @@ static int handle_forward_reply(non_null() void *object, non_null() const IP_Por #define FORWARDING_MIN_PACKET_SIZE (1 + 1) -static int handle_forwarding(non_null() void *object, non_null() const IP_Port *source, nullable() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int handle_forwarding(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nullable packet, uint16_t length, + void *_Nullable userdata) { const Forwarding *forwarding = (const Forwarding *)object; if (length < FORWARDING_MIN_PACKET_SIZE) { @@ -348,7 +348,7 @@ void set_callback_forward_reply(Forwarding *forwarding, forward_reply_cb *functi forwarding->forward_reply_callback_object = object; } -Forwarding *new_forwarding(const Logger *log, const Memory *mem, const Random *rng, const Mono_Time *mono_time, DHT *dht) +Forwarding *_Nullable new_forwarding(const Logger *log, const Memory *mem, const Random *rng, const Mono_Time *mono_time, DHT *dht) { if (log == nullptr || mono_time == nullptr || dht == nullptr) { return nullptr; diff --git a/toxcore/forwarding.h b/toxcore/forwarding.h index ef65b76f0..ac533b3ab 100644 --- a/toxcore/forwarding.h +++ b/toxcore/forwarding.h @@ -30,7 +30,7 @@ extern "C" { typedef struct Forwarding Forwarding; -DHT *forwarding_get_dht(non_null() const Forwarding *forwarding); +DHT *_Nonnull forwarding_get_dht(const Forwarding *_Nonnull forwarding); /** * @brief Send data to forwarder for forwarding via chain of dht nodes. @@ -44,7 +44,7 @@ DHT *forwarding_get_dht(non_null() const Forwarding *forwarding); * * @return true on success, false otherwise. */ -bool send_forward_request(non_null() const Networking_Core *net, non_null() const IP_Port *forwarder, non_null() const uint8_t *chain_keys, uint16_t chain_length, non_null() const uint8_t *data, +bool send_forward_request(const Networking_Core *_Nonnull net, const IP_Port *_Nonnull forwarder, const uint8_t *_Nonnull chain_keys, uint16_t chain_length, const uint8_t *_Nonnull data, uint16_t data_length); /** Returns size of packet written by create_forward_chain_packet. */ @@ -64,7 +64,7 @@ uint16_t forward_chain_packet_size(uint16_t chain_length, uint16_t data_length); * * @return true on success, false otherwise. */ -bool create_forward_chain_packet(non_null() const uint8_t *chain_keys, uint16_t chain_length, non_null() const uint8_t *data, uint16_t data_length, non_null() uint8_t *packet); +bool create_forward_chain_packet(const uint8_t *_Nonnull chain_keys, uint16_t chain_length, const uint8_t *_Nonnull data, uint16_t data_length, uint8_t *_Nonnull packet); /** * @brief Send reply to forwarded packet via forwarder. @@ -73,7 +73,7 @@ bool create_forward_chain_packet(non_null() const uint8_t *chain_keys, uint16_t * * @return true on success, false otherwise. */ -bool forward_reply(non_null() const Networking_Core *net, non_null() const IP_Port *forwarder, non_null() const uint8_t *sendback, uint16_t sendback_length, non_null() const uint8_t *data, +bool forward_reply(const Networking_Core *_Nonnull net, const IP_Port *_Nonnull forwarder, const uint8_t *_Nonnull sendback, uint16_t sendback_length, const uint8_t *_Nonnull data, uint16_t length); /** @@ -81,28 +81,28 @@ bool forward_reply(non_null() const Networking_Core *net, non_null() const IP_Po * To reply to the packet, callback should use `forward_reply()` to send a reply * forwarded via forwarder, passing the provided sendback. */ -typedef void forwarded_request_cb(void *object, const IP_Port *forwarder, const uint8_t *sendback, - uint16_t sendback_length, const uint8_t *data, - uint16_t length, void *userdata); -void set_callback_forwarded_request(non_null() Forwarding *forwarding, nullable() forwarded_request_cb *function, nullable() void *object); +typedef void forwarded_request_cb(void *_Nullable object, const IP_Port *_Nonnull forwarder, const uint8_t *_Nonnull sendback, + uint16_t sendback_length, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata); +void set_callback_forwarded_request(Forwarding *_Nonnull forwarding, forwarded_request_cb *_Nullable function, void *_Nullable object); /** @brief Set callback to handle a forwarded response. */ -typedef void forwarded_response_cb(void *object, const uint8_t *data, uint16_t length, void *userdata); -void set_callback_forwarded_response(non_null() Forwarding *forwarding, nullable() forwarded_response_cb *function, nullable() void *object); +typedef void forwarded_response_cb(void *_Nullable object, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata); +void set_callback_forwarded_response(Forwarding *_Nonnull forwarding, forwarded_response_cb *_Nullable function, void *_Nullable object); /** @brief Send forwarding packet to dest with given sendback data and data. */ -bool send_forwarding(non_null() const Forwarding *forwarding, non_null() const IP_Port *dest, - nullable() const uint8_t *sendback_data, uint16_t sendback_data_len, - non_null() const uint8_t *data, uint16_t length); -typedef bool forward_reply_cb(void *object, const uint8_t *sendback_data, uint16_t sendback_data_len, - const uint8_t *data, uint16_t length); +bool send_forwarding(const Forwarding *_Nonnull forwarding, const IP_Port *_Nonnull dest, + const uint8_t *_Nullable sendback_data, uint16_t sendback_data_len, + const uint8_t *_Nonnull data, uint16_t length); +typedef bool forward_reply_cb(void *_Nullable object, const uint8_t *_Nullable sendback_data, uint16_t sendback_data_len, + const uint8_t *_Nonnull data, uint16_t length); /** * @brief Set callback to handle a forward reply with an otherwise unhandled * sendback. */ -void set_callback_forward_reply(non_null() Forwarding *forwarding, nullable() forward_reply_cb *function, nullable() void *object); -Forwarding *new_forwarding(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Random *rng, non_null() const Mono_Time *mono_time, non_null() DHT *dht); +void set_callback_forward_reply(Forwarding *_Nonnull forwarding, forward_reply_cb *_Nullable function, void *_Nullable object); +Forwarding *_Nullable new_forwarding(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Random *_Nonnull rng, const Mono_Time *_Nonnull mono_time, DHT *_Nonnull dht); -void kill_forwarding(nullable() Forwarding *forwarding); +void kill_forwarding(Forwarding *_Nullable forwarding); #ifdef __cplusplus } /* extern "C" */ #endif diff --git a/toxcore/friend_connection.c b/toxcore/friend_connection.c index 157740d8f..e3464e5e6 100644 --- a/toxcore/friend_connection.c +++ b/toxcore/friend_connection.c @@ -110,7 +110,7 @@ const IP_Port *friend_conn_get_dht_ip_port(const Friend_Conn *fc) * @retval true if the friendcon_id is valid. * @retval false if the friendcon_id is not valid. */ -static bool friendconn_id_valid(non_null() const Friend_Connections *fr_c, int friendcon_id) +static bool friendconn_id_valid(const Friend_Connections *_Nonnull fr_c, int friendcon_id) { return (unsigned int)friendcon_id < fr_c->num_cons && fr_c->conns != nullptr && @@ -122,7 +122,7 @@ static bool friendconn_id_valid(non_null() const Friend_Connections *fr_c, int f * @retval false if realloc fails. * @retval true if it succeeds. */ -static bool realloc_friendconns(non_null() Friend_Connections *fr_c, uint32_t num) +static bool realloc_friendconns(Friend_Connections *_Nonnull fr_c, uint32_t num) { if (num == 0) { mem_delete(fr_c->mem, fr_c->conns); @@ -145,7 +145,7 @@ static bool realloc_friendconns(non_null() Friend_Connections *fr_c, uint32_t nu * @retval -1 on failure. * @return friendcon_id on success. */ -static int create_friend_conn(non_null() Friend_Connections *fr_c) +static int create_friend_conn(Friend_Connections *_Nonnull fr_c) { for (uint32_t i = 0; i < fr_c->num_cons; ++i) { if (fr_c->conns[i].status == FRIENDCONN_STATUS_NONE) { @@ -169,7 +169,7 @@ static int create_friend_conn(non_null() Friend_Connections *fr_c) * @retval -1 on failure. * @retval 0 on success. */ -static int wipe_friend_conn(non_null() Friend_Connections *fr_c, int friendcon_id) +static int wipe_friend_conn(Friend_Connections *_Nonnull fr_c, int friendcon_id) { if (!friendconn_id_valid(fr_c, friendcon_id)) { return -1; @@ -193,7 +193,7 @@ static int wipe_friend_conn(non_null() Friend_Connections *fr_c, int friendcon_i return 0; } -Friend_Conn *get_conn(const Friend_Connections *fr_c, int friendcon_id) +Friend_Conn *_Nullable get_conn(const Friend_Connections *fr_c, int friendcon_id) { if (!friendconn_id_valid(fr_c, friendcon_id)) { return nullptr; @@ -226,7 +226,7 @@ int getfriend_conn_id_pk(const Friend_Connections *fr_c, const uint8_t *real_pk) * @retval -1 on failure. * @retval 0 on success. */ -static int friend_add_tcp_relay(non_null() Friend_Connections *fr_c, int friendcon_id, non_null() const IP_Port *ip_port, non_null() const uint8_t *public_key) +static int friend_add_tcp_relay(Friend_Connections *_Nonnull fr_c, int friendcon_id, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key) { IP_Port ipp_copy = *ip_port; @@ -262,7 +262,7 @@ static int friend_add_tcp_relay(non_null() Friend_Connections *fr_c, int friendc } /** Connect to number saved relays for friend. */ -static void connect_to_saved_tcp_relays(non_null() Friend_Connections *fr_c, int friendcon_id, unsigned int number) +static void connect_to_saved_tcp_relays(Friend_Connections *_Nonnull fr_c, int friendcon_id, unsigned int number) { const Friend_Conn *const friend_con = get_conn(fr_c, friendcon_id); @@ -282,7 +282,7 @@ static void connect_to_saved_tcp_relays(non_null() Friend_Connections *fr_c, int } } -static unsigned int send_relays(non_null() Friend_Connections *fr_c, int friendcon_id) +static unsigned int send_relays(Friend_Connections *_Nonnull fr_c, int friendcon_id) { Friend_Conn *const friend_con = get_conn(fr_c, friendcon_id); @@ -322,7 +322,7 @@ static unsigned int send_relays(non_null() Friend_Connections *fr_c, int friendc } /** callback for recv TCP relay nodes. */ -static int tcp_relay_node_callback(non_null() void *object, uint32_t number, non_null() const IP_Port *ip_port, non_null() const uint8_t *public_key) +static int tcp_relay_node_callback(void *_Nonnull object, uint32_t number, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key) { Friend_Connections *fr_c = (Friend_Connections *)object; const Friend_Conn *friend_con = get_conn(fr_c, number); @@ -338,10 +338,10 @@ static int tcp_relay_node_callback(non_null() void *object, uint32_t number, non return add_tcp_relay(fr_c->net_crypto, ip_port, public_key); } -static int friend_new_connection(non_null() Friend_Connections *fr_c, int friendcon_id); +static int friend_new_connection(Friend_Connections *_Nonnull fr_c, int friendcon_id); /** Callback for DHT ip_port changes. */ -static void dht_ip_callback(non_null() void *object, int32_t number, non_null() const IP_Port *ip_port) +static void dht_ip_callback(void *_Nonnull object, int32_t number, const IP_Port *_Nonnull ip_port) { Friend_Connections *const fr_c = (Friend_Connections *)object; Friend_Conn *const friend_con = get_conn(fr_c, number); @@ -364,7 +364,7 @@ static void dht_ip_callback(non_null() void *object, int32_t number, non_null() } } -static void change_dht_pk(non_null() Friend_Connections *fr_c, int friendcon_id, non_null() const uint8_t *dht_public_key) +static void change_dht_pk(Friend_Connections *_Nonnull fr_c, int friendcon_id, const uint8_t *_Nonnull dht_public_key) { Friend_Conn *const friend_con = get_conn(fr_c, friendcon_id); @@ -386,7 +386,7 @@ static void change_dht_pk(non_null() Friend_Connections *fr_c, int friendcon_id, memcpy(friend_con->dht_temp_pk, dht_public_key, CRYPTO_PUBLIC_KEY_SIZE); } -static int handle_status(non_null() void *object, int id, bool status, non_null() void *userdata) +static int handle_status(void *_Nonnull object, int id, bool status, void *_Nonnull userdata) { Friend_Connections *const fr_c = (Friend_Connections *)object; Friend_Conn *const friend_con = get_conn(fr_c, id); @@ -433,7 +433,7 @@ static int handle_status(non_null() void *object, int id, bool status, non_null( } /** Callback for dht public key changes. */ -static void dht_pk_callback(non_null() void *object, int32_t number, non_null() const uint8_t *dht_public_key, non_null() void *userdata) +static void dht_pk_callback(void *_Nonnull object, int32_t number, const uint8_t *_Nonnull dht_public_key, void *_Nonnull userdata) { Friend_Connections *const fr_c = (Friend_Connections *)object; Friend_Conn *const friend_con = get_conn(fr_c, number); @@ -459,7 +459,7 @@ static void dht_pk_callback(non_null() void *object, int32_t number, non_null() onion_set_friend_dht_pubkey(fr_c->onion_c, friend_con->onion_friendnum, dht_public_key); } -static int handle_packet(non_null() void *object, int id, non_null() const uint8_t *data, uint16_t length, non_null() void *userdata) +static int handle_packet(void *_Nonnull object, int id, const uint8_t *_Nonnull data, uint16_t length, void *_Nonnull userdata) { Friend_Connections *const fr_c = (Friend_Connections *)object; @@ -518,7 +518,7 @@ static int handle_packet(non_null() void *object, int id, non_null() const uint8 return 0; } -static int handle_lossy_packet(non_null() void *object, int id, non_null() const uint8_t *data, uint16_t length, non_null() void *userdata) +static int handle_lossy_packet(void *_Nonnull object, int id, const uint8_t *_Nonnull data, uint16_t length, void *_Nonnull userdata) { const Friend_Connections *const fr_c = (const Friend_Connections *)object; @@ -549,7 +549,7 @@ static int handle_lossy_packet(non_null() void *object, int id, non_null() const return 0; } -static int handle_new_connections(non_null() void *object, non_null() const New_Connection *n_c) +static int handle_new_connections(void *_Nonnull object, const New_Connection *_Nonnull n_c) { Friend_Connections *const fr_c = (Friend_Connections *)object; const int friendcon_id = getfriend_conn_id_pk(fr_c, n_c->public_key); @@ -621,7 +621,7 @@ static int friend_new_connection(Friend_Connections *fr_c, int friendcon_id) return 0; } -static int send_ping(non_null() const Friend_Connections *fr_c, int friendcon_id) +static int send_ping(const Friend_Connections *_Nonnull fr_c, int friendcon_id) { Friend_Conn *const friend_con = get_conn(fr_c, friendcon_id); @@ -814,7 +814,7 @@ int new_friend_connection(Friend_Connections *fr_c, const uint8_t *real_public_k * @retval -1 on failure. * @retval 0 on success. */ -int kill_friend_connection(Friend_Connections *fr_c, int friendcon_id) +int kill_friend_connection(Friend_Connections *_Nonnull fr_c, int friendcon_id) { Friend_Conn *const friend_con = get_conn(fr_c, friendcon_id); @@ -934,7 +934,7 @@ Friend_Connections *new_friend_connections( } /** Send a LAN discovery packet every LAN_DISCOVERY_INTERVAL seconds. */ -static void lan_discovery(non_null() Friend_Connections *fr_c) +static void lan_discovery(Friend_Connections *_Nonnull fr_c) { if (fr_c->last_lan_discovery + LAN_DISCOVERY_INTERVAL < mono_time_get(fr_c->mono_time)) { const uint16_t first = fr_c->next_lan_port; diff --git a/toxcore/friend_connection.h b/toxcore/friend_connection.h index 6dfccebfc..e4b6baa69 100644 --- a/toxcore/friend_connection.h +++ b/toxcore/friend_connection.h @@ -53,44 +53,44 @@ typedef enum Friendconn_Status { typedef struct Friend_Connections Friend_Connections; -Net_Crypto *friendconn_net_crypto(non_null() const Friend_Connections *fr_c); +Net_Crypto *_Nonnull friendconn_net_crypto(const Friend_Connections *_Nonnull fr_c); /** @return friendcon_id corresponding to the real public key on success. * @retval -1 on failure. */ -int getfriend_conn_id_pk(non_null() const Friend_Connections *fr_c, non_null() const uint8_t *real_pk); +int getfriend_conn_id_pk(const Friend_Connections *_Nonnull fr_c, const uint8_t *_Nonnull real_pk); /** @brief Increases lock_count for the connection with friendcon_id by 1. * * @retval 0 on success. * @retval -1 on failure. */ -int friend_connection_lock(non_null() const Friend_Connections *fr_c, int friendcon_id); +int friend_connection_lock(const Friend_Connections *_Nonnull fr_c, int friendcon_id); /** * @retval FRIENDCONN_STATUS_CONNECTED if the friend is connected. * @retval FRIENDCONN_STATUS_CONNECTING if the friend isn't connected. * @retval FRIENDCONN_STATUS_NONE on failure. */ -unsigned int friend_con_connected(non_null() const Friend_Connections *fr_c, int friendcon_id); +unsigned int friend_con_connected(const Friend_Connections *_Nonnull fr_c, int friendcon_id); /** @brief Copy public keys associated to friendcon_id. * * @retval 0 on success. * @retval -1 on failure. */ -int get_friendcon_public_keys(nullable() uint8_t *real_pk, nullable() uint8_t *dht_temp_pk, non_null() const Friend_Connections *fr_c, int friendcon_id); +int get_friendcon_public_keys(uint8_t *_Nullable real_pk, uint8_t *_Nullable dht_temp_pk, const Friend_Connections *_Nonnull fr_c, int friendcon_id); /** Set temp dht key for connection. */ -void set_dht_temp_pk(non_null() Friend_Connections *fr_c, int friendcon_id, non_null() const uint8_t *dht_temp_pk, non_null() void *userdata); +void set_dht_temp_pk(Friend_Connections *_Nonnull fr_c, int friendcon_id, const uint8_t *_Nonnull dht_temp_pk, void *_Nonnull userdata); -typedef int global_status_cb(void *object, int friendcon_id, bool status, void *userdata); +typedef int global_status_cb(void *_Nullable object, int friendcon_id, bool status, void *_Nullable userdata); -typedef int fc_status_cb(void *object, int friendcon_id, bool status, void *userdata); -typedef int fc_data_cb(void *object, int friendcon_id, const uint8_t *data, uint16_t length, void *userdata); -typedef int fc_lossy_data_cb(void *object, int friendcon_id, const uint8_t *data, uint16_t length, void *userdata); +typedef int fc_status_cb(void *_Nullable object, int friendcon_id, bool status, void *_Nullable userdata); +typedef int fc_data_cb(void *_Nullable object, int friendcon_id, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata); +typedef int fc_lossy_data_cb(void *_Nullable object, int friendcon_id, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata); /** Set global status callback for friend connections. */ -void set_global_status_callback(non_null() Friend_Connections *fr_c, nullable() global_status_cb *global_status_callback, nullable() void *object); +void set_global_status_callback(Friend_Connections *_Nonnull fr_c, global_status_cb *_Nullable global_status_callback, void *_Nullable object); /** @brief Set the callbacks for the friend connection. * @param index is the index (0 to (MAX_FRIEND_CONNECTION_CALLBACKS - 1)) we * want the callback to set in the array. @@ -98,17 +98,17 @@ void set_global_status_callback(non_null() Friend_Connections *fr_c, nullable() * @retval 0 on success. * @retval -1 on failure */ -int friend_connection_callbacks(non_null() const Friend_Connections *fr_c, int friendcon_id, unsigned int index, - nullable() fc_status_cb *status_callback, - nullable() fc_data_cb *data_callback, - nullable() fc_lossy_data_cb *lossy_data_callback, - nullable() void *object, int number); +int friend_connection_callbacks(const Friend_Connections *_Nonnull fr_c, int friendcon_id, unsigned int index, + fc_status_cb *_Nullable status_callback, + fc_data_cb *_Nullable data_callback, + fc_lossy_data_cb *_Nullable lossy_data_callback, + void *_Nullable object, int number); /** @brief return the crypt_connection_id for the connection. * * @return crypt_connection_id on success. * @retval -1 on failure. */ -int friend_connection_crypt_connection_id(non_null() const Friend_Connections *fr_c, int friendcon_id); +int friend_connection_crypt_connection_id(const Friend_Connections *_Nonnull fr_c, int friendcon_id); /** @brief Create a new friend connection. * If one to that real public key already exists, increase lock count and return it. @@ -116,14 +116,14 @@ int friend_connection_crypt_connection_id(non_null() const Friend_Connections *f * @retval -1 on failure. * @return connection id on success. */ -int new_friend_connection(non_null() Friend_Connections *fr_c, non_null() const uint8_t *real_public_key); +int new_friend_connection(Friend_Connections *_Nonnull fr_c, const uint8_t *_Nonnull real_public_key); /** @brief Kill a friend connection. * * @retval -1 on failure. * @retval 0 on success. */ -int kill_friend_connection(non_null() Friend_Connections *fr_c, int friendcon_id); +int kill_friend_connection(Friend_Connections *_Nonnull fr_c, int friendcon_id); /** @brief Send a Friend request packet. * @@ -131,30 +131,30 @@ int kill_friend_connection(non_null() Friend_Connections *fr_c, int friendcon_id * @retval 0 if it sent the friend request directly to the friend. * @return the number of peers it was routed through if it did not send it directly. */ -int send_friend_request_packet(non_null() Friend_Connections *fr_c, int friendcon_id, uint32_t nospam_num, non_null() const uint8_t *data, uint16_t length); +int send_friend_request_packet(Friend_Connections *_Nonnull fr_c, int friendcon_id, uint32_t nospam_num, const uint8_t *_Nonnull data, uint16_t length); typedef int fr_request_cb( - void *object, const uint8_t *source_pubkey, const uint8_t *data, uint16_t length, void *userdata); + void *_Nonnull object, const uint8_t *_Nonnull source_pubkey, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata); /** @brief Set friend request callback. * * This function will be called every time a friend request packet is received. */ -void set_friend_request_callback(non_null() Friend_Connections *fr_c, non_null() fr_request_cb *fr_request_callback, non_null() void *object); +void set_friend_request_callback(Friend_Connections *_Nonnull fr_c, fr_request_cb *_Nonnull fr_request_callback, void *_Nonnull object); /** Create new friend_connections instance. */ -Friend_Connections *new_friend_connections(non_null() const Logger *logger, non_null() const Memory *mem, non_null() const Mono_Time *mono_time, non_null() const Network *ns, - non_null() Onion_Client *onion_c, bool local_discovery_enabled); +Friend_Connections *_Nullable new_friend_connections(const Logger *_Nonnull logger, const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, const Network *_Nonnull ns, + Onion_Client *_Nonnull onion_c, bool local_discovery_enabled); /** main friend_connections loop. */ -void do_friend_connections(non_null() Friend_Connections *fr_c, non_null() void *userdata); +void do_friend_connections(Friend_Connections *_Nonnull fr_c, void *_Nonnull userdata); /** Free everything related with friend_connections. */ -void kill_friend_connections(nullable() Friend_Connections *fr_c); +void kill_friend_connections(Friend_Connections *_Nullable fr_c); typedef struct Friend_Conn Friend_Conn; -Friend_Conn *get_conn(non_null() const Friend_Connections *fr_c, int friendcon_id); -int friend_conn_get_onion_friendnum(non_null() const Friend_Conn *fc); -const IP_Port *friend_conn_get_dht_ip_port(non_null() const Friend_Conn *fc); +Friend_Conn *_Nullable get_conn(const Friend_Connections *_Nonnull fr_c, int friendcon_id); +int friend_conn_get_onion_friendnum(const Friend_Conn *_Nonnull fc); +const IP_Port *_Nullable friend_conn_get_dht_ip_port(const Friend_Conn *_Nonnull fc); #endif /* C_TOXCORE_TOXCORE_FRIEND_CONNECTION_H */ diff --git a/toxcore/friend_requests.c b/toxcore/friend_requests.c index fa249fec4..00373274c 100644 --- a/toxcore/friend_requests.c +++ b/toxcore/friend_requests.c @@ -78,7 +78,7 @@ void set_filter_function(Friend_Requests *fr, filter_function_cb *function, void } /** Add to list of received friend requests. */ -static void addto_receivedlist(non_null() Friend_Requests *fr, non_null() const uint8_t *real_pk) +static void addto_receivedlist(Friend_Requests *_Nonnull fr, const uint8_t *_Nonnull real_pk) { if (fr->received.requests_index >= MAX_RECEIVED_STORED) { fr->received.requests_index = 0; @@ -93,7 +93,7 @@ static void addto_receivedlist(non_null() Friend_Requests *fr, non_null() const * @retval false if it did not. * @retval true if it did. */ -static bool request_received(non_null() const Friend_Requests *fr, non_null() const uint8_t *real_pk) +static bool request_received(const Friend_Requests *_Nonnull fr, const uint8_t *_Nonnull real_pk) { for (uint32_t i = 0; i < MAX_RECEIVED_STORED; ++i) { if (pk_equal(fr->received.requests[i], real_pk)) { @@ -109,7 +109,7 @@ static bool request_received(non_null() const Friend_Requests *fr, non_null() co * @retval 0 if it removed it successfully. * @retval -1 if it didn't find it. */ -int remove_request_received(Friend_Requests *fr, const uint8_t *real_pk) +int remove_request_received(Friend_Requests *_Nonnull fr, const uint8_t *_Nonnull real_pk) { for (uint32_t i = 0; i < MAX_RECEIVED_STORED; ++i) { if (pk_equal(fr->received.requests[i], real_pk)) { @@ -121,7 +121,7 @@ int remove_request_received(Friend_Requests *fr, const uint8_t *real_pk) return -1; } -static int friendreq_handlepacket(non_null() void *object, non_null() const uint8_t *source_pubkey, non_null() const uint8_t *data, uint16_t length, non_null() void *userdata) +static int friendreq_handlepacket(void *_Nonnull object, const uint8_t *_Nonnull source_pubkey, const uint8_t *_Nonnull data, uint16_t length, void *_Nonnull userdata) { Friend_Requests *const fr = (Friend_Requests *)object; diff --git a/toxcore/friend_requests.h b/toxcore/friend_requests.h index 5077d6727..0a31367ce 100644 --- a/toxcore/friend_requests.h +++ b/toxcore/friend_requests.h @@ -21,33 +21,33 @@ typedef struct Friend_Requests Friend_Requests; /** Set and get the nospam variable used to prevent one type of friend request spam. */ -void set_nospam(non_null() Friend_Requests *fr, uint32_t num); -uint32_t get_nospam(non_null() const Friend_Requests *fr); +void set_nospam(Friend_Requests *_Nonnull fr, uint32_t num); +uint32_t get_nospam(const Friend_Requests *_Nonnull fr); /** @brief Remove real_pk from received_requests list. * * @retval 0 if it removed it successfully. * @retval -1 if it didn't find it. */ -int remove_request_received(non_null() Friend_Requests *fr, non_null() const uint8_t *real_pk); +int remove_request_received(Friend_Requests *_Nonnull fr, const uint8_t *_Nonnull real_pk); -typedef void fr_friend_request_cb(void *object, const uint8_t *public_key, const uint8_t *message, size_t length, - void *user_data); +typedef void fr_friend_request_cb(void *_Nonnull object, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull message, size_t length, + void *_Nullable user_data); /** Set the function that will be executed when a friend request for us is received. */ -void callback_friendrequest(non_null() Friend_Requests *fr, non_null() fr_friend_request_cb *function, non_null() void *object); +void callback_friendrequest(Friend_Requests *_Nonnull fr, fr_friend_request_cb *_Nonnull function, void *_Nonnull object); -typedef int filter_function_cb(void *object, const uint8_t *public_key); +typedef int filter_function_cb(void *_Nonnull object, const uint8_t *_Nonnull public_key); /** @brief Set the function used to check if a friend request should be displayed to the user or not. * It must return 0 if the request is ok (anything else if it is bad). */ -void set_filter_function(non_null() Friend_Requests *fr, non_null() filter_function_cb *function, non_null() void *userdata); +void set_filter_function(Friend_Requests *_Nonnull fr, filter_function_cb *_Nonnull function, void *_Nonnull userdata); /** Sets up friendreq packet handlers. */ -void friendreq_init(non_null() Friend_Requests *fr, non_null() Friend_Connections *fr_c); +void friendreq_init(Friend_Requests *_Nonnull fr, Friend_Connections *_Nonnull fr_c); -Friend_Requests *friendreq_new(non_null() const Memory *mem); +Friend_Requests *_Nullable friendreq_new(const Memory *_Nonnull mem); -void friendreq_kill(nullable() Friend_Requests *fr); +void friendreq_kill(Friend_Requests *_Nullable fr); #endif /* C_TOXCORE_TOXCORE_FRIEND_REQUESTS_H */ diff --git a/toxcore/group.c b/toxcore/group.c index c4b63e602..4eddd9d4b 100644 --- a/toxcore/group.c +++ b/toxcore/group.c @@ -216,17 +216,17 @@ const Mono_Time *g_mono_time(const Group_Chats *g_c) return g_c->mono_time; } -static bool group_id_eq(non_null() const uint8_t *a, non_null() const uint8_t *b) +static bool group_id_eq(const uint8_t *_Nonnull a, const uint8_t *_Nonnull b) { return pk_equal(a, b); } -static bool g_title_eq(non_null() const Group_c *g, non_null() const uint8_t *title, uint8_t title_len) +static bool g_title_eq(const Group_c *_Nonnull g, const uint8_t *_Nonnull title, uint8_t title_len) { return memeq(g->title, g->title_len, title, title_len); } -static bool g_peer_nick_eq(non_null() const Group_Peer *peer, non_null() const uint8_t *nick, uint8_t nick_len) +static bool g_peer_nick_eq(const Group_Peer *_Nonnull peer, const uint8_t *_Nonnull nick, uint8_t nick_len) { return memeq(peer->nick, peer->nick_len, nick, nick_len); } @@ -235,7 +235,7 @@ static bool g_peer_nick_eq(non_null() const Group_Peer *peer, non_null() const u * @retval false if the groupnumber is not valid. * @retval true if the groupnumber is valid. */ -static bool is_groupnumber_valid(non_null() const Group_Chats *g_c, uint32_t groupnumber) +static bool is_groupnumber_valid(const Group_Chats *_Nonnull g_c, uint32_t groupnumber) { return groupnumber < g_c->num_chats && g_c->chats != nullptr @@ -247,7 +247,7 @@ static bool is_groupnumber_valid(non_null() const Group_Chats *g_c, uint32_t gro * @retval false if mem_vrealloc fails. * @retval true if it succeeds. */ -static bool realloc_conferences(non_null() Group_Chats *g_c, uint16_t num) +static bool realloc_conferences(Group_Chats *_Nonnull g_c, uint16_t num) { if (num == 0) { mem_delete(g_c->mem, g_c->chats); @@ -265,7 +265,7 @@ static bool realloc_conferences(non_null() Group_Chats *g_c, uint16_t num) return true; } -static void setup_conference(non_null() Group_c *g) +static void setup_conference(Group_c *_Nonnull g) { *g = empty_group_c; g->maxfrozen = MAX_FROZEN_DEFAULT; @@ -276,7 +276,7 @@ static void setup_conference(non_null() Group_c *g) * @retval -1 on failure. * @return groupnumber on success. */ -static int32_t create_group_chat(non_null() Group_Chats *g_c) +static int32_t create_group_chat(Group_Chats *_Nonnull g_c) { for (uint16_t i = 0; i < g_c->num_chats; ++i) { if (g_c->chats[i].status == GROUPCHAT_STATUS_NONE) { @@ -294,7 +294,7 @@ static int32_t create_group_chat(non_null() Group_Chats *g_c) return -1; } -static void wipe_group_c(non_null() const Memory *mem, non_null() Group_c *g) +static void wipe_group_c(const Memory *_Nonnull mem, Group_c *_Nonnull g) { mem_delete(mem, g->frozen); mem_delete(mem, g->group); @@ -305,7 +305,7 @@ static void wipe_group_c(non_null() const Memory *mem, non_null() Group_c *g) * * @retval true on success. */ -static bool wipe_group_chat(non_null() Group_Chats *g_c, uint32_t groupnumber) +static bool wipe_group_chat(Group_Chats *_Nonnull g_c, uint32_t groupnumber) { if (groupnumber >= g_c->num_chats || g_c->chats == nullptr) { return false; @@ -329,7 +329,7 @@ static bool wipe_group_chat(non_null() Group_Chats *g_c, uint32_t groupnumber) return true; } -static Group_c *get_group_c(non_null() const Group_Chats *g_c, uint32_t groupnumber) +static Group_c *get_group_c(const Group_Chats *_Nonnull g_c, uint32_t groupnumber) { if (!is_groupnumber_valid(g_c, groupnumber)) { return nullptr; @@ -346,7 +346,7 @@ static Group_c *get_group_c(non_null() const Group_Chats *g_c, uint32_t groupnum * * TODO(irungentoo): make this more efficient. */ -static int peer_in_group(non_null() const Group_c *g, non_null() const uint8_t *real_pk) +static int peer_in_group(const Group_c *_Nonnull g, const uint8_t *_Nonnull real_pk) { for (uint32_t i = 0; i < g->numpeers; ++i) { if (pk_equal(g->group[i].real_pk, real_pk)) { @@ -357,7 +357,7 @@ static int peer_in_group(non_null() const Group_c *g, non_null() const uint8_t * return -1; } -static int frozen_in_group(non_null() const Group_c *g, non_null() const uint8_t *real_pk) +static int frozen_in_group(const Group_c *_Nonnull g, const uint8_t *_Nonnull real_pk) { for (uint32_t i = 0; i < g->numfrozen; ++i) { if (pk_equal(g->frozen[i].real_pk, real_pk)) { @@ -376,7 +376,7 @@ static int frozen_in_group(non_null() const Group_c *g, non_null() const uint8_t * * TODO(irungentoo): make this more efficient and maybe use constant time comparisons? */ -static int32_t get_group_num(non_null() const Group_Chats *g_c, const uint8_t type, non_null() const uint8_t *id) +static int32_t get_group_num(const Group_Chats *_Nonnull g_c, const uint8_t type, const uint8_t *_Nonnull id) { for (uint16_t i = 0; i < g_c->num_chats; ++i) { if (g_c->chats[i].type == type && group_id_eq(g_c->chats[i].id, id)) { @@ -406,7 +406,7 @@ int32_t conference_by_id(const Group_Chats *g_c, const uint8_t *id) * * TODO(irungentoo): make this more efficient. */ -static int get_peer_index(non_null() const Group_c *g, uint16_t peer_number) +static int get_peer_index(const Group_c *_Nonnull g, uint16_t peer_number) { for (uint32_t i = 0; i < g->numpeers; ++i) { if (g->group[i].peer_number == peer_number) { @@ -417,7 +417,7 @@ static int get_peer_index(non_null() const Group_c *g, uint16_t peer_number) return -1; } -static uint64_t calculate_comp_value(non_null() const uint8_t *pk1, non_null() const uint8_t *pk2) +static uint64_t calculate_comp_value(const uint8_t *_Nonnull pk1, const uint8_t *_Nonnull pk2) { uint64_t cmp1 = 0; uint64_t cmp2 = 0; @@ -436,7 +436,7 @@ typedef enum Groupchat_Closest_Change { GROUPCHAT_CLOSEST_CHANGE_REMOVED, } Groupchat_Closest_Change; -static bool add_to_closest(non_null() Group_c *g, non_null() const uint8_t *real_pk, non_null() const uint8_t *temp_pk) +static bool add_to_closest(Group_c *_Nonnull g, const uint8_t *_Nonnull real_pk, const uint8_t *_Nonnull temp_pk) { if (pk_equal(g->real_pk, real_pk)) { return false; @@ -511,7 +511,7 @@ static bool add_to_closest(non_null() Group_c *g, non_null() const uint8_t *real return true; } -static bool pk_in_closest_peers(non_null() const Group_c *g, non_null() const uint8_t *real_pk) +static bool pk_in_closest_peers(const Group_c *_Nonnull g, const uint8_t *_Nonnull real_pk) { for (unsigned int i = 0; i < DESIRED_CLOSEST; ++i) { if (!g->closest_peers[i].active) { @@ -526,9 +526,9 @@ static bool pk_in_closest_peers(non_null() const Group_c *g, non_null() const ui return false; } -static void remove_connection_reason(non_null() Group_Chats *g_c, non_null() Group_c *g, uint16_t i, uint8_t reason); +static void remove_connection_reason(Group_Chats *_Nonnull g_c, Group_c *_Nonnull g, uint16_t i, uint8_t reason); -static void purge_closest(non_null() Group_Chats *g_c, uint32_t groupnumber) +static void purge_closest(Group_Chats *_Nonnull g_c, uint32_t groupnumber) { Group_c *g = get_group_c(g_c, groupnumber); @@ -554,11 +554,11 @@ static void purge_closest(non_null() Group_Chats *g_c, uint32_t groupnumber) } } -static bool send_packet_online(non_null() const Friend_Connections *fr_c, int friendcon_id, uint16_t group_num, uint8_t type, non_null() const uint8_t *id); +static bool send_packet_online(const Friend_Connections *_Nonnull fr_c, int friendcon_id, uint16_t group_num, uint8_t type, const uint8_t *_Nonnull id); -static int add_conn_to_groupchat(non_null() Group_Chats *g_c, int friendcon_id, non_null() Group_c *g, uint8_t reason, bool lock); +static int add_conn_to_groupchat(Group_Chats *_Nonnull g_c, int friendcon_id, Group_c *_Nonnull g, uint8_t reason, bool lock); -static void add_closest_connections(non_null() Group_Chats *g_c, uint32_t groupnumber, nullable() void *userdata) +static void add_closest_connections(Group_Chats *_Nonnull g_c, uint32_t groupnumber, void *_Nullable userdata) { Group_c *g = get_group_c(g_c, groupnumber); if (g == nullptr) { @@ -603,7 +603,7 @@ static void add_closest_connections(non_null() Group_Chats *g_c, uint32_t groupn } } -static bool connect_to_closest(non_null() Group_Chats *g_c, uint32_t groupnumber, nullable() void *userdata) +static bool connect_to_closest(Group_Chats *_Nonnull g_c, uint32_t groupnumber, void *_Nullable userdata) { Group_c *g = get_group_c(g_c, groupnumber); if (g == nullptr) { @@ -629,7 +629,7 @@ static bool connect_to_closest(non_null() Group_Chats *g_c, uint32_t groupnumber return true; } -static int get_frozen_index(non_null() const Group_c *g, uint16_t peer_number) +static int get_frozen_index(const Group_c *_Nonnull g, uint16_t peer_number) { for (uint32_t i = 0; i < g->numfrozen; ++i) { if (g->frozen[i].peer_number == peer_number) { @@ -640,7 +640,7 @@ static int get_frozen_index(non_null() const Group_c *g, uint16_t peer_number) return -1; } -static bool delete_frozen(non_null() const Memory *mem, non_null() Group_c *g, uint32_t frozen_index) +static bool delete_frozen(const Memory *_Nonnull mem, Group_c *_Nonnull g, uint32_t frozen_index) { if (frozen_index >= g->numfrozen) { return false; @@ -673,7 +673,7 @@ static bool delete_frozen(non_null() const Memory *mem, non_null() Group_c *g, u * @return peer index if peer is in the conference. * @retval -1 otherwise, and on error. */ -static int note_peer_active(non_null() Group_Chats *g_c, uint32_t groupnumber, uint16_t peer_number, nullable() void *userdata) +static int note_peer_active(Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint16_t peer_number, void *_Nullable userdata) { Group_c *g = get_group_c(g_c, groupnumber); if (g == nullptr) { @@ -727,8 +727,8 @@ static int note_peer_active(non_null() Group_Chats *g_c, uint32_t groupnumber, u return thawed_index; } -static bool delpeer(non_null() Group_Chats *g_c, uint32_t groupnumber, int peer_index, nullable() void *userdata); -static void delete_any_peer_with_pk(non_null() Group_Chats *g_c, uint32_t groupnumber, non_null() const uint8_t *real_pk, nullable() void *userdata) +static bool delpeer(Group_Chats *_Nonnull g_c, uint32_t groupnumber, int peer_index, void *_Nullable userdata); +static void delete_any_peer_with_pk(Group_Chats *_Nonnull g_c, uint32_t groupnumber, const uint8_t *_Nonnull real_pk, void *_Nullable userdata) { Group_c *g = get_group_c(g_c, groupnumber); if (g == nullptr) { @@ -760,8 +760,8 @@ static void delete_any_peer_with_pk(non_null() Group_Chats *g_c, uint32_t groupn * @return peer_index if success or peer already in chat. * @retval -1 if error. */ -static int addpeer(non_null() Group_Chats *g_c, uint32_t groupnumber, non_null() const uint8_t *real_pk, non_null() const uint8_t *temp_pk, - uint16_t peer_number, nullable() void *userdata, bool fresh, bool do_gc_callback) +static int addpeer(Group_Chats *_Nonnull g_c, uint32_t groupnumber, const uint8_t *_Nonnull real_pk, const uint8_t *_Nonnull temp_pk, + uint16_t peer_number, void *_Nullable userdata, bool fresh, bool do_gc_callback) { Group_c *g = get_group_c(g_c, groupnumber); if (g == nullptr) { @@ -834,7 +834,7 @@ static int addpeer(non_null() Group_Chats *g_c, uint32_t groupnumber, non_null() return new_index; } -static void remove_connection(non_null() Group_Chats *g_c, non_null() Group_c *g, uint16_t i) +static void remove_connection(Group_Chats *_Nonnull g_c, Group_c *_Nonnull g, uint16_t i) { if ((g->connections[i].reasons & GROUPCHAT_CONNECTION_REASON_INTRODUCER) != 0) { --g->num_introducer_connections; @@ -844,7 +844,7 @@ static void remove_connection(non_null() Group_Chats *g_c, non_null() Group_c *g g->connections[i].type = GROUPCHAT_CONNECTION_NONE; } -static void remove_from_closest(non_null() Group_c *g, int peer_index) +static void remove_from_closest(Group_c *_Nonnull g, int peer_index) { for (uint32_t i = 0; i < DESIRED_CLOSEST; ++i) { if (g->closest_peers[i].active @@ -919,7 +919,7 @@ static bool delpeer(Group_Chats *g_c, uint32_t groupnumber, int peer_index, void } /** Order peers with friends first and with more recently active earlier */ -static bool group_peer_less_handler(non_null() const void *object, non_null() const void *a, non_null() const void *b) +static bool group_peer_less_handler(const void *_Nonnull object, const void *_Nonnull a, const void *_Nonnull b) { const Group_Peer *pa = (const Group_Peer *)a; const Group_Peer *pb = (const Group_Peer *)b; @@ -931,26 +931,26 @@ static bool group_peer_less_handler(non_null() const void *object, non_null() co return cmp_uint(pb->last_active, pa->last_active) < 0; } -static const void *group_peer_get_handler(non_null() const void *arr, uint32_t index) +static const void *group_peer_get_handler(const void *_Nonnull arr, uint32_t index) { const Group_Peer *entries = (const Group_Peer *)arr; return &entries[index]; } -static void group_peer_set_handler(non_null() void *arr, uint32_t index, non_null() const void *val) +static void group_peer_set_handler(void *_Nonnull arr, uint32_t index, const void *_Nonnull val) { Group_Peer *entries = (Group_Peer *)arr; const Group_Peer *entry = (const Group_Peer *)val; entries[index] = *entry; } -static void *group_peer_subarr_handler(non_null() void *arr, uint32_t index, uint32_t size) +static void *group_peer_subarr_handler(void *_Nonnull arr, uint32_t index, uint32_t size) { Group_Peer *entries = (Group_Peer *)arr; return &entries[index]; } -static void *group_peer_alloc_handler(non_null() const void *object, uint32_t size) +static void *group_peer_alloc_handler(const void *_Nonnull object, uint32_t size) { const Memory *mem = (const Memory *)object; Group_Peer *tmp = (Group_Peer *)mem_valloc(mem, size, sizeof(Group_Peer)); @@ -962,7 +962,7 @@ static void *group_peer_alloc_handler(non_null() const void *object, uint32_t si return tmp; } -static void group_peer_delete_handler(non_null() const void *object, non_null() void *arr, uint32_t size) +static void group_peer_delete_handler(const void *_Nonnull object, void *_Nonnull arr, uint32_t size) { const Memory *mem = (const Memory *)object; mem_delete(mem, arr); @@ -981,7 +981,7 @@ static const Sort_Funcs group_peer_cmp_funcs = { * * @retval true if any frozen peers are removed. */ -static bool delete_old_frozen(non_null() Group_c *g, non_null() const Memory *mem) +static bool delete_old_frozen(Group_c *_Nonnull g, const Memory *_Nonnull mem) { if (g->numfrozen <= g->maxfrozen) { return false; @@ -1009,9 +1009,9 @@ static bool delete_old_frozen(non_null() Group_c *g, non_null() const Memory *me return true; } -static bool try_send_rejoin(non_null() Group_Chats *g_c, non_null() Group_c *g, non_null() const uint8_t *real_pk); +static bool try_send_rejoin(Group_Chats *_Nonnull g_c, Group_c *_Nonnull g, const uint8_t *_Nonnull real_pk); -static bool freeze_peer(non_null() Group_Chats *g_c, uint32_t groupnumber, int peer_index, nullable() void *userdata) +static bool freeze_peer(Group_Chats *_Nonnull g_c, uint32_t groupnumber, int peer_index, void *_Nullable userdata) { Group_c *g = get_group_c(g_c, groupnumber); if (g == nullptr) { @@ -1049,8 +1049,8 @@ static bool freeze_peer(non_null() Group_Chats *g_c, uint32_t groupnumber, int p * * @retval true on success. */ -static bool setnick(non_null() Group_Chats *g_c, uint32_t groupnumber, int peer_index, non_null() const uint8_t *nick, uint16_t nick_len, - nullable() void *userdata, bool do_gc_callback) +static bool setnick(Group_Chats *_Nonnull g_c, uint32_t groupnumber, int peer_index, const uint8_t *_Nonnull nick, uint16_t nick_len, + void *_Nullable userdata, bool do_gc_callback) { if (nick_len > MAX_NAME_LENGTH) { return false; @@ -1086,8 +1086,8 @@ static bool setnick(non_null() Group_Chats *g_c, uint32_t groupnumber, int peer_ * * @retval true on success. */ -static bool settitle(non_null() Group_Chats *g_c, uint32_t groupnumber, int peer_index, non_null() const uint8_t *title, uint8_t title_len, - nullable() void *userdata) +static bool settitle(Group_Chats *_Nonnull g_c, uint32_t groupnumber, int peer_index, const uint8_t *_Nonnull title, uint8_t title_len, + void *_Nullable userdata) { if (title_len > MAX_NAME_LENGTH || title_len == 0) { return false; @@ -1117,7 +1117,7 @@ static bool settitle(non_null() Group_Chats *g_c, uint32_t groupnumber, int peer } /** Check if the group has no online connection, and freeze all peers if so */ -static void check_disconnected(non_null() Group_Chats *g_c, uint32_t groupnumber, nullable() void *userdata) +static void check_disconnected(Group_Chats *_Nonnull g_c, uint32_t groupnumber, void *_Nullable userdata) { const Group_c *g = get_group_c(g_c, groupnumber); if (g == nullptr) { @@ -1137,8 +1137,8 @@ static void check_disconnected(non_null() Group_Chats *g_c, uint32_t groupnumber } } -static void set_conns_type_connections(non_null() Group_Chats *g_c, uint32_t groupnumber, int friendcon_id, uint8_t type, - nullable() void *userdata) +static void set_conns_type_connections(Group_Chats *_Nonnull g_c, uint32_t groupnumber, int friendcon_id, uint8_t type, + void *_Nullable userdata) { Group_c *g = get_group_c(g_c, groupnumber); if (g == nullptr) { @@ -1164,14 +1164,14 @@ static void set_conns_type_connections(non_null() Group_Chats *g_c, uint32_t gro } /** Set the type for all connections with friendcon_id */ -static void set_conns_status_groups(non_null() Group_Chats *g_c, int friendcon_id, uint8_t type, nullable() void *userdata) +static void set_conns_status_groups(Group_Chats *_Nonnull g_c, int friendcon_id, uint8_t type, void *_Nullable userdata) { for (uint16_t i = 0; i < g_c->num_chats; ++i) { set_conns_type_connections(g_c, i, friendcon_id, type, userdata); } } -static void rejoin_frozen_friend(non_null() Group_Chats *g_c, int friendcon_id) +static void rejoin_frozen_friend(Group_Chats *_Nonnull g_c, int friendcon_id) { uint8_t real_pk[CRYPTO_PUBLIC_KEY_SIZE]; get_friendcon_public_keys(real_pk, nullptr, g_c->fr_c, friendcon_id); @@ -1192,7 +1192,7 @@ static void rejoin_frozen_friend(non_null() Group_Chats *g_c, int friendcon_id) } } -static int g_handle_any_status(non_null() void *object, int friendcon_id, bool status, nullable() void *userdata) +static int g_handle_any_status(void *_Nonnull object, int friendcon_id, bool status, void *_Nullable userdata) { Group_Chats *g_c = (Group_Chats *)object; if (status) { @@ -1202,7 +1202,7 @@ static int g_handle_any_status(non_null() void *object, int friendcon_id, bool s return 0; } -static int g_handle_status(non_null() void *object, int friendcon_id, bool status, nullable() void *userdata) +static int g_handle_status(void *_Nonnull object, int friendcon_id, bool status, void *_Nullable userdata) { Group_Chats *g_c = (Group_Chats *)object; if (status) { /* Went online */ @@ -1215,8 +1215,8 @@ static int g_handle_status(non_null() void *object, int friendcon_id, bool statu return 0; } -static int g_handle_packet(non_null() void *object, int friendcon_id, non_null() const uint8_t *data, uint16_t length, nullable() void *userdata); -static int handle_lossy(non_null() void *object, int friendcon_id, non_null() const uint8_t *data, uint16_t length, nullable() void *userdata); +static int g_handle_packet(void *_Nonnull object, int friendcon_id, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata); +static int handle_lossy(void *_Nonnull object, int friendcon_id, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata); /** @brief Add friend to group chat. * * @return connections index on success @@ -1269,7 +1269,7 @@ static int add_conn_to_groupchat(Group_Chats *g_c, int friendcon_id, Group_c *g, return ind; } -static bool send_peer_introduced(non_null() const Group_Chats *g_c, int friendcon_id, uint16_t group_num); +static bool send_peer_introduced(const Group_Chats *_Nonnull g_c, int friendcon_id, uint16_t group_num); /** @brief Removes reason for keeping connection. * @@ -1332,7 +1332,7 @@ int add_groupchat(Group_Chats *g_c, const Random *rng, uint8_t type) return groupnumber; } -static bool group_leave(non_null() const Group_Chats *g_c, uint32_t groupnumber, bool permanent); +static bool group_leave(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, bool permanent); /** @brief Delete a groupchat from the chats array, informing the group first as * appropriate. @@ -1372,7 +1372,7 @@ bool del_groupchat(Group_Chats *g_c, uint32_t groupnumber, bool leave_permanentl return wipe_group_chat(g_c, groupnumber); } -static const Group_Peer *peer_in_list(non_null() const Group_c *g, uint32_t peernumber, bool frozen) +static const Group_Peer *peer_in_list(const Group_c *_Nonnull g, uint32_t peernumber, bool frozen) { const Group_Peer *list = frozen ? g->frozen : g->group; const uint32_t num = frozen ? g->numfrozen : g->numpeers; @@ -1591,7 +1591,7 @@ bool conference_get_id(const Group_Chats *g_c, uint32_t groupnumber, uint8_t *id * @retval true on success * @retval false on failure */ -static bool send_packet_group_peer(non_null() const Friend_Connections *fr_c, int friendcon_id, uint8_t packet_id, uint16_t group_num, non_null() const uint8_t *data, uint16_t length) +static bool send_packet_group_peer(const Friend_Connections *_Nonnull fr_c, int friendcon_id, uint8_t packet_id, uint16_t group_num, const uint8_t *_Nonnull data, uint16_t length) { if (1 + sizeof(uint16_t) + length > MAX_CRYPTO_DATA_SIZE) { return false; @@ -1612,7 +1612,7 @@ static bool send_packet_group_peer(non_null() const Friend_Connections *fr_c, in * @retval true on success * @retval false on failure */ -static bool send_lossy_group_peer(non_null() const Friend_Connections *fr_c, int friendcon_id, uint8_t packet_id, uint16_t group_num, non_null() const uint8_t *data, uint16_t length) +static bool send_lossy_group_peer(const Friend_Connections *_Nonnull fr_c, int friendcon_id, uint8_t packet_id, uint16_t group_num, const uint8_t *_Nonnull data, uint16_t length) { if (1 + sizeof(uint16_t) + length > MAX_CRYPTO_DATA_SIZE) { return false; @@ -1688,9 +1688,9 @@ static bool try_send_rejoin(Group_Chats *g_c, Group_c *g, const uint8_t *real_pk return true; } -static bool send_peer_query(non_null() const Group_Chats *g_c, int friendcon_id, uint16_t group_num); +static bool send_peer_query(const Group_Chats *_Nonnull g_c, int friendcon_id, uint16_t group_num); -static bool send_invite_response(non_null() Group_Chats *g_c, int groupnumber, uint32_t friendnumber, non_null() const uint8_t *data, uint16_t length); +static bool send_invite_response(Group_Chats *_Nonnull g_c, int groupnumber, uint32_t friendnumber, const uint8_t *_Nonnull data, uint16_t length); /** @brief Join a group (we need to have been invited first). * @@ -1898,12 +1898,12 @@ int callback_groupchat_delete(const Group_Chats *g_c, uint32_t groupnumber, grou return 0; } -static int send_message_group(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint8_t message_id, nullable() const uint8_t *data, +static int send_message_group(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint8_t message_id, const uint8_t *_Nullable data, uint16_t len); /** @brief send a ping message * return true on success */ -static bool group_ping_send(non_null() const Group_Chats *g_c, uint32_t groupnumber) +static bool group_ping_send(const Group_Chats *_Nonnull g_c, uint32_t groupnumber) { return send_message_group(g_c, groupnumber, GROUP_MESSAGE_PING_ID, nullptr, 0) > 0; } @@ -1911,7 +1911,7 @@ static bool group_ping_send(non_null() const Group_Chats *g_c, uint32_t groupnum /** @brief send a new_peer message * return true on success */ -static bool group_new_peer_send(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint16_t peer_num, non_null() const uint8_t *real_pk, non_null() const uint8_t *temp_pk) +static bool group_new_peer_send(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint16_t peer_num, const uint8_t *_Nonnull real_pk, const uint8_t *_Nonnull temp_pk) { uint8_t packet[GROUP_MESSAGE_NEW_PEER_LENGTH]; @@ -1926,7 +1926,7 @@ static bool group_new_peer_send(non_null() const Group_Chats *g_c, uint32_t grou /** @brief send a kill_peer message * return true on success */ -static bool group_kill_peer_send(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint16_t peer_num) +static bool group_kill_peer_send(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint16_t peer_num) { uint8_t packet[GROUP_MESSAGE_KILL_PEER_LENGTH]; @@ -1939,7 +1939,7 @@ static bool group_kill_peer_send(non_null() const Group_Chats *g_c, uint32_t gro /** @brief send a freeze_peer message * return true on success */ -static bool group_freeze_peer_send(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint16_t peer_num) +static bool group_freeze_peer_send(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint16_t peer_num) { uint8_t packet[GROUP_MESSAGE_KILL_PEER_LENGTH]; @@ -1952,7 +1952,7 @@ static bool group_freeze_peer_send(non_null() const Group_Chats *g_c, uint32_t g /** @brief send a name message * return true on success */ -static bool group_name_send(non_null() const Group_Chats *g_c, uint32_t groupnumber, non_null() const uint8_t *nick, uint16_t nick_len) +static bool group_name_send(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, const uint8_t *_Nonnull nick, uint16_t nick_len) { if (nick_len > MAX_NAME_LENGTH) { return false; @@ -2059,7 +2059,7 @@ int group_title_get(const Group_Chats *g_c, uint32_t groupnumber, uint8_t *title return g->title_len; } -static bool get_peer_number(non_null() const Group_c *g, non_null() const uint8_t *real_pk, non_null() uint16_t *peer_number) +static bool get_peer_number(const Group_c *_Nonnull g, const uint8_t *_Nonnull real_pk, uint16_t *_Nonnull peer_number) { const int peer_index = peer_in_group(g, real_pk); @@ -2078,8 +2078,8 @@ static bool get_peer_number(non_null() const Group_c *g, non_null() const uint8_ return false; } -static void handle_friend_invite_packet(non_null() Messenger *m, uint32_t friend_number, non_null() const uint8_t *cookie, uint16_t length, - nullable() void *user_data) +static void handle_friend_invite_packet(Messenger *_Nonnull m, uint32_t friend_number, const uint8_t *_Nonnull cookie, uint16_t length, + void *_Nullable user_data) { Group_Chats *g_c = m->conferences_object; if (length <= 1) { @@ -2204,7 +2204,7 @@ static void handle_friend_invite_packet(non_null() Messenger *m, uint32_t friend * return index on success * return -1 on failure. */ -static int friend_in_connections(non_null() const Group_c *g, int friendcon_id) +static int friend_in_connections(const Group_c *_Nonnull g, int friendcon_id) { for (unsigned int i = 0; i < MAX_GROUP_CONNECTIONS; ++i) { if (g->connections[i].type == GROUPCHAT_CONNECTION_NONE) { @@ -2220,7 +2220,7 @@ static int friend_in_connections(non_null() const Group_c *g, int friendcon_id) } /** return number of connections. */ -static unsigned int count_connected(non_null() const Group_c *g) +static unsigned int count_connected(const Group_c *_Nonnull g) { unsigned int count = 0; @@ -2246,9 +2246,9 @@ static bool send_packet_online(const Friend_Connections *fr_c, int friendcon_id, sizeof(packet), false) != -1; } -static bool ping_groupchat(non_null() const Group_Chats *g_c, uint32_t groupnumber); +static bool ping_groupchat(const Group_Chats *_Nonnull g_c, uint32_t groupnumber); -static int handle_packet_online(non_null() const Group_Chats *g_c, int friendcon_id, non_null() const uint8_t *data, uint16_t length) +static int handle_packet_online(const Group_Chats *_Nonnull g_c, int friendcon_id, const uint8_t *_Nonnull data, uint16_t length) { if (length != ONLINE_PACKET_DATA_SIZE) { return -1; @@ -2307,8 +2307,8 @@ static int handle_packet_online(non_null() const Group_Chats *g_c, int friendcon return 0; } -static int handle_packet_rejoin(non_null() Group_Chats *g_c, int friendcon_id, non_null() const uint8_t *data, uint16_t length, - nullable() void *userdata) +static int handle_packet_rejoin(Group_Chats *_Nonnull g_c, int friendcon_id, const uint8_t *_Nonnull data, uint16_t length, + void *_Nullable userdata) { if (length < 1 + GROUP_ID_LENGTH) { return -1; @@ -2371,7 +2371,7 @@ static bool send_peer_query(const Group_Chats *g_c, int friendcon_id, uint16_t g * @return number of peers sent on success. * @retval 0 on failure. */ -static unsigned int send_peers(non_null() const Group_Chats *g_c, non_null() const Group_c *g, int friendcon_id, uint16_t group_num) +static unsigned int send_peers(const Group_Chats *_Nonnull g_c, const Group_c *_Nonnull g, int friendcon_id, uint16_t group_num) { uint8_t response_packet[MAX_CRYPTO_DATA_SIZE - (1 + sizeof(uint16_t))]; response_packet[0] = PEER_RESPONSE_ID; @@ -2422,8 +2422,8 @@ static unsigned int send_peers(non_null() const Group_Chats *g_c, non_null() con return sent; } -static int handle_send_peers(non_null() Group_Chats *g_c, uint32_t groupnumber, non_null() const uint8_t *data, uint16_t length, - nullable() void *userdata) +static int handle_send_peers(Group_Chats *_Nonnull g_c, uint32_t groupnumber, const uint8_t *_Nonnull data, uint16_t length, + void *_Nullable userdata) { if (length == 0) { return -1; @@ -2479,8 +2479,8 @@ static int handle_send_peers(non_null() Group_Chats *g_c, uint32_t groupnumber, return 0; } -static void handle_direct_packet(non_null() Group_Chats *g_c, uint32_t groupnumber, non_null() const uint8_t *data, uint16_t length, - uint32_t connection_index, nullable() void *userdata) +static void handle_direct_packet(Group_Chats *_Nonnull g_c, uint32_t groupnumber, const uint8_t *_Nonnull data, uint16_t length, + uint32_t connection_index, void *_Nullable userdata) { if (length == 0) { return; @@ -2528,7 +2528,7 @@ static void handle_direct_packet(non_null() Group_Chats *g_c, uint32_t groupnumb * * @return number of messages sent. */ -static unsigned int send_message_all_connections(non_null() const Group_Chats *g_c, non_null() const Group_c *g, non_null() const uint8_t *data, uint16_t length, int receiver) +static unsigned int send_message_all_connections(const Group_Chats *_Nonnull g_c, const Group_c *_Nonnull g, const uint8_t *_Nonnull data, uint16_t length, int receiver) { uint16_t sent = 0; @@ -2556,7 +2556,7 @@ static unsigned int send_message_all_connections(non_null() const Group_Chats *g * * @return number of messages sent. */ -static unsigned int send_lossy_all_connections(non_null() const Group_Chats *g_c, non_null() const Group_c *g, non_null() const uint8_t *data, uint16_t length, int receiver) +static unsigned int send_lossy_all_connections(const Group_Chats *_Nonnull g_c, const Group_c *_Nonnull g, const uint8_t *_Nonnull data, uint16_t length, int receiver) { unsigned int sent = 0; unsigned int num_connected_closest = 0; @@ -2732,7 +2732,7 @@ int send_group_lossy_packet(const Group_Chats *g_c, uint32_t groupnumber, const return 0; } -static Message_Info *find_message_slot_or_reject(uint32_t message_number, uint8_t message_id, non_null() Group_Peer *peer) +static Message_Info *find_message_slot_or_reject(uint32_t message_number, uint8_t message_id, Group_Peer *_Nonnull peer) { const bool ignore_older = message_id == GROUP_MESSAGE_NAME_ID || message_id == GROUP_MESSAGE_TITLE_ID; @@ -2760,7 +2760,7 @@ static Message_Info *find_message_slot_or_reject(uint32_t message_number, uint8_ * @retval true if message should be processed. * @retval false otherwise. */ -static bool check_message_info(uint32_t message_number, uint8_t message_id, non_null() Group_Peer *peer) +static bool check_message_info(uint32_t message_number, uint8_t message_id, Group_Peer *_Nonnull peer) { Message_Info *const i = find_message_slot_or_reject(message_number, message_id, peer); @@ -2784,8 +2784,8 @@ static bool check_message_info(uint32_t message_number, uint8_t message_id, non_ return true; } -static void handle_message_packet_group(non_null() Group_Chats *g_c, uint32_t groupnumber, non_null() const uint8_t *data, uint16_t length, - uint32_t connection_index, nullable() void *userdata) +static void handle_message_packet_group(Group_Chats *_Nonnull g_c, uint32_t groupnumber, const uint8_t *_Nonnull data, uint16_t length, + uint32_t connection_index, void *_Nullable userdata) { if (length < sizeof(uint16_t) + sizeof(uint32_t) + 1) { return; @@ -3015,7 +3015,7 @@ static int g_handle_packet(void *object, int friendcon_id, const uint8_t *data, * * TODO(irungentoo): test this */ -static int lossy_packet_not_received(non_null() const Group_c *g, int peer_index, uint16_t message_number) +static int lossy_packet_not_received(const Group_c *_Nonnull g, int peer_index, uint16_t message_number) { if (peer_index == -1) { return -1; @@ -3236,7 +3236,7 @@ static bool ping_groupchat(const Group_Chats *g_c, uint32_t groupnumber) /** Seconds of inactivity after which to freeze a peer */ #define FREEZE_TIMEOUT (GROUP_PING_INTERVAL * 3) -static bool groupchat_freeze_timedout(non_null() Group_Chats *g_c, uint32_t groupnumber, nullable() void *userdata) +static bool groupchat_freeze_timedout(Group_Chats *_Nonnull g_c, uint32_t groupnumber, void *_Nullable userdata) { Group_c *g = get_group_c(g_c, groupnumber); if (g == nullptr) { @@ -3261,7 +3261,7 @@ static bool groupchat_freeze_timedout(non_null() Group_Chats *g_c, uint32_t grou } /** Push non-empty slots to start. */ -static void squash_connections(non_null() Group_c *g) +static void squash_connections(Group_c *_Nonnull g) { uint16_t num_connected = 0; @@ -3279,7 +3279,7 @@ static void squash_connections(non_null() Group_c *g) #define MIN_EMPTY_CONNECTIONS (1 + MAX_GROUP_CONNECTIONS / 10) -static uint16_t empty_connection_count(non_null() const Group_c *g) +static uint16_t empty_connection_count(const Group_c *_Nonnull g) { uint16_t to_clear = MIN_EMPTY_CONNECTIONS; @@ -3303,7 +3303,7 @@ static uint16_t empty_connection_count(non_null() const Group_c *g) * This invalidates connections array indices (which is * why we do this periodically rather than on adding a connection). */ -static void clean_connections(non_null() Group_Chats *g_c, non_null() Group_c *g) +static void clean_connections(Group_Chats *_Nonnull g_c, Group_c *_Nonnull g) { for (uint16_t to_clear = empty_connection_count(g); to_clear > 0; --to_clear) { // Remove a connection. Prefer non-closest connections, and given @@ -3354,12 +3354,12 @@ void send_name_all_groups(const Group_Chats *g_c) #define SAVED_PEER_SIZE_CONSTANT (2 * CRYPTO_PUBLIC_KEY_SIZE + sizeof(uint16_t) + sizeof(uint64_t) + 1) -static uint32_t saved_peer_size(non_null() const Group_Peer *peer) +static uint32_t saved_peer_size(const Group_Peer *_Nonnull peer) { return SAVED_PEER_SIZE_CONSTANT + peer->nick_len; } -static uint8_t *save_peer(non_null() const Group_Peer *peer, non_null() uint8_t *data) +static uint8_t *save_peer(const Group_Peer *_Nonnull peer, uint8_t *_Nonnull data) { memcpy(data, peer->real_pk, CRYPTO_PUBLIC_KEY_SIZE); data += CRYPTO_PUBLIC_KEY_SIZE; @@ -3386,7 +3386,7 @@ static uint8_t *save_peer(non_null() const Group_Peer *peer, non_null() uint8_t #define SAVED_CONF_SIZE_CONSTANT (1 + GROUP_ID_LENGTH + sizeof(uint32_t) \ + sizeof(uint16_t) + sizeof(uint16_t) + sizeof(uint32_t) + 1) -static uint32_t saved_conf_size(non_null() const Group_c *g) +static uint32_t saved_conf_size(const Group_c *_Nonnull g) { uint32_t len = SAVED_CONF_SIZE_CONSTANT + g->title_len; @@ -3410,7 +3410,7 @@ static uint32_t saved_conf_size(non_null() const Group_c *g) #define SAVE_OFFSET_MESSAGE_NUMBER (1 << 16) #define SAVE_OFFSET_LOSSY_MESSAGE_NUMBER (1 << 13) -static uint8_t *save_conf(non_null() const Group_c *g, non_null() uint8_t *data) +static uint8_t *save_conf(const Group_c *_Nonnull g, uint8_t *_Nonnull data) { *data = g->type; ++data; @@ -3454,7 +3454,7 @@ static uint8_t *save_conf(non_null() const Group_c *g, non_null() uint8_t *data) return data; } -static uint32_t conferences_section_size(non_null() const Group_Chats *g_c) +static uint32_t conferences_section_size(const Group_Chats *_Nonnull g_c) { uint32_t len = 0; @@ -3502,7 +3502,7 @@ uint8_t *conferences_save(const Group_Chats *g_c, uint8_t *data) * @param length Length of data * @return 0 on error, number of consumed bytes otherwise */ -static uint32_t load_group(non_null() Group_c *g, non_null() const Group_Chats *g_c, non_null() const uint8_t *data, uint32_t length) +static uint32_t load_group(Group_c *_Nonnull g, const Group_Chats *_Nonnull g_c, const uint8_t *_Nonnull data, uint32_t length) { const uint8_t *init_data = data; @@ -3609,7 +3609,7 @@ static uint32_t load_group(non_null() Group_c *g, non_null() const Group_Chats * return (uint32_t)(data - init_data); } -static State_Load_Status load_conferences_helper(non_null() Group_Chats *g_c, non_null() const uint8_t *data, uint32_t length) +static State_Load_Status load_conferences_helper(Group_Chats *_Nonnull g_c, const uint8_t *_Nonnull data, uint32_t length) { const uint8_t *init_data = data; @@ -3659,7 +3659,7 @@ static State_Load_Status load_conferences_helper(non_null() Group_Chats *g_c, no return STATE_LOAD_STATUS_CONTINUE; } -static State_Load_Status load_conferences(non_null() Group_Chats *g_c, non_null() const uint8_t *data, uint32_t length) +static State_Load_Status load_conferences(Group_Chats *_Nonnull g_c, const uint8_t *_Nonnull data, uint32_t length) { const State_Load_Status res = load_conferences_helper(g_c, data, length); diff --git a/toxcore/group.h b/toxcore/group.h index 08f5f25e0..a9ef03293 100644 --- a/toxcore/group.h +++ b/toxcore/group.h @@ -24,72 +24,72 @@ typedef enum Groupchat_Type { GROUPCHAT_TYPE_AV, } Groupchat_Type; -typedef void peer_on_join_cb(void *object, uint32_t conference_number, uint32_t peer_number); -typedef void peer_on_leave_cb(void *object, uint32_t conference_number, void *peer_object); -typedef void group_on_delete_cb(void *object, uint32_t conference_number); +typedef void peer_on_join_cb(void *_Nullable object, uint32_t conference_number, uint32_t peer_number); +typedef void peer_on_leave_cb(void *_Nullable object, uint32_t conference_number, void *_Nullable peer_object); +typedef void group_on_delete_cb(void *_Nullable object, uint32_t conference_number); /** @brief Callback for group invites. * * data of length is what needs to be passed to `join_groupchat()`. */ -typedef void g_conference_invite_cb(Messenger *m, uint32_t friend_number, int type, const uint8_t *cookie, - size_t length, void *user_data); +typedef void g_conference_invite_cb(Messenger *_Nonnull m, uint32_t friend_number, int type, const uint8_t *_Nonnull cookie, + size_t length, void *_Nullable user_data); /** Callback for group connection. */ -typedef void g_conference_connected_cb(Messenger *m, uint32_t conference_number, void *user_data); +typedef void g_conference_connected_cb(Messenger *_Nonnull m, uint32_t conference_number, void *_Nullable user_data); /** Callback for group messages. */ -typedef void g_conference_message_cb(Messenger *m, uint32_t conference_number, uint32_t peer_number, int type, - const uint8_t *message, size_t length, void *user_data); +typedef void g_conference_message_cb(Messenger *_Nonnull m, uint32_t conference_number, uint32_t peer_number, int type, + const uint8_t *_Nonnull message, size_t length, void *_Nullable user_data); /** Callback for peer nickname changes. */ -typedef void peer_name_cb(Messenger *m, uint32_t conference_number, uint32_t peer_number, const uint8_t *name, - size_t length, void *user_data); +typedef void peer_name_cb(Messenger *_Nonnull m, uint32_t conference_number, uint32_t peer_number, const uint8_t *_Nonnull name, + size_t length, void *_Nullable user_data); /** Set callback function for peer list changes. */ -typedef void peer_list_changed_cb(Messenger *m, uint32_t conference_number, void *user_data); +typedef void peer_list_changed_cb(Messenger *_Nonnull m, uint32_t conference_number, void *_Nullable user_data); /** @brief Callback for title changes. * * If peer_number == -1, then author is unknown (e.g. initial joining the group). */ -typedef void title_cb(Messenger *m, uint32_t conference_number, uint32_t peer_number, const uint8_t *title, - size_t length, void *user_data); +typedef void title_cb(Messenger *_Nonnull m, uint32_t conference_number, uint32_t peer_number, const uint8_t *_Nonnull title, + size_t length, void *_Nullable user_data); /** @brief Callback for lossy packets. * * NOTE: Handler must return 0 if packet is to be relayed, -1 if the packet should not be relayed. */ -typedef int lossy_packet_cb(void *object, uint32_t conference_number, uint32_t peer_number, void *peer_object, - const uint8_t *packet, uint16_t length); +typedef int lossy_packet_cb(void *_Nullable object, uint32_t conference_number, uint32_t peer_number, void *_Nullable peer_object, + const uint8_t *_Nonnull packet, uint16_t length); typedef struct Group_Chats Group_Chats; -const Mono_Time *g_mono_time(non_null() const Group_Chats *g_c); +const Mono_Time *_Nonnull g_mono_time(const Group_Chats *_Nonnull g_c); /** Set the callback for group invites. */ -void g_callback_group_invite(non_null() Group_Chats *g_c, non_null() g_conference_invite_cb *function); +void g_callback_group_invite(Group_Chats *_Nonnull g_c, g_conference_invite_cb *_Nonnull function); /** Set the callback for group connection. */ -void g_callback_group_connected(non_null() Group_Chats *g_c, non_null() g_conference_connected_cb *function); +void g_callback_group_connected(Group_Chats *_Nonnull g_c, g_conference_connected_cb *_Nonnull function); /** Set the callback for group messages. */ -void g_callback_group_message(non_null() Group_Chats *g_c, non_null() g_conference_message_cb *function); +void g_callback_group_message(Group_Chats *_Nonnull g_c, g_conference_message_cb *_Nonnull function); /** Set callback function for title changes. */ -void g_callback_group_title(non_null() Group_Chats *g_c, non_null() title_cb *function); +void g_callback_group_title(Group_Chats *_Nonnull g_c, title_cb *_Nonnull function); /** @brief Set callback function for peer nickname changes. * * It gets called every time a peer changes their nickname. */ -void g_callback_peer_name(non_null() Group_Chats *g_c, non_null() peer_name_cb *function); +void g_callback_peer_name(Group_Chats *_Nonnull g_c, peer_name_cb *_Nonnull function); /** @brief Set callback function for peer list changes. * * It gets called every time the name list changes(new peer, deleted peer) */ -void g_callback_peer_list_changed(non_null() Group_Chats *g_c, non_null() peer_list_changed_cb *function); +void g_callback_peer_list_changed(Group_Chats *_Nonnull g_c, peer_list_changed_cb *_Nonnull function); /** @brief Creates a new groupchat and puts it in the chats array. * @@ -99,7 +99,7 @@ void g_callback_peer_list_changed(non_null() Group_Chats *g_c, non_null() peer_l * @return group number on success. * @retval -1 on failure. */ -int add_groupchat(non_null() Group_Chats *g_c, non_null() const Random *rng, uint8_t type); +int add_groupchat(Group_Chats *_Nonnull g_c, const Random *_Nonnull rng, uint8_t type); /** @brief Delete a groupchat from the chats array, informing the group first as * appropriate. @@ -107,7 +107,7 @@ int add_groupchat(non_null() Group_Chats *g_c, non_null() const Random *rng, uin * @retval true on success. * @retval false if groupnumber is invalid. */ -bool del_groupchat(non_null() Group_Chats *g_c, uint32_t groupnumber, bool leave_permanently); +bool del_groupchat(Group_Chats *_Nonnull g_c, uint32_t groupnumber, bool leave_permanently); /** * @brief Copy the public key of (frozen, if frozen is true) peernumber who is in @@ -119,7 +119,7 @@ bool del_groupchat(non_null() Group_Chats *g_c, uint32_t groupnumber, bool leave * @retval -1 if groupnumber is invalid. * @retval -2 if peernumber is invalid. */ -int group_peer_pubkey(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint32_t peernumber, non_null() uint8_t *pk, bool frozen); +int group_peer_pubkey(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint32_t peernumber, uint8_t *_Nonnull pk, bool frozen); /** * @brief Return the size of (frozen, if frozen is true) peernumber's name. @@ -127,7 +127,7 @@ int group_peer_pubkey(non_null() const Group_Chats *g_c, uint32_t groupnumber, u * @retval -1 if groupnumber is invalid. * @retval -2 if peernumber is invalid. */ -int group_peername_size(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint32_t peernumber, bool frozen); +int group_peername_size(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint32_t peernumber, bool frozen); /** * @brief Copy the name of (frozen, if frozen is true) peernumber who is in @@ -139,7 +139,7 @@ int group_peername_size(non_null() const Group_Chats *g_c, uint32_t groupnumber, * @retval -1 if groupnumber is invalid. * @retval -2 if peernumber is invalid. */ -int group_peername(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint32_t peernumber, non_null() uint8_t *name, bool frozen); +int group_peername(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint32_t peernumber, uint8_t *_Nonnull name, bool frozen); /** * @brief Copy last active timestamp of frozen peernumber who is in groupnumber to @@ -149,14 +149,14 @@ int group_peername(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint * @retval -1 if groupnumber is invalid. * @retval -2 if peernumber is invalid. */ -int group_frozen_last_active(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint32_t peernumber, non_null() uint64_t *last_active); +int group_frozen_last_active(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint32_t peernumber, uint64_t *_Nonnull last_active); /** @brief Set maximum number of frozen peers. * * @retval 0 on success. * @retval -1 if groupnumber is invalid. */ -int group_set_max_frozen(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint32_t maxfrozen); +int group_set_max_frozen(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint32_t maxfrozen); /** @brief invite friendnumber to groupnumber. * @@ -165,7 +165,7 @@ int group_set_max_frozen(non_null() const Group_Chats *g_c, uint32_t groupnumber * @retval -2 if invite packet failed to send. * @retval -3 if we are not connected to the group chat. */ -int invite_friend(non_null() const Group_Chats *g_c, uint32_t friendnumber, uint32_t groupnumber); +int invite_friend(const Group_Chats *_Nonnull g_c, uint32_t friendnumber, uint32_t groupnumber); /** @brief Join a group (we need to have been invited first). * @@ -180,19 +180,19 @@ int invite_friend(non_null() const Group_Chats *g_c, uint32_t friendnumber, uint * @retval -5 if group instance failed to initialize. * @retval -6 if join packet fails to send. */ -int join_groupchat(non_null() Group_Chats *g_c, uint32_t friendnumber, uint8_t expected_type, non_null() const uint8_t *data, uint16_t length); +int join_groupchat(Group_Chats *_Nonnull g_c, uint32_t friendnumber, uint8_t expected_type, const uint8_t *_Nonnull data, uint16_t length); /** @brief send a group message * @retval 0 on success * @see send_message_group for error codes. */ -int group_message_send(non_null() const Group_Chats *g_c, uint32_t groupnumber, non_null() const uint8_t *message, uint16_t length); +int group_message_send(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, const uint8_t *_Nonnull message, uint16_t length); /** @brief send a group action * @retval 0 on success * @see send_message_group for error codes. */ -int group_action_send(non_null() const Group_Chats *g_c, uint32_t groupnumber, non_null() const uint8_t *action, uint16_t length); +int group_action_send(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, const uint8_t *_Nonnull action, uint16_t length); /** @brief set the group's title, limited to MAX_NAME_LENGTH. * @retval 0 on success @@ -200,13 +200,13 @@ int group_action_send(non_null() const Group_Chats *g_c, uint32_t groupnumber, n * @retval -2 if title is too long or empty. * @retval -3 if packet fails to send. */ -int group_title_send(non_null() const Group_Chats *g_c, uint32_t groupnumber, non_null() const uint8_t *title, uint8_t title_len); +int group_title_send(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, const uint8_t *_Nonnull title, uint8_t title_len); /** @brief return the group's title size. * @retval -1 of groupnumber is invalid. * @retval -2 if title is too long or empty. */ -int group_title_get_size(non_null() const Group_Chats *g_c, uint32_t groupnumber); +int group_title_get_size(const Group_Chats *_Nonnull g_c, uint32_t groupnumber); /** @brief Get group title from groupnumber and put it in title. * @@ -216,13 +216,13 @@ int group_title_get_size(non_null() const Group_Chats *g_c, uint32_t groupnumber * @retval -1 if groupnumber is invalid. * @retval -2 if title is too long or empty. */ -int group_title_get(non_null() const Group_Chats *g_c, uint32_t groupnumber, non_null() uint8_t *title); +int group_title_get(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint8_t *_Nonnull title); /** * @return the number of (frozen, if frozen is true) peers in the group chat on success. * @retval -1 if groupnumber is invalid. */ -int group_number_peers(non_null() const Group_Chats *g_c, uint32_t groupnumber, bool frozen); +int group_number_peers(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, bool frozen); /** * @retval 1 if the peernumber corresponds to ours. @@ -231,17 +231,17 @@ int group_number_peers(non_null() const Group_Chats *g_c, uint32_t groupnumber, * @retval -2 if peernumber is invalid. * @retval -3 if we are not connected to the group chat. */ -int group_peernumber_is_ours(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint32_t peernumber); +int group_peernumber_is_ours(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint32_t peernumber); /** Set handlers for custom lossy packets. */ -void group_lossy_packet_registerhandler(non_null() Group_Chats *g_c, uint8_t byte, non_null() lossy_packet_cb *function); +void group_lossy_packet_registerhandler(Group_Chats *_Nonnull g_c, uint8_t byte, lossy_packet_cb *_Nonnull function); /** @brief High level function to send custom lossy packets. * * @retval -1 on failure. * @retval 0 on success. */ -int send_group_lossy_packet(non_null() const Group_Chats *g_c, uint32_t groupnumber, non_null() const uint8_t *data, uint16_t length); +int send_group_lossy_packet(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, const uint8_t *_Nonnull data, uint16_t length); /** * @brief Return the number of chats in the instance m. @@ -249,7 +249,7 @@ int send_group_lossy_packet(non_null() const Group_Chats *g_c, uint32_t groupnum * You should use this to determine how much memory to allocate * for copy_chatlist. */ -uint32_t count_chatlist(non_null() const Group_Chats *g_c); +uint32_t count_chatlist(const Group_Chats *_Nonnull g_c); /** @brief Copy a list of valid chat IDs into the array out_list. * @@ -258,76 +258,76 @@ uint32_t count_chatlist(non_null() const Group_Chats *g_c); * If the array was too small, the contents * of out_list will be truncated to list_size. */ -uint32_t copy_chatlist(non_null() const Group_Chats *g_c, non_null() uint32_t *out_list, uint32_t list_size); +uint32_t copy_chatlist(const Group_Chats *_Nonnull g_c, uint32_t *_Nonnull out_list, uint32_t list_size); /** @brief return the type of groupchat (GROUPCHAT_TYPE_) that groupnumber is. * * @retval -1 on failure. * @return type on success. */ -int group_get_type(non_null() const Group_Chats *g_c, uint32_t groupnumber); +int group_get_type(const Group_Chats *_Nonnull g_c, uint32_t groupnumber); /** @brief Copies the unique id of `group_chat[groupnumber]` into `id`. * * @retval false on failure. * @retval true on success. */ -bool conference_get_id(non_null() const Group_Chats *g_c, uint32_t groupnumber, non_null() uint8_t *id); +bool conference_get_id(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint8_t *_Nonnull id); -int32_t conference_by_id(non_null() const Group_Chats *g_c, non_null() const uint8_t *id); +int32_t conference_by_id(const Group_Chats *_Nonnull g_c, const uint8_t *_Nonnull id); /** Send current name (set in messenger) to all online groups. */ -void send_name_all_groups(non_null() const Group_Chats *g_c); +void send_name_all_groups(const Group_Chats *_Nonnull g_c); /** @brief Set the object that is tied to the group chat. * * @retval 0 on success. * @retval -1 on failure */ -int group_set_object(non_null() const Group_Chats *g_c, uint32_t groupnumber, nullable() void *object); +int group_set_object(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, void *_Nullable object); /** @brief Set the object that is tied to the group peer. * * @retval 0 on success. * @retval -1 on failure */ -int group_peer_set_object(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint32_t peernumber, nullable() void *object); +int group_peer_set_object(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint32_t peernumber, void *_Nullable object); /** @brief Return the object tied to the group chat previously set by group_set_object. * * @retval NULL on failure. * @return object on success. */ -void *group_get_object(non_null() const Group_Chats *g_c, uint32_t groupnumber); +void *_Nullable group_get_object(const Group_Chats *_Nonnull g_c, uint32_t groupnumber); /** @brief Return the object tied to the group chat peer previously set by group_peer_set_object. * * @retval NULL on failure. * @return object on success. */ -void *group_peer_get_object(non_null() const Group_Chats *g_c, uint32_t groupnumber, uint32_t peernumber); +void *_Nullable group_peer_get_object(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, uint32_t peernumber); /** @brief Set a function to be called when a new peer joins a group chat. * * @retval 0 on success. * @retval -1 on failure. */ -int callback_groupchat_peer_new(non_null() const Group_Chats *g_c, uint32_t groupnumber, nullable() peer_on_join_cb *function); +int callback_groupchat_peer_new(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, peer_on_join_cb *_Nullable function); /** @brief Set a function to be called when a peer leaves a group chat. * * @retval 0 on success. * @retval -1 on failure. */ -int callback_groupchat_peer_delete(non_null() const Group_Chats *g_c, uint32_t groupnumber, nullable() peer_on_leave_cb *function); +int callback_groupchat_peer_delete(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, peer_on_leave_cb *_Nullable function); /** @brief Set a function to be called when the group chat is deleted. * * @retval 0 on success. * @retval -1 on failure. */ -int callback_groupchat_delete(non_null() const Group_Chats *g_c, uint32_t groupnumber, nullable() group_on_delete_cb *function); +int callback_groupchat_delete(const Group_Chats *_Nonnull g_c, uint32_t groupnumber, group_on_delete_cb *_Nullable function); /** Return size of the conferences data (for saving). */ -uint32_t conferences_size(non_null() const Group_Chats *g_c); +uint32_t conferences_size(const Group_Chats *_Nonnull g_c); /** Save the conferences in data (must be allocated memory of size at least `conferences_size()`). */ -uint8_t *conferences_save(non_null() const Group_Chats *g_c, non_null() uint8_t *data); +uint8_t *_Nonnull conferences_save(const Group_Chats *_Nonnull g_c, uint8_t *_Nonnull data); /** * Load a state section. @@ -338,13 +338,13 @@ uint8_t *conferences_save(non_null() const Group_Chats *g_c, non_null() uint8_t * @param status Result of loading section is stored here if the section is handled. * @return true iff section handled. */ -bool conferences_load_state_section(non_null() Group_Chats *g_c, non_null() const uint8_t *data, uint32_t length, uint16_t type, non_null() State_Load_Status *status); +bool conferences_load_state_section(Group_Chats *_Nonnull g_c, const uint8_t *_Nonnull data, uint32_t length, uint16_t type, State_Load_Status *_Nonnull status); /** Create new groupchat instance. */ -Group_Chats *new_groupchats(non_null() const Mono_Time *mono_time, non_null() const Memory *mem, non_null() Messenger *m); +Group_Chats *_Nullable new_groupchats(const Mono_Time *_Nonnull mono_time, const Memory *_Nonnull mem, Messenger *_Nonnull m); /** main groupchats loop. */ -void do_groupchats(non_null() Group_Chats *g_c, nullable() void *userdata); +void do_groupchats(Group_Chats *_Nonnull g_c, void *_Nullable userdata); /** Free everything related with group chats. */ -void kill_groupchats(nullable() Group_Chats *g_c); +void kill_groupchats(Group_Chats *_Nullable g_c); #endif /* C_TOXCORE_TOXCORE_GROUP_H */ diff --git a/toxcore/group_announce.c b/toxcore/group_announce.c index 7fd085072..a5a55bc0b 100644 --- a/toxcore/group_announce.c +++ b/toxcore/group_announce.c @@ -19,7 +19,7 @@ /** * Removes `announces` from `gc_announces_list`. */ -static void remove_announces(non_null() GC_Announces_List *gc_announces_list, non_null() GC_Announces *announces) +static void remove_announces(GC_Announces_List *_Nonnull gc_announces_list, GC_Announces *_Nonnull announces) { if (announces == nullptr || gc_announces_list == nullptr) { return; @@ -42,7 +42,7 @@ static void remove_announces(non_null() GC_Announces_List *gc_announces_list, no * Returns the announce designated by `chat_id`. * Returns null if no announce is found. */ -static GC_Announces *get_announces_by_chat_id(non_null() const GC_Announces_List *gc_announces_list, non_null() const uint8_t *chat_id) +static GC_Announces *_Nullable get_announces_by_chat_id(const GC_Announces_List *_Nonnull gc_announces_list, const uint8_t *_Nonnull chat_id) { GC_Announces *announces = gc_announces_list->root_announces; @@ -165,7 +165,7 @@ int gca_pack_announce(const Logger *log, uint8_t *data, uint16_t length, const G * Returns the size of the unpacked data on success. * Returns -1 on failure. */ -static int gca_unpack_announce(non_null() const Logger *log, non_null() const uint8_t *data, uint16_t length, non_null() GC_Announce *announce) +static int gca_unpack_announce(const Logger *_Nonnull log, const uint8_t *_Nonnull data, uint16_t length, GC_Announce *_Nonnull announce) { if (length < ENC_PUBLIC_KEY_SIZE + 2) { LOGGER_ERROR(log, "Invalid announce length: %u", length); @@ -338,7 +338,7 @@ int gca_unpack_announces_list(const Logger *log, const uint8_t *data, uint16_t l return announces_count; } -static GC_Announces *gca_new_announces(non_null() const Memory *mem, non_null() GC_Announces_List *gc_announces_list, non_null() const GC_Public_Announce *public_announce) +static GC_Announces *_Nullable gca_new_announces(const Memory *_Nonnull mem, GC_Announces_List *_Nonnull gc_announces_list, const GC_Public_Announce *_Nonnull public_announce) { GC_Announces *announces = (GC_Announces *)mem_alloc(mem, sizeof(GC_Announces)); diff --git a/toxcore/group_announce.h b/toxcore/group_announce.h index 238172f88..29238bc6e 100644 --- a/toxcore/group_announce.h +++ b/toxcore/group_announce.h @@ -74,15 +74,15 @@ struct GC_Announces { GC_Peer_Announce peer_announces[GCA_MAX_SAVED_ANNOUNCES_PER_GC]; - GC_Announces *next_announce; - GC_Announces *prev_announce; + GC_Announces *_Nullable next_announce; + GC_Announces *_Nullable prev_announce; }; /* A list of all announces. */ struct GC_Announces_List { - const Memory *mem; + const Memory *_Nonnull mem; - GC_Announces *root_announces; + GC_Announces *_Nullable root_announces; uint64_t last_timeout_check; }; @@ -90,10 +90,10 @@ struct GC_Announces_List { * * The caller is responsible for freeing the memory with `kill_gca`. */ -GC_Announces_List *new_gca_list(non_null() const Memory *mem); +GC_Announces_List *_Nullable new_gca_list(const Memory *_Nonnull mem); /** @brief Frees all dynamically allocated memory associated with `announces_list`. */ -void kill_gca(nullable() GC_Announces_List *announces_list); +void kill_gca(GC_Announces_List *_Nullable announces_list); /** @brief Iterates through the announces list and removes announces that are considered stale. * * @param gc_announces_list The list of announces to iterate. @@ -101,14 +101,14 @@ void kill_gca(nullable() GC_Announces_List *announces_list); * This function should be called from the main loop, and will iterate the list a * maxmimum of once per second. */ -void do_gca(non_null() const Mono_Time *mono_time, non_null() GC_Announces_List *gc_announces_list); +void do_gca(const Mono_Time *_Nonnull mono_time, GC_Announces_List *_Nonnull gc_announces_list); /** @brief Frees all dynamically allocated memory associated with an announces list entry. * * @param gc_announces_list The announces list we want to search through. * @param chat_id The chat ID that designates the entry we want to remove. */ -void cleanup_gca(non_null() GC_Announces_List *gc_announces_list, non_null() const uint8_t *chat_id); +void cleanup_gca(GC_Announces_List *_Nonnull gc_announces_list, const uint8_t *_Nonnull chat_id); /** @brief Puts a set of announces from the announces list in supplied list. * @@ -121,8 +121,8 @@ void cleanup_gca(non_null() GC_Announces_List *gc_announces_list, non_null() con * @return the number of added nodes on success. * @retval -1 on failure. */ -int gca_get_announces(non_null() const GC_Announces_List *gc_announces_list, non_null() GC_Announce *gc_announces, uint8_t max_nodes, non_null() const uint8_t *chat_id, - non_null() const uint8_t *except_public_key); +int gca_get_announces(const GC_Announces_List *_Nonnull gc_announces_list, GC_Announce *_Nonnull gc_announces, uint8_t max_nodes, const uint8_t *_Nonnull chat_id, + const uint8_t *_Nonnull except_public_key); /** @brief Adds a public_announce to list of announces. * @@ -132,8 +132,8 @@ int gca_get_announces(non_null() const GC_Announces_List *gc_announces_list, non * @return the peer announce on success. * @retval null on failure. */ -GC_Peer_Announce *gca_add_announce(non_null() const Memory *mem, non_null() const Mono_Time *mono_time, non_null() GC_Announces_List *gc_announces_list, - non_null() const GC_Public_Announce *public_announce); +GC_Peer_Announce *_Nullable gca_add_announce(const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, GC_Announces_List *_Nonnull gc_announces_list, + const GC_Public_Announce *_Nonnull public_announce); /** @brief Packs an announce into a data buffer. * @@ -144,7 +144,7 @@ GC_Peer_Announce *gca_add_announce(non_null() const Memory *mem, non_null() cons * @return the size of the packed data on success. * @retval -1 on failure. */ -int gca_pack_announce(non_null() const Logger *log, non_null() uint8_t *data, uint16_t length, non_null() const GC_Announce *announce); +int gca_pack_announce(const Logger *_Nonnull log, uint8_t *_Nonnull data, uint16_t length, const GC_Announce *_Nonnull announce); /** @brief Returns the number of bytes needed for a buff in which to pack `count` announces. */ uint16_t gca_pack_announces_list_size(uint16_t count); @@ -161,8 +161,8 @@ uint16_t gca_pack_announces_list_size(uint16_t count); * @return the number of packed announces on success. * @retval -1 on failure. */ -int gca_pack_announces_list(non_null() const Logger *log, non_null() uint8_t *data, uint16_t length, non_null() const GC_Announce *announces, - uint8_t announces_count, nullable() size_t *processed); +int gca_pack_announces_list(const Logger *_Nonnull log, uint8_t *_Nonnull data, uint16_t length, const GC_Announce *_Nonnull announces, + uint8_t announces_count, size_t *_Nullable processed); /** @brief Unpacks packed announces from a data buffer into a supplied list. * * @param data The data buffer to unpack from. @@ -173,7 +173,7 @@ int gca_pack_announces_list(non_null() const Logger *log, non_null() uint8_t *da * @return the number of unpacked announces on success. * @retval -1 on failure. */ -int gca_unpack_announces_list(non_null() const Logger *log, non_null() const uint8_t *data, uint16_t length, non_null() GC_Announce *announces, uint8_t max_count); +int gca_unpack_announces_list(const Logger *_Nonnull log, const uint8_t *_Nonnull data, uint16_t length, GC_Announce *_Nonnull announces, uint8_t max_count); /** @brief Packs a public announce into a data buffer. * @@ -184,7 +184,7 @@ int gca_unpack_announces_list(non_null() const Logger *log, non_null() const uin * @return the size of the packed data on success. * @retval -1 on failure. */ -int gca_pack_public_announce(non_null() const Logger *log, non_null() uint8_t *data, uint16_t length, non_null() const GC_Public_Announce *public_announce); +int gca_pack_public_announce(const Logger *_Nonnull log, uint8_t *_Nonnull data, uint16_t length, const GC_Public_Announce *_Nonnull public_announce); /** @brief Unpacks a public announce from a data buffer into a supplied public announce. * @@ -195,13 +195,13 @@ int gca_pack_public_announce(non_null() const Logger *log, non_null() uint8_t *d * @return the size of the unpacked data on success. * @retval -1 on failure. */ -int gca_unpack_public_announce(non_null() const Logger *log, non_null() const uint8_t *data, uint16_t length, non_null() GC_Public_Announce *public_announce); +int gca_unpack_public_announce(const Logger *_Nonnull log, const uint8_t *_Nonnull data, uint16_t length, GC_Public_Announce *_Nonnull public_announce); /** @brief Returns true if the announce is valid. * * An announce is considered valid if there is at least one TCP relay, or the ip_port is set. */ -bool gca_is_valid_announce(non_null() const GC_Announce *announce); +bool gca_is_valid_announce(const GC_Announce *_Nonnull announce); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/group_announce_test.cc b/toxcore/group_announce_test.cc index 1b37fd334..d78fccfd3 100644 --- a/toxcore/group_announce_test.cc +++ b/toxcore/group_announce_test.cc @@ -55,7 +55,7 @@ TEST_F(Announces, CanBeCreatedAndDeleted) GC_Public_Announce ann{}; ann.chat_public_key[0] = 0x88; ASSERT_NE(gca_add_announce(mem_, mono_time_, gca_, &ann), nullptr); -#ifndef _DEBUG +#ifndef __clang__ ASSERT_EQ(gca_add_announce(mem_, mono_time_, gca_, nullptr), nullptr); ASSERT_EQ(gca_add_announce(mem_, mono_time_, nullptr, &ann), nullptr); #endif @@ -110,7 +110,7 @@ TEST_F(Announces, AnnouncesGetAndCleanup) cleanup_gca(gca_, ann2.chat_public_key); ASSERT_EQ(gca_get_announces(gca_, &announces, 1, ann2.chat_public_key, empty_pk), 0); -#ifndef _DEBUG +#ifndef __clang__ ASSERT_EQ(gca_get_announces(gca_, nullptr, 1, ann2.chat_public_key, empty_pk), -1); #endif } @@ -172,7 +172,7 @@ TEST_F(AnnouncesPack, PublicAnnounceCanBePackedAndUnpacked) TEST_F(AnnouncesPack, UnpackEmptyPublicAnnounce) { -#ifndef _DEBUG +#ifndef __clang__ GC_Public_Announce ann{}; std::vector packed(GCA_PUBLIC_ANNOUNCE_MAX_SIZE); @@ -183,7 +183,7 @@ TEST_F(AnnouncesPack, UnpackEmptyPublicAnnounce) TEST_F(AnnouncesPack, PackEmptyPublicAnnounce) { -#ifndef _DEBUG +#ifndef __clang__ GC_Public_Announce ann{}; std::vector packed(GCA_PUBLIC_ANNOUNCE_MAX_SIZE); EXPECT_EQ(gca_pack_public_announce(logger_, packed.data(), packed.size(), nullptr), -1); @@ -212,7 +212,7 @@ TEST_F(AnnouncesPack, PublicAnnouncePackNull) TEST_F(AnnouncesPack, AnnouncesValidationCheck) { -#ifndef _DEBUG +#ifndef __clang__ EXPECT_EQ(gca_is_valid_announce(nullptr), false); #endif @@ -233,7 +233,7 @@ TEST_F(AnnouncesPack, UnpackIncompleteAnnouncesList) GC_Announce announce; EXPECT_EQ(gca_unpack_announces_list(logger_, data, sizeof(data), &announce, 1), -1); -#ifndef _DEBUG +#ifndef __clang__ EXPECT_EQ(gca_unpack_announces_list(logger_, data, sizeof(data), nullptr, 1), -1); EXPECT_EQ(gca_unpack_announces_list(logger_, nullptr, 0, &announce, 1), -1); #endif @@ -264,7 +264,7 @@ TEST_F(AnnouncesPack, PackingEmptyAnnounceFails) std::vector packed(gca_pack_announces_list_size(1)); EXPECT_EQ( gca_pack_announces_list(logger_, packed.data(), packed.size(), &announce, 1, nullptr), -1); -#ifndef _DEBUG +#ifndef __clang__ EXPECT_EQ( gca_pack_announces_list(logger_, packed.data(), packed.size(), nullptr, 1, nullptr), -1); EXPECT_EQ(gca_pack_announces_list(logger_, nullptr, 0, &announce, 1, nullptr), -1); @@ -273,7 +273,7 @@ TEST_F(AnnouncesPack, PackingEmptyAnnounceFails) TEST_F(AnnouncesPack, PackAnnounceNull) { -#ifndef _DEBUG +#ifndef __clang__ std::vector data(GCA_ANNOUNCE_MAX_SIZE); GC_Announce announce; ASSERT_EQ(gca_pack_announce(logger_, nullptr, 0, &announce), -1); diff --git a/toxcore/group_chats.c b/toxcore/group_chats.c index ff44c7ef6..954b7d444 100644 --- a/toxcore/group_chats.c +++ b/toxcore/group_chats.c @@ -161,16 +161,16 @@ typedef enum Group_Sync_Flags { GF_STATE = (1 << 2), // 4 } Group_Sync_Flags; -static bool self_gc_is_founder(non_null() const GC_Chat *chat); -static bool group_number_valid(non_null() const GC_Session *c, int group_number); -static int peer_update(non_null() const GC_Chat *chat, non_null() const GC_Peer *peer, uint32_t peer_number); -static void group_delete(non_null() GC_Session *c, non_null() GC_Chat *chat); -static void group_cleanup(non_null() const GC_Session *c, non_null() GC_Chat *chat); -static bool group_exists(non_null() const GC_Session *c, non_null() const uint8_t *chat_id); -static void add_tcp_relays_to_chat(non_null() const GC_Session *c, non_null() GC_Chat *chat); -static void create_gc_session_keypair(non_null() const Logger *log, non_null() const Random *rng, non_null() uint8_t *public_key, non_null() uint8_t *secret_key); -static size_t load_gc_peers(non_null() GC_Chat *chat, non_null() const GC_SavedPeerInfo *addrs, uint16_t num_addrs); -static bool saved_peer_is_valid(non_null() const GC_SavedPeerInfo *saved_peer); +static bool self_gc_is_founder(const GC_Chat *_Nonnull chat); +static bool group_number_valid(const GC_Session *_Nonnull c, int group_number); +static int peer_update(const GC_Chat *_Nonnull chat, const GC_Peer *_Nonnull peer, uint32_t peer_number); +static void group_delete(GC_Session *_Nonnull c, GC_Chat *_Nonnull chat); +static void group_cleanup(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat); +static bool group_exists(const GC_Session *_Nonnull c, const uint8_t *_Nonnull chat_id); +static void add_tcp_relays_to_chat(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat); +static void create_gc_session_keypair(const Logger *_Nonnull log, const Random *_Nonnull rng, uint8_t *_Nonnull public_key, uint8_t *_Nonnull secret_key); +static size_t load_gc_peers(GC_Chat *_Nonnull chat, const GC_SavedPeerInfo *_Nonnull addrs, uint16_t num_addrs); +static bool saved_peer_is_valid(const GC_SavedPeerInfo *_Nonnull saved_peer); static const GC_Chat empty_gc_chat = {nullptr}; @@ -203,7 +203,7 @@ static GC_Peer_Id gc_unknown_peer_id(void) return gc_peer_id_from_int(0); } -static void kill_group_friend_connection(non_null() const GC_Session *c, non_null() const GC_Chat *chat) +static void kill_group_friend_connection(const GC_Session *_Nonnull c, const GC_Chat *_Nonnull chat) { if (chat->friend_connection_id != -1) { m_kill_group_connection(c->messenger, chat); @@ -235,7 +235,7 @@ bool gc_peer_number_is_valid(const GC_Chat *chat, int peer_number) return peer_number >= 0 && peer_number < (int)chat->numpeers; } -static GC_Peer *get_gc_peer(non_null() const GC_Chat *chat, int peer_number) +static GC_Peer *get_gc_peer(const GC_Chat *_Nonnull chat, int peer_number) { if (!gc_peer_number_is_valid(chat, peer_number)) { return nullptr; @@ -294,7 +294,7 @@ uint16_t gc_get_self_nick_size(const GC_Chat *chat) * * Returns false if `nick` is null or `length` is greater than MAX_GC_NICK_SIZE. */ -static bool self_gc_set_nick(non_null() const GC_Chat *chat, non_null() const uint8_t *nick, uint16_t length) +static bool self_gc_set_nick(const GC_Chat *_Nonnull chat, const uint8_t *_Nonnull nick, uint16_t length) { if (nick == nullptr || length > MAX_GC_NICK_SIZE) { return false; @@ -319,7 +319,7 @@ Group_Role gc_get_self_role(const GC_Chat *chat) } /** Sets self role. If role is invalid this function has no effect. */ -static void self_gc_set_role(non_null() const GC_Chat *chat, Group_Role role) +static void self_gc_set_role(const GC_Chat *_Nonnull chat, Group_Role role) { if (role <= GR_OBSERVER) { GC_Peer *peer = get_gc_peer(chat, 0); @@ -338,7 +338,7 @@ uint8_t gc_get_self_status(const GC_Chat *chat) } /** Sets self status. If status is invalid this function has no effect. */ -static void self_gc_set_status(non_null() const GC_Chat *chat, Group_Peer_Status status) +static void self_gc_set_status(const GC_Chat *_Nonnull chat, Group_Peer_Status status) { if (status == GS_NONE || status == GS_AWAY || status == GS_BUSY) { GC_Peer *peer = get_gc_peer(chat, 0); @@ -359,7 +359,7 @@ GC_Peer_Id gc_get_self_peer_id(const GC_Chat *chat) } /** Sets self confirmed status. */ -static void self_gc_set_confirmed(non_null() const GC_Chat *chat, bool confirmed) +static void self_gc_set_confirmed(const GC_Chat *_Nonnull chat, bool confirmed) { GC_Connection *gconn = get_gc_connection(chat, 0); assert(gconn != nullptr); @@ -368,7 +368,7 @@ static void self_gc_set_confirmed(non_null() const GC_Chat *chat, bool confirmed } /** Returns true if self has the founder role */ -static bool self_gc_is_founder(non_null() const GC_Chat *chat) +static bool self_gc_is_founder(const GC_Chat *_Nonnull chat) { return gc_get_self_role(chat) == GR_FOUNDER; } @@ -384,7 +384,7 @@ void gc_get_self_public_key(const GC_Chat *chat, uint8_t *public_key) * * If `ext_public_key` is null this function has no effect. */ -static void self_gc_set_ext_public_key(non_null() const GC_Chat *chat, non_null() const Extended_Public_Key *ext_public_key) +static void self_gc_set_ext_public_key(const GC_Chat *_Nonnull chat, const Extended_Public_Key *_Nonnull ext_public_key) { if (ext_public_key != nullptr) { GC_Connection *gconn = get_gc_connection(chat, 0); @@ -396,7 +396,7 @@ static void self_gc_set_ext_public_key(non_null() const GC_Chat *chat, non_null( /** * Return true if `peer` has permission to speak according to the `voice_state`. */ -static bool peer_has_voice(non_null() const GC_Peer *peer, Group_Voice_State voice_state) +static bool peer_has_voice(const GC_Peer *_Nonnull peer, Group_Voice_State voice_state) { const Group_Role role = peer->role; @@ -521,19 +521,19 @@ int unpack_gc_saved_peers(GC_Chat *chat, const uint8_t *data, uint16_t length) } /** Returns true if chat privacy state is set to public. */ -static bool is_public_chat(non_null() const GC_Chat *chat) +static bool is_public_chat(const GC_Chat *_Nonnull chat) { return chat->shared_state.privacy_state == GI_PUBLIC; } /** Returns true if group is password protected */ -static bool chat_is_password_protected(non_null() const GC_Chat *chat) +static bool chat_is_password_protected(const GC_Chat *_Nonnull chat) { return chat->shared_state.password_length > 0; } /** Returns true if `password` matches the current group password. */ -static bool validate_password(non_null() const GC_Chat *chat, non_null() const uint8_t *password, uint16_t length) +static bool validate_password(const GC_Chat *_Nonnull chat, const uint8_t *_Nonnull password, uint16_t length) { if (length > MAX_GC_PASSWORD_SIZE) { return false; @@ -550,7 +550,7 @@ static bool validate_password(non_null() const GC_Chat *chat, non_null() const u * * `id` must be at least ENC_PUBLIC_KEY_SIZE bytes in length. */ -static GC_Chat *get_chat_by_id(non_null() const GC_Session *c, non_null() const uint8_t *id) +static GC_Chat *get_chat_by_id(const GC_Session *_Nonnull c, const uint8_t *_Nonnull id) { if (c == nullptr) { return nullptr; @@ -585,7 +585,7 @@ uint32_t gc_get_pk_jenkins_hash(const uint8_t *public_key) * * Must be called every time a peer is confirmed or deleted. */ -static void set_gc_peerlist_checksum(non_null() GC_Chat *chat) +static void set_gc_peerlist_checksum(GC_Chat *_Nonnull chat) { uint16_t sum = 0; @@ -603,7 +603,7 @@ static void set_gc_peerlist_checksum(non_null() GC_Chat *chat) } /** Returns a checksum of the topic currently set in `topic_info`. */ -static uint16_t get_gc_topic_checksum(non_null() const GC_TopicInfo *topic_info) +static uint16_t get_gc_topic_checksum(const GC_TopicInfo *_Nonnull topic_info) { return data_checksum(topic_info->topic, topic_info->length); } @@ -636,7 +636,7 @@ int get_peer_number_of_enc_pk(const GC_Chat *chat, const uint8_t *public_enc_key * Returns the peer number if peer is in the peer list. * Returns -1 if peer is not in the peer list. */ -static int get_peer_number_of_sig_pk(non_null() const GC_Chat *chat, non_null() const uint8_t *public_sig_key) +static int get_peer_number_of_sig_pk(const GC_Chat *_Nonnull chat, const uint8_t *_Nonnull public_sig_key) { for (uint32_t i = 0; i < chat->numpeers; ++i) { const GC_Connection *gconn = get_gc_connection(chat, i); @@ -651,7 +651,7 @@ static int get_peer_number_of_sig_pk(non_null() const GC_Chat *chat, non_null() return -1; } -static bool gc_get_enc_pk_from_sig_pk(non_null() const GC_Chat *chat, non_null() uint8_t *public_key, non_null() const uint8_t *public_sig_key) +static bool gc_get_enc_pk_from_sig_pk(const GC_Chat *_Nonnull chat, uint8_t *_Nonnull public_key, const uint8_t *_Nonnull public_sig_key) { for (uint32_t i = 0; i < chat->numpeers; ++i) { const GC_Connection *gconn = get_gc_connection(chat, i); @@ -669,7 +669,7 @@ static bool gc_get_enc_pk_from_sig_pk(non_null() const GC_Chat *chat, non_null() return false; } -static GC_Connection *random_gc_connection(non_null() const GC_Chat *chat) +static GC_Connection *random_gc_connection(const GC_Chat *_Nonnull chat) { if (chat->numpeers <= 1) { return nullptr; @@ -696,7 +696,7 @@ static GC_Connection *random_gc_connection(non_null() const GC_Chat *chat) /** @brief Returns the peer number associated with peer_id. * Returns -1 if peer_id is invalid. */ -static int get_peer_number_of_peer_id(non_null() const GC_Chat *chat, GC_Peer_Id peer_id) +static int get_peer_number_of_peer_id(const GC_Chat *_Nonnull chat, GC_Peer_Id peer_id) { for (uint32_t i = 0; i < chat->numpeers; ++i) { if (chat->group[i].peer_id.value == peer_id.value) { @@ -713,7 +713,7 @@ static int get_peer_number_of_peer_id(non_null() const GC_Chat *chat, GC_Peer_Id * These ID's are permanently assigned to a peer when they join the group and should be * considered arbitrary values. */ -static GC_Peer_Id get_new_peer_id(non_null() const GC_Chat *chat) +static GC_Peer_Id get_new_peer_id(const GC_Chat *_Nonnull chat) { for (uint32_t i = 0; i < UINT32_MAX - 1; ++i) { const GC_Peer_Id peer_id = gc_peer_id_from_int(i); @@ -729,7 +729,7 @@ static GC_Peer_Id get_new_peer_id(non_null() const GC_Chat *chat) * * Return true on success. */ -static bool set_gc_password_local(non_null() GC_Chat *chat, nullable() const uint8_t *passwd, uint16_t length) +static bool set_gc_password_local(GC_Chat *_Nonnull chat, const uint8_t *_Nullable passwd, uint16_t length) { if (length > MAX_GC_PASSWORD_SIZE) { return false; @@ -751,7 +751,7 @@ static bool set_gc_password_local(non_null() GC_Chat *chat, nullable() const uin * * This should always be called instead of setting the variables manually. */ -static void set_gc_shared_state_version(non_null() GC_Chat *chat, uint32_t version) +static void set_gc_shared_state_version(GC_Chat *_Nonnull chat, uint32_t version) { chat->shared_state.version = version; chat->moderation.shared_state_version = version; @@ -763,7 +763,7 @@ static void set_gc_shared_state_version(non_null() GC_Chat *chat, uint32_t versi * * Return true on success. */ -static bool expand_chat_id(non_null() Extended_Public_Key *dest, non_null() const uint8_t *chat_id) +static bool expand_chat_id(Extended_Public_Key *_Nonnull dest, const uint8_t *_Nonnull chat_id) { assert(dest != nullptr); @@ -774,7 +774,7 @@ static bool expand_chat_id(non_null() Extended_Public_Key *dest, non_null() cons } /** Copies peer connect info from `gconn` to `addr`. */ -static void copy_gc_saved_peer(non_null() const Random *rng, non_null() const GC_Connection *gconn, non_null() GC_SavedPeerInfo *addr) +static void copy_gc_saved_peer(const Random *_Nonnull rng, const GC_Connection *_Nonnull gconn, GC_SavedPeerInfo *_Nonnull addr) { if (!gcc_copy_tcp_relay(rng, &addr->tcp_relay, gconn)) { addr->tcp_relay = (Node_format) { @@ -787,7 +787,7 @@ static void copy_gc_saved_peer(non_null() const Random *rng, non_null() const GC } /** Return true if `saved_peer` has either a valid IP_Port or a valid TCP relay. */ -static bool saved_peer_is_valid(non_null() const GC_SavedPeerInfo *saved_peer) +static bool saved_peer_is_valid(const GC_SavedPeerInfo *_Nonnull saved_peer) { return ipport_isset(&saved_peer->ip_port) || ipport_isset(&saved_peer->tcp_relay.ip_port); } @@ -795,7 +795,7 @@ static bool saved_peer_is_valid(non_null() const GC_SavedPeerInfo *saved_peer) /** @brief Returns the index of the saved peers entry for `public_key`. * Returns -1 if key is not found. */ -static int saved_peer_index(non_null() const GC_Chat *chat, non_null() const uint8_t *public_key) +static int saved_peer_index(const GC_Chat *_Nonnull chat, const uint8_t *_Nonnull public_key) { for (uint16_t i = 0; i < GC_MAX_SAVED_PEERS; ++i) { const GC_SavedPeerInfo *saved_peer = &chat->saved_peers[i]; @@ -809,7 +809,7 @@ static int saved_peer_index(non_null() const GC_Chat *chat, non_null() const uin } /** @brief Removes entry containing `public_key` from the saved peers list. */ -static void saved_peers_remove_entry(non_null() GC_Chat *chat, non_null() const uint8_t *public_key) +static void saved_peers_remove_entry(GC_Chat *_Nonnull chat, const uint8_t *_Nonnull public_key) { const int idx = saved_peer_index(chat, public_key); @@ -833,7 +833,7 @@ static void saved_peers_remove_entry(non_null() GC_Chat *chat, non_null() const * * Returns -1 if there are no vacant indices. */ -static int saved_peers_get_new_index(non_null() const GC_Chat *chat, nullable() const uint8_t *public_key) +static int saved_peers_get_new_index(const GC_Chat *_Nonnull chat, const uint8_t *_Nullable public_key) { if (public_key != nullptr) { const int idx = saved_peer_index(chat, public_key); @@ -874,7 +874,7 @@ static int saved_peers_get_new_index(non_null() const GC_Chat *chat, nullable() * * This function should be called every time a new peer joins the group. */ -static void add_gc_saved_peers(non_null() GC_Chat *chat, non_null() const GC_Connection *gconn) +static void add_gc_saved_peers(GC_Chat *_Nonnull chat, const GC_Connection *_Nonnull gconn) { const int idx = saved_peers_get_new_index(chat, gconn->addr.public_key.enc); @@ -891,7 +891,7 @@ static void add_gc_saved_peers(non_null() GC_Chat *chat, non_null() const GC_Con * * This function should be called after a confirmed peer exits the group. */ -static void refresh_gc_saved_peers(non_null() GC_Chat *chat) +static void refresh_gc_saved_peers(GC_Chat *_Nonnull chat) { const int idx = saved_peers_get_new_index(chat, nullptr); @@ -919,7 +919,7 @@ static void refresh_gc_saved_peers(non_null() GC_Chat *chat) } /** Returns the number of confirmed peers in peerlist. */ -static uint16_t get_gc_confirmed_numpeers(non_null() const GC_Chat *chat) +static uint16_t get_gc_confirmed_numpeers(const GC_Chat *_Nonnull chat) { uint16_t count = 0; @@ -936,15 +936,15 @@ static uint16_t get_gc_confirmed_numpeers(non_null() const GC_Chat *chat) return count; } -static bool sign_gc_shared_state(non_null() GC_Chat *chat); -static bool broadcast_gc_mod_list(non_null() const GC_Chat *chat); -static bool broadcast_gc_shared_state(non_null() const GC_Chat *chat); -static bool update_gc_sanctions_list(non_null() GC_Chat *chat, non_null() const uint8_t *public_sig_key); -static bool update_gc_topic(non_null() GC_Chat *chat, non_null() const uint8_t *public_sig_key); -static bool send_gc_set_observer(non_null() const GC_Chat *chat, non_null() const Extended_Public_Key *target_ext_pk, non_null() const uint8_t *sanction_data, uint16_t length, bool add_obs); +static bool sign_gc_shared_state(GC_Chat *_Nonnull chat); +static bool broadcast_gc_mod_list(const GC_Chat *_Nonnull chat); +static bool broadcast_gc_shared_state(const GC_Chat *_Nonnull chat); +static bool update_gc_sanctions_list(GC_Chat *_Nonnull chat, const uint8_t *_Nonnull public_sig_key); +static bool update_gc_topic(GC_Chat *_Nonnull chat, const uint8_t *_Nonnull public_sig_key); +static bool send_gc_set_observer(const GC_Chat *_Nonnull chat, const Extended_Public_Key *_Nonnull target_ext_pk, const uint8_t *_Nonnull sanction_data, uint16_t length, bool add_obs); /** Returns true if peer designated by `peer_number` is in the sanctions list as an observer. */ -static bool peer_is_observer(non_null() const GC_Chat *chat, uint32_t peer_number) +static bool peer_is_observer(const GC_Chat *_Nonnull chat, uint32_t peer_number) { const GC_Connection *gconn = get_gc_connection(chat, peer_number); @@ -956,7 +956,7 @@ static bool peer_is_observer(non_null() const GC_Chat *chat, uint32_t peer_numbe } /** Returns true if peer designated by `peer_number` is the group founder. */ -static bool peer_is_founder(non_null() const GC_Chat *chat, uint32_t peer_number) +static bool peer_is_founder(const GC_Chat *_Nonnull chat, uint32_t peer_number) { const GC_Connection *gconn = get_gc_connection(chat, peer_number); @@ -969,7 +969,7 @@ static bool peer_is_founder(non_null() const GC_Chat *chat, uint32_t peer_number } /** Returns true if peer designated by `peer_number` is in the moderator list or is the founder. */ -static bool peer_is_moderator(non_null() const GC_Chat *chat, uint32_t peer_number) +static bool peer_is_moderator(const GC_Chat *_Nonnull chat, uint32_t peer_number) { const GC_Connection *gconn = get_gc_connection(chat, peer_number); @@ -993,7 +993,7 @@ static bool peer_is_moderator(non_null() const GC_Chat *chat, uint32_t peer_numb * This should be called every time the moderator list or sanctions list changes, * and after a new peer is marked as confirmed. */ -static void update_gc_peer_roles(non_null() GC_Chat *chat) +static void update_gc_peer_roles(GC_Chat *_Nonnull chat) { chat->roles_checksum = 0; bool conflicts = false; @@ -1059,7 +1059,7 @@ static void update_gc_peer_roles(non_null() GC_Chat *chat) * * Returns false on failure. */ -static bool prune_gc_mod_list(non_null() GC_Chat *chat) +static bool prune_gc_mod_list(GC_Chat *_Nonnull chat) { if (chat->moderation.num_mods == 0) { return true; @@ -1090,7 +1090,7 @@ static bool prune_gc_mod_list(non_null() GC_Chat *chat) && update_gc_topic(chat, public_sig_key); } -static bool prune_gc_sanctions_list_inner(non_null() GC_Chat *chat, non_null() const Mod_Sanction *sanction, non_null() const Extended_Public_Key *target_ext_pk) +static bool prune_gc_sanctions_list_inner(GC_Chat *_Nonnull chat, const Mod_Sanction *_Nonnull sanction, const Extended_Public_Key *_Nonnull target_ext_pk) { if (!sanctions_list_remove_observer(&chat->moderation, sanction->target_public_enc_key, nullptr)) { LOGGER_WARNING(chat->log, "Failed to remove entry from observer list"); @@ -1118,7 +1118,7 @@ static bool prune_gc_sanctions_list_inner(non_null() GC_Chat *chat, non_null() c * * @retval false on failure or if no presently sanctioned peer is offline. */ -static bool prune_gc_sanctions_list(non_null() GC_Chat *chat) +static bool prune_gc_sanctions_list(GC_Chat *_Nonnull chat) { if (chat->moderation.num_sanctions == 0) { return true; @@ -1149,7 +1149,7 @@ static bool prune_gc_sanctions_list(non_null() GC_Chat *chat) * Return length of packed peer on success. * Return -1 on failure. */ -static int pack_gc_peer(non_null() uint8_t *data, uint16_t length, non_null() const GC_Peer *peer) +static int pack_gc_peer(uint8_t *_Nonnull data, uint16_t length, const GC_Peer *_Nonnull peer) { if (PACKED_GC_PEER_SIZE > length) { return -1; @@ -1172,7 +1172,7 @@ static int pack_gc_peer(non_null() uint8_t *data, uint16_t length, non_null() co * Returns the length of processed data on success. * Returns -1 on failure. */ -static int unpack_gc_peer(non_null() GC_Peer *peer, non_null() const uint8_t *data, uint16_t length) +static int unpack_gc_peer(GC_Peer *_Nonnull peer, const uint8_t *_Nonnull data, uint16_t length) { if (PACKED_GC_PEER_SIZE > length) { return -1; @@ -1197,7 +1197,7 @@ static int unpack_gc_peer(non_null() GC_Peer *peer, non_null() const uint8_t *da * * Returns packed data length. */ -static uint16_t pack_gc_shared_state(non_null() uint8_t *data, uint16_t length, non_null() const GC_SharedState *shared_state) +static uint16_t pack_gc_shared_state(uint8_t *_Nonnull data, uint16_t length, const GC_SharedState *_Nonnull shared_state) { if (length < GC_PACKED_SHARED_STATE_SIZE) { return 0; @@ -1244,7 +1244,7 @@ static uint16_t pack_gc_shared_state(non_null() uint8_t *data, uint16_t length, * * Returns the length of processed data. */ -static uint16_t unpack_gc_shared_state(non_null() GC_SharedState *shared_state, non_null() const uint8_t *data, uint16_t length) +static uint16_t unpack_gc_shared_state(GC_SharedState *_Nonnull shared_state, const uint8_t *_Nonnull data, uint16_t length) { if (length < GC_PACKED_SHARED_STATE_SIZE) { return 0; @@ -1297,7 +1297,7 @@ static uint16_t unpack_gc_shared_state(non_null() GC_SharedState *shared_state, * * Returns packed data length. */ -static uint16_t pack_gc_topic_info(non_null() uint8_t *data, uint16_t length, non_null() const GC_TopicInfo *topic_info) +static uint16_t pack_gc_topic_info(uint8_t *_Nonnull data, uint16_t length, const GC_TopicInfo *_Nonnull topic_info) { if (length < topic_info->length + GC_MIN_PACKED_TOPIC_INFO_SIZE) { return 0; @@ -1324,7 +1324,7 @@ static uint16_t pack_gc_topic_info(non_null() uint8_t *data, uint16_t length, no * Returns -1 on failure. * Returns the length of the processed data on success. */ -static int unpack_gc_topic_info(non_null() GC_TopicInfo *topic_info, non_null() const uint8_t *data, uint16_t length) +static int unpack_gc_topic_info(GC_TopicInfo *_Nonnull topic_info, const uint8_t *_Nonnull data, uint16_t length) { if (length < sizeof(uint16_t) + sizeof(uint16_t) + sizeof(uint32_t)) { return -1; @@ -1365,7 +1365,7 @@ static int unpack_gc_topic_info(non_null() GC_TopicInfo *topic_info, non_null() * Returns packet length on success. * Returns -1 on failure. */ -static int make_gc_shared_state_packet(non_null() const GC_Chat *chat, non_null() uint8_t *data, uint16_t length) +static int make_gc_shared_state_packet(const GC_Chat *_Nonnull chat, uint8_t *_Nonnull data, uint16_t length) { if (length < GC_SHARED_STATE_ENC_PACKET_SIZE) { return -1; @@ -1389,7 +1389,7 @@ static int make_gc_shared_state_packet(non_null() const GC_Chat *chat, non_null( * * Returns true on success and increments the shared state version. */ -static bool sign_gc_shared_state(non_null() GC_Chat *chat) +static bool sign_gc_shared_state(GC_Chat *_Nonnull chat) { if (!self_gc_is_founder(chat)) { LOGGER_ERROR(chat->log, "Failed to sign shared state (invalid permission)"); @@ -1435,8 +1435,8 @@ static bool sign_gc_shared_state(non_null() GC_Chat *chat) * Return -2 on decryption failure. * Return -3 if plaintext payload length is invalid. */ -static int group_packet_unwrap(non_null() const Logger *log, non_null() const Memory *mem, non_null() const GC_Connection *gconn, non_null() uint8_t *data, nullable() uint64_t *message_id, - non_null() uint8_t *packet_type, non_null() const uint8_t *packet, uint16_t length) +static int group_packet_unwrap(const Logger *_Nonnull log, const Memory *_Nonnull mem, const GC_Connection *_Nonnull gconn, uint8_t *_Nonnull data, uint64_t *_Nullable message_id, + uint8_t *_Nonnull packet_type, const uint8_t *_Nonnull packet, uint16_t length) { assert(data != nullptr); assert(packet != nullptr); @@ -1573,7 +1573,7 @@ int group_packet_wrap( * * Returns true on success. */ -static bool send_lossy_group_packet(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, non_null() const uint8_t *data, uint16_t length, uint8_t packet_type) +static bool send_lossy_group_packet(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nonnull data, uint16_t length, uint8_t packet_type) { assert(length <= MAX_GC_CUSTOM_LOSSY_PACKET_SIZE); @@ -1613,7 +1613,7 @@ static bool send_lossy_group_packet(non_null() const GC_Chat *chat, non_null() G * * Returns true on success. */ -static bool send_lossless_group_packet(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, nullable() const uint8_t *data, uint16_t length, +static bool send_lossless_group_packet(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nullable data, uint16_t length, uint8_t packet_type) { assert(length <= MAX_GC_PACKET_SIZE); @@ -1632,7 +1632,7 @@ static bool send_lossless_group_packet(non_null() const GC_Chat *chat, non_null( * * Returns true on success or if sync request timeout has not expired. */ -static bool send_gc_sync_request(non_null() GC_Chat *chat, non_null() GC_Connection *gconn, uint16_t sync_flags) +static bool send_gc_sync_request(GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, uint16_t sync_flags) { if (!mono_time_is_timeout(chat->mono_time, chat->last_sync_request, GC_SYNC_REQUEST_LIMIT)) { return true; @@ -1660,14 +1660,14 @@ static bool send_gc_sync_request(non_null() GC_Chat *chat, non_null() GC_Connect * * Return true on success. */ -static bool send_gc_sync_response(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, nullable() const uint8_t *data, uint16_t length) +static bool send_gc_sync_response(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nullable data, uint16_t length) { return send_lossless_group_packet(chat, gconn, data, length, GP_SYNC_RESPONSE); } -static bool send_gc_peer_exchange(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn); -static bool send_gc_handshake_packet(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, uint8_t handshake_type, uint8_t request_type, uint8_t join_type); -static bool send_gc_oob_handshake_request(non_null() const GC_Chat *chat, non_null() const GC_Connection *gconn); +static bool send_gc_peer_exchange(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn); +static bool send_gc_handshake_packet(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, uint8_t handshake_type, uint8_t request_type, uint8_t join_type); +static bool send_gc_oob_handshake_request(const GC_Chat *_Nonnull chat, const GC_Connection *_Nonnull gconn); /** @brief Unpacks a sync announce. * @@ -1676,7 +1676,7 @@ static bool send_gc_oob_handshake_request(non_null() const GC_Chat *chat, non_nu * * Return true on success (whether or not the peer was added). */ -static bool unpack_gc_sync_announce(non_null() GC_Chat *chat, non_null() const uint8_t *data, const uint16_t length) +static bool unpack_gc_sync_announce(GC_Chat *_Nonnull chat, const uint8_t *_Nonnull data, const uint16_t length) { GC_Announce announce = {0}; @@ -1756,8 +1756,8 @@ static bool unpack_gc_sync_announce(non_null() GC_Chat *chat, non_null() const u * Return -1 if the group is full or the peer failed to unpack. * Return -2 if `peer_number` does not designate a valid peer. */ -static int handle_gc_sync_response(non_null() const GC_Session *c, non_null() GC_Chat *chat, uint32_t peer_number, nullable() const uint8_t *data, - uint16_t length, nullable() void *userdata) +static int handle_gc_sync_response(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, uint32_t peer_number, const uint8_t *_Nullable data, + uint16_t length, void *_Nullable userdata) { if (chat->connection_state == CS_CONNECTED && get_gc_confirmed_numpeers(chat) >= chat->shared_state.maxpeers && !peer_is_founder(chat, peer_number)) { @@ -1790,18 +1790,18 @@ static int handle_gc_sync_response(non_null() const GC_Session *c, non_null() GC return 0; } -static int get_gc_peer_public_key(non_null() const GC_Chat *chat, uint32_t peer_number, non_null() uint8_t *public_key); -static bool send_peer_shared_state(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn); -static bool send_peer_mod_list(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn); -static bool send_peer_sanctions_list(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn); -static bool send_peer_topic(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn); +static int get_gc_peer_public_key(const GC_Chat *_Nonnull chat, uint32_t peer_number, uint8_t *_Nonnull public_key); +static bool send_peer_shared_state(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn); +static bool send_peer_mod_list(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn); +static bool send_peer_sanctions_list(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn); +static bool send_peer_topic(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn); /** @brief Creates a sync announce for peer designated by `gconn` and puts it in `announce`, which * must be zeroed by the caller. * * Returns true if announce was successfully created. */ -static bool create_sync_announce(non_null() const GC_Chat *chat, non_null() const GC_Connection *gconn, uint32_t peer_number, non_null() GC_Announce *announce) +static bool create_sync_announce(const GC_Chat *_Nonnull chat, const GC_Connection *_Nonnull gconn, uint32_t peer_number, GC_Announce *_Nonnull announce) { if (chat == nullptr || gconn == nullptr) { return false; @@ -1823,7 +1823,7 @@ static bool create_sync_announce(non_null() const GC_Chat *chat, non_null() cons return true; } -static bool sync_response_send_peers(non_null() GC_Chat *chat, non_null() GC_Connection *gconn, uint32_t peer_number, bool first_sync) +static bool sync_response_send_peers(GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, uint32_t peer_number, bool first_sync) { // Always respond to a peer's first sync request if (!first_sync && !mono_time_is_timeout(chat->mono_time, @@ -1891,7 +1891,7 @@ static bool sync_response_send_peers(non_null() GC_Chat *chat, non_null() GC_Con * * Return true on success. */ -static bool sync_response_send_state(non_null() GC_Chat *chat, non_null() GC_Connection *gconn, uint32_t peer_number, uint16_t sync_flags) +static bool sync_response_send_state(GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, uint32_t peer_number, uint16_t sync_flags) { const bool first_sync = gconn->last_sync_response == 0; @@ -1948,7 +1948,7 @@ static bool sync_response_send_state(non_null() GC_Chat *chat, non_null() GC_Con * Return -3 if we fail to send a response packet. * Return -4 if `peer_number` does not designate a valid peer. */ -static int handle_gc_sync_request(non_null() GC_Chat *chat, uint32_t peer_number, non_null() const uint8_t *data, uint16_t length) +static int handle_gc_sync_request(GC_Chat *_Nonnull chat, uint32_t peer_number, const uint8_t *_Nonnull data, uint16_t length) { GC_Connection *gconn = get_gc_connection(chat, peer_number); @@ -2000,14 +2000,14 @@ static int handle_gc_sync_request(non_null() GC_Chat *chat, uint32_t peer_number return 0; } -static void copy_self(non_null() const GC_Chat *chat, non_null() GC_Peer *peer); -static bool send_gc_peer_info_request(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn); +static void copy_self(const GC_Chat *_Nonnull chat, GC_Peer *_Nonnull peer); +static bool send_gc_peer_info_request(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn); /** @brief Shares our TCP relays with peer and adds shared relays to our connection with them. * * Returns true on success or if we're not connected to any TCP relays. */ -static bool send_gc_tcp_relays(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_gc_tcp_relays(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { Node_format tcp_relays[GCC_MAX_TCP_SHARED_RELAYS]; @@ -2048,7 +2048,7 @@ static bool send_gc_tcp_relays(non_null() const GC_Chat *chat, non_null() GC_Con * Return -1 if packet has invalid size. * Return -2 if packet contains invalid data. */ -static int handle_gc_tcp_relays(non_null() GC_Chat *chat, non_null() GC_Connection *gconn, non_null() const uint8_t *data, uint16_t length) +static int handle_gc_tcp_relays(GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nonnull data, uint16_t length) { if (length == 0) { return -1; @@ -2084,7 +2084,7 @@ static int handle_gc_tcp_relays(non_null() GC_Chat *chat, non_null() GC_Connecti * * Return true on success. */ -static bool send_gc_invite_request(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_gc_invite_request(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { if (!chat_is_password_protected(chat)) { return send_lossless_group_packet(chat, gconn, nullptr, 0, GP_INVITE_REQUEST); @@ -2101,7 +2101,7 @@ static bool send_gc_invite_request(non_null() const GC_Chat *chat, non_null() GC return send_lossless_group_packet(chat, gconn, data, length, GP_INVITE_REQUEST); } -static bool send_gc_invite_response(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_gc_invite_response(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { return send_lossless_group_packet(chat, gconn, nullptr, 0, GP_INVITE_RESPONSE); } @@ -2111,7 +2111,7 @@ static bool send_gc_invite_response(non_null() const GC_Chat *chat, non_null() G * Return 0 if packet is correctly handled. * Return -1 if we fail to send a sync request. */ -static int handle_gc_invite_response(non_null() GC_Chat *chat, non_null() GC_Connection *gconn) +static int handle_gc_invite_response(GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { const uint16_t flags = GF_PEERS | GF_TOPIC | GF_STATE; @@ -2128,8 +2128,8 @@ static int handle_gc_invite_response(non_null() GC_Chat *chat, non_null() GC_Con * Return 0 if packet is handled correctly. * Return -1 if packet has invalid size. */ -static int handle_gc_invite_response_reject(non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() const uint8_t *data, uint16_t length, - nullable() void *userdata) +static int handle_gc_invite_response_reject(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, const uint8_t *_Nonnull data, uint16_t length, + void *_Nullable userdata) { if (length < sizeof(uint8_t)) { return -1; @@ -2162,7 +2162,7 @@ static int handle_gc_invite_response_reject(non_null() const GC_Session *c, non_ * * Return true on success. */ -static bool send_gc_invite_response_reject(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, uint8_t type) +static bool send_gc_invite_response_reject(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, uint8_t type) { if (type >= GJ_INVALID) { type = GJ_INVITE_FAILED; @@ -2184,7 +2184,7 @@ static bool send_gc_invite_response_reject(non_null() const GC_Chat *chat, non_n * Return -3 if we fail to send an invite response. * Return -4 if peer_number does not designate a valid peer. */ -static int handle_gc_invite_request(non_null() GC_Chat *chat, uint32_t peer_number, nullable() const uint8_t *data, uint16_t length) +static int handle_gc_invite_request(GC_Chat *_Nonnull chat, uint32_t peer_number, const uint8_t *_Nullable data, uint16_t length) { if (chat->shared_state.version == 0) { // we aren't synced yet; ignore request return 0; @@ -2241,7 +2241,7 @@ FAILED_INVITE: * Return true if packet is successfully sent to at least one peer or the * group is empty. */ -static bool send_gc_lossless_packet_all_peers(non_null() const GC_Chat *chat, non_null() const uint8_t *data, uint16_t length, uint8_t type) +static bool send_gc_lossless_packet_all_peers(const GC_Chat *_Nonnull chat, const uint8_t *_Nonnull data, uint16_t length, uint8_t type) { uint32_t sent = 0; uint32_t confirmed_peers = 0; @@ -2270,7 +2270,7 @@ static bool send_gc_lossless_packet_all_peers(non_null() const GC_Chat *chat, no * Return true if packet is successfully sent to at least one peer or the * group is empty. */ -static bool send_gc_lossy_packet_all_peers(non_null() const GC_Chat *chat, non_null() const uint8_t *data, uint16_t length, uint8_t type) +static bool send_gc_lossy_packet_all_peers(const GC_Chat *_Nonnull chat, const uint8_t *_Nonnull data, uint16_t length, uint8_t type) { uint32_t sent = 0; uint32_t confirmed_peers = 0; @@ -2298,7 +2298,7 @@ static bool send_gc_lossy_packet_all_peers(non_null() const GC_Chat *chat, non_n * * Returns length of packet including header. */ -static uint16_t make_gc_broadcast_header(nullable() const uint8_t *data, uint16_t length, non_null() uint8_t *packet, uint8_t bc_type) +static uint16_t make_gc_broadcast_header(const uint8_t *_Nullable data, uint16_t length, uint8_t *_Nonnull packet, uint8_t bc_type) { packet[0] = bc_type; const uint16_t header_len = sizeof(uint8_t); @@ -2314,7 +2314,7 @@ static uint16_t make_gc_broadcast_header(nullable() const uint8_t *data, uint16_ * * Returns true on success. */ -static bool send_gc_broadcast_message(non_null() const GC_Chat *chat, nullable() const uint8_t *data, uint16_t length, uint8_t bc_type) +static bool send_gc_broadcast_message(const GC_Chat *_Nonnull chat, const uint8_t *_Nullable data, uint16_t length, uint8_t bc_type) { if (length + GC_BROADCAST_ENC_HEADER_SIZE > MAX_GC_PACKET_SIZE) { LOGGER_ERROR(chat->log, "Failed to broadcast message: invalid length %u", length); @@ -2336,12 +2336,12 @@ static bool send_gc_broadcast_message(non_null() const GC_Chat *chat, nullable() return ret; } -static bool group_topic_lock_enabled(non_null() const GC_Chat *chat); +static bool group_topic_lock_enabled(const GC_Chat *_Nonnull chat); /** @brief Compares the supplied values with our own state and returns the appropriate * sync flags for a sync request. */ -static uint16_t get_sync_flags(non_null() const GC_Chat *chat, uint16_t peers_checksum, uint16_t peer_count, uint32_t sstate_version, uint32_t screds_version, uint16_t roles_checksum, +static uint16_t get_sync_flags(const GC_Chat *_Nonnull chat, uint16_t peers_checksum, uint16_t peer_count, uint32_t sstate_version, uint32_t screds_version, uint16_t roles_checksum, uint32_t topic_version, uint16_t topic_checksum) { uint16_t sync_flags = 0; @@ -2380,7 +2380,7 @@ static uint16_t get_sync_flags(non_null() const GC_Chat *chat, uint16_t peers_ch * * Returns true if a sync request packet is successfully sent. */ -static bool do_gc_peer_state_sync(non_null() GC_Chat *chat, non_null() GC_Connection *gconn, non_null() const uint8_t *sync_data, const uint16_t length) +static bool do_gc_peer_state_sync(GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nonnull sync_data, const uint16_t length) { if (length < GC_PING_PACKET_MIN_DATA_SIZE) { return false; @@ -2440,7 +2440,7 @@ static bool do_gc_peer_state_sync(non_null() GC_Chat *chat, non_null() GC_Connec * Return 0 if packet is handled correctly. * Return -1 if packet has invalid size or peer is not confirmed. */ -static int handle_gc_ping(non_null() GC_Chat *chat, non_null() GC_Connection *gconn, non_null() const uint8_t *data, uint16_t length) +static int handle_gc_ping(GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nonnull data, uint16_t length) { if (length < GC_PING_PACKET_MIN_DATA_SIZE) { return -1; @@ -2491,8 +2491,8 @@ int gc_set_self_status(const Messenger *m, int group_number, Group_Peer_Status s * Return 0 if packet is handled correctly. * Return -1 if packet has invalid length. */ -static int handle_gc_status(non_null() const GC_Session *c, non_null() const GC_Chat *chat, non_null() GC_Peer *peer, non_null() const uint8_t *data, - uint16_t length, nullable() void *userdata) +static int handle_gc_status(const GC_Session *_Nonnull c, const GC_Chat *_Nonnull chat, GC_Peer *_Nonnull peer, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata) { if (length < sizeof(uint8_t)) { return -1; @@ -2555,7 +2555,7 @@ void gc_get_chat_id(const GC_Chat *chat, uint8_t *dest) * * Returns true on success. */ -static bool send_self_to_peer(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_self_to_peer(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { GC_Peer *self = (GC_Peer *)mem_alloc(chat->mem, sizeof(GC_Peer)); @@ -2608,7 +2608,7 @@ static bool send_self_to_peer(non_null() const GC_Chat *chat, non_null() GC_Conn * Return -2 if response fails. * Return -3 if `peer_number` does not designate a valid peer. */ -static int handle_gc_peer_info_request(non_null() const GC_Chat *chat, uint32_t peer_number) +static int handle_gc_peer_info_request(const GC_Chat *_Nonnull chat, uint32_t peer_number) { GC_Connection *gconn = get_gc_connection(chat, peer_number); @@ -2632,7 +2632,7 @@ static int handle_gc_peer_info_request(non_null() const GC_Chat *chat, uint32_t * * Return true on success. */ -static bool send_gc_peer_info_request(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_gc_peer_info_request(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { return send_lossless_group_packet(chat, gconn, nullptr, 0, GP_PEER_INFO_REQUEST); } @@ -2662,8 +2662,8 @@ static bool send_gc_peer_exchange(const GC_Chat *chat, GC_Connection *gconn) * Return -7 if peer's role cannot be validated. * Return -8 if memory allocation fails. */ -static int handle_gc_peer_info_response(non_null() const GC_Session *c, non_null() GC_Chat *chat, uint32_t peer_number, - non_null() const uint8_t *data, uint16_t length, nullable() void *userdata) +static int handle_gc_peer_info_response(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, uint32_t peer_number, + const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata) { if (length < PACKED_GC_PEER_SIZE) { return -1; @@ -2744,7 +2744,7 @@ static int handle_gc_peer_info_response(non_null() const GC_Session *c, non_null * * Returns true on success. */ -static bool send_peer_shared_state(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_peer_shared_state(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { if (chat->shared_state.version == 0) { return false; @@ -2764,7 +2764,7 @@ static bool send_peer_shared_state(non_null() const GC_Chat *chat, non_null() GC * * Returns true on success. */ -static bool broadcast_gc_shared_state(non_null() const GC_Chat *chat) +static bool broadcast_gc_shared_state(const GC_Chat *_Nonnull chat) { uint8_t packet[GC_SHARED_STATE_ENC_PACKET_SIZE]; const int packet_len = make_gc_shared_state_packet(chat, packet, sizeof(packet)); @@ -2781,7 +2781,7 @@ static bool broadcast_gc_shared_state(non_null() const GC_Chat *chat) * If the privacy state has been set to private, we kill our group's connection to the DHT. * Otherwise, we create a new connection with the DHT and flag an announcement. */ -static void do_privacy_state_change(non_null() const GC_Session *c, non_null() GC_Chat *chat, nullable() void *userdata) +static void do_privacy_state_change(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, void *_Nullable userdata) { if (is_public_chat(chat)) { if (!m_create_group_connection(c->messenger, chat)) { @@ -2808,8 +2808,8 @@ static void do_privacy_state_change(non_null() const GC_Session *c, non_null() G * * The initial retrieval of the shared state on group join will be ignored by this function. */ -static void do_gc_shared_state_changes(non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() const GC_SharedState *old_shared_state, - nullable() void *userdata) +static void do_gc_shared_state_changes(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, const GC_SharedState *_Nonnull old_shared_state, + void *_Nullable userdata) { /* Max peers changed */ if (chat->shared_state.maxpeers != old_shared_state->maxpeers && c->peer_limit != nullptr) { @@ -2847,7 +2847,7 @@ static void do_gc_shared_state_changes(non_null() const GC_Session *c, non_null( * * Return true on success. */ -static bool send_gc_random_sync_request(non_null() GC_Chat *chat, uint16_t sync_flags) +static bool send_gc_random_sync_request(GC_Chat *_Nonnull chat, uint16_t sync_flags) { GC_Connection *rand_gconn = random_gc_connection(chat); @@ -2859,7 +2859,7 @@ static bool send_gc_random_sync_request(non_null() GC_Chat *chat, uint16_t sync_ } /** @brief Returns true if all shared state values are legal. */ -static bool validate_gc_shared_state(non_null() const GC_SharedState *state) +static bool validate_gc_shared_state(const GC_SharedState *_Nonnull state) { return state->maxpeers > 0 && state->password_length <= MAX_GC_PASSWORD_SIZE @@ -2874,7 +2874,7 @@ static bool validate_gc_shared_state(non_null() const GC_SharedState *state) * Return 0 if error is currectly handled. * Return -1 on failure. */ -static int handle_gc_shared_state_error(non_null() GC_Chat *chat, non_null() GC_Connection *gconn) +static int handle_gc_shared_state_error(GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { gcc_mark_for_deletion(gconn, chat->tcp_conn, GC_EXIT_TYPE_SYNC_ERR, nullptr, 0); @@ -2899,8 +2899,8 @@ static int handle_gc_shared_state_error(non_null() GC_Chat *chat, non_null() GC_ * Return 0 if packet is successfully handled. * Return -1 if packet is invalid and this is not successfully handled. */ -static int handle_gc_shared_state(non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() GC_Connection *gconn, non_null() const uint8_t *data, - uint16_t length, nullable() void *userdata) +static int handle_gc_shared_state(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata) { if (length < GC_SHARED_STATE_ENC_PACKET_SIZE) { return handle_gc_shared_state_error(chat, gconn); @@ -2961,7 +2961,7 @@ static int handle_gc_shared_state(non_null() const GC_Session *c, non_null() GC_ * Return 0 if data is valid. * Return -1 if data is invalid. */ -static int validate_unpack_mod_list(non_null() GC_Chat *chat, non_null() const uint8_t *data, uint16_t length, uint16_t num_mods) +static int validate_unpack_mod_list(GC_Chat *_Nonnull chat, const uint8_t *_Nonnull data, uint16_t length, uint16_t num_mods) { if (num_mods > MOD_MAX_NUM_MODERATORS) { return -1; @@ -2996,7 +2996,7 @@ static int validate_unpack_mod_list(non_null() GC_Chat *chat, non_null() const u * Return -1 if packet has invalid size. * Return -2 if packet contained invalid data or validation failed. */ -static int handle_gc_mod_list(non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() const uint8_t *data, uint16_t length, nullable() void *userdata) +static int handle_gc_mod_list(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata) { if (length < sizeof(uint16_t)) { return -1; @@ -3047,7 +3047,7 @@ static int handle_gc_mod_list(non_null() const GC_Session *c, non_null() GC_Chat * Return 0 on success. * Return -1 on failure. */ -static int handle_gc_sanctions_list_error(non_null() GC_Chat *chat) +static int handle_gc_sanctions_list_error(GC_Chat *_Nonnull chat) { if (chat->moderation.sanctions_creds.version > 0) { return 0; @@ -3075,8 +3075,8 @@ static int handle_gc_sanctions_list_error(non_null() GC_Chat *chat) * Return -1 if we failed to gracefully handle a sanctions list error. * Return -2 if packet has invalid size. */ -static int handle_gc_sanctions_list(non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() const uint8_t *data, uint16_t length, - nullable() void *userdata) +static int handle_gc_sanctions_list(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, const uint8_t *_Nonnull data, uint16_t length, + void *_Nullable userdata) { if (length < sizeof(uint16_t)) { return -2; @@ -3147,7 +3147,7 @@ static int handle_gc_sanctions_list(non_null() const GC_Session *c, non_null() G * Returns length of packet data on success. * Returns -1 on failure. */ -static int make_gc_mod_list_packet(non_null() const GC_Chat *chat, non_null() uint8_t *data, uint32_t maxlen, uint16_t mod_list_size) +static int make_gc_mod_list_packet(const GC_Chat *_Nonnull chat, uint8_t *_Nonnull data, uint32_t maxlen, uint16_t mod_list_size) { if (maxlen < sizeof(uint16_t) + mod_list_size) { return -1; @@ -3176,7 +3176,7 @@ static int make_gc_mod_list_packet(non_null() const GC_Chat *chat, non_null() ui * * Return true on success. */ -static bool send_peer_mod_list(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_peer_mod_list(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { const uint16_t mod_list_size = chat->moderation.num_mods * MOD_LIST_ENTRY_SIZE; const uint16_t length = sizeof(uint16_t) + mod_list_size; @@ -3205,7 +3205,7 @@ static bool send_peer_mod_list(non_null() const GC_Chat *chat, non_null() GC_Con * Returns packet length on success. * Returns -1 on failure. */ -static int make_gc_sanctions_list_packet(non_null() const GC_Chat *chat, non_null() uint8_t *data, uint16_t maxlen) +static int make_gc_sanctions_list_packet(const GC_Chat *_Nonnull chat, uint8_t *_Nonnull data, uint16_t maxlen) { if (maxlen < sizeof(uint16_t)) { return -1; @@ -3228,7 +3228,7 @@ static int make_gc_sanctions_list_packet(non_null() const GC_Chat *chat, non_nul * * Returns true on success. */ -static bool send_peer_sanctions_list(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_peer_sanctions_list(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { if (chat->moderation.sanctions_creds.version == 0) { return true; @@ -3261,7 +3261,7 @@ static bool send_peer_sanctions_list(non_null() const GC_Chat *chat, non_null() * * Returns true on success. */ -static bool broadcast_gc_sanctions_list(non_null() const GC_Chat *chat) +static bool broadcast_gc_sanctions_list(const GC_Chat *_Nonnull chat) { const uint16_t packet_size = MOD_SANCTION_PACKED_SIZE * chat->moderation.num_sanctions + sizeof(uint16_t) + MOD_SANCTIONS_CREDS_SIZE; @@ -3291,7 +3291,7 @@ static bool broadcast_gc_sanctions_list(non_null() const GC_Chat *chat) * * Returns true on success. */ -static bool update_gc_sanctions_list(non_null() GC_Chat *chat, non_null() const uint8_t *public_sig_key) +static bool update_gc_sanctions_list(GC_Chat *_Nonnull chat, const uint8_t *_Nonnull public_sig_key) { const uint16_t num_replaced = sanctions_list_replace_sig(&chat->moderation, public_sig_key); @@ -3306,7 +3306,7 @@ static bool update_gc_sanctions_list(non_null() GC_Chat *chat, non_null() const * * Returns true on success. */ -static bool broadcast_gc_mod_list(non_null() const GC_Chat *chat) +static bool broadcast_gc_mod_list(const GC_Chat *_Nonnull chat) { const uint16_t mod_list_size = chat->moderation.num_mods * MOD_LIST_ENTRY_SIZE; const uint16_t length = sizeof(uint16_t) + mod_list_size; @@ -3336,7 +3336,7 @@ static bool broadcast_gc_mod_list(non_null() const GC_Chat *chat) * Returns -1 if the message is too long. * Returns -2 if the packet failed to send. */ -static int send_gc_self_exit(non_null() const GC_Chat *chat, nullable() const uint8_t *partmessage, uint16_t length) +static int send_gc_self_exit(const GC_Chat *_Nonnull chat, const uint8_t *_Nullable partmessage, uint16_t length) { if (length > MAX_GC_PART_MESSAGE_SIZE) { return -1; @@ -3350,7 +3350,7 @@ static int send_gc_self_exit(non_null() const GC_Chat *chat, nullable() const ui } /** @brief Handles a peer exit broadcast. */ -static void handle_gc_peer_exit(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, nullable() const uint8_t *data, uint16_t length) +static void handle_gc_peer_exit(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nullable data, uint16_t length) { if (length > MAX_GC_PART_MESSAGE_SIZE) { length = MAX_GC_PART_MESSAGE_SIZE; @@ -3422,8 +3422,8 @@ int gc_get_peer_nick_size(const GC_Chat *chat, GC_Peer_Id peer_id) * Return 0 if packet is handled correctly. * Return -1 on failure. */ -static int handle_gc_nick(non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() GC_Peer *peer, non_null() const uint8_t *nick, - uint16_t length, nullable() void *userdata) +static int handle_gc_nick(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, GC_Peer *_Nonnull peer, const uint8_t *_Nonnull nick, + uint16_t length, void *_Nullable userdata) { /* If this happens malicious behaviour is highly suspect */ if (length == 0 || length > MAX_GC_NICK_SIZE) { @@ -3449,7 +3449,7 @@ static int handle_gc_nick(non_null() const GC_Session *c, non_null() GC_Chat *ch * Returns -1 if peer_number is invalid. * Returns -2 if `public_key` is null. */ -static int get_gc_peer_public_key(non_null() const GC_Chat *chat, uint32_t peer_number, non_null() uint8_t *public_key) +static int get_gc_peer_public_key(const GC_Chat *_Nonnull chat, uint32_t peer_number, uint8_t *_Nonnull public_key) { const GC_Connection *gconn = get_gc_connection(chat, peer_number); @@ -3489,7 +3489,7 @@ int gc_get_peer_public_key_by_peer_id(const GC_Chat *chat, GC_Peer_Id peer_id, u * connection is direct, otherwise puts a placeholder in the buffer indicating that * the IP cannot be displayed. */ -static void get_gc_ip_ntoa(non_null() const IP_Port *ip_port, non_null() Ip_Ntoa *ip_str) +static void get_gc_ip_ntoa(const IP_Port *_Nonnull ip_port, Ip_Ntoa *_Nonnull ip_str) { net_ip_ntoa(&ip_port->ip, ip_str); @@ -3570,7 +3570,7 @@ unsigned int gc_get_peer_connection_status(const GC_Chat *chat, GC_Peer_Id peer_ * Returns packet length on success. * Returns -1 on failure. */ -static int make_gc_topic_packet(non_null() const GC_Chat *chat, non_null() uint8_t *data, uint16_t length) +static int make_gc_topic_packet(const GC_Chat *_Nonnull chat, uint8_t *_Nonnull data, uint16_t length) { if (length < SIGNATURE_SIZE + chat->topic_info.length + GC_MIN_PACKED_TOPIC_INFO_SIZE) { return -1; @@ -3593,7 +3593,7 @@ static int make_gc_topic_packet(non_null() const GC_Chat *chat, non_null() uint8 * * Returns true on success. */ -static bool send_peer_topic(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_peer_topic(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { const uint16_t packet_buf_size = SIGNATURE_SIZE + chat->topic_info.length + GC_MIN_PACKED_TOPIC_INFO_SIZE; uint8_t *packet = (uint8_t *)mem_balloc(chat->mem, packet_buf_size); @@ -3624,7 +3624,7 @@ static bool send_peer_topic(non_null() const GC_Chat *chat, non_null() GC_Connec * * Return true on success. */ -static bool send_peer_key_rotation_request(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_peer_key_rotation_request(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { // Only the peer closest to the chat_id sends requests. This is to prevent both peers from sending // requests at the same time and ending up with a different resulting shared key @@ -3659,7 +3659,7 @@ static bool send_peer_key_rotation_request(non_null() const GC_Chat *chat, non_n * * Returns true on success. */ -static bool broadcast_gc_topic(non_null() const GC_Chat *chat) +static bool broadcast_gc_topic(const GC_Chat *_Nonnull chat) { const uint16_t packet_buf_size = SIGNATURE_SIZE + chat->topic_info.length + GC_MIN_PACKED_TOPIC_INFO_SIZE; uint8_t *packet = (uint8_t *)mem_balloc(chat->mem, packet_buf_size); @@ -3782,7 +3782,7 @@ uint16_t gc_get_topic_size(const GC_Chat *chat) * * Returns true on success */ -static bool update_gc_topic(non_null() GC_Chat *chat, non_null() const uint8_t *public_sig_key) +static bool update_gc_topic(GC_Chat *_Nonnull chat, const uint8_t *_Nonnull public_sig_key) { if (memcmp(public_sig_key, chat->topic_info.public_sig_key, SIG_PUBLIC_KEY_SIZE) != 0) { return true; @@ -3796,7 +3796,7 @@ static bool update_gc_topic(non_null() GC_Chat *chat, non_null() const uint8_t * * * Return true if topic info is valid. */ -static bool handle_gc_topic_validate(non_null() const GC_Chat *chat, non_null() const GC_Peer *peer, non_null() const GC_TopicInfo *topic_info, bool topic_lock_enabled) +static bool handle_gc_topic_validate(const GC_Chat *_Nonnull chat, const GC_Peer *_Nonnull peer, const GC_TopicInfo *_Nonnull topic_info, bool topic_lock_enabled) { if (topic_info->checksum != get_gc_topic_checksum(topic_info)) { LOGGER_WARNING(chat->log, "received invalid topic checksum"); @@ -3854,8 +3854,8 @@ static bool handle_gc_topic_validate(non_null() const GC_Chat *chat, non_null() * Return 0 if packet is correctly handled. * Return -1 if packet has invalid size. */ -static int handle_gc_topic(non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() const GC_Peer *peer, non_null() const uint8_t *data, - uint16_t length, nullable() void *userdata) +static int handle_gc_topic(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, const GC_Peer *_Nonnull peer, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata) { if (length < SIGNATURE_SIZE + GC_MIN_PACKED_TOPIC_INFO_SIZE) { return -1; @@ -3910,7 +3910,7 @@ static int handle_gc_topic(non_null() const GC_Session *c, non_null() GC_Chat *c * Return -2 if we fail to create a new session keypair. * Return -3 if response packet fails to send. */ -static int handle_gc_key_exchange(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, non_null() const uint8_t *data, uint16_t length) +static int handle_gc_key_exchange(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nonnull data, uint16_t length) { if (length < 1 + ENC_PUBLIC_KEY_SIZE) { return -1; @@ -4040,7 +4040,7 @@ int gc_founder_set_password(GC_Chat *chat, const uint8_t *password, uint16_t pas * Return -3 if target peer is not a valid role (probably indicates sync issues). * Return -4 on validation failure. */ -static int validate_unpack_gc_set_mod(non_null() GC_Chat *chat, uint32_t peer_number, non_null() const uint8_t *data, uint16_t length, bool add_mod) +static int validate_unpack_gc_set_mod(GC_Chat *_Nonnull chat, uint32_t peer_number, const uint8_t *_Nonnull data, uint16_t length, bool add_mod) { int target_peer_number; uint8_t mod_data[MOD_LIST_ENTRY_SIZE]; @@ -4097,8 +4097,8 @@ static int validate_unpack_gc_set_mod(non_null() GC_Chat *chat, uint32_t peer_nu * Return -2 if the packet contains invalid data. * Return -3 if `peer_number` does not designate a valid peer. */ -static int handle_gc_set_mod(non_null() const GC_Session *c, non_null() GC_Chat *chat, uint32_t peer_number, non_null() const uint8_t *data, - uint16_t length, nullable() void *userdata) +static int handle_gc_set_mod(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, uint32_t peer_number, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata) { if (length < 1 + SIG_PUBLIC_KEY_SIZE) { return -1; @@ -4141,7 +4141,7 @@ static int handle_gc_set_mod(non_null() const GC_Session *c, non_null() GC_Chat * * Return true on success. */ -static bool send_gc_set_mod(non_null() const GC_Chat *chat, non_null() const GC_Connection *gconn, bool add_mod) +static bool send_gc_set_mod(const GC_Chat *_Nonnull chat, const GC_Connection *_Nonnull gconn, bool add_mod) { const uint16_t length = 1 + SIG_PUBLIC_KEY_SIZE; uint8_t *data = (uint8_t *)mem_balloc(chat->mem, length); @@ -4170,7 +4170,7 @@ static bool send_gc_set_mod(non_null() const GC_Chat *chat, non_null() const GC_ * * Returns true on success. */ -static bool founder_gc_set_moderator(non_null() GC_Chat *chat, non_null() const GC_Connection *gconn, bool add_mod) +static bool founder_gc_set_moderator(GC_Chat *_Nonnull chat, const GC_Connection *_Nonnull gconn, bool add_mod) { if (!self_gc_is_founder(chat)) { return false; @@ -4221,7 +4221,7 @@ static bool founder_gc_set_moderator(non_null() GC_Chat *chat, non_null() const * Return 0 if data is valid and sanctions list is successfully modified. * Return -1 if data is invalid format. */ -static int validate_unpack_observer_entry(non_null() GC_Chat *chat, non_null() const uint8_t *data, uint16_t length, non_null() const uint8_t *public_key, bool add_obs) +static int validate_unpack_observer_entry(GC_Chat *_Nonnull chat, const uint8_t *_Nonnull data, uint16_t length, const uint8_t *_Nonnull public_key, bool add_obs) { Mod_Sanction_Creds creds; @@ -4272,8 +4272,8 @@ static int validate_unpack_observer_entry(non_null() GC_Chat *chat, non_null() c * Return -2 if the packet contains invalid data. * Return -3 if `peer_number` does not designate a valid peer. */ -static int handle_gc_set_observer(non_null() const GC_Session *c, non_null() GC_Chat *chat, uint32_t peer_number, non_null() const uint8_t *data, - uint16_t length, nullable() void *userdata) +static int handle_gc_set_observer(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, uint32_t peer_number, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata) { if (length <= 1 + EXT_PUBLIC_KEY_SIZE) { return -1; @@ -4338,7 +4338,7 @@ static int handle_gc_set_observer(non_null() const GC_Session *c, non_null() GC_ * * Returns true on success. */ -static bool send_gc_set_observer(non_null() const GC_Chat *chat, non_null() const Extended_Public_Key *target_ext_pk, non_null() const uint8_t *sanction_data, uint16_t length, bool add_obs) +static bool send_gc_set_observer(const GC_Chat *_Nonnull chat, const Extended_Public_Key *_Nonnull target_ext_pk, const uint8_t *_Nonnull sanction_data, uint16_t length, bool add_obs) { const uint16_t packet_len = 1 + ENC_PUBLIC_KEY_SIZE + SIG_PUBLIC_KEY_SIZE + length; uint8_t *packet = (uint8_t *)mem_balloc(chat->mem, packet_len); @@ -4368,7 +4368,7 @@ static bool send_gc_set_observer(non_null() const GC_Chat *chat, non_null() cons * * Returns true on success. */ -static bool mod_gc_set_observer(non_null() GC_Chat *chat, uint32_t peer_number, bool add_obs) +static bool mod_gc_set_observer(GC_Chat *_Nonnull chat, uint32_t peer_number, bool add_obs) { const GC_Connection *gconn = get_gc_connection(chat, peer_number); @@ -4445,7 +4445,7 @@ static bool mod_gc_set_observer(non_null() GC_Chat *chat, uint32_t peer_number, * * Return true on success. */ -static bool apply_new_gc_role(non_null() GC_Chat *chat, uint32_t peer_number, Group_Role current_role, Group_Role new_role) +static bool apply_new_gc_role(GC_Chat *_Nonnull chat, uint32_t peer_number, Group_Role current_role, Group_Role new_role) { const GC_Connection *gconn = get_gc_connection(chat, peer_number); @@ -4555,7 +4555,7 @@ int gc_set_peer_role(const Messenger *m, int group_number, GC_Peer_Id peer_id, G } /** @brief Return true if topic lock is enabled */ -static bool group_topic_lock_enabled(non_null() const GC_Chat *chat) +static bool group_topic_lock_enabled(const GC_Chat *_Nonnull chat) { return chat->shared_state.topic_lock == GC_TOPIC_LOCK_ENABLED; } @@ -4802,8 +4802,8 @@ int gc_send_message(const GC_Chat *chat, const uint8_t *message, uint16_t length * Return 0 if packet is handled correctly. * Return -1 if packet has invalid size. */ -static int handle_gc_message(non_null() const GC_Session *c, non_null() const GC_Chat *chat, non_null() const GC_Peer *peer, non_null() const uint8_t *data, - uint16_t length, uint8_t type, nullable() void *userdata) +static int handle_gc_message(const GC_Session *_Nonnull c, const GC_Chat *_Nonnull chat, const GC_Peer *_Nonnull peer, const uint8_t *_Nonnull data, + uint16_t length, uint8_t type, void *_Nullable userdata) { if (data == nullptr || length > MAX_GC_MESSAGE_RAW_SIZE || length <= GC_MESSAGE_PSEUDO_ID_SIZE) { return -1; @@ -4902,8 +4902,8 @@ int gc_send_private_message(const GC_Chat *chat, GC_Peer_Id peer_id, uint8_t typ * Return 0 if packet is handled correctly. * Return -1 if packet has invalid size. */ -static int handle_gc_private_message(non_null() const GC_Session *c, non_null() const GC_Chat *chat, non_null() const GC_Peer *peer, non_null() const uint8_t *data, - uint16_t length, nullable() void *userdata) +static int handle_gc_private_message(const GC_Session *_Nonnull c, const GC_Chat *_Nonnull chat, const GC_Peer *_Nonnull peer, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata) { if (data == nullptr || length > MAX_GC_MESSAGE_SIZE || length <= 1 + GC_MESSAGE_PSEUDO_ID_SIZE) { return -1; @@ -4973,8 +4973,8 @@ int gc_send_custom_private_packet(const GC_Chat *chat, bool lossless, GC_Peer_Id * @retval 0 if packet is handled correctly. * @retval -1 if packet has invalid size. */ -static int handle_gc_custom_private_packet(non_null() const GC_Session *c, non_null() const GC_Chat *chat, non_null() const GC_Peer *peer, - non_null() const uint8_t *data, uint16_t length, bool lossless, nullable() void *userdata) +static int handle_gc_custom_private_packet(const GC_Session *_Nonnull c, const GC_Chat *_Nonnull chat, const GC_Peer *_Nonnull peer, + const uint8_t *_Nonnull data, uint16_t length, bool lossless, void *_Nullable userdata) { if (!custom_gc_packet_length_is_valid(length, lossless)) { return -1; @@ -5017,8 +5017,8 @@ int gc_send_custom_packet(const GC_Chat *chat, bool lossless, const uint8_t *dat * Return 0 if packet is handled correctly. * Return -1 if packet has invalid size. */ -static int handle_gc_custom_packet(non_null() const GC_Session *c, non_null() const GC_Chat *chat, non_null() const GC_Peer *peer, non_null() const uint8_t *data, - uint16_t length, bool lossless, nullable() void *userdata) +static int handle_gc_custom_packet(const GC_Session *_Nonnull c, const GC_Chat *_Nonnull chat, const GC_Peer *_Nonnull peer, const uint8_t *_Nonnull data, + uint16_t length, bool lossless, void *_Nullable userdata) { if (!custom_gc_packet_length_is_valid(length, lossless)) { return -1; @@ -5040,8 +5040,8 @@ static int handle_gc_custom_packet(non_null() const GC_Session *c, non_null() co * Return 0 if packet is handled correctly. * Return -1 if packet has invalid size. */ -static int handle_gc_kick_peer(non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() const GC_Peer *setter_peer, non_null() const uint8_t *data, - uint16_t length, nullable() void *userdata) +static int handle_gc_kick_peer(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, const GC_Peer *_Nonnull setter_peer, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata) { if (length < ENC_PUBLIC_KEY_SIZE) { return -1; @@ -5099,7 +5099,7 @@ static int handle_gc_kick_peer(non_null() const GC_Session *c, non_null() GC_Cha * * Returns true on success. */ -static bool send_gc_kick_peer(non_null() const GC_Chat *chat, non_null() const GC_Connection *gconn) +static bool send_gc_kick_peer(const GC_Chat *_Nonnull chat, const GC_Connection *_Nonnull gconn) { uint8_t packet[ENC_PUBLIC_KEY_SIZE]; memcpy(packet, gconn->addr.public_key.enc, ENC_PUBLIC_KEY_SIZE); @@ -5188,7 +5188,7 @@ bool gc_send_message_ack(const GC_Chat *chat, GC_Connection *gconn, uint64_t mes * Return -2 if we failed to handle the ack (may be caused by connection issues). * Return -3 if we failed to re-send a requested packet. */ -static int handle_gc_message_ack(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, non_null() const uint8_t *data, uint16_t length) +static int handle_gc_message_ack(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nonnull data, uint16_t length) { if (length < GC_LOSSLESS_ACK_PACKET_SIZE) { return -1; @@ -5234,7 +5234,7 @@ static int handle_gc_message_ack(non_null() const GC_Chat *chat, non_null() GC_C * * Return true on success. */ -static bool send_gc_hs_response_ack(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_gc_hs_response_ack(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { return send_lossless_group_packet(chat, gconn, nullptr, 0, GP_HS_RESPONSE_ACK); } @@ -5244,7 +5244,7 @@ static bool send_gc_hs_response_ack(non_null() const GC_Chat *chat, non_null() G * Return 0 if packet is handled correctly. * Return -1 if we failed to respond with an invite request. */ -static int handle_gc_hs_response_ack(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static int handle_gc_hs_response_ack(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { gconn->handshaked = true; // has to be true before we can send a lossless packet @@ -5280,8 +5280,8 @@ int gc_set_ignore(const GC_Chat *chat, GC_Peer_Id peer_id, bool ignore) * Returns 0 if packet is handled correctly. * Returns -1 on failure. */ -static int handle_gc_broadcast(non_null() const GC_Session *c, non_null() GC_Chat *chat, uint32_t peer_number, non_null() const uint8_t *data, - uint16_t length, nullable() void *userdata) +static int handle_gc_broadcast(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, uint32_t peer_number, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata) { if (length < GC_BROADCAST_ENC_HEADER_SIZE) { return -1; @@ -5374,8 +5374,8 @@ static int handle_gc_broadcast(non_null() const GC_Session *c, non_null() GC_Cha * Return -1 if length is invalid. * Return -2 if decryption fails. */ -static int unwrap_group_handshake_packet(non_null() const Logger *log, non_null() const Memory *mem, non_null() const uint8_t *self_sk, non_null() const uint8_t *sender_pk, non_null() uint8_t *plain, - size_t plain_size, non_null() const uint8_t *packet, uint16_t length) +static int unwrap_group_handshake_packet(const Logger *_Nonnull log, const Memory *_Nonnull mem, const uint8_t *_Nonnull self_sk, const uint8_t *_Nonnull sender_pk, uint8_t *_Nonnull plain, + size_t plain_size, const uint8_t *_Nonnull packet, uint16_t length) { if (length <= CRYPTO_NONCE_SIZE) { LOGGER_FATAL(log, "Invalid handshake packet length %u", length); @@ -5403,8 +5403,8 @@ static int unwrap_group_handshake_packet(non_null() const Logger *log, non_null( * Return -2 on memory allocation failure. * Return -3 if encryption fails. */ -static int wrap_group_handshake_packet(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Random *rng, non_null() const uint8_t *self_pk, non_null() const uint8_t *self_sk, - non_null() const uint8_t *target_pk, non_null() uint8_t *packet, uint32_t packet_size, non_null() const uint8_t *data, uint16_t length) +static int wrap_group_handshake_packet(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Random *_Nonnull rng, const uint8_t *_Nonnull self_pk, const uint8_t *_Nonnull self_sk, + const uint8_t *_Nonnull target_pk, uint8_t *_Nonnull packet, uint32_t packet_size, const uint8_t *_Nonnull data, uint16_t length) { if (packet_size != GC_MIN_ENCRYPTED_HS_PAYLOAD_SIZE + sizeof(Node_format)) { LOGGER_FATAL(log, "Invalid packet size: %u", packet_size); @@ -5448,8 +5448,8 @@ static int wrap_group_handshake_packet(non_null() const Logger *log, non_null() * Returns length of encrypted packet on success. * Returns -1 on failure. */ -static int make_gc_handshake_packet(non_null() const GC_Chat *chat, non_null() const GC_Connection *gconn, uint8_t handshake_type, uint8_t request_type, uint8_t join_type, non_null() uint8_t *packet, - size_t packet_size, non_null() const Node_format *node) +static int make_gc_handshake_packet(const GC_Chat *_Nonnull chat, const GC_Connection *_Nonnull gconn, uint8_t handshake_type, uint8_t request_type, uint8_t join_type, uint8_t *_Nonnull packet, + size_t packet_size, const Node_format *_Nonnull node) { if (chat == nullptr || gconn == nullptr || node == nullptr) { return -1; @@ -5500,7 +5500,7 @@ static int make_gc_handshake_packet(non_null() const GC_Chat *chat, non_null() c * * Returns true on success. */ -static bool send_gc_handshake_packet(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, uint8_t handshake_type, uint8_t request_type, uint8_t join_type) +static bool send_gc_handshake_packet(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, uint8_t handshake_type, uint8_t request_type, uint8_t join_type) { if (gconn == nullptr) { return false; @@ -5588,7 +5588,7 @@ static bool send_gc_oob_handshake_request(const GC_Chat *chat, const GC_Connecti * Returns peer_number of new connected peer on success. * Returns -1 on failure. */ -static int handle_gc_handshake_response(non_null() const GC_Chat *chat, non_null() const uint8_t *sender_pk, non_null() const uint8_t *data, uint16_t length) +static int handle_gc_handshake_response(const GC_Chat *_Nonnull chat, const uint8_t *_Nonnull sender_pk, const uint8_t *_Nonnull data, uint16_t length) { // this should be checked at lower level; this is a redundant defense check. Ideally we should // guarantee that this can never happen in the future. @@ -5652,7 +5652,7 @@ static int handle_gc_handshake_response(non_null() const GC_Chat *chat, non_null * * Return true on success. */ -static bool send_gc_handshake_response(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_gc_handshake_response(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { return send_gc_handshake_packet(chat, gconn, GH_RESPONSE, gconn->pending_handshake_type, 0); } @@ -5667,8 +5667,8 @@ static bool send_gc_handshake_response(non_null() const GC_Chat *chat, non_null( * Return -1 on failure. */ #define GC_NEW_PEER_CONNECTION_LIMIT 10 -static int handle_gc_handshake_request(non_null() GC_Chat *chat, nullable() const IP_Port *ipp, non_null() const uint8_t *sender_pk, - non_null() const uint8_t *data, uint16_t length) +static int handle_gc_handshake_request(GC_Chat *_Nonnull chat, const IP_Port *_Nullable ipp, const uint8_t *_Nonnull sender_pk, + const uint8_t *_Nonnull data, uint16_t length) { // this should be checked at lower level; this is a redundant defense check. Ideally we should // guarantee that this can never happen in the future. @@ -5791,8 +5791,8 @@ static int handle_gc_handshake_request(non_null() GC_Chat *chat, nullable() cons * Returns the peer_number of the connecting peer on success. * Returns -1 on failure. */ -static int handle_gc_handshake_packet(non_null() GC_Chat *chat, non_null() const uint8_t *sender_pk, nullable() const IP_Port *ipp, - non_null() const uint8_t *packet, uint16_t length, bool direct_conn, nullable() void *userdata) +static int handle_gc_handshake_packet(GC_Chat *_Nonnull chat, const uint8_t *_Nonnull sender_pk, const IP_Port *_Nullable ipp, + const uint8_t *_Nonnull packet, uint16_t length, bool direct_conn, void *_Nullable userdata) { if (length < GC_MIN_HS_PACKET_PAYLOAD_SIZE + CRYPTO_MAC_SIZE + CRYPTO_NONCE_SIZE) { return -1; @@ -5970,9 +5970,9 @@ bool handle_gc_lossless_helper(const GC_Session *c, GC_Chat *chat, uint32_t peer * * Return true if packet is handled successfully. */ -static bool handle_gc_packet_fragment(non_null() const GC_Session *c, non_null() GC_Chat *chat, uint32_t peer_number, non_null() GC_Connection *gconn, - nullable() const uint8_t *data, uint16_t length, uint8_t packet_type, uint64_t message_id, - nullable() void *userdata) +static bool handle_gc_packet_fragment(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, uint32_t peer_number, GC_Connection *_Nonnull gconn, + const uint8_t *_Nullable data, uint16_t length, uint8_t packet_type, uint64_t message_id, + void *_Nullable userdata) { if (gconn->last_chunk_id != 0 && message_id != gconn->last_chunk_id + 1) { return gc_send_message_ack(chat, gconn, gconn->last_chunk_id + 1, GR_ACK_REQ); @@ -6004,8 +6004,8 @@ static bool handle_gc_packet_fragment(non_null() const GC_Session *c, non_null() * * Returns true if packet is successfully handled. */ -static bool handle_gc_lossless_packet(non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() const uint8_t *sender_pk, - non_null() const uint8_t *packet, uint16_t length, bool direct_conn, nullable() void *userdata) +static bool handle_gc_lossless_packet(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, const uint8_t *_Nonnull sender_pk, + const uint8_t *_Nonnull packet, uint16_t length, bool direct_conn, void *_Nullable userdata) { if (length < GC_MIN_LOSSLESS_PAYLOAD_SIZE) { return false; @@ -6115,8 +6115,8 @@ static bool handle_gc_lossless_packet(non_null() const GC_Session *c, non_null() } static int handle_gc_lossy_packet_decoded( - non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() GC_Connection *gconn, non_null() const GC_Peer *peer, - uint8_t packet_type, non_null() const uint8_t *data, uint16_t payload_len, nullable() void *userdata) + const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const GC_Peer *_Nonnull peer, + uint8_t packet_type, const uint8_t *_Nonnull data, uint16_t payload_len, void *_Nullable userdata) { switch (packet_type) { case GP_MESSAGE_ACK: { @@ -6152,8 +6152,8 @@ static int handle_gc_lossy_packet_decoded( * * Return true if packet is handled successfully. */ -static bool handle_gc_lossy_packet(non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() const uint8_t *sender_pk, - non_null() const uint8_t *packet, uint16_t length, bool direct_conn, nullable() void *userdata) +static bool handle_gc_lossy_packet(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, const uint8_t *_Nonnull sender_pk, + const uint8_t *_Nonnull packet, uint16_t length, bool direct_conn, void *_Nullable userdata) { if (length < GC_MIN_LOSSY_PAYLOAD_SIZE) { return false; @@ -6215,7 +6215,7 @@ static bool handle_gc_lossy_packet(non_null() const GC_Session *c, non_null() GC } /** @brief Return true if group is either connected or attempting to connect. */ -static bool group_can_handle_packets(non_null() const GC_Chat *chat) +static bool group_can_handle_packets(const GC_Chat *_Nonnull chat) { const GC_Conn_State state = chat->connection_state; return state == CS_CONNECTING || state == CS_CONNECTED; @@ -6227,7 +6227,7 @@ static bool group_can_handle_packets(non_null() const GC_Chat *chat) * Returns -1 on failure. */ #define MIN_TCP_PACKET_SIZE (1 + ENC_PUBLIC_KEY_SIZE + CRYPTO_NONCE_SIZE + CRYPTO_MAC_SIZE) -static int handle_gc_tcp_packet(non_null() void *object, int crypt_connection_id, non_null() const uint8_t *packet, uint16_t length, nullable() void *userdata) +static int handle_gc_tcp_packet(void *_Nonnull object, int crypt_connection_id, const uint8_t *_Nonnull packet, uint16_t length, void *_Nullable userdata) { const Messenger *m = (Messenger *)object; if (m == nullptr) { @@ -6305,8 +6305,8 @@ static int handle_gc_tcp_packet(non_null() void *object, int crypt_connection_id } } -static int handle_gc_tcp_oob_packet(non_null() void *object, non_null() const uint8_t *public_key, unsigned int tcp_connections_number, - non_null() const uint8_t *packet, uint16_t length, nullable() void *userdata) +static int handle_gc_tcp_oob_packet(void *_Nonnull object, const uint8_t *_Nonnull public_key, unsigned int tcp_connections_number, + const uint8_t *_Nonnull packet, uint16_t length, void *_Nullable userdata) { const Messenger *m = (Messenger *)object; if (m == nullptr) { @@ -6359,8 +6359,8 @@ static int handle_gc_tcp_oob_packet(non_null() void *object, non_null() const ui } #define MIN_UDP_PACKET_SIZE (1 + ENC_PUBLIC_KEY_SIZE + CRYPTO_NONCE_SIZE + CRYPTO_MAC_SIZE) -static int handle_gc_udp_packet(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int handle_gc_udp_packet(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nullable userdata) { const Messenger *m = (Messenger *)object; if (m == nullptr) { @@ -6544,7 +6544,7 @@ void gc_callback_rejected(const Messenger *m, gc_rejected_cb *function) * * Return true on success. */ -static bool peer_delete(non_null() const GC_Session *c, non_null() GC_Chat *chat, uint32_t peer_number, nullable() void *userdata) +static bool peer_delete(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, uint32_t peer_number, void *_Nullable userdata) { GC_Peer *peer = get_gc_peer(chat, peer_number); if (peer == nullptr) { @@ -6727,7 +6727,7 @@ int peer_add(GC_Chat *chat, const IP_Port *ipp, const uint8_t *public_key) } /** @brief Copies own peer data to `peer`. */ -static void copy_self(non_null() const GC_Chat *chat, non_null() GC_Peer *peer) +static void copy_self(const GC_Chat *_Nonnull chat, GC_Peer *_Nonnull peer) { *peer = (GC_Peer) { 0 @@ -6742,7 +6742,7 @@ static void copy_self(non_null() const GC_Chat *chat, non_null() GC_Peer *peer) /** @brief Returns true if we haven't received a ping from this peer after n seconds. * n depends on whether or not the peer has been confirmed. */ -static bool peer_timed_out(non_null() const Mono_Time *mono_time, non_null() const GC_Connection *gconn) +static bool peer_timed_out(const Mono_Time *_Nonnull mono_time, const GC_Connection *_Nonnull gconn) { return mono_time_is_timeout(mono_time, gconn->last_received_packet_time, gconn->confirmed ? GC_CONFIRMED_PEER_TIMEOUT @@ -6755,7 +6755,7 @@ static bool peer_timed_out(non_null() const Mono_Time *mono_time, non_null() con * * Return true on success. */ -static bool send_pending_handshake(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool send_pending_handshake(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { if (chat == nullptr || gconn == nullptr) { return false; @@ -6785,7 +6785,7 @@ static bool send_pending_handshake(non_null() const GC_Chat *chat, non_null() GC } #define GC_TCP_RELAY_SEND_INTERVAL (60 * 3) -static void do_peer_connections(non_null() const GC_Session *c, non_null() GC_Chat *chat, nullable() void *userdata) +static void do_peer_connections(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, void *_Nullable userdata) { for (uint32_t i = 1; i < chat->numpeers; ++i) { GC_Connection *gconn = get_gc_connection(chat, i); @@ -6820,7 +6820,7 @@ static void do_peer_connections(non_null() const GC_Session *c, non_null() GC_Ch * load peers from our saved peers list and initiate handshake requests with them. */ #define LOAD_PEERS_TIMEOUT (GC_UNCONFIRMED_PEER_TIMEOUT + 10) -static void do_handshakes(non_null() GC_Chat *chat) +static void do_handshakes(GC_Chat *_Nonnull chat) { for (uint32_t i = 1; i < chat->numpeers; ++i) { GC_Connection *gconn = get_gc_connection(chat, i); @@ -6844,7 +6844,7 @@ static void do_handshakes(non_null() GC_Chat *chat) } /** @brief Adds `gconn` to the group timeout list. */ -static void add_gc_peer_timeout_list(non_null() GC_Chat *chat, non_null() const GC_Connection *gconn) +static void add_gc_peer_timeout_list(GC_Chat *_Nonnull chat, const GC_Connection *_Nonnull gconn) { const size_t idx = chat->timeout_list_index; const uint64_t tm = mono_time_get(chat->mono_time); @@ -6856,7 +6856,7 @@ static void add_gc_peer_timeout_list(non_null() GC_Chat *chat, non_null() const chat->timeout_list_index = (idx + 1) % MAX_GC_SAVED_TIMEOUTS; } -static void do_peer_delete(non_null() const GC_Session *c, non_null() GC_Chat *chat, nullable() void *userdata) +static void do_peer_delete(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, void *_Nullable userdata) { for (uint32_t i = 1; i < chat->numpeers; ++i) { GC_Connection *gconn = get_gc_connection(chat, i); @@ -6892,7 +6892,7 @@ static void do_peer_delete(non_null() const GC_Session *c, non_null() GC_Chat *c * * Return true on success. */ -static bool ping_peer(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn) +static bool ping_peer(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn) { const uint16_t buf_size = GC_PING_PACKET_MIN_DATA_SIZE + sizeof(IP_Port); uint8_t *data = (uint8_t *)mem_balloc(chat->mem, buf_size); @@ -6960,7 +6960,7 @@ static bool ping_peer(non_null() const GC_Chat *chat, non_null() GC_Connection * * do not have a direct connection with. */ #define GC_DO_PINGS_INTERVAL 2 -static void do_gc_ping_and_key_rotation(non_null() GC_Chat *chat) +static void do_gc_ping_and_key_rotation(GC_Chat *_Nonnull chat) { if (!mono_time_is_timeout(chat->mono_time, chat->last_ping_interval, GC_DO_PINGS_INTERVAL)) { return; @@ -6992,7 +6992,7 @@ static void do_gc_ping_and_key_rotation(non_null() GC_Chat *chat) chat->last_ping_interval = tm; } -static void do_new_connection_cooldown(non_null() GC_Chat *chat) +static void do_new_connection_cooldown(GC_Chat *_Nonnull chat) { if (chat->connection_o_metre == 0) { return; @@ -7012,7 +7012,7 @@ static void do_new_connection_cooldown(non_null() GC_Chat *chat) } #define TCP_RELAYS_CHECK_INTERVAL 10 -static void do_gc_tcp(non_null() const GC_Session *c, non_null() GC_Chat *chat, nullable() void *userdata) +static void do_gc_tcp(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, void *_Nullable userdata) { if (chat->tcp_conn == nullptr || !group_can_handle_packets(chat)) { return; @@ -7042,7 +7042,7 @@ static void do_gc_tcp(non_null() const GC_Session *c, non_null() GC_Chat *chat, */ #define GC_SELF_CONNECTION_CHECK_INTERVAL 5 // how often in seconds we should run this function #define GC_SELF_REFRESH_ANNOUNCE_INTERVAL (60 * 20) // how often in seconds we force refresh our group announcement -static void do_self_connection(non_null() const GC_Session *c, non_null() GC_Chat *chat) +static void do_self_connection(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat) { if (!mono_time_is_timeout(chat->mono_time, chat->last_self_announce_check, GC_SELF_CONNECTION_CHECK_INTERVAL)) { return; @@ -7070,7 +7070,7 @@ static void do_self_connection(non_null() const GC_Session *c, non_null() GC_Cha * should automatically do this for us. */ #define TIMED_OUT_RECONN_INTERVAL 2 -static void do_timed_out_reconn(non_null() GC_Chat *chat) +static void do_timed_out_reconn(GC_Chat *_Nonnull chat) { if (is_public_chat(chat)) { return; @@ -7152,7 +7152,7 @@ void do_gc(GC_Session *c, void *userdata) * * Return true on success. */ -static bool realloc_groupchats(non_null() const Memory *mem, non_null() GC_Session *c, uint32_t n) +static bool realloc_groupchats(const Memory *_Nonnull mem, GC_Session *_Nonnull c, uint32_t n) { if (n == 0) { mem_delete(mem, c->chats); @@ -7170,7 +7170,7 @@ static bool realloc_groupchats(non_null() const Memory *mem, non_null() GC_Sessi return true; } -static int get_new_group_index(non_null() const Memory *mem, non_null() GC_Session *c) +static int get_new_group_index(const Memory *_Nonnull mem, GC_Session *_Nonnull c) { if (c == nullptr) { return -1; @@ -7225,7 +7225,7 @@ static void add_tcp_relays_to_chat(const GC_Session *c, GC_Chat *chat) mem_delete(chat->mem, tcp_relays); } -static bool init_gc_tcp_connection(non_null() const GC_Session *c, non_null() GC_Chat *chat) +static bool init_gc_tcp_connection(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat) { const Messenger *m = c->messenger; @@ -7245,7 +7245,7 @@ static bool init_gc_tcp_connection(non_null() const GC_Session *c, non_null() GC } /** Initializes default shared state values. */ -static void init_gc_shared_state(non_null() GC_Chat *chat, Group_Privacy_State privacy_state) +static void init_gc_shared_state(GC_Chat *_Nonnull chat, Group_Privacy_State privacy_state) { chat->shared_state.maxpeers = MAX_GC_PEERS_DEFAULT; chat->shared_state.privacy_state = privacy_state; @@ -7257,7 +7257,7 @@ static void init_gc_shared_state(non_null() GC_Chat *chat, Group_Privacy_State p * * Return true on success. */ -static bool init_gc_shared_state_founder(non_null() GC_Chat *chat, Group_Privacy_State privacy_state, non_null() const uint8_t *group_name, uint16_t name_length) +static bool init_gc_shared_state_founder(GC_Chat *_Nonnull chat, Group_Privacy_State privacy_state, const uint8_t *_Nonnull group_name, uint16_t name_length) { chat->shared_state.founder_public_key = chat->self_public_key; memcpy(chat->shared_state.group_name, group_name, name_length); @@ -7272,7 +7272,7 @@ static bool init_gc_shared_state_founder(non_null() GC_Chat *chat, Group_Privacy * This must be called before any moderation * or sanctions related operations. */ -static void init_gc_moderation(non_null() GC_Chat *chat) +static void init_gc_moderation(GC_Chat *_Nonnull chat) { memcpy(chat->moderation.founder_public_sig_key, get_sig_pk(&chat->shared_state.founder_public_key), SIG_PUBLIC_KEY_SIZE); @@ -7283,9 +7283,9 @@ static void init_gc_moderation(non_null() GC_Chat *chat) chat->moderation.mem = chat->mem; } -static bool create_new_chat_ext_keypair(non_null() GC_Chat *chat); +static bool create_new_chat_ext_keypair(GC_Chat *_Nonnull chat); -static int create_new_group(non_null() const Memory *mem, non_null() GC_Session *c, non_null() const uint8_t *nick, size_t nick_length, bool founder, const Group_Privacy_State privacy_state) +static int create_new_group(const Memory *_Nonnull mem, GC_Session *_Nonnull c, const uint8_t *_Nonnull nick, size_t nick_length, bool founder, const Group_Privacy_State privacy_state) { if (nick == nullptr || nick_length == 0) { return -1; @@ -7358,7 +7358,7 @@ static int create_new_group(non_null() const Memory *mem, non_null() GC_Session * * Return true on success. */ -static bool init_gc_sanctions_creds(non_null() GC_Chat *chat) +static bool init_gc_sanctions_creds(GC_Chat *_Nonnull chat) { return sanctions_list_make_creds(&chat->moderation); } @@ -7738,7 +7738,7 @@ int gc_invite_friend(const GC_Session *c, GC_Chat *chat, int32_t friend_number, * Return -2 if `chat `is null. * Return -3 if packet failed to send. */ -static int send_gc_invite_accepted_packet(non_null() const Messenger *m, non_null() const GC_Chat *chat, uint32_t friend_number) +static int send_gc_invite_accepted_packet(const Messenger *_Nonnull m, const GC_Chat *_Nonnull chat, uint32_t friend_number) { if (!friend_is_valid(m, friend_number)) { return -1; @@ -7774,7 +7774,7 @@ static int send_gc_invite_accepted_packet(non_null() const Messenger *m, non_nul * * Return true on success. */ -static bool send_gc_invite_confirmed_packet(non_null() const Messenger *m, non_null() const GC_Chat *chat, uint32_t friend_number, non_null() const uint8_t *data, uint16_t length) +static bool send_gc_invite_confirmed_packet(const Messenger *_Nonnull m, const GC_Chat *_Nonnull chat, uint32_t friend_number, const uint8_t *_Nonnull data, uint16_t length) { if (!friend_is_valid(m, friend_number)) { return false; @@ -7814,7 +7814,7 @@ static bool send_gc_invite_confirmed_packet(non_null() const Messenger *m, non_n * * Returns the number of relays successfully added. */ -static uint32_t add_gc_tcp_relays(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, non_null() const Node_format *tcp_relays, size_t num_nodes) +static uint32_t add_gc_tcp_relays(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const Node_format *_Nonnull tcp_relays, size_t num_nodes) { uint32_t relays_added = 0; @@ -7833,7 +7833,7 @@ static uint32_t add_gc_tcp_relays(non_null() const GC_Chat *chat, non_null() GC_ return relays_added; } -static bool copy_friend_ip_port_to_gconn(non_null() const Messenger *m, int friend_number, non_null() GC_Connection *gconn) +static bool copy_friend_ip_port_to_gconn(const Messenger *_Nonnull m, int friend_number, GC_Connection *_Nonnull gconn) { if (!friend_is_valid(m, friend_number)) { return false; @@ -7914,7 +7914,7 @@ int handle_gc_invite_confirmed_packet(const GC_Session *c, int friend_number, co } /** Return true if we have a pending sent invite for our friend designated by `friend_number`. */ -static bool friend_was_invited(non_null() const Messenger *m, non_null() GC_Chat *chat, int friend_number) +static bool friend_was_invited(const Messenger *_Nonnull m, GC_Chat *_Nonnull chat, int friend_number) { for (size_t i = 0; i < MAX_GC_SAVED_INVITES; ++i) { if (chat->saved_invites[i] == friend_number) { @@ -8053,8 +8053,8 @@ int gc_accept_invite(GC_Session *c, int32_t friend_number, const uint8_t *data, return group_number; } -static bool gc_handle_announce_response_callback(non_null() Onion_Client *onion_c, uint32_t sendback_num, non_null() const uint8_t *data, - size_t data_length, nullable() void *user_data); +static bool gc_handle_announce_response_callback(Onion_Client *_Nonnull onion_c, uint32_t sendback_num, const uint8_t *_Nonnull data, + size_t data_length, void *_Nullable user_data); GC_Session *new_dht_groupchats(Messenger *m) { if (m == nullptr) { @@ -8140,7 +8140,7 @@ int gc_group_exit(GC_Session *c, GC_Chat *chat, const uint8_t *message, uint16_t return group_can_handle_packets(chat) ? send_gc_self_exit(chat, message, length) : 0; } -static int kill_group(non_null() GC_Session *c, non_null() GC_Chat *chat) +static int kill_group(GC_Session *_Nonnull c, GC_Chat *_Nonnull chat) { const int ret = gc_group_exit(c, chat, nullptr, 0); group_delete(c, chat); @@ -8255,7 +8255,7 @@ static void create_gc_session_keypair(const Logger *log, const Random *rng, uint * * Return false if key generation fails. */ -static bool create_new_chat_ext_keypair(non_null() GC_Chat *chat) +static bool create_new_chat_ext_keypair(GC_Chat *_Nonnull chat) { crypto_memlock(&chat->self_secret_key, sizeof(chat->self_secret_key)); @@ -8308,7 +8308,7 @@ static bool gc_handle_announce_response_callback(Onion_Client *onion_c, uint32_t * * Returns the number of relays successfully added. */ -static uint32_t add_gc_tcp_relays_from_announce(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, non_null() const GC_Announce *announce) +static uint32_t add_gc_tcp_relays_from_announce(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const GC_Announce *_Nonnull announce) { uint32_t added_relays = 0; diff --git a/toxcore/group_chats.h b/toxcore/group_chats.h index 2072ed6a8..ef051e756 100644 --- a/toxcore/group_chats.h +++ b/toxcore/group_chats.h @@ -115,10 +115,10 @@ typedef enum Group_Message_Ack_Type { /** @brief Returns the GC_Connection object associated with `peer_number`. * Returns null if peer_number does not designate a valid peer. */ -GC_Connection *get_gc_connection(non_null() const GC_Chat *chat, int peer_number); +GC_Connection *_Nullable get_gc_connection(const GC_Chat *_Nonnull chat, int peer_number); /** @brief Returns the jenkins hash of a 32 byte public encryption key. */ -uint32_t gc_get_pk_jenkins_hash(non_null() const uint8_t *public_key); +uint32_t gc_get_pk_jenkins_hash(const uint8_t *_Nonnull public_key); /** @brief Check if peer with the public encryption key is in peer list. * @@ -127,7 +127,7 @@ uint32_t gc_get_pk_jenkins_hash(non_null() const uint8_t *public_key); * * If `confirmed` is true the peer number will only be returned if the peer is confirmed. */ -int get_peer_number_of_enc_pk(non_null() const GC_Chat *chat, non_null() const uint8_t *public_enc_key, bool confirmed); +int get_peer_number_of_enc_pk(const GC_Chat *_Nonnull chat, const uint8_t *_Nonnull public_enc_key, bool confirmed); /** @brief Encrypts `data` of size `length` using the peer's shared key and a new nonce. * @@ -140,8 +140,8 @@ int get_peer_number_of_enc_pk(non_null() const GC_Chat *chat, non_null() const u * Return -3 if encryption fails. */ int group_packet_wrap( - non_null() const Logger *log, non_null() const Memory *mem, non_null() const Random *rng, non_null() const uint8_t *self_pk, non_null() const uint8_t *shared_key, non_null() uint8_t *packet, - uint16_t packet_size, nullable() const uint8_t *data, uint16_t length, uint64_t message_id, + const Logger *_Nonnull log, const Memory *_Nonnull mem, const Random *_Nonnull rng, const uint8_t *_Nonnull self_pk, const uint8_t *_Nonnull shared_key, uint8_t *_Nonnull packet, + uint16_t packet_size, const uint8_t *_Nullable data, uint16_t length, uint64_t message_id, uint8_t gp_packet_type, Net_Packet_Type net_packet_type); /** @brief Returns the size of a wrapped/encrypted packet with a plain size of `length`. * @@ -161,8 +161,8 @@ uint16_t gc_get_wrapped_packet_size(uint16_t length, Net_Packet_Type packet_type * Returns -4 if the sender does not have permission to speak. * Returns -5 if the packet fails to send. */ -int gc_send_message(non_null() const GC_Chat *chat, non_null() const uint8_t *message, uint16_t length, uint8_t type, - nullable() uint32_t *message_id); +int gc_send_message(const GC_Chat *_Nonnull chat, const uint8_t *_Nonnull message, uint16_t length, uint8_t type, + uint32_t *_Nullable message_id); /** @brief Sends a private message to peer_id. * * `length` must not exceed MAX_GC_MESSAGE_SIZE and must not be equal to zero. @@ -175,8 +175,8 @@ int gc_send_message(non_null() const GC_Chat *chat, non_null() const uint8_t *me * Returns -5 if the sender has the observer role. * Returns -6 if the packet fails to send. */ -int gc_send_private_message(non_null() const GC_Chat *chat, GC_Peer_Id peer_id, uint8_t type, non_null() const uint8_t *message, - uint16_t length, nullable() uint32_t *message_id); +int gc_send_private_message(const GC_Chat *_Nonnull chat, GC_Peer_Id peer_id, uint8_t type, const uint8_t *_Nonnull message, + uint16_t length, uint32_t *_Nullable message_id); /** @brief Sends a custom packet to the group. If lossless is true, the packet will be lossless. * * `length` must not exceed MAX_GC_MESSAGE_SIZE and must not be equal to zero. @@ -186,7 +186,7 @@ int gc_send_private_message(non_null() const GC_Chat *chat, GC_Peer_Id peer_id, * Returns -2 if the message pointer is NULL or length is zero. * Returns -3 if the packet did not successfully send to any peer. */ -int gc_send_custom_packet(non_null() const GC_Chat *chat, bool lossless, non_null() const uint8_t *data, uint16_t length); +int gc_send_custom_packet(const GC_Chat *_Nonnull chat, bool lossless, const uint8_t *_Nonnull data, uint16_t length); /** @brief Sends a custom private packet to the peer designated by peer_id. * @@ -198,7 +198,7 @@ int gc_send_custom_packet(non_null() const GC_Chat *chat, bool lossless, non_nul * @retval -3 if the supplied peer_id does not designate a valid peer. * @retval -4 if the packet fails to send. */ -int gc_send_custom_private_packet(non_null() const GC_Chat *chat, bool lossless, GC_Peer_Id peer_id, non_null() const uint8_t *message, uint16_t length); +int gc_send_custom_private_packet(const GC_Chat *_Nonnull chat, bool lossless, GC_Peer_Id peer_id, const uint8_t *_Nonnull message, uint16_t length); /** @brief Sets ignore for peer_id. * @@ -206,7 +206,7 @@ int gc_send_custom_private_packet(non_null() const GC_Chat *chat, bool lossless, * Returns -1 if the peer_id is invalid. * Returns -2 if the caller attempted to ignore himself. */ -int gc_set_ignore(non_null() const GC_Chat *chat, GC_Peer_Id peer_id, bool ignore); +int gc_set_ignore(const GC_Chat *_Nonnull chat, GC_Peer_Id peer_id, bool ignore); /** @brief Sets the group topic and broadcasts it to the group. * @@ -218,29 +218,29 @@ int gc_set_ignore(non_null() const GC_Chat *chat, GC_Peer_Id peer_id, bool ignor * Returns -3 if the packet cannot be created or signing fails. * Returns -4 if the packet fails */ -int gc_set_topic(non_null() GC_Chat *chat, nullable() const uint8_t *topic, uint16_t length); +int gc_set_topic(GC_Chat *_Nonnull chat, const uint8_t *_Nullable topic, uint16_t length); /** @brief Copies the group topic to `topic`. If topic is null this function has no effect. * * Call `gc_get_topic_size` to determine the allocation size for the `topic` parameter. * * The data written to `topic` is equal to the data received by the last topic callback. */ -void gc_get_topic(non_null() const GC_Chat *chat, nullable() uint8_t *topic); +void gc_get_topic(const GC_Chat *_Nonnull chat, uint8_t *_Nullable topic); /** @brief Returns the topic length. * * The return value is equal to the `length` agument received by the last topic callback. */ -uint16_t gc_get_topic_size(non_null() const GC_Chat *chat); +uint16_t gc_get_topic_size(const GC_Chat *_Nonnull chat); /** @brief Copies group name to `group_name`. If `group_name` is null this function has no effect. * * Call `gc_get_group_name_size` to determine the allocation size for the `group_name` * parameter. */ -void gc_get_group_name(non_null() const GC_Chat *chat, non_null() uint8_t *group_name); +void gc_get_group_name(const GC_Chat *_Nonnull chat, uint8_t *_Nonnull group_name); /** @brief Returns the group name length. */ -uint16_t gc_get_group_name_size(non_null() const GC_Chat *chat); +uint16_t gc_get_group_name_size(const GC_Chat *_Nonnull chat); /** @brief Copies the group password to password. * @@ -251,34 +251,34 @@ uint16_t gc_get_group_name_size(non_null() const GC_Chat *chat); * * The data received is equal to the data received by the last password callback. */ -void gc_get_password(non_null() const GC_Chat *chat, non_null() uint8_t *password); +void gc_get_password(const GC_Chat *_Nonnull chat, uint8_t *_Nonnull password); /** @brief Returns the group password length. */ -uint16_t gc_get_password_size(non_null() const GC_Chat *chat); +uint16_t gc_get_password_size(const GC_Chat *_Nonnull chat); /** @brief Returns the group privacy state. * * The value returned is equal to the data receieved by the last privacy_state callback. */ -Group_Privacy_State gc_get_privacy_state(non_null() const GC_Chat *chat); +Group_Privacy_State gc_get_privacy_state(const GC_Chat *_Nonnull chat); /** @brief Returns the group topic lock state. * * The value returned is equal to the data received by the last last topic_lock callback. */ -Group_Topic_Lock gc_get_topic_lock_state(non_null() const GC_Chat *chat); +Group_Topic_Lock gc_get_topic_lock_state(const GC_Chat *_Nonnull chat); /** @brief Returns the group voice state. * * The value returned is equal to the data received by the last voice_state callback. */ -Group_Voice_State gc_get_voice_state(non_null() const GC_Chat *chat); +Group_Voice_State gc_get_voice_state(const GC_Chat *_Nonnull chat); /** @brief Returns the group peer limit. * * The value returned is equal to the data receieved by the last peer_limit callback. */ -uint16_t gc_get_max_peers(non_null() const GC_Chat *chat); +uint16_t gc_get_max_peers(const GC_Chat *_Nonnull chat); /** @brief Sets your own nick to `nick`. * @@ -291,28 +291,28 @@ uint16_t gc_get_max_peers(non_null() const GC_Chat *chat); * Returns -3 if the length is zero or nick is a NULL pointer. * Returns -4 if the packet fails to send. */ -int gc_set_self_nick(non_null() const Messenger *m, int group_number, non_null() const uint8_t *nick, uint16_t length); +int gc_set_self_nick(const Messenger *_Nonnull m, int group_number, const uint8_t *_Nonnull nick, uint16_t length); /** @brief Copies your own name to `nick`. * * If `nick` is null this function has no effect. */ -void gc_get_self_nick(non_null() const GC_Chat *chat, non_null() uint8_t *nick); +void gc_get_self_nick(const GC_Chat *_Nonnull chat, uint8_t *_Nonnull nick); /** @brief Return your own nick length. * * If no nick was set before calling this function it will return 0. */ -uint16_t gc_get_self_nick_size(non_null() const GC_Chat *chat); +uint16_t gc_get_self_nick_size(const GC_Chat *_Nonnull chat); /** @brief Returns your own group role. */ -Group_Role gc_get_self_role(non_null() const GC_Chat *chat); +Group_Role gc_get_self_role(const GC_Chat *_Nonnull chat); /** @brief Return your own status. */ -uint8_t gc_get_self_status(non_null() const GC_Chat *chat); +uint8_t gc_get_self_status(const GC_Chat *_Nonnull chat); /** @brief Returns your own peer id. */ -GC_Peer_Id gc_get_self_peer_id(non_null() const GC_Chat *chat); +GC_Peer_Id gc_get_self_peer_id(const GC_Chat *_Nonnull chat); /** @brief Copies self public key to `public_key`. * @@ -322,7 +322,7 @@ GC_Peer_Id gc_get_self_peer_id(non_null() const GC_Chat *chat); * exit the group. This key is the only way for other peers to reliably identify * us across client restarts. */ -void gc_get_self_public_key(non_null() const GC_Chat *chat, nullable() uint8_t *public_key); +void gc_get_self_public_key(const GC_Chat *_Nonnull chat, uint8_t *_Nullable public_key); /** @brief Copies nick designated by `peer_id` to `name`. * * Call `gc_get_peer_nick_size` to determine the allocation size for the `name` parameter. @@ -332,14 +332,14 @@ void gc_get_self_public_key(non_null() const GC_Chat *chat, nullable() uint8_t * * Returns true on success. * Returns false if peer_id is invalid. */ -bool gc_get_peer_nick(non_null() const GC_Chat *chat, GC_Peer_Id peer_id, nullable() uint8_t *name); +bool gc_get_peer_nick(const GC_Chat *_Nonnull chat, GC_Peer_Id peer_id, uint8_t *_Nullable name); /** @brief Returns the length of the nick for the peer designated by `peer_id`. * Returns -1 if peer_id is invalid. * * The value returned is equal to the `length` argument received by the last * nick_change callback. */ -int gc_get_peer_nick_size(non_null() const GC_Chat *chat, GC_Peer_Id peer_id); +int gc_get_peer_nick_size(const GC_Chat *_Nonnull chat, GC_Peer_Id peer_id); /** @brief Copies peer_id's public key to `public_key`. * @@ -353,11 +353,11 @@ int gc_get_peer_nick_size(non_null() const GC_Chat *chat, GC_Peer_Id peer_id); * Returns -1 if peer_id is invalid or doesn't correspond to a valid peer connection. * Returns -2 if `public_key` is null. */ -int gc_get_peer_public_key_by_peer_id(non_null() const GC_Chat *chat, GC_Peer_Id peer_id, nullable() uint8_t *public_key); +int gc_get_peer_public_key_by_peer_id(const GC_Chat *_Nonnull chat, GC_Peer_Id peer_id, uint8_t *_Nullable public_key); /** @brief Returns the length of the IP address for the peer designated by `peer_id`. * Returns -1 if peer_id is invalid. */ -int gc_get_peer_ip_address_size(non_null() const GC_Chat *chat, GC_Peer_Id peer_id); +int gc_get_peer_ip_address_size(const GC_Chat *_Nonnull chat, GC_Peer_Id peer_id); /** @brief Copies peer_id's IP address to `ip_addr`. * @@ -373,7 +373,7 @@ int gc_get_peer_ip_address_size(non_null() const GC_Chat *chat, GC_Peer_Id peer_ * Returns -1 if peer_id is invalid or doesn't correspond to a valid peer connection. * Returns -2 if `ip_addr` is null. */ -int gc_get_peer_ip_address(non_null() const GC_Chat *chat, GC_Peer_Id peer_id, nullable() uint8_t *ip_addr); +int gc_get_peer_ip_address(const GC_Chat *_Nonnull chat, GC_Peer_Id peer_id, uint8_t *_Nullable ip_addr); /** @brief Gets the connection status for peer associated with `peer_id`. * * If `peer_id` designates ourself, the return value indicates whether we're capable @@ -385,7 +385,7 @@ int gc_get_peer_ip_address(non_null() const GC_Chat *chat, GC_Peer_Id peer_id, n * * Note: Return values must correspond to Tox_Connection enum in API. */ -unsigned int gc_get_peer_connection_status(non_null() const GC_Chat *chat, GC_Peer_Id peer_id); +unsigned int gc_get_peer_connection_status(const GC_Chat *_Nonnull chat, GC_Peer_Id peer_id); /** @brief Sets the caller's status to `status`. * @@ -393,7 +393,7 @@ unsigned int gc_get_peer_connection_status(non_null() const GC_Chat *chat, GC_Pe * Returns -1 if the group_number is invalid. * Returns -2 if the packet failed to send. */ -int gc_set_self_status(non_null() const Messenger *m, int group_number, Group_Peer_Status status); +int gc_set_self_status(const Messenger *_Nonnull m, int group_number, Group_Peer_Status status); /** @brief Returns the status of peer designated by `peer_id`. * Returns UINT8_MAX on failure. @@ -401,14 +401,14 @@ int gc_set_self_status(non_null() const Messenger *m, int group_number, Group_Pe * The status returned is equal to the last status received through the status_change * callback. */ -uint8_t gc_get_status(non_null() const GC_Chat *chat, GC_Peer_Id peer_id); +uint8_t gc_get_status(const GC_Chat *_Nonnull chat, GC_Peer_Id peer_id); /** @brief Returns the group role of peer designated by `peer_id`. * Returns UINT8_MAX on failure. * * The role returned is equal to the last role received through the moderation callback. */ -uint8_t gc_get_role(non_null() const GC_Chat *chat, GC_Peer_Id peer_id); +uint8_t gc_get_role(const GC_Chat *_Nonnull chat, GC_Peer_Id peer_id); /** @brief Sets the role of peer_id. role must be one of: GR_MODERATOR, GR_USER, GR_OBSERVER * @@ -420,7 +420,7 @@ uint8_t gc_get_role(non_null() const GC_Chat *chat, GC_Peer_Id peer_id); * Returns -5 if the role failed to be set. * Returns -6 if the caller attempted to kick himself. */ -int gc_set_peer_role(non_null() const Messenger *m, int group_number, GC_Peer_Id peer_id, Group_Role new_role); +int gc_set_peer_role(const Messenger *_Nonnull m, int group_number, GC_Peer_Id peer_id, Group_Role new_role); /** @brief Sets the group password and distributes the new shared state to the group. * @@ -434,7 +434,7 @@ int gc_set_peer_role(non_null() const Messenger *m, int group_number, GC_Peer_Id * Returns -3 if the packet failed to send. * Returns -4 if malloc failed. */ -int gc_founder_set_password(non_null() GC_Chat *chat, nullable() const uint8_t *password, uint16_t password_length); +int gc_founder_set_password(GC_Chat *_Nonnull chat, const uint8_t *_Nullable password, uint16_t password_length); /** @brief Sets the topic lock and distributes the new shared state to the group. * * When the topic lock is enabled, only the group founder and moderators may set the topic. @@ -450,7 +450,7 @@ int gc_founder_set_password(non_null() GC_Chat *chat, nullable() const uint8_t * * Returns -5 if the topic lock could not be set. * Returns -6 if the packet failed to send. */ -int gc_founder_set_topic_lock(non_null() const Messenger *m, int group_number, Group_Topic_Lock new_lock_state); +int gc_founder_set_topic_lock(const Messenger *_Nonnull m, int group_number, Group_Topic_Lock new_lock_state); /** @brief Sets the group privacy state and distributes the new shared state to the group. * @@ -466,7 +466,7 @@ int gc_founder_set_topic_lock(non_null() const Messenger *m, int group_number, G * Returns -4 if the privacy state could not be set. * Returns -5 if the packet failed to send. */ -int gc_founder_set_privacy_state(non_null() const Messenger *m, int group_number, Group_Privacy_State new_privacy_state); +int gc_founder_set_privacy_state(const Messenger *_Nonnull m, int group_number, Group_Privacy_State new_privacy_state); /** @brief Sets the group voice state and distributes the new shared state to the group. * @@ -482,7 +482,7 @@ int gc_founder_set_privacy_state(non_null() const Messenger *m, int group_number * Returns -4 if the voice state could not be set. * Returns -5 if the packet failed to send. */ -int gc_founder_set_voice_state(non_null() const Messenger *m, int group_number, Group_Voice_State new_voice_state); +int gc_founder_set_voice_state(const Messenger *_Nonnull m, int group_number, Group_Voice_State new_voice_state); /** @brief Sets the peer limit to maxpeers and distributes the new shared state to the group. * @@ -493,7 +493,7 @@ int gc_founder_set_voice_state(non_null() const Messenger *m, int group_number, * Returns -2 if the peer limit could not be set. * Returns -3 if the packet failed to send. */ -int gc_founder_set_max_peers(non_null() GC_Chat *chat, uint16_t max_peers); +int gc_founder_set_max_peers(GC_Chat *_Nonnull chat, uint16_t max_peers); /** @brief Removes peer designated by `peer_id` from peer list and sends a broadcast instructing * all other peers to remove the peer from their peerlist as well. @@ -508,42 +508,42 @@ int gc_founder_set_max_peers(non_null() GC_Chat *chat, uint16_t max_peers); * Returns -5 if the packet failed to send. * Returns -6 if the caller attempted to kick himself. */ -int gc_kick_peer(non_null() const Messenger *m, int group_number, GC_Peer_Id peer_id); +int gc_kick_peer(const Messenger *_Nonnull m, int group_number, GC_Peer_Id peer_id); /** @brief Copies the chat_id to dest. If dest is null this function has no effect. * * `dest` should have room for at least CHAT_ID_SIZE bytes. */ -void gc_get_chat_id(non_null() const GC_Chat *chat, nullable() uint8_t *dest); +void gc_get_chat_id(const GC_Chat *_Nonnull chat, uint8_t *_Nullable dest); /** Group callbacks */ -void gc_callback_message(non_null() const Messenger *m, nullable() gc_message_cb *function); -void gc_callback_private_message(non_null() const Messenger *m, nullable() gc_private_message_cb *function); -void gc_callback_custom_packet(non_null() const Messenger *m, nullable() gc_custom_packet_cb *function); -void gc_callback_custom_private_packet(non_null() const Messenger *m, - nullable() gc_custom_private_packet_cb *function); -void gc_callback_moderation(non_null() const Messenger *m, nullable() gc_moderation_cb *function); -void gc_callback_nick_change(non_null() const Messenger *m, nullable() gc_nick_change_cb *function); -void gc_callback_status_change(non_null() const Messenger *m, nullable() gc_status_change_cb *function); -void gc_callback_topic_change(non_null() const Messenger *m, nullable() gc_topic_change_cb *function); -void gc_callback_peer_limit(non_null() const Messenger *m, nullable() gc_peer_limit_cb *function); -void gc_callback_privacy_state(non_null() const Messenger *m, nullable() gc_privacy_state_cb *function); -void gc_callback_topic_lock(non_null() const Messenger *m, nullable() gc_topic_lock_cb *function); -void gc_callback_password(non_null() const Messenger *m, nullable() gc_password_cb *function); -void gc_callback_peer_join(non_null() const Messenger *m, nullable() gc_peer_join_cb *function); -void gc_callback_peer_exit(non_null() const Messenger *m, nullable() gc_peer_exit_cb *function); -void gc_callback_self_join(non_null() const Messenger *m, nullable() gc_self_join_cb *function); -void gc_callback_rejected(non_null() const Messenger *m, nullable() gc_rejected_cb *function); -void gc_callback_voice_state(non_null() const Messenger *m, nullable() gc_voice_state_cb *function); +void gc_callback_message(const Messenger *_Nonnull m, gc_message_cb *_Nullable function); +void gc_callback_private_message(const Messenger *_Nonnull m, gc_private_message_cb *_Nullable function); +void gc_callback_custom_packet(const Messenger *_Nonnull m, gc_custom_packet_cb *_Nullable function); +void gc_callback_custom_private_packet(const Messenger *_Nonnull m, + gc_custom_private_packet_cb *_Nullable function); +void gc_callback_moderation(const Messenger *_Nonnull m, gc_moderation_cb *_Nullable function); +void gc_callback_nick_change(const Messenger *_Nonnull m, gc_nick_change_cb *_Nullable function); +void gc_callback_status_change(const Messenger *_Nonnull m, gc_status_change_cb *_Nullable function); +void gc_callback_topic_change(const Messenger *_Nonnull m, gc_topic_change_cb *_Nullable function); +void gc_callback_peer_limit(const Messenger *_Nonnull m, gc_peer_limit_cb *_Nullable function); +void gc_callback_privacy_state(const Messenger *_Nonnull m, gc_privacy_state_cb *_Nullable function); +void gc_callback_topic_lock(const Messenger *_Nonnull m, gc_topic_lock_cb *_Nullable function); +void gc_callback_password(const Messenger *_Nonnull m, gc_password_cb *_Nullable function); +void gc_callback_peer_join(const Messenger *_Nonnull m, gc_peer_join_cb *_Nullable function); +void gc_callback_peer_exit(const Messenger *_Nonnull m, gc_peer_exit_cb *_Nullable function); +void gc_callback_self_join(const Messenger *_Nonnull m, gc_self_join_cb *_Nullable function); +void gc_callback_rejected(const Messenger *_Nonnull m, gc_rejected_cb *_Nullable function); +void gc_callback_voice_state(const Messenger *_Nonnull m, gc_voice_state_cb *_Nullable function); /** @brief The main loop. Should be called with every Messenger iteration. */ -void do_gc(non_null() GC_Session *c, nullable() void *userdata); +void do_gc(GC_Session *_Nonnull c, void *_Nullable userdata); /** * Make sure that DHT is initialized before calling this. * Returns a NULL pointer on failure. */ -GC_Session *new_dht_groupchats(nullable() Messenger *m); +GC_Session *_Nullable new_dht_groupchats(Messenger *_Nullable m); /** @brief Cleans up groupchat structures and calls `gc_group_exit()` for every group chat */ -void kill_dht_groupchats(nullable() GC_Session *c); +void kill_dht_groupchats(GC_Session *_Nullable c); /** @brief Loads a previously saved group and attempts to join it. * * `bu` is the packed group info. @@ -551,12 +551,12 @@ void kill_dht_groupchats(nullable() GC_Session *c); * Returns group_number on success. * Returns -1 on failure. */ -int gc_group_load(non_null() GC_Session *c, non_null() Bin_Unpack *bu); +int gc_group_load(GC_Session *_Nonnull c, Bin_Unpack *_Nonnull bu); /** * @brief Saves info from `chat` to `bp` in binary format. */ -void gc_group_save(non_null() const GC_Chat *chat, non_null() Bin_Pack *bp); +void gc_group_save(const GC_Chat *_Nonnull chat, Bin_Pack *_Nonnull bp); /** @brief Creates a new group and adds it to the group sessions group array. * @@ -571,7 +571,7 @@ void gc_group_save(non_null() const GC_Chat *chat, non_null() Bin_Pack *bp); * Return -4 if the group state fails to initialize. * Return -5 if the Messenger friend connection fails to initialize. */ -int gc_group_add(non_null() GC_Session *c, Group_Privacy_State privacy_state, non_null() const uint8_t *group_name, uint16_t group_name_length, non_null() const uint8_t *nick, size_t nick_length); +int gc_group_add(GC_Session *_Nonnull c, Group_Privacy_State privacy_state, const uint8_t *_Nonnull group_name, uint16_t group_name_length, const uint8_t *_Nonnull nick, size_t nick_length); /** @brief Joins a group designated by `chat_id`. * @@ -589,14 +589,14 @@ int gc_group_add(non_null() GC_Session *c, Group_Privacy_State privacy_state, no * Return -5 if there is an error setting the group password. * Return -6 if the Messenger friend connection fails to initialize. */ -int gc_group_join(non_null() GC_Session *c, non_null() const uint8_t *chat_id, non_null() const uint8_t *nick, size_t nick_length, nullable() const uint8_t *passwd, +int gc_group_join(GC_Session *_Nonnull c, const uint8_t *_Nonnull chat_id, const uint8_t *_Nonnull nick, size_t nick_length, const uint8_t *_Nullable passwd, uint16_t passwd_len); /** @brief Disconnects from all peers in a group but saves the group state for later use. * * Return true on sucess. * Return false if the group handler object or chat object is null. */ -bool gc_disconnect_from_group(non_null() const GC_Session *c, non_null() GC_Chat *chat); +bool gc_disconnect_from_group(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat); /** @brief Disconnects from all peers in a group and attempts to reconnect. * @@ -606,7 +606,7 @@ bool gc_disconnect_from_group(non_null() const GC_Session *c, non_null() GC_Chat * Returns -1 if the group handler object or chat object is null. * Returns -2 if the Messenger friend connection fails to initialize. */ -int gc_rejoin_group(non_null() GC_Session *c, non_null() GC_Chat *chat, nullable() const uint8_t *passwd, uint16_t passwd_len); +int gc_rejoin_group(GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, const uint8_t *_Nullable passwd, uint16_t passwd_len); /** @brief Joins a group using the invite data received in a friend's group invite. * * The invite is only valid while the inviter is present in the group. @@ -620,9 +620,9 @@ int gc_rejoin_group(non_null() GC_Session *c, non_null() GC_Chat *chat, nullable * Return -6 if friend doesn't exist. * Return -7 if sending packet failed. */ -int gc_accept_invite(non_null() GC_Session *c, int32_t friend_number, non_null() const uint8_t *data, uint16_t length, non_null() const uint8_t *nick, - size_t nick_length, nullable() const uint8_t *passwd, uint16_t passwd_len); -typedef bool gc_send_group_invite_packet_cb(const Messenger *m, uint32_t friendnumber, const uint8_t *packet, +int gc_accept_invite(GC_Session *_Nonnull c, int32_t friend_number, const uint8_t *_Nonnull data, uint16_t length, const uint8_t *_Nonnull nick, + size_t nick_length, const uint8_t *_Nullable passwd, uint16_t passwd_len); +typedef bool gc_send_group_invite_packet_cb(const Messenger *_Nonnull m, uint32_t friendnumber, const uint8_t *_Nonnull packet, uint16_t length); /** @brief Invites friend designated by `friendnumber` to chat. @@ -633,7 +633,7 @@ typedef bool gc_send_group_invite_packet_cb(const Messenger *m, uint32_t friendn * Return -2 on failure to create the invite data. * Return -3 if the packet fails to send. */ -int gc_invite_friend(non_null() const GC_Session *c, non_null() GC_Chat *chat, int32_t friend_number, non_null() gc_send_group_invite_packet_cb *callback); +int gc_invite_friend(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, int32_t friend_number, gc_send_group_invite_packet_cb *_Nonnull callback); /** @brief Leaves a group and sends an exit broadcast packet with an optional parting message. * @@ -643,25 +643,25 @@ int gc_invite_friend(non_null() const GC_Session *c, non_null() GC_Chat *chat, i * Return -1 if the parting message is too long. * Return -2 if the parting message failed to send. */ -int gc_group_exit(non_null() GC_Session *c, non_null() GC_Chat *chat, nullable() const uint8_t *message, uint16_t length); +int gc_group_exit(GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, const uint8_t *_Nullable message, uint16_t length); /** @brief Returns true if `chat` is a valid group chat. * * A valid group chat constitutes an initialized chat instance with a non-zero shared state version. * The shared state version will be non-zero either if a peer has created the group, or if * they have ever successfully connected to the group. */ -bool gc_group_is_valid(non_null() const GC_Chat *chat); +bool gc_group_is_valid(const GC_Chat *_Nonnull chat); /** @brief Returns the number of active groups in `c`. */ -uint32_t gc_count_groups(non_null() const GC_Session *c); +uint32_t gc_count_groups(const GC_Session *_Nonnull c); /** @brief Returns true if peer_number exists */ -bool gc_peer_number_is_valid(non_null() const GC_Chat *chat, int peer_number); +bool gc_peer_number_is_valid(const GC_Chat *_Nonnull chat, int peer_number); /** @brief Return group_number's GC_Chat pointer on success * Return NULL on failure */ -GC_Chat *gc_get_group(non_null() const GC_Session *c, int group_number); +GC_Chat *_Nullable gc_get_group(const GC_Session *_Nonnull c, int group_number); /** @brief Sends a lossy message acknowledgement to peer associated with `gconn`. * @@ -672,7 +672,7 @@ GC_Chat *gc_get_group(non_null() const GC_Session *c, int group_number); * * @retval true on success. */ -bool gc_send_message_ack(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, uint64_t message_id, Group_Message_Ack_Type type); +bool gc_send_message_ack(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, uint64_t message_id, Group_Message_Ack_Type type); /** @brief Helper function for `handle_gc_lossless_packet()`. * @@ -680,19 +680,19 @@ bool gc_send_message_ack(non_null() const GC_Chat *chat, non_null() GC_Connectio * * @retval true if packet is successfully handled. */ -bool handle_gc_lossless_helper(non_null() const GC_Session *c, non_null() GC_Chat *chat, uint32_t peer_number, nullable() const uint8_t *data, - uint16_t length, uint8_t packet_type, nullable() void *userdata); +bool handle_gc_lossless_helper(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, uint32_t peer_number, const uint8_t *_Nullable data, + uint16_t length, uint8_t packet_type, void *_Nullable userdata); /** @brief Handles an invite accept packet. * * @retval true on success. */ -bool handle_gc_invite_accepted_packet(non_null() const GC_Session *c, int friend_number, non_null() const uint8_t *data, uint16_t length); +bool handle_gc_invite_accepted_packet(const GC_Session *_Nonnull c, int friend_number, const uint8_t *_Nonnull data, uint16_t length); /** @brief Return true if `chat_id` is not present in our group sessions array. * * `length` must be at least CHAT_ID_SIZE bytes in length. */ -bool group_not_added(non_null() const GC_Session *c, non_null() const uint8_t *chat_id, uint32_t length); +bool group_not_added(const GC_Session *_Nonnull c, const uint8_t *_Nonnull chat_id, uint32_t length); /** @brief Handles an invite confirmed packet. * @@ -703,18 +703,18 @@ bool group_not_added(non_null() const GC_Session *c, non_null() const uint8_t *c * Return -4 if `friend_number` does not designate a valid friend. * Return -5 if data contains invalid connection info. */ -int handle_gc_invite_confirmed_packet(non_null() const GC_Session *c, int friend_number, non_null() const uint8_t *data, uint16_t length); +int handle_gc_invite_confirmed_packet(const GC_Session *_Nonnull c, int friend_number, const uint8_t *_Nonnull data, uint16_t length); /** @brief Returns the group designated by `public_key`. * Returns null if group does not exist. */ -GC_Chat *gc_get_group_by_public_key(non_null() const GC_Session *c, non_null() const uint8_t *public_key); +GC_Chat *_Nullable gc_get_group_by_public_key(const GC_Session *_Nonnull c, const uint8_t *_Nonnull public_key); /** @brief Attempts to add peers from `announces` to our peer list and initiate an invite request. * * Returns the number of peers added on success. * Returns -1 on failure. */ -int gc_add_peers_from_announces(non_null() GC_Chat *chat, non_null() const GC_Announce *announces, uint8_t gc_announces_count); +int gc_add_peers_from_announces(GC_Chat *_Nonnull chat, const GC_Announce *_Nonnull announces, uint8_t gc_announces_count); #endif /* C_TOXCORE_TOXCORE_GROUP_CHATS_H */ diff --git a/toxcore/group_common.h b/toxcore/group_common.h index 87b1819d0..35dcb702a 100644 --- a/toxcore/group_common.h +++ b/toxcore/group_common.h @@ -85,7 +85,7 @@ typedef struct GC_PeerAddress { } GC_PeerAddress; typedef struct GC_Message_Array_Entry { - uint8_t *data; + uint8_t *_Nullable data; uint16_t data_length; uint8_t packet_type; uint64_t message_id; @@ -97,10 +97,10 @@ typedef struct GC_Connection { uint64_t send_message_id; /* message_id of the next message we send to peer */ uint16_t send_array_start; /* send_array index of oldest item */ - GC_Message_Array_Entry *send_array; + GC_Message_Array_Entry *_Nullable send_array; uint64_t received_message_id; /* message_id of peer's last message to us */ - GC_Message_Array_Entry *recv_array; + GC_Message_Array_Entry *_Nullable recv_array; uint64_t last_chunk_id; /* The message ID of the last packet fragment we received */ @@ -265,22 +265,22 @@ typedef struct GC_TopicInfo { } GC_TopicInfo; typedef struct GC_Chat { - Mono_Time *mono_time; - const Logger *log; - const Memory *mem; - const Random *rng; + Mono_Time *_Nonnull mono_time; + const Logger *_Nonnull log; + const Memory *_Nonnull mem; + const Random *_Nonnull rng; uint32_t connected_tcp_relays; Self_UDP_Status self_udp_status; IP_Port self_ip_port; - Networking_Core *net; - TCP_Connections *tcp_conn; + Networking_Core *_Nonnull net; + TCP_Connections *_Nullable tcp_conn; uint64_t last_checked_tcp_relays; Group_Handshake_Join_Type join_type; - GC_Peer *group; + GC_Peer *_Nullable group; Moderation moderation; GC_Conn_State connection_state; @@ -347,60 +347,60 @@ typedef struct GC_Chat { typedef struct Messenger Messenger; #endif /* MESSENGER_DEFINED */ -typedef void gc_message_cb(const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, unsigned int type, - const uint8_t *message, size_t length, uint32_t message_id, void *user_data); -typedef void gc_private_message_cb(const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, unsigned int type, - const uint8_t *message, size_t length, uint32_t message_id, void *user_data); -typedef void gc_custom_packet_cb(const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, const uint8_t *data, - size_t length, void *user_data); -typedef void gc_custom_private_packet_cb(const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, - const uint8_t *data, size_t length, void *user_data); -typedef void gc_moderation_cb(const Messenger *m, uint32_t group_number, GC_Peer_Id source_peer_number, - GC_Peer_Id target_peer_number, unsigned int mod_type, void *user_data); -typedef void gc_nick_change_cb(const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, const uint8_t *name, - size_t length, void *user_data); -typedef void gc_status_change_cb(const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, unsigned int status, - void *user_data); -typedef void gc_topic_change_cb(const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, const uint8_t *topic, - size_t length, void *user_data); -typedef void gc_topic_lock_cb(const Messenger *m, uint32_t group_number, unsigned int topic_lock, void *user_data); -typedef void gc_voice_state_cb(const Messenger *m, uint32_t group_number, unsigned int voice_state, void *user_data); -typedef void gc_peer_limit_cb(const Messenger *m, uint32_t group_number, uint32_t peer_limit, void *user_data); -typedef void gc_privacy_state_cb(const Messenger *m, uint32_t group_number, unsigned int privacy_state, void *user_data); -typedef void gc_password_cb(const Messenger *m, uint32_t group_number, const uint8_t *password, size_t length, - void *user_data); -typedef void gc_peer_join_cb(const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, void *user_data); -typedef void gc_peer_exit_cb(const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, unsigned int exit_type, - const uint8_t *name, size_t name_length, const uint8_t *part_message, size_t length, - void *user_data); -typedef void gc_self_join_cb(const Messenger *m, uint32_t group_number, void *user_data); -typedef void gc_rejected_cb(const Messenger *m, uint32_t group_number, unsigned int fail_type, void *user_data); +typedef void gc_message_cb(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, unsigned int type, + const uint8_t *_Nonnull message, size_t length, uint32_t message_id, void *_Nullable user_data); +typedef void gc_private_message_cb(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, unsigned int type, + const uint8_t *_Nonnull message, size_t length, uint32_t message_id, void *_Nullable user_data); +typedef void gc_custom_packet_cb(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, const uint8_t *_Nonnull data, + size_t length, void *_Nullable user_data); +typedef void gc_custom_private_packet_cb(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, + const uint8_t *_Nonnull data, size_t length, void *_Nullable user_data); +typedef void gc_moderation_cb(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id source_peer_number, + GC_Peer_Id target_peer_number, unsigned int mod_type, void *_Nullable user_data); +typedef void gc_nick_change_cb(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, const uint8_t *_Nonnull name, + size_t length, void *_Nullable user_data); +typedef void gc_status_change_cb(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, unsigned int status, + void *_Nullable user_data); +typedef void gc_topic_change_cb(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, const uint8_t *_Nullable topic, + size_t length, void *_Nullable user_data); +typedef void gc_topic_lock_cb(const Messenger *_Nonnull m, uint32_t group_number, unsigned int topic_lock, void *_Nullable user_data); +typedef void gc_voice_state_cb(const Messenger *_Nonnull m, uint32_t group_number, unsigned int voice_state, void *_Nullable user_data); +typedef void gc_peer_limit_cb(const Messenger *_Nonnull m, uint32_t group_number, uint32_t peer_limit, void *_Nullable user_data); +typedef void gc_privacy_state_cb(const Messenger *_Nonnull m, uint32_t group_number, unsigned int privacy_state, void *_Nullable user_data); +typedef void gc_password_cb(const Messenger *_Nonnull m, uint32_t group_number, const uint8_t *_Nullable password, size_t length, + void *_Nullable user_data); +typedef void gc_peer_join_cb(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, void *_Nullable user_data); +typedef void gc_peer_exit_cb(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, unsigned int exit_type, + const uint8_t *_Nullable name, size_t name_length, const uint8_t *_Nullable part_message, size_t length, + void *_Nullable user_data); +typedef void gc_self_join_cb(const Messenger *_Nonnull m, uint32_t group_number, void *_Nullable user_data); +typedef void gc_rejected_cb(const Messenger *_Nonnull m, uint32_t group_number, unsigned int fail_type, void *_Nullable user_data); typedef struct GC_Session { - Messenger *messenger; - GC_Chat *chats; - Net_Profile *tcp_np; - struct GC_Announces_List *announces_list; + Messenger *_Nonnull messenger; + GC_Chat *_Nullable chats; + Net_Profile *_Nullable tcp_np; + struct GC_Announces_List *_Nullable announces_list; uint32_t chats_index; - gc_message_cb *message; - gc_private_message_cb *private_message; - gc_custom_packet_cb *custom_packet; - gc_custom_private_packet_cb *custom_private_packet; - gc_moderation_cb *moderation; - gc_nick_change_cb *nick_change; - gc_status_change_cb *status_change; - gc_topic_change_cb *topic_change; - gc_topic_lock_cb *topic_lock; - gc_voice_state_cb *voice_state; - gc_peer_limit_cb *peer_limit; - gc_privacy_state_cb *privacy_state; - gc_password_cb *password; - gc_peer_join_cb *peer_join; - gc_peer_exit_cb *peer_exit; - gc_self_join_cb *self_join; - gc_rejected_cb *rejected; + gc_message_cb *_Nullable message; + gc_private_message_cb *_Nullable private_message; + gc_custom_packet_cb *_Nullable custom_packet; + gc_custom_private_packet_cb *_Nullable custom_private_packet; + gc_moderation_cb *_Nullable moderation; + gc_nick_change_cb *_Nullable nick_change; + gc_status_change_cb *_Nullable status_change; + gc_topic_change_cb *_Nullable topic_change; + gc_topic_lock_cb *_Nullable topic_lock; + gc_voice_state_cb *_Nullable voice_state; + gc_peer_limit_cb *_Nullable peer_limit; + gc_privacy_state_cb *_Nullable privacy_state; + gc_password_cb *_Nullable password; + gc_peer_join_cb *_Nullable peer_join; + gc_peer_exit_cb *_Nullable peer_exit; + gc_self_join_cb *_Nullable self_join; + gc_rejected_cb *_Nullable rejected; } GC_Session; /** @brief Adds a new peer to group_number's peer list. @@ -409,13 +409,13 @@ typedef struct GC_Session { * Return -1 on failure. * Return -2 if a peer with public_key is already in our peerlist. */ -int peer_add(non_null() GC_Chat *chat, nullable() const IP_Port *ipp, non_null() const uint8_t *public_key); +int peer_add(GC_Chat *_Nonnull chat, const IP_Port *_Nullable ipp, const uint8_t *_Nonnull public_key); /** @brief Unpacks saved peers from `data` of size `length` into `chat`. * * Returns the number of unpacked peers on success. * Returns -1 on failure. */ -int unpack_gc_saved_peers(non_null() GC_Chat *chat, non_null() const uint8_t *data, uint16_t length); +int unpack_gc_saved_peers(GC_Chat *_Nonnull chat, const uint8_t *_Nonnull data, uint16_t length); /** @brief Packs all valid entries from saved peerlist into `data`. * @@ -425,5 +425,5 @@ int unpack_gc_saved_peers(non_null() GC_Chat *chat, non_null() const uint8_t *da * Return the number of packed saved peers on success. * Return -1 if buffer is too small. */ -int pack_gc_saved_peers(non_null() const GC_Chat *chat, non_null() uint8_t *data, uint16_t length, nullable() uint16_t *processed); +int pack_gc_saved_peers(const GC_Chat *_Nonnull chat, uint8_t *_Nonnull data, uint16_t length, uint16_t *_Nullable processed); #endif /* C_TOXCORE_TOXCORE_GROUP_COMMON_H */ diff --git a/toxcore/group_connection.c b/toxcore/group_connection.c index afff0ade5..8dc2cdf87 100644 --- a/toxcore/group_connection.c +++ b/toxcore/group_connection.c @@ -33,14 +33,14 @@ #define GCC_UDP_DIRECT_RETRY 1 /** Returns true if array entry does not contain an active packet. */ -static bool array_entry_is_empty(non_null() const GC_Message_Array_Entry *array_entry) +static bool array_entry_is_empty(const GC_Message_Array_Entry *_Nonnull array_entry) { assert(array_entry != nullptr); return array_entry->time_added == 0; } /** @brief Clears an array entry. */ -static void clear_array_entry(non_null() const Memory *mem, non_null() GC_Message_Array_Entry *const array_entry) +static void clear_array_entry(const Memory *_Nonnull mem, GC_Message_Array_Entry *_Nonnull const array_entry) { mem_delete(mem, array_entry->data); @@ -54,7 +54,7 @@ static void clear_array_entry(non_null() const Memory *mem, non_null() GC_Messag * `start_id` and ending at `end_id`, and sets the send_message_id for `gconn` * to `start_id`. */ -static void clear_send_queue_id_range(non_null() const Memory *mem, non_null() GC_Connection *gconn, uint64_t start_id, uint64_t end_id) +static void clear_send_queue_id_range(const Memory *_Nonnull mem, GC_Connection *_Nonnull gconn, uint64_t start_id, uint64_t end_id) { const uint16_t start_idx = gcc_get_array_index(start_id); const uint16_t end_idx = gcc_get_array_index(end_id); @@ -90,8 +90,8 @@ void gcc_set_recv_message_id(GC_Connection *gconn, uint64_t id) * * Return true on success. */ -static bool create_array_entry(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Mono_Time *mono_time, non_null() GC_Message_Array_Entry *array_entry, - nullable() const uint8_t *data, uint16_t length, uint8_t packet_type, uint64_t message_id) +static bool create_array_entry(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, GC_Message_Array_Entry *_Nonnull array_entry, + const uint8_t *_Nullable data, uint16_t length, uint8_t packet_type, uint64_t message_id) { if (!array_entry_is_empty(array_entry)) { LOGGER_WARNING(log, "Failed to create array entry; entry is not empty."); @@ -133,8 +133,8 @@ static bool create_array_entry(non_null() const Logger *log, non_null() const Me * * Returns true and increments gconn's send_message_id on success. */ -static bool add_to_send_array(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Mono_Time *mono_time, non_null() GC_Connection *gconn, - nullable() const uint8_t *data, uint16_t length, uint8_t packet_type) +static bool add_to_send_array(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, GC_Connection *_Nonnull gconn, + const uint8_t *_Nullable data, uint16_t length, uint8_t packet_type) { /* check if send_array is full */ if ((gconn->send_message_id % GCC_BUFFER_SIZE) == (uint16_t)(gconn->send_array_start - 1)) { @@ -334,8 +334,8 @@ int gcc_save_tcp_relay(const Random *rng, GC_Connection *gconn, const Node_forma * * Return true on success. */ -static bool store_in_recv_array(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Mono_Time *mono_time, - non_null() GC_Connection *gconn, nullable() const uint8_t *data, +static bool store_in_recv_array(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, + GC_Connection *_Nonnull gconn, const uint8_t *_Nullable data, uint16_t length, uint8_t packet_type, uint64_t message_id) { const uint16_t idx = gcc_get_array_index(message_id); @@ -355,7 +355,7 @@ static bool store_in_recv_array(non_null() const Logger *log, non_null() const M * Return the length of the fully reassembled packet on success. * Return 0 on failure. */ -static uint16_t reassemble_packet(non_null() const Logger *log, non_null() const Memory *mem, nullable() GC_Connection *gconn, non_null() uint8_t **payload, uint64_t message_id) +static uint16_t reassemble_packet(const Logger *_Nonnull log, const Memory *_Nonnull mem, GC_Connection *_Nullable gconn, uint8_t *_Nonnull *payload, uint64_t message_id) { uint16_t end_idx = gcc_get_array_index(message_id - 1); uint16_t start_idx = end_idx; @@ -504,8 +504,8 @@ int gcc_handle_received_message(const Logger *log, const Memory *mem, const Mono * * Return true on success. */ -static bool process_recv_array_entry(non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() GC_Connection *gconn, uint32_t peer_number, - non_null() GC_Message_Array_Entry *const array_entry, nullable() void *userdata) +static bool process_recv_array_entry(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, uint32_t peer_number, + GC_Message_Array_Entry *_Nonnull const array_entry, void *_Nullable userdata) { uint8_t sender_pk[ENC_PUBLIC_KEY_SIZE]; memcpy(sender_pk, get_enc_key(&gconn->addr.public_key), ENC_PUBLIC_KEY_SIZE); diff --git a/toxcore/group_connection.h b/toxcore/group_connection.h index 583252b91..010b51e57 100644 --- a/toxcore/group_connection.h +++ b/toxcore/group_connection.h @@ -24,8 +24,8 @@ #define GCC_MAX_TCP_SHARED_RELAYS 3 /** Marks a peer for deletion. If gconn is null or already marked for deletion this function has no effect. */ -void gcc_mark_for_deletion(non_null() GC_Connection *gconn, non_null() TCP_Connections *tcp_conn, Group_Exit_Type type, - nullable() const uint8_t *part_message, uint16_t length); +void gcc_mark_for_deletion(GC_Connection *_Nonnull gconn, TCP_Connections *_Nonnull tcp_conn, Group_Exit_Type type, + const uint8_t *_Nullable part_message, uint16_t length); /** @brief Decides if message need to be put in recv_array or immediately handled. * * Return 3 if message is in correct sequence and is a fragment packet. @@ -34,8 +34,8 @@ void gcc_mark_for_deletion(non_null() GC_Connection *gconn, non_null() TCP_Conne * Return 0 if message is a duplicate. * Return -1 on failure */ -int gcc_handle_received_message(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Mono_Time *mono_time, non_null() GC_Connection *gconn, - nullable() const uint8_t *data, uint16_t length, uint8_t packet_type, uint64_t message_id, +int gcc_handle_received_message(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, GC_Connection *_Nonnull gconn, + const uint8_t *_Nullable data, uint16_t length, uint8_t packet_type, uint64_t message_id, bool direct_conn); /** @brief Handles a packet fragment. * @@ -47,9 +47,9 @@ int gcc_handle_received_message(non_null() const Logger *log, non_null() const M * Return 0 if fragment is the end of a sequence and successfully handled. * Return -1 on failure. */ -int gcc_handle_packet_fragment(non_null() const GC_Session *c, non_null() GC_Chat *chat, uint32_t peer_number, non_null() GC_Connection *gconn, - nullable() const uint8_t *chunk, uint16_t length, uint8_t packet_type, uint64_t message_id, - nullable() void *userdata); +int gcc_handle_packet_fragment(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, uint32_t peer_number, GC_Connection *_Nonnull gconn, + const uint8_t *_Nullable chunk, uint16_t length, uint8_t packet_type, uint64_t message_id, + void *_Nullable userdata); /** @brief Return array index for message_id */ uint16_t gcc_get_array_index(uint64_t message_id); @@ -57,33 +57,33 @@ uint16_t gcc_get_array_index(uint64_t message_id); * * Return true on success. */ -bool gcc_handle_ack(non_null() const Logger *log, non_null() const Memory *mem, non_null() GC_Connection *gconn, uint64_t message_id); +bool gcc_handle_ack(const Logger *_Nonnull log, const Memory *_Nonnull mem, GC_Connection *_Nonnull gconn, uint64_t message_id); /** @brief Sets the send_message_id and send_array_start for `gconn` to `id`. * * This should only be used to initialize a new lossless connection. */ -void gcc_set_send_message_id(non_null() GC_Connection *gconn, uint64_t id); +void gcc_set_send_message_id(GC_Connection *_Nonnull gconn, uint64_t id); /** @brief Sets the received_message_id for `gconn` to `id`. */ -void gcc_set_recv_message_id(non_null() GC_Connection *gconn, uint64_t id); +void gcc_set_recv_message_id(GC_Connection *_Nonnull gconn, uint64_t id); /** * @brief Returns true if the ip_port is set for gconn. */ -bool gcc_ip_port_is_set(non_null() const GC_Connection *gconn); +bool gcc_ip_port_is_set(const GC_Connection *_Nonnull gconn); /** * @brief Sets the ip_port for gconn to ipp. * * If ipp is not set this function has no effect. */ -void gcc_set_ip_port(non_null() GC_Connection *gconn, nullable() const IP_Port *ipp); +void gcc_set_ip_port(GC_Connection *_Nonnull gconn, const IP_Port *_Nullable ipp); /** @brief Copies a random TCP relay node from gconn to tcp_node. * * Return true on success. */ -bool gcc_copy_tcp_relay(non_null() const Random *rng, non_null() Node_format *tcp_node, non_null() const GC_Connection *gconn); +bool gcc_copy_tcp_relay(const Random *_Nonnull rng, Node_format *_Nonnull tcp_node, const GC_Connection *_Nonnull gconn); /** @brief Saves tcp_node to gconn's list of connected tcp relays. * @@ -93,15 +93,15 @@ bool gcc_copy_tcp_relay(non_null() const Random *rng, non_null() Node_format *tc * Return -1 on failure. * Return -2 if node is already in list. */ -int gcc_save_tcp_relay(non_null() const Random *rng, non_null() GC_Connection *gconn, non_null() const Node_format *tcp_node); +int gcc_save_tcp_relay(const Random *_Nonnull rng, GC_Connection *_Nonnull gconn, const Node_format *_Nonnull tcp_node); /** @brief Checks for and handles messages that are in proper sequence in gconn's recv_array. * This should always be called after a new packet is successfully handled. */ -void gcc_check_recv_array(non_null() const GC_Session *c, non_null() GC_Chat *chat, non_null() GC_Connection *gconn, uint32_t peer_number, - nullable() void *userdata); +void gcc_check_recv_array(const GC_Session *_Nonnull c, GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, uint32_t peer_number, + void *_Nullable userdata); /** @brief Attempts to re-send lossless packets that have not yet received an ack. */ -void gcc_resend_packets(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn); +void gcc_resend_packets(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn); /** * Uses public encryption key `sender_pk` and the shared secret key associated with `gconn` @@ -111,16 +111,16 @@ void gcc_resend_packets(non_null() const GC_Chat *chat, non_null() GC_Connection * Puts the result in the shared session key buffer for `gconn`, which must have room for * CRYPTO_SHARED_KEY_SIZE bytes. This resulting shared key should be treated as a secret key. */ -void gcc_make_session_shared_key(non_null() GC_Connection *gconn, non_null() const uint8_t *sender_pk); +void gcc_make_session_shared_key(GC_Connection *_Nonnull gconn, const uint8_t *_Nonnull sender_pk); /** @brief Return true if we have a direct connection with `gconn`. */ -bool gcc_conn_is_direct(non_null() const Mono_Time *mono_time, non_null() const GC_Connection *gconn); +bool gcc_conn_is_direct(const Mono_Time *_Nonnull mono_time, const GC_Connection *_Nonnull gconn); /** @brief Return true if we can try a direct connection with `gconn` again. */ -bool gcc_conn_should_try_direct(non_null() const Mono_Time *mono_time, non_null() const GC_Connection *gconn); +bool gcc_conn_should_try_direct(const Mono_Time *_Nonnull mono_time, const GC_Connection *_Nonnull gconn); /** @brief Return true if a direct UDP connection is possible with `gconn`. */ -bool gcc_direct_conn_is_possible(non_null() const GC_Chat *chat, non_null() const GC_Connection *gconn); +bool gcc_direct_conn_is_possible(const GC_Chat *_Nonnull chat, const GC_Connection *_Nonnull gconn); /** @brief Sends a packet to the peer associated with gconn. * @@ -128,7 +128,7 @@ bool gcc_direct_conn_is_possible(non_null() const GC_Chat *chat, non_null() cons * * Return true on success. */ -bool gcc_send_packet(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, non_null() const uint8_t *packet, uint16_t length); +bool gcc_send_packet(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nonnull packet, uint16_t length); /** @brief Sends a lossless packet to `gconn` comprised of `data` of size `length`. * @@ -139,7 +139,7 @@ bool gcc_send_packet(non_null() const GC_Chat *chat, non_null() GC_Connection *g * Return -1 if the packet couldn't be added to the send array. * Return -2 if the packet failed to be wrapped or encrypted. */ -int gcc_send_lossless_packet(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, nullable() const uint8_t *data, uint16_t length, +int gcc_send_lossless_packet(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nullable data, uint16_t length, uint8_t packet_type); /** @brief Splits a lossless packet up into fragments, wraps each fragment in a GP_FRAGMENT * header, encrypts them, and send them in succession. @@ -150,7 +150,7 @@ int gcc_send_lossless_packet(non_null() const GC_Chat *chat, non_null() GC_Conne * * Return true if all fragments are successfully added to the send array. */ -bool gcc_send_lossless_packet_fragments(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, non_null() const uint8_t *data, uint16_t length, uint8_t packet_type); +bool gcc_send_lossless_packet_fragments(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nonnull data, uint16_t length, uint8_t packet_type); /** @brief Encrypts `data` of `length` bytes, designated by `message_id`, using the shared key * associated with `gconn` and sends lossless packet over the wire. @@ -161,12 +161,12 @@ bool gcc_send_lossless_packet_fragments(non_null() const GC_Chat *chat, non_null * Return -1 if packet wrapping and encryption fails. * Return -2 if the packet fails to send. */ -int gcc_encrypt_and_send_lossless_packet(non_null() const GC_Chat *chat, non_null() GC_Connection *gconn, nullable() const uint8_t *data, +int gcc_encrypt_and_send_lossless_packet(const GC_Chat *_Nonnull chat, GC_Connection *_Nonnull gconn, const uint8_t *_Nullable data, uint16_t length, uint64_t message_id, uint8_t packet_type); /** @brief Called when a peer leaves the group. */ -void gcc_peer_cleanup(non_null() const Memory *mem, non_null() GC_Connection *gconn); +void gcc_peer_cleanup(const Memory *_Nonnull mem, GC_Connection *_Nonnull gconn); /** @brief Called on group exit. */ -void gcc_cleanup(non_null() const GC_Chat *chat); +void gcc_cleanup(const GC_Chat *_Nonnull chat); #endif /* C_TOXCORE_TOXCORE_GROUP_CONNECTION_H */ diff --git a/toxcore/group_moderation.c b/toxcore/group_moderation.c index 1bd8e5878..b25eb440e 100644 --- a/toxcore/group_moderation.c +++ b/toxcore/group_moderation.c @@ -34,12 +34,12 @@ static_assert(MOD_MAX_NUM_MODERATORS <= MOD_MAX_NUM_MODERATORS_LIMIT, static_assert(MOD_MAX_NUM_SANCTIONS <= MOD_MAX_NUM_SANCTIONS_LIMIT, "MOD_MAX_NUM_SANCTIONS must be <= MOD_MAX_NUM_SANCTIONS_LIMIT"); -uint16_t mod_list_packed_size(const Moderation *moderation) +uint16_t mod_list_packed_size(const Moderation *_Nonnull moderation) { return moderation->num_mods * MOD_LIST_ENTRY_SIZE; } -int mod_list_unpack(Moderation *moderation, const uint8_t *data, uint16_t length, uint16_t num_mods) +int mod_list_unpack(Moderation *_Nonnull moderation, const uint8_t *_Nonnull data, uint16_t length, uint16_t num_mods) { if (length < num_mods * MOD_LIST_ENTRY_SIZE) { return -1; @@ -79,19 +79,19 @@ int mod_list_unpack(Moderation *moderation, const uint8_t *data, uint16_t length return unpacked_len; } -void mod_list_pack(const Moderation *moderation, uint8_t *data) +void mod_list_pack(const Moderation *_Nonnull moderation, uint8_t *_Nonnull data) { for (uint16_t i = 0; i < moderation->num_mods; ++i) { memcpy(&data[i * MOD_LIST_ENTRY_SIZE], moderation->mod_list[i], MOD_LIST_ENTRY_SIZE); } } -void mod_list_get_data_hash(uint8_t *hash, const uint8_t *packed_mod_list, uint16_t length) +void mod_list_get_data_hash(uint8_t *_Nonnull hash, const uint8_t *_Nonnull packed_mod_list, uint16_t length) { crypto_sha256(hash, packed_mod_list, length); } -bool mod_list_make_hash(const Moderation *moderation, uint8_t *hash) +bool mod_list_make_hash(const Moderation *_Nonnull moderation, uint8_t *_Nonnull hash) { if (moderation->num_mods == 0) { memzero(hash, MOD_MODERATION_HASH_SIZE); @@ -121,7 +121,7 @@ bool mod_list_make_hash(const Moderation *moderation, uint8_t *hash) * Returns moderator list index for public_sig_key. * Returns -1 if key is not in the list. */ -static int mod_list_index_of_sig_pk(non_null() const Moderation *moderation, non_null() const uint8_t *public_sig_key) +static int mod_list_index_of_sig_pk(const Moderation *_Nonnull moderation, const uint8_t *_Nonnull public_sig_key) { for (uint16_t i = 0; i < moderation->num_mods; ++i) { if (memcmp(moderation->mod_list[i], public_sig_key, SIG_PUBLIC_KEY_SIZE) == 0) { @@ -132,7 +132,7 @@ static int mod_list_index_of_sig_pk(non_null() const Moderation *moderation, non return -1; } -bool mod_list_verify_sig_pk(const Moderation *moderation, const uint8_t *sig_pk) +bool mod_list_verify_sig_pk(const Moderation *_Nonnull moderation, const uint8_t *_Nonnull sig_pk) { if (memcmp(moderation->founder_public_sig_key, sig_pk, SIG_PUBLIC_KEY_SIZE) == 0) { return true; @@ -147,7 +147,7 @@ bool mod_list_verify_sig_pk(const Moderation *moderation, const uint8_t *sig_pk) return false; } -bool mod_list_remove_index(Moderation *moderation, uint16_t index) +bool mod_list_remove_index(Moderation *_Nonnull moderation, uint16_t index) { if (index >= moderation->num_mods) { return false; @@ -179,7 +179,7 @@ bool mod_list_remove_index(Moderation *moderation, uint16_t index) return true; } -bool mod_list_remove_entry(Moderation *moderation, const uint8_t *public_sig_key) +bool mod_list_remove_entry(Moderation *_Nonnull moderation, const uint8_t *_Nonnull public_sig_key) { if (moderation->num_mods == 0) { return false; @@ -196,7 +196,7 @@ bool mod_list_remove_entry(Moderation *moderation, const uint8_t *public_sig_key return mod_list_remove_index(moderation, (uint16_t)idx); } -bool mod_list_add_entry(Moderation *moderation, const uint8_t *mod_data) +bool mod_list_add_entry(Moderation *_Nonnull moderation, const uint8_t *_Nonnull mod_data) { if (moderation->num_mods >= MOD_MAX_NUM_MODERATORS) { return false; @@ -224,14 +224,14 @@ bool mod_list_add_entry(Moderation *moderation, const uint8_t *mod_data) return true; } -void mod_list_cleanup(Moderation *moderation) +void mod_list_cleanup(Moderation *_Nullable moderation) { free_uint8_t_pointer_array(moderation->mem, moderation->mod_list, moderation->num_mods); moderation->num_mods = 0; moderation->mod_list = nullptr; } -uint16_t sanctions_creds_pack(const Mod_Sanction_Creds *creds, uint8_t *data) +uint16_t sanctions_creds_pack(const Mod_Sanction_Creds *_Nonnull creds, uint8_t *_Nonnull data) { uint16_t packed_len = 0; @@ -254,8 +254,8 @@ uint16_t sanctions_list_packed_size(uint16_t num_sanctions) return MOD_SANCTION_PACKED_SIZE * num_sanctions; } -int sanctions_list_pack(uint8_t *data, uint16_t length, const Mod_Sanction *sanctions, uint16_t num_sanctions, - const Mod_Sanction_Creds *creds) +int sanctions_list_pack(uint8_t *_Nonnull data, uint16_t length, const Mod_Sanction *_Nullable sanctions, uint16_t num_sanctions, + const Mod_Sanction_Creds *_Nullable creds) { assert(sanctions != nullptr || num_sanctions == 0); assert(sanctions != nullptr || creds != nullptr); @@ -313,7 +313,7 @@ int sanctions_list_pack(uint8_t *data, uint16_t length, const Mod_Sanction *sanc return packed_len + cred_len; } -uint16_t sanctions_creds_unpack(Mod_Sanction_Creds *creds, const uint8_t *data) +uint16_t sanctions_creds_unpack(Mod_Sanction_Creds *_Nonnull creds, const uint8_t *_Nonnull data) { uint16_t len_processed = 0; @@ -331,8 +331,8 @@ uint16_t sanctions_creds_unpack(Mod_Sanction_Creds *creds, const uint8_t *data) return len_processed; } -int sanctions_list_unpack(Mod_Sanction *sanctions, Mod_Sanction_Creds *creds, uint16_t max_sanctions, - const uint8_t *data, uint16_t length, uint16_t *processed_data_len) +int sanctions_list_unpack(Mod_Sanction *_Nonnull sanctions, Mod_Sanction_Creds *_Nonnull creds, uint16_t max_sanctions, + const uint8_t *_Nonnull data, uint16_t length, uint16_t *_Nullable processed_data_len) { uint16_t num = 0; uint16_t len_processed = 0; @@ -404,8 +404,8 @@ int sanctions_list_unpack(Mod_Sanction *sanctions, Mod_Sanction_Creds *creds, ui * * Return true on success. */ -static bool sanctions_list_make_hash(non_null() const Memory *mem, nullable() const Mod_Sanction *sanctions, uint32_t new_version, uint16_t num_sanctions, - non_null() uint8_t *hash) +static bool sanctions_list_make_hash(const Memory *_Nonnull mem, const Mod_Sanction *_Nullable sanctions, uint32_t new_version, uint16_t num_sanctions, + uint8_t *_Nonnull hash) { if (num_sanctions == 0 || sanctions == nullptr) { memzero(hash, MOD_SANCTION_HASH_SIZE); @@ -442,7 +442,7 @@ static bool sanctions_list_make_hash(non_null() const Memory *mem, nullable() co * * Returns true on success. */ -static bool sanctions_list_validate_entry(non_null() const Moderation *moderation, non_null() const Mod_Sanction *sanction) +static bool sanctions_list_validate_entry(const Moderation *_Nonnull moderation, const Mod_Sanction *_Nonnull sanction) { if (!mod_list_verify_sig_pk(moderation, sanction->setter_public_sig_key)) { return false; @@ -467,17 +467,17 @@ static bool sanctions_list_validate_entry(non_null() const Moderation *moderatio sanction->setter_public_sig_key); } -static uint16_t sanctions_creds_get_checksum(non_null() const Mod_Sanction_Creds *creds) +static uint16_t sanctions_creds_get_checksum(const Mod_Sanction_Creds *_Nonnull creds) { return data_checksum(creds->hash, sizeof(creds->hash)); } -static void sanctions_creds_set_checksum(non_null() Mod_Sanction_Creds *creds) +static void sanctions_creds_set_checksum(Mod_Sanction_Creds *_Nonnull creds) { creds->checksum = sanctions_creds_get_checksum(creds); } -bool sanctions_list_make_creds(Moderation *moderation) +bool sanctions_list_make_creds(Moderation *_Nonnull moderation) { const Mod_Sanction_Creds old_creds = moderation->sanctions_creds; @@ -517,8 +517,8 @@ bool sanctions_list_make_creds(Moderation *moderation) * * Returns true on success. */ -static bool sanctions_creds_validate(non_null() const Moderation *moderation, nullable() const Mod_Sanction *sanctions, - non_null() const Mod_Sanction_Creds *creds, uint16_t num_sanctions) +static bool sanctions_creds_validate(const Moderation *_Nonnull moderation, const Mod_Sanction *_Nullable sanctions, + const Mod_Sanction_Creds *_Nonnull creds, uint16_t num_sanctions) { if (!mod_list_verify_sig_pk(moderation, creds->sig_pk)) { LOGGER_WARNING(moderation->log, "Invalid credentials signature pk"); @@ -557,8 +557,8 @@ static bool sanctions_creds_validate(non_null() const Moderation *moderation, nu return true; } -bool sanctions_list_check_integrity(const Moderation *moderation, const Mod_Sanction_Creds *creds, - const Mod_Sanction *sanctions, uint16_t num_sanctions) +bool sanctions_list_check_integrity(const Moderation *_Nonnull moderation, const Mod_Sanction_Creds *_Nonnull creds, + const Mod_Sanction *_Nonnull sanctions, uint16_t num_sanctions) { for (uint16_t i = 0; i < num_sanctions; ++i) { if (!sanctions_list_validate_entry(moderation, &sanctions[i])) { @@ -581,8 +581,8 @@ bool sanctions_list_check_integrity(const Moderation *moderation, const Mod_Sanc * * @retval false if sanctions credentials validation fails. */ -static bool sanctions_apply_new(non_null() Moderation *moderation, non_null() Mod_Sanction *new_sanctions, - nullable() const Mod_Sanction_Creds *new_creds, +static bool sanctions_apply_new(Moderation *_Nonnull moderation, Mod_Sanction *_Nonnull new_sanctions, + const Mod_Sanction_Creds *_Nullable new_creds, uint16_t num_sanctions) { if (new_creds != nullptr) { @@ -604,7 +604,7 @@ static bool sanctions_apply_new(non_null() Moderation *moderation, non_null() Mo /** @brief Returns a copy of the sanctions list. The caller is responsible for freeing the * memory returned by this function. */ -static Mod_Sanction *sanctions_list_copy(non_null() const Memory *mem, non_null() const Mod_Sanction *sanctions, uint16_t num_sanctions) +static Mod_Sanction *sanctions_list_copy(const Memory *_Nonnull mem, const Mod_Sanction *_Nonnull sanctions, uint16_t num_sanctions) { Mod_Sanction *copy = (Mod_Sanction *)mem_valloc(mem, num_sanctions, sizeof(Mod_Sanction)); @@ -623,7 +623,7 @@ static Mod_Sanction *sanctions_list_copy(non_null() const Memory *mem, non_null( * * Returns true on success. */ -static bool sanctions_list_remove_index(non_null() Moderation *moderation, uint16_t index, nullable() const Mod_Sanction_Creds *creds) +static bool sanctions_list_remove_index(Moderation *_Nonnull moderation, uint16_t index, const Mod_Sanction_Creds *_Nullable creds) { if (index >= moderation->num_sanctions) { return false; @@ -671,8 +671,8 @@ static bool sanctions_list_remove_index(non_null() Moderation *moderation, uint1 return true; } -bool sanctions_list_remove_observer(Moderation *moderation, const uint8_t *public_key, - const Mod_Sanction_Creds *creds) +bool sanctions_list_remove_observer(Moderation *_Nonnull moderation, const uint8_t *_Nonnull public_key, + const Mod_Sanction_Creds *_Nullable creds) { for (uint16_t i = 0; i < moderation->num_sanctions; ++i) { const Mod_Sanction *curr_sanction = &moderation->sanctions[i]; @@ -697,7 +697,7 @@ bool sanctions_list_remove_observer(Moderation *moderation, const uint8_t *publi return false; } -bool sanctions_list_is_observer(const Moderation *moderation, const uint8_t *public_key) +bool sanctions_list_is_observer(const Moderation *_Nonnull moderation, const uint8_t *_Nonnull public_key) { for (uint16_t i = 0; i < moderation->num_sanctions; ++i) { const Mod_Sanction *curr_sanction = &moderation->sanctions[i]; @@ -714,7 +714,7 @@ bool sanctions_list_is_observer(const Moderation *moderation, const uint8_t *pub return false; } -bool sanctions_list_entry_exists(const Moderation *moderation, const Mod_Sanction *sanction) +bool sanctions_list_entry_exists(const Moderation *_Nonnull moderation, const Mod_Sanction *_Nonnull sanction) { if (sanction->type == SA_OBSERVER) { return sanctions_list_is_observer(moderation, sanction->target_public_enc_key); @@ -723,7 +723,7 @@ bool sanctions_list_entry_exists(const Moderation *moderation, const Mod_Sanctio return false; } -bool sanctions_list_add_entry(Moderation *moderation, const Mod_Sanction *sanction, const Mod_Sanction_Creds *creds) +bool sanctions_list_add_entry(Moderation *_Nonnull moderation, const Mod_Sanction *_Nonnull sanction, const Mod_Sanction_Creds *_Nullable creds) { if (moderation->num_sanctions >= MOD_MAX_NUM_SANCTIONS) { LOGGER_WARNING(moderation->log, "num_sanctions %d exceeds maximum", moderation->num_sanctions); @@ -775,7 +775,7 @@ bool sanctions_list_add_entry(Moderation *moderation, const Mod_Sanction *sancti * * Returns true on success. */ -static bool sanctions_list_sign_entry(non_null() const Moderation *moderation, non_null() Mod_Sanction *sanction) +static bool sanctions_list_sign_entry(const Moderation *_Nonnull moderation, Mod_Sanction *_Nonnull sanction) { uint8_t packed_data[MOD_SANCTION_PACKED_SIZE]; const int packed_len = sanctions_list_pack(packed_data, sizeof(packed_data), sanction, 1, nullptr); @@ -789,7 +789,7 @@ static bool sanctions_list_sign_entry(non_null() const Moderation *moderation, n moderation->self_secret_sig_key); } -bool sanctions_list_make_entry(Moderation *moderation, const uint8_t *public_key, Mod_Sanction *sanction, +bool sanctions_list_make_entry(Moderation *_Nonnull moderation, const uint8_t *_Nonnull public_key, Mod_Sanction *_Nonnull sanction, uint8_t type) { *sanction = (Mod_Sanction) { @@ -824,7 +824,7 @@ bool sanctions_list_make_entry(Moderation *moderation, const uint8_t *public_key return true; } -uint16_t sanctions_list_replace_sig(Moderation *moderation, const uint8_t *public_sig_key) +uint16_t sanctions_list_replace_sig(Moderation *_Nonnull moderation, const uint8_t *_Nonnull public_sig_key) { uint16_t count = 0; @@ -852,7 +852,7 @@ uint16_t sanctions_list_replace_sig(Moderation *moderation, const uint8_t *publi return count; } -void sanctions_list_cleanup(Moderation *moderation) +void sanctions_list_cleanup(Moderation *_Nonnull moderation) { mem_delete(moderation->mem, moderation->sanctions); diff --git a/toxcore/group_moderation.h b/toxcore/group_moderation.h index ec59da90f..068198b7a 100644 --- a/toxcore/group_moderation.h +++ b/toxcore/group_moderation.h @@ -81,26 +81,26 @@ typedef struct Mod_Sanction { } Mod_Sanction; typedef struct Moderation { - const Memory *mem; - const Logger *log; + const Memory *_Nonnull mem; + const Logger *_Nonnull log; - Mod_Sanction *sanctions; + Mod_Sanction *_Nullable sanctions; uint16_t num_sanctions; Mod_Sanction_Creds sanctions_creds; - uint8_t **mod_list; // array of public signature keys of all the mods + uint8_t *_Nullable *_Nullable mod_list; // array of public signature keys of all the mods uint16_t num_mods; // copies from parent/sibling chat/shared state objects - uint8_t founder_public_sig_key[SIG_PUBLIC_KEY_SIZE]; + uint8_t founder_public_sig_key[CRYPTO_PUBLIC_KEY_SIZE]; uint8_t self_public_sig_key[SIG_PUBLIC_KEY_SIZE]; uint8_t self_secret_sig_key[SIG_SECRET_KEY_SIZE]; uint32_t shared_state_version; } Moderation; /** @brief Returns the size in bytes of the packed moderation list. */ -uint16_t mod_list_packed_size(non_null() const Moderation *moderation); +uint16_t mod_list_packed_size(const Moderation *_Nonnull moderation); /** @brief Unpacks data into the moderator list. * @@ -109,12 +109,12 @@ uint16_t mod_list_packed_size(non_null() const Moderation *moderation); * Returns length of unpacked data on success. * Returns -1 on failure. */ -int mod_list_unpack(non_null() Moderation *moderation, non_null() const uint8_t *data, uint16_t length, uint16_t num_mods); +int mod_list_unpack(Moderation *_Nonnull moderation, const uint8_t *_Nonnull data, uint16_t length, uint16_t num_mods); /** @brief Packs moderator list into data. * @param data must have room for the number of bytes returned by `mod_list_packed_size`. */ -void mod_list_pack(non_null() const Moderation *moderation, non_null() uint8_t *data); +void mod_list_pack(const Moderation *_Nonnull moderation, uint8_t *_Nonnull data); /** @brief Creates a new moderator list hash and puts it in `hash`. * @@ -124,25 +124,25 @@ void mod_list_pack(non_null() const Moderation *moderation, non_null() uint8_t * * * Returns true on sucess. */ -bool mod_list_make_hash(non_null() const Moderation *moderation, non_null() uint8_t *hash); +bool mod_list_make_hash(const Moderation *_Nonnull moderation, uint8_t *_Nonnull hash); /** @brief Puts a sha256 hash of `packed_mod_list` of `length` bytes in `hash`. * * @param hash must have room for at least MOD_MODERATION_HASH_SIZE bytes. */ -void mod_list_get_data_hash(non_null() uint8_t *hash, non_null() const uint8_t *packed_mod_list, uint16_t length); +void mod_list_get_data_hash(uint8_t *_Nonnull hash, const uint8_t *_Nonnull packed_mod_list, uint16_t length); /** @brief Removes moderator at index-th position in the moderator list. * * Returns true on success. */ -bool mod_list_remove_index(non_null() Moderation *moderation, uint16_t index); +bool mod_list_remove_index(Moderation *_Nonnull moderation, uint16_t index); /** @brief Removes public_sig_key from the moderator list. * * Returns true on success. */ -bool mod_list_remove_entry(non_null() Moderation *moderation, non_null() const uint8_t *public_sig_key); +bool mod_list_remove_entry(Moderation *_Nonnull moderation, const uint8_t *_Nonnull public_sig_key); /** @brief Adds a mod to the moderator list. * @@ -150,13 +150,13 @@ bool mod_list_remove_entry(non_null() Moderation *moderation, non_null() const u * * Returns true on success. */ -bool mod_list_add_entry(non_null() Moderation *moderation, non_null() const uint8_t *mod_data); +bool mod_list_add_entry(Moderation *_Nonnull moderation, const uint8_t *_Nonnull mod_data); /** @return true if the public signature key belongs to a moderator or the founder */ -bool mod_list_verify_sig_pk(non_null() const Moderation *moderation, non_null() const uint8_t *sig_pk); +bool mod_list_verify_sig_pk(const Moderation *_Nonnull moderation, const uint8_t *_Nonnull sig_pk); /** @brief Frees all memory associated with the moderator list and sets num_mods to 0. */ -void mod_list_cleanup(nullable() Moderation *moderation); +void mod_list_cleanup(Moderation *_Nullable moderation); /** @brief Returns the size in bytes of num_sanctions packed sanctions. */ uint16_t sanctions_list_packed_size(uint16_t num_sanctions); @@ -173,8 +173,8 @@ uint16_t sanctions_list_packed_size(uint16_t num_sanctions); * @retval The length of packed data on success. * @retval -1 on failure. */ -int sanctions_list_pack(non_null() uint8_t *data, uint16_t length, nullable() const Mod_Sanction *sanctions, uint16_t num_sanctions, - nullable() const Mod_Sanction_Creds *creds); +int sanctions_list_pack(uint8_t *_Nonnull data, uint16_t length, const Mod_Sanction *_Nullable sanctions, uint16_t num_sanctions, + const Mod_Sanction_Creds *_Nullable creds); /** @brief Unpacks sanctions and new sanctions credentials. * * @param sanctions The sanctions array the sanctions data is unpacked into. @@ -187,15 +187,15 @@ int sanctions_list_pack(non_null() uint8_t *data, uint16_t length, nullable() co * @retval The number of unpacked entries on success. * @retval -1 on failure. */ -int sanctions_list_unpack(non_null() Mod_Sanction *sanctions, non_null() Mod_Sanction_Creds *creds, uint16_t max_sanctions, - non_null() const uint8_t *data, uint16_t length, nullable() uint16_t *processed_data_len); +int sanctions_list_unpack(Mod_Sanction *_Nonnull sanctions, Mod_Sanction_Creds *_Nonnull creds, uint16_t max_sanctions, + const uint8_t *_Nonnull data, uint16_t length, uint16_t *_Nullable processed_data_len); /** @brief Packs sanction list credentials into data. * * @param data must have room for MOD_SANCTIONS_CREDS_SIZE bytes. * * Returns length of packed data. */ -uint16_t sanctions_creds_pack(non_null() const Mod_Sanction_Creds *creds, non_null() uint8_t *data); +uint16_t sanctions_creds_pack(const Mod_Sanction_Creds *_Nonnull creds, uint8_t *_Nonnull data); /** @brief Unpacks sanctions credentials into creds from data. * @@ -203,7 +203,7 @@ uint16_t sanctions_creds_pack(non_null() const Mod_Sanction_Creds *creds, non_nu * * Returns the length of the data processed. */ -uint16_t sanctions_creds_unpack(non_null() Mod_Sanction_Creds *creds, non_null() const uint8_t *data); +uint16_t sanctions_creds_unpack(Mod_Sanction_Creds *_Nonnull creds, const uint8_t *_Nonnull data); /** @brief Updates sanction list credentials. * @@ -212,14 +212,14 @@ uint16_t sanctions_creds_unpack(non_null() Mod_Sanction_Creds *creds, non_null() * * Returns true on success. */ -bool sanctions_list_make_creds(non_null() Moderation *moderation); +bool sanctions_list_make_creds(Moderation *_Nonnull moderation); /** @brief Validates all sanctions list entries as well as the list itself. * * Returns true if all entries are valid. * Returns false if one or more entries are invalid. */ -bool sanctions_list_check_integrity(non_null() const Moderation *moderation, non_null() const Mod_Sanction_Creds *creds, non_null() const Mod_Sanction *sanctions, uint16_t num_sanctions); +bool sanctions_list_check_integrity(const Moderation *_Nonnull moderation, const Mod_Sanction_Creds *_Nonnull creds, const Mod_Sanction *_Nonnull sanctions, uint16_t num_sanctions); /** @brief Adds an entry to the sanctions list. * @@ -230,20 +230,20 @@ bool sanctions_list_check_integrity(non_null() const Moderation *moderation, non * * Returns true on success. */ -bool sanctions_list_add_entry(non_null() Moderation *moderation, non_null() const Mod_Sanction *sanction, nullable() const Mod_Sanction_Creds *creds); +bool sanctions_list_add_entry(Moderation *_Nonnull moderation, const Mod_Sanction *_Nonnull sanction, const Mod_Sanction_Creds *_Nullable creds); /** @brief Creates a new sanction entry for `public_key` where type is one of Mod_Sanction_Type. * * New entry is signed and placed in the sanctions list. * * Returns true on success. */ -bool sanctions_list_make_entry(non_null() Moderation *moderation, non_null() const uint8_t *public_key, non_null() Mod_Sanction *sanction, uint8_t type); +bool sanctions_list_make_entry(Moderation *_Nonnull moderation, const uint8_t *_Nonnull public_key, Mod_Sanction *_Nonnull sanction, uint8_t type); /** @return true if public key is in the observer list. */ -bool sanctions_list_is_observer(non_null() const Moderation *moderation, non_null() const uint8_t *public_key); +bool sanctions_list_is_observer(const Moderation *_Nonnull moderation, const uint8_t *_Nonnull public_key); /** @return true if sanction already exists in the sanctions list. */ -bool sanctions_list_entry_exists(non_null() const Moderation *moderation, non_null() const Mod_Sanction *sanction); +bool sanctions_list_entry_exists(const Moderation *_Nonnull moderation, const Mod_Sanction *_Nonnull sanction); /** @brief Removes observer entry for public key from sanction list. * @@ -251,17 +251,17 @@ bool sanctions_list_entry_exists(non_null() const Moderation *moderation, non_nu * * Returns false on failure or if entry was not found. */ -bool sanctions_list_remove_observer(non_null() Moderation *moderation, non_null() const uint8_t *public_key, - nullable() const Mod_Sanction_Creds *creds); +bool sanctions_list_remove_observer(Moderation *_Nonnull moderation, const uint8_t *_Nonnull public_key, + const Mod_Sanction_Creds *_Nullable creds); /** @brief Replaces all sanctions list signatures made by public_sig_key with the caller's. * * This is called whenever the founder demotes a moderator. * * Returns the number of entries re-signed. */ -uint16_t sanctions_list_replace_sig(non_null() Moderation *moderation, non_null() const uint8_t *public_sig_key); +uint16_t sanctions_list_replace_sig(Moderation *_Nonnull moderation, const uint8_t *_Nonnull public_sig_key); -void sanctions_list_cleanup(non_null() Moderation *moderation); +void sanctions_list_cleanup(Moderation *_Nonnull moderation); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/group_onion_announce.c b/toxcore/group_onion_announce.c index 15f2cbdbd..059931a44 100644 --- a/toxcore/group_onion_announce.c +++ b/toxcore/group_onion_announce.c @@ -28,8 +28,8 @@ static_assert(GCA_ANNOUNCE_MAX_SIZE <= ONION_MAX_EXTRA_DATA_SIZE, "GC_Announce does not fit into the onion packet extra data"); static pack_extra_data_cb pack_group_announces; -static int pack_group_announces(non_null() void *object, non_null() const Logger *logger, non_null() const Memory *mem, non_null() const Mono_Time *mono_time, uint8_t num_nodes, - non_null() uint8_t *plain, uint16_t plain_size, non_null() uint8_t *response, uint16_t response_size, uint16_t offset) +static int pack_group_announces(void *_Nonnull object, const Logger *_Nonnull logger, const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, uint8_t num_nodes, + uint8_t *_Nonnull plain, uint16_t plain_size, uint8_t *_Nonnull response, uint16_t response_size, uint16_t offset) { GC_Announces_List *gc_announces_list = (GC_Announces_List *)object; GC_Public_Announce public_announce; diff --git a/toxcore/group_onion_announce.h b/toxcore/group_onion_announce.h index ffebcc953..4ebd702c9 100644 --- a/toxcore/group_onion_announce.h +++ b/toxcore/group_onion_announce.h @@ -12,10 +12,10 @@ #include "mem.h" #include "onion_announce.h" -void gca_onion_init(non_null() GC_Announces_List *group_announce, non_null() Onion_Announce *onion_a); +void gca_onion_init(GC_Announces_List *_Nonnull group_announce, Onion_Announce *_Nonnull onion_a); -int create_gca_announce_request(non_null() const Memory *mem, non_null() const Random *rng, non_null() uint8_t *packet, uint16_t max_packet_length, non_null() const uint8_t *dest_client_id, - non_null() const uint8_t *public_key, non_null() const uint8_t *secret_key, non_null() const uint8_t *ping_id, non_null() const uint8_t *client_id, non_null() const uint8_t *data_public_key, - uint64_t sendback_data, non_null() const uint8_t *gc_data, uint16_t gc_data_length); +int create_gca_announce_request(const Memory *_Nonnull mem, const Random *_Nonnull rng, uint8_t *_Nonnull packet, uint16_t max_packet_length, const uint8_t *_Nonnull dest_client_id, + const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull secret_key, const uint8_t *_Nonnull ping_id, const uint8_t *_Nonnull client_id, const uint8_t *_Nonnull data_public_key, + uint64_t sendback_data, const uint8_t *_Nonnull gc_data, uint16_t gc_data_length); #endif /* C_TOXCORE_TOXCORE_GROUP_ONION_ANNOUNCE_H */ diff --git a/toxcore/group_pack.c b/toxcore/group_pack.c index 152a7fa32..03e94b568 100644 --- a/toxcore/group_pack.c +++ b/toxcore/group_pack.c @@ -74,7 +74,7 @@ bool group_voice_state_from_int(uint8_t value, Group_Voice_State *out_enum) } } -static bool load_unpack_state_values(non_null() GC_Chat *chat, non_null() Bin_Unpack *bu) +static bool load_unpack_state_values(GC_Chat *_Nonnull chat, Bin_Unpack *_Nonnull bu) { if (!bin_unpack_array_fixed(bu, 8, nullptr)) { LOGGER_ERROR(chat->log, "Group state values array malformed"); @@ -109,7 +109,7 @@ static bool load_unpack_state_values(non_null() GC_Chat *chat, non_null() Bin_Un return true; } -static bool load_unpack_state_bin(non_null() GC_Chat *chat, non_null() Bin_Unpack *bu) +static bool load_unpack_state_bin(GC_Chat *_Nonnull chat, Bin_Unpack *_Nonnull bu) { if (!bin_unpack_array_fixed(bu, 5, nullptr)) { LOGGER_ERROR(chat->log, "Group state binary array malformed"); @@ -136,7 +136,7 @@ static bool load_unpack_state_bin(non_null() GC_Chat *chat, non_null() Bin_Unpac return true; } -static bool load_unpack_topic_info(non_null() GC_Chat *chat, non_null() Bin_Unpack *bu) +static bool load_unpack_topic_info(GC_Chat *_Nonnull chat, Bin_Unpack *_Nonnull bu) { if (!bin_unpack_array_fixed(bu, 6, nullptr)) { LOGGER_ERROR(chat->log, "Group topic array malformed"); @@ -156,7 +156,7 @@ static bool load_unpack_topic_info(non_null() GC_Chat *chat, non_null() Bin_Unpa return true; } -static bool load_unpack_mod_list(non_null() GC_Chat *chat, non_null() Bin_Unpack *bu) +static bool load_unpack_mod_list(GC_Chat *_Nonnull chat, Bin_Unpack *_Nonnull bu) { uint32_t actual_size = 0; if (!bin_unpack_array_fixed(bu, 2, &actual_size)) { @@ -205,7 +205,7 @@ static bool load_unpack_mod_list(non_null() GC_Chat *chat, non_null() Bin_Unpack return true; } -static bool load_unpack_keys(non_null() GC_Chat *chat, non_null() Bin_Unpack *bu) +static bool load_unpack_keys(GC_Chat *_Nonnull chat, Bin_Unpack *_Nonnull bu) { if (!bin_unpack_array_fixed(bu, 4, nullptr)) { LOGGER_ERROR(chat->log, "Group keys array malformed"); @@ -223,7 +223,7 @@ static bool load_unpack_keys(non_null() GC_Chat *chat, non_null() Bin_Unpack *bu return true; } -static bool load_unpack_self_info(non_null() GC_Chat *chat, non_null() Bin_Unpack *bu) +static bool load_unpack_self_info(GC_Chat *_Nonnull chat, Bin_Unpack *_Nonnull bu) { if (!bin_unpack_array_fixed(bu, 4, nullptr)) { LOGGER_ERROR(chat->log, "Group self info array malformed"); @@ -275,7 +275,7 @@ static bool load_unpack_self_info(non_null() GC_Chat *chat, non_null() Bin_Unpac return true; } -static bool load_unpack_saved_peers(non_null() GC_Chat *chat, non_null() Bin_Unpack *bu) +static bool load_unpack_saved_peers(GC_Chat *_Nonnull chat, Bin_Unpack *_Nonnull bu) { if (!bin_unpack_array_fixed(bu, 2, nullptr)) { LOGGER_ERROR(chat->log, "Group saved peers array malformed"); @@ -334,7 +334,7 @@ bool gc_load_unpack_group(GC_Chat *chat, Bin_Unpack *bu) && load_unpack_saved_peers(chat, bu); } -static void save_pack_state_values(non_null() const GC_Chat *chat, non_null() Bin_Pack *bp) +static void save_pack_state_values(const GC_Chat *_Nonnull chat, Bin_Pack *_Nonnull bp) { bin_pack_array(bp, 8); bin_pack_bool(bp, chat->connection_state == CS_DISCONNECTED); // 1 @@ -347,7 +347,7 @@ static void save_pack_state_values(non_null() const GC_Chat *chat, non_null() Bi bin_pack_u08(bp, chat->shared_state.voice_state); // 8 } -static void save_pack_state_bin(non_null() const GC_Chat *chat, non_null() Bin_Pack *bp) +static void save_pack_state_bin(const GC_Chat *_Nonnull chat, Bin_Pack *_Nonnull bp) { bin_pack_array(bp, 5); @@ -358,7 +358,7 @@ static void save_pack_state_bin(non_null() const GC_Chat *chat, non_null() Bin_P bin_pack_bin(bp, chat->shared_state.mod_list_hash, MOD_MODERATION_HASH_SIZE); // 5 } -static void save_pack_topic_info(non_null() const GC_Chat *chat, non_null() Bin_Pack *bp) +static void save_pack_topic_info(const GC_Chat *_Nonnull chat, Bin_Pack *_Nonnull bp) { bin_pack_array(bp, 6); @@ -370,7 +370,7 @@ static void save_pack_topic_info(non_null() const GC_Chat *chat, non_null() Bin_ bin_pack_bin(bp, chat->topic_sig, SIGNATURE_SIZE); // 6 } -static void save_pack_mod_list(non_null() const GC_Chat *chat, non_null() Bin_Pack *bp) +static void save_pack_mod_list(const GC_Chat *_Nonnull chat, Bin_Pack *_Nonnull bp) { bin_pack_array(bp, 2); @@ -403,7 +403,7 @@ static void save_pack_mod_list(non_null() const GC_Chat *chat, non_null() Bin_Pa mem_delete(chat->mem, packed_mod_list); } -static void save_pack_keys(non_null() const GC_Chat *chat, non_null() Bin_Pack *bp) +static void save_pack_keys(const GC_Chat *_Nonnull chat, Bin_Pack *_Nonnull bp) { bin_pack_array(bp, 4); @@ -413,7 +413,7 @@ static void save_pack_keys(non_null() const GC_Chat *chat, non_null() Bin_Pack * pack_extended_secret_key(&chat->self_secret_key, bp); // 4 } -static void save_pack_self_info(non_null() const GC_Chat *chat, non_null() Bin_Pack *bp) +static void save_pack_self_info(const GC_Chat *_Nonnull chat, Bin_Pack *_Nonnull bp) { bin_pack_array(bp, 4); @@ -430,7 +430,7 @@ static void save_pack_self_info(non_null() const GC_Chat *chat, non_null() Bin_P bin_pack_bin(bp, self->nick, self->nick_length); // 4 } -static void save_pack_saved_peers(non_null() const GC_Chat *chat, non_null() Bin_Pack *bp) +static void save_pack_saved_peers(const GC_Chat *_Nonnull chat, Bin_Pack *_Nonnull bp) { bin_pack_array(bp, 2); diff --git a/toxcore/group_pack.h b/toxcore/group_pack.h index 7e6932de5..cc0e5b8c4 100644 --- a/toxcore/group_pack.h +++ b/toxcore/group_pack.h @@ -21,7 +21,7 @@ * Packs group data from `chat` into `mp` in binary format. Parallel to the * `gc_load_unpack_group` function. */ -void gc_save_pack_group(non_null() const GC_Chat *chat, non_null() Bin_Pack *bp); +void gc_save_pack_group(const GC_Chat *_Nonnull chat, Bin_Pack *_Nonnull bp); /** * Unpacks binary group data from `obj` into `chat`. Parallel to the `gc_save_pack_group` @@ -29,9 +29,9 @@ void gc_save_pack_group(non_null() const GC_Chat *chat, non_null() Bin_Pack *bp) * * Return true if unpacking is successful. */ -bool gc_load_unpack_group(non_null() GC_Chat *chat, non_null() Bin_Unpack *bu); +bool gc_load_unpack_group(GC_Chat *_Nonnull chat, Bin_Unpack *_Nonnull bu); -bool group_privacy_state_from_int(uint8_t value, non_null() Group_Privacy_State *out_enum); -bool group_voice_state_from_int(uint8_t value, non_null() Group_Voice_State *out_enum); +bool group_privacy_state_from_int(uint8_t value, Group_Privacy_State *_Nonnull out_enum); +bool group_voice_state_from_int(uint8_t value, Group_Voice_State *_Nonnull out_enum); #endif /* C_TOXCORE_TOXCORE_GROUP_PACK_H */ diff --git a/toxcore/list.c b/toxcore/list.c index 7ddfacf9e..66330b0c1 100644 --- a/toxcore/list.c +++ b/toxcore/list.c @@ -41,7 +41,7 @@ static int32_t list_index(uint32_t i) * @retval <0 no match, returns index (return value is `list_index(index)`) where * the data should be inserted */ -static int find(non_null() const BS_List *list, non_null() const uint8_t *data) +static int find(const BS_List *_Nonnull list, const uint8_t *_Nonnull data) { // should work well, but could be improved if (list->n == 0) { @@ -59,7 +59,7 @@ static int find(non_null() const BS_List *list, non_null() const uint8_t *data) // closest match is found if we move back to where we have already been while (true) { - const int r = list->cmp_callback(data, list->data + list->element_size * i, list->element_size); + const int r = list->cmp_callback(data, (const void *_Nonnull)(list->data + list->element_size * i), list->element_size); if (r == 0) { return i; @@ -106,7 +106,7 @@ static int find(non_null() const BS_List *list, non_null() const uint8_t *data) * * @return true on success. */ -static bool resize(non_null() BS_List *list, uint32_t new_size) +static bool resize(BS_List *_Nonnull list, uint32_t new_size) { if (new_size == 0) { bs_list_free(list); diff --git a/toxcore/list.h b/toxcore/list.h index 71559ac2e..168cbe3ed 100644 --- a/toxcore/list.h +++ b/toxcore/list.h @@ -22,17 +22,17 @@ extern "C" { #endif -typedef int bs_list_cmp_cb(const void *a, const void *b, size_t size); +typedef int bs_list_cmp_cb(const void *_Nonnull a, const void *_Nonnull b, size_t size); typedef struct BS_List { - const Memory *mem; + const Memory *_Nonnull mem; uint32_t n; // number of elements uint32_t capacity; // number of elements memory is allocated for uint32_t element_size; // size of the elements - uint8_t *data; // array of elements - int *ids; // array of element ids - bs_list_cmp_cb *cmp_callback; + uint8_t *_Nullable data; // array of elements + int *_Nullable ids; // array of element ids + bs_list_cmp_cb *_Nullable cmp_callback; } BS_List; /** @brief Initialize a list. @@ -43,30 +43,30 @@ typedef struct BS_List { * @retval 1 success * @retval 0 failure */ -int bs_list_init(non_null() BS_List *list, non_null() const Memory *mem, uint32_t element_size, uint32_t initial_capacity, non_null() bs_list_cmp_cb *cmp_callback); +int bs_list_init(BS_List *_Nonnull list, const Memory *_Nonnull mem, uint32_t element_size, uint32_t initial_capacity, bs_list_cmp_cb *_Nonnull cmp_callback); /** Free a list initiated with list_init */ -void bs_list_free(nullable() BS_List *list); +void bs_list_free(BS_List *_Nullable list); /** @brief Retrieve the id of an element in the list * * @retval >=0 id associated with data * @retval -1 failure */ -int bs_list_find(non_null() const BS_List *list, non_null() const uint8_t *data); +int bs_list_find(const BS_List *_Nonnull list, const uint8_t *_Nonnull data); /** @brief Add an element with associated id to the list * * @retval true success * @retval false failure (data already in list) */ -bool bs_list_add(non_null() BS_List *list, non_null() const uint8_t *data, int id); +bool bs_list_add(BS_List *_Nonnull list, const uint8_t *_Nonnull data, int id); /** @brief Remove element from the list * * @retval true success * @retval false failure (element not found or id does not match) */ -bool bs_list_remove(non_null() BS_List *list, non_null() const uint8_t *data, int id); +bool bs_list_remove(BS_List *_Nonnull list, const uint8_t *_Nonnull data, int id); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/logger.h b/toxcore/logger.h index 6871de5ba..060c189f0 100644 --- a/toxcore/logger.h +++ b/toxcore/logger.h @@ -33,23 +33,23 @@ typedef enum Logger_Level { typedef struct Logger Logger; -typedef void logger_cb(void *context, Logger_Level level, const char *file, uint32_t line, - const char *func, const char *message, void *userdata); +typedef void logger_cb(void *_Nullable context, Logger_Level level, const char *_Nonnull file, uint32_t line, + const char *_Nonnull func, const char *_Nonnull message, void *_Nullable userdata); /** * Creates a new logger with logging disabled (callback is NULL) by default. */ -Logger *logger_new(non_null() const Memory *mem); +Logger *_Nullable logger_new(const Memory *_Nonnull mem); /** * Frees all resources associated with the logger. */ -void logger_kill(nullable() Logger *log); +void logger_kill(Logger *_Nullable log); /** * Sets the logger callback. Disables logging if set to NULL. * The context parameter is passed to the callback as first argument. */ -void logger_callback_log(non_null() Logger *log, nullable() logger_cb *function, nullable() void *context, nullable() void *userdata); +void logger_callback_log(Logger *_Nonnull log, logger_cb *_Nullable function, void *_Nullable context, void *_Nullable userdata); /** @brief Main write function. If logging is disabled, this does nothing. * * If the logger is NULL and `NDEBUG` is not defined, this writes to stderr. @@ -60,7 +60,7 @@ void logger_callback_log(non_null() Logger *log, nullable() logger_cb *function, * If `NDEBUG` is defined, the NULL logger does nothing. */ GNU_PRINTF(6, 7) -void logger_write(nullable() const Logger *log, Logger_Level level, non_null() const char *file, uint32_t line, non_null() const char *func, non_null() const char *format, ...); +void logger_write(const Logger *_Nullable log, Logger_Level level, const char *_Nonnull file, uint32_t line, const char *_Nonnull func, const char *_Nonnull format, ...); /* @brief Terminate the program with a signal. */ void logger_abort(void); diff --git a/toxcore/mem.c b/toxcore/mem.c index 30dc6b0b4..31aa4c9e5 100644 --- a/toxcore/mem.c +++ b/toxcore/mem.c @@ -10,22 +10,22 @@ #include "attributes.h" #include "ccompat.h" -static void *sys_malloc(nullable() void *obj, uint32_t size) +static void *sys_malloc(void *_Nullable obj, uint32_t size) { return malloc(size); } -static void *sys_calloc(nullable() void *obj, uint32_t nmemb, uint32_t size) +static void *sys_calloc(void *_Nullable obj, uint32_t nmemb, uint32_t size) { return calloc(nmemb, size); } -static void *sys_realloc(nullable() void *obj, nullable() void *ptr, uint32_t size) +static void *sys_realloc(void *_Nullable obj, void *_Nullable ptr, uint32_t size) { return realloc(ptr, size); } -static void sys_free(nullable() void *obj, nullable() void *ptr) +static void sys_free(void *_Nullable obj, void *_Nullable ptr) { free(ptr); } diff --git a/toxcore/mem.h b/toxcore/mem.h index 0f631dd0b..a8a4eff99 100644 --- a/toxcore/mem.h +++ b/toxcore/mem.h @@ -17,25 +17,25 @@ extern "C" { #endif -typedef void *mem_malloc_cb(void *obj, uint32_t size); -typedef void *mem_calloc_cb(void *obj, uint32_t nmemb, uint32_t size); -typedef void *mem_realloc_cb(void *obj, void *ptr, uint32_t size); -typedef void mem_free_cb(void *obj, void *ptr); +typedef void *mem_malloc_cb(void *_Nullable obj, uint32_t size); +typedef void *mem_calloc_cb(void *_Nullable obj, uint32_t nmemb, uint32_t size); +typedef void *mem_realloc_cb(void *_Nullable obj, void *_Nullable ptr, uint32_t size); +typedef void mem_free_cb(void *_Nullable obj, void *_Nullable ptr); /** @brief Functions wrapping standard C memory allocation functions. */ typedef struct Memory_Funcs { - mem_malloc_cb *malloc; - mem_calloc_cb *calloc; - mem_realloc_cb *realloc; - mem_free_cb *free; + mem_malloc_cb *_Nullable malloc; + mem_calloc_cb *_Nullable calloc; + mem_realloc_cb *_Nullable realloc; + mem_free_cb *_Nullable free; } Memory_Funcs; typedef struct Memory { - const Memory_Funcs *funcs; - void *obj; + const Memory_Funcs *_Nullable funcs; + void *_Nullable obj; } Memory; -const Memory *os_memory(void); +const Memory *_Nullable os_memory(void); /** * @brief Allocate an array of a given size for built-in types. @@ -43,7 +43,7 @@ const Memory *os_memory(void); * The array will not be initialised. Supported built-in types are * `uint8_t`, `int8_t`, and `int16_t`. */ -void *mem_balloc(non_null() const Memory *mem, uint32_t size); +void *_Nullable mem_balloc(const Memory *_Nonnull mem, uint32_t size); /** * @brief Resize an array of a given size for built-in types. @@ -51,21 +51,21 @@ void *mem_balloc(non_null() const Memory *mem, uint32_t size); * If used for a type other than byte-sized types, `size` needs to be manually * multiplied by the element size. */ -void *mem_brealloc(non_null() const Memory *mem, nullable() void *ptr, uint32_t size); +void *_Nullable mem_brealloc(const Memory *_Nonnull mem, void *_Nullable ptr, uint32_t size); /** * @brief Allocate a single object. * * Always use as `(T *)mem_alloc(mem, sizeof(T))`. */ -void *mem_alloc(non_null() const Memory *mem, uint32_t size); +void *_Nullable mem_alloc(const Memory *_Nonnull mem, uint32_t size); /** * @brief Allocate a vector (array) of objects. * * Always use as `(T *)mem_valloc(mem, N, sizeof(T))`. */ -void *mem_valloc(non_null() const Memory *mem, uint32_t nmemb, uint32_t size); +void *_Nullable mem_valloc(const Memory *_Nonnull mem, uint32_t nmemb, uint32_t size); /** * @brief Resize an object vector. @@ -82,10 +82,10 @@ void *mem_valloc(non_null() const Memory *mem, uint32_t nmemb, uint32_t size); * case where the multiplication would overflow. If such an overflow occurs, * `mem_vrealloc()` returns `nullptr`. */ -void *mem_vrealloc(non_null() const Memory *mem, nullable() void *ptr, uint32_t nmemb, uint32_t size); +void *_Nullable mem_vrealloc(const Memory *_Nonnull mem, void *_Nullable ptr, uint32_t nmemb, uint32_t size); /** @brief Free an array, object, or object vector. */ -void mem_delete(non_null() const Memory *mem, nullable() void *ptr); +void mem_delete(const Memory *_Nonnull mem, void *_Nullable ptr); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/mono_time.c b/toxcore/mono_time.c index 7c73eb47d..6e1ea375c 100644 --- a/toxcore/mono_time.c +++ b/toxcore/mono_time.c @@ -57,7 +57,7 @@ static uint64_t timespec_to_u64(struct timespec clock_mono) } #ifdef OS_WIN32 -static uint64_t current_time_monotonic_default(non_null() void *user_data) +static uint64_t current_time_monotonic_default(void *_Nonnull user_data) { LARGE_INTEGER freq; LARGE_INTEGER count; @@ -78,7 +78,7 @@ static uint64_t current_time_monotonic_default(non_null() void *user_data) } #else #ifdef __APPLE__ -static uint64_t current_time_monotonic_default(non_null() void *user_data) +static uint64_t current_time_monotonic_default(void *_Nonnull user_data) { struct timespec clock_mono; clock_serv_t muhclock; @@ -93,7 +93,7 @@ static uint64_t current_time_monotonic_default(non_null() void *user_data) return timespec_to_u64(clock_mono); } #else // !__APPLE__ -static uint64_t current_time_monotonic_default(non_null() void *user_data) +static uint64_t current_time_monotonic_default(void *_Nonnull user_data) { #ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION // This assert should always fail. If it does, the fuzzing harness didn't diff --git a/toxcore/mono_time.h b/toxcore/mono_time.h index 558691b55..cb2430931 100644 --- a/toxcore/mono_time.h +++ b/toxcore/mono_time.h @@ -46,39 +46,39 @@ extern "C" { */ typedef struct Mono_Time Mono_Time; -typedef uint64_t mono_time_current_time_cb(void *user_data); +typedef uint64_t mono_time_current_time_cb(void *_Nullable user_data); -Mono_Time *mono_time_new(non_null() const Memory *mem, nullable() mono_time_current_time_cb *current_time_callback, nullable() void *user_data); -void mono_time_free(non_null() const Memory *mem, nullable() Mono_Time *mono_time); +Mono_Time *_Nullable mono_time_new(const Memory *_Nonnull mem, mono_time_current_time_cb *_Nullable current_time_callback, void *_Nullable user_data); +void mono_time_free(const Memory *_Nonnull mem, Mono_Time *_Nullable mono_time); /** * Update mono_time; subsequent calls to mono_time_get or mono_time_is_timeout * will use the time at the call to mono_time_update. */ -void mono_time_update(non_null() Mono_Time *mono_time); +void mono_time_update(Mono_Time *_Nonnull mono_time); /** @brief Return current monotonic time in milliseconds (ms). * * The starting point is UNIX epoch as measured by `time()` in `mono_time_new()`. */ -uint64_t mono_time_get_ms(non_null() const Mono_Time *mono_time); +uint64_t mono_time_get_ms(const Mono_Time *_Nonnull mono_time); /** @brief Return a monotonically increasing time in seconds. * * The starting point is UNIX epoch as measured by `time()` in `mono_time_new()`. */ -uint64_t mono_time_get(non_null() const Mono_Time *mono_time); +uint64_t mono_time_get(const Mono_Time *_Nonnull mono_time); /** * Return true iff timestamp is at least timeout seconds in the past. */ -bool mono_time_is_timeout(non_null() const Mono_Time *mono_time, uint64_t timestamp, uint64_t timeout); +bool mono_time_is_timeout(const Mono_Time *_Nonnull mono_time, uint64_t timestamp, uint64_t timeout); /** @brief Return current monotonic time in milliseconds (ms). * * The starting point is unspecified and in particular is likely not comparable * to the return value of `mono_time_get_ms()`. */ -uint64_t current_time_monotonic(non_null() const Mono_Time *mono_time); +uint64_t current_time_monotonic(const Mono_Time *_Nonnull mono_time); /** * Override implementation of `current_time_monotonic()` (for tests). @@ -86,8 +86,8 @@ uint64_t current_time_monotonic(non_null() const Mono_Time *mono_time); * The caller is obligated to ensure that `current_time_monotonic()` continues * to increase monotonically. */ -void mono_time_set_current_time_callback(non_null() Mono_Time *mono_time, - nullable() mono_time_current_time_cb *current_time_callback, nullable() void *user_data); +void mono_time_set_current_time_callback(Mono_Time *_Nonnull mono_time, + mono_time_current_time_cb *_Nullable current_time_callback, void *_Nullable user_data); #ifdef __cplusplus } /* extern "C" */ #endif diff --git a/toxcore/net_crypto.c b/toxcore/net_crypto.c index cd5d76f76..6815a13ab 100644 --- a/toxcore/net_crypto.c +++ b/toxcore/net_crypto.c @@ -181,7 +181,7 @@ DHT *nc_get_dht(const Net_Crypto *c) return c->dht; } -static bool crypt_connection_id_is_valid(non_null() const Net_Crypto *c, int crypt_connection_id) +static bool crypt_connection_id_is_valid(const Net_Crypto *_Nonnull c, int crypt_connection_id) { if ((uint32_t)crypt_connection_id >= c->crypto_connections_length) { return false; @@ -215,7 +215,7 @@ static bool crypt_connection_id_is_valid(non_null() const Net_Crypto *c, int cry * @retval -1 on failure. * @retval COOKIE_REQUEST_LENGTH on success. */ -static int create_cookie_request(non_null() const Net_Crypto *c, non_null() uint8_t *packet, non_null() const uint8_t *dht_public_key, uint64_t number, non_null() uint8_t *shared_key) +static int create_cookie_request(const Net_Crypto *_Nonnull c, uint8_t *_Nonnull packet, const uint8_t *_Nonnull dht_public_key, uint64_t number, uint8_t *_Nonnull shared_key) { uint8_t plain[COOKIE_REQUEST_PLAIN_LENGTH]; @@ -244,8 +244,8 @@ static int create_cookie_request(non_null() const Net_Crypto *c, non_null() uint * @retval -1 on failure. * @retval 0 on success. */ -static int create_cookie(non_null() const Memory *mem, non_null() const Random *rng, non_null() const Mono_Time *mono_time, non_null() uint8_t *cookie, non_null() const uint8_t *bytes, - non_null() const uint8_t *encryption_key) +static int create_cookie(const Memory *_Nonnull mem, const Random *_Nonnull rng, const Mono_Time *_Nonnull mono_time, uint8_t *_Nonnull cookie, const uint8_t *_Nonnull bytes, + const uint8_t *_Nonnull encryption_key) { uint8_t contents[COOKIE_CONTENTS_LENGTH]; const uint64_t temp_time = mono_time_get(mono_time); @@ -266,7 +266,7 @@ static int create_cookie(non_null() const Memory *mem, non_null() const Random * * @retval -1 on failure. * @retval 0 on success. */ -static int open_cookie(non_null() const Memory *mem, non_null() const Mono_Time *mono_time, non_null() uint8_t *bytes, non_null() const uint8_t *cookie, non_null() const uint8_t *encryption_key) +static int open_cookie(const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, uint8_t *_Nonnull bytes, const uint8_t *_Nonnull cookie, const uint8_t *_Nonnull encryption_key) { uint8_t contents[COOKIE_CONTENTS_LENGTH]; const int len = decrypt_data_symmetric(mem, encryption_key, cookie, cookie + CRYPTO_NONCE_SIZE, @@ -295,8 +295,8 @@ static int open_cookie(non_null() const Memory *mem, non_null() const Mono_Time * @retval -1 on failure. * @retval COOKIE_RESPONSE_LENGTH on success. */ -static int create_cookie_response(non_null() const Net_Crypto *c, non_null() uint8_t *packet, non_null() const uint8_t *request_plain, non_null() const uint8_t *shared_key, - non_null() const uint8_t *dht_public_key) +static int create_cookie_response(const Net_Crypto *_Nonnull c, uint8_t *_Nonnull packet, const uint8_t *_Nonnull request_plain, const uint8_t *_Nonnull shared_key, + const uint8_t *_Nonnull dht_public_key) { uint8_t cookie_plain[COOKIE_DATA_LENGTH]; memcpy(cookie_plain, request_plain, CRYPTO_PUBLIC_KEY_SIZE); @@ -326,8 +326,8 @@ static int create_cookie_response(non_null() const Net_Crypto *c, non_null() uin * @retval -1 on failure. * @retval 0 on success. */ -static int handle_cookie_request(non_null() const Net_Crypto *c, non_null() uint8_t *request_plain, non_null() uint8_t *shared_key, non_null() uint8_t *dht_public_key, - non_null() const uint8_t *packet, uint16_t length) +static int handle_cookie_request(const Net_Crypto *_Nonnull c, uint8_t *_Nonnull request_plain, uint8_t *_Nonnull shared_key, uint8_t *_Nonnull dht_public_key, + const uint8_t *_Nonnull packet, uint16_t length) { if (length != COOKIE_REQUEST_LENGTH) { return -1; @@ -348,8 +348,8 @@ static int handle_cookie_request(non_null() const Net_Crypto *c, non_null() uint } /** Handle the cookie request packet (for raw UDP) */ -static int udp_handle_cookie_request(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int udp_handle_cookie_request(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nullable userdata) { const Net_Crypto *c = (const Net_Crypto *)object; uint8_t request_plain[COOKIE_REQUEST_PLAIN_LENGTH]; @@ -374,7 +374,7 @@ static int udp_handle_cookie_request(non_null() void *object, non_null() const I } /** Handle the cookie request packet (for TCP) */ -static int tcp_handle_cookie_request(non_null() const Net_Crypto *c, int connections_number, non_null() const uint8_t *packet, uint16_t length) +static int tcp_handle_cookie_request(const Net_Crypto *_Nonnull c, int connections_number, const uint8_t *_Nonnull packet, uint16_t length) { uint8_t request_plain[COOKIE_REQUEST_PLAIN_LENGTH]; uint8_t shared_key[CRYPTO_SHARED_KEY_SIZE]; @@ -395,7 +395,7 @@ static int tcp_handle_cookie_request(non_null() const Net_Crypto *c, int connect } /** Handle the cookie request packet (for TCP oob packets) */ -static int tcp_oob_handle_cookie_request(non_null() const Net_Crypto *c, unsigned int tcp_connections_number, non_null() const uint8_t *dht_public_key, non_null() const uint8_t *packet, +static int tcp_oob_handle_cookie_request(const Net_Crypto *_Nonnull c, unsigned int tcp_connections_number, const uint8_t *_Nonnull dht_public_key, const uint8_t *_Nonnull packet, uint16_t length) { uint8_t request_plain[COOKIE_REQUEST_PLAIN_LENGTH]; @@ -428,8 +428,8 @@ static int tcp_oob_handle_cookie_request(non_null() const Net_Crypto *c, unsigne * @retval -1 on failure. * @retval COOKIE_LENGTH on success. */ -static int handle_cookie_response(non_null() const Memory *mem, non_null() uint8_t *cookie, non_null() uint64_t *number, non_null() const uint8_t *packet, uint16_t length, - non_null() const uint8_t *shared_key) +static int handle_cookie_response(const Memory *_Nonnull mem, uint8_t *_Nonnull cookie, uint64_t *_Nonnull number, const uint8_t *_Nonnull packet, uint16_t length, + const uint8_t *_Nonnull shared_key) { if (length != COOKIE_RESPONSE_LENGTH) { return -1; @@ -457,8 +457,8 @@ static int handle_cookie_response(non_null() const Memory *mem, non_null() uint8 * @retval -1 on failure. * @retval HANDSHAKE_PACKET_LENGTH on success. */ -static int create_crypto_handshake(non_null() const Net_Crypto *c, non_null() uint8_t *packet, non_null() const uint8_t *cookie, non_null() const uint8_t *nonce, non_null() const uint8_t *session_pk, - non_null() const uint8_t *peer_real_pk, non_null() const uint8_t *peer_dht_pubkey) +static int create_crypto_handshake(const Net_Crypto *_Nonnull c, uint8_t *_Nonnull packet, const uint8_t *_Nonnull cookie, const uint8_t *_Nonnull nonce, const uint8_t *_Nonnull session_pk, + const uint8_t *_Nonnull peer_real_pk, const uint8_t *_Nonnull peer_dht_pubkey) { uint8_t plain[CRYPTO_NONCE_SIZE + CRYPTO_PUBLIC_KEY_SIZE + CRYPTO_SHA512_SIZE + COOKIE_LENGTH]; memcpy(plain, nonce, CRYPTO_NONCE_SIZE); @@ -505,8 +505,8 @@ static int create_crypto_handshake(non_null() const Net_Crypto *c, non_null() ui * @retval false on failure. * @retval true on success. */ -static bool handle_crypto_handshake(non_null() const Net_Crypto *c, non_null() uint8_t *nonce, non_null() uint8_t *session_pk, non_null() uint8_t *peer_real_pk, - non_null() uint8_t *dht_public_key, non_null() uint8_t *cookie, non_null() const uint8_t *packet, uint16_t length, nullable() const uint8_t *expected_real_pk) +static bool handle_crypto_handshake(const Net_Crypto *_Nonnull c, uint8_t *_Nonnull nonce, uint8_t *_Nonnull session_pk, uint8_t *_Nonnull peer_real_pk, + uint8_t *_Nonnull dht_public_key, uint8_t *_Nonnull cookie, const uint8_t *_Nonnull packet, uint16_t length, const uint8_t *_Nullable expected_real_pk) { if (length != HANDSHAKE_PACKET_LENGTH) { return false; @@ -546,7 +546,7 @@ static bool handle_crypto_handshake(non_null() const Net_Crypto *c, non_null() u return true; } -static Crypto_Connection *get_crypto_connection(non_null() const Net_Crypto *c, int crypt_connection_id) +static Crypto_Connection *get_crypto_connection(const Net_Crypto *_Nonnull c, int crypt_connection_id) { if (!crypt_connection_id_is_valid(c, crypt_connection_id)) { return nullptr; @@ -560,7 +560,7 @@ static Crypto_Connection *get_crypto_connection(non_null() const Net_Crypto *c, * @retval -1 on failure. * @retval 0 on success. */ -static int add_ip_port_connection(non_null() Net_Crypto *c, int crypt_connection_id, non_null() const IP_Port *ip_port) +static int add_ip_port_connection(Net_Crypto *_Nonnull c, int crypt_connection_id, const IP_Port *_Nonnull ip_port) { Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); @@ -598,7 +598,7 @@ static int add_ip_port_connection(non_null() Net_Crypto *c, int crypt_connection * @retval IP_Port with family 0 on failure. * @return IP_Port on success. */ -static IP_Port return_ip_port_connection(non_null() const Net_Crypto *c, int crypt_connection_id) +static IP_Port return_ip_port_connection(const Net_Crypto *_Nonnull c, int crypt_connection_id) { const IP_Port empty = {{{0}}}; @@ -655,7 +655,7 @@ static IP_Port return_ip_port_connection(non_null() const Net_Crypto *c, int cry * @retval -1 on failure. * @retval 0 on success. */ -static int send_packet_to(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() const uint8_t *data, uint16_t length) +static int send_packet_to(const Net_Crypto *_Nonnull c, int crypt_connection_id, const uint8_t *_Nonnull data, uint16_t length) { // TODO(irungentoo): TCP, etc... Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); @@ -714,7 +714,7 @@ static int send_packet_to(non_null() const Net_Crypto *c, int crypt_connection_i /** @brief Return number of packets in array * Note that holes are counted too. */ -static uint32_t num_packets_array(non_null() const Packets_Array *array) +static uint32_t num_packets_array(const Packets_Array *_Nonnull array) { return array->buffer_end - array->buffer_start; } @@ -724,7 +724,7 @@ static uint32_t num_packets_array(non_null() const Packets_Array *array) * @retval -1 on failure. * @retval 0 on success. */ -static int add_data_to_buffer(non_null() const Memory *mem, non_null() Packets_Array *array, uint32_t number, non_null() const Packet_Data *data) +static int add_data_to_buffer(const Memory *_Nonnull mem, Packets_Array *_Nonnull array, uint32_t number, const Packet_Data *_Nonnull data) { if (number - array->buffer_start >= CRYPTO_PACKET_BUFFER_SIZE) { return -1; @@ -758,7 +758,7 @@ static int add_data_to_buffer(non_null() const Memory *mem, non_null() Packets_A * @retval 0 if data at number is empty. * @retval 1 if data pointer was put in data. */ -static int get_data_pointer(non_null() const Packets_Array *array, non_null() Packet_Data **data, uint32_t number) +static int get_data_pointer(const Packets_Array *_Nonnull array, Packet_Data *_Nonnull *_Nonnull data, uint32_t number) { const uint32_t num_spots = num_packets_array(array); @@ -781,7 +781,7 @@ static int get_data_pointer(non_null() const Packets_Array *array, non_null() Pa * @retval -1 on failure. * @return packet number on success. */ -static int64_t add_data_end_of_buffer(non_null() const Logger *logger, non_null() const Memory *mem, non_null() Packets_Array *array, non_null() const Packet_Data *data) +static int64_t add_data_end_of_buffer(const Logger *_Nonnull logger, const Memory *_Nonnull mem, Packets_Array *_Nonnull array, const Packet_Data *_Nonnull data) { const uint32_t num_spots = num_packets_array(array); @@ -809,7 +809,7 @@ static int64_t add_data_end_of_buffer(non_null() const Logger *logger, non_null( * @retval -1 on failure. * @return packet number on success. */ -static int64_t read_data_beg_buffer(non_null() const Memory *mem, non_null() Packets_Array *array, non_null() Packet_Data *data) +static int64_t read_data_beg_buffer(const Memory *_Nonnull mem, Packets_Array *_Nonnull array, Packet_Data *_Nonnull data) { if (array->buffer_end == array->buffer_start) { return -1; @@ -834,7 +834,7 @@ static int64_t read_data_beg_buffer(non_null() const Memory *mem, non_null() Pac * @retval -1 on failure. * @retval 0 on success */ -static int clear_buffer_until(non_null() const Memory *mem, non_null() Packets_Array *array, uint32_t number) +static int clear_buffer_until(const Memory *_Nonnull mem, Packets_Array *_Nonnull array, uint32_t number) { const uint32_t num_spots = num_packets_array(array); @@ -857,7 +857,7 @@ static int clear_buffer_until(non_null() const Memory *mem, non_null() Packets_A return 0; } -static int clear_buffer(non_null() const Memory *mem, non_null() Packets_Array *array) +static int clear_buffer(const Memory *_Nonnull mem, Packets_Array *_Nonnull array) { uint32_t i; @@ -879,7 +879,7 @@ static int clear_buffer(non_null() const Memory *mem, non_null() Packets_Array * * @retval -1 on failure. * @retval 0 on success. */ -static int set_buffer_end(non_null() Packets_Array *array, uint32_t number) +static int set_buffer_end(Packets_Array *_Nonnull array, uint32_t number) { if (number - array->buffer_start > CRYPTO_PACKET_BUFFER_SIZE) { return -1; @@ -900,7 +900,7 @@ static int set_buffer_end(non_null() Packets_Array *array, uint32_t number) * @retval -1 on failure. * @return length of packet on success. */ -static int generate_request_packet(non_null() uint8_t *data, uint16_t length, non_null() const Packets_Array *recv_array) +static int generate_request_packet(uint8_t *_Nonnull data, uint16_t length, const Packets_Array *_Nonnull recv_array) { if (length == 0) { return -1; @@ -953,8 +953,8 @@ static int generate_request_packet(non_null() uint8_t *data, uint16_t length, no * @retval -1 on failure. * @return number of requested packets on success. */ -static int handle_request_packet(non_null() const Memory *mem, non_null() const Mono_Time *mono_time, non_null() Packets_Array *send_array, non_null() const uint8_t *data, uint16_t length, - non_null() uint64_t *latest_send_time, uint64_t rtt_time) +static int handle_request_packet(const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, Packets_Array *_Nonnull send_array, const uint8_t *_Nonnull data, uint16_t length, + uint64_t *_Nonnull latest_send_time, uint64_t rtt_time) { if (length == 0) { return -1; @@ -1034,7 +1034,7 @@ static int handle_request_packet(non_null() const Memory *mem, non_null() const * @retval -1 on failure. * @retval 0 on success. */ -static int send_data_packet(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() const uint8_t *data, uint16_t length) +static int send_data_packet(const Net_Crypto *_Nonnull c, int crypt_connection_id, const uint8_t *_Nonnull data, uint16_t length) { const uint16_t max_length = MAX_CRYPTO_PACKET_SIZE - (1 + sizeof(uint16_t) + CRYPTO_MAC_SIZE); @@ -1071,7 +1071,7 @@ static int send_data_packet(non_null() const Net_Crypto *c, int crypt_connection * @retval -1 on failure. * @retval 0 on success. */ -static int send_data_packet_helper(non_null() const Net_Crypto *c, int crypt_connection_id, uint32_t buffer_start, uint32_t num, non_null() const uint8_t *data, uint16_t length) +static int send_data_packet_helper(const Net_Crypto *_Nonnull c, int crypt_connection_id, uint32_t buffer_start, uint32_t num, const uint8_t *_Nonnull data, uint16_t length) { if (length == 0 || length > MAX_CRYPTO_DATA_SIZE) { LOGGER_ERROR(c->log, "zero-length or too large data packet: %d (max: %d)", length, MAX_CRYPTO_PACKET_SIZE); @@ -1091,7 +1091,7 @@ static int send_data_packet_helper(non_null() const Net_Crypto *c, int crypt_con return send_data_packet(c, crypt_connection_id, packet, packet_size); } -static int reset_max_speed_reached(non_null() const Net_Crypto *c, int crypt_connection_id) +static int reset_max_speed_reached(const Net_Crypto *_Nonnull c, int crypt_connection_id) { Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); @@ -1125,7 +1125,7 @@ static int reset_max_speed_reached(non_null() const Net_Crypto *c, int crypt_con * @retval -1 if data could not be put in packet queue. * @return positive packet number if data was put into the queue. */ -static int64_t send_lossless_packet(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() const uint8_t *data, uint16_t length, bool congestion_control) +static int64_t send_lossless_packet(const Net_Crypto *_Nonnull c, int crypt_connection_id, const uint8_t *_Nonnull data, uint16_t length, bool congestion_control) { if (length == 0 || length > MAX_CRYPTO_DATA_SIZE) { LOGGER_ERROR(c->log, "rejecting too large (or empty) packet of size %d on crypt connection %d", length, @@ -1180,7 +1180,7 @@ static int64_t send_lossless_packet(non_null() const Net_Crypto *c, int crypt_co * @brief Get the lowest 2 bytes from the nonce and convert * them to host byte format before returning them. */ -static uint16_t get_nonce_uint16(non_null() const uint8_t *nonce) +static uint16_t get_nonce_uint16(const uint8_t *_Nonnull nonce) { uint16_t num; memcpy(&num, nonce + (CRYPTO_NONCE_SIZE - sizeof(uint16_t)), sizeof(uint16_t)); @@ -1196,7 +1196,7 @@ static uint16_t get_nonce_uint16(non_null() const uint8_t *nonce) * @retval -1 on failure. * @return length of data on success. */ -static int handle_data_packet(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() uint8_t *data, non_null() const uint8_t *packet, uint16_t length) +static int handle_data_packet(const Net_Crypto *_Nonnull c, int crypt_connection_id, uint8_t *_Nonnull data, const uint8_t *_Nonnull packet, uint16_t length) { const uint16_t crypto_packet_overhead = 1 + sizeof(uint16_t) + CRYPTO_MAC_SIZE; @@ -1236,7 +1236,7 @@ static int handle_data_packet(non_null() const Net_Crypto *c, int crypt_connecti * @retval -1 on failure. * @retval 0 on success. */ -static int send_request_packet(non_null() const Net_Crypto *c, int crypt_connection_id) +static int send_request_packet(const Net_Crypto *_Nonnull c, int crypt_connection_id) { const Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); @@ -1260,7 +1260,7 @@ static int send_request_packet(non_null() const Net_Crypto *c, int crypt_connect * @retval -1 on failure. * @return number of packets sent on success. */ -static int send_requested_packets(non_null() const Net_Crypto *c, int crypt_connection_id, uint32_t max_num) +static int send_requested_packets(const Net_Crypto *_Nonnull c, int crypt_connection_id, uint32_t max_num) { if (max_num == 0) { return -1; @@ -1312,7 +1312,7 @@ static int send_requested_packets(non_null() const Net_Crypto *c, int crypt_conn * @retval -1 on failure. * @retval 0 on success. */ -static int new_temp_packet(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() const uint8_t *packet, uint16_t length) +static int new_temp_packet(const Net_Crypto *_Nonnull c, int crypt_connection_id, const uint8_t *_Nonnull packet, uint16_t length) { if (length == 0 || length > MAX_CRYPTO_PACKET_SIZE) { return -1; @@ -1347,7 +1347,7 @@ static int new_temp_packet(non_null() const Net_Crypto *c, int crypt_connection_ * @retval -1 on failure. * @retval 0 on success. */ -static int clear_temp_packet(non_null() const Net_Crypto *c, int crypt_connection_id) +static int clear_temp_packet(const Net_Crypto *_Nonnull c, int crypt_connection_id) { Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); @@ -1371,7 +1371,7 @@ static int clear_temp_packet(non_null() const Net_Crypto *c, int crypt_connectio * @retval -1 on failure. * @retval 0 on success. */ -static int send_temp_packet(non_null() const Net_Crypto *c, int crypt_connection_id) +static int send_temp_packet(const Net_Crypto *_Nonnull c, int crypt_connection_id) { Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); @@ -1398,7 +1398,7 @@ static int send_temp_packet(non_null() const Net_Crypto *c, int crypt_connection * @retval -1 on failure. * @retval 0 on success. */ -static int create_send_handshake(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() const uint8_t *cookie, non_null() const uint8_t *dht_public_key) +static int create_send_handshake(const Net_Crypto *_Nonnull c, int crypt_connection_id, const uint8_t *_Nonnull cookie, const uint8_t *_Nonnull dht_public_key) { const Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); @@ -1426,7 +1426,7 @@ static int create_send_handshake(non_null() const Net_Crypto *c, int crypt_conne * @retval -1 on failure. * @retval 0 on success. */ -static int send_kill_packet(non_null() const Net_Crypto *c, int crypt_connection_id) +static int send_kill_packet(const Net_Crypto *_Nonnull c, int crypt_connection_id) { const Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); @@ -1439,7 +1439,7 @@ static int send_kill_packet(non_null() const Net_Crypto *c, int crypt_connection kill_packet, sizeof(kill_packet)); } -static void connection_kill(non_null() Net_Crypto *c, int crypt_connection_id, nullable() void *userdata) +static void connection_kill(Net_Crypto *_Nonnull c, int crypt_connection_id, void *_Nullable userdata) { const Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); if (conn == nullptr) { @@ -1459,8 +1459,8 @@ static void connection_kill(non_null() Net_Crypto *c, int crypt_connection_id, n * @retval -1 on failure. * @retval 0 on success. */ -static int handle_data_packet_core(non_null() Net_Crypto *c, int crypt_connection_id, non_null() const uint8_t *packet, uint16_t length, - bool udp, nullable() void *userdata) +static int handle_data_packet_core(Net_Crypto *_Nonnull c, int crypt_connection_id, const uint8_t *_Nonnull packet, uint16_t length, + bool udp, void *_Nullable userdata) { if (length > MAX_CRYPTO_PACKET_SIZE || length <= CRYPTO_DATA_PACKET_MIN_SIZE) { return -1; @@ -1597,7 +1597,7 @@ static int handle_data_packet_core(non_null() Net_Crypto *c, int crypt_connectio return 0; } -static int handle_packet_cookie_response(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() const uint8_t *packet, uint16_t length) +static int handle_packet_cookie_response(const Net_Crypto *_Nonnull c, int crypt_connection_id, const uint8_t *_Nonnull packet, uint16_t length) { Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); @@ -1628,8 +1628,8 @@ static int handle_packet_cookie_response(non_null() const Net_Crypto *c, int cry return 0; } -static int handle_packet_crypto_hs(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int handle_packet_crypto_hs(const Net_Crypto *_Nonnull c, int crypt_connection_id, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nullable userdata) { Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); if (conn == nullptr) { @@ -1670,8 +1670,8 @@ static int handle_packet_crypto_hs(non_null() const Net_Crypto *c, int crypt_con return 0; } -static int handle_packet_crypto_data(non_null() Net_Crypto *c, int crypt_connection_id, non_null() const uint8_t *packet, uint16_t length, - bool udp, nullable() void *userdata) +static int handle_packet_crypto_data(Net_Crypto *_Nonnull c, int crypt_connection_id, const uint8_t *_Nonnull packet, uint16_t length, + bool udp, void *_Nullable userdata) { const Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); if (conn == nullptr) { @@ -1690,8 +1690,8 @@ static int handle_packet_crypto_data(non_null() Net_Crypto *c, int crypt_connect * @retval -1 on failure. * @retval 0 on success. */ -static int handle_packet_connection(non_null() Net_Crypto *c, int crypt_connection_id, non_null() const uint8_t *packet, uint16_t length, - bool udp, nullable() void *userdata) +static int handle_packet_connection(Net_Crypto *_Nonnull c, int crypt_connection_id, const uint8_t *_Nonnull packet, uint16_t length, + bool udp, void *_Nullable userdata) { if (length == 0 || length > MAX_CRYPTO_PACKET_SIZE) { return -1; @@ -1717,7 +1717,7 @@ static int handle_packet_connection(non_null() Net_Crypto *c, int crypt_connecti * @retval -1 if mem_vrealloc fails. * @retval 0 if it succeeds. */ -static int realloc_cryptoconnection(non_null() Net_Crypto *c, uint32_t num) +static int realloc_cryptoconnection(Net_Crypto *_Nonnull c, uint32_t num) { if (num == 0) { mem_delete(c->mem, c->crypto_connections); @@ -1741,7 +1741,7 @@ static int realloc_cryptoconnection(non_null() Net_Crypto *c, uint32_t num) * @retval -1 on failure. * @return connection id on success. */ -static int create_crypto_connection(non_null() Net_Crypto *c) +static int create_crypto_connection(Net_Crypto *_Nonnull c) { int id = -1; @@ -1780,7 +1780,7 @@ static int create_crypto_connection(non_null() Net_Crypto *c) * @retval -1 on failure. * @retval 0 on success. */ -static int wipe_crypto_connection(non_null() Net_Crypto *c, int crypt_connection_id) +static int wipe_crypto_connection(Net_Crypto *_Nonnull c, int crypt_connection_id) { if ((uint32_t)crypt_connection_id >= c->crypto_connections_length) { return -1; @@ -1820,7 +1820,7 @@ static int wipe_crypto_connection(non_null() Net_Crypto *c, int crypt_connection * @retval -1 if there are no connections like we are looking for. * @return id if it found it. */ -static int getcryptconnection_id(non_null() const Net_Crypto *c, non_null() const uint8_t *public_key) +static int getcryptconnection_id(const Net_Crypto *_Nonnull c, const uint8_t *_Nonnull public_key) { for (uint32_t i = 0; i < c->crypto_connections_length; ++i) { if (!crypt_connection_id_is_valid(c, i)) { @@ -1842,7 +1842,7 @@ static int getcryptconnection_id(non_null() const Net_Crypto *c, non_null() cons * @retval 0 if source was a direct UDP connection. * @return positive number on success. */ -static int crypto_connection_add_source(non_null() Net_Crypto *c, int crypt_connection_id, non_null() const IP_Port *source) +static int crypto_connection_add_source(Net_Crypto *_Nonnull c, int crypt_connection_id, const IP_Port *_Nonnull source) { Crypto_Connection *conn = get_crypto_connection(c, crypt_connection_id); @@ -1893,8 +1893,8 @@ void new_connection_handler(Net_Crypto *c, new_connection_cb *new_connection_cal * @retval -1 on failure. * @retval 0 on success. */ -static int handle_new_connection_handshake(non_null() Net_Crypto *c, non_null() const IP_Port *source, non_null() const uint8_t *data, uint16_t length, - nullable() void *userdata) +static int handle_new_connection_handshake(Net_Crypto *_Nonnull c, const IP_Port *_Nonnull source, const uint8_t *_Nonnull data, uint16_t length, + void *_Nullable userdata) { uint8_t *cookie = (uint8_t *)mem_balloc(c->mem, COOKIE_LENGTH); if (cookie == nullptr) { @@ -2091,8 +2091,8 @@ int set_direct_ip_port(Net_Crypto *c, int crypt_connection_id, const IP_Port *ip return 0; } -static int tcp_data_callback(non_null() void *object, int crypt_connection_id, non_null() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int tcp_data_callback(void *_Nonnull object, int crypt_connection_id, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nullable userdata) { Net_Crypto *c = (Net_Crypto *)object; if (length == 0 || length > MAX_CRYPTO_PACKET_SIZE) { @@ -2119,8 +2119,8 @@ static int tcp_data_callback(non_null() void *object, int crypt_connection_id, n return 0; } -static int tcp_oob_callback(non_null() void *object, non_null() const uint8_t *public_key, unsigned int tcp_connections_number, - non_null() const uint8_t *packet, uint16_t length, nullable() void *userdata) +static int tcp_oob_callback(void *_Nonnull object, const uint8_t *_Nonnull public_key, unsigned int tcp_connections_number, + const uint8_t *_Nonnull packet, uint16_t length, void *_Nullable userdata) { Net_Crypto *c = (Net_Crypto *)object; if (length == 0 || length > MAX_CRYPTO_PACKET_SIZE) { @@ -2244,7 +2244,7 @@ uint32_t copy_connected_tcp_relays_index(const Net_Crypto *c, Node_format *tcp_r return tcp_copy_connected_relays_index(c->tcp_c, tcp_relays, num, idx); } -static void do_tcp(non_null() Net_Crypto *c, non_null() void *userdata) +static void do_tcp(Net_Crypto *_Nonnull c, void *_Nonnull userdata) { do_tcp_connections(c->log, c->tcp_c, userdata); @@ -2370,7 +2370,7 @@ int nc_dht_pk_callback(const Net_Crypto *c, int crypt_connection_id, dht_pk_cb * * return -1 on failure. * return connection id on success. */ -static int crypto_id_ip_port(non_null() const Net_Crypto *c, non_null() const IP_Port *ip_port) +static int crypto_id_ip_port(const Net_Crypto *_Nonnull c, const IP_Port *_Nonnull ip_port) { return bs_list_find(&c->ip_port_list, (const uint8_t *)ip_port); } @@ -2385,8 +2385,8 @@ static int crypto_id_ip_port(non_null() const Net_Crypto *c, non_null() const IP * Crypto data packets. * */ -static int udp_handle_packet(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int udp_handle_packet(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nullable userdata) { Net_Crypto *c = (Net_Crypto *)object; if (length <= CRYPTO_MIN_PACKET_SIZE || length > MAX_CRYPTO_PACKET_SIZE) { @@ -2446,7 +2446,7 @@ static int udp_handle_packet(non_null() void *object, non_null() const IP_Port * */ #define SEND_QUEUE_RATIO 2.0 -static void send_crypto_packets(non_null() Net_Crypto *c) +static void send_crypto_packets(Net_Crypto *_Nonnull c) { const uint64_t temp_time = current_time_monotonic(c->mono_time); double total_send_rate = 0; @@ -2960,7 +2960,7 @@ Net_Crypto *new_net_crypto(const Logger *log, const Memory *mem, const Random *r return temp; } -static void kill_timedout(non_null() Net_Crypto *c, nullable() void *userdata) +static void kill_timedout(Net_Crypto *_Nonnull c, void *_Nullable userdata) { for (uint32_t i = 0; i < c->crypto_connections_length; ++i) { const Crypto_Connection *conn = get_crypto_connection(c, i); diff --git a/toxcore/net_crypto.h b/toxcore/net_crypto.h index dc24bdd77..dc93d6585 100644 --- a/toxcore/net_crypto.h +++ b/toxcore/net_crypto.h @@ -123,10 +123,10 @@ typedef enum Packet_Id { typedef struct Net_Crypto Net_Crypto; -const uint8_t *nc_get_self_public_key(non_null() const Net_Crypto *c); -const uint8_t *nc_get_self_secret_key(non_null() const Net_Crypto *c); -TCP_Connections *nc_get_tcp_c(non_null() const Net_Crypto *c); -DHT *nc_get_dht(non_null() const Net_Crypto *c); +const uint8_t *_Nonnull nc_get_self_public_key(const Net_Crypto *_Nonnull c); +const uint8_t *_Nonnull nc_get_self_secret_key(const Net_Crypto *_Nonnull c); +TCP_Connections *_Nonnull nc_get_tcp_c(const Net_Crypto *_Nonnull c); +DHT *_Nonnull nc_get_dht(const Net_Crypto *_Nonnull c); typedef struct New_Connection { IP_Port source; @@ -134,15 +134,15 @@ typedef struct New_Connection { uint8_t dht_public_key[CRYPTO_PUBLIC_KEY_SIZE]; /* The dht public key of the peer. */ uint8_t recv_nonce[CRYPTO_NONCE_SIZE]; /* Nonce of received packets. */ uint8_t peersessionpublic_key[CRYPTO_PUBLIC_KEY_SIZE]; /* The public key of the peer. */ - uint8_t *cookie; + uint8_t *_Nullable cookie; uint8_t cookie_length; } New_Connection; -typedef int connection_status_cb(void *object, int id, bool status, void *userdata); -typedef int connection_data_cb(void *object, int id, const uint8_t *data, uint16_t length, void *userdata); -typedef int connection_lossy_data_cb(void *object, int id, const uint8_t *data, uint16_t length, void *userdata); -typedef void dht_pk_cb(void *object, int32_t number, const uint8_t *dht_public_key, void *userdata); -typedef int new_connection_cb(void *object, const New_Connection *n_c); +typedef int connection_status_cb(void *_Nonnull object, int id, bool status, void *_Nullable userdata); +typedef int connection_data_cb(void *_Nonnull object, int id, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata); +typedef int connection_lossy_data_cb(void *_Nonnull object, int id, const uint8_t *_Nonnull data, uint16_t length, void *_Nullable userdata); +typedef void dht_pk_cb(void *_Nonnull object, int32_t number, const uint8_t *_Nonnull dht_public_key, void *_Nullable userdata); +typedef int new_connection_cb(void *_Nonnull object, const New_Connection *_Nonnull n_c); /** @brief Set function to be called when someone requests a new connection to us. * @@ -150,14 +150,14 @@ typedef int new_connection_cb(void *object, const New_Connection *n_c); * * n_c is only valid for the duration of the function call. */ -void new_connection_handler(non_null() Net_Crypto *c, non_null() new_connection_cb *new_connection_callback, non_null() void *object); +void new_connection_handler(Net_Crypto *_Nonnull c, new_connection_cb *_Nonnull new_connection_callback, void *_Nonnull object); /** @brief Accept a crypto connection. * * return -1 on failure. * return connection id on success. */ -int accept_crypto_connection(non_null() Net_Crypto *c, non_null() const New_Connection *n_c); +int accept_crypto_connection(Net_Crypto *_Nonnull c, const New_Connection *_Nonnull n_c); /** @brief Create a crypto connection. * If one to that real public key already exists, return it. @@ -165,7 +165,7 @@ int accept_crypto_connection(non_null() Net_Crypto *c, non_null() const New_Conn * return -1 on failure. * return connection id on success. */ -int new_crypto_connection(non_null() Net_Crypto *c, non_null() const uint8_t *real_public_key, non_null() const uint8_t *dht_public_key); +int new_crypto_connection(Net_Crypto *_Nonnull c, const uint8_t *_Nonnull real_public_key, const uint8_t *_Nonnull dht_public_key); /** @brief Set the direct ip of the crypto connection. * @@ -174,7 +174,7 @@ int new_crypto_connection(non_null() Net_Crypto *c, non_null() const uint8_t *re * return -1 on failure. * return 0 on success. */ -int set_direct_ip_port(non_null() Net_Crypto *c, int crypt_connection_id, non_null() const IP_Port *ip_port, bool connected); +int set_direct_ip_port(Net_Crypto *_Nonnull c, int crypt_connection_id, const IP_Port *_Nonnull ip_port, bool connected); /** @brief Set function to be called when connection with crypt_connection_id goes connects/disconnects. * @@ -186,7 +186,7 @@ int set_direct_ip_port(non_null() Net_Crypto *c, int crypt_connection_id, non_nu * return -1 on failure. * return 0 on success. */ -int connection_status_handler(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() connection_status_cb *connection_status_callback, non_null() void *object, int id); +int connection_status_handler(const Net_Crypto *_Nonnull c, int crypt_connection_id, connection_status_cb *_Nonnull connection_status_callback, void *_Nonnull object, int id); /** @brief Set function to be called when connection with crypt_connection_id receives a lossless data packet of length. * @@ -196,7 +196,7 @@ int connection_status_handler(non_null() const Net_Crypto *c, int crypt_connecti * return -1 on failure. * return 0 on success. */ -int connection_data_handler(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() connection_data_cb *connection_data_callback, non_null() void *object, int id); +int connection_data_handler(const Net_Crypto *_Nonnull c, int crypt_connection_id, connection_data_cb *_Nonnull connection_data_callback, void *_Nonnull object, int id); /** @brief Set function to be called when connection with crypt_connection_id receives a lossy data packet of length. * @@ -206,7 +206,7 @@ int connection_data_handler(non_null() const Net_Crypto *c, int crypt_connection * return -1 on failure. * return 0 on success. */ -int connection_lossy_data_handler(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() connection_lossy_data_cb *connection_lossy_data_callback, non_null() void *object, int id); +int connection_lossy_data_handler(const Net_Crypto *_Nonnull c, int crypt_connection_id, connection_lossy_data_cb *_Nonnull connection_lossy_data_callback, void *_Nonnull object, int id); /** @brief Set the function for this friend that will be callbacked with object and number if * the friend sends us a different dht public key than we have associated to him. @@ -218,19 +218,19 @@ int connection_lossy_data_handler(non_null() const Net_Crypto *c, int crypt_conn * return -1 on failure. * return 0 on success. */ -int nc_dht_pk_callback(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() dht_pk_cb *function, non_null() void *object, uint32_t number); +int nc_dht_pk_callback(const Net_Crypto *_Nonnull c, int crypt_connection_id, dht_pk_cb *_Nonnull function, void *_Nonnull object, uint32_t number); /** * @return the number of packet slots left in the sendbuffer. * @retval 0 if failure. */ -uint32_t crypto_num_free_sendqueue_slots(non_null() const Net_Crypto *c, int crypt_connection_id); +uint32_t crypto_num_free_sendqueue_slots(const Net_Crypto *_Nonnull c, int crypt_connection_id); /** * @retval 1 if max speed was reached for this connection (no more data can be physically through the pipe). * @retval 0 if it wasn't reached. */ -bool max_speed_reached(non_null() const Net_Crypto *c, int crypt_connection_id); +bool max_speed_reached(const Net_Crypto *_Nonnull c, int crypt_connection_id); /** @brief Sends a lossless cryptopacket. * @@ -241,7 +241,7 @@ bool max_speed_reached(non_null() const Net_Crypto *c, int crypt_connection_id); * * congestion_control: should congestion control apply to this packet? */ -int64_t write_cryptpacket(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() const uint8_t *data, uint16_t length, bool congestion_control); +int64_t write_cryptpacket(const Net_Crypto *_Nonnull c, int crypt_connection_id, const uint8_t *_Nonnull data, uint16_t length, bool congestion_control); /** @brief Check if packet_number was received by the other side. * @@ -257,7 +257,7 @@ int64_t write_cryptpacket(non_null() const Net_Crypto *c, int crypt_connection_i * It CANNOT be simplified to `packet_number < buffer_start`, as it will fail * when `buffer_end < buffer_start`. */ -int cryptpacket_received(non_null() const Net_Crypto *c, int crypt_connection_id, uint32_t packet_number); +int cryptpacket_received(const Net_Crypto *_Nonnull c, int crypt_connection_id, uint32_t packet_number); /** @brief Sends a lossy cryptopacket. * @@ -266,21 +266,21 @@ int cryptpacket_received(non_null() const Net_Crypto *c, int crypt_connection_id * * The first byte of data must be in the PACKET_ID_RANGE_LOSSY. */ -int send_lossy_cryptpacket(non_null() const Net_Crypto *c, int crypt_connection_id, non_null() const uint8_t *data, uint16_t length); +int send_lossy_cryptpacket(const Net_Crypto *_Nonnull c, int crypt_connection_id, const uint8_t *_Nonnull data, uint16_t length); /** @brief Add a tcp relay, associating it to a crypt_connection_id. * * return 0 if it was added. * return -1 if it wasn't. */ -int add_tcp_relay_peer(non_null() Net_Crypto *c, int crypt_connection_id, non_null() const IP_Port *ip_port, non_null() const uint8_t *public_key); +int add_tcp_relay_peer(Net_Crypto *_Nonnull c, int crypt_connection_id, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key); /** @brief Add a tcp relay to the array. * * return 0 if it was added. * return -1 if it wasn't. */ -int add_tcp_relay(non_null() Net_Crypto *c, non_null() const IP_Port *ip_port, non_null() const uint8_t *public_key); +int add_tcp_relay(Net_Crypto *_Nonnull c, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key); /** @brief Return a random TCP connection number for use in send_tcp_onion_request. * @@ -290,21 +290,21 @@ int add_tcp_relay(non_null() Net_Crypto *c, non_null() const IP_Port *ip_port, n * return TCP connection number on success. * return -1 on failure. */ -int get_random_tcp_con_number(non_null() const Net_Crypto *c); +int get_random_tcp_con_number(const Net_Crypto *_Nonnull c); /** @brief Put IP_Port of a random onion TCP connection in ip_port. * * return true on success. * return false on failure. */ -bool get_random_tcp_conn_ip_port(non_null() const Net_Crypto *c, non_null() IP_Port *ip_port); +bool get_random_tcp_conn_ip_port(const Net_Crypto *_Nonnull c, IP_Port *_Nonnull ip_port); /** @brief Send an onion packet via the TCP relay corresponding to tcp_connections_number. * * return 0 on success. * return -1 on failure. */ -int send_tcp_onion_request(non_null() Net_Crypto *c, unsigned int tcp_connections_number, non_null() const uint8_t *data, uint16_t length); +int send_tcp_onion_request(Net_Crypto *_Nonnull c, unsigned int tcp_connections_number, const uint8_t *_Nonnull data, uint16_t length); /** * Send a forward request to the TCP relay with IP_Port tcp_forwarder, @@ -314,8 +314,8 @@ int send_tcp_onion_request(non_null() Net_Crypto *c, unsigned int tcp_connection * return 0 on success. * return -1 on failure. */ -int send_tcp_forward_request(non_null() const Logger *logger, non_null() Net_Crypto *c, non_null() const IP_Port *tcp_forwarder, non_null() const IP_Port *dht_node, - non_null() const uint8_t *chain_keys, uint16_t chain_length, non_null() const uint8_t *data, uint16_t data_length); +int send_tcp_forward_request(const Logger *_Nonnull logger, Net_Crypto *_Nonnull c, const IP_Port *_Nonnull tcp_forwarder, const IP_Port *_Nonnull dht_node, + const uint8_t *_Nonnull chain_keys, uint16_t chain_length, const uint8_t *_Nonnull data, uint16_t data_length); /** @brief Copy a maximum of num random TCP relays we are connected to to tcp_relays. * @@ -324,7 +324,7 @@ int send_tcp_forward_request(non_null() const Logger *logger, non_null() Net_Cry * return number of relays copied to tcp_relays on success. * return 0 on failure. */ -unsigned int copy_connected_tcp_relays(non_null() const Net_Crypto *c, non_null() Node_format *tcp_relays, uint16_t num); +unsigned int copy_connected_tcp_relays(const Net_Crypto *_Nonnull c, Node_format *_Nonnull tcp_relays, uint16_t num); /** * Copy a maximum of `max_num` TCP relays we are connected to starting at the index in the TCP relay array @@ -332,14 +332,14 @@ unsigned int copy_connected_tcp_relays(non_null() const Net_Crypto *c, non_null( * * Returns the number of relays successfully copied. */ -uint32_t copy_connected_tcp_relays_index(non_null() const Net_Crypto *c, non_null() Node_format *tcp_relays, uint16_t num, uint32_t idx); +uint32_t copy_connected_tcp_relays_index(const Net_Crypto *_Nonnull c, Node_format *_Nonnull tcp_relays, uint16_t num, uint32_t idx); /** @brief Kill a crypto connection. * * return -1 on failure. * return 0 on success. */ -int crypto_kill(non_null() Net_Crypto *c, int crypt_connection_id); +int crypto_kill(Net_Crypto *_Nonnull c, int crypt_connection_id); /** * @retval true if connection is valid, false otherwise @@ -348,36 +348,36 @@ int crypto_kill(non_null() Net_Crypto *c, int crypt_connection_id); * sets online_tcp_relays to the number of connected tcp relays this connection has. */ bool crypto_connection_status( - non_null() const Net_Crypto *c, int crypt_connection_id, non_null() bool *direct_connected, nullable() uint32_t *online_tcp_relays); + const Net_Crypto *_Nonnull c, int crypt_connection_id, bool *_Nonnull direct_connected, uint32_t *_Nullable online_tcp_relays); /** @brief Generate our public and private keys. * Only call this function the first time the program starts. */ -void new_keys(non_null() Net_Crypto *c); +void new_keys(Net_Crypto *_Nonnull c); /** @brief Save the public and private keys to the keys array. * Length must be CRYPTO_PUBLIC_KEY_SIZE + CRYPTO_SECRET_KEY_SIZE. * * TODO(irungentoo): Save only secret key. */ -void save_keys(non_null() const Net_Crypto *c, non_null() uint8_t *keys); +void save_keys(const Net_Crypto *_Nonnull c, uint8_t *_Nonnull keys); /** @brief Load the secret key. * Length must be CRYPTO_SECRET_KEY_SIZE. */ -void load_secret_key(non_null() Net_Crypto *c, non_null() const uint8_t *sk); +void load_secret_key(Net_Crypto *_Nonnull c, const uint8_t *_Nonnull sk); /** @brief Create new instance of Net_Crypto. * Sets all the global connection variables to their default values. */ -Net_Crypto *new_net_crypto(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Random *rng, non_null() const Network *ns, non_null() Mono_Time *mono_time, non_null() DHT *dht, - non_null() const TCP_Proxy_Info *proxy_info, non_null() Net_Profile *tcp_np); +Net_Crypto *_Nullable new_net_crypto(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Random *_Nonnull rng, const Network *_Nonnull ns, Mono_Time *_Nonnull mono_time, DHT *_Nonnull dht, + const TCP_Proxy_Info *_Nonnull proxy_info, Net_Profile *_Nonnull tcp_np); /** return the optimal interval in ms for running do_net_crypto. */ -uint32_t crypto_run_interval(non_null() const Net_Crypto *c); +uint32_t crypto_run_interval(const Net_Crypto *_Nonnull c); /** Main loop. */ -void do_net_crypto(non_null() Net_Crypto *c, nullable() void *userdata); -void kill_net_crypto(nullable() Net_Crypto *c); +void do_net_crypto(Net_Crypto *_Nonnull c, void *_Nullable userdata); +void kill_net_crypto(Net_Crypto *_Nullable c); #ifdef __cplusplus } /* extern "C" */ #endif diff --git a/toxcore/net_profile.c b/toxcore/net_profile.c index c04ba94bc..c195a2e00 100644 --- a/toxcore/net_profile.c +++ b/toxcore/net_profile.c @@ -33,7 +33,7 @@ typedef struct Net_Profile { } Net_Profile; /** Returns the number of sent or received packets for all ID's between `start_id` and `end_id`. */ -static uint64_t netprof_get_packet_count_id_range(nullable() const Net_Profile *profile, uint8_t start_id, uint8_t end_id, +static uint64_t netprof_get_packet_count_id_range(const Net_Profile *_Nullable profile, uint8_t start_id, uint8_t end_id, Packet_Direction dir) { if (profile == nullptr) { @@ -51,7 +51,7 @@ static uint64_t netprof_get_packet_count_id_range(nullable() const Net_Profile * } /** Returns the number of sent or received bytes for all ID's between `start_id` and `end_id`. */ -static uint64_t netprof_get_bytes_id_range(nullable() const Net_Profile *profile, uint8_t start_id, uint8_t end_id, +static uint64_t netprof_get_bytes_id_range(const Net_Profile *_Nullable profile, uint8_t start_id, uint8_t end_id, Packet_Direction dir) { if (profile == nullptr) { diff --git a/toxcore/net_profile.h b/toxcore/net_profile.h index bb376471c..b797ad87c 100644 --- a/toxcore/net_profile.h +++ b/toxcore/net_profile.h @@ -34,33 +34,33 @@ typedef enum Packet_Direction { /** * Records a sent or received packet of type `id` and size `length` to the given profile. */ -void netprof_record_packet(nullable() Net_Profile *profile, uint8_t id, size_t length, Packet_Direction dir); +void netprof_record_packet(Net_Profile *_Nullable profile, uint8_t id, size_t length, Packet_Direction dir); /** * Returns the number of sent or received packets of type `id` for the given profile. */ -uint64_t netprof_get_packet_count_id(nullable() const Net_Profile *profile, uint8_t id, Packet_Direction dir); +uint64_t netprof_get_packet_count_id(const Net_Profile *_Nullable profile, uint8_t id, Packet_Direction dir); /** * Returns the total number of sent or received packets for the given profile. */ -uint64_t netprof_get_packet_count_total(nullable() const Net_Profile *profile, Packet_Direction dir); +uint64_t netprof_get_packet_count_total(const Net_Profile *_Nullable profile, Packet_Direction dir); /** * Returns the number of bytes sent or received of packet type `id` for the given profile. */ -uint64_t netprof_get_bytes_id(nullable() const Net_Profile *profile, uint8_t id, Packet_Direction dir); +uint64_t netprof_get_bytes_id(const Net_Profile *_Nullable profile, uint8_t id, Packet_Direction dir); /** * Returns the total number of bytes sent or received for the given profile. */ -uint64_t netprof_get_bytes_total(nullable() const Net_Profile *profile, Packet_Direction dir); +uint64_t netprof_get_bytes_total(const Net_Profile *_Nullable profile, Packet_Direction dir); /** * Returns a new net_profile object. The caller is responsible for freeing the * returned memory via `netprof_kill`. */ -Net_Profile *netprof_new(non_null() const Logger *log, non_null() const Memory *mem); +Net_Profile *_Nullable netprof_new(const Logger *_Nonnull log, const Memory *_Nonnull mem); /** * Kills a net_profile object and frees all associated memory. */ -void netprof_kill(non_null() const Memory *mem, nullable() Net_Profile *net_profile); +void netprof_kill(const Memory *_Nonnull mem, Net_Profile *_Nullable net_profile); #ifdef __cplusplus } /* extern "C" */ #endif diff --git a/toxcore/network.c b/toxcore/network.c index ba232e288..25b49c95f 100644 --- a/toxcore/network.c +++ b/toxcore/network.c @@ -118,22 +118,22 @@ static bool should_ignore_connect_error(int err) return err == EWOULDBLOCK || err == EINPROGRESS; } -static const char *inet_ntop4(non_null() const struct in_addr *addr, non_null() char *buf, size_t bufsize) +static const char *inet_ntop4(const struct in_addr *_Nonnull addr, char *_Nonnull buf, size_t bufsize) { return inet_ntop(AF_INET, addr, buf, bufsize); } -static const char *inet_ntop6(non_null() const struct in6_addr *addr, non_null() char *buf, size_t bufsize) +static const char *inet_ntop6(const struct in6_addr *_Nonnull addr, char *_Nonnull buf, size_t bufsize) { return inet_ntop(AF_INET6, addr, buf, bufsize); } -static int inet_pton4(non_null() const char *addr_string, non_null() struct in_addr *addrbuf) +static int inet_pton4(const char *_Nonnull addr_string, struct in_addr *_Nonnull addrbuf) { return inet_pton(AF_INET, addr_string, addrbuf); } -static int inet_pton6(non_null() const char *addr_string, non_null() struct in6_addr *addrbuf) +static int inet_pton6(const char *_Nonnull addr_string, struct in6_addr *_Nonnull addrbuf) { return inet_pton(AF_INET6, addr_string, addrbuf); } @@ -155,7 +155,7 @@ static bool should_ignore_connect_error(int err) return err == WSAEWOULDBLOCK || err == WSAEINPROGRESS; } -static const char *inet_ntop4(non_null() const struct in_addr *addr, non_null() char *buf, size_t bufsize) +static const char *inet_ntop4(const struct in_addr *_Nonnull addr, char *_Nonnull buf, size_t bufsize) { struct sockaddr_in saddr = {0}; @@ -171,7 +171,7 @@ static const char *inet_ntop4(non_null() const struct in_addr *addr, non_null() return buf; } -static const char *inet_ntop6(non_null() const struct in6_addr *addr, non_null() char *buf, size_t bufsize) +static const char *inet_ntop6(const struct in6_addr *_Nonnull addr, char *_Nonnull buf, size_t bufsize) { struct sockaddr_in6 saddr = {0}; @@ -187,7 +187,7 @@ static const char *inet_ntop6(non_null() const struct in6_addr *addr, non_null() return buf; } -static int inet_pton4(non_null() const char *addrString, non_null() struct in_addr *addrbuf) +static int inet_pton4(const char *_Nonnull addrString, struct in_addr *_Nonnull addrbuf) { struct sockaddr_in saddr = {0}; @@ -202,7 +202,7 @@ static int inet_pton4(non_null() const char *addrString, non_null() struct in_ad return 1; } -static int inet_pton6(non_null() const char *addrString, non_null() struct in6_addr *addrbuf) +static int inet_pton6(const char *_Nonnull addrString, struct in6_addr *_Nonnull addrbuf) { struct sockaddr_in6 saddr = {0}; @@ -298,26 +298,26 @@ static const Family *make_tox_family(int family) } } -static void get_ip4(non_null() IP4 *result, non_null() const struct in_addr *addr) +static void get_ip4(IP4 *_Nonnull result, const struct in_addr *_Nonnull addr) { static_assert(sizeof(result->uint32) == sizeof(addr->s_addr), "Tox and operating system don't agree on size of IPv4 addresses"); result->uint32 = addr->s_addr; } -static void get_ip6(non_null() IP6 *result, non_null() const struct in6_addr *addr) +static void get_ip6(IP6 *_Nonnull result, const struct in6_addr *_Nonnull addr) { static_assert(sizeof(result->uint8) == sizeof(addr->s6_addr), "Tox and operating system don't agree on size of IPv6 addresses"); memcpy(result->uint8, addr->s6_addr, sizeof(result->uint8)); } -static void fill_addr4(non_null() const IP4 *ip, non_null() struct in_addr *addr) +static void fill_addr4(const IP4 *_Nonnull ip, struct in_addr *_Nonnull addr) { addr->s_addr = ip->uint32; } -static void fill_addr6(non_null() const IP6 *ip, non_null() struct in6_addr *addr) +static void fill_addr6(const IP6 *_Nonnull ip, struct in6_addr *_Nonnull addr) { memcpy(addr->s6_addr, ip->uint8, sizeof(ip->uint8)); } @@ -476,7 +476,7 @@ struct Network_Addr { size_t size; }; -static int sys_close(non_null() void *obj, Socket sock) +static int sys_close(void *_Nonnull obj, Socket sock) { #if defined(OS_WIN32) return closesocket(net_socket_to_native(sock)); @@ -485,27 +485,27 @@ static int sys_close(non_null() void *obj, Socket sock) #endif /* OS_WIN32 */ } -static Socket sys_accept(non_null() void *obj, Socket sock) +static Socket sys_accept(void *_Nonnull obj, Socket sock) { return net_socket_from_native(accept(net_socket_to_native(sock), nullptr, nullptr)); } -static int sys_bind(non_null() void *obj, Socket sock, non_null() const Network_Addr *addr) +static int sys_bind(void *_Nonnull obj, Socket sock, const Network_Addr *_Nonnull addr) { return bind(net_socket_to_native(sock), (const struct sockaddr *)&addr->addr, addr->size); } -static int sys_listen(non_null() void *obj, Socket sock, int backlog) +static int sys_listen(void *_Nonnull obj, Socket sock, int backlog) { return listen(net_socket_to_native(sock), backlog); } -static int sys_connect(non_null() void *obj, Socket sock, non_null() const Network_Addr *addr) +static int sys_connect(void *_Nonnull obj, Socket sock, const Network_Addr *_Nonnull addr) { return connect(net_socket_to_native(sock), (const struct sockaddr *)&addr->addr, addr->size); } -static int sys_recvbuf(non_null() void *obj, Socket sock) +static int sys_recvbuf(void *_Nonnull obj, Socket sock) { #ifdef OS_WIN32 u_long count = 0; @@ -518,22 +518,22 @@ static int sys_recvbuf(non_null() void *obj, Socket sock) return count; } -static int sys_recv(non_null() void *obj, Socket sock, non_null() uint8_t *buf, size_t len) +static int sys_recv(void *_Nonnull obj, Socket sock, uint8_t *_Nonnull buf, size_t len) { return recv(net_socket_to_native(sock), (char *)buf, len, MSG_NOSIGNAL); } -static int sys_send(non_null() void *obj, Socket sock, non_null() const uint8_t *buf, size_t len) +static int sys_send(void *_Nonnull obj, Socket sock, const uint8_t *_Nonnull buf, size_t len) { return send(net_socket_to_native(sock), (const char *)buf, len, MSG_NOSIGNAL); } -static int sys_sendto(non_null() void *obj, Socket sock, non_null() const uint8_t *buf, size_t len, non_null() const Network_Addr *addr) +static int sys_sendto(void *_Nonnull obj, Socket sock, const uint8_t *_Nonnull buf, size_t len, const Network_Addr *_Nonnull addr) { return sendto(net_socket_to_native(sock), (const char *)buf, len, 0, (const struct sockaddr *)&addr->addr, addr->size); } -static int sys_recvfrom(non_null() void *obj, Socket sock, non_null() uint8_t *buf, size_t len, non_null() Network_Addr *addr) +static int sys_recvfrom(void *_Nonnull obj, Socket sock, uint8_t *_Nonnull buf, size_t len, Network_Addr *_Nonnull addr) { socklen_t size = addr->size; const int ret = recvfrom(net_socket_to_native(sock), (char *)buf, len, 0, (struct sockaddr *)&addr->addr, &size); @@ -541,12 +541,12 @@ static int sys_recvfrom(non_null() void *obj, Socket sock, non_null() uint8_t *b return ret; } -static Socket sys_socket(non_null() void *obj, int domain, int type, int proto) +static Socket sys_socket(void *_Nonnull obj, int domain, int type, int proto) { return net_socket_from_native(socket(domain, type, proto)); } -static int sys_socket_nonblock(non_null() void *obj, Socket sock, bool nonblock) +static int sys_socket_nonblock(void *_Nonnull obj, Socket sock, bool nonblock) { #ifdef OS_WIN32 u_long mode = nonblock ? 1 : 0; @@ -556,7 +556,7 @@ static int sys_socket_nonblock(non_null() void *obj, Socket sock, bool nonblock) #endif /* OS_WIN32 */ } -static int sys_getsockopt(non_null() void *obj, Socket sock, int level, int optname, non_null() void *optval, non_null() size_t *optlen) +static int sys_getsockopt(void *_Nonnull obj, Socket sock, int level, int optname, void *_Nonnull optval, size_t *_Nonnull optlen) { socklen_t len = *optlen; const int ret = getsockopt(net_socket_to_native(sock), level, optname, (char *)optval, &len); @@ -564,7 +564,7 @@ static int sys_getsockopt(non_null() void *obj, Socket sock, int level, int optn return ret; } -static int sys_setsockopt(non_null() void *obj, Socket sock, int level, int optname, non_null() const void *optval, size_t optlen) +static int sys_setsockopt(void *_Nonnull obj, Socket sock, int level, int optname, const void *_Nonnull optval, size_t optlen) { #ifdef EMSCRIPTEN return 0; @@ -575,7 +575,7 @@ static int sys_setsockopt(non_null() void *obj, Socket sock, int level, int optn // sets and fills an array of addrs for address // returns the number of entries in addrs -static int sys_getaddrinfo(non_null() void *obj, non_null() const Memory *mem, non_null() const char *address, int family, int sock_type, non_null() Network_Addr **addrs) +static int sys_getaddrinfo(void *_Nonnull obj, const Memory *_Nonnull mem, const char *_Nonnull address, int family, int sock_type, Network_Addr **_Nonnull addrs) { assert(addrs != nullptr); @@ -646,7 +646,7 @@ static int sys_getaddrinfo(non_null() void *obj, non_null() const Memory *mem, n return result; } -static int sys_freeaddrinfo(non_null() void *obj, non_null() const Memory *mem, non_null() Network_Addr *addrs) +static int sys_freeaddrinfo(void *_Nonnull obj, const Memory *_Nonnull mem, Network_Addr *_Nonnull addrs) { if (addrs == nullptr) { return 0; @@ -704,17 +704,17 @@ void os_network_deinit(const Network *ns) } #endif /* 0 */ -static int net_setsockopt(non_null() const Network *ns, Socket sock, int level, int optname, non_null() const void *optval, size_t optlen) +static int net_setsockopt(const Network *_Nonnull ns, Socket sock, int level, int optname, const void *_Nonnull optval, size_t optlen) { return ns->funcs->setsockopt(ns->obj, sock, level, optname, optval, optlen); } -static int net_getsockopt(non_null() const Network *ns, Socket sock, int level, int optname, non_null() void *optval, non_null() size_t *optlen) +static int net_getsockopt(const Network *_Nonnull ns, Socket sock, int level, int optname, void *_Nonnull optval, size_t *_Nonnull optlen) { return ns->funcs->getsockopt(ns->obj, sock, level, optname, optval, optlen); } -static uint32_t data_0(uint16_t buflen, non_null() const uint8_t *buffer) +static uint32_t data_0(uint16_t buflen, const uint8_t *_Nonnull buffer) { uint32_t data = 0; @@ -724,7 +724,7 @@ static uint32_t data_0(uint16_t buflen, non_null() const uint8_t *buffer) return data; } -static uint32_t data_1(uint16_t buflen, non_null() const uint8_t *buffer) +static uint32_t data_1(uint16_t buflen, const uint8_t *_Nonnull buffer) { uint32_t data = 0; @@ -850,7 +850,7 @@ static const char *net_packet_type_name(Net_Packet_Type type) return ""; } -static void loglogdata(non_null() const Logger *log, non_null() const char *message, non_null() const uint8_t *buffer, uint16_t buflen, non_null() const IP_Port *ip_port, long res) +static void loglogdata(const Logger *_Nonnull log, const char *_Nonnull message, const uint8_t *_Nonnull buffer, uint16_t buflen, const IP_Port *_Nonnull ip_port, long res) { if (res < 0) { /* Windows doesn't necessarily know `%zu` */ Ip_Ntoa ip_str; @@ -891,7 +891,7 @@ int net_send(const Network *ns, const Logger *log, return res; } -static int net_sendto(non_null() const Network *ns, Socket sock, non_null() const uint8_t *buf, size_t len, non_null() const Network_Addr *addr, non_null() const IP_Port *ip_port) +static int net_sendto(const Network *_Nonnull ns, Socket sock, const uint8_t *_Nonnull buf, size_t len, const Network_Addr *_Nonnull addr, const IP_Port *_Nonnull ip_port) { return ns->funcs->sendto(ns->obj, sock, buf, len, addr); } @@ -904,7 +904,7 @@ int net_recv(const Network *ns, const Logger *log, return res; } -static int net_recvfrom(non_null() const Network *ns, Socket sock, non_null() uint8_t *buf, size_t len, non_null() Network_Addr *addr) +static int net_recvfrom(const Network *_Nonnull ns, Socket sock, uint8_t *_Nonnull buf, size_t len, Network_Addr *_Nonnull addr) { return ns->funcs->recvfrom(ns->obj, sock, buf, len, addr); } @@ -914,7 +914,7 @@ int net_listen(const Network *ns, Socket sock, int backlog) return ns->funcs->listen(ns->obj, sock, backlog); } -static int net_bind(non_null() const Network *ns, Socket sock, non_null() const Network_Addr *addr) +static int net_bind(const Network *_Nonnull ns, Socket sock, const Network_Addr *_Nonnull addr) { return ns->funcs->bind(ns->obj, sock, addr); } @@ -1095,7 +1095,7 @@ int sendpacket(const Networking_Core *net, const IP_Port *ip_port, const uint8_t * Packet data is put into data. * Packet length is put into length. */ -static int receivepacket(non_null() const Network *ns, non_null() const Logger *log, Socket sock, non_null() IP_Port *ip_port, non_null() uint8_t *data, non_null() uint32_t *length) +static int receivepacket(const Network *_Nonnull ns, const Logger *_Nonnull log, Socket sock, IP_Port *_Nonnull ip_port, uint8_t *_Nonnull data, uint32_t *_Nonnull length) { memset(ip_port, 0, sizeof(IP_Port)); Network_Addr addr = {{0}}; @@ -1527,12 +1527,12 @@ bool ipport_equal(const IP_Port *a, const IP_Port *b) return ip_equal(&a->ip, &b->ip); } -static int ip4_cmp(non_null() const IP4 *a, non_null() const IP4 *b) +static int ip4_cmp(const IP4 *_Nonnull a, const IP4 *_Nonnull b) { return cmp_uint(a->uint32, b->uint32); } -static int ip6_cmp(non_null() const IP6 *a, non_null() const IP6 *b) +static int ip6_cmp(const IP6 *_Nonnull a, const IP6 *_Nonnull b) { const int res = cmp_uint(a->uint64[0], b->uint64[0]); if (res != 0) { @@ -1541,7 +1541,7 @@ static int ip6_cmp(non_null() const IP6 *a, non_null() const IP6 *b) return cmp_uint(a->uint64[1], b->uint64[1]); } -static int ip_cmp(non_null() const IP *a, non_null() const IP *b) +static int ip_cmp(const IP *_Nonnull a, const IP *_Nonnull b) { const int res = cmp_uint(a->family.value, b->family.value); if (res != 0) { @@ -1674,7 +1674,7 @@ void ipport_copy(IP_Port *target, const IP_Port *source) * * @retval true on success. */ -static bool bin_pack_ip(non_null() Bin_Pack *bp, non_null() const IP *ip, bool is_ipv4) +static bool bin_pack_ip(Bin_Pack *_Nonnull bp, const IP *_Nonnull ip, bool is_ipv4) { if (is_ipv4) { return bin_pack_bin_b(bp, ip->ip.v4.uint8, SIZE_IP4); @@ -1718,7 +1718,7 @@ bool bin_pack_ip_port(Bin_Pack *bp, const Logger *logger, const IP_Port *ip_port && bin_pack_u16_b(bp, net_ntohs(ip_port->port)); } -static bool bin_pack_ip_port_handler(non_null() const void *obj, non_null() const Logger *logger, non_null() Bin_Pack *bp) +static bool bin_pack_ip_port_handler(const void *_Nonnull obj, const Logger *_Nonnull logger, Bin_Pack *_Nonnull bp) { const IP_Port *ip_port = (const IP_Port *)obj; return bin_pack_ip_port(bp, logger, ip_port); @@ -1895,7 +1895,7 @@ bool addr_parse_ip(const char *address, IP *to) * * @return false on failure, true on success. */ -static bool addr_resolve(non_null() const Network *ns, non_null() const Memory *mem, non_null() const char *address, non_null() IP *to, nullable() IP *extra) +static bool addr_resolve(const Network *_Nonnull ns, const Memory *_Nonnull mem, const char *_Nonnull address, IP *_Nonnull to, IP *_Nullable extra) { #ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION if ((true)) { @@ -2327,7 +2327,7 @@ char *net_strerror(int error, Net_Strerror *buf) } #else #if defined(_GNU_SOURCE) && defined(__GLIBC__) -static const char *net_strerror_r(int error, non_null() char *tmp, size_t tmp_size) +static const char *net_strerror_r(int error, char *_Nonnull tmp, size_t tmp_size) { const char *retstr = strerror_r(error, tmp, tmp_size); @@ -2338,7 +2338,7 @@ static const char *net_strerror_r(int error, non_null() char *tmp, size_t tmp_si return retstr; } #else -static const char *net_strerror_r(int error, non_null() char *tmp, size_t tmp_size) +static const char *net_strerror_r(int error, char *_Nonnull tmp, size_t tmp_size) { const int fmt_error = strerror_r(error, tmp, tmp_size); diff --git a/toxcore/network.h b/toxcore/network.h index 712d8d4fc..35917fbcc 100644 --- a/toxcore/network.h +++ b/toxcore/network.h @@ -36,22 +36,22 @@ typedef struct Socket { int net_socket_to_native(Socket sock); Socket net_socket_from_native(int sock); -typedef int net_close_cb(void *obj, Socket sock); -typedef Socket net_accept_cb(void *obj, Socket sock); -typedef int net_bind_cb(void *obj, Socket sock, const Network_Addr *addr); -typedef int net_listen_cb(void *obj, Socket sock, int backlog); -typedef int net_connect_cb(void *obj, Socket sock, const Network_Addr *addr); -typedef int net_recvbuf_cb(void *obj, Socket sock); -typedef int net_recv_cb(void *obj, Socket sock, uint8_t *buf, size_t len); -typedef int net_recvfrom_cb(void *obj, Socket sock, uint8_t *buf, size_t len, Network_Addr *addr); -typedef int net_send_cb(void *obj, Socket sock, const uint8_t *buf, size_t len); -typedef int net_sendto_cb(void *obj, Socket sock, const uint8_t *buf, size_t len, const Network_Addr *addr); -typedef Socket net_socket_cb(void *obj, int domain, int type, int proto); -typedef int net_socket_nonblock_cb(void *obj, Socket sock, bool nonblock); -typedef int net_getsockopt_cb(void *obj, Socket sock, int level, int optname, void *optval, size_t *optlen); -typedef int net_setsockopt_cb(void *obj, Socket sock, int level, int optname, const void *optval, size_t optlen); -typedef int net_getaddrinfo_cb(void *obj, const Memory *mem, const char *address, int family, int protocol, Network_Addr **addrs); -typedef int net_freeaddrinfo_cb(void *obj, const Memory *mem, Network_Addr *addrs); +typedef int net_close_cb(void *_Nullable obj, Socket sock); +typedef Socket net_accept_cb(void *_Nullable obj, Socket sock); +typedef int net_bind_cb(void *_Nullable obj, Socket sock, const Network_Addr *_Nonnull addr); +typedef int net_listen_cb(void *_Nullable obj, Socket sock, int backlog); +typedef int net_connect_cb(void *_Nullable obj, Socket sock, const Network_Addr *_Nonnull addr); +typedef int net_recvbuf_cb(void *_Nullable obj, Socket sock); +typedef int net_recv_cb(void *_Nullable obj, Socket sock, uint8_t *_Nonnull buf, size_t len); +typedef int net_recvfrom_cb(void *_Nullable obj, Socket sock, uint8_t *_Nonnull buf, size_t len, Network_Addr *_Nonnull addr); +typedef int net_send_cb(void *_Nullable obj, Socket sock, const uint8_t *_Nonnull buf, size_t len); +typedef int net_sendto_cb(void *_Nullable obj, Socket sock, const uint8_t *_Nonnull buf, size_t len, const Network_Addr *_Nonnull addr); +typedef Socket net_socket_cb(void *_Nullable obj, int domain, int type, int proto); +typedef int net_socket_nonblock_cb(void *_Nullable obj, Socket sock, bool nonblock); +typedef int net_getsockopt_cb(void *_Nullable obj, Socket sock, int level, int optname, void *_Nonnull optval, size_t *_Nonnull optlen); +typedef int net_setsockopt_cb(void *_Nullable obj, Socket sock, int level, int optname, const void *_Nonnull optval, size_t optlen); +typedef int net_getaddrinfo_cb(void *_Nullable obj, const Memory *_Nonnull mem, const char *_Nonnull address, int family, int protocol, Network_Addr *_Nullable *_Nonnull addrs); +typedef int net_freeaddrinfo_cb(void *_Nullable obj, const Memory *_Nonnull mem, Network_Addr *_Nullable addrs); /** @brief Functions wrapping POSIX network functions. * @@ -59,30 +59,30 @@ typedef int net_freeaddrinfo_cb(void *obj, const Memory *mem, Network_Addr *addr * expected to do when providing alternative Network implementations. */ typedef struct Network_Funcs { - net_close_cb *close; - net_accept_cb *accept; - net_bind_cb *bind; - net_listen_cb *listen; - net_connect_cb *connect; - net_recvbuf_cb *recvbuf; - net_recv_cb *recv; - net_recvfrom_cb *recvfrom; - net_send_cb *send; - net_sendto_cb *sendto; - net_socket_cb *socket; - net_socket_nonblock_cb *socket_nonblock; - net_getsockopt_cb *getsockopt; - net_setsockopt_cb *setsockopt; - net_getaddrinfo_cb *getaddrinfo; - net_freeaddrinfo_cb *freeaddrinfo; + net_close_cb *_Nullable close; + net_accept_cb *_Nullable accept; + net_bind_cb *_Nullable bind; + net_listen_cb *_Nullable listen; + net_connect_cb *_Nullable connect; + net_recvbuf_cb *_Nullable recvbuf; + net_recv_cb *_Nullable recv; + net_recvfrom_cb *_Nullable recvfrom; + net_send_cb *_Nullable send; + net_sendto_cb *_Nullable sendto; + net_socket_cb *_Nullable socket; + net_socket_nonblock_cb *_Nullable socket_nonblock; + net_getsockopt_cb *_Nullable getsockopt; + net_setsockopt_cb *_Nullable setsockopt; + net_getaddrinfo_cb *_Nullable getaddrinfo; + net_freeaddrinfo_cb *_Nullable freeaddrinfo; } Network_Funcs; typedef struct Network { - const Network_Funcs *funcs; - void *obj; + const Network_Funcs *_Nullable funcs; + void *_Nullable obj; } Network; -const Network *os_network(void); +const Network *_Nullable os_network(void); typedef struct Family { uint8_t value; @@ -222,7 +222,7 @@ typedef struct IP_Port { uint16_t port; } IP_Port; -Socket net_socket(non_null() const Network *ns, Family domain, int type, int protocol); +Socket net_socket(const Network *_Nonnull ns, Family domain, int type, int protocol); /** * Check if socket is valid. @@ -244,8 +244,8 @@ Socket net_invalid_socket(void); * @param ip_port IP and port to send data to. * @param net_profile Network profile to record the packet. */ -int net_send(non_null() const Network *ns, non_null() const Logger *log, Socket sock, non_null() const uint8_t *buf, size_t len, non_null() const IP_Port *ip_port, - nullable() Net_Profile *net_profile); +int net_send(const Network *_Nonnull ns, const Logger *_Nonnull log, Socket sock, const uint8_t *_Nonnull buf, size_t len, const IP_Port *_Nonnull ip_port, + Net_Profile *_Nullable net_profile); /** * Calls recv(sockfd, buf, len, MSG_NOSIGNAL). * @@ -256,21 +256,21 @@ int net_send(non_null() const Network *ns, non_null() const Logger *log, Socket * @param len Length of buffer. * @param ip_port IP and port of the sender. */ -int net_recv(non_null() const Network *ns, non_null() const Logger *log, Socket sock, non_null() uint8_t *buf, size_t len, non_null() const IP_Port *ip_port); +int net_recv(const Network *_Nonnull ns, const Logger *_Nonnull log, Socket sock, uint8_t *_Nonnull buf, size_t len, const IP_Port *_Nonnull ip_port); /** * Calls listen(sockfd, backlog). */ -int net_listen(non_null() const Network *ns, Socket sock, int backlog); +int net_listen(const Network *_Nonnull ns, Socket sock, int backlog); /** * Calls accept(sockfd, nullptr, nullptr). */ -Socket net_accept(non_null() const Network *ns, Socket sock); +Socket net_accept(const Network *_Nonnull ns, Socket sock); /** * return the size of data in the tcp recv buffer. * return 0 on failure. */ -uint16_t net_socket_data_recv_buffer(non_null() const Network *ns, Socket sock); +uint16_t net_socket_data_recv_buffer(const Network *_Nonnull ns, Socket sock); /** Convert values between host and network byte order. */ uint32_t net_htonl(uint32_t hostlong); @@ -278,18 +278,18 @@ uint16_t net_htons(uint16_t hostshort); uint32_t net_ntohl(uint32_t hostlong); uint16_t net_ntohs(uint16_t hostshort); -size_t net_pack_bool(non_null() uint8_t *bytes, bool v); -size_t net_pack_u16(non_null() uint8_t *bytes, uint16_t v); -size_t net_pack_u32(non_null() uint8_t *bytes, uint32_t v); -size_t net_pack_u64(non_null() uint8_t *bytes, uint64_t v); +size_t net_pack_bool(uint8_t *_Nonnull bytes, bool v); +size_t net_pack_u16(uint8_t *_Nonnull bytes, uint16_t v); +size_t net_pack_u32(uint8_t *_Nonnull bytes, uint32_t v); +size_t net_pack_u64(uint8_t *_Nonnull bytes, uint64_t v); -size_t net_unpack_bool(non_null() const uint8_t *bytes, non_null() bool *v); -size_t net_unpack_u16(non_null() const uint8_t *bytes, non_null() uint16_t *v); -size_t net_unpack_u32(non_null() const uint8_t *bytes, non_null() uint32_t *v); -size_t net_unpack_u64(non_null() const uint8_t *bytes, non_null() uint64_t *v); +size_t net_unpack_bool(const uint8_t *_Nonnull bytes, bool *_Nonnull v); +size_t net_unpack_u16(const uint8_t *_Nonnull bytes, uint16_t *_Nonnull v); +size_t net_unpack_u32(const uint8_t *_Nonnull bytes, uint32_t *_Nonnull v); +size_t net_unpack_u64(const uint8_t *_Nonnull bytes, uint64_t *_Nonnull v); /** Does the IP6 struct a contain an IPv4 address in an IPv6 one? */ -bool ipv6_ipv4_in_v6(non_null() const IP6 *a); +bool ipv6_ipv4_in_v6(const IP6 *_Nonnull a); #define TOX_ENABLE_IPV6_DEFAULT true @@ -314,7 +314,7 @@ typedef struct Ip_Ntoa { * * @return Pointer to the buffer inside `ip_str` containing the IP string. */ -const char *net_ip_ntoa(non_null() const IP *ip, non_null() Ip_Ntoa *ip_str); +const char *_Nonnull net_ip_ntoa(const IP *_Nonnull ip, Ip_Ntoa *_Nonnull ip_str); /** * Parses IP structure into an address string. @@ -328,7 +328,7 @@ const char *net_ip_ntoa(non_null() const IP *ip, non_null() Ip_Ntoa *ip_str); * * @return true on success, false on failure. */ -bool ip_parse_addr(non_null() const IP *ip, non_null() char *address, size_t length); +bool ip_parse_addr(const IP *_Nonnull ip, char *_Nonnull address, size_t length); /** * Directly parses the input into an IP structure. @@ -340,7 +340,7 @@ bool ip_parse_addr(non_null() const IP *ip, non_null() char *address, size_t len * * @return true on success, false on failure. */ -bool addr_parse_ip(non_null() const char *address, non_null() IP *to); +bool addr_parse_ip(const char *_Nonnull address, IP *_Nonnull to); /** * Compares two IP structures. @@ -349,7 +349,7 @@ bool addr_parse_ip(non_null() const char *address, non_null() IP *to); * * @return false when not equal or when uninitialized. */ -bool ip_equal(nullable() const IP *a, nullable() const IP *b); +bool ip_equal(const IP *_Nullable a, const IP *_Nullable b); /** * Compares two IP_Port structures. * @@ -357,7 +357,7 @@ bool ip_equal(nullable() const IP *a, nullable() const IP *b); * * @return false when not equal or when uninitialized. */ -bool ipport_equal(nullable() const IP_Port *a, nullable() const IP_Port *b); +bool ipport_equal(const IP_Port *_Nullable a, const IP_Port *_Nullable b); /** * @brief IP_Port comparison function with `memcmp` signature. * @@ -367,22 +367,22 @@ bool ipport_equal(nullable() const IP_Port *a, nullable() const IP_Port *b); * @retval 0 if `a == b` * @retval 1 if `a > b` */ -int ipport_cmp_handler(non_null() const void *a, non_null() const void *b, size_t size); +int ipport_cmp_handler(const void *_Nonnull a, const void *_Nonnull b, size_t size); /** nulls out ip */ -void ip_reset(non_null() IP *ip); +void ip_reset(IP *_Nonnull ip); /** nulls out ip_port */ -void ipport_reset(non_null() IP_Port *ipport); +void ipport_reset(IP_Port *_Nonnull ipport); /** nulls out ip, sets family according to flag */ -void ip_init(non_null() IP *ip, bool ipv6enabled); +void ip_init(IP *_Nonnull ip, bool ipv6enabled); /** checks if ip is valid */ -bool ip_isset(non_null() const IP *ip); +bool ip_isset(const IP *_Nonnull ip); /** checks if ip is valid */ -bool ipport_isset(non_null() const IP_Port *ipport); +bool ipport_isset(const IP_Port *_Nonnull ipport); /** copies an ip structure (careful about direction) */ -void ip_copy(non_null() IP *target, non_null() const IP *source); +void ip_copy(IP *_Nonnull target, const IP *_Nonnull source); /** copies an ip_port structure (careful about direction) */ -void ipport_copy(non_null() IP_Port *target, non_null() const IP_Port *source); +void ipport_copy(IP_Port *_Nonnull target, const IP_Port *_Nonnull source); /** * @brief Resolves string into an IP address. @@ -400,48 +400,48 @@ void ipport_copy(non_null() IP_Port *target, non_null() const IP_Port *source); * * @return true on success, false on failure */ -bool addr_resolve_or_parse_ip(non_null() const Network *ns, non_null() const Memory *mem, non_null() const char *address, non_null() IP *to, nullable() IP *extra, bool dns_enabled); +bool addr_resolve_or_parse_ip(const Network *_Nonnull ns, const Memory *_Nonnull mem, const char *_Nonnull address, IP *_Nonnull to, IP *_Nullable extra, bool dns_enabled); /** @brief Function to receive data, ip and port of sender is put into ip_port. * Packet data is put into data. * Packet length is put into length. */ -typedef int packet_handler_cb(void *object, const IP_Port *source, const uint8_t *packet, uint16_t length, void *userdata); +typedef int packet_handler_cb(void *_Nullable object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nullable userdata); typedef struct Networking_Core Networking_Core; -Family net_family(non_null() const Networking_Core *net); -uint16_t net_port(non_null() const Networking_Core *net); +Family net_family(const Networking_Core *_Nonnull net); +uint16_t net_port(const Networking_Core *_Nonnull net); /** Close the socket. */ -void kill_sock(non_null() const Network *ns, Socket sock); +void kill_sock(const Network *_Nonnull ns, Socket sock); /** * Set socket as nonblocking * * @return true on success, false on failure. */ -bool set_socket_nonblock(non_null() const Network *ns, Socket sock); +bool set_socket_nonblock(const Network *_Nonnull ns, Socket sock); /** * Set socket to not emit SIGPIPE * * @return true on success, false on failure. */ -bool set_socket_nosigpipe(non_null() const Network *ns, Socket sock); +bool set_socket_nosigpipe(const Network *_Nonnull ns, Socket sock); /** * Enable SO_REUSEADDR on socket. * * @return true on success, false on failure. */ -bool set_socket_reuseaddr(non_null() const Network *ns, Socket sock); +bool set_socket_reuseaddr(const Network *_Nonnull ns, Socket sock); /** * Set socket to dual (IPv4 + IPv6 socket) * * @return true on success, false on failure. */ -bool set_socket_dualstack(non_null() const Network *ns, Socket sock); +bool set_socket_dualstack(const Network *_Nonnull ns, Socket sock); /* Basic network functions: */ @@ -451,33 +451,33 @@ bool set_socket_dualstack(non_null() const Network *ns, Socket sock); * Use `send_packet` to send it to an IP/port endpoint. */ typedef struct Packet { - const uint8_t *data; + const uint8_t *_Nonnull data; uint16_t length; } Packet; /** * Function to send a network packet to a given IP/port. */ -int send_packet(non_null() const Networking_Core *net, non_null() const IP_Port *ip_port, Packet packet); +int send_packet(const Networking_Core *_Nonnull net, const IP_Port *_Nonnull ip_port, Packet packet); /** * Function to send packet(data) of length length to ip_port. * * @deprecated Use send_packet instead. */ -int sendpacket(non_null() const Networking_Core *net, non_null() const IP_Port *ip_port, non_null() const uint8_t *data, uint16_t length); +int sendpacket(const Networking_Core *_Nonnull net, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull data, uint16_t length); /** Function to call when packet beginning with byte is received. */ -void networking_registerhandler(non_null() Networking_Core *net, uint8_t byte, nullable() packet_handler_cb *cb, nullable() void *object); +void networking_registerhandler(Networking_Core *_Nonnull net, uint8_t byte, packet_handler_cb *_Nullable cb, void *_Nullable object); /** Call this several times a second. */ -void networking_poll(non_null() const Networking_Core *net, nullable() void *userdata); +void networking_poll(const Networking_Core *_Nonnull net, void *_Nullable userdata); typedef enum Net_Err_Connect { NET_ERR_CONNECT_OK, NET_ERR_CONNECT_INVALID_FAMILY, NET_ERR_CONNECT_FAILED, } Net_Err_Connect; -const char *net_err_connect_to_string(Net_Err_Connect err); +const char *_Nonnull net_err_connect_to_string(Net_Err_Connect err); /** @brief Connect a socket to the address specified by the ip_port. * @@ -485,7 +485,7 @@ const char *net_err_connect_to_string(Net_Err_Connect err); * * @retval true on success, false on failure. */ -bool net_connect(non_null() const Network *ns, non_null() const Memory *mem, non_null() const Logger *log, Socket sock, non_null() const IP_Port *ip_port, non_null() Net_Err_Connect *err); +bool net_connect(const Network *_Nonnull ns, const Memory *_Nonnull mem, const Logger *_Nonnull log, Socket sock, const IP_Port *_Nonnull ip_port, Net_Err_Connect *_Nonnull err); /** @brief High-level getaddrinfo implementation. * @@ -507,11 +507,11 @@ bool net_connect(non_null() const Network *ns, non_null() const Memory *mem, non * @retval 0 if res array empty. * @retval -1 on error. */ -int32_t net_getipport(non_null() const Network *ns, non_null() const Memory *mem, non_null() const char *node, non_null() IP_Port **res, int tox_type, bool dns_enabled); +int32_t net_getipport(const Network *_Nonnull ns, const Memory *_Nonnull mem, const char *_Nonnull node, IP_Port *_Nullable *_Nonnull res, int tox_type, bool dns_enabled); /** Deallocates memory allocated by net_getipport */ -void net_freeipport(non_null() const Memory *mem, nullable() IP_Port *ip_ports); -bool bin_pack_ip_port(non_null() Bin_Pack *bp, non_null() const Logger *logger, non_null() const IP_Port *ip_port); +void net_freeipport(const Memory *_Nonnull mem, IP_Port *_Nullable ip_ports); +bool bin_pack_ip_port(Bin_Pack *_Nonnull bp, const Logger *_Nonnull logger, const IP_Port *_Nonnull ip_port); /** @brief Pack an IP_Port structure into data of max size length. * @@ -520,7 +520,7 @@ bool bin_pack_ip_port(non_null() Bin_Pack *bp, non_null() const Logger *logger, * @return size of packed IP_Port data on success. * @retval -1 on failure. */ -int pack_ip_port(non_null() const Logger *logger, non_null() uint8_t *data, uint16_t length, non_null() const IP_Port *ip_port); +int pack_ip_port(const Logger *_Nonnull logger, uint8_t *_Nonnull data, uint16_t length, const IP_Port *_Nonnull ip_port); /** @brief Unpack IP_Port structure from data of max size length into ip_port. * @@ -529,12 +529,12 @@ int pack_ip_port(non_null() const Logger *logger, non_null() uint8_t *data, uint * @return size of unpacked ip_port on success. * @retval -1 on failure. */ -int unpack_ip_port(non_null() IP_Port *ip_port, non_null() const uint8_t *data, uint16_t length, bool tcp_enabled); +int unpack_ip_port(IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull data, uint16_t length, bool tcp_enabled); /** * @return true on success, false on failure. */ -bool bind_to_port(non_null() const Network *ns, Socket sock, Family family, uint16_t port); +bool bind_to_port(const Network *_Nonnull ns, Socket sock, Family family, uint16_t port); /** @brief Get the last networking error code. * @@ -568,7 +568,7 @@ typedef struct Net_Strerror { * * @return pointer to a NULL-terminated string describing the error code. */ -char *net_strerror(int error, non_null() Net_Strerror *buf); +char *_Nonnull net_strerror(int error, Net_Strerror *_Nonnull buf); /** @brief Initialize networking. * Bind to ip and port. @@ -580,18 +580,18 @@ char *net_strerror(int error, non_null() Net_Strerror *buf); * * If error is non NULL it is set to 0 if no issues, 1 if socket related error, 2 if other. */ -Networking_Core *new_networking_ex( - non_null() const Logger *log, non_null() const Memory *mem, non_null() const Network *ns, non_null() const IP *ip, - uint16_t port_from, uint16_t port_to, nullable() unsigned int *error); -Networking_Core *new_networking_no_udp(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Network *ns); +Networking_Core *_Nullable new_networking_ex( + const Logger *_Nonnull log, const Memory *_Nonnull mem, const Network *_Nonnull ns, const IP *_Nonnull ip, + uint16_t port_from, uint16_t port_to, unsigned int *_Nullable error); +Networking_Core *_Nullable new_networking_no_udp(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Network *_Nonnull ns); /** Function to cleanup networking stuff (doesn't do much right now). */ -void kill_networking(nullable() Networking_Core *net); +void kill_networking(Networking_Core *_Nullable net); /** @brief Returns a pointer to the network net_profile object associated with `net`. * * Returns null if `net` is null. */ -const Net_Profile *net_get_net_profile(non_null() const Networking_Core *net); +const Net_Profile *_Nullable net_get_net_profile(const Networking_Core *_Nonnull net); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/onion.c b/toxcore/onion.c index f69d7e589..3241fbf4b 100644 --- a/toxcore/onion.c +++ b/toxcore/onion.c @@ -38,7 +38,7 @@ #define KEYS_TIMEOUT 600 /** Change symmetric keys every 2 hours to make paths expire eventually. */ -static void change_symmetric_key(non_null() Onion *onion) +static void change_symmetric_key(Onion *_Nonnull onion) { if (mono_time_is_timeout(onion->mono_time, onion->timestamp, KEY_REFRESH_INTERVAL)) { new_symmetric_key(onion->rng, onion->secret_symmetric_key); @@ -47,7 +47,7 @@ static void change_symmetric_key(non_null() Onion *onion) } /** packing and unpacking functions */ -static void ip_pack_to_bytes(non_null() uint8_t *data, non_null() const IP *source) +static void ip_pack_to_bytes(uint8_t *_Nonnull data, const IP *_Nonnull source) { data[0] = source->family.value; @@ -60,7 +60,7 @@ static void ip_pack_to_bytes(non_null() uint8_t *data, non_null() const IP *sour } /** return 0 on success, -1 on failure. */ -static int ip_unpack_from_bytes(non_null() IP *target, non_null() const uint8_t *data, unsigned int data_size, bool disable_family_check) +static int ip_unpack_from_bytes(IP *_Nonnull target, const uint8_t *_Nonnull data, unsigned int data_size, bool disable_family_check) { if (data_size < (1 + SIZE_IP6)) { return -1; @@ -82,14 +82,14 @@ static int ip_unpack_from_bytes(non_null() IP *target, non_null() const uint8_t return valid ? 0 : -1; } -static void ipport_pack(non_null() uint8_t *data, non_null() const IP_Port *source) +static void ipport_pack(uint8_t *_Nonnull data, const IP_Port *_Nonnull source) { ip_pack_to_bytes(data, &source->ip); memcpy(data + SIZE_IP, &source->port, SIZE_PORT); } /** return 0 on success, -1 on failure. */ -static int ipport_unpack(non_null() IP_Port *target, non_null() const uint8_t *data, unsigned int data_size, bool disable_family_check) +static int ipport_unpack(IP_Port *_Nonnull target, const uint8_t *_Nonnull data, unsigned int data_size, bool disable_family_check) { if (data_size < (SIZE_IP + SIZE_PORT)) { return -1; @@ -311,7 +311,7 @@ int send_onion_response(const Logger *log, const Networking_Core *net, return 0; } -static int handle_send_initial(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int handle_send_initial(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { Onion *onion = (Onion *)object; @@ -405,7 +405,7 @@ int onion_send_1(const Onion *onion, const uint8_t *plain, uint16_t len, const I return 0; } -static int handle_send_1(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int handle_send_1(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { Onion *onion = (Onion *)object; @@ -470,7 +470,7 @@ static int handle_send_1(non_null() void *object, non_null() const IP_Port *sour return 0; } -static int handle_send_2(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int handle_send_2(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { Onion *onion = (Onion *)object; @@ -542,7 +542,7 @@ static int handle_send_2(non_null() void *object, non_null() const IP_Port *sour return 0; } -static int handle_recv_3(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int handle_recv_3(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { Onion *onion = (Onion *)object; @@ -594,7 +594,7 @@ static int handle_recv_3(non_null() void *object, non_null() const IP_Port *sour return 0; } -static int handle_recv_2(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int handle_recv_2(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { Onion *onion = (Onion *)object; @@ -645,7 +645,7 @@ static int handle_recv_2(non_null() void *object, non_null() const IP_Port *sour return 0; } -static int handle_recv_1(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int handle_recv_1(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { Onion *onion = (Onion *)object; diff --git a/toxcore/onion.h b/toxcore/onion.h index 5b5950ba9..355a41f6b 100644 --- a/toxcore/onion.h +++ b/toxcore/onion.h @@ -18,24 +18,24 @@ #include "network.h" #include "shared_key_cache.h" -typedef int onion_recv_1_cb(void *object, const IP_Port *dest, const uint8_t *data, uint16_t length); +typedef int onion_recv_1_cb(void *_Nullable object, const IP_Port *_Nonnull dest, const uint8_t *_Nonnull data, uint16_t length); typedef struct Onion { - const Logger *log; - const Mono_Time *mono_time; - const Random *rng; - const Memory *mem; - DHT *dht; - Networking_Core *net; + const Logger *_Nonnull log; + const Mono_Time *_Nonnull mono_time; + const Random *_Nonnull rng; + const Memory *_Nonnull mem; + DHT *_Nonnull dht; + Networking_Core *_Nonnull net; uint8_t secret_symmetric_key[CRYPTO_SYMMETRIC_KEY_SIZE]; uint64_t timestamp; - Shared_Key_Cache *shared_keys_1; - Shared_Key_Cache *shared_keys_2; - Shared_Key_Cache *shared_keys_3; + Shared_Key_Cache *_Nonnull shared_keys_1; + Shared_Key_Cache *_Nonnull shared_keys_2; + Shared_Key_Cache *_Nonnull shared_keys_3; - onion_recv_1_cb *recv_1_function; - void *callback_object; + onion_recv_1_cb *_Nullable recv_1_function; + void *_Nullable callback_object; } Onion; #define ONION_MAX_PACKET_SIZE 1400 @@ -84,14 +84,14 @@ typedef struct Onion_Path { * return -1 on failure. * return 0 on success. */ -int create_onion_path(non_null() const Random *rng, non_null() const DHT *dht, non_null() Onion_Path *new_path, non_null() const Node_format *nodes); +int create_onion_path(const Random *_Nonnull rng, const DHT *_Nonnull dht, Onion_Path *_Nonnull new_path, const Node_format *_Nonnull nodes); /** @brief Dump nodes in onion path to nodes of length num_nodes. * * return -1 on failure. * return 0 on success. */ -int onion_path_to_nodes(non_null() Node_format *nodes, unsigned int num_nodes, non_null() const Onion_Path *path); +int onion_path_to_nodes(Node_format *_Nonnull nodes, unsigned int num_nodes, const Onion_Path *_Nonnull path); /** @brief Create a onion packet. * @@ -102,8 +102,8 @@ int onion_path_to_nodes(non_null() Node_format *nodes, unsigned int num_nodes, n * return -1 on failure. * return length of created packet on success. */ -int create_onion_packet(non_null() const Memory *mem, non_null() const Random *rng, non_null() uint8_t *packet, uint16_t max_packet_length, non_null() const Onion_Path *path, - non_null() const IP_Port *dest, non_null() const uint8_t *data, uint16_t length); +int create_onion_packet(const Memory *_Nonnull mem, const Random *_Nonnull rng, uint8_t *_Nonnull packet, uint16_t max_packet_length, const Onion_Path *_Nonnull path, + const IP_Port *_Nonnull dest, const uint8_t *_Nonnull data, uint16_t length); /** @brief Create a onion packet to be sent over tcp. * @@ -114,8 +114,8 @@ int create_onion_packet(non_null() const Memory *mem, non_null() const Random *r * return -1 on failure. * return length of created packet on success. */ -int create_onion_packet_tcp(non_null() const Memory *mem, non_null() const Random *rng, non_null() uint8_t *packet, uint16_t max_packet_length, non_null() const Onion_Path *path, - non_null() const IP_Port *dest, non_null() const uint8_t *data, uint16_t length); +int create_onion_packet_tcp(const Memory *_Nonnull mem, const Random *_Nonnull rng, uint8_t *_Nonnull packet, uint16_t max_packet_length, const Onion_Path *_Nonnull path, + const IP_Port *_Nonnull dest, const uint8_t *_Nonnull data, uint16_t length); /** @brief Create and send a onion response sent initially to dest with. * Maximum length of data is ONION_RESPONSE_MAX_DATA_SIZE. @@ -123,8 +123,8 @@ int create_onion_packet_tcp(non_null() const Memory *mem, non_null() const Rando * return -1 on failure. * return 0 on success. */ -int send_onion_response(non_null() const Logger *log, non_null() const Networking_Core *net, non_null() const IP_Port *dest, non_null() const uint8_t *data, uint16_t length, - non_null() const uint8_t *ret); +int send_onion_response(const Logger *_Nonnull log, const Networking_Core *_Nonnull net, const IP_Port *_Nonnull dest, const uint8_t *_Nonnull data, uint16_t length, + const uint8_t *_Nonnull ret); /** @brief Function to handle/send received decrypted versions of the packet created by create_onion_packet. * @@ -136,11 +136,11 @@ int send_onion_response(non_null() const Logger *log, non_null() const Networkin * Source family must be set to something else than TOX_AF_INET6 or TOX_AF_INET so that the callback gets called * when the response is received. */ -int onion_send_1(non_null() const Onion *onion, non_null() const uint8_t *plain, uint16_t len, non_null() const IP_Port *source, non_null() const uint8_t *nonce); +int onion_send_1(const Onion *_Nonnull onion, const uint8_t *_Nonnull plain, uint16_t len, const IP_Port *_Nonnull source, const uint8_t *_Nonnull nonce); /** Set the callback to be called when the dest ip_port doesn't have TOX_AF_INET6 or TOX_AF_INET as the family. */ -void set_callback_handle_recv_1(non_null() Onion *onion, nullable() onion_recv_1_cb *function, nullable() void *object); -Onion *new_onion(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Mono_Time *mono_time, non_null() const Random *rng, non_null() DHT *dht); +void set_callback_handle_recv_1(Onion *_Nonnull onion, onion_recv_1_cb *_Nullable function, void *_Nullable object); +Onion *_Nullable new_onion(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, const Random *_Nonnull rng, DHT *_Nonnull dht); -void kill_onion(nullable() Onion *onion); +void kill_onion(Onion *_Nullable onion); #endif /* C_TOXCORE_TOXCORE_ONION_H */ diff --git a/toxcore/onion_announce.c b/toxcore/onion_announce.c index 446885ab3..6c80aa96d 100644 --- a/toxcore/onion_announce.c +++ b/toxcore/onion_announce.c @@ -269,7 +269,7 @@ int send_data_request( * return -1 if no * return position in list if yes */ -static int in_entries(non_null() const Onion_Announce *onion_a, non_null() const uint8_t *public_key) +static int in_entries(const Onion_Announce *_Nonnull onion_a, const uint8_t *_Nonnull public_key) { for (unsigned int i = 0; i < ONION_ANNOUNCE_MAX_ENTRIES; ++i) { if (!mono_time_is_timeout(onion_a->mono_time, onion_a->entries[i].announce_time, ONION_ANNOUNCE_TIMEOUT) @@ -287,7 +287,7 @@ typedef struct Onion_Announce_Entry_Cmp { const uint8_t *comp_public_key; } Onion_Announce_Entry_Cmp; -static int onion_announce_entry_cmp(non_null() const Onion_Announce_Entry_Cmp *cmp, non_null() const Onion_Announce_Entry *entry1, non_null() const Onion_Announce_Entry *entry2) +static int onion_announce_entry_cmp(const Onion_Announce_Entry_Cmp *_Nonnull cmp, const Onion_Announce_Entry *_Nonnull entry1, const Onion_Announce_Entry *_Nonnull entry2) { const bool t1 = mono_time_is_timeout(cmp->mono_time, entry1->announce_time, ONION_ANNOUNCE_TIMEOUT); const bool t2 = mono_time_is_timeout(cmp->mono_time, entry2->announce_time, ONION_ANNOUNCE_TIMEOUT); @@ -317,7 +317,7 @@ static int onion_announce_entry_cmp(non_null() const Onion_Announce_Entry_Cmp *c return 0; } -static bool onion_announce_entry_less_handler(non_null() const void *object, non_null() const void *a, non_null() const void *b) +static bool onion_announce_entry_less_handler(const void *_Nonnull object, const void *_Nonnull a, const void *_Nonnull b) { const Onion_Announce_Entry_Cmp *cmp = (const Onion_Announce_Entry_Cmp *)object; const Onion_Announce_Entry *entry1 = (const Onion_Announce_Entry *)a; @@ -326,26 +326,26 @@ static bool onion_announce_entry_less_handler(non_null() const void *object, non return onion_announce_entry_cmp(cmp, entry1, entry2) < 0; } -static const void *onion_announce_entry_get_handler(non_null() const void *arr, uint32_t index) +static const void *onion_announce_entry_get_handler(const void *_Nonnull arr, uint32_t index) { const Onion_Announce_Entry *entries = (const Onion_Announce_Entry *)arr; return &entries[index]; } -static void onion_announce_entry_set_handler(non_null() void *arr, uint32_t index, non_null() const void *val) +static void onion_announce_entry_set_handler(void *_Nonnull arr, uint32_t index, const void *_Nonnull val) { Onion_Announce_Entry *entries = (Onion_Announce_Entry *)arr; const Onion_Announce_Entry *entry = (const Onion_Announce_Entry *)val; entries[index] = *entry; } -static void *onion_announce_entry_subarr_handler(non_null() void *arr, uint32_t index, uint32_t size) +static void *onion_announce_entry_subarr_handler(void *_Nonnull arr, uint32_t index, uint32_t size) { Onion_Announce_Entry *entries = (Onion_Announce_Entry *)arr; return &entries[index]; } -static void *onion_announce_entry_alloc_handler(non_null() const void *object, uint32_t size) +static void *onion_announce_entry_alloc_handler(const void *_Nonnull object, uint32_t size) { const Onion_Announce_Entry_Cmp *cmp = (const Onion_Announce_Entry_Cmp *)object; Onion_Announce_Entry *tmp = (Onion_Announce_Entry *)mem_valloc(cmp->mem, size, sizeof(Onion_Announce_Entry)); @@ -357,7 +357,7 @@ static void *onion_announce_entry_alloc_handler(non_null() const void *object, u return tmp; } -static void onion_announce_entry_delete_handler(non_null() const void *object, non_null() void *arr, uint32_t size) +static void onion_announce_entry_delete_handler(const void *_Nonnull object, void *_Nonnull arr, uint32_t size) { const Onion_Announce_Entry_Cmp *cmp = (const Onion_Announce_Entry_Cmp *)object; mem_delete(cmp->mem, arr); @@ -372,8 +372,8 @@ static const Sort_Funcs onion_announce_entry_cmp_funcs = { onion_announce_entry_delete_handler, }; -static void sort_onion_announce_list(non_null() const Memory *mem, non_null() const Mono_Time *mono_time, non_null() Onion_Announce_Entry *list, unsigned int length, - non_null() const uint8_t *comp_public_key) +static void sort_onion_announce_list(const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, Onion_Announce_Entry *_Nonnull list, unsigned int length, + const uint8_t *_Nonnull comp_public_key) { // Pass comp_public_key to sort with each Onion_Announce_Entry entry, so the // comparison function can use it as the base of comparison. @@ -391,8 +391,8 @@ static void sort_onion_announce_list(non_null() const Memory *mem, non_null() co * return -1 if failure * return position if added */ -static int add_to_entries(non_null() Onion_Announce *onion_a, non_null() const IP_Port *ret_ip_port, non_null() const uint8_t *public_key, non_null() const uint8_t *data_public_key, - non_null() const uint8_t *ret) +static int add_to_entries(Onion_Announce *_Nonnull onion_a, const IP_Port *_Nonnull ret_ip_port, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull data_public_key, + const uint8_t *_Nonnull ret) { int pos = in_entries(onion_a, public_key); @@ -426,8 +426,8 @@ static int add_to_entries(non_null() Onion_Announce *onion_a, non_null() const I return in_entries(onion_a, public_key); } -static void make_announce_payload_helper(non_null() const Onion_Announce *onion_a, non_null() const uint8_t *ping_id, non_null() uint8_t *response, int index, - non_null() const uint8_t *packet_public_key, non_null() const uint8_t *data_public_key) +static void make_announce_payload_helper(const Onion_Announce *_Nonnull onion_a, const uint8_t *_Nonnull ping_id, uint8_t *_Nonnull response, int index, + const uint8_t *_Nonnull packet_public_key, const uint8_t *_Nonnull data_public_key) { if (index < 0) { response[0] = 0; @@ -468,9 +468,9 @@ static void make_announce_payload_helper(non_null() const Onion_Announce *onion_ * @retval 0 on success. */ static int handle_announce_request_common( - non_null() Onion_Announce *onion_a, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, + Onion_Announce *_Nonnull onion_a, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, uint8_t response_packet_id, uint16_t plain_size, bool want_node_count, uint16_t max_extra_size, - nullable() pack_extra_data_cb *pack_extra_data_callback) + pack_extra_data_cb *_Nullable pack_extra_data_callback) { const uint8_t *packet_public_key = packet + 1 + CRYPTO_NONCE_SIZE; const uint8_t *shared_key = shared_key_cache_lookup(onion_a->shared_keys_recv, packet_public_key); @@ -607,7 +607,7 @@ static int handle_announce_request_common( return 0; } -static int handle_gca_announce_request(non_null() Onion_Announce *onion_a, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length) +static int handle_gca_announce_request(Onion_Announce *_Nonnull onion_a, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length) { if (length > ANNOUNCE_REQUEST_MAX_SIZE_RECV || length <= ANNOUNCE_REQUEST_MIN_SIZE_RECV) { return 1; @@ -622,8 +622,8 @@ static int handle_gca_announce_request(non_null() Onion_Announce *onion_a, non_n true, onion_a->extra_data_max_size, onion_a->extra_data_callback); } -static int handle_announce_request(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int handle_announce_request(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nullable userdata) { Onion_Announce *onion_a = (Onion_Announce *)object; if (length != ANNOUNCE_REQUEST_MIN_SIZE_RECV) { @@ -636,8 +636,8 @@ static int handle_announce_request(non_null() void *object, non_null() const IP_ } /* TODO(Jfreegman): DEPRECATE */ -static int handle_announce_request_old(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int handle_announce_request_old(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nullable userdata) { Onion_Announce *onion_a = (Onion_Announce *)object; if (length != ANNOUNCE_REQUEST_SIZE_RECV) { @@ -649,7 +649,7 @@ static int handle_announce_request_old(non_null() void *object, non_null() const false, 0, nullptr); } -static int handle_data_request(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int handle_data_request(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { const Onion_Announce *onion_a = (const Onion_Announce *)object; diff --git a/toxcore/onion_announce.h b/toxcore/onion_announce.h index 580b43cc1..a7e0f0658 100644 --- a/toxcore/onion_announce.h +++ b/toxcore/onion_announce.h @@ -44,8 +44,8 @@ typedef struct Onion_Announce Onion_Announce; /** These two are not public; they are for tests only! */ -uint8_t *onion_announce_entry_public_key(non_null() Onion_Announce *onion_a, uint32_t entry); -void onion_announce_entry_set_time(non_null() Onion_Announce *onion_a, uint32_t entry, uint64_t announce_time); +uint8_t *_Nullable onion_announce_entry_public_key(Onion_Announce *_Nonnull onion_a, uint32_t entry); +void onion_announce_entry_set_time(Onion_Announce *_Nonnull onion_a, uint32_t entry, uint64_t announce_time); /** @brief Create an onion announce request packet in packet of max_packet_length. * @@ -62,8 +62,8 @@ void onion_announce_entry_set_time(non_null() Onion_Announce *onion_a, uint32_t * return -1 on failure. * return packet length on success. */ -int create_announce_request(non_null() const Memory *mem, non_null() const Random *rng, non_null() uint8_t *packet, uint16_t max_packet_length, non_null() const uint8_t *dest_client_id, - non_null() const uint8_t *public_key, non_null() const uint8_t *secret_key, non_null() const uint8_t *ping_id, non_null() const uint8_t *client_id, non_null() const uint8_t *data_public_key, +int create_announce_request(const Memory *_Nonnull mem, const Random *_Nonnull rng, uint8_t *_Nonnull packet, uint16_t max_packet_length, const uint8_t *_Nonnull dest_client_id, + const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull secret_key, const uint8_t *_Nonnull ping_id, const uint8_t *_Nonnull client_id, const uint8_t *_Nonnull data_public_key, uint64_t sendback_data); /** @brief Create an onion data request packet in packet of max_packet_length. @@ -78,8 +78,8 @@ int create_announce_request(non_null() const Memory *mem, non_null() const Rando * return -1 on failure. * return 0 on success. */ -int create_data_request(non_null() const Memory *mem, non_null() const Random *rng, non_null() uint8_t *packet, uint16_t max_packet_length, non_null() const uint8_t *public_key, - non_null() const uint8_t *encrypt_public_key, non_null() const uint8_t *nonce, non_null() const uint8_t *data, uint16_t length); +int create_data_request(const Memory *_Nonnull mem, const Random *_Nonnull rng, uint8_t *_Nonnull packet, uint16_t max_packet_length, const uint8_t *_Nonnull public_key, + const uint8_t *_Nonnull encrypt_public_key, const uint8_t *_Nonnull nonce, const uint8_t *_Nonnull data, uint16_t length); /** @brief Create and send an onion announce request packet. * @@ -95,9 +95,9 @@ int create_data_request(non_null() const Memory *mem, non_null() const Random *r * return -1 on failure. * return 0 on success. */ -int send_announce_request(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Networking_Core *net, non_null() const Random *rng, non_null() const Onion_Path *path, - non_null() const Node_format *dest, non_null() const uint8_t *public_key, non_null() const uint8_t *secret_key, non_null() const uint8_t *ping_id, non_null() const uint8_t *client_id, - non_null() const uint8_t *data_public_key, uint64_t sendback_data); +int send_announce_request(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Networking_Core *_Nonnull net, const Random *_Nonnull rng, const Onion_Path *_Nonnull path, + const Node_format *_Nonnull dest, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull secret_key, const uint8_t *_Nonnull ping_id, const uint8_t *_Nonnull client_id, + const uint8_t *_Nonnull data_public_key, uint64_t sendback_data); /** @brief Create and send an onion data request packet. * @@ -115,16 +115,16 @@ int send_announce_request(non_null() const Logger *log, non_null() const Memory * return -1 on failure. * return 0 on success. */ -int send_data_request(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Networking_Core *net, non_null() const Random *rng, non_null() const Onion_Path *path, - non_null() const IP_Port *dest, non_null() const uint8_t *public_key, non_null() const uint8_t *encrypt_public_key, non_null() const uint8_t *nonce, non_null() const uint8_t *data, uint16_t length); +int send_data_request(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Networking_Core *_Nonnull net, const Random *_Nonnull rng, const Onion_Path *_Nonnull path, + const IP_Port *_Nonnull dest, const uint8_t *_Nonnull public_key, const uint8_t *_Nonnull encrypt_public_key, const uint8_t *_Nonnull nonce, const uint8_t *_Nonnull data, uint16_t length); -typedef int pack_extra_data_cb(void *object, const Logger *logger, const Memory *mem, const Mono_Time *mono_time, - uint8_t num_nodes, uint8_t *plain, uint16_t plain_size, - uint8_t *response, uint16_t response_size, uint16_t offset); +typedef int pack_extra_data_cb(void *_Nonnull object, const Logger *_Nonnull logger, const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, + uint8_t num_nodes, uint8_t *_Nonnull plain, uint16_t plain_size, + uint8_t *_Nonnull response, uint16_t response_size, uint16_t offset); -void onion_announce_extra_data_callback(non_null() Onion_Announce *onion_a, uint16_t extra_data_max_size, non_null() pack_extra_data_cb *extra_data_callback, non_null() void *extra_data_object); +void onion_announce_extra_data_callback(Onion_Announce *_Nonnull onion_a, uint16_t extra_data_max_size, pack_extra_data_cb *_Nonnull extra_data_callback, void *_Nonnull extra_data_object); -Onion_Announce *new_onion_announce(non_null() const Logger *log, non_null() const Memory *mem, non_null() const Random *rng, non_null() const Mono_Time *mono_time, non_null() DHT *dht); +Onion_Announce *_Nullable new_onion_announce(const Logger *_Nonnull log, const Memory *_Nonnull mem, const Random *_Nonnull rng, const Mono_Time *_Nonnull mono_time, DHT *_Nonnull dht); -void kill_onion_announce(nullable() Onion_Announce *onion_a); +void kill_onion_announce(Onion_Announce *_Nullable onion_a); #endif /* C_TOXCORE_TOXCORE_ONION_ANNOUNCE_H */ diff --git a/toxcore/onion_client.c b/toxcore/onion_client.c index 4cc532a5f..78e760962 100644 --- a/toxcore/onion_client.c +++ b/toxcore/onion_client.c @@ -257,7 +257,7 @@ bool onion_add_bs_path_node(Onion_Client *onion_c, const IP_Port *ip_port, const * return -1 on failure * return 0 on success */ -static int onion_add_path_node(non_null() Onion_Client *onion_c, non_null() const IP_Port *ip_port, non_null() const uint8_t *public_key) +static int onion_add_path_node(Onion_Client *_Nonnull onion_c, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key) { if (!net_family_is_ipv4(ip_port->ip.family) && !net_family_is_ipv6(ip_port->ip.family)) { return -1; @@ -324,7 +324,7 @@ uint16_t onion_backup_nodes(const Onion_Client *onion_c, Node_format *nodes, uin * * return the number of nodes. */ -static uint16_t random_nodes_path_onion(non_null() const Onion_Client *onion_c, non_null() Node_format *nodes, uint16_t max_num) +static uint16_t random_nodes_path_onion(const Onion_Client *_Nonnull onion_c, Node_format *_Nonnull nodes, uint16_t max_num) { if (max_num == 0) { return 0; @@ -381,7 +381,7 @@ static uint16_t random_nodes_path_onion(non_null() const Onion_Client *onion_c, * return -1 if nodes are suitable for creating a new path. * return path number of already existing similar path if one already exists. */ -static int is_path_used(non_null() const Mono_Time *mono_time, non_null() const Onion_Client_Paths *onion_paths, non_null() const Node_format *nodes) +static int is_path_used(const Mono_Time *_Nonnull mono_time, const Onion_Client_Paths *_Nonnull onion_paths, const Node_format *_Nonnull nodes) { for (unsigned int i = 0; i < NUMBER_ONION_PATHS; ++i) { if (mono_time_is_timeout(mono_time, onion_paths->last_path_success[i], ONION_PATH_TIMEOUT)) { @@ -402,7 +402,7 @@ static int is_path_used(non_null() const Mono_Time *mono_time, non_null() const } /** is path timed out */ -static bool path_timed_out(non_null() const Mono_Time *mono_time, non_null() const Onion_Client_Paths *onion_paths, uint32_t pathnum) +static bool path_timed_out(const Mono_Time *_Nonnull mono_time, const Onion_Client_Paths *_Nonnull onion_paths, uint32_t pathnum) { pathnum = pathnum % NUMBER_ONION_PATHS; @@ -415,7 +415,7 @@ static bool path_timed_out(non_null() const Mono_Time *mono_time, non_null() con } /** should node be considered to have timed out */ -static bool onion_node_timed_out(non_null() const Onion_Node *node, non_null() const Mono_Time *mono_time) +static bool onion_node_timed_out(const Onion_Node *_Nonnull node, const Mono_Time *_Nonnull mono_time) { return node->timestamp == 0 || (node->pings_since_last_response >= ONION_NODE_MAX_PINGS @@ -431,7 +431,7 @@ static bool onion_node_timed_out(non_null() const Onion_Node *node, non_null() c * TODO(irungentoo): Make this function better, it currently probably is * vulnerable to some attacks that could deanonimize us. */ -static int random_path(non_null() const Onion_Client *onion_c, non_null() Onion_Client_Paths *onion_paths, uint32_t pathnum, non_null() Onion_Path *path) +static int random_path(const Onion_Client *_Nonnull onion_c, Onion_Client_Paths *_Nonnull onion_paths, uint32_t pathnum, Onion_Path *_Nonnull path) { if (pathnum == UINT32_MAX) { pathnum = random_range_u32(onion_c->rng, NUMBER_ONION_PATHS); @@ -479,7 +479,7 @@ static int random_path(non_null() const Onion_Client *onion_c, non_null() Onion_ } /** Set path timeouts, return the path number. */ -static uint32_t set_path_timeouts(non_null() Onion_Client *onion_c, uint32_t num, uint32_t path_num) +static uint32_t set_path_timeouts(Onion_Client *_Nonnull onion_c, uint32_t num, uint32_t path_num) { if (num > onion_c->num_friends) { return -1; @@ -516,7 +516,7 @@ static uint32_t set_path_timeouts(non_null() Onion_Client *onion_c, uint32_t num * return -1 on failure. * return 0 on success. */ -static int send_onion_packet_tcp_udp(non_null() const Onion_Client *onion_c, non_null() const Onion_Path *path, non_null() const IP_Port *dest, non_null() const uint8_t *data, uint16_t length) +static int send_onion_packet_tcp_udp(const Onion_Client *_Nonnull onion_c, const Onion_Path *_Nonnull path, const IP_Port *_Nonnull dest, const uint8_t *_Nonnull data, uint16_t length) { if (net_family_is_ipv4(path->ip_port1.ip.family) || net_family_is_ipv6(path->ip_port1.ip.family)) { uint8_t packet[ONION_MAX_PACKET_SIZE]; @@ -564,7 +564,7 @@ static int send_onion_packet_tcp_udp(non_null() const Onion_Client *onion_c, non * return 0 on success * */ -static int new_sendback(non_null() Onion_Client *onion_c, uint32_t num, non_null() const uint8_t *public_key, non_null() const IP_Port *ip_port, uint32_t path_num, non_null() uint64_t *sendback) +static int new_sendback(Onion_Client *_Nonnull onion_c, uint32_t num, const uint8_t *_Nonnull public_key, const IP_Port *_Nonnull ip_port, uint32_t path_num, uint64_t *_Nonnull sendback) { uint8_t data[sizeof(uint32_t) + CRYPTO_PUBLIC_KEY_SIZE + SIZE_IPPORT + sizeof(uint32_t)]; memcpy(data, &num, sizeof(uint32_t)); @@ -597,7 +597,7 @@ static int new_sendback(non_null() Onion_Client *onion_c, uint32_t num, non_null * return -1 on failure * return num (see new_sendback(...)) on success */ -static uint32_t check_sendback(non_null() Onion_Client *onion_c, non_null() const uint8_t *sendback, non_null() uint8_t *ret_pubkey, non_null() IP_Port *ret_ip_port, non_null() uint32_t *path_num) +static uint32_t check_sendback(Onion_Client *_Nonnull onion_c, const uint8_t *_Nonnull sendback, uint8_t *_Nonnull ret_pubkey, IP_Port *_Nonnull ret_ip_port, uint32_t *_Nonnull path_num) { uint64_t sback; memcpy(&sback, sendback, sizeof(uint64_t)); @@ -616,8 +616,8 @@ static uint32_t check_sendback(non_null() Onion_Client *onion_c, non_null() cons return num; } -static int client_send_announce_request(non_null() Onion_Client *onion_c, uint32_t num, non_null() const IP_Port *dest, - non_null() const uint8_t *dest_pubkey, nullable() const uint8_t *ping_id, uint32_t pathnum) +static int client_send_announce_request(Onion_Client *_Nonnull onion_c, uint32_t num, const IP_Port *_Nonnull dest, + const uint8_t *_Nonnull dest_pubkey, const uint8_t *_Nullable ping_id, uint32_t pathnum) { if (num > onion_c->num_friends) { LOGGER_TRACE(onion_c->logger, "not sending announce to out of bounds friend %u (num friends: %u)", num, onion_c->num_friends); @@ -693,7 +693,7 @@ typedef struct Onion_Node_Cmp { const uint8_t *comp_public_key; } Onion_Node_Cmp; -static int onion_node_cmp(non_null() const Onion_Node_Cmp *cmp, non_null() const Onion_Node *entry1, non_null() const Onion_Node *entry2) +static int onion_node_cmp(const Onion_Node_Cmp *_Nonnull cmp, const Onion_Node *_Nonnull entry1, const Onion_Node *_Nonnull entry2) { const bool t1 = onion_node_timed_out(entry1, cmp->mono_time); const bool t2 = onion_node_timed_out(entry2, cmp->mono_time); @@ -723,7 +723,7 @@ static int onion_node_cmp(non_null() const Onion_Node_Cmp *cmp, non_null() const return 0; } -static bool onion_node_less_handler(non_null() const void *object, non_null() const void *a, non_null() const void *b) +static bool onion_node_less_handler(const void *_Nonnull object, const void *_Nonnull a, const void *_Nonnull b) { const Onion_Node_Cmp *cmp = (const Onion_Node_Cmp *)object; const Onion_Node *entry1 = (const Onion_Node *)a; @@ -732,26 +732,26 @@ static bool onion_node_less_handler(non_null() const void *object, non_null() co return onion_node_cmp(cmp, entry1, entry2) < 0; } -static const void *onion_node_get_handler(non_null() const void *arr, uint32_t index) +static const void *onion_node_get_handler(const void *_Nonnull arr, uint32_t index) { const Onion_Node *entries = (const Onion_Node *)arr; return &entries[index]; } -static void onion_node_set_handler(non_null() void *arr, uint32_t index, non_null() const void *val) +static void onion_node_set_handler(void *_Nonnull arr, uint32_t index, const void *_Nonnull val) { Onion_Node *entries = (Onion_Node *)arr; const Onion_Node *entry = (const Onion_Node *)val; entries[index] = *entry; } -static void *onion_node_subarr_handler(non_null() void *arr, uint32_t index, uint32_t size) +static void *onion_node_subarr_handler(void *_Nonnull arr, uint32_t index, uint32_t size) { Onion_Node *entries = (Onion_Node *)arr; return &entries[index]; } -static void *onion_node_alloc_handler(non_null() const void *object, uint32_t size) +static void *onion_node_alloc_handler(const void *_Nonnull object, uint32_t size) { const Onion_Node_Cmp *cmp = (const Onion_Node_Cmp *)object; Onion_Node *tmp = (Onion_Node *)mem_valloc(cmp->mem, size, sizeof(Onion_Node)); @@ -763,7 +763,7 @@ static void *onion_node_alloc_handler(non_null() const void *object, uint32_t si return tmp; } -static void onion_node_delete_handler(non_null() const void *object, non_null() void *arr, uint32_t size) +static void onion_node_delete_handler(const void *_Nonnull object, void *_Nonnull arr, uint32_t size) { const Onion_Node_Cmp *cmp = (const Onion_Node_Cmp *)object; mem_delete(cmp->mem, arr); @@ -778,7 +778,7 @@ static const Sort_Funcs onion_node_cmp_funcs = { onion_node_delete_handler, }; -static void sort_onion_node_list(non_null() const Memory *mem, non_null() const Mono_Time *mono_time, non_null() Onion_Node *list, unsigned int length, non_null() const uint8_t *comp_public_key) +static void sort_onion_node_list(const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, Onion_Node *_Nonnull list, unsigned int length, const uint8_t *_Nonnull comp_public_key) { // Pass comp_public_key to sort with each Onion_Node entry, so the // comparison function can use it as the base of comparison. @@ -791,8 +791,8 @@ static void sort_onion_node_list(non_null() const Memory *mem, non_null() const merge_sort(list, length, &cmp, &onion_node_cmp_funcs); } -static int client_add_to_list(non_null() Onion_Client *onion_c, uint32_t num, non_null() const uint8_t *public_key, non_null() const IP_Port *ip_port, uint8_t is_stored, - non_null() const uint8_t *pingid_or_key, uint32_t path_used) +static int client_add_to_list(Onion_Client *_Nonnull onion_c, uint32_t num, const uint8_t *_Nonnull public_key, const IP_Port *_Nonnull ip_port, uint8_t is_stored, + const uint8_t *_Nonnull pingid_or_key, uint32_t path_used) { if (num > onion_c->num_friends) { return -1; @@ -867,7 +867,7 @@ static int client_add_to_list(non_null() Onion_Client *onion_c, uint32_t num, no return 0; } -static bool good_to_ping(non_null() const Mono_Time *mono_time, non_null() Last_Pinged *last_pinged, non_null() uint8_t *last_pinged_index, non_null() const uint8_t *public_key) +static bool good_to_ping(const Mono_Time *_Nonnull mono_time, Last_Pinged *_Nonnull last_pinged, uint8_t *_Nonnull last_pinged_index, const uint8_t *_Nonnull public_key) { for (unsigned int i = 0; i < MAX_STORED_PINGED_NODES; ++i) { if (!mono_time_is_timeout(mono_time, last_pinged[i].timestamp, MIN_NODE_PING_TIME)) { @@ -883,7 +883,7 @@ static bool good_to_ping(non_null() const Mono_Time *mono_time, non_null() Last_ return true; } -static int client_ping_nodes(non_null() Onion_Client *onion_c, uint32_t num, non_null() const Node_format *nodes, uint16_t num_nodes, non_null() const IP_Port *source) +static int client_ping_nodes(Onion_Client *_Nonnull onion_c, uint32_t num, const Node_format *_Nonnull nodes, uint16_t num_nodes, const IP_Port *_Nonnull source) { if (num > onion_c->num_friends) { return -1; @@ -945,7 +945,7 @@ static int client_ping_nodes(non_null() Onion_Client *onion_c, uint32_t num, non return 0; } -static bool handle_group_announce_response(non_null() Onion_Client *onion_c, uint32_t num, non_null() const uint8_t *plain, size_t plain_size) +static bool handle_group_announce_response(Onion_Client *_Nonnull onion_c, uint32_t num, const uint8_t *_Nonnull plain, size_t plain_size) { if (onion_c->group_announce_response == nullptr) { return true; @@ -954,8 +954,8 @@ static bool handle_group_announce_response(non_null() Onion_Client *onion_c, uin return onion_c->group_announce_response(onion_c, num, plain, plain_size, onion_c->group_announce_response_user_data); } -static int handle_announce_response(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int handle_announce_response(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nullable userdata) { Onion_Client *onion_c = (Onion_Client *)object; if (length < ONION_ANNOUNCE_RESPONSE_MIN_SIZE || length > ONION_ANNOUNCE_RESPONSE_MAX_SIZE) { @@ -1054,8 +1054,8 @@ static int handle_announce_response(non_null() void *object, non_null() const IP } /* TODO(jfreegman): DEPRECATE */ -static int handle_announce_response_old(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, - nullable() void *userdata) +static int handle_announce_response_old(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nullable userdata) { Onion_Client *onion_c = (Onion_Client *)object; if (length < ONION_ANNOUNCE_RESPONSE_MIN_SIZE || length > ONION_ANNOUNCE_RESPONSE_MAX_SIZE) { @@ -1137,7 +1137,7 @@ static int handle_announce_response_old(non_null() void *object, non_null() cons #define DATA_IN_RESPONSE_MIN_SIZE ONION_DATA_IN_RESPONSE_MIN_SIZE -static int handle_data_response(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int handle_data_response(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { Onion_Client *onion_c = (Onion_Client *)object; @@ -1179,8 +1179,8 @@ static int handle_data_response(non_null() void *object, non_null() const IP_Por #define DHTPK_DATA_MIN_LENGTH (1 + sizeof(uint64_t) + CRYPTO_PUBLIC_KEY_SIZE) #define DHTPK_DATA_MAX_LENGTH (DHTPK_DATA_MIN_LENGTH + sizeof(Node_format)*MAX_SENT_NODES) -static int handle_dhtpk_announce(non_null() void *object, non_null() const uint8_t *source_pubkey, non_null() const uint8_t *data, uint16_t length, - nullable() void *userdata) +static int handle_dhtpk_announce(void *_Nonnull object, const uint8_t *_Nonnull source_pubkey, const uint8_t *_Nonnull data, uint16_t length, + void *_Nullable userdata) { Onion_Client *onion_c = (Onion_Client *)object; if (length < DHTPK_DATA_MIN_LENGTH) { @@ -1242,7 +1242,7 @@ static int handle_dhtpk_announce(non_null() void *object, non_null() const uint8 return 0; } -static int handle_tcp_onion(non_null() void *object, non_null() const uint8_t *data, uint16_t length, non_null() void *userdata) +static int handle_tcp_onion(void *_Nonnull object, const uint8_t *_Nonnull data, uint16_t length, void *_Nonnull userdata) { if (length == 0) { return 1; @@ -1358,7 +1358,7 @@ int send_onion_data(Onion_Client *onion_c, int friend_num, const uint8_t *data, * return the number of packets sent on success * return -1 on failure. */ -static int send_dht_dhtpk(non_null() const Onion_Client *onion_c, int friend_num, non_null() const uint8_t *data, uint16_t length) +static int send_dht_dhtpk(const Onion_Client *_Nonnull onion_c, int friend_num, const uint8_t *_Nonnull data, uint16_t length) { if ((uint32_t)friend_num >= onion_c->num_friends) { return -1; @@ -1397,8 +1397,8 @@ static int send_dht_dhtpk(non_null() const Onion_Client *onion_c, int friend_num return route_to_friend(onion_c->dht, onion_c->friends_list[friend_num].dht_public_key, &packet); } -static int handle_dht_dhtpk(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *source_pubkey, non_null() const uint8_t *packet, uint16_t length, - non_null() void *userdata) +static int handle_dht_dhtpk(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull source_pubkey, const uint8_t *_Nonnull packet, uint16_t length, + void *_Nonnull userdata) { Onion_Client *onion_c = (Onion_Client *)object; @@ -1436,7 +1436,7 @@ static int handle_dht_dhtpk(non_null() void *object, non_null() const IP_Port *s * return the number of packets sent on success * return -1 on failure. */ -static int send_dhtpk_announce(non_null() Onion_Client *onion_c, uint16_t friend_num, uint8_t onion_dht_both) +static int send_dhtpk_announce(Onion_Client *_Nonnull onion_c, uint16_t friend_num, uint8_t onion_dht_both) { if (friend_num >= onion_c->num_friends) { return -1; @@ -1509,7 +1509,7 @@ int onion_friend_num(const Onion_Client *onion_c, const uint8_t *public_key) * @retval -1 if mem_vrealloc fails. * @retval 0 if it succeeds. */ -static int realloc_onion_friends(non_null() Onion_Client *onion_c, uint32_t num) +static int realloc_onion_friends(Onion_Client *_Nonnull onion_c, uint32_t num) { if (num == 0) { mem_delete(onion_c->mem, onion_c->friends_list); @@ -1736,7 +1736,7 @@ int onion_set_friend_online(Onion_Client *onion_c, int friend_num, bool is_onlin return 0; } -static void populate_path_nodes(non_null() Onion_Client *onion_c) +static void populate_path_nodes(Onion_Client *_Nonnull onion_c) { Node_format node_list[MAX_FRIEND_CLIENTS]; @@ -1762,7 +1762,7 @@ static void populate_path_nodes(non_null() Onion_Client *onion_c) /* Max exponent when calculating the announce request interval */ #define MAX_RUN_COUNT_EXPONENT 12 -static void do_friend(non_null() Onion_Client *onion_c, uint16_t friendnum) +static void do_friend(Onion_Client *_Nonnull onion_c, uint16_t friendnum) { if (friendnum >= onion_c->num_friends) { return; @@ -1900,7 +1900,7 @@ void onion_group_announce_register(Onion_Client *onion_c, onion_group_announce_c #define TIME_TO_STABLE (ONION_NODE_PING_INTERVAL * 6) #define ANNOUNCE_INTERVAL_STABLE (ONION_NODE_PING_INTERVAL * 8) -static bool key_list_contains(non_null() const uint8_t *const *keys, uint16_t keys_size, non_null() const uint8_t *public_key) +static bool key_list_contains(const uint8_t *const *_Nonnull keys, uint16_t keys_size, const uint8_t *_Nonnull public_key) { for (uint16_t i = 0; i < keys_size; ++i) { if (memeq(keys[i], CRYPTO_PUBLIC_KEY_SIZE, public_key, CRYPTO_PUBLIC_KEY_SIZE)) { @@ -1912,7 +1912,7 @@ static bool key_list_contains(non_null() const uint8_t *const *keys, uint16_t ke } /** Does path with path_num exist. */ -static bool path_exists(non_null() const Mono_Time *mono_time, non_null() const Onion_Client_Paths *onion_paths, uint32_t path_num) +static bool path_exists(const Mono_Time *_Nonnull mono_time, const Onion_Client_Paths *_Nonnull onion_paths, uint32_t path_num) { if (path_timed_out(mono_time, onion_paths, path_num)) { return false; @@ -1925,7 +1925,7 @@ static bool path_exists(non_null() const Mono_Time *mono_time, non_null() const * A node/path is considered "stable" if it has survived for at least TIME_TO_STABLE * and the latest packets sent to it are not timing out. */ -static bool path_is_stable(non_null() const Mono_Time *mono_time, non_null() const Onion_Client_Paths *paths, uint32_t pathnum, non_null() const Onion_Node *node) +static bool path_is_stable(const Mono_Time *_Nonnull mono_time, const Onion_Client_Paths *_Nonnull paths, uint32_t pathnum, const Onion_Node *_Nonnull node) { return mono_time_is_timeout(mono_time, node->added_time, TIME_TO_STABLE) && !(node->pings_since_last_response > 0 @@ -1935,7 +1935,7 @@ static bool path_is_stable(non_null() const Mono_Time *mono_time, non_null() con && mono_time_is_timeout(mono_time, paths->last_path_used[pathnum], ONION_PATH_TIMEOUT)); } -static void do_announce(non_null() Onion_Client *onion_c) +static void do_announce(Onion_Client *_Nonnull onion_c) { unsigned int count = 0; Onion_Node *node_list = onion_c->clients_announce_list; @@ -2045,7 +2045,7 @@ static void do_announce(non_null() Onion_Client *onion_c) * @retval false if we are not connected to the network. * @retval true if we are. */ -static bool onion_isconnected(non_null() Onion_Client *onion_c) +static bool onion_isconnected(Onion_Client *_Nonnull onion_c) { unsigned int live = 0; unsigned int announced = 0; @@ -2096,7 +2096,7 @@ static bool onion_isconnected(non_null() Onion_Client *onion_c) return false; } -static void reset_friend_run_counts(non_null() Onion_Client *onion_c) +static void reset_friend_run_counts(Onion_Client *_Nonnull onion_c) { for (uint16_t i = 0; i < onion_c->num_friends; ++i) { Onion_Friend *o_friend = &onion_c->friends_list[i]; diff --git a/toxcore/onion_client.h b/toxcore/onion_client.h index 71e5ae5e4..bdcaf3553 100644 --- a/toxcore/onion_client.h +++ b/toxcore/onion_client.h @@ -66,8 +66,8 @@ typedef struct Onion_Client Onion_Client; -DHT *onion_get_dht(non_null() const Onion_Client *onion_c); -Net_Crypto *onion_get_net_crypto(non_null() const Onion_Client *onion_c); +DHT *_Nonnull onion_get_dht(const Onion_Client *_Nonnull onion_c); +Net_Crypto *_Nonnull onion_get_net_crypto(const Onion_Client *_Nonnull onion_c); /** @brief Add a node to the path_nodes bootstrap array. * @@ -82,34 +82,34 @@ Net_Crypto *onion_get_net_crypto(non_null() const Onion_Client *onion_c); * @retval false on failure * @retval true on success */ -bool onion_add_bs_path_node(non_null() Onion_Client *onion_c, non_null() const IP_Port *ip_port, non_null() const uint8_t *public_key); +bool onion_add_bs_path_node(Onion_Client *_Nonnull onion_c, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key); /** @brief Put up to max_num nodes in nodes. * * return the number of nodes. */ -uint16_t onion_backup_nodes(non_null() const Onion_Client *onion_c, non_null() Node_format *nodes, uint16_t max_num); +uint16_t onion_backup_nodes(const Onion_Client *_Nonnull onion_c, Node_format *_Nonnull nodes, uint16_t max_num); /** @brief Get the friend_num of a friend. * * return -1 on failure. * return friend number on success. */ -int onion_friend_num(non_null() const Onion_Client *onion_c, non_null() const uint8_t *public_key); +int onion_friend_num(const Onion_Client *_Nonnull onion_c, const uint8_t *_Nonnull public_key); /** @brief Add a friend who we want to connect to. * * return -1 on failure. * return the friend number on success or if the friend was already added. */ -int onion_addfriend(non_null() Onion_Client *onion_c, non_null() const uint8_t *public_key); +int onion_addfriend(Onion_Client *_Nonnull onion_c, const uint8_t *_Nonnull public_key); /** @brief Delete a friend. * * return -1 on failure. * return the deleted friend number on success. */ -int onion_delfriend(non_null() Onion_Client *onion_c, int friend_num); +int onion_delfriend(Onion_Client *_Nonnull onion_c, int friend_num); /** @brief Set if friend is online or not. * @@ -119,7 +119,7 @@ int onion_delfriend(non_null() Onion_Client *onion_c, int friend_num); * return -1 on failure. * return 0 on success. */ -int onion_set_friend_online(non_null() Onion_Client *onion_c, int friend_num, bool is_online); +int onion_set_friend_online(Onion_Client *_Nonnull onion_c, int friend_num, bool is_online); /** @brief Get the ip of friend friendnum and put it in ip_port * @@ -127,9 +127,9 @@ int onion_set_friend_online(non_null() Onion_Client *onion_c, int friend_num, bo * @retval 0 if public_key refers to a friend and we failed to find the friend (yet) * @retval 1 if public_key refers to a friend and we found them */ -int onion_getfriendip(non_null() const Onion_Client *onion_c, int friend_num, non_null() IP_Port *ip_port); +int onion_getfriendip(const Onion_Client *_Nonnull onion_c, int friend_num, IP_Port *_Nonnull ip_port); -typedef int recv_tcp_relay_cb(void *object, uint32_t number, const IP_Port *ip_port, const uint8_t *public_key); +typedef int recv_tcp_relay_cb(void *_Nonnull object, uint32_t number, const IP_Port *_Nonnull ip_port, const uint8_t *_Nonnull public_key); /** @brief Set the function for this friend that will be callbacked with object and number * when that friend gives us one of the TCP relays they are connected to. @@ -139,9 +139,9 @@ typedef int recv_tcp_relay_cb(void *object, uint32_t number, const IP_Port *ip_p * return -1 on failure. * return 0 on success. */ -int recv_tcp_relay_handler(non_null() Onion_Client *onion_c, int friend_num, non_null() recv_tcp_relay_cb *callback, non_null() void *object, uint32_t number); +int recv_tcp_relay_handler(Onion_Client *_Nonnull onion_c, int friend_num, recv_tcp_relay_cb *_Nonnull callback, void *_Nonnull object, uint32_t number); -typedef void onion_dht_pk_cb(void *object, int32_t number, const uint8_t *dht_public_key, void *userdata); +typedef void onion_dht_pk_cb(void *_Nonnull object, int32_t number, const uint8_t *_Nonnull dht_public_key, void *_Nullable userdata); /** @brief Set the function for this friend that will be callbacked with object and number * when that friend gives us their DHT temporary public key. @@ -151,21 +151,21 @@ typedef void onion_dht_pk_cb(void *object, int32_t number, const uint8_t *dht_pu * return -1 on failure. * return 0 on success. */ -int onion_dht_pk_callback(non_null() Onion_Client *onion_c, int friend_num, non_null() onion_dht_pk_cb *function, non_null() void *object, uint32_t number); +int onion_dht_pk_callback(Onion_Client *_Nonnull onion_c, int friend_num, onion_dht_pk_cb *_Nonnull function, void *_Nonnull object, uint32_t number); /** @brief Set a friend's DHT public key. * * return -1 on failure. * return 0 on success. */ -int onion_set_friend_dht_pubkey(non_null() Onion_Client *onion_c, int friend_num, non_null() const uint8_t *dht_key); +int onion_set_friend_dht_pubkey(Onion_Client *_Nonnull onion_c, int friend_num, const uint8_t *_Nonnull dht_key); /** @brief Copy friends DHT public key into dht_key. * * return 0 on failure (no key copied). * return 1 on success (key copied). */ -unsigned int onion_getfriend_dht_pubkey(non_null() const Onion_Client *onion_c, int friend_num, non_null() uint8_t *dht_key); +unsigned int onion_getfriend_dht_pubkey(const Onion_Client *_Nonnull onion_c, int friend_num, uint8_t *_Nonnull dht_key); #define ONION_DATA_IN_RESPONSE_MIN_SIZE (CRYPTO_PUBLIC_KEY_SIZE + CRYPTO_MAC_SIZE) @@ -181,23 +181,23 @@ unsigned int onion_getfriend_dht_pubkey(non_null() const Onion_Client *onion_c, * return the number of packets sent on success * return -1 on failure. */ -int send_onion_data(non_null() Onion_Client *onion_c, int friend_num, non_null() const uint8_t *data, uint16_t length); +int send_onion_data(Onion_Client *_Nonnull onion_c, int friend_num, const uint8_t *_Nonnull data, uint16_t length); -typedef int oniondata_handler_cb(void *object, const uint8_t *source_pubkey, const uint8_t *data, - uint16_t length, void *userdata); +typedef int oniondata_handler_cb(void *_Nullable object, const uint8_t *_Nonnull source_pubkey, const uint8_t *_Nonnull data, + uint16_t length, void *_Nullable userdata); /** Function to call when onion data packet with contents beginning with byte is received. */ -void oniondata_registerhandler(non_null() Onion_Client *onion_c, uint8_t byte, nullable() oniondata_handler_cb *cb, nullable() void *object); -typedef bool onion_group_announce_cb(Onion_Client *onion_c, uint32_t sendback_num, const uint8_t *data, - size_t data_length, void *user_data); +void oniondata_registerhandler(Onion_Client *_Nonnull onion_c, uint8_t byte, oniondata_handler_cb *_Nullable cb, void *_Nullable object); +typedef bool onion_group_announce_cb(Onion_Client *_Nonnull onion_c, uint32_t sendback_num, const uint8_t *_Nonnull data, + size_t data_length, void *_Nullable user_data); /** Function to call when the onion gets a group announce response. */ -void onion_group_announce_register(non_null() Onion_Client *onion_c, nullable() onion_group_announce_cb *func, nullable() void *user_data); -void do_onion_client(non_null() Onion_Client *onion_c); +void onion_group_announce_register(Onion_Client *_Nonnull onion_c, onion_group_announce_cb *_Nullable func, void *_Nullable user_data); +void do_onion_client(Onion_Client *_Nonnull onion_c); -Onion_Client *new_onion_client(non_null() const Logger *logger, non_null() const Memory *mem, non_null() const Random *rng, non_null() const Mono_Time *mono_time, non_null() Net_Crypto *c); +Onion_Client *_Nullable new_onion_client(const Logger *_Nonnull logger, const Memory *_Nonnull mem, const Random *_Nonnull rng, const Mono_Time *_Nonnull mono_time, Net_Crypto *_Nonnull c); -void kill_onion_client(nullable() Onion_Client *onion_c); +void kill_onion_client(Onion_Client *_Nullable onion_c); typedef enum Onion_Connection_Status { /** We are not connected to the network. */ ONION_CONNECTION_STATUS_NONE = 0, @@ -207,16 +207,16 @@ typedef enum Onion_Connection_Status { ONION_CONNECTION_STATUS_UDP = 2, } Onion_Connection_Status; -Onion_Connection_Status onion_connection_status(non_null() const Onion_Client *onion_c); +Onion_Connection_Status onion_connection_status(const Onion_Client *_Nonnull onion_c); typedef struct Onion_Friend Onion_Friend; -uint16_t onion_get_friend_count(non_null() const Onion_Client *onion_c); -Onion_Friend *onion_get_friend(non_null() const Onion_Client *onion_c, uint16_t friend_num); -const uint8_t *onion_friend_get_gc_public_key(non_null() const Onion_Friend *onion_friend); -const uint8_t *onion_friend_get_gc_public_key_num(non_null() const Onion_Client *onion_c, uint32_t num); -void onion_friend_set_gc_public_key(non_null() Onion_Friend *onion_friend, non_null() const uint8_t *public_key); -void onion_friend_set_gc_data(non_null() Onion_Friend *onion_friend, nullable() const uint8_t *gc_data, uint16_t gc_data_length); -bool onion_friend_is_groupchat(non_null() const Onion_Friend *onion_friend); +uint16_t onion_get_friend_count(const Onion_Client *_Nonnull onion_c); +Onion_Friend *_Nullable onion_get_friend(const Onion_Client *_Nonnull onion_c, uint16_t friend_num); +const uint8_t *_Nullable onion_friend_get_gc_public_key(const Onion_Friend *_Nonnull onion_friend); +const uint8_t *_Nullable onion_friend_get_gc_public_key_num(const Onion_Client *_Nonnull onion_c, uint32_t num); +void onion_friend_set_gc_public_key(Onion_Friend *_Nonnull onion_friend, const uint8_t *_Nonnull public_key); +void onion_friend_set_gc_data(Onion_Friend *_Nonnull onion_friend, const uint8_t *_Nullable gc_data, uint16_t gc_data_length); +bool onion_friend_is_groupchat(const Onion_Friend *_Nonnull onion_friend); #endif /* C_TOXCORE_TOXCORE_ONION_CLIENT_H */ diff --git a/toxcore/ping.c b/toxcore/ping.c index 13c7939b9..13e443353 100644 --- a/toxcore/ping.c +++ b/toxcore/ping.c @@ -86,7 +86,7 @@ void ping_send_request(Ping *ping, const IP_Port *ipp, const uint8_t *public_key sendpacket(dht_get_net(ping->dht), ipp, pk, sizeof(pk)); } -static int ping_send_response(non_null() const Ping *ping, non_null() const IP_Port *ipp, non_null() const uint8_t *public_key, uint64_t ping_id, non_null() const uint8_t *shared_encryption_key) +static int ping_send_response(const Ping *_Nonnull ping, const IP_Port *_Nonnull ipp, const uint8_t *_Nonnull public_key, uint64_t ping_id, const uint8_t *_Nonnull shared_encryption_key) { uint8_t pk[DHT_PING_SIZE]; @@ -115,7 +115,7 @@ static int ping_send_response(non_null() const Ping *ping, non_null() const IP_P return sendpacket(dht_get_net(ping->dht), ipp, pk, sizeof(pk)); } -static int handle_ping_request(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int handle_ping_request(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { DHT *dht = (DHT *)object; @@ -157,7 +157,7 @@ static int handle_ping_request(non_null() void *object, non_null() const IP_Port return 0; } -static int handle_ping_response(non_null() void *object, non_null() const IP_Port *source, non_null() const uint8_t *packet, uint16_t length, non_null() void *userdata) +static int handle_ping_response(void *_Nonnull object, const IP_Port *_Nonnull source, const uint8_t *_Nonnull packet, uint16_t length, void *_Nonnull userdata) { DHT *dht = (DHT *)object; int rc; @@ -219,7 +219,7 @@ static int handle_ping_response(non_null() void *object, non_null() const IP_Por * return true if it is. * return false if it isn't. */ -static bool in_list(non_null() const Client_data *list, uint16_t length, non_null() const Mono_Time *mono_time, non_null() const uint8_t *public_key, non_null() const IP_Port *ip_port) +static bool in_list(const Client_data *_Nonnull list, uint16_t length, const Mono_Time *_Nonnull mono_time, const uint8_t *_Nonnull public_key, const IP_Port *_Nonnull ip_port) { for (unsigned int i = 0; i < length; ++i) { if (pk_equal(list[i].public_key, public_key)) { diff --git a/toxcore/ping.h b/toxcore/ping.h index 69afbe9eb..90e9cfa8e 100644 --- a/toxcore/ping.h +++ b/toxcore/ping.h @@ -21,9 +21,9 @@ typedef struct Ping Ping; -Ping *ping_new(non_null() const Memory *mem, non_null() const Mono_Time *mono_time, non_null() const Random *rng, non_null() DHT *dht); +Ping *_Nullable ping_new(const Memory *_Nonnull mem, const Mono_Time *_Nonnull mono_time, const Random *_Nonnull rng, DHT *_Nonnull dht); -void ping_kill(non_null() const Memory *mem, nullable() Ping *ping); +void ping_kill(const Memory *_Nonnull mem, Ping *_Nullable ping); /** @brief Add nodes to the to_ping list. * All nodes in this list are pinged every TIME_TO_PING seconds * and are then removed from the list. @@ -34,13 +34,13 @@ void ping_kill(non_null() const Memory *mem, nullable() Ping *ping); * @retval 0 if node was added. * @retval -1 if node was not added. */ -int32_t ping_add(non_null() Ping *ping, non_null() const uint8_t *public_key, non_null() const IP_Port *ip_port); +int32_t ping_add(Ping *_Nonnull ping, const uint8_t *_Nonnull public_key, const IP_Port *_Nonnull ip_port); /** @brief Ping all the valid nodes in the to_ping list every TIME_TO_PING seconds. * This function must be run at least once every TIME_TO_PING seconds. */ -void ping_iterate(non_null() Ping *ping); +void ping_iterate(Ping *_Nonnull ping); -void ping_send_request(non_null() Ping *ping, non_null() const IP_Port *ipp, non_null() const uint8_t *public_key); +void ping_send_request(Ping *_Nonnull ping, const IP_Port *_Nonnull ipp, const uint8_t *_Nonnull public_key); #endif /* C_TOXCORE_TOXCORE_PING_H */ diff --git a/toxcore/ping_array.c b/toxcore/ping_array.c index 1167064be..61e607ccd 100644 --- a/toxcore/ping_array.c +++ b/toxcore/ping_array.c @@ -66,7 +66,7 @@ Ping_Array *ping_array_new(const Memory *mem, uint32_t size, uint32_t timeout) return empty_array; } -static void clear_entry(non_null() Ping_Array *array, uint32_t index) +static void clear_entry(Ping_Array *_Nonnull array, uint32_t index) { const Ping_Array_Entry empty = {nullptr}; mem_delete(array->mem, array->entries[index].data); @@ -90,7 +90,7 @@ void ping_array_kill(Ping_Array *array) } /** Clear timed out entries. */ -static void ping_array_clear_timedout(non_null() Ping_Array *array, non_null() const Mono_Time *mono_time) +static void ping_array_clear_timedout(Ping_Array *_Nonnull array, const Mono_Time *_Nonnull mono_time) { while (array->last_deleted != array->last_added) { const uint32_t index = array->last_deleted % array->total_size; diff --git a/toxcore/ping_array.h b/toxcore/ping_array.h index 0ba450906..9c025e028 100644 --- a/toxcore/ping_array.h +++ b/toxcore/ping_array.h @@ -31,18 +31,18 @@ typedef struct Ping_Array Ping_Array; * * @return pointer to allocated Ping_Array on success, nullptr on failure. */ -struct Ping_Array *ping_array_new(non_null() const Memory *mem, uint32_t size, uint32_t timeout); +struct Ping_Array *_Nullable ping_array_new(const Memory *_Nonnull mem, uint32_t size, uint32_t timeout); /** * @brief Free all the allocated memory in a @ref Ping_Array. */ -void ping_array_kill(nullable() Ping_Array *array); +void ping_array_kill(Ping_Array *_Nullable array); /** * @brief Add a data with length to the @ref Ping_Array list and return a ping_id. * * @return ping_id on success, 0 on failure. */ -uint64_t ping_array_add(non_null() Ping_Array *array, non_null() const Mono_Time *mono_time, non_null() const Random *rng, non_null() const uint8_t *data, uint32_t length); +uint64_t ping_array_add(Ping_Array *_Nonnull array, const Mono_Time *_Nonnull mono_time, const Random *_Nonnull rng, const uint8_t *_Nonnull data, uint32_t length); /** * @brief Check if @p ping_id is valid and not timed out. @@ -51,7 +51,7 @@ uint64_t ping_array_add(non_null() Ping_Array *array, non_null() const Mono_Time * * @return length of data copied on success, -1 on failure. */ -int32_t ping_array_check(non_null() Ping_Array *array, non_null() const Mono_Time *mono_time, non_null() uint8_t *data, size_t length, uint64_t ping_id); +int32_t ping_array_check(Ping_Array *_Nonnull array, const Mono_Time *_Nonnull mono_time, uint8_t *_Nonnull data, size_t length, uint64_t ping_id); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/shared_key_cache.c b/toxcore/shared_key_cache.c index 3192b4575..1e0a82b19 100644 --- a/toxcore/shared_key_cache.c +++ b/toxcore/shared_key_cache.c @@ -30,7 +30,7 @@ struct Shared_Key_Cache { uint8_t keys_per_slot; }; -static bool shared_key_is_empty(non_null() const Logger *log, non_null() const Shared_Key *k) +static bool shared_key_is_empty(const Logger *_Nonnull log, const Shared_Key *_Nonnull k) { LOGGER_ASSERT(log, k != nullptr, "shared key must not be NULL"); /* @@ -40,7 +40,7 @@ static bool shared_key_is_empty(non_null() const Logger *log, non_null() const S return k->time_last_requested == 0; } -static void shared_key_set_empty(non_null() const Logger *log, non_null() Shared_Key *k) +static void shared_key_set_empty(const Logger *_Nonnull log, Shared_Key *_Nonnull k) { crypto_memzero(k, sizeof(Shared_Key)); LOGGER_ASSERT(log, shared_key_is_empty(log, k), "shared key must be empty after clearing it"); diff --git a/toxcore/shared_key_cache.h b/toxcore/shared_key_cache.h index 6f0204a4b..c9892d062 100644 --- a/toxcore/shared_key_cache.h +++ b/toxcore/shared_key_cache.h @@ -28,14 +28,14 @@ typedef struct Shared_Key_Cache Shared_Key_Cache; * @param keys_per_slot There are 256 slots, this controls how many keys are stored per slot and the size of the cache. * @return nullptr on error. */ -Shared_Key_Cache *shared_key_cache_new(non_null() const Logger *log, non_null() const Mono_Time *mono_time, non_null() const Memory *mem, non_null() const uint8_t *self_secret_key, uint64_t timeout, - uint8_t keys_per_slot); +Shared_Key_Cache *_Nullable shared_key_cache_new(const Logger *_Nonnull log, const Mono_Time *_Nonnull mono_time, const Memory *_Nonnull mem, const uint8_t *_Nonnull self_secret_key, uint64_t timeout, + uint8_t keys_per_slot); /** * @brief Deletes the cache and frees all resources. * @param cache Cache to delete or nullptr. */ -void shared_key_cache_free(nullable() Shared_Key_Cache *cache); +void shared_key_cache_free(Shared_Key_Cache *_Nullable cache); /** * @brief Looks up a key from the cache or computes it if it didn't exist yet. * @param cache Cache to perform the lookup on. @@ -44,6 +44,6 @@ void shared_key_cache_free(nullable() Shared_Key_Cache *cache); * @return The shared key of length CRYPTO_SHARED_KEY_SIZE, matching the public key and our secret key. * @return nullptr on error. */ -const uint8_t *shared_key_cache_lookup(non_null() Shared_Key_Cache *cache, non_null() const uint8_t public_key[CRYPTO_PUBLIC_KEY_SIZE]); +const uint8_t *_Nullable shared_key_cache_lookup(Shared_Key_Cache *_Nonnull cache, const uint8_t public_key[_Nonnull CRYPTO_PUBLIC_KEY_SIZE]); #endif /* C_TOXCORE_TOXCORE_SHARED_KEY_CACHE_H */ diff --git a/toxcore/sort.c b/toxcore/sort.c index 894e634d1..b3bc4a4c7 100644 --- a/toxcore/sort.c +++ b/toxcore/sort.c @@ -25,8 +25,8 @@ */ #define SMALL_ARRAY_THRESHOLD 16 -static void merge_sort_merge_back(non_null() void *arr, non_null() const void *l_arr, uint32_t l_arr_size, non_null() const void *r_arr, uint32_t r_arr_size, uint32_t left_start, - non_null() const void *object, non_null() const Sort_Funcs *funcs) +static void merge_sort_merge_back(void *_Nonnull arr, const void *_Nonnull l_arr, uint32_t l_arr_size, const void *_Nonnull r_arr, uint32_t r_arr_size, uint32_t left_start, + const void *_Nonnull object, const Sort_Funcs *_Nonnull funcs) { uint32_t li = 0; uint32_t ri = 0; @@ -62,7 +62,7 @@ static void merge_sort_merge_back(non_null() void *arr, non_null() const void *l } /** Function to merge the two haves `arr[left_start..mid]` and `arr[mid+1..right_end]` of array `arr[]`. */ -static void merge_sort_merge(non_null() void *arr, uint32_t left_start, uint32_t mid, uint32_t right_end, non_null() void *tmp, non_null() const void *object, non_null() const Sort_Funcs *funcs) +static void merge_sort_merge(void *_Nonnull arr, uint32_t left_start, uint32_t mid, uint32_t right_end, void *_Nonnull tmp, const void *_Nonnull object, const Sort_Funcs *_Nonnull funcs) { const uint32_t l_arr_size = mid - left_start + 1; const uint32_t r_arr_size = right_end - mid; @@ -88,7 +88,7 @@ static void merge_sort_merge(non_null() void *arr, uint32_t left_start, uint32_t merge_sort_merge_back(arr, l_arr, l_arr_size, r_arr, r_arr_size, left_start, object, funcs); } -static void insertion_sort_step(non_null() void *arr, non_null() void *tmp, uint32_t i, non_null() const void *object, non_null() const Sort_Funcs *funcs) +static void insertion_sort_step(void *_Nonnull arr, void *_Nonnull tmp, uint32_t i, const void *_Nonnull object, const Sort_Funcs *_Nonnull funcs) { funcs->set_callback(tmp, 0, funcs->get_callback(arr, i)); uint32_t j = i; @@ -104,14 +104,14 @@ static void insertion_sort_step(non_null() void *arr, non_null() void *tmp, uint funcs->set_callback(arr, j, tmp); } -static void insertion_sort_with_buf(non_null() void *arr, uint32_t arr_size, non_null() void *tmp, uint32_t tmp_size, non_null() const void *object, non_null() const Sort_Funcs *funcs) +static void insertion_sort_with_buf(void *_Nonnull arr, uint32_t arr_size, void *_Nonnull tmp, uint32_t tmp_size, const void *_Nonnull object, const Sort_Funcs *_Nonnull funcs) { for (uint32_t i = 1; i < arr_size; ++i) { insertion_sort_step(arr, tmp, i, object, funcs); } } -static bool insertion_sort(non_null() void *arr, uint32_t arr_size, non_null() const void *object, non_null() const Sort_Funcs *funcs) +static bool insertion_sort(void *_Nonnull arr, uint32_t arr_size, const void *_Nonnull object, const Sort_Funcs *_Nonnull funcs) { void *tmp = funcs->alloc_callback(object, 1); diff --git a/toxcore/sort.h b/toxcore/sort.h index e9a6e9092..b5b244bbb 100644 --- a/toxcore/sort.h +++ b/toxcore/sort.h @@ -15,25 +15,25 @@ extern "C" { #endif /** @brief Compare elements with a less-than ordering: `a < b`. */ -typedef bool sort_less_cb(const void *object, const void *a, const void *b); +typedef bool sort_less_cb(const void *_Nonnull object, const void *_Nonnull a, const void *_Nonnull b); /** @brief Get element from array at index. */ -typedef const void *sort_get_cb(const void *arr, uint32_t index); +typedef const void *sort_get_cb(const void *_Nonnull arr, uint32_t index); /** @brief Set element in array at index to new value (perform copy). */ -typedef void sort_set_cb(void *arr, uint32_t index, const void *val); +typedef void sort_set_cb(void *_Nonnull arr, uint32_t index, const void *_Nonnull val); /** @brief Get a sub-array at an index of a given size (mutable pointer). * * Used to index in the temporary array allocated by `sort_alloc_cb` and get * a sub-array for working memory. */ -typedef void *sort_subarr_cb(void *arr, uint32_t index, uint32_t size); +typedef void *sort_subarr_cb(void *_Nonnull arr, uint32_t index, uint32_t size); /** @brief Allocate a new array of the element type. * * @param size The array size in elements of type T (not byte size). This value * is always exactly the input array size as passed to `merge_sort`. */ -typedef void *sort_alloc_cb(const void *object, uint32_t size); +typedef void *sort_alloc_cb(const void *_Nonnull object, uint32_t size); /** @brief Free the element type array. */ -typedef void sort_delete_cb(const void *object, void *arr, uint32_t size); +typedef void sort_delete_cb(const void *_Nonnull object, void *_Nonnull arr, uint32_t size); /** @brief Virtual function table for getting/setting elements in an array and * comparing them. @@ -46,12 +46,12 @@ typedef void sort_delete_cb(const void *object, void *arr, uint32_t size); * to mutate any state, but if necessary that can be changed in the future. */ typedef struct Sort_Funcs { - sort_less_cb *less_callback; - sort_get_cb *get_callback; - sort_set_cb *set_callback; - sort_subarr_cb *subarr_callback; - sort_alloc_cb *alloc_callback; - sort_delete_cb *delete_callback; + sort_less_cb *_Nonnull less_callback; + sort_get_cb *_Nonnull get_callback; + sort_set_cb *_Nonnull set_callback; + sort_subarr_cb *_Nonnull subarr_callback; + sort_alloc_cb *_Nonnull alloc_callback; + sort_delete_cb *_Nonnull delete_callback; } Sort_Funcs; /** @brief Non-recursive merge sort function to sort `arr[0...arr_size-1]`. @@ -82,7 +82,7 @@ typedef struct Sort_Funcs { * @param[in] object Comparator object. * @param[in] funcs Callback struct for elements of type T. */ -bool merge_sort(non_null() void *arr, uint32_t arr_size, non_null() const void *object, non_null() const Sort_Funcs *funcs); +bool merge_sort(void *_Nonnull arr, uint32_t arr_size, const void *_Nonnull object, const Sort_Funcs *_Nonnull funcs); /** * @brief Merge sort like above but with a pre-allocated buffer. @@ -105,7 +105,7 @@ bool merge_sort(non_null() void *arr, uint32_t arr_size, non_null() const void * * @param[in] object Comparator object. * @param[in] funcs Callback struct for elements of type T. */ -void merge_sort_with_buf(non_null() void *arr, uint32_t arr_size, non_null() void *tmp, uint32_t tmp_size, non_null() const void *object, non_null() const Sort_Funcs *funcs); +void merge_sort_with_buf(void *_Nonnull arr, uint32_t arr_size, void *_Nonnull tmp, uint32_t tmp_size, const void *_Nonnull object, const Sort_Funcs *_Nonnull funcs); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/state.c b/toxcore/state.c index 6835ca000..6afdde4e0 100644 --- a/toxcore/state.c +++ b/toxcore/state.c @@ -10,8 +10,8 @@ #include "logger.h" /** state load/save */ -int state_load(const Logger *log, state_load_cb *state_load_callback, void *outer, - const uint8_t *data, uint32_t length, uint16_t cookie_inner) +int state_load(const Logger *_Nonnull log, state_load_cb *_Nonnull state_load_callback, void *_Nonnull outer, + const uint8_t *_Nonnull data, uint32_t length, uint16_t cookie_inner) { if (state_load_callback == nullptr || data == nullptr) { LOGGER_ERROR(log, "state_load() called with invalid args."); @@ -70,7 +70,7 @@ int state_load(const Logger *log, state_load_cb *state_load_callback, void *oute return 0; } -uint8_t *state_write_section_header(uint8_t *data, uint16_t cookie_type, uint32_t len, uint32_t section_type) +uint8_t *_Nonnull state_write_section_header(uint8_t *_Nonnull data, uint16_t cookie_type, uint32_t len, uint32_t section_type) { host_to_lendian_bytes32(data, len); data += sizeof(uint32_t); @@ -93,7 +93,7 @@ uint16_t host_to_lendian16(uint16_t host) return lendian_to_host16(host); } -void host_to_lendian_bytes64(uint8_t *dest, uint64_t num) +void host_to_lendian_bytes64(uint8_t *_Nonnull dest, uint64_t num) { #ifdef WORDS_BIGENDIAN num = ((num << 8) & 0xFF00FF00FF00FF00) | ((num >> 8) & 0xFF00FF00FF00FF); @@ -103,7 +103,7 @@ void host_to_lendian_bytes64(uint8_t *dest, uint64_t num) memcpy(dest, &num, sizeof(uint64_t)); } -void lendian_bytes_to_host64(uint64_t *dest, const uint8_t *lendian) +void lendian_bytes_to_host64(uint64_t *_Nonnull dest, const uint8_t *_Nonnull lendian) { uint64_t d; memcpy(&d, lendian, sizeof(uint64_t)); @@ -115,7 +115,7 @@ void lendian_bytes_to_host64(uint64_t *dest, const uint8_t *lendian) *dest = d; } -void host_to_lendian_bytes32(uint8_t *dest, uint32_t num) +void host_to_lendian_bytes32(uint8_t *_Nonnull dest, uint32_t num) { #ifdef WORDS_BIGENDIAN num = ((num << 8) & 0xFF00FF00) | ((num >> 8) & 0xFF00FF); @@ -124,7 +124,7 @@ void host_to_lendian_bytes32(uint8_t *dest, uint32_t num) memcpy(dest, &num, sizeof(uint32_t)); } -void lendian_bytes_to_host32(uint32_t *dest, const uint8_t *lendian) +void lendian_bytes_to_host32(uint32_t *_Nonnull dest, const uint8_t *_Nonnull lendian) { uint32_t d; memcpy(&d, lendian, sizeof(uint32_t)); @@ -135,7 +135,7 @@ void lendian_bytes_to_host32(uint32_t *dest, const uint8_t *lendian) *dest = d; } -void host_to_lendian_bytes16(uint8_t *dest, uint16_t num) +void host_to_lendian_bytes16(uint8_t *_Nonnull dest, uint16_t num) { #ifdef WORDS_BIGENDIAN num = (num << 8) | (num >> 8); @@ -143,7 +143,7 @@ void host_to_lendian_bytes16(uint8_t *dest, uint16_t num) memcpy(dest, &num, sizeof(uint16_t)); } -void lendian_bytes_to_host16(uint16_t *dest, const uint8_t *lendian) +void lendian_bytes_to_host16(uint16_t *_Nonnull dest, const uint8_t *_Nonnull lendian) { uint16_t d; memcpy(&d, lendian, sizeof(uint16_t)); diff --git a/toxcore/state.h b/toxcore/state.h index bb5cfae36..8ae9ab660 100644 --- a/toxcore/state.h +++ b/toxcore/state.h @@ -52,26 +52,26 @@ typedef enum State_Load_Status { STATE_LOAD_STATUS_END, } State_Load_Status; -typedef State_Load_Status state_load_cb(void *outer, const uint8_t *data, uint32_t length, uint16_t type); +typedef State_Load_Status state_load_cb(void *_Nonnull outer, const uint8_t *_Nonnull data, uint32_t length, uint16_t type); /** state load/save */ -int state_load(non_null() const Logger *log, non_null() state_load_cb *state_load_callback, non_null() void *outer, non_null() const uint8_t *data, uint32_t length, uint16_t cookie_inner); +int state_load(const Logger *_Nonnull log, state_load_cb *_Nonnull state_load_callback, void *_Nonnull outer, const uint8_t *_Nonnull data, uint32_t length, uint16_t cookie_inner); -uint8_t *state_write_section_header(non_null() uint8_t *data, uint16_t cookie_type, uint32_t len, uint32_t section_type); +uint8_t *_Nonnull state_write_section_header(uint8_t *_Nonnull data, uint16_t cookie_type, uint32_t len, uint32_t section_type); // Utilities for state data serialisation. uint16_t lendian_to_host16(uint16_t lendian); uint16_t host_to_lendian16(uint16_t host); -void host_to_lendian_bytes64(non_null() uint8_t *dest, uint64_t num); -void lendian_bytes_to_host64(non_null() uint64_t *dest, non_null() const uint8_t *lendian); +void host_to_lendian_bytes64(uint8_t *_Nonnull dest, uint64_t num); +void lendian_bytes_to_host64(uint64_t *_Nonnull dest, const uint8_t *_Nonnull lendian); -void host_to_lendian_bytes32(non_null() uint8_t *dest, uint32_t num); -void lendian_bytes_to_host32(non_null() uint32_t *dest, non_null() const uint8_t *lendian); +void host_to_lendian_bytes32(uint8_t *_Nonnull dest, uint32_t num); +void lendian_bytes_to_host32(uint32_t *_Nonnull dest, const uint8_t *_Nonnull lendian); -void host_to_lendian_bytes16(non_null() uint8_t *dest, uint16_t num); -void lendian_bytes_to_host16(non_null() uint16_t *dest, non_null() const uint8_t *lendian); +void host_to_lendian_bytes16(uint8_t *_Nonnull dest, uint16_t num); +void lendian_bytes_to_host16(uint16_t *_Nonnull dest, const uint8_t *_Nonnull lendian); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/timed_auth.c b/toxcore/timed_auth.c index b3b2e126c..cfa05bdd1 100644 --- a/toxcore/timed_auth.c +++ b/toxcore/timed_auth.c @@ -10,8 +10,8 @@ #include "crypto_core.h" #include "mono_time.h" -static void create_timed_auth_to_hash(non_null() const Mono_Time *mono_time, uint16_t timeout, bool previous, nullable() const uint8_t *data, - uint16_t length, non_null() uint8_t *to_hash) +static void create_timed_auth_to_hash(const Mono_Time *_Nonnull mono_time, uint16_t timeout, bool previous, const uint8_t *_Nullable data, + uint16_t length, uint8_t *_Nonnull to_hash) { const uint64_t t = (mono_time_get(mono_time) / timeout) - (previous ? 1 : 0); memcpy(to_hash, &t, sizeof(t)); diff --git a/toxcore/timed_auth.h b/toxcore/timed_auth.h index 7ac1a06b9..bd26a9e04 100644 --- a/toxcore/timed_auth.h +++ b/toxcore/timed_auth.h @@ -16,8 +16,8 @@ * @param timed_auth Must be of size TIMED_AUTH_SIZE. */ -void generate_timed_auth(non_null() const Mono_Time *mono_time, uint16_t timeout, non_null() const uint8_t *key, - nullable() const uint8_t *data, uint16_t length, non_null() uint8_t *timed_auth); +void generate_timed_auth(const Mono_Time *_Nonnull mono_time, uint16_t timeout, const uint8_t *_Nonnull key, + const uint8_t *_Nullable data, uint16_t length, uint8_t *_Nonnull timed_auth); /** * @brief Check timed_auth. This succeeds if `timed_auth` was generated by * `generate_timed_auth` at most `timeout` seconds ago, and fails if at least @@ -28,6 +28,6 @@ void generate_timed_auth(non_null() const Mono_Time *mono_time, uint16_t timeout * @param timed_auth Must be of size TIMED_AUTH_SIZE. * @return true on success, false otherwise. */ -bool check_timed_auth(non_null() const Mono_Time *mono_time, uint16_t timeout, non_null() const uint8_t *key, - nullable() const uint8_t *data, uint16_t length, non_null() const uint8_t *timed_auth); +bool check_timed_auth(const Mono_Time *_Nonnull mono_time, uint16_t timeout, const uint8_t *_Nonnull key, + const uint8_t *_Nullable data, uint16_t length, const uint8_t *_Nonnull timed_auth); #endif /* C_TOXCORE_TOXCORE_TIMED_AUTH_H */ diff --git a/toxcore/tox.c b/toxcore/tox.c index f6bb925b8..1ef4cc0e4 100644 --- a/toxcore/tox.c +++ b/toxcore/tox.c @@ -80,8 +80,8 @@ struct Tox_Userdata { }; static logger_cb tox_log_handler; -static void tox_log_handler(non_null() void *context, Logger_Level level, non_null() const char *file, uint32_t line, non_null() const char *func, - non_null() const char *message, nullable() void *userdata) +static void tox_log_handler(void *_Nullable context, Logger_Level level, const char *_Nonnull file, uint32_t line, const char *_Nonnull func, + const char *_Nonnull message, void *_Nullable userdata) { Tox *tox = (Tox *)context; assert(tox != nullptr); @@ -92,7 +92,7 @@ static void tox_log_handler(non_null() void *context, Logger_Level level, non_nu } static m_self_connection_status_cb tox_self_connection_status_handler; -static void tox_self_connection_status_handler(non_null() Messenger *m, Onion_Connection_Status connection_status, nullable() void *user_data) +static void tox_self_connection_status_handler(Messenger *_Nonnull m, Onion_Connection_Status connection_status, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->self_connection_status_callback != nullptr) { @@ -103,8 +103,8 @@ static void tox_self_connection_status_handler(non_null() Messenger *m, Onion_Co } static m_friend_name_cb tox_friend_name_handler; -static void tox_friend_name_handler(non_null() Messenger *m, uint32_t friend_number, non_null() const uint8_t *name, size_t length, - nullable() void *user_data) +static void tox_friend_name_handler(Messenger *_Nonnull m, uint32_t friend_number, const uint8_t *_Nonnull name, size_t length, + void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->friend_name_callback != nullptr) { @@ -115,8 +115,8 @@ static void tox_friend_name_handler(non_null() Messenger *m, uint32_t friend_num } static m_friend_status_message_cb tox_friend_status_message_handler; -static void tox_friend_status_message_handler(non_null() Messenger *m, uint32_t friend_number, non_null() const uint8_t *message, - size_t length, nullable() void *user_data) +static void tox_friend_status_message_handler(Messenger *_Nonnull m, uint32_t friend_number, const uint8_t *_Nonnull message, + size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->friend_status_message_callback != nullptr) { @@ -127,7 +127,7 @@ static void tox_friend_status_message_handler(non_null() Messenger *m, uint32_t } static m_friend_status_cb tox_friend_status_handler; -static void tox_friend_status_handler(non_null() Messenger *m, uint32_t friend_number, unsigned int status, nullable() void *user_data) +static void tox_friend_status_handler(Messenger *_Nonnull m, uint32_t friend_number, unsigned int status, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->friend_status_callback != nullptr) { @@ -138,8 +138,8 @@ static void tox_friend_status_handler(non_null() Messenger *m, uint32_t friend_n } static m_friend_connection_status_cb tox_friend_connection_status_handler; -static void tox_friend_connection_status_handler(non_null() Messenger *m, uint32_t friend_number, unsigned int connection_status, - nullable() void *user_data) +static void tox_friend_connection_status_handler(Messenger *_Nonnull m, uint32_t friend_number, unsigned int connection_status, + void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->friend_connection_status_callback != nullptr) { @@ -151,7 +151,7 @@ static void tox_friend_connection_status_handler(non_null() Messenger *m, uint32 } static m_friend_typing_cb tox_friend_typing_handler; -static void tox_friend_typing_handler(non_null() Messenger *m, uint32_t friend_number, bool is_typing, nullable() void *user_data) +static void tox_friend_typing_handler(Messenger *_Nonnull m, uint32_t friend_number, bool is_typing, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->friend_typing_callback != nullptr) { @@ -162,7 +162,7 @@ static void tox_friend_typing_handler(non_null() Messenger *m, uint32_t friend_n } static m_friend_read_receipt_cb tox_friend_read_receipt_handler; -static void tox_friend_read_receipt_handler(non_null() Messenger *m, uint32_t friend_number, uint32_t message_id, nullable() void *user_data) +static void tox_friend_read_receipt_handler(Messenger *_Nonnull m, uint32_t friend_number, uint32_t message_id, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->friend_read_receipt_callback != nullptr) { @@ -173,8 +173,8 @@ static void tox_friend_read_receipt_handler(non_null() Messenger *m, uint32_t fr } static m_friend_request_cb tox_friend_request_handler; -static void tox_friend_request_handler(non_null() Messenger *m, const uint8_t public_key[TOX_PUBLIC_KEY_SIZE], non_null() const uint8_t *message, size_t length, - nullable() void *user_data) +static void tox_friend_request_handler(Messenger *_Nonnull m, const uint8_t public_key[TOX_PUBLIC_KEY_SIZE], const uint8_t *_Nonnull message, size_t length, + void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->friend_request_callback != nullptr) { @@ -185,8 +185,8 @@ static void tox_friend_request_handler(non_null() Messenger *m, const uint8_t pu } static m_friend_message_cb tox_friend_message_handler; -static void tox_friend_message_handler(non_null() Messenger *m, uint32_t friend_number, unsigned int message_type, - non_null() const uint8_t *message, size_t length, nullable() void *user_data) +static void tox_friend_message_handler(Messenger *_Nonnull m, uint32_t friend_number, unsigned int message_type, + const uint8_t *_Nonnull message, size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->friend_message_callback != nullptr) { @@ -198,8 +198,8 @@ static void tox_friend_message_handler(non_null() Messenger *m, uint32_t friend_ } static m_file_recv_control_cb tox_file_recv_control_handler; -static void tox_file_recv_control_handler(non_null() Messenger *m, uint32_t friend_number, uint32_t file_number, - unsigned int control, nullable() void *user_data) +static void tox_file_recv_control_handler(Messenger *_Nonnull m, uint32_t friend_number, uint32_t file_number, + unsigned int control, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->file_recv_control_callback != nullptr) { @@ -211,8 +211,8 @@ static void tox_file_recv_control_handler(non_null() Messenger *m, uint32_t frie } static m_file_chunk_request_cb tox_file_chunk_request_handler; -static void tox_file_chunk_request_handler(non_null() Messenger *m, uint32_t friend_number, uint32_t file_number, - uint64_t position, size_t length, nullable() void *user_data) +static void tox_file_chunk_request_handler(Messenger *_Nonnull m, uint32_t friend_number, uint32_t file_number, + uint64_t position, size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->file_chunk_request_callback != nullptr) { @@ -224,8 +224,8 @@ static void tox_file_chunk_request_handler(non_null() Messenger *m, uint32_t fri } static m_file_recv_cb tox_file_recv_handler; -static void tox_file_recv_handler(non_null() Messenger *m, uint32_t friend_number, uint32_t file_number, uint32_t kind, - uint64_t file_size, non_null() const uint8_t *filename, size_t filename_length, nullable() void *user_data) +static void tox_file_recv_handler(Messenger *_Nonnull m, uint32_t friend_number, uint32_t file_number, uint32_t kind, + uint64_t file_size, const uint8_t *_Nonnull filename, size_t filename_length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->file_recv_callback != nullptr) { @@ -237,8 +237,8 @@ static void tox_file_recv_handler(non_null() Messenger *m, uint32_t friend_numbe } static m_file_recv_chunk_cb tox_file_recv_chunk_handler; -static void tox_file_recv_chunk_handler(non_null() Messenger *m, uint32_t friend_number, uint32_t file_number, uint64_t position, - non_null() const uint8_t *data, size_t length, nullable() void *user_data) +static void tox_file_recv_chunk_handler(Messenger *_Nonnull m, uint32_t friend_number, uint32_t file_number, uint64_t position, + const uint8_t *_Nullable data, size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->file_recv_chunk_callback != nullptr) { @@ -250,8 +250,8 @@ static void tox_file_recv_chunk_handler(non_null() Messenger *m, uint32_t friend } static g_conference_invite_cb tox_conference_invite_handler; -static void tox_conference_invite_handler(non_null() Messenger *m, uint32_t friend_number, int type, non_null() const uint8_t *cookie, - size_t length, nullable() void *user_data) +static void tox_conference_invite_handler(Messenger *_Nonnull m, uint32_t friend_number, int type, const uint8_t *_Nonnull cookie, + size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->conference_invite_callback != nullptr) { @@ -263,7 +263,7 @@ static void tox_conference_invite_handler(non_null() Messenger *m, uint32_t frie } static g_conference_connected_cb tox_conference_connected_handler; -static void tox_conference_connected_handler(non_null() Messenger *m, uint32_t conference_number, nullable() void *user_data) +static void tox_conference_connected_handler(Messenger *_Nonnull m, uint32_t conference_number, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->conference_connected_callback != nullptr) { @@ -274,8 +274,8 @@ static void tox_conference_connected_handler(non_null() Messenger *m, uint32_t c } static g_conference_message_cb tox_conference_message_handler; -static void tox_conference_message_handler(non_null() Messenger *m, uint32_t conference_number, uint32_t peer_number, int type, - non_null() const uint8_t *message, size_t length, nullable() void *user_data) +static void tox_conference_message_handler(Messenger *_Nonnull m, uint32_t conference_number, uint32_t peer_number, int type, + const uint8_t *_Nonnull message, size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->conference_message_callback != nullptr) { @@ -287,8 +287,8 @@ static void tox_conference_message_handler(non_null() Messenger *m, uint32_t con } static title_cb tox_conference_title_handler; -static void tox_conference_title_handler(non_null() Messenger *m, uint32_t conference_number, uint32_t peer_number, - non_null() const uint8_t *title, size_t length, nullable() void *user_data) +static void tox_conference_title_handler(Messenger *_Nonnull m, uint32_t conference_number, uint32_t peer_number, + const uint8_t *_Nonnull title, size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->conference_title_callback != nullptr) { @@ -300,8 +300,8 @@ static void tox_conference_title_handler(non_null() Messenger *m, uint32_t confe } static peer_name_cb tox_conference_peer_name_handler; -static void tox_conference_peer_name_handler(non_null() Messenger *m, uint32_t conference_number, uint32_t peer_number, - non_null() const uint8_t *name, size_t length, nullable() void *user_data) +static void tox_conference_peer_name_handler(Messenger *_Nonnull m, uint32_t conference_number, uint32_t peer_number, + const uint8_t *_Nonnull name, size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->conference_peer_name_callback != nullptr) { @@ -313,7 +313,7 @@ static void tox_conference_peer_name_handler(non_null() Messenger *m, uint32_t c } static peer_list_changed_cb tox_conference_peer_list_changed_handler; -static void tox_conference_peer_list_changed_handler(non_null() Messenger *m, uint32_t conference_number, nullable() void *user_data) +static void tox_conference_peer_list_changed_handler(Messenger *_Nonnull m, uint32_t conference_number, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->conference_peer_list_changed_callback != nullptr) { @@ -324,7 +324,7 @@ static void tox_conference_peer_list_changed_handler(non_null() Messenger *m, ui } static dht_nodes_response_cb tox_dht_nodes_response_handler; -static void tox_dht_nodes_response_handler(non_null() const DHT *dht, non_null() const Node_format *node, nullable() void *user_data) +static void tox_dht_nodes_response_handler(const DHT *_Nonnull dht, const Node_format *_Nonnull node, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->dht_nodes_response_callback == nullptr) { @@ -342,8 +342,8 @@ static void tox_dht_nodes_response_handler(non_null() const DHT *dht, non_null() } static m_friend_lossy_packet_cb tox_friend_lossy_packet_handler; -static void tox_friend_lossy_packet_handler(non_null() Messenger *m, uint32_t friend_number, uint8_t packet_id, - non_null() const uint8_t *data, size_t length, nullable() void *user_data) +static void tox_friend_lossy_packet_handler(Messenger *_Nonnull m, uint32_t friend_number, uint8_t packet_id, + const uint8_t *_Nonnull data, size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; assert(data != nullptr); @@ -358,8 +358,8 @@ static void tox_friend_lossy_packet_handler(non_null() Messenger *m, uint32_t fr } static m_friend_lossless_packet_cb tox_friend_lossless_packet_handler; -static void tox_friend_lossless_packet_handler(non_null() Messenger *m, uint32_t friend_number, uint8_t packet_id, - non_null() const uint8_t *data, size_t length, nullable() void *user_data) +static void tox_friend_lossless_packet_handler(Messenger *_Nonnull m, uint32_t friend_number, uint8_t packet_id, + const uint8_t *_Nonnull data, size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; assert(data != nullptr); @@ -373,8 +373,8 @@ static void tox_friend_lossless_packet_handler(non_null() Messenger *m, uint32_t } } -static void tox_group_peer_name_handler(non_null() const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, - non_null() const uint8_t *name, size_t length, nullable() void *user_data) +static void tox_group_peer_name_handler(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, + const uint8_t *_Nonnull name, size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_peer_name_callback != nullptr) { @@ -384,8 +384,8 @@ static void tox_group_peer_name_handler(non_null() const Messenger *m, uint32_t } } -static void tox_group_peer_status_handler(non_null() const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, - unsigned int status, nullable() void *user_data) +static void tox_group_peer_status_handler(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, + unsigned int status, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_peer_status_callback != nullptr) { @@ -396,8 +396,8 @@ static void tox_group_peer_status_handler(non_null() const Messenger *m, uint32_ } } -static void tox_group_topic_handler(non_null() const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, non_null() const uint8_t *topic, - size_t length, nullable() void *user_data) +static void tox_group_topic_handler(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, const uint8_t *_Nonnull topic, + size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_topic_callback != nullptr) { @@ -407,8 +407,8 @@ static void tox_group_topic_handler(non_null() const Messenger *m, uint32_t grou } } -static void tox_group_topic_lock_handler(non_null() const Messenger *m, uint32_t group_number, unsigned int topic_lock, - nullable() void *user_data) +static void tox_group_topic_lock_handler(const Messenger *_Nonnull m, uint32_t group_number, unsigned int topic_lock, + void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_topic_lock_callback != nullptr) { @@ -419,8 +419,8 @@ static void tox_group_topic_lock_handler(non_null() const Messenger *m, uint32_t } } -static void tox_group_voice_state_handler(non_null() const Messenger *m, uint32_t group_number, unsigned int voice_state, - nullable() void *user_data) +static void tox_group_voice_state_handler(const Messenger *_Nonnull m, uint32_t group_number, unsigned int voice_state, + void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_voice_state_callback != nullptr) { @@ -431,8 +431,8 @@ static void tox_group_voice_state_handler(non_null() const Messenger *m, uint32_ } } -static void tox_group_peer_limit_handler(non_null() const Messenger *m, uint32_t group_number, uint32_t peer_limit, - nullable() void *user_data) +static void tox_group_peer_limit_handler(const Messenger *_Nonnull m, uint32_t group_number, uint32_t peer_limit, + void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_peer_limit_callback != nullptr) { @@ -442,8 +442,8 @@ static void tox_group_peer_limit_handler(non_null() const Messenger *m, uint32_t } } -static void tox_group_privacy_state_handler(non_null() const Messenger *m, uint32_t group_number, unsigned int privacy_state, - nullable() void *user_data) +static void tox_group_privacy_state_handler(const Messenger *_Nonnull m, uint32_t group_number, unsigned int privacy_state, + void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_privacy_state_callback != nullptr) { @@ -454,8 +454,8 @@ static void tox_group_privacy_state_handler(non_null() const Messenger *m, uint3 } } -static void tox_group_password_handler(non_null() const Messenger *m, uint32_t group_number, nullable() const uint8_t *password, - size_t length, nullable() void *user_data) +static void tox_group_password_handler(const Messenger *_Nonnull m, uint32_t group_number, const uint8_t *_Nullable password, + size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_password_callback != nullptr) { @@ -465,8 +465,8 @@ static void tox_group_password_handler(non_null() const Messenger *m, uint32_t g } } -static void tox_group_message_handler(non_null() const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, unsigned int type, - non_null() const uint8_t *message, size_t length, Tox_Group_Message_Id message_id, nullable() void *user_data) +static void tox_group_message_handler(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, unsigned int type, + const uint8_t *_Nonnull message, size_t length, Tox_Group_Message_Id message_id, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_message_callback != nullptr) { @@ -477,8 +477,8 @@ static void tox_group_message_handler(non_null() const Messenger *m, uint32_t gr } } -static void tox_group_private_message_handler(non_null() const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, - unsigned int type, non_null() const uint8_t *message, size_t length, Tox_Group_Message_Id message_id, nullable() void *user_data) +static void tox_group_private_message_handler(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, + unsigned int type, const uint8_t *_Nonnull message, size_t length, Tox_Group_Message_Id message_id, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_private_message_callback != nullptr) { @@ -489,8 +489,8 @@ static void tox_group_private_message_handler(non_null() const Messenger *m, uin } } -static void tox_group_custom_packet_handler(non_null() const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, - non_null() const uint8_t *data, size_t length, nullable() void *user_data) +static void tox_group_custom_packet_handler(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, + const uint8_t *_Nonnull data, size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_custom_packet_callback != nullptr) { @@ -500,8 +500,8 @@ static void tox_group_custom_packet_handler(non_null() const Messenger *m, uint3 } } -static void tox_group_custom_private_packet_handler(non_null() const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, - non_null() const uint8_t *data, size_t length, nullable() void *user_data) +static void tox_group_custom_private_packet_handler(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, + const uint8_t *_Nonnull data, size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_custom_private_packet_callback != nullptr) { @@ -512,8 +512,8 @@ static void tox_group_custom_private_packet_handler(non_null() const Messenger * } } -static void tox_group_invite_handler(non_null() const Messenger *m, uint32_t friend_number, non_null() const uint8_t *invite_data, - size_t length, non_null() const uint8_t *group_name, size_t group_name_length, nullable() void *user_data) +static void tox_group_invite_handler(const Messenger *_Nonnull m, uint32_t friend_number, const uint8_t *_Nonnull invite_data, + size_t length, const uint8_t *_Nonnull group_name, size_t group_name_length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_invite_callback != nullptr) { @@ -524,7 +524,7 @@ static void tox_group_invite_handler(non_null() const Messenger *m, uint32_t fri } } -static void tox_group_peer_join_handler(non_null() const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, nullable() void *user_data) +static void tox_group_peer_join_handler(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_peer_join_callback != nullptr) { @@ -534,9 +534,9 @@ static void tox_group_peer_join_handler(non_null() const Messenger *m, uint32_t } } -static void tox_group_peer_exit_handler(non_null() const Messenger *m, uint32_t group_number, GC_Peer_Id peer_id, - unsigned int exit_type, non_null() const uint8_t *name, size_t name_length, - nullable() const uint8_t *part_message, size_t length, nullable() void *user_data) +static void tox_group_peer_exit_handler(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id peer_id, + unsigned int exit_type, const uint8_t *_Nonnull name, size_t name_length, + const uint8_t *_Nullable part_message, size_t length, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_peer_exit_callback != nullptr) { @@ -548,7 +548,7 @@ static void tox_group_peer_exit_handler(non_null() const Messenger *m, uint32_t } } -static void tox_group_self_join_handler(non_null() const Messenger *m, uint32_t group_number, nullable() void *user_data) +static void tox_group_self_join_handler(const Messenger *_Nonnull m, uint32_t group_number, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_self_join_callback != nullptr) { @@ -558,8 +558,8 @@ static void tox_group_self_join_handler(non_null() const Messenger *m, uint32_t } } -static void tox_group_join_fail_handler(non_null() const Messenger *m, uint32_t group_number, unsigned int fail_type, - nullable() void *user_data) +static void tox_group_join_fail_handler(const Messenger *_Nonnull m, uint32_t group_number, unsigned int fail_type, + void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_join_fail_callback != nullptr) { @@ -570,8 +570,8 @@ static void tox_group_join_fail_handler(non_null() const Messenger *m, uint32_t } } -static void tox_group_moderation_handler(non_null() const Messenger *m, uint32_t group_number, GC_Peer_Id source_peer_number, - GC_Peer_Id target_peer_number, unsigned int mod_type, nullable() void *user_data) +static void tox_group_moderation_handler(const Messenger *_Nonnull m, uint32_t group_number, GC_Peer_Id source_peer_number, + GC_Peer_Id target_peer_number, unsigned int mod_type, void *_Nullable user_data) { struct Tox_Userdata *tox_data = (struct Tox_Userdata *)user_data; if (tox_data->tox->group_moderation_callback != nullptr) { @@ -588,7 +588,7 @@ bool tox_version_is_compatible(uint32_t major, uint32_t minor, uint32_t patch) return TOX_VERSION_IS_API_COMPATIBLE(major, minor, patch); } -static State_Load_Status state_load_callback(non_null() void *outer, non_null() const uint8_t *data, uint32_t length, uint16_t type) +static State_Load_Status state_load_callback(void *_Nonnull outer, const uint8_t *_Nonnull data, uint32_t length, uint16_t type) { const Tox *tox = (const Tox *)outer; State_Load_Status status = STATE_LOAD_STATUS_CONTINUE; @@ -613,7 +613,7 @@ static State_Load_Status state_load_callback(non_null() void *outer, non_null() } /** Load tox from data of size length. */ -static int tox_load(non_null() Tox *tox, non_null() const uint8_t *data, uint32_t length) +static int tox_load(Tox *_Nonnull tox, const uint8_t *_Nonnull data, uint32_t length) { uint32_t data32[2]; const uint32_t cookie_len = sizeof(data32); @@ -633,7 +633,7 @@ static int tox_load(non_null() Tox *tox, non_null() const uint8_t *data, uint32_ length - cookie_len, STATE_COOKIE_TYPE); } -static Tox *tox_new_system(nullable() const struct Tox_Options *options, nullable() Tox_Err_New *error, nullable() const Tox_System *sys) +static Tox *tox_new_system(const struct Tox_Options *_Nullable options, Tox_Err_New *_Nullable error, const Tox_System *_Nullable sys) { struct Tox_Options *default_options = nullptr; if (options == nullptr) { @@ -999,7 +999,7 @@ static uint32_t end_size(void) return 2 * sizeof(uint32_t); } -static void end_save(non_null() uint8_t *data) +static void end_save(uint8_t *_Nonnull data) { state_write_section_header(data, STATE_COOKIE_TYPE, 0, STATE_TYPE_END); } @@ -1043,8 +1043,8 @@ void tox_get_savedata(const Tox *tox, uint8_t *savedata) tox_unlock(tox); } -static int32_t resolve_bootstrap_node(nullable() Tox *tox, nullable() const char *host, uint16_t port, const uint8_t public_key[TOX_PUBLIC_KEY_SIZE], - non_null() IP_Port **root, nullable() Tox_Err_Bootstrap *error) +static int32_t resolve_bootstrap_node(Tox *_Nullable tox, const char *_Nullable host, uint16_t port, const uint8_t public_key[TOX_PUBLIC_KEY_SIZE], + IP_Port *_Nonnull *root, Tox_Err_Bootstrap *_Nullable error) { assert(tox != nullptr); assert(root != nullptr); @@ -1369,7 +1369,7 @@ Tox_User_Status tox_self_get_status(const Tox *tox) return (Tox_User_Status)status; } -static void set_friend_error(non_null() const Logger *log, int32_t ret, nullable() Tox_Err_Friend_Add *error) +static void set_friend_error(const Logger *_Nonnull log, int32_t ret, Tox_Err_Friend_Add *_Nullable error) { switch (ret) { case FAERR_TOOLONG: { @@ -1745,7 +1745,7 @@ bool tox_self_set_typing(Tox *tox, uint32_t friend_number, bool typing, Tox_Err_ return true; } -static void set_message_error(non_null() const Logger *log, int ret, nullable() Tox_Err_Friend_Send_Message *error) +static void set_message_error(const Logger *_Nonnull log, int ret, Tox_Err_Friend_Send_Message *_Nullable error) { switch (ret) { case 0: { @@ -2733,7 +2733,7 @@ uint32_t tox_conference_by_uid(const Tox *tox, const uint8_t uid[TOX_CONFERENCE_ return res; } -static void set_custom_packet_error(int ret, nullable() Tox_Err_Friend_Custom_Packet *error) +static void set_custom_packet_error(int ret, Tox_Err_Friend_Custom_Packet *_Nullable error) { switch (ret) { case 0: { diff --git a/toxcore/tox_dispatch.c b/toxcore/tox_dispatch.c index 51ab745f5..04e0d9345 100644 --- a/toxcore/tox_dispatch.c +++ b/toxcore/tox_dispatch.c @@ -285,7 +285,7 @@ void tox_events_callback_dht_nodes_response( dispatch->dht_nodes_response_callback = callback; } -static void tox_dispatch_invoke_event(non_null() const Tox_Dispatch *dispatch, non_null() const Tox_Event *event, nullable() void *user_data) +static void tox_dispatch_invoke_event(const Tox_Dispatch *_Nonnull dispatch, const Tox_Event *_Nonnull event, void *_Nullable user_data) { switch (event->type) { case TOX_EVENT_CONFERENCE_CONNECTED: { diff --git a/toxcore/tox_event.c b/toxcore/tox_event.c index 222eac1f1..faa7be4ee 100644 --- a/toxcore/tox_event.c +++ b/toxcore/tox_event.c @@ -578,12 +578,12 @@ void tox_event_destruct(Tox_Event *event, const Memory *mem) event->data.value = nullptr; } -static bool tox_event_type_pack(Tox_Event_Type type, non_null() Bin_Pack *bp) +static bool tox_event_type_pack(Tox_Event_Type type, Bin_Pack *_Nonnull bp) { return bin_pack_u32(bp, (uint32_t)type); } -static bool tox_event_data_pack(Tox_Event_Type type, non_null() const Tox_Event_Data *data, non_null() Bin_Pack *bp) +static bool tox_event_data_pack(Tox_Event_Type type, const Tox_Event_Data *_Nonnull data, Bin_Pack *_Nonnull bp) { switch (type) { case TOX_EVENT_CONFERENCE_CONNECTED: @@ -722,7 +722,7 @@ bool tox_event_pack(const Tox_Event *event, Bin_Pack *bp) && tox_event_data_pack(event->type, &event->data, bp); } -static bool tox_event_type_from_int(uint32_t value, non_null() Tox_Event_Type *out_enum) +static bool tox_event_type_from_int(uint32_t value, Tox_Event_Type *_Nonnull out_enum) { switch (value) { case TOX_EVENT_SELF_CONNECTION_STATUS: { @@ -937,14 +937,14 @@ static bool tox_event_type_from_int(uint32_t value, non_null() Tox_Event_Type *o } } -static bool tox_event_type_unpack(non_null() Tox_Event_Type *val, non_null() Bin_Unpack *bu) +static bool tox_event_type_unpack(Tox_Event_Type *_Nonnull val, Bin_Unpack *_Nonnull bu) { uint32_t u32; return bin_unpack_u32(bu, &u32) && tox_event_type_from_int(u32, val); } -static bool tox_event_data_unpack(Tox_Event_Type type, non_null() Tox_Event_Data *data, non_null() Bin_Unpack *bu, non_null() const Memory *mem) +static bool tox_event_data_unpack(Tox_Event_Type type, Tox_Event_Data *_Nonnull data, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem) { switch (type) { case TOX_EVENT_CONFERENCE_CONNECTED: diff --git a/toxcore/tox_event.h b/toxcore/tox_event.h index 445674502..ebbf7b35a 100644 --- a/toxcore/tox_event.h +++ b/toxcore/tox_event.h @@ -20,48 +20,48 @@ typedef union Tox_Event_Data { /** * Opaque pointer just to check whether any value is set. */ - void *value; + void *_Nullable value; - Tox_Event_Conference_Connected *conference_connected; - Tox_Event_Conference_Invite *conference_invite; - Tox_Event_Conference_Message *conference_message; - Tox_Event_Conference_Peer_List_Changed *conference_peer_list_changed; - Tox_Event_Conference_Peer_Name *conference_peer_name; - Tox_Event_Conference_Title *conference_title; - Tox_Event_File_Chunk_Request *file_chunk_request; - Tox_Event_File_Recv *file_recv; - Tox_Event_File_Recv_Chunk *file_recv_chunk; - Tox_Event_File_Recv_Control *file_recv_control; - Tox_Event_Friend_Connection_Status *friend_connection_status; - Tox_Event_Friend_Lossless_Packet *friend_lossless_packet; - Tox_Event_Friend_Lossy_Packet *friend_lossy_packet; - Tox_Event_Friend_Message *friend_message; - Tox_Event_Friend_Name *friend_name; - Tox_Event_Friend_Read_Receipt *friend_read_receipt; - Tox_Event_Friend_Request *friend_request; - Tox_Event_Friend_Status *friend_status; - Tox_Event_Friend_Status_Message *friend_status_message; - Tox_Event_Friend_Typing *friend_typing; - Tox_Event_Self_Connection_Status *self_connection_status; - Tox_Event_Group_Peer_Name *group_peer_name; - Tox_Event_Group_Peer_Status *group_peer_status; - Tox_Event_Group_Topic *group_topic; - Tox_Event_Group_Privacy_State *group_privacy_state; - Tox_Event_Group_Voice_State *group_voice_state; - Tox_Event_Group_Topic_Lock *group_topic_lock; - Tox_Event_Group_Peer_Limit *group_peer_limit; - Tox_Event_Group_Password *group_password; - Tox_Event_Group_Message *group_message; - Tox_Event_Group_Private_Message *group_private_message; - Tox_Event_Group_Custom_Packet *group_custom_packet; - Tox_Event_Group_Custom_Private_Packet *group_custom_private_packet; - Tox_Event_Group_Invite *group_invite; - Tox_Event_Group_Peer_Join *group_peer_join; - Tox_Event_Group_Peer_Exit *group_peer_exit; - Tox_Event_Group_Self_Join *group_self_join; - Tox_Event_Group_Join_Fail *group_join_fail; - Tox_Event_Group_Moderation *group_moderation; - Tox_Event_Dht_Nodes_Response *dht_nodes_response; + Tox_Event_Conference_Connected *_Nullable conference_connected; + Tox_Event_Conference_Invite *_Nullable conference_invite; + Tox_Event_Conference_Message *_Nullable conference_message; + Tox_Event_Conference_Peer_List_Changed *_Nullable conference_peer_list_changed; + Tox_Event_Conference_Peer_Name *_Nullable conference_peer_name; + Tox_Event_Conference_Title *_Nullable conference_title; + Tox_Event_File_Chunk_Request *_Nullable file_chunk_request; + Tox_Event_File_Recv *_Nullable file_recv; + Tox_Event_File_Recv_Chunk *_Nullable file_recv_chunk; + Tox_Event_File_Recv_Control *_Nullable file_recv_control; + Tox_Event_Friend_Connection_Status *_Nullable friend_connection_status; + Tox_Event_Friend_Lossless_Packet *_Nullable friend_lossless_packet; + Tox_Event_Friend_Lossy_Packet *_Nullable friend_lossy_packet; + Tox_Event_Friend_Message *_Nullable friend_message; + Tox_Event_Friend_Name *_Nullable friend_name; + Tox_Event_Friend_Read_Receipt *_Nullable friend_read_receipt; + Tox_Event_Friend_Request *_Nullable friend_request; + Tox_Event_Friend_Status *_Nullable friend_status; + Tox_Event_Friend_Status_Message *_Nullable friend_status_message; + Tox_Event_Friend_Typing *_Nullable friend_typing; + Tox_Event_Self_Connection_Status *_Nullable self_connection_status; + Tox_Event_Group_Peer_Name *_Nullable group_peer_name; + Tox_Event_Group_Peer_Status *_Nullable group_peer_status; + Tox_Event_Group_Topic *_Nullable group_topic; + Tox_Event_Group_Privacy_State *_Nullable group_privacy_state; + Tox_Event_Group_Voice_State *_Nullable group_voice_state; + Tox_Event_Group_Topic_Lock *_Nullable group_topic_lock; + Tox_Event_Group_Peer_Limit *_Nullable group_peer_limit; + Tox_Event_Group_Password *_Nullable group_password; + Tox_Event_Group_Message *_Nullable group_message; + Tox_Event_Group_Private_Message *_Nullable group_private_message; + Tox_Event_Group_Custom_Packet *_Nullable group_custom_packet; + Tox_Event_Group_Custom_Private_Packet *_Nullable group_custom_private_packet; + Tox_Event_Group_Invite *_Nullable group_invite; + Tox_Event_Group_Peer_Join *_Nullable group_peer_join; + Tox_Event_Group_Peer_Exit *_Nullable group_peer_exit; + Tox_Event_Group_Self_Join *_Nullable group_self_join; + Tox_Event_Group_Join_Fail *_Nullable group_join_fail; + Tox_Event_Group_Moderation *_Nullable group_moderation; + Tox_Event_Dht_Nodes_Response *_Nullable dht_nodes_response; } Tox_Event_Data; struct Tox_Event { @@ -72,186 +72,186 @@ struct Tox_Event { /** * Constructor. */ -bool tox_event_construct(non_null() Tox_Event *event, Tox_Event_Type type, non_null() const Memory *mem); +bool tox_event_construct(Tox_Event *_Nonnull event, Tox_Event_Type type, const Memory *_Nonnull mem); -Tox_Event_Conference_Connected *tox_event_conference_connected_new(non_null() const Memory *mem); -Tox_Event_Conference_Invite *tox_event_conference_invite_new(non_null() const Memory *mem); -Tox_Event_Conference_Message *tox_event_conference_message_new(non_null() const Memory *mem); -Tox_Event_Conference_Peer_List_Changed *tox_event_conference_peer_list_changed_new(non_null() const Memory *mem); -Tox_Event_Conference_Peer_Name *tox_event_conference_peer_name_new(non_null() const Memory *mem); -Tox_Event_Conference_Title *tox_event_conference_title_new(non_null() const Memory *mem); -Tox_Event_File_Chunk_Request *tox_event_file_chunk_request_new(non_null() const Memory *mem); -Tox_Event_File_Recv_Chunk *tox_event_file_recv_chunk_new(non_null() const Memory *mem); -Tox_Event_File_Recv_Control *tox_event_file_recv_control_new(non_null() const Memory *mem); -Tox_Event_File_Recv *tox_event_file_recv_new(non_null() const Memory *mem); -Tox_Event_Friend_Connection_Status *tox_event_friend_connection_status_new(non_null() const Memory *mem); -Tox_Event_Friend_Lossless_Packet *tox_event_friend_lossless_packet_new(non_null() const Memory *mem); -Tox_Event_Friend_Lossy_Packet *tox_event_friend_lossy_packet_new(non_null() const Memory *mem); -Tox_Event_Friend_Message *tox_event_friend_message_new(non_null() const Memory *mem); -Tox_Event_Friend_Name *tox_event_friend_name_new(non_null() const Memory *mem); -Tox_Event_Friend_Read_Receipt *tox_event_friend_read_receipt_new(non_null() const Memory *mem); -Tox_Event_Friend_Request *tox_event_friend_request_new(non_null() const Memory *mem); -Tox_Event_Friend_Status_Message *tox_event_friend_status_message_new(non_null() const Memory *mem); -Tox_Event_Friend_Status *tox_event_friend_status_new(non_null() const Memory *mem); -Tox_Event_Friend_Typing *tox_event_friend_typing_new(non_null() const Memory *mem); -Tox_Event_Self_Connection_Status *tox_event_self_connection_status_new(non_null() const Memory *mem); -Tox_Event_Group_Peer_Name *tox_event_group_peer_name_new(non_null() const Memory *mem); -Tox_Event_Group_Peer_Status *tox_event_group_peer_status_new(non_null() const Memory *mem); -Tox_Event_Group_Topic *tox_event_group_topic_new(non_null() const Memory *mem); -Tox_Event_Group_Privacy_State *tox_event_group_privacy_state_new(non_null() const Memory *mem); -Tox_Event_Group_Voice_State *tox_event_group_voice_state_new(non_null() const Memory *mem); -Tox_Event_Group_Topic_Lock *tox_event_group_topic_lock_new(non_null() const Memory *mem); -Tox_Event_Group_Peer_Limit *tox_event_group_peer_limit_new(non_null() const Memory *mem); -Tox_Event_Group_Password *tox_event_group_password_new(non_null() const Memory *mem); -Tox_Event_Group_Message *tox_event_group_message_new(non_null() const Memory *mem); -Tox_Event_Group_Private_Message *tox_event_group_private_message_new(non_null() const Memory *mem); -Tox_Event_Group_Custom_Packet *tox_event_group_custom_packet_new(non_null() const Memory *mem); -Tox_Event_Group_Custom_Private_Packet *tox_event_group_custom_private_packet_new(non_null() const Memory *mem); -Tox_Event_Group_Invite *tox_event_group_invite_new(non_null() const Memory *mem); -Tox_Event_Group_Peer_Join *tox_event_group_peer_join_new(non_null() const Memory *mem); -Tox_Event_Group_Peer_Exit *tox_event_group_peer_exit_new(non_null() const Memory *mem); -Tox_Event_Group_Self_Join *tox_event_group_self_join_new(non_null() const Memory *mem); -Tox_Event_Group_Join_Fail *tox_event_group_join_fail_new(non_null() const Memory *mem); -Tox_Event_Group_Moderation *tox_event_group_moderation_new(non_null() const Memory *mem); -Tox_Event_Dht_Nodes_Response *tox_event_dht_nodes_response_new(non_null() const Memory *mem); +Tox_Event_Conference_Connected *_Nullable tox_event_conference_connected_new(const Memory *_Nonnull mem); +Tox_Event_Conference_Invite *_Nullable tox_event_conference_invite_new(const Memory *_Nonnull mem); +Tox_Event_Conference_Message *_Nullable tox_event_conference_message_new(const Memory *_Nonnull mem); +Tox_Event_Conference_Peer_List_Changed *_Nullable tox_event_conference_peer_list_changed_new(const Memory *_Nonnull mem); +Tox_Event_Conference_Peer_Name *_Nullable tox_event_conference_peer_name_new(const Memory *_Nonnull mem); +Tox_Event_Conference_Title *_Nullable tox_event_conference_title_new(const Memory *_Nonnull mem); +Tox_Event_File_Chunk_Request *_Nullable tox_event_file_chunk_request_new(const Memory *_Nonnull mem); +Tox_Event_File_Recv_Chunk *_Nullable tox_event_file_recv_chunk_new(const Memory *_Nonnull mem); +Tox_Event_File_Recv_Control *_Nullable tox_event_file_recv_control_new(const Memory *_Nonnull mem); +Tox_Event_File_Recv *_Nullable tox_event_file_recv_new(const Memory *_Nonnull mem); +Tox_Event_Friend_Connection_Status *_Nullable tox_event_friend_connection_status_new(const Memory *_Nonnull mem); +Tox_Event_Friend_Lossless_Packet *_Nullable tox_event_friend_lossless_packet_new(const Memory *_Nonnull mem); +Tox_Event_Friend_Lossy_Packet *_Nullable tox_event_friend_lossy_packet_new(const Memory *_Nonnull mem); +Tox_Event_Friend_Message *_Nullable tox_event_friend_message_new(const Memory *_Nonnull mem); +Tox_Event_Friend_Name *_Nullable tox_event_friend_name_new(const Memory *_Nonnull mem); +Tox_Event_Friend_Read_Receipt *_Nullable tox_event_friend_read_receipt_new(const Memory *_Nonnull mem); +Tox_Event_Friend_Request *_Nullable tox_event_friend_request_new(const Memory *_Nonnull mem); +Tox_Event_Friend_Status_Message *_Nullable tox_event_friend_status_message_new(const Memory *_Nonnull mem); +Tox_Event_Friend_Status *_Nullable tox_event_friend_status_new(const Memory *_Nonnull mem); +Tox_Event_Friend_Typing *_Nullable tox_event_friend_typing_new(const Memory *_Nonnull mem); +Tox_Event_Self_Connection_Status *_Nullable tox_event_self_connection_status_new(const Memory *_Nonnull mem); +Tox_Event_Group_Peer_Name *_Nullable tox_event_group_peer_name_new(const Memory *_Nonnull mem); +Tox_Event_Group_Peer_Status *_Nullable tox_event_group_peer_status_new(const Memory *_Nonnull mem); +Tox_Event_Group_Topic *_Nullable tox_event_group_topic_new(const Memory *_Nonnull mem); +Tox_Event_Group_Privacy_State *_Nullable tox_event_group_privacy_state_new(const Memory *_Nonnull mem); +Tox_Event_Group_Voice_State *_Nullable tox_event_group_voice_state_new(const Memory *_Nonnull mem); +Tox_Event_Group_Topic_Lock *_Nullable tox_event_group_topic_lock_new(const Memory *_Nonnull mem); +Tox_Event_Group_Peer_Limit *_Nullable tox_event_group_peer_limit_new(const Memory *_Nonnull mem); +Tox_Event_Group_Password *_Nullable tox_event_group_password_new(const Memory *_Nonnull mem); +Tox_Event_Group_Message *_Nullable tox_event_group_message_new(const Memory *_Nonnull mem); +Tox_Event_Group_Private_Message *_Nullable tox_event_group_private_message_new(const Memory *_Nonnull mem); +Tox_Event_Group_Custom_Packet *_Nullable tox_event_group_custom_packet_new(const Memory *_Nonnull mem); +Tox_Event_Group_Custom_Private_Packet *_Nullable tox_event_group_custom_private_packet_new(const Memory *_Nonnull mem); +Tox_Event_Group_Invite *_Nullable tox_event_group_invite_new(const Memory *_Nonnull mem); +Tox_Event_Group_Peer_Join *_Nullable tox_event_group_peer_join_new(const Memory *_Nonnull mem); +Tox_Event_Group_Peer_Exit *_Nullable tox_event_group_peer_exit_new(const Memory *_Nonnull mem); +Tox_Event_Group_Self_Join *_Nullable tox_event_group_self_join_new(const Memory *_Nonnull mem); +Tox_Event_Group_Join_Fail *_Nullable tox_event_group_join_fail_new(const Memory *_Nonnull mem); +Tox_Event_Group_Moderation *_Nullable tox_event_group_moderation_new(const Memory *_Nonnull mem); +Tox_Event_Dht_Nodes_Response *_Nullable tox_event_dht_nodes_response_new(const Memory *_Nonnull mem); /** * Destructor. */ -void tox_event_destruct(nullable() Tox_Event *event, non_null() const Memory *mem); +void tox_event_destruct(Tox_Event *_Nullable event, const Memory *_Nonnull mem); -void tox_event_conference_connected_free(nullable() Tox_Event_Conference_Connected *conference_connected, non_null() const Memory *mem); -void tox_event_conference_invite_free(nullable() Tox_Event_Conference_Invite *conference_invite, non_null() const Memory *mem); -void tox_event_conference_message_free(nullable() Tox_Event_Conference_Message *conference_message, non_null() const Memory *mem); -void tox_event_conference_peer_list_changed_free(nullable() Tox_Event_Conference_Peer_List_Changed *conference_peer_list_changed, non_null() const Memory *mem); -void tox_event_conference_peer_name_free(nullable() Tox_Event_Conference_Peer_Name *conference_peer_name, non_null() const Memory *mem); -void tox_event_conference_title_free(nullable() Tox_Event_Conference_Title *conference_title, non_null() const Memory *mem); -void tox_event_file_chunk_request_free(nullable() Tox_Event_File_Chunk_Request *file_chunk_request, non_null() const Memory *mem); -void tox_event_file_recv_chunk_free(nullable() Tox_Event_File_Recv_Chunk *file_recv_chunk, non_null() const Memory *mem); -void tox_event_file_recv_control_free(nullable() Tox_Event_File_Recv_Control *file_recv_control, non_null() const Memory *mem); -void tox_event_file_recv_free(nullable() Tox_Event_File_Recv *file_recv, non_null() const Memory *mem); -void tox_event_friend_connection_status_free(nullable() Tox_Event_Friend_Connection_Status *friend_connection_status, non_null() const Memory *mem); -void tox_event_friend_lossless_packet_free(nullable() Tox_Event_Friend_Lossless_Packet *friend_lossless_packet, non_null() const Memory *mem); -void tox_event_friend_lossy_packet_free(nullable() Tox_Event_Friend_Lossy_Packet *friend_lossy_packet, non_null() const Memory *mem); -void tox_event_friend_message_free(nullable() Tox_Event_Friend_Message *friend_message, non_null() const Memory *mem); -void tox_event_friend_name_free(nullable() Tox_Event_Friend_Name *friend_name, non_null() const Memory *mem); -void tox_event_friend_read_receipt_free(nullable() Tox_Event_Friend_Read_Receipt *friend_read_receipt, non_null() const Memory *mem); -void tox_event_friend_request_free(nullable() Tox_Event_Friend_Request *friend_request, non_null() const Memory *mem); -void tox_event_friend_status_message_free(nullable() Tox_Event_Friend_Status_Message *friend_status_message, non_null() const Memory *mem); -void tox_event_friend_status_free(nullable() Tox_Event_Friend_Status *friend_status, non_null() const Memory *mem); -void tox_event_friend_typing_free(nullable() Tox_Event_Friend_Typing *friend_typing, non_null() const Memory *mem); -void tox_event_self_connection_status_free(nullable() Tox_Event_Self_Connection_Status *self_connection_status, non_null() const Memory *mem); -void tox_event_group_peer_name_free(nullable() Tox_Event_Group_Peer_Name *group_peer_name, non_null() const Memory *mem); -void tox_event_group_peer_status_free(nullable() Tox_Event_Group_Peer_Status *group_peer_status, non_null() const Memory *mem); -void tox_event_group_topic_free(nullable() Tox_Event_Group_Topic *group_topic, non_null() const Memory *mem); -void tox_event_group_privacy_state_free(nullable() Tox_Event_Group_Privacy_State *group_privacy_state, non_null() const Memory *mem); -void tox_event_group_voice_state_free(nullable() Tox_Event_Group_Voice_State *group_voice_state, non_null() const Memory *mem); -void tox_event_group_topic_lock_free(nullable() Tox_Event_Group_Topic_Lock *group_topic_lock, non_null() const Memory *mem); -void tox_event_group_peer_limit_free(nullable() Tox_Event_Group_Peer_Limit *group_peer_limit, non_null() const Memory *mem); -void tox_event_group_password_free(nullable() Tox_Event_Group_Password *group_password, non_null() const Memory *mem); -void tox_event_group_message_free(nullable() Tox_Event_Group_Message *group_message, non_null() const Memory *mem); -void tox_event_group_private_message_free(nullable() Tox_Event_Group_Private_Message *group_private_message, non_null() const Memory *mem); -void tox_event_group_custom_packet_free(nullable() Tox_Event_Group_Custom_Packet *group_custom_packet, non_null() const Memory *mem); -void tox_event_group_custom_private_packet_free(nullable() Tox_Event_Group_Custom_Private_Packet *group_custom_private_packet, non_null() const Memory *mem); -void tox_event_group_invite_free(nullable() Tox_Event_Group_Invite *group_invite, non_null() const Memory *mem); -void tox_event_group_peer_join_free(nullable() Tox_Event_Group_Peer_Join *group_peer_join, non_null() const Memory *mem); -void tox_event_group_peer_exit_free(nullable() Tox_Event_Group_Peer_Exit *group_peer_exit, non_null() const Memory *mem); -void tox_event_group_self_join_free(nullable() Tox_Event_Group_Self_Join *group_self_join, non_null() const Memory *mem); -void tox_event_group_join_fail_free(nullable() Tox_Event_Group_Join_Fail *group_join_fail, non_null() const Memory *mem); -void tox_event_group_moderation_free(nullable() Tox_Event_Group_Moderation *group_moderation, non_null() const Memory *mem); -void tox_event_dht_nodes_response_free(nullable() Tox_Event_Dht_Nodes_Response *dht_nodes_response, non_null() const Memory *mem); +void tox_event_conference_connected_free(Tox_Event_Conference_Connected *_Nullable conference_connected, const Memory *_Nonnull mem); +void tox_event_conference_invite_free(Tox_Event_Conference_Invite *_Nullable conference_invite, const Memory *_Nonnull mem); +void tox_event_conference_message_free(Tox_Event_Conference_Message *_Nullable conference_message, const Memory *_Nonnull mem); +void tox_event_conference_peer_list_changed_free(Tox_Event_Conference_Peer_List_Changed *_Nullable conference_peer_list_changed, const Memory *_Nonnull mem); +void tox_event_conference_peer_name_free(Tox_Event_Conference_Peer_Name *_Nullable conference_peer_name, const Memory *_Nonnull mem); +void tox_event_conference_title_free(Tox_Event_Conference_Title *_Nullable conference_title, const Memory *_Nonnull mem); +void tox_event_file_chunk_request_free(Tox_Event_File_Chunk_Request *_Nullable file_chunk_request, const Memory *_Nonnull mem); +void tox_event_file_recv_chunk_free(Tox_Event_File_Recv_Chunk *_Nullable file_recv_chunk, const Memory *_Nonnull mem); +void tox_event_file_recv_control_free(Tox_Event_File_Recv_Control *_Nullable file_recv_control, const Memory *_Nonnull mem); +void tox_event_file_recv_free(Tox_Event_File_Recv *_Nullable file_recv, const Memory *_Nonnull mem); +void tox_event_friend_connection_status_free(Tox_Event_Friend_Connection_Status *_Nullable friend_connection_status, const Memory *_Nonnull mem); +void tox_event_friend_lossless_packet_free(Tox_Event_Friend_Lossless_Packet *_Nullable friend_lossless_packet, const Memory *_Nonnull mem); +void tox_event_friend_lossy_packet_free(Tox_Event_Friend_Lossy_Packet *_Nullable friend_lossy_packet, const Memory *_Nonnull mem); +void tox_event_friend_message_free(Tox_Event_Friend_Message *_Nullable friend_message, const Memory *_Nonnull mem); +void tox_event_friend_name_free(Tox_Event_Friend_Name *_Nullable friend_name, const Memory *_Nonnull mem); +void tox_event_friend_read_receipt_free(Tox_Event_Friend_Read_Receipt *_Nullable friend_read_receipt, const Memory *_Nonnull mem); +void tox_event_friend_request_free(Tox_Event_Friend_Request *_Nullable friend_request, const Memory *_Nonnull mem); +void tox_event_friend_status_message_free(Tox_Event_Friend_Status_Message *_Nullable friend_status_message, const Memory *_Nonnull mem); +void tox_event_friend_status_free(Tox_Event_Friend_Status *_Nullable friend_status, const Memory *_Nonnull mem); +void tox_event_friend_typing_free(Tox_Event_Friend_Typing *_Nullable friend_typing, const Memory *_Nonnull mem); +void tox_event_self_connection_status_free(Tox_Event_Self_Connection_Status *_Nullable self_connection_status, const Memory *_Nonnull mem); +void tox_event_group_peer_name_free(Tox_Event_Group_Peer_Name *_Nullable group_peer_name, const Memory *_Nonnull mem); +void tox_event_group_peer_status_free(Tox_Event_Group_Peer_Status *_Nullable group_peer_status, const Memory *_Nonnull mem); +void tox_event_group_topic_free(Tox_Event_Group_Topic *_Nullable group_topic, const Memory *_Nonnull mem); +void tox_event_group_privacy_state_free(Tox_Event_Group_Privacy_State *_Nullable group_privacy_state, const Memory *_Nonnull mem); +void tox_event_group_voice_state_free(Tox_Event_Group_Voice_State *_Nullable group_voice_state, const Memory *_Nonnull mem); +void tox_event_group_topic_lock_free(Tox_Event_Group_Topic_Lock *_Nullable group_topic_lock, const Memory *_Nonnull mem); +void tox_event_group_peer_limit_free(Tox_Event_Group_Peer_Limit *_Nullable group_peer_limit, const Memory *_Nonnull mem); +void tox_event_group_password_free(Tox_Event_Group_Password *_Nullable group_password, const Memory *_Nonnull mem); +void tox_event_group_message_free(Tox_Event_Group_Message *_Nullable group_message, const Memory *_Nonnull mem); +void tox_event_group_private_message_free(Tox_Event_Group_Private_Message *_Nullable group_private_message, const Memory *_Nonnull mem); +void tox_event_group_custom_packet_free(Tox_Event_Group_Custom_Packet *_Nullable group_custom_packet, const Memory *_Nonnull mem); +void tox_event_group_custom_private_packet_free(Tox_Event_Group_Custom_Private_Packet *_Nullable group_custom_private_packet, const Memory *_Nonnull mem); +void tox_event_group_invite_free(Tox_Event_Group_Invite *_Nullable group_invite, const Memory *_Nonnull mem); +void tox_event_group_peer_join_free(Tox_Event_Group_Peer_Join *_Nullable group_peer_join, const Memory *_Nonnull mem); +void tox_event_group_peer_exit_free(Tox_Event_Group_Peer_Exit *_Nullable group_peer_exit, const Memory *_Nonnull mem); +void tox_event_group_self_join_free(Tox_Event_Group_Self_Join *_Nullable group_self_join, const Memory *_Nonnull mem); +void tox_event_group_join_fail_free(Tox_Event_Group_Join_Fail *_Nullable group_join_fail, const Memory *_Nonnull mem); +void tox_event_group_moderation_free(Tox_Event_Group_Moderation *_Nullable group_moderation, const Memory *_Nonnull mem); +void tox_event_dht_nodes_response_free(Tox_Event_Dht_Nodes_Response *_Nullable dht_nodes_response, const Memory *_Nonnull mem); /** * Pack into msgpack. */ -bool tox_event_pack(non_null() const Tox_Event *event, non_null() Bin_Pack *bp); +bool tox_event_pack(const Tox_Event *_Nonnull event, Bin_Pack *_Nonnull bp); -bool tox_event_conference_connected_pack(non_null() const Tox_Event_Conference_Connected *event, non_null() Bin_Pack *bp); -bool tox_event_conference_invite_pack(non_null() const Tox_Event_Conference_Invite *event, non_null() Bin_Pack *bp); -bool tox_event_conference_message_pack(non_null() const Tox_Event_Conference_Message *event, non_null() Bin_Pack *bp); -bool tox_event_conference_peer_list_changed_pack(non_null() const Tox_Event_Conference_Peer_List_Changed *event, non_null() Bin_Pack *bp); -bool tox_event_conference_peer_name_pack(non_null() const Tox_Event_Conference_Peer_Name *event, non_null() Bin_Pack *bp); -bool tox_event_conference_title_pack(non_null() const Tox_Event_Conference_Title *event, non_null() Bin_Pack *bp); -bool tox_event_file_chunk_request_pack(non_null() const Tox_Event_File_Chunk_Request *event, non_null() Bin_Pack *bp); -bool tox_event_file_recv_chunk_pack(non_null() const Tox_Event_File_Recv_Chunk *event, non_null() Bin_Pack *bp); -bool tox_event_file_recv_control_pack(non_null() const Tox_Event_File_Recv_Control *event, non_null() Bin_Pack *bp); -bool tox_event_file_recv_pack(non_null() const Tox_Event_File_Recv *event, non_null() Bin_Pack *bp); -bool tox_event_friend_connection_status_pack(non_null() const Tox_Event_Friend_Connection_Status *event, non_null() Bin_Pack *bp); -bool tox_event_friend_lossless_packet_pack(non_null() const Tox_Event_Friend_Lossless_Packet *event, non_null() Bin_Pack *bp); -bool tox_event_friend_lossy_packet_pack(non_null() const Tox_Event_Friend_Lossy_Packet *event, non_null() Bin_Pack *bp); -bool tox_event_friend_message_pack(non_null() const Tox_Event_Friend_Message *event, non_null() Bin_Pack *bp); -bool tox_event_friend_name_pack(non_null() const Tox_Event_Friend_Name *event, non_null() Bin_Pack *bp); -bool tox_event_friend_read_receipt_pack(non_null() const Tox_Event_Friend_Read_Receipt *event, non_null() Bin_Pack *bp); -bool tox_event_friend_request_pack(non_null() const Tox_Event_Friend_Request *event, non_null() Bin_Pack *bp); -bool tox_event_friend_status_message_pack(non_null() const Tox_Event_Friend_Status_Message *event, non_null() Bin_Pack *bp); -bool tox_event_friend_status_pack(non_null() const Tox_Event_Friend_Status *event, non_null() Bin_Pack *bp); -bool tox_event_friend_typing_pack(non_null() const Tox_Event_Friend_Typing *event, non_null() Bin_Pack *bp); -bool tox_event_self_connection_status_pack(non_null() const Tox_Event_Self_Connection_Status *event, non_null() Bin_Pack *bp); -bool tox_event_group_peer_name_pack(non_null() const Tox_Event_Group_Peer_Name *event, non_null() Bin_Pack *bp); -bool tox_event_group_peer_status_pack(non_null() const Tox_Event_Group_Peer_Status *event, non_null() Bin_Pack *bp); -bool tox_event_group_topic_pack(non_null() const Tox_Event_Group_Topic *event, non_null() Bin_Pack *bp); -bool tox_event_group_privacy_state_pack(non_null() const Tox_Event_Group_Privacy_State *event, non_null() Bin_Pack *bp); -bool tox_event_group_voice_state_pack(non_null() const Tox_Event_Group_Voice_State *event, non_null() Bin_Pack *bp); -bool tox_event_group_topic_lock_pack(non_null() const Tox_Event_Group_Topic_Lock *event, non_null() Bin_Pack *bp); -bool tox_event_group_peer_limit_pack(non_null() const Tox_Event_Group_Peer_Limit *event, non_null() Bin_Pack *bp); -bool tox_event_group_password_pack(non_null() const Tox_Event_Group_Password *event, non_null() Bin_Pack *bp); -bool tox_event_group_message_pack(non_null() const Tox_Event_Group_Message *event, non_null() Bin_Pack *bp); -bool tox_event_group_private_message_pack(non_null() const Tox_Event_Group_Private_Message *event, non_null() Bin_Pack *bp); -bool tox_event_group_custom_packet_pack(non_null() const Tox_Event_Group_Custom_Packet *event, non_null() Bin_Pack *bp); -bool tox_event_group_custom_private_packet_pack(non_null() const Tox_Event_Group_Custom_Private_Packet *event, non_null() Bin_Pack *bp); -bool tox_event_group_invite_pack(non_null() const Tox_Event_Group_Invite *event, non_null() Bin_Pack *bp); -bool tox_event_group_peer_join_pack(non_null() const Tox_Event_Group_Peer_Join *event, non_null() Bin_Pack *bp); -bool tox_event_group_peer_exit_pack(non_null() const Tox_Event_Group_Peer_Exit *event, non_null() Bin_Pack *bp); -bool tox_event_group_self_join_pack(non_null() const Tox_Event_Group_Self_Join *event, non_null() Bin_Pack *bp); -bool tox_event_group_join_fail_pack(non_null() const Tox_Event_Group_Join_Fail *event, non_null() Bin_Pack *bp); -bool tox_event_group_moderation_pack(non_null() const Tox_Event_Group_Moderation *event, non_null() Bin_Pack *bp); -bool tox_event_dht_nodes_response_pack(non_null() const Tox_Event_Dht_Nodes_Response *event, non_null() Bin_Pack *bp); +bool tox_event_conference_connected_pack(const Tox_Event_Conference_Connected *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_conference_invite_pack(const Tox_Event_Conference_Invite *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_conference_message_pack(const Tox_Event_Conference_Message *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_conference_peer_list_changed_pack(const Tox_Event_Conference_Peer_List_Changed *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_conference_peer_name_pack(const Tox_Event_Conference_Peer_Name *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_conference_title_pack(const Tox_Event_Conference_Title *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_file_chunk_request_pack(const Tox_Event_File_Chunk_Request *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_file_recv_chunk_pack(const Tox_Event_File_Recv_Chunk *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_file_recv_control_pack(const Tox_Event_File_Recv_Control *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_file_recv_pack(const Tox_Event_File_Recv *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_friend_connection_status_pack(const Tox_Event_Friend_Connection_Status *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_friend_lossless_packet_pack(const Tox_Event_Friend_Lossless_Packet *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_friend_lossy_packet_pack(const Tox_Event_Friend_Lossy_Packet *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_friend_message_pack(const Tox_Event_Friend_Message *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_friend_name_pack(const Tox_Event_Friend_Name *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_friend_read_receipt_pack(const Tox_Event_Friend_Read_Receipt *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_friend_request_pack(const Tox_Event_Friend_Request *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_friend_status_message_pack(const Tox_Event_Friend_Status_Message *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_friend_status_pack(const Tox_Event_Friend_Status *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_friend_typing_pack(const Tox_Event_Friend_Typing *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_self_connection_status_pack(const Tox_Event_Self_Connection_Status *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_peer_name_pack(const Tox_Event_Group_Peer_Name *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_peer_status_pack(const Tox_Event_Group_Peer_Status *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_topic_pack(const Tox_Event_Group_Topic *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_privacy_state_pack(const Tox_Event_Group_Privacy_State *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_voice_state_pack(const Tox_Event_Group_Voice_State *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_topic_lock_pack(const Tox_Event_Group_Topic_Lock *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_peer_limit_pack(const Tox_Event_Group_Peer_Limit *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_password_pack(const Tox_Event_Group_Password *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_message_pack(const Tox_Event_Group_Message *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_private_message_pack(const Tox_Event_Group_Private_Message *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_custom_packet_pack(const Tox_Event_Group_Custom_Packet *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_custom_private_packet_pack(const Tox_Event_Group_Custom_Private_Packet *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_invite_pack(const Tox_Event_Group_Invite *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_peer_join_pack(const Tox_Event_Group_Peer_Join *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_peer_exit_pack(const Tox_Event_Group_Peer_Exit *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_self_join_pack(const Tox_Event_Group_Self_Join *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_join_fail_pack(const Tox_Event_Group_Join_Fail *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_group_moderation_pack(const Tox_Event_Group_Moderation *_Nonnull event, Bin_Pack *_Nonnull bp); +bool tox_event_dht_nodes_response_pack(const Tox_Event_Dht_Nodes_Response *_Nonnull event, Bin_Pack *_Nonnull bp); /** * Unpack from msgpack. */ -bool tox_event_unpack_into(non_null() Tox_Event *event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); +bool tox_event_unpack_into(Tox_Event *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); -bool tox_event_conference_connected_unpack(non_null() Tox_Event_Conference_Connected **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_conference_invite_unpack(non_null() Tox_Event_Conference_Invite **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_conference_message_unpack(non_null() Tox_Event_Conference_Message **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_conference_peer_list_changed_unpack(non_null() Tox_Event_Conference_Peer_List_Changed **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_conference_peer_name_unpack(non_null() Tox_Event_Conference_Peer_Name **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_conference_title_unpack(non_null() Tox_Event_Conference_Title **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_file_chunk_request_unpack(non_null() Tox_Event_File_Chunk_Request **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_file_recv_chunk_unpack(non_null() Tox_Event_File_Recv_Chunk **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_file_recv_control_unpack(non_null() Tox_Event_File_Recv_Control **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_file_recv_unpack(non_null() Tox_Event_File_Recv **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_friend_connection_status_unpack(non_null() Tox_Event_Friend_Connection_Status **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_friend_lossless_packet_unpack(non_null() Tox_Event_Friend_Lossless_Packet **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_friend_lossy_packet_unpack(non_null() Tox_Event_Friend_Lossy_Packet **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_friend_message_unpack(non_null() Tox_Event_Friend_Message **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_friend_name_unpack(non_null() Tox_Event_Friend_Name **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_friend_read_receipt_unpack(non_null() Tox_Event_Friend_Read_Receipt **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_friend_request_unpack(non_null() Tox_Event_Friend_Request **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_friend_status_message_unpack(non_null() Tox_Event_Friend_Status_Message **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_friend_status_unpack(non_null() Tox_Event_Friend_Status **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_friend_typing_unpack(non_null() Tox_Event_Friend_Typing **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_self_connection_status_unpack(non_null() Tox_Event_Self_Connection_Status **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_peer_name_unpack(non_null() Tox_Event_Group_Peer_Name **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_peer_status_unpack(non_null() Tox_Event_Group_Peer_Status **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_topic_unpack(non_null() Tox_Event_Group_Topic **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_privacy_state_unpack(non_null() Tox_Event_Group_Privacy_State **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_voice_state_unpack(non_null() Tox_Event_Group_Voice_State **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_topic_lock_unpack(non_null() Tox_Event_Group_Topic_Lock **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_peer_limit_unpack(non_null() Tox_Event_Group_Peer_Limit **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_password_unpack(non_null() Tox_Event_Group_Password **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_message_unpack(non_null() Tox_Event_Group_Message **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_private_message_unpack(non_null() Tox_Event_Group_Private_Message **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_custom_packet_unpack(non_null() Tox_Event_Group_Custom_Packet **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_custom_private_packet_unpack(non_null() Tox_Event_Group_Custom_Private_Packet **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_invite_unpack(non_null() Tox_Event_Group_Invite **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_peer_join_unpack(non_null() Tox_Event_Group_Peer_Join **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_peer_exit_unpack(non_null() Tox_Event_Group_Peer_Exit **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_self_join_unpack(non_null() Tox_Event_Group_Self_Join **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_join_fail_unpack(non_null() Tox_Event_Group_Join_Fail **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_group_moderation_unpack(non_null() Tox_Event_Group_Moderation **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); -bool tox_event_dht_nodes_response_unpack(non_null() Tox_Event_Dht_Nodes_Response **event, non_null() Bin_Unpack *bu, non_null() const Memory *mem); +bool tox_event_conference_connected_unpack(Tox_Event_Conference_Connected *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_conference_invite_unpack(Tox_Event_Conference_Invite *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_conference_message_unpack(Tox_Event_Conference_Message *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_conference_peer_list_changed_unpack(Tox_Event_Conference_Peer_List_Changed *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_conference_peer_name_unpack(Tox_Event_Conference_Peer_Name *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_conference_title_unpack(Tox_Event_Conference_Title *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_file_chunk_request_unpack(Tox_Event_File_Chunk_Request *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_file_recv_chunk_unpack(Tox_Event_File_Recv_Chunk *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_file_recv_control_unpack(Tox_Event_File_Recv_Control *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_file_recv_unpack(Tox_Event_File_Recv *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_friend_connection_status_unpack(Tox_Event_Friend_Connection_Status *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_friend_lossless_packet_unpack(Tox_Event_Friend_Lossless_Packet *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_friend_lossy_packet_unpack(Tox_Event_Friend_Lossy_Packet *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_friend_message_unpack(Tox_Event_Friend_Message *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_friend_name_unpack(Tox_Event_Friend_Name *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_friend_read_receipt_unpack(Tox_Event_Friend_Read_Receipt *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_friend_request_unpack(Tox_Event_Friend_Request *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_friend_status_message_unpack(Tox_Event_Friend_Status_Message *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_friend_status_unpack(Tox_Event_Friend_Status *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_friend_typing_unpack(Tox_Event_Friend_Typing *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_self_connection_status_unpack(Tox_Event_Self_Connection_Status *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_peer_name_unpack(Tox_Event_Group_Peer_Name *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_peer_status_unpack(Tox_Event_Group_Peer_Status *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_topic_unpack(Tox_Event_Group_Topic *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_privacy_state_unpack(Tox_Event_Group_Privacy_State *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_voice_state_unpack(Tox_Event_Group_Voice_State *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_topic_lock_unpack(Tox_Event_Group_Topic_Lock *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_peer_limit_unpack(Tox_Event_Group_Peer_Limit *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_password_unpack(Tox_Event_Group_Password *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_message_unpack(Tox_Event_Group_Message *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_private_message_unpack(Tox_Event_Group_Private_Message *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_custom_packet_unpack(Tox_Event_Group_Custom_Packet *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_custom_private_packet_unpack(Tox_Event_Group_Custom_Private_Packet *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_invite_unpack(Tox_Event_Group_Invite *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_peer_join_unpack(Tox_Event_Group_Peer_Join *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_peer_exit_unpack(Tox_Event_Group_Peer_Exit *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_self_join_unpack(Tox_Event_Group_Self_Join *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_join_fail_unpack(Tox_Event_Group_Join_Fail *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_group_moderation_unpack(Tox_Event_Group_Moderation *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); +bool tox_event_dht_nodes_response_unpack(Tox_Event_Dht_Nodes_Response *_Nonnull *_Nonnull event, Bin_Unpack *_Nonnull bu, const Memory *_Nonnull mem); #ifdef __cplusplus } /* extern "C" */ diff --git a/toxcore/tox_events.c b/toxcore/tox_events.c index 62c4fdc55..05aae5a54 100644 --- a/toxcore/tox_events.c +++ b/toxcore/tox_events.c @@ -74,7 +74,7 @@ uint32_t tox_events_get_size(const Tox_Events *events) return events == nullptr ? 0 : events->events_size; } -static const Tox_Event *tox_events_get_events(nullable() const Tox_Events *events) +static const Tox_Event *tox_events_get_events(const Tox_Events *_Nullable events) { return events == nullptr ? nullptr : events->events; } @@ -106,14 +106,14 @@ Tox_Events *tox_events_iterate(Tox *tox, bool fail_hard, Tox_Err_Events_Iterate return state.events; } -static bool tox_event_pack_handler(non_null() const void *arr, uint32_t index, non_null() const Logger *logger, non_null() Bin_Pack *bp) +static bool tox_event_pack_handler(const void *_Nonnull arr, uint32_t index, const Logger *_Nonnull logger, Bin_Pack *_Nonnull bp) { const Tox_Event *events = (const Tox_Event *)arr; assert(events != nullptr); return tox_event_pack(&events[index], bp); } -static bool tox_events_pack_handler(nullable() const void *obj, nullable() const Logger *logger, non_null() Bin_Pack *bp) +static bool tox_events_pack_handler(const void *_Nullable obj, const Logger *_Nullable logger, Bin_Pack *_Nonnull bp) { const Tox_Events *events = (const Tox_Events *)obj; return bin_pack_obj_array(bp, tox_event_pack_handler, tox_events_get_events(events), tox_events_get_size(events), logger); @@ -129,7 +129,7 @@ bool tox_events_get_bytes(const Tox_Events *events, uint8_t *bytes) return bin_pack_obj(tox_events_pack_handler, events, nullptr, bytes, UINT32_MAX); } -static bool tox_events_unpack_handler(non_null() void *obj, non_null() Bin_Unpack *bu) +static bool tox_events_unpack_handler(void *_Nonnull obj, Bin_Unpack *_Nonnull bu) { Tox_Events *events = (Tox_Events *)obj; diff --git a/toxcore/tox_pack.h b/toxcore/tox_pack.h index ac80376b7..56ef94deb 100644 --- a/toxcore/tox_pack.h +++ b/toxcore/tox_pack.h @@ -9,16 +9,16 @@ #include "bin_pack.h" #include "tox.h" -bool tox_conference_type_pack(Tox_Conference_Type val, non_null() Bin_Pack *bp); -bool tox_connection_pack(Tox_Connection val, non_null() Bin_Pack *bp); -bool tox_file_control_pack(Tox_File_Control val, non_null() Bin_Pack *bp); -bool tox_message_type_pack(Tox_Message_Type val, non_null() Bin_Pack *bp); -bool tox_user_status_pack(Tox_User_Status val, non_null() Bin_Pack *bp); -bool tox_group_privacy_state_pack(Tox_Group_Privacy_State val, non_null() Bin_Pack *bp); -bool tox_group_voice_state_pack(Tox_Group_Voice_State val, non_null() Bin_Pack *bp); -bool tox_group_topic_lock_pack(Tox_Group_Topic_Lock val, non_null() Bin_Pack *bp); -bool tox_group_join_fail_pack(Tox_Group_Join_Fail val, non_null() Bin_Pack *bp); -bool tox_group_mod_event_pack(Tox_Group_Mod_Event val, non_null() Bin_Pack *bp); -bool tox_group_exit_type_pack(Tox_Group_Exit_Type val, non_null() Bin_Pack *bp); +bool tox_conference_type_pack(Tox_Conference_Type val, Bin_Pack *_Nonnull bp); +bool tox_connection_pack(Tox_Connection val, Bin_Pack *_Nonnull bp); +bool tox_file_control_pack(Tox_File_Control val, Bin_Pack *_Nonnull bp); +bool tox_message_type_pack(Tox_Message_Type val, Bin_Pack *_Nonnull bp); +bool tox_user_status_pack(Tox_User_Status val, Bin_Pack *_Nonnull bp); +bool tox_group_privacy_state_pack(Tox_Group_Privacy_State val, Bin_Pack *_Nonnull bp); +bool tox_group_voice_state_pack(Tox_Group_Voice_State val, Bin_Pack *_Nonnull bp); +bool tox_group_topic_lock_pack(Tox_Group_Topic_Lock val, Bin_Pack *_Nonnull bp); +bool tox_group_join_fail_pack(Tox_Group_Join_Fail val, Bin_Pack *_Nonnull bp); +bool tox_group_mod_event_pack(Tox_Group_Mod_Event val, Bin_Pack *_Nonnull bp); +bool tox_group_exit_type_pack(Tox_Group_Exit_Type val, Bin_Pack *_Nonnull bp); #endif /* C_TOXCORE_TOXCORE_TOX_PACK_H */ diff --git a/toxcore/tox_unpack.c b/toxcore/tox_unpack.c index bc8b9fe54..cc52781b9 100644 --- a/toxcore/tox_unpack.c +++ b/toxcore/tox_unpack.c @@ -10,7 +10,7 @@ #include "bin_unpack.h" #include "tox.h" -static bool tox_conference_type_from_int(uint32_t value, non_null() Tox_Conference_Type *out_enum) +static bool tox_conference_type_from_int(uint32_t value, Tox_Conference_Type *_Nonnull out_enum) { switch (value) { case TOX_CONFERENCE_TYPE_TEXT: { @@ -36,7 +36,7 @@ bool tox_conference_type_unpack(Tox_Conference_Type *val, Bin_Unpack *bu) && tox_conference_type_from_int(u32, val); } -static bool tox_connection_from_int(uint32_t value, non_null() Tox_Connection *out_enum) +static bool tox_connection_from_int(uint32_t value, Tox_Connection *_Nonnull out_enum) { switch (value) { case TOX_CONNECTION_NONE: { @@ -68,7 +68,7 @@ bool tox_connection_unpack(Tox_Connection *val, Bin_Unpack *bu) && tox_connection_from_int(u32, val); } -static bool tox_file_control_from_int(uint32_t value, non_null() Tox_File_Control *out_enum) +static bool tox_file_control_from_int(uint32_t value, Tox_File_Control *_Nonnull out_enum) { switch (value) { case TOX_FILE_CONTROL_RESUME: { @@ -100,7 +100,7 @@ bool tox_file_control_unpack(Tox_File_Control *val, Bin_Unpack *bu) && tox_file_control_from_int(u32, val); } -static bool tox_message_type_from_int(uint32_t value, non_null() Tox_Message_Type *out_enum) +static bool tox_message_type_from_int(uint32_t value, Tox_Message_Type *_Nonnull out_enum) { switch (value) { case TOX_MESSAGE_TYPE_NORMAL: { @@ -127,7 +127,7 @@ bool tox_message_type_unpack(Tox_Message_Type *val, Bin_Unpack *bu) && tox_message_type_from_int(u32, val); } -static bool tox_user_status_from_int(uint32_t value, non_null() Tox_User_Status *out_enum) +static bool tox_user_status_from_int(uint32_t value, Tox_User_Status *_Nonnull out_enum) { switch (value) { case TOX_USER_STATUS_NONE: { @@ -159,7 +159,7 @@ bool tox_user_status_unpack(Tox_User_Status *val, Bin_Unpack *bu) && tox_user_status_from_int(u32, val); } -static bool tox_group_privacy_state_from_int(uint32_t value, non_null() Tox_Group_Privacy_State *out_enum) +static bool tox_group_privacy_state_from_int(uint32_t value, Tox_Group_Privacy_State *_Nonnull out_enum) { switch (value) { case TOX_GROUP_PRIVACY_STATE_PUBLIC: { @@ -182,7 +182,7 @@ bool tox_group_privacy_state_unpack(Tox_Group_Privacy_State *val, Bin_Unpack *bu return bin_unpack_u32(bu, &u32) && tox_group_privacy_state_from_int(u32, val); } -static bool tox_group_voice_state_from_int(uint32_t value, non_null() Tox_Group_Voice_State *out_enum) +static bool tox_group_voice_state_from_int(uint32_t value, Tox_Group_Voice_State *_Nonnull out_enum) { switch (value) { case TOX_GROUP_VOICE_STATE_ALL: { @@ -210,7 +210,7 @@ bool tox_group_voice_state_unpack(Tox_Group_Voice_State *val, Bin_Unpack *bu) && tox_group_voice_state_from_int(u32, val); } -static bool tox_group_topic_lock_from_int(uint32_t value, non_null() Tox_Group_Topic_Lock *out_enum) +static bool tox_group_topic_lock_from_int(uint32_t value, Tox_Group_Topic_Lock *_Nonnull out_enum) { switch (value) { case TOX_GROUP_TOPIC_LOCK_ENABLED: { @@ -234,7 +234,7 @@ bool tox_group_topic_lock_unpack(Tox_Group_Topic_Lock *val, Bin_Unpack *bu) && tox_group_topic_lock_from_int(u32, val); } -static bool tox_group_join_fail_from_int(uint32_t value, non_null() Tox_Group_Join_Fail *out_enum) +static bool tox_group_join_fail_from_int(uint32_t value, Tox_Group_Join_Fail *_Nonnull out_enum) { switch (value) { case TOX_GROUP_JOIN_FAIL_PEER_LIMIT: { @@ -262,7 +262,7 @@ bool tox_group_join_fail_unpack(Tox_Group_Join_Fail *val, Bin_Unpack *bu) && tox_group_join_fail_from_int(u32, val); } -static bool tox_group_mod_event_from_int(uint32_t value, non_null() Tox_Group_Mod_Event *out_enum) +static bool tox_group_mod_event_from_int(uint32_t value, Tox_Group_Mod_Event *_Nonnull out_enum) { switch (value) { case TOX_GROUP_MOD_EVENT_KICK: { @@ -294,7 +294,7 @@ bool tox_group_mod_event_unpack(Tox_Group_Mod_Event *val, Bin_Unpack *bu) && tox_group_mod_event_from_int(u32, val); } -static bool tox_group_exit_type_from_int(uint32_t value, non_null() Tox_Group_Exit_Type *out_enum) +static bool tox_group_exit_type_from_int(uint32_t value, Tox_Group_Exit_Type *_Nonnull out_enum) { switch (value) { case TOX_GROUP_EXIT_TYPE_QUIT: { diff --git a/toxcore/tox_unpack.h b/toxcore/tox_unpack.h index c56276752..b9b885b18 100644 --- a/toxcore/tox_unpack.h +++ b/toxcore/tox_unpack.h @@ -9,16 +9,16 @@ #include "bin_unpack.h" #include "tox.h" -bool tox_conference_type_unpack(non_null() Tox_Conference_Type *val, non_null() Bin_Unpack *bu); -bool tox_connection_unpack(non_null() Tox_Connection *val, non_null() Bin_Unpack *bu); -bool tox_file_control_unpack(non_null() Tox_File_Control *val, non_null() Bin_Unpack *bu); -bool tox_message_type_unpack(non_null() Tox_Message_Type *val, non_null() Bin_Unpack *bu); -bool tox_user_status_unpack(non_null() Tox_User_Status *val, non_null() Bin_Unpack *bu); -bool tox_group_privacy_state_unpack(non_null() Tox_Group_Privacy_State *val, non_null() Bin_Unpack *bu); -bool tox_group_voice_state_unpack(non_null() Tox_Group_Voice_State *val, non_null() Bin_Unpack *bu); -bool tox_group_topic_lock_unpack(non_null() Tox_Group_Topic_Lock *val, non_null() Bin_Unpack *bu); -bool tox_group_join_fail_unpack(non_null() Tox_Group_Join_Fail *val, non_null() Bin_Unpack *bu); -bool tox_group_mod_event_unpack(non_null() Tox_Group_Mod_Event *val, non_null() Bin_Unpack *bu); -bool tox_group_exit_type_unpack(non_null() Tox_Group_Exit_Type *val, non_null() Bin_Unpack *bu); +bool tox_conference_type_unpack(Tox_Conference_Type *_Nonnull val, Bin_Unpack *_Nonnull bu); +bool tox_connection_unpack(Tox_Connection *_Nonnull val, Bin_Unpack *_Nonnull bu); +bool tox_file_control_unpack(Tox_File_Control *_Nonnull val, Bin_Unpack *_Nonnull bu); +bool tox_message_type_unpack(Tox_Message_Type *_Nonnull val, Bin_Unpack *_Nonnull bu); +bool tox_user_status_unpack(Tox_User_Status *_Nonnull val, Bin_Unpack *_Nonnull bu); +bool tox_group_privacy_state_unpack(Tox_Group_Privacy_State *_Nonnull val, Bin_Unpack *_Nonnull bu); +bool tox_group_voice_state_unpack(Tox_Group_Voice_State *_Nonnull val, Bin_Unpack *_Nonnull bu); +bool tox_group_topic_lock_unpack(Tox_Group_Topic_Lock *_Nonnull val, Bin_Unpack *_Nonnull bu); +bool tox_group_join_fail_unpack(Tox_Group_Join_Fail *_Nonnull val, Bin_Unpack *_Nonnull bu); +bool tox_group_mod_event_unpack(Tox_Group_Mod_Event *_Nonnull val, Bin_Unpack *_Nonnull bu); +bool tox_group_exit_type_unpack(Tox_Group_Exit_Type *_Nonnull val, Bin_Unpack *_Nonnull bu); #endif /* C_TOXCORE_TOXCORE_TOX_UNPACK_H */ diff --git a/toxcore/util.h b/toxcore/util.h index ca16a184b..179616b84 100644 --- a/toxcore/util.h +++ b/toxcore/util.h @@ -25,9 +25,9 @@ extern "C" { bool is_power_of_2(uint64_t x); /** @brief Frees all pointers in a uint8_t pointer array, as well as the array itself. */ -void free_uint8_t_pointer_array(non_null() const Memory *mem, nullable() uint8_t **ary, size_t n_items); +void free_uint8_t_pointer_array(const Memory *_Nonnull mem, uint8_t *_Nullable *_Nullable ary, size_t n_items); /** Returns -1 if failed or 0 if success */ -int create_recursive_mutex(non_null() pthread_mutex_t *mutex); +int create_recursive_mutex(pthread_mutex_t *_Nonnull mutex); /** * @brief Checks whether two buffers are the same length and contents. @@ -37,14 +37,14 @@ int create_recursive_mutex(non_null() pthread_mutex_t *mutex); * @retval true if sizes and contents are equal. * @retval false otherwise. */ -bool memeq(non_null() const uint8_t *a, size_t a_size, non_null() const uint8_t *b, size_t b_size); +bool memeq(const uint8_t *_Nonnull a, size_t a_size, const uint8_t *_Nonnull b, size_t b_size); /** * @brief Copies a byte array of a given size into a newly allocated one. * * @return nullptr on allocation failure or if the input data was nullptr or data_size was 0. */ -uint8_t *memdup(non_null() const Memory *mem, nullable() const uint8_t *data, size_t data_size); +uint8_t *_Nullable memdup(const Memory *_Nonnull mem, const uint8_t *_Nullable data, size_t data_size); /** * @brief Set all bytes in `data` to 0. @@ -54,7 +54,7 @@ uint8_t *memdup(non_null() const Memory *mem, nullable() const uint8_t *data, si * message buffers, public keys, encrypted data, etc. It is not ok for buffers * containing key material (secret keys, shared keys). */ -void memzero(nullable() uint8_t *data, size_t data_size); +void memzero(uint8_t *_Nullable data, size_t data_size); // Safe min/max functions with specific types. This forces the conversion to the // desired type before the comparison expression, giving the choice of @@ -86,7 +86,7 @@ uint64_t min_u64(uint64_t a, uint64_t b); int cmp_uint(uint64_t a, uint64_t b); /** @brief Returns a 32-bit hash of key of size len */ -uint32_t jenkins_one_at_a_time_hash(non_null() const uint8_t *key, size_t len); +uint32_t jenkins_one_at_a_time_hash(const uint8_t *_Nonnull key, size_t len); /** @brief Computes a checksum of a byte array. * @@ -95,7 +95,7 @@ uint32_t jenkins_one_at_a_time_hash(non_null() const uint8_t *key, size_t len); * * @retval The resulting checksum. */ -uint16_t data_checksum(non_null() const uint8_t *data, uint32_t length); +uint16_t data_checksum(const uint8_t *_Nonnull data, uint32_t length); #ifdef __cplusplus } /* extern "C" */