Author: mmichelson
Date: Tue Mar 17 14:55:35 2015
New Revision: 433055
URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=433055
Log:
Add some doxygen for tests.
Modified:
team/group/dns/res/res_resolver_unbound.c
Modified: team/group/dns/res/res_resolver_unbound.c
URL:
http://svnview.digium.com/svn/asterisk/team/group/dns/res/res_resolver_unbound.c?view=diff&rev=433055&r1=433054&r2=433055
==============================================================================
--- team/group/dns/res/res_resolver_unbound.c (original)
+++ team/group/dns/res/res_resolver_unbound.c Tue Mar 17 14:55:35 2015
@@ -891,7 +891,11 @@
return res;
}
+/*!
+ * \brief User data for off-nominal async resolution test
+ */
struct off_nominal_async_data {
+ /*! The DNS result's expected rcode */
int expected_rcode;
/*! Whether an asynchronous query failed */
int failed;
@@ -926,6 +930,16 @@
return adata;
}
+/*!
+ * \brief Async callback for off-nominal async test
+ *
+ * This test ensures that there is a result present on the query, then it
checks
+ * that the rcode on the result is the expected value and that there are no
+ * records on the result.
+ *
+ * Once completed, the testing thread is signaled that the async query has
+ * completed.
+ */
static void off_nominal_async_callback(const struct ast_dns_query *query)
{
struct off_nominal_async_data *adata = ast_dns_query_get_data(query);
@@ -1075,6 +1089,9 @@
return off_nominal_test(test, off_nominal_async_run);
}
+/*!
+ * \brief Minimal data required to signal the completion of an async resolve
+ */
struct async_minimal_data {
int complete;
ast_mutex_t lock;
@@ -1104,6 +1121,11 @@
return adata;
}
+/*!
+ * \brief Async callback for off-nominal cancellation test.
+ *
+ * This simply signals the testing thread that the query completed
+ */
static void minimal_callback(const struct ast_dns_query *query)
{
struct async_minimal_data *adata = ast_dns_query_get_data(query);
--
_____________________________________________________________________
-- Bandwidth and Colocation Provided by http://www.api-digital.com --
svn-commits mailing list
To UNSUBSCRIBE or update options visit:
http://lists.digium.com/mailman/listinfo/svn-commits
