From 917bcedfc76294050763a5bd5077f5b4e44d62fe Mon Sep 17 00:00:00 2001 From: Guus Sliepen Date: Sun, 11 Dec 2022 12:47:47 +0100 Subject: [PATCH] Initial support for CMake. This supports building and installing the library, as well as running part of the test suite (blackbox tests are not built yet). So far it has only been tested on Linux. --- CMakeLists.txt | 28 ++++++ cmake_config.h.in | 10 +++ src/CMakeLists.txt | 76 ++++++++++++++++ src/conf.c | 2 +- src/crypto.c | 2 +- src/devtools.h | 30 ++++--- src/discovery.c | 2 +- src/dropin.h | 2 +- src/have.h | 68 ++------------ src/meshlink.c | 6 +- src/meshlink.h | 212 ++++++++++++++++++++++---------------------- src/net.h | 2 +- src/utils.c | 2 +- src/utils.h | 6 +- src/xalloc.h | 2 +- test/CMakeLists.txt | 46 ++++++++++ 16 files changed, 308 insertions(+), 188 deletions(-) create mode 100644 CMakeLists.txt create mode 100644 cmake_config.h.in create mode 100644 src/CMakeLists.txt create mode 100644 test/CMakeLists.txt diff --git a/CMakeLists.txt b/CMakeLists.txt new file mode 100644 index 00000000..ce082569 --- /dev/null +++ b/CMakeLists.txt @@ -0,0 +1,28 @@ +project(meshlink-tiny) +cmake_minimum_required(VERSION 3.12) + +set(THREADS_PREFER_PTHREAD_FLAG ON) +find_package(Threads REQUIRED) + +include(CheckSymbolExists) +include(CheckIncludeFile) +include(CTest) + +#add_definitions(-D_GNU_SOURCE) +#add_definitions(-D_POSIX_C_SOURCE=200112L) +set(CMAKE_REQUIRED_DEFINITIONS -D_GNU_SOURCE) +#list(APPEND CMAKE_REQUIRED_DEFINITIONS -D_GNU_SOURCE) +#add_compile_definitions(_GNU_SOURCE) +#string(APPEND CMAKE_C_FLAGS "-D_GNU_SOURCE") + +check_symbol_exists(setns "sched.h" HAVE_SETNS) +check_symbol_exists(strsignal "string.h" HAVE_STRSIGNAL) +check_symbol_exists(asprintf "stdio.h" HAVE_ASPRINTF) +check_symbol_exists(pselect "sys/select.h" HAVE_PSELECT) +check_include_file(stdatomic.h HAVE_STDATOMIC_H) +configure_file(cmake_config.h.in config.h) +include_directories(${CMAKE_CURRENT_BINARY_DIR}/src) + +add_subdirectory(src) +enable_testing() +add_subdirectory(test) diff --git a/cmake_config.h.in b/cmake_config.h.in new file mode 100644 index 00000000..c4854c36 --- /dev/null +++ b/cmake_config.h.in @@ -0,0 +1,10 @@ +#define _GNU_SOURCE 1 +#define __USE_BSD 1 +#define _POSIX_C_SOURCE 200809L +#define _DARWIN_C_SOURCE 1 + +#cmakedefine HAVE_ASPRINTF +#cmakedefine HAVE_PSELECT +#cmakedefine HAVE_SETNS +#cmakedefine HAVE_STDATOMIC_H +#cmakedefine HAVE_STRSIGNAL diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt new file mode 100644 index 00000000..1b47d5b4 --- /dev/null +++ b/src/CMakeLists.txt @@ -0,0 +1,76 @@ +#include(GenerateExportHeader) +#generate_export_header(meshlink BASE_NAME meshlink) + +add_library(meshlink SHARED + adns.c + buffer.c + chacha-poly1305/chacha-poly1305.c + chacha-poly1305/chacha.c + chacha-poly1305/poly1305.c + conf.c + connection.c + crypto.c + devtools.c + discovery.c + dropin.c + ed25519/add_scalar.c + ed25519/ecdh.c + ed25519/ecdsa.c + ed25519/ecdsagen.c + ed25519/fe.c + ed25519/ge.c + ed25519/key_exchange.c + ed25519/keypair.c + ed25519/sc.c + ed25519/seed.c + ed25519/sha512.c + ed25519/sign.c + ed25519/verify.c + edge.c + event.c + graph.c + hash.c + list.c + logger.c + mdns.c + meshlink.c + meta.c + net.c + net_packet.c + net_setup.c + net_socket.c + netutl.c + node.c + prf.c + protocol.c + protocol_auth.c + protocol_edge.c + protocol_key.c + protocol_misc.c + route.c + splay_tree.c + sptps.c + submesh.c + utcp-test.c + utcp.c + utils.c + xoshiro.c +) + +set(MESHLINK_PUBLIC_HEADERS + meshlink.h + meshlink++.h +) + +target_compile_features(meshlink PUBLIC c_std_11) +target_link_libraries(meshlink PRIVATE Threads::Threads) +set_target_properties(meshlink PROPERTIES PUBLIC_HEADER "${MESHLINK_PUBLIC_HEADERS}") +set_property(TARGET meshlink PROPERTY C_VISIBILITY_PRESET hidden) +set_property(TARGET meshlink PROPERTY C_STANDARD 11) + +include(GNUInstallDirs) +install(TARGETS meshlink + LIBRARY + LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR} + PUBLIC_HEADER DESTINATION ${CMAKE_INSTALL_INCLUDEDIR} +) diff --git a/src/conf.c b/src/conf.c index db91d5fb..13ee7e1b 100644 --- a/src/conf.c +++ b/src/conf.c @@ -510,7 +510,7 @@ bool main_config_lock(meshlink_handle_t *mesh, const char *lock_filename) { fcntl(fileno(mesh->lockfile), F_SETFD, FD_CLOEXEC); #endif -#ifdef HAVE_MINGW +#ifdef _WIN32 // TODO: use _locking()? #else diff --git a/src/crypto.c b/src/crypto.c index 3244a0b4..097f9d2b 100644 --- a/src/crypto.c +++ b/src/crypto.c @@ -23,7 +23,7 @@ //TODO: use a strict random source once to seed a PRNG? -#ifndef HAVE_MINGW +#ifndef _WIN32 static int random_fd = -1; diff --git a/src/devtools.h b/src/devtools.h index 78e36428..8e56c9e0 100644 --- a/src/devtools.h +++ b/src/devtools.h @@ -20,6 +20,10 @@ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ +#ifndef MESHLINK_EXPORT +#define MESHLINK_EXPORT __attribute__((visibility("default"))) +#endif + /// \file devtools.h /** This header files declares functions that are only intended for debugging and quality control. * They are not necessary for the normal operation of MeshLink. @@ -71,7 +75,7 @@ struct devtool_edge { * value. If the new values is NULL, then the old array * will have been freed by Meshlink. */ -devtool_edge_t *devtool_get_all_edges(meshlink_handle_t *mesh, devtool_edge_t *edges, size_t *nmemb); +MESHLINK_EXPORT devtool_edge_t *devtool_get_all_edges(meshlink_handle_t *mesh, devtool_edge_t *edges, size_t *nmemb); /// Export a list of edges to a file in JSON format. /* @param mesh A handle which represents an instance of MeshLink. @@ -79,7 +83,7 @@ devtool_edge_t *devtool_get_all_edges(meshlink_handle_t *mesh, devtool_edge_t *e * * @return True in case of success, false otherwise. */ -bool devtool_export_json_all_edges_state(meshlink_handle_t *mesh, FILE *stream); +MESHLINK_EXPORT bool devtool_export_json_all_edges_state(meshlink_handle_t *mesh, FILE *stream); /// The status of a node. typedef struct devtool_node_status devtool_node_status_t; @@ -120,7 +124,7 @@ struct devtool_node_status { * The contents of this variable will be changed to reflect * the current status of the node. */ -void devtool_get_node_status(meshlink_handle_t *mesh, meshlink_node_t *node, devtool_node_status_t *status); +MESHLINK_EXPORT 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. @@ -134,7 +138,7 @@ void devtool_get_node_status(meshlink_handle_t *mesh, meshlink_node_t *node, dev * 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); +MESHLINK_EXPORT 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. @@ -148,7 +152,7 @@ void devtool_reset_node_counters(meshlink_handle_t *mesh, meshlink_node_t *node, * The contents of this variable will be changed to indicate * the number if array elements. */ -meshlink_submesh_t **devtool_get_all_submeshes(meshlink_handle_t *mesh, meshlink_submesh_t **submeshes, size_t *nmemb); +MESHLINK_EXPORT meshlink_submesh_t **devtool_get_all_submeshes(meshlink_handle_t *mesh, meshlink_submesh_t **submeshes, size_t *nmemb); /// Open a MeshLink instance in a given network namespace. /** This function opens MeshLink in the given network namespace. @@ -165,7 +169,7 @@ meshlink_submesh_t **devtool_get_all_submeshes(meshlink_handle_t *mesh, meshlink * @return A pointer to a meshlink_handle_t which represents this instance of MeshLink, or NULL in case of an error. * The pointer is valid until meshlink_close() is called. */ -meshlink_handle_t *devtool_open_in_netns(const char *confbase, const char *name, const char *appname, dev_class_t devclass, int netns); +MESHLINK_EXPORT meshlink_handle_t *devtool_open_in_netns(const char *confbase, const char *name, const char *appname, dev_class_t devclass, int netns); /// Debug function pointer variable for set port API /** This function pointer variable is a userspace tracepoint or debugger callback for @@ -173,7 +177,7 @@ meshlink_handle_t *devtool_open_in_netns(const char *confbase, const char *name, * On assigning a debug function variable invokes callback when try_bind() succeeds in meshlink_set_port API. * */ -extern void (*devtool_trybind_probe)(void); +MESHLINK_EXPORT extern void (*devtool_trybind_probe)(void); /// Debug function pointer variable for encrypted key rotate API /** This function pointer variable is a userspace tracepoint or debugger callback for @@ -182,10 +186,10 @@ extern void (*devtool_trybind_probe)(void); * * @param stage Debug stage number. */ -extern void (*devtool_keyrotate_probe)(int stage); +MESHLINK_EXPORT extern void (*devtool_keyrotate_probe)(int stage); /// Debug function pointer variable for asynchronous DNS resolving -extern void (*devtool_adns_resolve_probe)(void); +MESHLINK_EXPORT extern void (*devtool_adns_resolve_probe)(void); /// Debug function pointer variable for SPTPS key renewal /** This function pointer variable is a userspace tracepoint or debugger callback for @@ -193,7 +197,7 @@ extern void (*devtool_adns_resolve_probe)(void); * * @param node The node whose SPTPS key(s) are being renewed */ -extern void (*devtool_sptps_renewal_probe)(meshlink_node_t *node); +MESHLINK_EXPORT extern void (*devtool_sptps_renewal_probe)(meshlink_node_t *node); /// Force renewal of SPTPS sessions with the given node. /** This causes the SPTPS sessions for both the UDP and TCP connections to renew their keys. @@ -201,7 +205,7 @@ extern void (*devtool_sptps_renewal_probe)(meshlink_node_t *node); * @param mesh A handle which represents an instance of MeshLink. * @param node The node whose SPTPS key(s) should be renewed */ -void devtool_force_sptps_renewal(meshlink_handle_t *mesh, meshlink_node_t *node); +MESHLINK_EXPORT void devtool_force_sptps_renewal(meshlink_handle_t *mesh, meshlink_node_t *node); /// Debug function pointer variable for asserting inviter/invitee committing sequence /** This function pointer variable is a userspace tracepoint or debugger callback which @@ -211,7 +215,7 @@ void devtool_force_sptps_renewal(meshlink_handle_t *mesh, meshlink_node_t *node) * * @param inviter_commited_first true if inviter committed first else false if invitee committed first the other host file into the disk. */ -extern void (*devtool_set_inviter_commits_first)(bool inviter_commited_first); +MESHLINK_EXPORT 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. @@ -225,6 +229,6 @@ extern void (*devtool_set_inviter_commits_first)(bool inviter_commited_first); * @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); +MESHLINK_EXPORT void devtool_set_meta_status_cb(struct meshlink_handle *mesh, meshlink_node_status_cb_t cb); #endif diff --git a/src/discovery.c b/src/discovery.c index 032b5599..a2d79adf 100644 --- a/src/discovery.c +++ b/src/discovery.c @@ -498,7 +498,7 @@ static void addr_del(meshlink_handle_t *mesh, const discovery_address_t *addr) { } void scan_ifaddrs(meshlink_handle_t *mesh) { -#ifdef HAVE_GETIFADDRS +#ifndef _WIN32 struct ifaddrs *ifa = NULL; if(getifaddrs(&ifa) == -1) { diff --git a/src/dropin.h b/src/dropin.h index 603a28d9..f5cdbfcc 100644 --- a/src/dropin.h +++ b/src/dropin.h @@ -25,7 +25,7 @@ int asprintf(char **, const char *, ...); int vasprintf(char **, const char *, va_list ap); #endif -#ifdef HAVE_MINGW +#ifdef _WIN32 #define mkdir(a, b) mkdir(a) #ifndef SHUT_RDWR diff --git a/src/have.h b/src/have.h index e7da3167..5533c6a4 100644 --- a/src/have.h +++ b/src/have.h @@ -20,12 +20,8 @@ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ -#ifdef HAVE_MINGW -#ifdef WITH_WINDOWS2000 -#define WINVER Windows2000 -#else +#ifdef _WIN32 #define WINVER WindowsXP -#endif #define WIN32_LEAN_AND_MEAN #endif @@ -43,88 +39,40 @@ #include #include #include +#include #ifdef HAVE_STDATOMIC_H #include #endif -#ifdef HAVE_MINGW +/* Include system specific headers */ + +#ifdef _WIN32 + #include #include #include #include -#endif -#ifdef HAVE_TERMIOS_H -#include -#endif - -/* Include system specific headers */ - -#ifdef HAVE_SYSLOG_H -#include -#endif +#else -#ifdef HAVE_SYS_TIME_H #include -#endif - -#ifdef HAVE_TIME_H -#include -#endif - -#ifdef HAVE_SYS_TYPES_H #include -#endif - -#ifdef HAVE_SYS_STAT_H #include -#endif - -#ifdef HAVE_SYS_FILE_H #include -#endif - -#ifdef HAVE_SYS_WAIT_H -#include -#endif - -#ifdef HAVE_SYS_PARAM_H -#include -#endif - -#ifdef HAVE_SYS_RESOURCE_H -#include -#endif -#ifdef HAVE_SYS_UN_H -#include -#endif - -#ifdef HAVE_DIRENT_H #include -#endif /* SunOS really wants sys/socket.h BEFORE net/if.h, and FreeBSD wants these lines below the rest. */ -#ifdef HAVE_NETDB_H #include -#endif - -#ifdef HAVE_SYS_SOCKET_H #include -#endif - -#ifdef HAVE_ARPA_INET_H #include -#endif - -#ifdef HAVE_IFADDRS_H #include #endif -#ifdef HAVE_MINGW +#ifdef _WIN32 #define SLASH "\\" #else #define SLASH "/" diff --git a/src/meshlink.c b/src/meshlink.c index a1a2ec40..6dbaec69 100644 --- a/src/meshlink.c +++ b/src/meshlink.c @@ -1622,7 +1622,7 @@ meshlink_handle_t *meshlink_open_ex(const meshlink_open_params_t *params) { mesh->storage_policy = params->storage_policy; -#ifdef HAVE_MINGW +#ifdef _WIN32 struct WSAData wsa_state; WSAStartup(MAKEWORD(2, 2), &wsa_state); #endif @@ -1922,7 +1922,7 @@ void meshlink_close(meshlink_handle_t *mesh) { event_loop_exit(&mesh->loop); -#ifdef HAVE_MINGW +#ifdef _WIN32 if(mesh->confbase) { WSACleanup(); @@ -1995,7 +1995,7 @@ bool meshlink_destroy_ex(const meshlink_open_params_t *params) { fcntl(fileno(lockfile), F_SETFD, FD_CLOEXEC); #endif -#ifdef HAVE_MINGW +#ifdef _WIN32 // TODO: use _locking()? #else diff --git a/src/meshlink.h b/src/meshlink.h index 903bab36..9c393a03 100644 --- a/src/meshlink.h +++ b/src/meshlink.h @@ -36,6 +36,10 @@ extern "C" { #endif +#ifndef MESHLINK_EXPORT +#define MESHLINK_EXPORT __attribute__((visibility("default"))) +#endif + /// The length in bytes of a signature made with meshlink_sign() #define MESHLINK_SIGLEN (64ul) @@ -112,7 +116,7 @@ static const uint32_t MESHLINK_CHANNEL_UDP = 0; // Select UDP semantics. * The variable is only updated when an error is encountered, and is not reset to MESHLINK_OK * if a function returned successfully. */ -extern __thread meshlink_errno_t meshlink_errno; +MESHLINK_EXPORT extern __thread meshlink_errno_t meshlink_errno; #ifndef MESHLINK_INTERNAL_H @@ -147,7 +151,7 @@ struct meshlink_channel { * The pointer is to static storage that is valid for the lifetime of the application. * This function will always return a valid pointer, even if an invalid error code has been passed. */ -const char *meshlink_strerror(meshlink_errno_t err) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT const char *meshlink_strerror(meshlink_errno_t err) __attribute__((__warn_unused_result__)); /// Create a new meshlink_open_params_t struct. /** This function allocates and initializes a new meshlink_open_params_t struct that can be passed to meshlink_open_ex(). @@ -166,14 +170,14 @@ const char *meshlink_strerror(meshlink_errno_t err) __attribute__((__warn_unused * @return A pointer to a meshlink_open_params_t which can be passed to meshlink_open_ex(), or NULL in case of an error. * The pointer is valid until meshlink_open_params_free() is called. */ -meshlink_open_params_t *meshlink_open_params_init(const char *confbase, const char *name, const char *appname, dev_class_t devclass) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT meshlink_open_params_t *meshlink_open_params_init(const char *confbase, const char *name, const char *appname, dev_class_t devclass) __attribute__((__warn_unused_result__)); /// Free a meshlink_open_params_t struct. /** This function frees a meshlink_open_params_t struct and all resources associated with it. * * @param params A pointer to a meshlink_open_params_t which must have been created earlier with meshlink_open_params_init(). */ -void meshlink_open_params_free(meshlink_open_params_t *params); +MESHLINK_EXPORT void meshlink_open_params_free(meshlink_open_params_t *params); /// Set the network namespace MeshLink should use. /** This function changes the open parameters to use the given netns filedescriptor. @@ -183,7 +187,7 @@ void meshlink_open_params_free(meshlink_open_params_t *params); * * @return This function will return true if the open parameters have been successfully updated, false otherwise. */ -bool meshlink_open_params_set_netns(meshlink_open_params_t *params, int netns) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_open_params_set_netns(meshlink_open_params_t *params, int netns) __attribute__((__warn_unused_result__)); /// Set the encryption key MeshLink should use for local storage. /** This function changes the open parameters to use the given key for encrypting MeshLink's own configuration files. @@ -194,7 +198,7 @@ bool meshlink_open_params_set_netns(meshlink_open_params_t *params, int netns) _ * * @return This function will return true if the open parameters have been successfully updated, false otherwise. */ -bool meshlink_open_params_set_storage_key(meshlink_open_params_t *params, const void *key, size_t keylen) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_open_params_set_storage_key(meshlink_open_params_t *params, const void *key, size_t keylen) __attribute__((__warn_unused_result__)); /// Set the encryption key MeshLink should use for local storage. /** This function changes the open parameters to use the given storage policy. @@ -204,7 +208,7 @@ bool meshlink_open_params_set_storage_key(meshlink_open_params_t *params, const * * @return This function will return true if the open parameters have been successfully updated, false otherwise. */ -bool meshlink_open_params_set_storage_policy(meshlink_open_params_t *params, meshlink_storage_policy_t policy) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_open_params_set_storage_policy(meshlink_open_params_t *params, meshlink_storage_policy_t policy) __attribute__((__warn_unused_result__)); /// Set the filename of the lockfile. /** This function changes the path of the lockfile used to ensure only one instance of MeshLink can be open at the same time. @@ -215,7 +219,7 @@ bool meshlink_open_params_set_storage_policy(meshlink_open_params_t *params, mes * * @return This function will return true if the open parameters have been successfully updated, false otherwise. */ -bool meshlink_open_params_set_lock_filename(meshlink_open_params_t *params, const char *filename) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_open_params_set_lock_filename(meshlink_open_params_t *params, const char *filename) __attribute__((__warn_unused_result__)); /// Open or create a MeshLink instance. /** This function opens or creates a MeshLink instance. @@ -235,7 +239,7 @@ bool meshlink_open_params_set_lock_filename(meshlink_open_params_t *params, cons * @return A pointer to a struct meshlink_handle which represents this instance of MeshLink, or NULL in case of an error. * The pointer is valid until meshlink_close() is called. */ -struct meshlink_handle *meshlink_open_ex(const meshlink_open_params_t *params) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_handle *meshlink_open_ex(const meshlink_open_params_t *params) __attribute__((__warn_unused_result__)); /// Open or create a MeshLink instance. /** This function opens or creates a MeshLink instance. @@ -265,7 +269,7 @@ struct meshlink_handle *meshlink_open_ex(const meshlink_open_params_t *params) _ * @return A pointer to a struct meshlink_handle which represents this instance of MeshLink, or NULL in case of an error. * The pointer is valid until meshlink_close() is called. */ -struct meshlink_handle *meshlink_open(const char *confbase, const char *name, const char *appname, dev_class_t devclass) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_handle *meshlink_open(const char *confbase, const char *name, const char *appname, dev_class_t devclass) __attribute__((__warn_unused_result__)); /// Open or create a MeshLink instance that uses encrypted storage. /** This function opens or creates a MeshLink instance. @@ -297,7 +301,7 @@ struct meshlink_handle *meshlink_open(const char *confbase, const char *name, co * @return A pointer to a struct meshlink_handle which represents this instance of MeshLink, or NULL in case of an error. * The pointer is valid until meshlink_close() is called. */ -struct meshlink_handle *meshlink_open_encrypted(const char *confbase, const char *name, const char *appname, dev_class_t devclass, const void *key, size_t keylen) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_handle *meshlink_open_encrypted(const char *confbase, const char *name, const char *appname, dev_class_t devclass, const void *key, size_t keylen) __attribute__((__warn_unused_result__)); /// Create an ephemeral MeshLink instance that does not store any state. /** This function creates a MeshLink instance. @@ -321,7 +325,7 @@ struct meshlink_handle *meshlink_open_encrypted(const char *confbase, const char * @return A pointer to a struct meshlink_handle which represents this instance of MeshLink, or NULL in case of an error. * The pointer is valid until meshlink_close() is called. */ -struct meshlink_handle *meshlink_open_ephemeral(const char *name, const char *appname, dev_class_t devclass) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_handle *meshlink_open_ephemeral(const char *name, const char *appname, dev_class_t devclass) __attribute__((__warn_unused_result__)); /// Create Sub-Mesh. /** This function causes MeshLink to open a new Sub-Mesh network @@ -337,7 +341,7 @@ struct meshlink_handle *meshlink_open_ephemeral(const char *name, const char *ap * @return A pointer to a struct meshlink_submesh which represents this instance of SubMesh, or NULL in case of an error. * The pointer is valid until meshlink_close() is called. */ -struct meshlink_submesh *meshlink_submesh_open(struct meshlink_handle *mesh, const char *submesh) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_submesh *meshlink_submesh_open(struct meshlink_handle *mesh, const char *submesh) __attribute__((__warn_unused_result__)); /// Start MeshLink. /** This function causes MeshLink to open network sockets, make outgoing connections, and @@ -350,7 +354,7 @@ struct meshlink_submesh *meshlink_submesh_open(struct meshlink_handle *mesh, con * * @return This function will return true if MeshLink has successfully started, false otherwise. */ -bool meshlink_start(struct meshlink_handle *mesh) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_start(struct meshlink_handle *mesh) __attribute__((__warn_unused_result__)); /// Stop MeshLink. /** This function causes MeshLink to disconnect from all other nodes, @@ -362,7 +366,7 @@ bool meshlink_start(struct meshlink_handle *mesh) __attribute__((__warn_unused_r * \memberof meshlink_handle * @param mesh A handle which represents an instance of MeshLink. */ -void meshlink_stop(struct meshlink_handle *mesh); +MESHLINK_EXPORT void meshlink_stop(struct meshlink_handle *mesh); /// Close the MeshLink handle. /** This function calls meshlink_stop() if necessary, @@ -376,7 +380,7 @@ void meshlink_stop(struct meshlink_handle *mesh); * \memberof meshlink_handle * @param mesh A handle which represents an instance of MeshLink. */ -void meshlink_close(struct meshlink_handle *mesh); +MESHLINK_EXPORT void meshlink_close(struct meshlink_handle *mesh); /// Destroy a MeshLink instance. /** This function remove all configuration files of a MeshLink instance. It should only be called when the application @@ -388,7 +392,7 @@ void meshlink_close(struct meshlink_handle *mesh); * * @return This function will return true if the MeshLink instance was successfully destroyed, false otherwise. */ -bool meshlink_destroy(const char *confbase) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_destroy(const char *confbase) __attribute__((__warn_unused_result__)); /// Destroy a MeshLink instance using open parameters. /** This function remove all configuration files of a MeshLink instance. It should only be called when the application @@ -403,7 +407,7 @@ bool meshlink_destroy(const char *confbase) __attribute__((__warn_unused_result_ * * @return This function will return true if the MeshLink instance was successfully destroyed, false otherwise. */ -bool meshlink_destroy_ex(const meshlink_open_params_t *params) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_destroy_ex(const meshlink_open_params_t *params) __attribute__((__warn_unused_result__)); /// A callback for receiving data from the mesh. /** @param mesh A handle which represents an instance of MeshLink. @@ -427,7 +431,7 @@ typedef void (*meshlink_receive_cb_t)(struct meshlink_handle *mesh, struct meshl * @param cb A pointer to the function which will be called when another node sends data to the local node. * If a NULL pointer is given, the callback will be disabled. */ -void meshlink_set_receive_cb(struct meshlink_handle *mesh, meshlink_receive_cb_t cb); +MESHLINK_EXPORT void meshlink_set_receive_cb(struct meshlink_handle *mesh, meshlink_receive_cb_t cb); /// A callback reporting the meta-connection attempt made by the host node to an another node. /** @param mesh A handle which represents an instance of MeshLink. @@ -448,7 +452,7 @@ typedef void (*meshlink_connection_try_cb_t)(struct meshlink_handle *mesh, struc * @param cb A pointer to the function which will be called when host node attempts to make * the connection to another node. If a NULL pointer is given, the callback will be disabled. */ -void meshlink_set_connection_try_cb(struct meshlink_handle *mesh, meshlink_connection_try_cb_t cb); +MESHLINK_EXPORT void meshlink_set_connection_try_cb(struct meshlink_handle *mesh, meshlink_connection_try_cb_t cb); /// A callback reporting node status changes. /** @param mesh A handle which represents an instance of MeshLink. @@ -470,7 +474,7 @@ typedef void (*meshlink_node_status_cb_t)(struct meshlink_handle *mesh, struct m * @param cb A pointer to the function which will be called when another node's status changes. * If a NULL pointer is given, the callback will be disabled. */ -void meshlink_set_node_status_cb(struct meshlink_handle *mesh, meshlink_node_status_cb_t cb); +MESHLINK_EXPORT void meshlink_set_node_status_cb(struct meshlink_handle *mesh, meshlink_node_status_cb_t cb); /// A callback reporting node path MTU changes. /** @param mesh A handle which represents an instance of MeshLink. @@ -492,7 +496,7 @@ typedef void (*meshlink_node_pmtu_cb_t)(struct meshlink_handle *mesh, struct mes * @param cb A pointer to the function which will be called when another node's extended status changes. * If a NULL pointer is given, the callback will be disabled. */ -void meshlink_set_node_pmtu_cb(struct meshlink_handle *mesh, meshlink_node_pmtu_cb_t cb); +MESHLINK_EXPORT void meshlink_set_node_pmtu_cb(struct meshlink_handle *mesh, meshlink_node_pmtu_cb_t cb); /// A callback reporting duplicate node detection. /** @param mesh A handle which represents an instance of MeshLink. @@ -513,7 +517,7 @@ typedef void (*meshlink_node_duplicate_cb_t)(struct meshlink_handle *mesh, struc * @param cb A pointer to the function which will be called when a duplicate node is detected. * If a NULL pointer is given, the callback will be disabled. */ -void meshlink_set_node_duplicate_cb(struct meshlink_handle *mesh, meshlink_node_duplicate_cb_t cb); +MESHLINK_EXPORT void meshlink_set_node_duplicate_cb(struct meshlink_handle *mesh, meshlink_node_duplicate_cb_t cb); /// Severity of log messages generated by MeshLink. typedef enum { @@ -556,7 +560,7 @@ typedef void (*meshlink_log_cb_t)(struct meshlink_handle *mesh, meshlink_log_lev * @param cb A pointer to the function which will be called when another node sends data to the local node. * If a NULL pointer is given, the callback will be disabled. */ -void meshlink_set_log_cb(struct meshlink_handle *mesh, meshlink_log_level_t level, meshlink_log_cb_t cb); +MESHLINK_EXPORT void meshlink_set_log_cb(struct meshlink_handle *mesh, meshlink_log_level_t level, meshlink_log_cb_t cb); /// A callback for receiving error conditions encountered by the MeshLink thread. /** @param mesh A handle which represents an instance of MeshLink, or NULL. @@ -588,7 +592,7 @@ typedef void (*meshlink_error_cb_t)(struct meshlink_handle *mesh, meshlink_errno * @param cb A pointer to the function which will be called when a serious error is encountered. * If a NULL pointer is given, the callback will be disabled. */ -void meshlink_set_error_cb(struct meshlink_handle *mesh, meshlink_error_cb_t cb); +MESHLINK_EXPORT void meshlink_set_error_cb(struct meshlink_handle *mesh, meshlink_error_cb_t cb); /// A callback for receiving blacklisted conditions encountered by the MeshLink thread. /** @param mesh A handle which represents an instance of MeshLink, or NULL. @@ -609,7 +613,7 @@ typedef void (*meshlink_blacklisted_cb_t)(struct meshlink_handle *mesh, struct m * @param cb A pointer to the function which will be called when a serious error is encountered. * If a NULL pointer is given, the callback will be disabled. */ -void meshlink_set_blacklisted_cb(struct meshlink_handle *mesh, meshlink_blacklisted_cb_t cb); +MESHLINK_EXPORT void meshlink_set_blacklisted_cb(struct meshlink_handle *mesh, meshlink_blacklisted_cb_t cb); /// A callback notifying when the MeshLink thread starts and stops. /* @param mesh A handle which represents an instance of MeshLink, or NULL. @@ -630,7 +634,7 @@ typedef void (*meshlink_thread_status_cb_t)(struct meshlink_handle *mesh, bool s * @param cb A pointer to the function which will be called when a serious error is encountered. * If a NULL pointer is given, the callback will be disabled. */ -void meshlink_set_thread_status_cb(struct meshlink_handle *mesh, meshlink_thread_status_cb_t cb); +MESHLINK_EXPORT void meshlink_set_thread_status_cb(struct meshlink_handle *mesh, meshlink_thread_status_cb_t cb); /// Send data to another node. /** This functions sends one packet of data to another node in the mesh. @@ -651,7 +655,7 @@ void meshlink_set_thread_status_cb(struct meshlink_handle *mesh, meshlink_thread * @return This function will return true if MeshLink has queued the message for transmission, and false otherwise. * A return value of true does not guarantee that the message will actually arrive at the destination. */ -bool meshlink_send(struct meshlink_handle *mesh, struct meshlink_node *destination, const void *data, size_t len) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_send(struct meshlink_handle *mesh, struct meshlink_node *destination, const void *data, size_t len) __attribute__((__warn_unused_result__)); /// 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(). @@ -667,7 +671,7 @@ bool meshlink_send(struct meshlink_handle *mesh, struct meshlink_node *destinati * @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. */ -ssize_t meshlink_get_pmtu(struct meshlink_handle *mesh, struct meshlink_node *destination) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT ssize_t meshlink_get_pmtu(struct meshlink_handle *mesh, struct meshlink_node *destination) __attribute__((__warn_unused_result__)); /// Get a handle for our own node. /** This function returns a handle for the local node. @@ -678,7 +682,7 @@ ssize_t meshlink_get_pmtu(struct meshlink_handle *mesh, struct meshlink_node *de * @return A pointer to a struct meshlink_node which represents the local node. * The pointer is guaranteed to be valid until meshlink_close() is called. */ -struct meshlink_node *meshlink_get_self(struct meshlink_handle *mesh) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_node *meshlink_get_self(struct meshlink_handle *mesh) __attribute__((__warn_unused_result__)); /// Get a handle for a specific node. /** This function returns a handle for the node with the given name. @@ -692,7 +696,7 @@ struct meshlink_node *meshlink_get_self(struct meshlink_handle *mesh) __attribut * or NULL if the requested node does not exist. * The pointer is guaranteed to be valid until meshlink_close() is called. */ -struct meshlink_node *meshlink_get_node(struct meshlink_handle *mesh, const char *name) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_node *meshlink_get_node(struct meshlink_handle *mesh, const char *name) __attribute__((__warn_unused_result__)); /// Get a handle for a specific submesh. /** This function returns a handle for the submesh with the given name. @@ -706,7 +710,7 @@ struct meshlink_node *meshlink_get_node(struct meshlink_handle *mesh, const char * or NULL if the requested submesh does not exist. * The pointer is guaranteed to be valid until meshlink_close() is called. */ -struct meshlink_submesh *meshlink_get_submesh(struct meshlink_handle *mesh, const char *name) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_submesh *meshlink_get_submesh(struct meshlink_handle *mesh, const char *name) __attribute__((__warn_unused_result__)); /// Get the fingerprint of a node's public key. /** This function returns a fingerprint of the node's public key. @@ -719,7 +723,7 @@ struct meshlink_submesh *meshlink_get_submesh(struct meshlink_handle *mesh, cons * @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. */ -char *meshlink_get_fingerprint(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT char *meshlink_get_fingerprint(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); /// Get a list of all nodes. /** This function returns a list with handles for all known nodes. @@ -739,7 +743,7 @@ char *meshlink_get_fingerprint(struct meshlink_handle *mesh, struct meshlink_nod * If it is a new value, the old value of @a nodes should not be used anymore. * If the new value is NULL, then the old array will have been freed by MeshLink. */ -struct meshlink_node **meshlink_get_all_nodes(struct meshlink_handle *mesh, struct meshlink_node **nodes, size_t *nmemb) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_node **meshlink_get_all_nodes(struct meshlink_handle *mesh, struct meshlink_node **nodes, size_t *nmemb) __attribute__((__warn_unused_result__)); /// Sign data using the local node's MeshLink key. /** This function signs data using the local node's MeshLink key. @@ -756,7 +760,7 @@ struct meshlink_node **meshlink_get_all_nodes(struct meshlink_handle *mesh, stru * * @return This function returns true if the signature was correctly generated, false otherwise. */ -bool meshlink_sign(struct meshlink_handle *mesh, const void *data, size_t len, void *signature, size_t *siglen) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_sign(struct meshlink_handle *mesh, const void *data, size_t len, void *signature, size_t *siglen) __attribute__((__warn_unused_result__)); /// Get the list of all nodes by device class. /** This function returns a list with handles for all the nodes that matches with the given @a devclass. @@ -777,7 +781,7 @@ bool meshlink_sign(struct meshlink_handle *mesh, const void *data, size_t len, v * If it is a new value, the old value of @a nodes should not be used anymore. * If the new value is NULL, then the old array will have been freed by MeshLink. */ -struct meshlink_node **meshlink_get_all_nodes_by_dev_class(struct meshlink_handle *mesh, dev_class_t devclass, struct meshlink_node **nodes, size_t *nmemb) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_node **meshlink_get_all_nodes_by_dev_class(struct meshlink_handle *mesh, dev_class_t devclass, struct meshlink_node **nodes, size_t *nmemb) __attribute__((__warn_unused_result__)); /// Get the list of all nodes by Submesh. /** This function returns a list with handles for all the nodes that matches with the given @a Submesh. @@ -798,7 +802,7 @@ struct meshlink_node **meshlink_get_all_nodes_by_dev_class(struct meshlink_handl * If it is a new value, the old value of @a nodes should not be used anymore. * If the new value is NULL, then the old array will have been freed by MeshLink. */ -struct meshlink_node **meshlink_get_all_nodes_by_submesh(struct meshlink_handle *mesh, struct meshlink_submesh *submesh, struct meshlink_node **nodes, size_t *nmemb) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_node **meshlink_get_all_nodes_by_submesh(struct meshlink_handle *mesh, struct meshlink_submesh *submesh, struct meshlink_node **nodes, size_t *nmemb) __attribute__((__warn_unused_result__)); /// Get the list of all nodes by time they were last reachable. /** This function returns a list with handles for all the nodes whose last known reachability time overlaps with the given time range. @@ -822,7 +826,7 @@ struct meshlink_node **meshlink_get_all_nodes_by_submesh(struct meshlink_handle * If it is a new value, the old value of @a nodes should not be used anymore. * If the new value is NULL, then the old array will have been freed by MeshLink. */ -struct meshlink_node **meshlink_get_all_nodes_by_last_reachable(struct meshlink_handle *mesh, time_t start, time_t end, struct meshlink_node **nodes, size_t *nmemb) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_node **meshlink_get_all_nodes_by_last_reachable(struct meshlink_handle *mesh, time_t start, time_t end, struct meshlink_node **nodes, size_t *nmemb) __attribute__((__warn_unused_result__)); /// Get the list of all nodes by blacklist status. /** This function returns a list with handles for all the nodes who were either blacklisted or whitelisted. @@ -843,7 +847,7 @@ struct meshlink_node **meshlink_get_all_nodes_by_last_reachable(struct meshlink_ * If it is a new value, the old value of @a nodes should not be used anymore. * If the new value is NULL, then the old array will have been freed by MeshLink. */ -struct meshlink_node **meshlink_get_all_nodes_by_blacklisted(struct meshlink_handle *mesh, bool blacklisted, struct meshlink_node **nodes, size_t *nmemb) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_node **meshlink_get_all_nodes_by_blacklisted(struct meshlink_handle *mesh, bool blacklisted, struct meshlink_node **nodes, size_t *nmemb) __attribute__((__warn_unused_result__)); /// Get the node's device class. /** This function returns the device class of the given node. @@ -854,7 +858,7 @@ struct meshlink_node **meshlink_get_all_nodes_by_blacklisted(struct meshlink_han * * @return This function returns the device class of the @a node, or -1 in case of an error. */ -dev_class_t meshlink_get_node_dev_class(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT dev_class_t meshlink_get_node_dev_class(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); /// Get the node's tiny status. /** This function returns true if the given node is a tiny node. @@ -866,7 +870,7 @@ dev_class_t meshlink_get_node_dev_class(struct meshlink_handle *mesh, struct mes * * @return This function returns true if the node is a tiny node. */ -bool meshlink_get_node_tiny(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_get_node_tiny(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); /// Get the node's blacklist status. /** This function returns the given node is blacklisted. @@ -877,7 +881,7 @@ bool meshlink_get_node_tiny(struct meshlink_handle *mesh, struct meshlink_node * * * @return This function returns true if the node is blacklisted, false otherwise. */ -bool meshlink_get_node_blacklisted(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_get_node_blacklisted(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); /// Get the node's submesh handle. /** This function returns the submesh handle of the given node. @@ -888,7 +892,7 @@ bool meshlink_get_node_blacklisted(struct meshlink_handle *mesh, struct meshlink * * @return This function returns the submesh handle of the @a node, or NULL in case of an error. */ -struct meshlink_submesh *meshlink_get_node_submesh(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_submesh *meshlink_get_node_submesh(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); /// Get a node's reachability status. /** This function returns the current reachability of a given node, and the times of the last state changes. @@ -904,7 +908,7 @@ struct meshlink_submesh *meshlink_get_node_submesh(struct meshlink_handle *mesh, * * @return This function returns true if the node is currently reachable, false otherwise. */ -bool meshlink_get_node_reachability(struct meshlink_handle *mesh, struct meshlink_node *node, time_t *last_reachable, time_t *last_unreachable); +MESHLINK_EXPORT bool meshlink_get_node_reachability(struct meshlink_handle *mesh, struct meshlink_node *node, time_t *last_reachable, time_t *last_unreachable); /// Verify the signature generated by another node of a piece of data. /** This function verifies the signature that another node generated for a piece of data. @@ -920,7 +924,7 @@ bool meshlink_get_node_reachability(struct meshlink_handle *mesh, struct meshlin * * @return This function returns true if the signature is valid, false otherwise. */ -bool meshlink_verify(struct meshlink_handle *mesh, struct meshlink_node *source, const void *data, size_t len, const void *signature, size_t siglen) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_verify(struct meshlink_handle *mesh, struct meshlink_node *source, const void *data, size_t len, const void *signature, size_t siglen) __attribute__((__warn_unused_result__)); /// Set the canonical Address for a node. /** This function sets the canonical Address for a node. @@ -942,7 +946,7 @@ bool meshlink_verify(struct meshlink_handle *mesh, struct meshlink_node *source, * * @return This function returns true if the address was added, false otherwise. */ -bool meshlink_set_canonical_address(struct meshlink_handle *mesh, struct meshlink_node *node, const char *address, const char *port) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_set_canonical_address(struct meshlink_handle *mesh, struct meshlink_node *node, const char *address, const char *port) __attribute__((__warn_unused_result__)); /// Clear the canonical Address for a node. /** This function clears the canonical Address for a node. @@ -953,7 +957,7 @@ bool meshlink_set_canonical_address(struct meshlink_handle *mesh, struct meshlin * * @return This function returns true if the address was removed, false otherwise. */ -bool meshlink_clear_canonical_address(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_clear_canonical_address(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); /// Add an invitation address for the local node. /** This function adds an address for the local node, which will be used only for invitation URLs. @@ -968,7 +972,7 @@ bool meshlink_clear_canonical_address(struct meshlink_handle *mesh, struct meshl * * @return This function returns true if the address was added, false otherwise. */ -bool meshlink_add_invitation_address(struct meshlink_handle *mesh, const char *address, const char *port) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_add_invitation_address(struct meshlink_handle *mesh, const char *address, const char *port) __attribute__((__warn_unused_result__)); /// Clears all invitation address for the local node. /** This function removes all addresses added with meshlink_add_invitation_address(). @@ -976,7 +980,7 @@ bool meshlink_add_invitation_address(struct meshlink_handle *mesh, const char *a * \memberof meshlink_handle * @param mesh A handle which represents an instance of MeshLink. */ -void meshlink_clear_invitation_addresses(struct meshlink_handle *mesh); +MESHLINK_EXPORT void meshlink_clear_invitation_addresses(struct meshlink_handle *mesh); /// Add an Address for the local node. /** This function adds an Address for the local node, which will be used for invitation URLs. @@ -988,7 +992,7 @@ void meshlink_clear_invitation_addresses(struct meshlink_handle *mesh); * * @return This function returns true if the address was added, false otherwise. */ -bool meshlink_add_address(struct meshlink_handle *mesh, const char *address) __attribute__((__warn_unused_result__, __deprecated__("use meshlink_set_canonical_address() and/or meshlink_add_invitation_address() instead"))); +MESHLINK_EXPORT bool meshlink_add_address(struct meshlink_handle *mesh, const char *address) __attribute__((__warn_unused_result__, __deprecated__("use meshlink_set_canonical_address() and/or meshlink_add_invitation_address() instead"))); /// Try to discover the external address for the local node. /** This function performs tries to discover the local node's external address @@ -1012,7 +1016,7 @@ bool meshlink_add_address(struct meshlink_handle *mesh, const char *address) __a * or NULL if there was an error looking up the address. * After meshlink_get_external_address() returns, the application is free to overwrite or free this string. */ -char *meshlink_get_external_address(struct meshlink_handle *mesh) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT char *meshlink_get_external_address(struct meshlink_handle *mesh) __attribute__((__warn_unused_result__)); /// Try to discover the external address for the local node. /** This function performs tries to discover the local node's external address @@ -1038,7 +1042,7 @@ char *meshlink_get_external_address(struct meshlink_handle *mesh) __attribute__( * or NULL if there was an error looking up the address. * After meshlink_get_external_address_for_family() returns, the application is free to overwrite or free this string. */ -char *meshlink_get_external_address_for_family(struct meshlink_handle *mesh, int address_family) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT char *meshlink_get_external_address_for_family(struct meshlink_handle *mesh, int address_family) __attribute__((__warn_unused_result__)); /// Try to discover the local address for the local node. /** This function performs tries to discover the address of the local interface used for outgoing connection. @@ -1061,7 +1065,7 @@ char *meshlink_get_external_address_for_family(struct meshlink_handle *mesh, int * or NULL if there was an error looking up the address. * After meshlink_get_local_address_for_family() returns, the application is free to overwrite or free this string. */ -char *meshlink_get_local_address_for_family(struct meshlink_handle *mesh, int address_family) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT char *meshlink_get_local_address_for_family(struct meshlink_handle *mesh, int address_family) __attribute__((__warn_unused_result__)); /// Try to discover the external address for the local node, and add it to its list of addresses. /** This function is equivalent to: @@ -1075,7 +1079,7 @@ char *meshlink_get_local_address_for_family(struct meshlink_handle *mesh, int ad * * @return This function returns true if the address was added, false otherwise. */ -bool meshlink_add_external_address(struct meshlink_handle *mesh) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_add_external_address(struct meshlink_handle *mesh) __attribute__((__warn_unused_result__)); /// Get the network port used by the local node. /** This function returns the network port that the local node is listening on. @@ -1085,7 +1089,7 @@ bool meshlink_add_external_address(struct meshlink_handle *mesh) __attribute__(( * * @return This function returns the port number, or -1 in case of an error. */ -int meshlink_get_port(struct meshlink_handle *mesh) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT int meshlink_get_port(struct meshlink_handle *mesh) __attribute__((__warn_unused_result__)); /// Set the network port used by the local node. /** This function sets the network port that the local node is listening on. @@ -1109,7 +1113,7 @@ int meshlink_get_port(struct meshlink_handle *mesh) __attribute__((__warn_unused * is no guarantee that MeshLink is listening on the old port. */ -bool meshlink_set_port(struct meshlink_handle *mesh, int port) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_set_port(struct meshlink_handle *mesh, int port) __attribute__((__warn_unused_result__)); /// Set the timeout for invitations. /** This function sets the timeout for invitations. @@ -1120,7 +1124,7 @@ bool meshlink_set_port(struct meshlink_handle *mesh, int port) __attribute__((__ * @param mesh A handle which represents an instance of MeshLink. * @param timeout The timeout for invitations in seconds. */ -void meshlink_set_invitation_timeout(struct meshlink_handle *mesh, int timeout); +MESHLINK_EXPORT void meshlink_set_invitation_timeout(struct meshlink_handle *mesh, int timeout); /// Invite another node into the mesh. /** This function generates an invitation that can be used by another node to join the same mesh as the local node. @@ -1138,7 +1142,7 @@ void meshlink_set_invitation_timeout(struct meshlink_handle *mesh, int timeout); * @return This function returns a nul-terminated C string that contains the invitation URL, or NULL in case of an error. * The application should call free() after it has finished using the URL. */ -char *meshlink_invite_ex(struct meshlink_handle *mesh, struct meshlink_submesh *submesh, const char *name, uint32_t flags) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT char *meshlink_invite_ex(struct meshlink_handle *mesh, struct meshlink_submesh *submesh, const char *name, uint32_t flags) __attribute__((__warn_unused_result__)); /// Invite another node into the mesh. /** This function generates an invitation that can be used by another node to join the same mesh as the local node. @@ -1157,7 +1161,7 @@ char *meshlink_invite_ex(struct meshlink_handle *mesh, struct meshlink_submesh * * @return This function returns a nul-terminated C string that contains the invitation URL, or NULL in case of an error. * The application should call free() after it has finished using the URL. */ -char *meshlink_invite(struct meshlink_handle *mesh, struct meshlink_submesh *submesh, const char *name) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT char *meshlink_invite(struct meshlink_handle *mesh, struct meshlink_submesh *submesh, const char *name) __attribute__((__warn_unused_result__)); /// Use an invitation to join a mesh. /** This function allows the local node to join an existing mesh using an invitation URL generated by another node. @@ -1178,7 +1182,7 @@ char *meshlink_invite(struct meshlink_handle *mesh, struct meshlink_submesh *sub * * @return This function returns true if the local node joined the mesh it was invited to, false otherwise. */ -bool meshlink_join(struct meshlink_handle *mesh, const char *invitation) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_join(struct meshlink_handle *mesh, const char *invitation) __attribute__((__warn_unused_result__)); /// Export the local node's key and addresses. /** This function generates a string that contains the local node's public key and one or more IP addresses. @@ -1194,7 +1198,7 @@ bool meshlink_join(struct meshlink_handle *mesh, const char *invitation) __attri * @return This function returns a nul-terminated C string that contains the exported key and addresses, or NULL in case of an error. * The application should call free() after it has finished using this string. */ -char *meshlink_export(struct meshlink_handle *mesh) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT char *meshlink_export(struct meshlink_handle *mesh) __attribute__((__warn_unused_result__)); /// Import another node's key and addresses. /** This function accepts a string containing the exported public key and addresses of another node. @@ -1210,7 +1214,7 @@ char *meshlink_export(struct meshlink_handle *mesh) __attribute__((__warn_unused * * @return This function returns true if the data was valid and the other node has been granted access to the mesh, false otherwise. */ -bool meshlink_import(struct meshlink_handle *mesh, const char *data) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_import(struct meshlink_handle *mesh, const char *data) __attribute__((__warn_unused_result__)); /// Forget any information about a node. /** This function allows the local node to forget any information it has about a node, @@ -1232,7 +1236,7 @@ bool meshlink_import(struct meshlink_handle *mesh, const char *data) __attribute * * @return This function returns true if all currently known data about the node has been forgotten, false otherwise. */ -bool meshlink_forget_node(struct meshlink_handle *mesh, struct meshlink_node *node); +MESHLINK_EXPORT bool meshlink_forget_node(struct meshlink_handle *mesh, struct meshlink_node *node); /// Blacklist a node from the mesh. /** This function causes the local node to blacklist another node. @@ -1245,7 +1249,7 @@ bool meshlink_forget_node(struct meshlink_handle *mesh, struct meshlink_node *no * * @return This function returns true if the node has been blacklisted, false otherwise. */ -bool meshlink_blacklist(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_blacklist(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); /// Blacklist a node from the mesh by name. /** This function causes the local node to blacklist another node by name. @@ -1260,7 +1264,7 @@ bool meshlink_blacklist(struct meshlink_handle *mesh, struct meshlink_node *node * * @return This function returns true if the node has been blacklisted, false otherwise. */ -bool meshlink_blacklist_by_name(struct meshlink_handle *mesh, const char *name) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_blacklist_by_name(struct meshlink_handle *mesh, const char *name) __attribute__((__warn_unused_result__)); /// Whitelist a node on the mesh. /** This function causes the local node to whitelist a previously blacklisted node. @@ -1273,7 +1277,7 @@ bool meshlink_blacklist_by_name(struct meshlink_handle *mesh, const char *name) * * @return This function returns true if the node has been whitelisted, false otherwise. */ -bool meshlink_whitelist(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_whitelist(struct meshlink_handle *mesh, struct meshlink_node *node) __attribute__((__warn_unused_result__)); /// Whitelist a node on the mesh by name. /** This function causes the local node to whitelist a node by name. @@ -1289,7 +1293,7 @@ bool meshlink_whitelist(struct meshlink_handle *mesh, struct meshlink_node *node * * @return This function returns true if the node has been whitelisted, false otherwise. */ -bool meshlink_whitelist_by_name(struct meshlink_handle *mesh, const char *name) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_whitelist_by_name(struct meshlink_handle *mesh, const char *name) __attribute__((__warn_unused_result__)); /// Set whether new nodes are blacklisted by default. /** This function sets the blacklist behaviour for newly discovered nodes. @@ -1302,7 +1306,7 @@ bool meshlink_whitelist_by_name(struct meshlink_handle *mesh, const char *name) * @param mesh A handle which represents an instance of MeshLink. * @param blacklist True if new nodes are to be blacklisted, false if whitelisted. */ -void meshlink_set_default_blacklist(struct meshlink_handle *mesh, bool blacklist); +MESHLINK_EXPORT void meshlink_set_default_blacklist(struct meshlink_handle *mesh, bool blacklist); /// A callback for listening for incoming channels. /** This function is called whenever a remote node wants to open a channel to the local node. @@ -1386,7 +1390,7 @@ typedef void (*meshlink_channel_poll_cb_t)(struct meshlink_handle *mesh, struct * @param cb A pointer to the function which will be called when another node want to open a channel. * If a NULL pointer is given, the callback will be disabled. */ -void meshlink_set_channel_listen_cb(struct meshlink_handle *mesh, meshlink_channel_listen_cb_t cb); +MESHLINK_EXPORT void meshlink_set_channel_listen_cb(struct meshlink_handle *mesh, meshlink_channel_listen_cb_t cb); /// Set the accept callback. /** This functions sets the callback that is called whenever a remote node has opened a channel to the local node. @@ -1402,7 +1406,7 @@ void meshlink_set_channel_listen_cb(struct meshlink_handle *mesh, meshlink_chann * @param cb A pointer to the function which will be called when a new channel has been opened by a remote node. * If a NULL pointer is given, the callback will be disabled. */ -void meshlink_set_channel_accept_cb(struct meshlink_handle *mesh, meshlink_channel_accept_cb_t cb); +MESHLINK_EXPORT void meshlink_set_channel_accept_cb(struct meshlink_handle *mesh, meshlink_channel_accept_cb_t cb); /// Set the receive callback. /** This functions sets the callback that is called whenever another node sends data to the local node. @@ -1417,7 +1421,7 @@ void meshlink_set_channel_accept_cb(struct meshlink_handle *mesh, meshlink_chann * @param cb A pointer to the function which will be called when another node sends data to the local node. * If a NULL pointer is given, the callback will be disabled and incoming data is ignored. */ -void meshlink_set_channel_receive_cb(struct meshlink_handle *mesh, struct meshlink_channel *channel, meshlink_channel_receive_cb_t cb); +MESHLINK_EXPORT void meshlink_set_channel_receive_cb(struct meshlink_handle *mesh, struct meshlink_channel *channel, meshlink_channel_receive_cb_t cb); /// Set the poll callback. /** This functions sets the callback that is called whenever data can be sent to another node. @@ -1432,7 +1436,7 @@ void meshlink_set_channel_receive_cb(struct meshlink_handle *mesh, struct meshli * @param cb A pointer to the function which will be called when data can be sent to another node. * If a NULL pointer is given, the callback will be disabled. */ -void meshlink_set_channel_poll_cb(struct meshlink_handle *mesh, struct meshlink_channel *channel, meshlink_channel_poll_cb_t cb); +MESHLINK_EXPORT void meshlink_set_channel_poll_cb(struct meshlink_handle *mesh, struct meshlink_channel *channel, meshlink_channel_poll_cb_t cb); /// Set the send buffer size of a channel. /** This function sets the desired size of the send buffer. @@ -1443,7 +1447,7 @@ void meshlink_set_channel_poll_cb(struct meshlink_handle *mesh, struct meshlink_ * @param channel A handle for the channel. * @param size The desired size for the send buffer. */ -void meshlink_set_channel_sndbuf(struct meshlink_handle *mesh, struct meshlink_channel *channel, size_t size); +MESHLINK_EXPORT void meshlink_set_channel_sndbuf(struct meshlink_handle *mesh, struct meshlink_channel *channel, size_t size); /// Set the receive buffer size of a channel. /** This function sets the desired size of the receive buffer. @@ -1454,7 +1458,7 @@ void meshlink_set_channel_sndbuf(struct meshlink_handle *mesh, struct meshlink_c * @param channel A handle for the channel. * @param size The desired size for the send buffer. */ -void meshlink_set_channel_rcvbuf(struct meshlink_handle *mesh, struct meshlink_channel *channel, size_t size); +MESHLINK_EXPORT void meshlink_set_channel_rcvbuf(struct meshlink_handle *mesh, struct meshlink_channel *channel, size_t size); /// Set the send buffer storage of a channel. /** This function provides MeshLink with a send buffer allocated by the application. @@ -1467,7 +1471,7 @@ void meshlink_set_channel_rcvbuf(struct meshlink_handle *mesh, struct meshlink_c * If a NULL pointer is given, MeshLink will use its own internal buffer again. * @param size The size of the buffer. */ -void meshlink_set_channel_sndbuf_storage(struct meshlink_handle *mesh, struct meshlink_channel *channel, void *buf, size_t size); +MESHLINK_EXPORT void meshlink_set_channel_sndbuf_storage(struct meshlink_handle *mesh, struct meshlink_channel *channel, void *buf, size_t size); /// Set the receive buffer storage of a channel. /** This function provides MeshLink with a receive buffer allocated by the application. @@ -1480,7 +1484,7 @@ void meshlink_set_channel_sndbuf_storage(struct meshlink_handle *mesh, struct me * If a NULL pointer is given, MeshLink will use its own internal buffer again. * @param size The size of the buffer. */ -void meshlink_set_channel_rcvbuf_storage(struct meshlink_handle *mesh, struct meshlink_channel *channel, void *buf, size_t size); +MESHLINK_EXPORT void meshlink_set_channel_rcvbuf_storage(struct meshlink_handle *mesh, struct meshlink_channel *channel, void *buf, size_t size); /// Set the flags of a channel. /** This function allows changing some of the channel flags. @@ -1493,7 +1497,7 @@ void meshlink_set_channel_rcvbuf_storage(struct meshlink_handle *mesh, struct me * @param channel A handle for the channel. * @param flags A bitwise-or'd combination of flags that set the semantics for this channel. */ -void meshlink_set_channel_flags(struct meshlink_handle *mesh, struct meshlink_channel *channel, uint32_t flags); +MESHLINK_EXPORT void meshlink_set_channel_flags(struct meshlink_handle *mesh, struct meshlink_channel *channel, uint32_t flags); /// Open a reliable stream channel to another node. /** This function is called whenever a remote node wants to open a channel to the local node. @@ -1518,7 +1522,7 @@ void meshlink_set_channel_flags(struct meshlink_handle *mesh, struct meshlink_ch * @return A handle for the channel, or NULL in case of an error. * The handle is valid until meshlink_channel_close() is called. */ -struct meshlink_channel *meshlink_channel_open_ex(struct meshlink_handle *mesh, struct meshlink_node *node, uint16_t port, meshlink_channel_receive_cb_t cb, const void *data, size_t len, uint32_t flags) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_channel *meshlink_channel_open_ex(struct meshlink_handle *mesh, struct meshlink_node *node, uint16_t port, meshlink_channel_receive_cb_t cb, const void *data, size_t len, uint32_t flags) __attribute__((__warn_unused_result__)); /// Open a reliable stream channel to another node. /** This function is called whenever a remote node wants to open a channel to the local node. @@ -1545,7 +1549,7 @@ struct meshlink_channel *meshlink_channel_open_ex(struct meshlink_handle *mesh, * @return A handle for the channel, or NULL in case of an error. * The handle is valid until meshlink_channel_close() is called. */ -struct meshlink_channel *meshlink_channel_open(struct meshlink_handle *mesh, struct meshlink_node *node, uint16_t port, meshlink_channel_receive_cb_t cb, const void *data, size_t len) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT struct meshlink_channel *meshlink_channel_open(struct meshlink_handle *mesh, struct meshlink_node *node, uint16_t port, meshlink_channel_receive_cb_t cb, const void *data, size_t len) __attribute__((__warn_unused_result__)); /// Partially close a reliable stream channel. /** This shuts down the read or write side of a channel, or both, without closing the handle. @@ -1559,7 +1563,7 @@ struct meshlink_channel *meshlink_channel_open(struct meshlink_handle *mesh, str * @param channel A handle for the channel. * @param direction Must be one of SHUT_RD, SHUT_WR or SHUT_RDWR, otherwise this call will not have any affect. */ -void meshlink_channel_shutdown(struct meshlink_handle *mesh, struct meshlink_channel *channel, int direction); +MESHLINK_EXPORT void meshlink_channel_shutdown(struct meshlink_handle *mesh, struct meshlink_channel *channel, int direction); /// Close a reliable stream channel. /** This informs the remote node that the local node has finished sending all data on the channel. @@ -1573,7 +1577,7 @@ void meshlink_channel_shutdown(struct meshlink_handle *mesh, struct meshlink_cha * @param mesh A handle which represents an instance of MeshLink. * @param channel A handle for the channel. */ -void meshlink_channel_close(struct meshlink_handle *mesh, struct meshlink_channel *channel); +MESHLINK_EXPORT void meshlink_channel_close(struct meshlink_handle *mesh, struct meshlink_channel *channel); /// Abort a reliable stream channel. /** This aborts a channel. @@ -1588,7 +1592,7 @@ void meshlink_channel_close(struct meshlink_handle *mesh, struct meshlink_channe * @param mesh A handle which represents an instance of MeshLink. * @param channel A handle for the channel. */ -void meshlink_channel_abort(struct meshlink_handle *mesh, struct meshlink_channel *channel); +MESHLINK_EXPORT void meshlink_channel_abort(struct meshlink_handle *mesh, struct meshlink_channel *channel); /// Transmit data on a channel /** This queues data to send to the remote node. @@ -1604,7 +1608,7 @@ void meshlink_channel_abort(struct meshlink_handle *mesh, struct meshlink_channe * If MESHLINK_CHANNEL_NO_PARTIAL is set, then the result will either be len, * 0 if the buffer is currently too full, or -1 if len is too big even for an empty buffer. */ -ssize_t meshlink_channel_send(struct meshlink_handle *mesh, struct meshlink_channel *channel, const void *data, size_t len) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT ssize_t meshlink_channel_send(struct meshlink_handle *mesh, struct meshlink_channel *channel, const void *data, size_t len) __attribute__((__warn_unused_result__)); /// A callback for cleaning up buffers submitted for asynchronous I/O. /** This callbacks signals that MeshLink has finished using this buffer. @@ -1646,7 +1650,7 @@ typedef void (*meshlink_aio_fd_cb_t)(struct meshlink_handle *mesh, struct meshli * * @return True if the buffer was enqueued, false otherwise. */ -bool meshlink_channel_aio_send(struct meshlink_handle *mesh, struct meshlink_channel *channel, const void *data, size_t len, meshlink_aio_cb_t cb, void *priv) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_channel_aio_send(struct meshlink_handle *mesh, struct meshlink_channel *channel, const void *data, size_t len, meshlink_aio_cb_t cb, void *priv) __attribute__((__warn_unused_result__)); /// Transmit data on a channel asynchronously from a filedescriptor /** This will read up to the specified length number of bytes from the given filedescriptor, and send it over the channel. @@ -1663,7 +1667,7 @@ bool meshlink_channel_aio_send(struct meshlink_handle *mesh, struct meshlink_cha * * @return True if the buffer was enqueued, false otherwise. */ -bool meshlink_channel_aio_fd_send(struct meshlink_handle *mesh, struct meshlink_channel *channel, int fd, size_t len, meshlink_aio_fd_cb_t cb, void *priv) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_channel_aio_fd_send(struct meshlink_handle *mesh, struct meshlink_channel *channel, int fd, size_t len, meshlink_aio_fd_cb_t cb, void *priv) __attribute__((__warn_unused_result__)); /// Receive data on a channel asynchronously /** This registers a buffer that will be filled with incoming channel data. @@ -1682,7 +1686,7 @@ bool meshlink_channel_aio_fd_send(struct meshlink_handle *mesh, struct meshlink_ * * @return True if the buffer was enqueued, false otherwise. */ -bool meshlink_channel_aio_receive(struct meshlink_handle *mesh, struct meshlink_channel *channel, const void *data, size_t len, meshlink_aio_cb_t cb, void *priv) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_channel_aio_receive(struct meshlink_handle *mesh, struct meshlink_channel *channel, const void *data, size_t len, meshlink_aio_cb_t cb, void *priv) __attribute__((__warn_unused_result__)); /// Receive data on a channel asynchronously and send it to a filedescriptor /** This will read up to the specified length number of bytes from the channel, and send it to the filedescriptor. @@ -1699,7 +1703,7 @@ bool meshlink_channel_aio_receive(struct meshlink_handle *mesh, struct meshlink_ * * @return True if the buffer was enqueued, false otherwise. */ -bool meshlink_channel_aio_fd_receive(struct meshlink_handle *mesh, struct meshlink_channel *channel, int fd, size_t len, meshlink_aio_fd_cb_t cb, void *priv) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_channel_aio_fd_receive(struct meshlink_handle *mesh, struct meshlink_channel *channel, int fd, size_t len, meshlink_aio_fd_cb_t cb, void *priv) __attribute__((__warn_unused_result__)); /// Get channel flags. /** This returns the flags used when opening this channel. @@ -1710,7 +1714,7 @@ bool meshlink_channel_aio_fd_receive(struct meshlink_handle *mesh, struct meshli * * @return The flags set for this channel. */ -uint32_t meshlink_channel_get_flags(struct meshlink_handle *mesh, struct meshlink_channel *channel) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT uint32_t meshlink_channel_get_flags(struct meshlink_handle *mesh, struct meshlink_channel *channel) __attribute__((__warn_unused_result__)); /// Get the amount of bytes in the send buffer. /** This returns the amount of bytes in the send buffer. @@ -1722,7 +1726,7 @@ uint32_t meshlink_channel_get_flags(struct meshlink_handle *mesh, struct meshlin * * @return The amount of un-ACKed bytes in the send buffer. */ -size_t meshlink_channel_get_sendq(struct meshlink_handle *mesh, struct meshlink_channel *channel) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT size_t meshlink_channel_get_sendq(struct meshlink_handle *mesh, struct meshlink_channel *channel) __attribute__((__warn_unused_result__)); /// Get the amount of bytes in the receive buffer. /** This returns the amount of bytes in the receive buffer. @@ -1734,7 +1738,7 @@ size_t meshlink_channel_get_sendq(struct meshlink_handle *mesh, struct meshlink_ * * @return The amount of bytes in the receive buffer. */ -size_t meshlink_channel_get_recvq(struct meshlink_handle *mesh, struct meshlink_channel *channel) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT size_t meshlink_channel_get_recvq(struct meshlink_handle *mesh, struct meshlink_channel *channel) __attribute__((__warn_unused_result__)); /// Get the maximum segment size of a channel. /** This returns the amount of bytes that can be sent at once for channels with UDP semantics. @@ -1745,7 +1749,7 @@ size_t meshlink_channel_get_recvq(struct meshlink_handle *mesh, struct meshlink_ * * @return The amount of bytes in the receive buffer. */ -size_t meshlink_channel_get_mss(struct meshlink_handle *mesh, struct meshlink_channel *channel) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT size_t meshlink_channel_get_mss(struct meshlink_handle *mesh, struct meshlink_channel *channel) __attribute__((__warn_unused_result__)); /// Set the connection timeout used for channels to the given node. /** This sets the timeout after which unresponsive channels will be reported as closed. @@ -1757,7 +1761,7 @@ size_t meshlink_channel_get_mss(struct meshlink_handle *mesh, struct meshlink_ch * @param timeout The timeout in seconds after which unresponsive channels will be reported as closed. * The default is 60 seconds. */ -void meshlink_set_node_channel_timeout(struct meshlink_handle *mesh, struct meshlink_node *node, int timeout); +MESHLINK_EXPORT void meshlink_set_node_channel_timeout(struct meshlink_handle *mesh, struct meshlink_node *node, int timeout); /// Hint that a hostname may be found at an address /** This function indicates to meshlink that the given hostname is likely found @@ -1770,7 +1774,7 @@ void meshlink_set_node_channel_timeout(struct meshlink_handle *mesh, struct mesh * given hostname. The caller is free to overwrite or free * this memory once meshlink returns. */ -void meshlink_hint_address(struct meshlink_handle *mesh, struct meshlink_node *node, const struct sockaddr *addr); +MESHLINK_EXPORT void meshlink_hint_address(struct meshlink_handle *mesh, struct meshlink_node *node, const struct sockaddr *addr); /// Enable or disable zeroconf discovery of local peers /** This controls whether zeroconf discovery using the Catta library will be @@ -1780,7 +1784,7 @@ void meshlink_hint_address(struct meshlink_handle *mesh, struct meshlink_node *n * @param mesh A handle which represents an instance of MeshLink. * @param enable Set to true to enable discovery, false to disable. */ -void meshlink_enable_discovery(struct meshlink_handle *mesh, bool enable); +MESHLINK_EXPORT void meshlink_enable_discovery(struct meshlink_handle *mesh, bool enable); /// Inform MeshLink that the local network configuration might have changed /** This is intended to be used when there is no way for MeshLink to get notifications of local network changes. @@ -1790,7 +1794,7 @@ void meshlink_enable_discovery(struct meshlink_handle *mesh, bool enable); * \memberof meshlink_handle * @param mesh A handle which represents an instance of MeshLink. */ -void meshlink_hint_network_change(struct meshlink_handle *mesh); +MESHLINK_EXPORT void meshlink_hint_network_change(struct meshlink_handle *mesh); /// Performs key rotation for an encrypted storage /** This rotates the (master) key for an encrypted storage and discards the old key @@ -1803,7 +1807,7 @@ void meshlink_hint_network_change(struct meshlink_handle *mesh); * * @return This function returns true if the key rotation for the encrypted storage succeeds, false otherwise. */ -bool meshlink_encrypted_key_rotate(struct meshlink_handle *mesh, const void *key, size_t keylen) __attribute__((__warn_unused_result__)); +MESHLINK_EXPORT bool meshlink_encrypted_key_rotate(struct meshlink_handle *mesh, const void *key, size_t keylen) __attribute__((__warn_unused_result__)); /// Set device class timeouts /** This sets the ping interval and timeout for a given device class. @@ -1815,7 +1819,7 @@ bool meshlink_encrypted_key_rotate(struct meshlink_handle *mesh, const void *key * @param pingtimeout The required time within which a peer should respond, in seconds. The default is 5. * The timeout must be smaller than the interval. */ -void meshlink_set_dev_class_timeouts(struct meshlink_handle *mesh, dev_class_t devclass, int pinginterval, int pingtimeout); +MESHLINK_EXPORT void meshlink_set_dev_class_timeouts(struct meshlink_handle *mesh, dev_class_t devclass, int pinginterval, int pingtimeout); /// Set device class fast retry period /** This sets the fast retry period for a given device class. @@ -1826,7 +1830,7 @@ void meshlink_set_dev_class_timeouts(struct meshlink_handle *mesh, dev_class_t d * @param devclass The device class to update * @param fast_retry_period The period during which fast connection retries are done. The default is 0. */ -void meshlink_set_dev_class_fast_retry_period(struct meshlink_handle *mesh, dev_class_t devclass, int fast_retry_period); +MESHLINK_EXPORT void meshlink_set_dev_class_fast_retry_period(struct meshlink_handle *mesh, dev_class_t devclass, int fast_retry_period); /// Set device class maximum timeout /** This sets the maximum timeout for outgoing connection retries for a given device class. @@ -1836,7 +1840,7 @@ void meshlink_set_dev_class_fast_retry_period(struct meshlink_handle *mesh, dev_ * @param devclass The device class to update * @param maxtimeout The maximum timeout between reconnection attempts, in seconds. The default is 900. */ -void meshlink_set_dev_class_maxtimeout(struct meshlink_handle *mesh, dev_class_t devclass, int maxtimeout); +MESHLINK_EXPORT void meshlink_set_dev_class_maxtimeout(struct meshlink_handle *mesh, dev_class_t devclass, int maxtimeout); /// Reset all connection timers /** This resets all timers related to connections, causing pending outgoing connections to be retried immediately. @@ -1845,7 +1849,7 @@ void meshlink_set_dev_class_maxtimeout(struct meshlink_handle *mesh, dev_class_t * \memberof meshlink_handle * @param mesh A handle which represents an instance of MeshLink. */ -void meshlink_reset_timers(struct meshlink_handle *mesh); +MESHLINK_EXPORT void meshlink_reset_timers(struct meshlink_handle *mesh); /// Set which order invitations are committed /** This determines in which order configuration files are written to disk during an invitation. @@ -1856,7 +1860,7 @@ void meshlink_reset_timers(struct meshlink_handle *mesh); * @param mesh A handle which represents an instance of MeshLink. * @param inviter_commits_first If true, then the node that invited a peer will commit data to disk first. */ -void meshlink_set_inviter_commits_first(struct meshlink_handle *mesh, bool inviter_commits_first); +MESHLINK_EXPORT void meshlink_set_inviter_commits_first(struct meshlink_handle *mesh, bool inviter_commits_first); /// Set the URL used to discover the host's external address /** For generating invitation URLs, MeshLink can look up the externally visible address of the local node. @@ -1867,7 +1871,7 @@ void meshlink_set_inviter_commits_first(struct meshlink_handle *mesh, bool invit * @param mesh A handle which represents an instance of MeshLink. * @param url The URL to use for external address queries, or NULL to revert back to the default URL. */ -void meshlink_set_external_address_discovery_url(struct meshlink_handle *mesh, const char *url); +MESHLINK_EXPORT void meshlink_set_external_address_discovery_url(struct meshlink_handle *mesh, const char *url); /// Set the scheduling granularity of the application /** This should be set to the effective scheduling granularity for the application. @@ -1879,7 +1883,7 @@ void meshlink_set_external_address_discovery_url(struct meshlink_handle *mesh, c * @param mesh A handle which represents an instance of MeshLink. * @param granularity The scheduling granularity of the application in microseconds. */ -void meshlink_set_scheduling_granularity(struct meshlink_handle *mesh, long granularity); +MESHLINK_EXPORT void meshlink_set_scheduling_granularity(struct meshlink_handle *mesh, long granularity); /// Sets the storage policy used by MeshLink /** This sets the policy MeshLink uses when it has new information about nodes. @@ -1892,7 +1896,7 @@ void meshlink_set_scheduling_granularity(struct meshlink_handle *mesh, long gran * @param mesh A handle which represents an instance of MeshLink. * @param policy The storage policy to use. */ -void meshlink_set_storage_policy(struct meshlink_handle *mesh, meshlink_storage_policy_t policy); +MESHLINK_EXPORT void meshlink_set_storage_policy(struct meshlink_handle *mesh, meshlink_storage_policy_t policy); #ifdef __cplusplus } diff --git a/src/net.h b/src/net.h index 9994fac6..a7faa4e0 100644 --- a/src/net.h +++ b/src/net.h @@ -113,7 +113,7 @@ void retry(struct meshlink_handle *mesh); int check_port(struct meshlink_handle *mesh); void flush_meta(struct meshlink_handle *mesh, struct connection_t *); -#ifndef HAVE_MINGW +#ifndef _WIN32 #define closesocket(s) close(s) #endif diff --git a/src/utils.c b/src/utils.c index 6e1c4ccb..9bdd0759 100644 --- a/src/utils.c +++ b/src/utils.c @@ -172,7 +172,7 @@ int b64encode_urlsafe(const void *src, char *dst, int length) { return b64encode_internal(src, dst, length, base64_urlsafe); } -#if defined(HAVE_MINGW) || defined(HAVE_CYGWIN) +#if defined(_WIN32) || defined(HAVE_CYGWIN) #ifdef HAVE_CYGWIN #include #endif diff --git a/src/utils.h b/src/utils.h index dfbb2055..80679658 100644 --- a/src/utils.h +++ b/src/utils.h @@ -27,7 +27,7 @@ int b64encode(const void *src, char *dst, int length); int b64encode_urlsafe(const void *src, char *dst, int length); int b64decode(const char *src, void *dst, int length); -#ifdef HAVE_MINGW +#ifdef _WIN32 const char *winerror(int); #define strerror(x) ((x)>0?strerror(x):winerror(GetLastError())) #define sockerrno WSAGetLastError() @@ -47,4 +47,8 @@ const char *winerror(int); unsigned int bitfield_to_int(const void *bitfield, size_t size) __attribute__((__warn_unused_result__)); +#ifndef MIN +#define MIN(x, y) (((x) < (y)) ? (x) : (y)) +#endif + #endif diff --git a/src/xalloc.h b/src/xalloc.h index 948723e3..53938ca3 100644 --- a/src/xalloc.h +++ b/src/xalloc.h @@ -64,7 +64,7 @@ static inline char *xstrdup(const char *s) { } static inline int xvasprintf(char **strp, const char *fmt, va_list ap) { -#ifdef HAVE_MINGW +#ifdef _WIN32 char buf[1024]; int result = vsnprintf(buf, sizeof(buf), fmt, ap); diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt new file mode 100644 index 00000000..28bb169e --- /dev/null +++ b/test/CMakeLists.txt @@ -0,0 +1,46 @@ +include_directories (../src) + +function(add_test_executable name) + add_executable(${name} ${ARGN}) + target_link_libraries(${name} meshlink) + add_test(NAME ${name} COMMAND ${name}) + set_tests_properties(${name} PROPERTIES SKIP_RETURN_CODE 77 TIMEOUT 30) +endfunction() + +add_executable(stream stream.c) + +add_test_executable(api_set_node_status_cb api_set_node_status_cb.c utils.c) +add_test_executable(basic basic.c utils.c) +add_test_executable(blacklist blacklist.c utils.c) +add_test_executable(channels-aio-abort channels-aio-abort.c utils.c) +add_test_executable(channels-aio-cornercases channels-aio-cornercases.c utils.c) +add_test_executable(channels-aio-fd channels-aio-fd.c utils.c) +add_test_executable(channels-aio channels-aio.c utils.c) +add_test_executable(channels-buffer-storage channels-buffer-storage.c utils.c) +add_test_executable(channels-cornercases channels-cornercases.c utils.c) +add_test_executable(channels-failure channels-failure.c utils.c) +add_test_executable(channels-fork channels-fork.c utils.c) +add_test_executable(channels-no-partial channels-no-partial.c utils.c) +add_test_executable(channels-udp-cornercases channels-udp-cornercases.c utils.c) +add_test_executable(channels-udp channels-udp.c utils.c) +add_test_executable(channels channels.c utils.c) +add_test_executable(discovery discovery.c utils.c) +add_test_executable(duplicate duplicate.c utils.c) +#add_test_executable(echo-fork echo-fork.c utils.c) +add_test_executable(encrypted encrypted.c utils.c) +add_test_executable(ephemeral ephemeral.c utils.c) +add_test_executable(get-all-nodes get-all-nodes.c utils.c) +add_test_executable(import-export import-export.c utils.c) +add_test_executable(invite-join invite-join.c utils.c) +add_test_executable(meta-connections meta-connections.c utils.c netns_utils.c) +add_test_executable(metering-relayed metering-relayed.c utils.c netns_utils.c) +add_test_executable(metering-slowping metering-slowping.c utils.c netns_utils.c) +add_test_executable(metering-tcponly metering-tcponly.c utils.c netns_utils.c) +add_test_executable(metering metering.c utils.c netns_utils.c) +add_test_executable(port port.c utils.c) +add_test_executable(sign-verify sign-verify.c utils.c) +add_test_executable(storage-policy storage-policy.c utils.c) +add_test_executable(trio trio.c utils.c) +add_test_executable(trio2 trio2.c utils.c) + +# TODO: add UTCP stream tests -- 2.39.5