]> git.meshlink.io Git - meshlink-tiny/blob - src/meshlink_internal.h
Remove the blackbox test suite.
[meshlink-tiny] / src / meshlink_internal.h
1 #ifndef MESHLINK_INTERNAL_H
2 #define MESHLINK_INTERNAL_H
3
4 /*
5     meshlink_internal.h -- Internal parts of the public API.
6     Copyright (C) 2014-2019 Guus Sliepen <guus@meshlink.io>
7
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.
12
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.
17
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.
21 */
22
23 #ifdef MESHLINK_H
24 #error You must not include both meshlink-tiny.h and meshlink_internal.h!
25 #endif
26
27 #include "system.h"
28
29 #include "event.h"
30 #include "hash.h"
31 #include "meshlink-tiny.h"
32 #include "meshlink_queue.h"
33 #include "sockaddr.h"
34 #include "sptps.h"
35 #include "xoshiro.h"
36
37 #include <pthread.h>
38
39 #define MAXSOCKETS 4    /* Probably overkill... */
40
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";
44
45 #define MESHLINK_CONFIG_VERSION 2
46 #define MESHLINK_INVITATION_VERSION 2
47
48 #define CORE_MESH "."
49
50 struct meshlink_open_params {
51         char *confbase;
52         char *lock_filename;
53         char *appname;
54         char *name;
55         dev_class_t devclass;
56
57         int netns;
58
59         const void *key;
60         size_t keylen;
61         meshlink_storage_policy_t storage_policy;
62 };
63
64 /// Device class traits
65 typedef struct {
66         int pinginterval;
67         int pingtimeout;
68         int fast_retry_period;
69         int maxtimeout;
70         unsigned int min_connects;
71         unsigned int max_connects;
72         int edge_weight;
73 } dev_class_traits_t;
74
75 /// A handle for an instance of MeshLink.
76 struct meshlink_handle {
77         // public members
78         char *name;
79         void *priv;
80
81         // private members
82         pthread_mutex_t mutex;
83         event_loop_t loop;
84         struct node_t *self;
85         meshlink_log_cb_t log_cb;
86         meshlink_log_level_t log_level;
87         void *packet;
88
89         // The most important network-related members come first
90         int reachable;
91
92         meshlink_receive_cb_t receive_cb;
93         meshlink_queue_t outpacketqueue;
94         signal_t datafromapp;
95
96         struct node_t *peer;
97         struct connection_t *connection;
98         struct outgoing_t *outgoing;
99
100         int contradicting_add_edge;
101         int contradicting_del_edge;
102         int sleeptime;
103         time_t last_unreachable;
104         timeout_t pingtimer;
105         timeout_t periodictimer;
106
107         struct connection_t *everyone;
108         uint64_t prng_state[4];
109         uint32_t session_id;
110
111         // Infrequently used callbacks
112         meshlink_node_status_cb_t node_status_cb;
113         meshlink_node_status_cb_t meta_status_cb;
114         meshlink_node_duplicate_cb_t node_duplicate_cb;
115         meshlink_connection_try_cb_t connection_try_cb;
116         meshlink_error_cb_t error_cb;
117
118         // Mesh parameters
119         char *appname;
120         char *myport;
121
122         struct ecdsa *private_key;
123
124         dev_class_t devclass;
125
126         dev_class_traits_t dev_class_traits[DEV_CLASS_COUNT];
127
128         int netns;
129
130         bool inviter_commits_first;
131
132         // Configuration
133         char *confbase;
134         FILE *lockfile;
135         void *config_key;
136         char *external_address_url;
137         meshlink_storage_policy_t storage_policy;
138
139         // Thread management
140         pthread_t thread;
141         pthread_cond_t cond;
142         bool threadstarted;
143 };
144
145 /// A handle for a MeshLink node.
146 struct meshlink_node {
147         const char *name;
148         void *priv;
149 };
150
151 void meshlink_send_from_queue(event_loop_t *loop, void *mesh);
152 void update_node_status(meshlink_handle_t *mesh, struct node_t *n);
153 extern meshlink_log_level_t global_log_level;
154 extern meshlink_log_cb_t global_log_cb;
155 void handle_duplicate_node(meshlink_handle_t *mesh, struct node_t *n);
156 void handle_network_change(meshlink_handle_t *mesh, bool online);
157 void call_error_cb(meshlink_handle_t *mesh, meshlink_errno_t meshlink_errno);
158
159 /// Per-instance PRNG
160 static inline int prng(meshlink_handle_t *mesh, uint64_t max) {
161         return xoshiro(mesh->prng_state) % max;
162 }
163
164 /// Fudge value of ~0.1 seconds, in microseconds.
165 static const unsigned int TIMER_FUDGE = 0x8000000;
166
167 #endif