X-Git-Url: http://git.meshlink.io/?a=blobdiff_plain;f=src%2Fmeshlink%2B%2B.h;h=bca39fd32332a2e3497e08a36f56c39056e49173;hb=5f2e8877486869471041b0eca1aaed841c41a1a9;hp=11e7eabb99d71dc260acfd9c413dd00a21a71b5b;hpb=11d4da4957cb576abe9ee79c9893809a34f1f3d9;p=meshlink

diff --git a/src/meshlink++.h b/src/meshlink++.h
index 11e7eabb..bca39fd3 100644
--- a/src/meshlink++.h
+++ b/src/meshlink++.h
@@ -486,11 +486,10 @@ public:
 		return meshlink_set_canonical_address(handle, node, address, port);
 	}
 
-	/// Set the canonical Address for the local node.
-	/** This function sets the canonical Address for the local node.
-	 *  This address is stored permanently until it is changed by another call to this function,
-	 *  unlike other addresses associated with a node,
-	 *  such as those added with meshlink_hint_address() or addresses discovered at runtime.
+	/// 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.
+	 *  This address is not stored permanently.
+	 *  Multiple addresses can be added using multiple calls to this function.
 	 *
 	 *  @param address      A nul-terminated C string containing the address, which can be either in numeric format or a hostname.
 	 *  @param port         A nul-terminated C string containing the port, which can be either in numeric or symbolic format.
@@ -498,19 +497,27 @@ public:
 	 *
 	 *  @return             This function returns true if the address was added, false otherwise.
 	 */
-	bool set_canonical_address(const char *address, const char *port = NULL) {
-		return meshlink_set_canonical_address(handle, get_self(), address, port);
+	bool add_invitation_address(const char *address, const char *port) {
+		return meshlink_add_invitation_address(handle, address, port);
+	}
+
+	/// Clears all invitation address for the local node.
+	/** This function removes all addresses added with meshlink_add_invitation_address().
+	 */
+	void clear_invitation_addresses() {
+		return meshlink_clear_invitation_addresses(handle);
 	}
 
 	/// Add an Address for the local node.
 	/** This function adds an Address for the local node, which will be used for invitation URLs.
+	 *  @deprecated This function is deprecated, use set_canonical_address() and/or add_invitation_address().
 	 *
 	 *  @param address      A string containing the address, which can be either in numeric format or a hostname.
 	 *
 	 *  @return             This function returns true if the address was added, false otherwise.
 	 */
-	bool add_address(const char *address) {
-		return meshlink_add_address(handle, address);
+	bool add_address(const char *address) __attribute__((__deprecated__("use set_canonical_address() and/or add_invitation_address() instead"))) {
+		return meshlink_set_canonical_address(handle, get_self(), address, NULL);
 	}
 
 	/** This function performs tries to discover the local node's external address
@@ -612,6 +619,18 @@ public:
 		meshlink_set_invitation_timeout(handle, timeout);
 	}
 
+	/// Set the scheduling granularity of the application
+	/** This should be set to the effective scheduling granularity for the application.
+	 *  This depends on the scheduling granularity of the operating system, the application's
+	 *  process priority and whether it is running as realtime or not.
+	 *  The default value is 10000 (10 milliseconds).
+	 *
+	 *  @param granularity  The scheduling granularity of the application in microseconds.
+	 */
+	void set_granularity(long granularity) {
+		meshlink_set_scheduling_granularity(handle, granularity);
+	}
+
 	/// 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.
 	 *  The generated invitation is a string containing a URL.
@@ -745,7 +764,7 @@ public:
 	 *  This is useful if new nodes are blacklisted by default.
 	 *
 	 *  \memberof meshlink_node
-	 *  @param node         A pointer to a struct meshlink_node describing the node to be whitelisted.
+	 *  @param name         The name of the node to whitelist.
 	 *
 	 *  @return             This function returns true if the node has been whitelisted, false otherwise.
 	 */
@@ -796,7 +815,7 @@ public:
 	/** This sets the timeout after which unresponsive channels will be reported as closed.
 	 *  The timeout is set for all current and future channels to the given node.
 	 *
-	 *  @param channel      A handle for the channel.
+	 *  @param node         The node to set the channel timeout for.
 	 *  @param timeout      The timeout in seconds after which unresponsive channels will be reported as closed.
 	 *                      The default is 60 seconds.
 	 */
@@ -986,6 +1005,17 @@ public:
 		return meshlink_channel_get_recvq(handle, channel);
 	}
 
+	/// 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.
+	 *
+	 *  @param channel      A handle for the channel.
+	 *
+	 *  @return             The amount of bytes in the receive buffer.
+	 */
+	size_t channel_get_mss(channel *channel) {
+		return meshlink_channel_get_mss(handle, channel);
+	};
+
 	/// Enable or disable zeroconf discovery of local peers
 	/** This controls whether zeroconf discovery using the Catta library will be
 	 *  enabled to search for peers on the local network. By default, it is enabled.