1 files changed, 21 insertions, 0 deletions

diff --git a/src/include/gnunet_messenger_service.h b/src/include/gnunet_messenger_service.h
index 0576e239f..ad5cc4f12 100644
--- a/src/include/gnunet_messenger_service.h
+++ b/src/include/gnunet_messenger_service.h
@@ -50,6 +50,8 @@ extern "C" {
 
 /**
  * Version number of GNUnet Messenger API.
+ *
+ * Current version of the Messenger: 0.1
  */
 #define GNUNET_MESSENGER_VERSION 0x00000001
 
@@ -219,6 +221,10 @@ struct GNUNET_MESSENGER_MessageInfo
 
   /**
    * The version of GNUnet Messenger API.
+   *
+   * The sixteen lower bits represent the lower version number while the sixteen higher bits
+   * represent the higher version number. A different higher version number implies imcompatibility
+   * to lower versions while differences in the lower version can still be supported potentially.
    */
   uint32_t messenger_version;
 };
@@ -672,6 +678,21 @@ void
 GNUNET_MESSENGER_close_room (struct GNUNET_MESSENGER_Room *room);
 
 /**
+ * Searches for a specific <i>contact</i> in a given <i>room</i> and calls a selected <i>callback</i> with a given
+ * closure for each of them containing the contact as a member. The callback will receive a room matching the condition
+ * and the given contact. The function returns the amount of rooms iterated with the given callback.
+ *
+ * @param[in] handle Messenger handle to use
+ * @param[in] contact Contact handle
+ * @param[in] callback Function called for each room
+ * @param[in] cls Closure for the <i>callback</i> handler
+ * @return Amount of rooms iterated
+ */
+int
+GNUNET_MESSENGER_find_rooms (const struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_MESSENGER_Contact *contact,
+                             GNUNET_MESSENGER_MemberCallback callback, void *cls);
+
+/**
  * Get the contact of a member in a <i>room</i> which sent a specific message identified with a given <i>hash</i>.
  *
  * Notice that contacts are independent of rooms but will be removed if all rooms containing these contacts get closed.