BIND 10 trac1976-cont-2, updated. e675dc75b6fbe186980798b8e3c7106a17de40dd [1976] Interface of the reload method

[BIND 10 source code commits]

The branch, trac1976-cont-2 has been updated
       via  e675dc75b6fbe186980798b8e3c7106a17de40dd (commit)
      from  77cc51898582ef249035a5ea3b99501d76143bde (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit e675dc75b6fbe186980798b8e3c7106a17de40dd
Author: Michal 'vorner' Vaner <michal.vaner at nic.cz>
Date:   Thu Jul 5 11:20:54 2012 +0200

    [1976] Interface of the reload method

-----------------------------------------------------------------------

Summary of changes:
 src/lib/datasrc/client_list.h |   22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

-----------------------------------------------------------------------
diff --git a/src/lib/datasrc/client_list.h b/src/lib/datasrc/client_list.h
index 8d54e6d..e4aff6e 100644
--- a/src/lib/datasrc/client_list.h
+++ b/src/lib/datasrc/client_list.h
@@ -238,6 +238,28 @@ public:
         return (configuration_);
     }
 
+    /// \brief Result of the reload() method.
+    enum ReloadResult {
+        CACHE_DISABLED,     ///< The cache is not enabled in this list.
+        ZONE_NOT_CACHED,    ///< Zone exists, but is not cached.
+        ZONE_NOT_FOUND,     ///< No data source in the list provides the zone.
+        ZONE_RELOADED       ///< The zone was successfully reloaded.
+    };
+
+    /// \brief Reloads a cached zone.
+    ///
+    /// This method finds a zone which is loaded into a cache and reloads it.
+    /// This may be used to renew the cache when the underlying data source
+    /// changes.
+    ///
+    /// \param zone The origin of the zone to reload.
+    /// \return A status if the command worked.
+    /// \throw DataSourceError or anything else that the data source
+    ///      containing the zone might throw is propagated.
+    /// \throw DataSourceError if something unexpected happens, like when
+    ///      the original data source no longer contains the cached zone.
+    ReloadResult reload(const dns::Name& zone);
+
     /// \brief Implementation of the ClientList::find.
     virtual FindResult find(const dns::Name& zone,
                             bool want_exact_match = false,