1 #ifndef MESHLINK_INTERNAL_H
2 #define MESHLINK_INTERNAL_H
5 meshlink_internal.h -- Internal parts of the public API.
6 Copyright (C) 2014-2019 Guus Sliepen <guus@meshlink.io>
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License along
19 with this program; if not, write to the Free Software Foundation, Inc.,
20 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
24 #error You must not include both meshlink-tiny.h and meshlink_internal.h!
31 #include "meshlink-tiny.h"
32 #include "meshlink_queue.h"
39 #define MAXSOCKETS 4 /* Probably overkill... */
41 static const char meshlink_invitation_label[] = "MeshLink invitation";
42 static const char meshlink_tcp_label[] = "MeshLink TCP";
43 static const char meshlink_udp_label[] = "MeshLink UDP";
45 #define MESHLINK_CONFIG_VERSION 2
46 #define MESHLINK_INVITATION_VERSION 2
50 struct meshlink_open_params {
61 meshlink_storage_policy_t storage_policy;
62 meshlink_load_cb_t load_cb;
63 meshlink_store_cb_t store_cb;
64 meshlink_ls_cb_t ls_cb;
67 /// Device class traits
71 int fast_retry_period;
73 unsigned int min_connects;
74 unsigned int max_connects;
78 /// A handle for an instance of MeshLink.
79 struct meshlink_handle {
85 pthread_mutex_t mutex;
88 meshlink_log_cb_t log_cb;
89 meshlink_log_level_t log_level;
92 // The most important network-related members come first
95 meshlink_receive_cb_t receive_cb;
96 meshlink_queue_t outpacketqueue;
100 struct connection_t *connection;
101 struct outgoing_t *outgoing;
103 int contradicting_add_edge;
104 int contradicting_del_edge;
106 time_t last_unreachable;
108 timeout_t periodictimer;
110 struct connection_t *everyone;
111 uint64_t prng_state[4];
114 // Infrequently used callbacks
115 meshlink_node_status_cb_t node_status_cb;
116 meshlink_node_status_cb_t meta_status_cb;
117 meshlink_node_duplicate_cb_t node_duplicate_cb;
118 meshlink_connection_try_cb_t connection_try_cb;
119 meshlink_error_cb_t error_cb;
125 struct ecdsa *private_key;
127 dev_class_t devclass;
129 dev_class_traits_t dev_class_traits[DEV_CLASS_COUNT];
133 bool inviter_commits_first;
139 char *external_address_url;
140 meshlink_storage_policy_t storage_policy;
141 meshlink_load_cb_t load_cb;
142 meshlink_store_cb_t store_cb;
143 meshlink_ls_cb_t ls_cb;
145 void *config_new_key;
153 /// A handle for a MeshLink node.
154 struct meshlink_node {
159 void meshlink_send_from_queue(event_loop_t *loop, void *mesh);
160 void update_node_status(meshlink_handle_t *mesh, struct node_t *n);
161 extern meshlink_log_level_t global_log_level;
162 extern meshlink_log_cb_t global_log_cb;
163 void handle_duplicate_node(meshlink_handle_t *mesh, struct node_t *n);
164 void handle_network_change(meshlink_handle_t *mesh, bool online);
165 void call_error_cb(meshlink_handle_t *mesh, meshlink_errno_t meshlink_errno);
167 /// Per-instance PRNG
168 static inline int prng(meshlink_handle_t *mesh, uint64_t max) {
169 return xoshiro(mesh->prng_state) % max;
172 /// Fudge value of ~0.1 seconds, in microseconds.
173 static const unsigned int TIMER_FUDGE = 0x8000000;