From: Christian Grothoff <christian@grothoff.org>
Date: Thu, 21 Jan 2010 08:21:19 +0000 (+0000)
Subject: blacklisting API
X-Git-Tag: initial-import-from-subversion-38251~22914
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=92cb20c180e4190494ad837682b1a6fb1fdd1e01;p=oweals%2Fgnunet.git

blacklisting API
---

diff --git a/src/include/gnunet_transport_service.h b/src/include/gnunet_transport_service.h
index 1c32f10f1..10b7e8f89 100644
--- a/src/include/gnunet_transport_service.h
+++ b/src/include/gnunet_transport_service.h
@@ -294,6 +294,77 @@ GNUNET_TRANSPORT_address_lookup (struct GNUNET_SCHEDULER_Handle *sched,
 
 
 
+
+/**
+ * Blacklist a peer for a given period of time.  All connections
+ * (inbound and outbound) to a peer that is blacklisted will be
+ * dropped (as soon as we learn who the connection is for).  A second
+ * call to this function for the same peer overrides previous
+ * blacklisting requests.
+ *
+ * @param sched scheduler to use
+ * @param cfg configuration to use
+ * @param peer identity of peer to blacklist
+ * @param duration how long to blacklist, use GNUNET_TIME_UNIT_ZERO to
+ *        re-enable connections
+ */
+void
+GNUNET_TRANSPORT_blacklist (struct GNUNET_SCHEDULER_Handle *sched,
+			    const struct GNUNET_CONFIGURATION_Handle *cfg,
+			    const struct GNUNET_PeerIdentity *peer,
+			    struct GNUNET_TIME_Relative duration);
+
+
+/**
+ * Handle for blacklist notifications.
+ */
+struct GNUNET_TRANSPORT_BlacklistNotification;
+
+
+/**
+ * Signature of function called whenever the blacklist status of
+ * a peer changes.  This includes changes to the duration of the
+ * blacklist status as well as the expiration of an existing
+ * blacklist status.
+ *
+ * @param cls closure
+ * @param peer identity of peer with the change
+ * @param until GNUNET_TIME_UNIT_ZERO_ABS if the peer is no
+ *              longer blacklisted, otherwise the time at
+ *              which the current blacklisting will expire
+ */
+typedef void (*GNUNET_TRANSPORT_BlacklistCallback)(void *cls,
+						   const struct GNUNET_PeerIdentity *peer,
+						   struct GNUNET_TIME_Absolute until);
+
+
+/**
+ * Call a function whenever a peer's blacklisting status changes.
+ *
+ * @param sched scheduler to use
+ * @param cfg configuration to use
+ * @param bc function to call on status changes
+ * @param bc_cls closure for bc
+ * @return NULL on error, otherwise handle for cancellation
+ */
+struct GNUNET_TRANSPORT_BlacklistNotification *
+GNUNET_TRANSPORT_blacklist_notify (struct GNUNET_SCHEDULER_Handle *sched,
+				   const struct GNUNET_CONFIGURATION_Handle *cfg,
+				   GNUNET_TRANSPORT_BlacklistCallback bc,
+				   void *bc_cls);
+
+
+/**
+ * Stop calling the notification callback associated with
+ * the given blacklist notification.
+ *
+ * @param bn handle of the request that is to be cancelled
+ */
+void
+GNUNET_TRANSPORT_blacklist_notify_cancel (struct GNUNET_TRANSPORT_BlacklistNotification * bn);
+
+
+
 #if 0                           /* keep Emacsens' auto-indent happy */
 {
 #endif