]> git.meshlink.io Git - meshlink-tiny/blob - src/meshlink_internal.h
Use a key/value store with configurable storage callbacks.
[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         meshlink_load_cb_t load_cb;
63         meshlink_store_cb_t store_cb;
64         meshlink_ls_cb_t ls_cb;
65 };
66
67 /// Device class traits
68 typedef struct {
69         int pinginterval;
70         int pingtimeout;
71         int fast_retry_period;
72         int maxtimeout;
73         unsigned int min_connects;
74         unsigned int max_connects;
75         int edge_weight;
76 } dev_class_traits_t;
77
78 /// A handle for an instance of MeshLink.
79 struct meshlink_handle {
80         // public members
81         char *name;
82         void *priv;
83
84         // private members
85         pthread_mutex_t mutex;
86         event_loop_t loop;
87         struct node_t *self;
88         meshlink_log_cb_t log_cb;
89         meshlink_log_level_t log_level;
90         void *packet;
91
92         // The most important network-related members come first
93         int reachable;
94
95         meshlink_receive_cb_t receive_cb;
96         meshlink_queue_t outpacketqueue;
97         signal_t datafromapp;
98
99         struct node_t *peer;
100         struct connection_t *connection;
101         struct outgoing_t *outgoing;
102
103         int contradicting_add_edge;
104         int contradicting_del_edge;
105         int sleeptime;
106         time_t last_unreachable;
107         timeout_t pingtimer;
108         timeout_t periodictimer;
109
110         struct connection_t *everyone;
111         uint64_t prng_state[4];
112         uint32_t session_id;
113
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;
120
121         // Mesh parameters
122         char *appname;
123         char *myport;
124
125         struct ecdsa *private_key;
126
127         dev_class_t devclass;
128
129         dev_class_traits_t dev_class_traits[DEV_CLASS_COUNT];
130
131         int netns;
132
133         bool inviter_commits_first;
134
135         // Configuration
136         char *confbase;
137         FILE *lockfile;
138         void *config_key;
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;
144
145         void *config_new_key;
146
147         // Thread management
148         pthread_t thread;
149         pthread_cond_t cond;
150         bool threadstarted;
151 };
152
153 /// A handle for a MeshLink node.
154 struct meshlink_node {
155         const char *name;
156         void *priv;
157 };
158
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);
166
167 /// Per-instance PRNG
168 static inline int prng(meshlink_handle_t *mesh, uint64_t max) {
169         return xoshiro(mesh->prng_state) % max;
170 }
171
172 /// Fudge value of ~0.1 seconds, in microseconds.
173 static const unsigned int TIMER_FUDGE = 0x8000000;
174
175 #endif