From: Matthias Wachs <wachs@net.in.tum.de>
Date: Fri, 15 Feb 2013 12:12:01 +0000 (+0000)
Subject: docu
X-Git-Tag: initial-import-from-subversion-38251~9907
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=f1040b05b92c13eb81dd7128e5bc0e633dbcbb49;p=oweals%2Fgnunet.git

docu
---

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
  *