uint16_t minmtu;
uint16_t maxmtu;
int mtuprobes;
+
enum {
DEVTOOL_UDP_FAILED = -2, /// UDP tried but failed
DEVTOOL_UDP_IMPOSSIBLE = -1, /// UDP not possible (node unreachable)
DEVTOOL_UDP_TRYING, /// UDP detection in progress
DEVTOOL_UDP_WORKING, /// UDP communication established
} udp_status;
- uint64_t in_packets;
- uint64_t in_bytes;
- uint64_t out_packets;
- uint64_t out_bytes;
+
+ uint64_t in_data; /// Bytes received from channels
+ uint64_t out_data; /// Bytes sent via channels
+ uint64_t in_forward; /// Bytes received for channels that need to be forwarded to other nodes
+ uint64_t out_forward; /// Bytes forwarded from channel from other nodes
+ uint64_t in_meta; /// Bytes received from meta-connections, heartbeat packets etc.
+ uint64_t out_meta; /// Bytes sent on meta-connections, heartbeat packets etc.
};
/// Get the status of a node.
*/
void devtool_get_node_status(meshlink_handle_t *mesh, meshlink_node_t *node, devtool_node_status_t *status);
+/// Reset the traffic counters of a node.
+/** This function resets the byte counters for the given node to zero.
+ * It also returns the status containing the counters right before they are zeroed.
+ *
+ * @param mesh A handle which represents an instance of MeshLink.
+ * @param node A pointer to a meshlink_node_t.
+ * @param status A pointer to a devtools_node_status_t variable that has
+ * to be provided by the caller.
+ * The contents of this variable will be changed to reflect
+ * the current status of the node before the counters are zeroed.
+ * If a NULL pointers is passed, no status will be written.
+ */
+void devtool_reset_node_counters(meshlink_handle_t *mesh, meshlink_node_t *node, devtool_node_status_t *status);
+
/// Get the list of all submeshes of a meshlink instance.
/** This function returns an array of submesh handles.
* These pointers are the same pointers that are present in the submeshes list
*/
extern void (*devtool_set_inviter_commits_first)(bool inviter_commited_first);
+/// Set the meta-connection status callback.
+/** This functions sets the callback that is called whenever a meta-connection is made or closed.
+ * The callback is run in MeshLink's own thread.
+ * It is therefore important that the callback uses apprioriate methods (queues, pipes, locking, etc.)
+ * to hand the data over to the application's thread.
+ * The callback should also not block itself and return as quickly as possible.
+ *
+ * \memberof meshlink_handle
+ * @param mesh A handle which represents an instance of MeshLink.
+ * @param cb A pointer to the function which will be called when a node's meta-connection status changes.
+ * If a NULL pointer is given, the callback will be disabled.
+ */
+void devtool_set_meta_status_cb(struct meshlink_handle *mesh, meshlink_node_status_cb_t cb);
+
#endif