docu

1 files changed, 14 insertions, 2 deletions

diff --git a/src/ats/gnunet-service-ats_addresses.c b/src/ats/gnunet-service-ats_addresses.c
index ee6f28770..8d9f91a94 100644
--- a/src/ats/gnunet-service-ats_addresses.c
+++ b/src/ats/gnunet-service-ats_addresses.c
@@ -105,9 +105,21 @@
  * kept. If session == 0, the addresses is removed.
  *
  * -- Requesting an address suggestion
- * FIXME
+ * The address client issues a request address message to be notified about
+ * address suggestions for a specific peer. Addresses asks the solver with s_get.
+ * If no address is available, it will not send a response, otherwise it will
+ * respond with the choosen address.
  *
- * - Address suggestions:
+ * -- Address suggestions
+ * Addresses will notify the client automatically on any bandwidth_changed_cb
+ * by the solver if a address suggestion request is pending. If no address is
+ * available it will not respond at all If the client is not interested anymore,
+ * it has to cancel the address suggestion request.
+ *
+ * -- Suggestions blocks and reset
+ * After suggesting an address it is blocked for ATS_BLOCKING_DELTA sec. to
+ * prevent the client from being thrashed. If the client requires immediately
+ * it can reset this block using GAS_addresses_handle_backoff_reset.
  *
  * - Bandwidth assignment
  *