/// Code of most recent error encountered.
typedef enum {
MESHLINK_OK, ///< Everything is fine
+ MESHLINK_EINVAL, ///< Invalid parameter(s) to function call
MESHLINK_ENOMEM, ///< Out of memory
MESHLINK_ENOENT, ///< Node is not known
+ MESHLINK_EEXIST, ///< Node already exists
+ MESHLINK_EINTERNAL, ///< MeshLink internal error
+ MESHLINK_ERESOLV, ///< MeshLink could not resolve a hostname
+ MESHLINK_ESTORAGE, ///< MeshLink coud not load or write data from/to disk
+ MESHLINK_ENETWORK, ///< MeshLink encountered a network error
+ MESHLINK_EPEER, ///< A peer caused an error
} meshlink_errno_t;
/// A variable holding the last encountered error from MeshLink.
#ifndef MESHLINK_INTERNAL_H
struct meshlink_handle {
+ const char *name;
+ void *priv;
};
struct meshlink_node {
*/
extern bool meshlink_send(meshlink_handle_t *mesh, meshlink_node_t *destination, const void *data, size_t len);
+/// Query the maximum packet size that can be sent to a node.
+/** This functions returns the maximum size of packets (path MTU) that can be sent to a specific node with meshlink_send().
+ * The path MTU is a property of the path packets will take to the destination node over the Internet.
+ * It can be different for different destination nodes.
+ * and the path MTU can change at any point in time due to changes in the Internet.
+ * Therefore, although this should only occur rarely, it can still happen that packets that do not exceed this size get dropped.
+ *
+ * @param mesh A handle which represents an instance of MeshLink.
+ * @param destination A pointer to a meshlink_node_t describing the destination for the data.
+ *
+ * @return The recommended maximum size of packets that are to be sent to the destination node, 0 if the node is unreachable,
+ * or a negative value in case of an error.
+ */
+extern ssize_t meshlink_get_pmtu(meshlink_handle_t *mesh, meshlink_node_t *destination);
/// Get a handle for a specific node.
/** This function returns a handle for the node with the given name.
*/
extern meshlink_node_t *meshlink_get_node(meshlink_handle_t *mesh, const char *name);
+/// Get the fingerprint of a node's public key.
+/** This function returns a fingerprint of the node's public key.
+ * It should be treated as an opaque blob.
+ *
+ * @param mesh A handle which represents an instance of MeshLink.
+ * @param node A pointer to a meshlink_node_t describing the node.
+ *
+ * @return A nul-terminated C string containing the fingerprint of the node's public key in a printable ASCII format.
+ * The application should call free() after it is done using this string.
+ */
+extern char *meshlink_get_fingerprint(meshlink_handle_t *mesh, meshlink_node_t *node);
+
/// Get a list of all nodes.
/** This function returns a list with handles for all known nodes.
*