git.meshlink.io Git - meshlink/blob - 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.h and meshlink_internal.h!
  25 #endif
  26
  27 #include "system.h"
  28
  29 #include "event.h"
  30 #include "hash.h"
  31 #include "meshlink.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 typedef struct listen_socket_t {
  49         struct io_t tcp;
  50         struct io_t udp;
  51         sockaddr_t sa;
  52         sockaddr_t broadcast_sa;
  53 } listen_socket_t;
  54
  55 struct meshlink_open_params {
  56         char *confbase;
  57         char *lock_filename;
  58         char *appname;
  59         char *name;
  60         dev_class_t devclass;
  61
  62         int netns;
  63
  64         const void *key;
  65         size_t keylen;
  66         meshlink_storage_policy_t storage_policy;
  67         meshlink_load_cb_t load_cb;
  68         meshlink_store_cb_t store_cb;
  69         meshlink_ls_cb_t ls_cb;
  70 };
  71
  72 /// Device class traits
  73 typedef struct {
  74         int pinginterval;
  75         int pingtimeout;
  76         int fast_retry_period;
  77         int maxtimeout;
  78         unsigned int min_connects;
  79         unsigned int max_connects;
  80         int edge_weight;
  81 } dev_class_traits_t;
  82
  83 /// A handle for an instance of MeshLink.
  84 struct meshlink_handle {
  85         // public members
  86         char *name;
  87         void *priv;
  88
  89         // private members
  90         pthread_mutex_t mutex;
  91         event_loop_t loop;
  92         struct node_t *self;
  93         meshlink_log_cb_t log_cb;
  94         meshlink_log_level_t log_level;
  95         void *packet;
  96
  97         // The most important network-related members come first
  98         int reachable;
  99         int listen_sockets;
 100         listen_socket_t listen_socket[MAXSOCKETS];
 101
 102         meshlink_receive_cb_t receive_cb;
 103         meshlink_queue_t outpacketqueue;
 104         signal_t datafromapp;
 105
 106         hash_t *node_udp_cache;
 107
 108         struct splay_tree_t *nodes;
 109         struct splay_tree_t *edges;
 110
 111         struct list_t *connections;
 112         struct list_t *outgoings;
 113         struct list_t *submeshes;
 114
 115         // Meta-connection-related members
 116         struct splay_tree_t *past_request_tree;
 117         timeout_t past_request_timeout;
 118
 119         int connection_burst;
 120         int contradicting_add_edge;
 121         int contradicting_del_edge;
 122         int sleeptime;
 123         time_t connection_burst_time;
 124         time_t last_hard_try;
 125         time_t last_unreachable;
 126         timeout_t pingtimer;
 127         timeout_t periodictimer;
 128
 129         struct connection_t *everyone;
 130         uint64_t prng_state[4];
 131         uint32_t session_id;
 132
 133         int next_pit;
 134         int pits[10];
 135
 136         // Infrequently used callbacks
 137         meshlink_node_status_cb_t node_status_cb;
 138         meshlink_node_status_cb_t meta_status_cb;
 139         meshlink_node_pmtu_cb_t node_pmtu_cb;
 140         meshlink_channel_listen_cb_t channel_listen_cb;
 141         meshlink_channel_accept_cb_t channel_accept_cb;
 142         meshlink_node_duplicate_cb_t node_duplicate_cb;
 143         meshlink_connection_try_cb_t connection_try_cb;
 144         meshlink_error_cb_t error_cb;
 145         meshlink_blacklisted_cb_t blacklisted_cb;
 146         meshlink_thread_status_cb_t thread_status_cb;
 147
 148         // Mesh parameters
 149         char *appname;
 150         char *myport;
 151
 152         struct ecdsa *private_key;
 153         struct ecdsa *invitation_key;
 154
 155         dev_class_t devclass;
 156
 157         int invitation_timeout;
 158         int udp_choice;
 159
 160         dev_class_traits_t dev_class_traits[DEV_CLASS_COUNT];
 161
 162         int netns;
 163
 164         bool default_blacklist;
 165         bool inviter_commits_first;
 166
 167         // Configuration
 168         char *confbase;
 169         FILE *lockfile;
 170         void *config_key;
 171         char *external_address_url;
 172         struct list_t *invitation_addresses;
 173         meshlink_storage_policy_t storage_policy;
 174         meshlink_load_cb_t load_cb;
 175         meshlink_store_cb_t store_cb;
 176         meshlink_ls_cb_t ls_cb;
 177
 178         void *ls_priv;
 179
 180         // Thread management
 181         pthread_t thread;
 182         pthread_cond_t cond;
 183         bool threadstarted;
 184
 185         // mDNS discovery
 186         struct {
 187                 bool enabled;
 188                 io_t pfroute_io;
 189                 int *ifaces;
 190                 struct discovery_address *addresses;
 191                 int iface_count;
 192                 int address_count;
 193                 io_t sockets[2];
 194                 time_t last_update;
 195 #ifdef __APPLE__
 196                 pthread_t thread;
 197                 void *runloop;
 198 #endif
 199         } discovery;
 200
 201         // ADNS
 202         pthread_t adns_thread;
 203         pthread_cond_t adns_cond;
 204         meshlink_queue_t adns_queue;
 205         meshlink_queue_t adns_done_queue;
 206         signal_t adns_signal;
 207 };
 208
 209 /// A handle for a MeshLink node.
 210 struct meshlink_node {
 211         const char *name;
 212         void *priv;
 213 };
 214
 215 /// A handle for a node Sub-Mesh.
 216 struct meshlink_submesh {
 217         const char *name;
 218         void *priv;
 219 };
 220
 221 /// An AIO buffer.
 222 typedef struct meshlink_aio_buffer {
 223         const void *data;
 224         int fd;
 225         size_t len;
 226         size_t done;
 227         union {
 228                 meshlink_aio_cb_t buffer;
 229                 meshlink_aio_fd_cb_t fd;
 230         } cb;
 231         void *priv;
 232         struct meshlink_aio_buffer *next;
 233 } meshlink_aio_buffer_t;
 234
 235 /// A channel.
 236 struct meshlink_channel {
 237         struct node_t *node;
 238         void *priv;
 239         bool in_callback;
 240
 241         struct utcp_connection *c;
 242         meshlink_aio_buffer_t *aio_send;
 243         meshlink_aio_buffer_t *aio_receive;
 244         meshlink_channel_receive_cb_t receive_cb;
 245         meshlink_channel_poll_cb_t poll_cb;
 246 };
 247
 248 /// Header for data packets routed between nodes
 249 typedef struct meshlink_packethdr {
 250         uint8_t destination[16];
 251         uint8_t source[16];
 252 } __attribute__((__packed__)) meshlink_packethdr_t;
 253
 254 void meshlink_send_from_queue(event_loop_t *loop, void *mesh);
 255 void update_node_status(meshlink_handle_t *mesh, struct node_t *n);
 256 void update_node_pmtu(meshlink_handle_t *mesh, struct node_t *n);
 257 extern meshlink_log_level_t global_log_level;
 258 extern meshlink_log_cb_t global_log_cb;
 259 void handle_duplicate_node(meshlink_handle_t *mesh, struct node_t *n);
 260 void handle_network_change(meshlink_handle_t *mesh, bool online);
 261 void call_error_cb(meshlink_handle_t *mesh, meshlink_errno_t meshlink_errno);
 262 void channel_receive(meshlink_handle_t *mesh, meshlink_node_t *node, const void *data, size_t len);
 263
 264 /// Per-instance PRNG
 265 static inline int prng(meshlink_handle_t *mesh, uint64_t max) {
 266         return xoshiro(mesh->prng_state) % max;
 267 }
 268
 269 /// Fudge value of ~0.1 seconds, in microseconds.
 270 static const unsigned int TIMER_FUDGE = 0x8000000;
 271
 272 #endif