DnsClient refactoring + features (timeout, suffix search, server rotation).

net/base/net_log_event_type_list.h

 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // NOTE: No header guards are used, since this file is intended to be expanded
 // directly into net_log.h. DO NOT include this file anywhere else.
 
 // In the event of a failure, a many end events will have a |net_error|
 // parameter with the integer error code associated with the failure.  Most
 // of these parameters are not individually documented.
@@ skipping 1187 matching lines @@
 
 // ------------------------------------------------------------------------
 // DnsTransaction
 // ------------------------------------------------------------------------
 
 // The start/end of a DnsTransaction.
 //
 // The BEGIN phase contains the following parameters:
 //
 // {
-//   "dns_server": <IP of the DNS server to which queries are sent>,
 //   "hostname": <The hostname it is trying to resolve>,
 //   "query_type": <Type of the query>,
 //   "source_dependency":  <Source id, if any, of what created the
 //                          transaction>,
 // }
 //
 // The END phase contains the following parameters:
 //
 // {
-//   "ip_address_list": <The result of the resolution process,
-//                       an IPAddressList>
 //   "net_error": <The net error code for the failure, if any>,
 // }
 EVENT_TYPE(DNS_TRANSACTION)
 
+// The start/end of a DnsTransaction query for a fully-qualified domain name.
+//
+// The BEGIN phase contains the following parameters:
+//
+// {
+//   "qname": <The fully-qualified domain name it is trying to resolve>,
+// }
+//
+// The END phase contains the following parameters:
+//
+// {
+//   "net_error": <The net error code for the failure, if any>,
+// }
+EVENT_TYPE(DNS_TRANSACTION_QUERY)
+
 // This event is created when DnsTransaction creates a new UDP socket and
-// tries to resolve the hostname.
+// tries to resolve the fully-qualified name.
 //
 // It has a single parameter:
 //
 //   {
-//     "attempt_number": <current attempt number at resolving hostname>
-//     "source_dependency": <Source id of the UDP socket that caused the
-//                           attempt>,
+//     "socket": <Source id of the UDP socket created for the attempt>,

[mmenke, 2012/01/13 16:44:37]

nit:  Think "socket_source" is a little clearer.

 //   }
-EVENT_TYPE(DNS_TRANSACTION_ATTEMPT_STARTED)
+EVENT_TYPE(DNS_TRANSACTION_ATTEMPT)
+
+// This event is created when DnsTransaction receives a matching response.
+//
+// It has the following parameters:
+//
+//   {
+//     "rcode": <rcode in the received response>,
+//     "answer_count": <answer_count in the received response>,
+//     "socket": <Source id of the UDP socket that received the response>,

[mmenke, 2012/01/13 16:44:37]

nit:  Think "socket_source" is a little clearer.

+//   }
+EVENT_TYPE(DNS_TRANSACTION_RESPONSE)
 
 // ------------------------------------------------------------------------
 // AsyncHostResolver
 // ------------------------------------------------------------------------
 
 // The start/end of waiting on a host resolve (DNS) request.
 // The BEGIN phase contains the following parameters:
 //
 //   {
 //     "source_dependency": <Source id of the request being waited on>,
@@ skipping 133 matching lines @@
 //                  pipeline capability>,
 //   }
 EVENT_TYPE(HTTP_PIPELINED_CONNECTION_RECEIVED_HEADERS)
 
 // This event is created when a pipelined stream closes.
 //   {
 //     "source_dependency": <Source id of the requesting stream>,
 //     "must_close": <True if the pipeline must shut down>,
 //   }
 EVENT_TYPE(HTTP_PIPELINED_CONNECTION_STREAM_CLOSED)