[net] HostResolverImpl + DnsTransaction + DnsConfigService = Asynchronous DNS ready for experiments.

net/base/net_log_event_type_list.h

 // Copyright (c) 2012 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 38 matching lines @@
 // The BEGIN phase contains the following parameters:
 //
 //   {
 //     "host": <Hostname associated with the request>,
 //     "source_dependency": <Source id, if any, of what created the request>,
 //   }
 //
 // If an error occurred, the END phase will contain these parameters:
 //   {
 //     "net_error": <The net error code integer for the failure>,
-//     "os_error": <The exact error code integer that getaddrinfo() returned>,
 //   }
 EVENT_TYPE(HOST_RESOLVER_IMPL_REQUEST)
 
 // This event is logged when a request is handled by a cache entry.
 EVENT_TYPE(HOST_RESOLVER_IMPL_CACHE_HIT)
 
 // This event is created when a new HostResolverImpl::Job is about to be created
 // for a request.
 EVENT_TYPE(HOST_RESOLVER_IMPL_CREATE_JOB)
 
 // The creation/completion of a HostResolverImpl::Job which is created for
 // Requests that cannot be resolved synchronously.
 //
 // The BEGIN phase contains the following parameters:
 //
 //   {
 //     "host": <Hostname associated with the request>,
 //     "source_dependency": <Source id, if any, of what created the request>,
 //   }
 //
 // On success, the END phase has these parameters:
 //   {
 //     "address_list": <The host name being resolved>,
 //   }
 // If an error occurred, the END phase will contain these parameters:
 //   {
 //     "net_error": <The net error code integer for the failure>,
-//     "os_error": <The exact error code integer that getaddrinfo() returned>,
 //   }
 EVENT_TYPE(HOST_RESOLVER_IMPL_JOB)
 
 // This event is created when a HostResolverImpl::Job is evicted from
 // PriorityDispatch before it can start, because the limit on number of queued
 // Jobs was reached.
 EVENT_TYPE(HOST_RESOLVER_IMPL_JOB_EVICTED)
 
 // This event is created when a HostResolverImpl::Job is started by
 // PriorityDispatch.
@@ skipping 49 matching lines @@
 // This is logged for a job when a request is cancelled and detached.
 //
 // The event contains the following parameters:
 //
 //   {
 //     "source_dependency": <Source identifier for the detached Request>,
 //     "priority": <New priority of the job>,
 //   }
 EVENT_TYPE(HOST_RESOLVER_IMPL_JOB_REQUEST_DETACH)
 
-// Logged for a HostResolverImpl::Job when it creates a ProcTask.
-//
-// The event contains the following parameters:
-//
-//   {
-//     "source_dependency": <Source id of parent HostResolverImpl::Job>,
-//   }
-EVENT_TYPE(HOST_RESOLVER_IMPL_CREATE_PROC_TASK)
-
 // The creation/completion of a HostResolverImpl::ProcTask to call getaddrinfo.
 // The BEGIN phase contains the following parameters:
 //
 //   {
 //     "hostname": <Hostname associated with the request>,
-//     "source_dependency": <Source id of parent HostResolverImpl::Job>,
 //   }
 //
 // On success, the END phase has these parameters:
 //   {
-//     "address_list": <The host name being resolved>,
+//     "address_list": <The resolved addresses>,
 //   }
 // If an error occurred, the END phase will contain these parameters:
 //   {
 //     "net_error": <The net error code integer for the failure>,
 //     "os_error": <The exact error code integer that getaddrinfo() returned>,
 //   }
 EVENT_TYPE(HOST_RESOLVER_IMPL_PROC_TASK)
 
+// The creation/completion of a HostResolverImpl::DnsTask to manage a
+// DnsTransaction. The BEGIN phase contains the following parameters:
+//
+//   {
+//     "source_dependency": <Source id of DnsTransaction>,
+//   }
+//
+// On success, the END phase has these parameters:
+//   {
+//     "address_list": <The resolved addresses>,
+//   }
+// If an error occurred, the END phase will contain these parameters:
+//   {
+//     "net_error": <The net error code integer for the failure>,
+//     "dns_error": <The detailed DnsResponse::Result>
+//   }
+EVENT_TYPE(HOST_RESOLVER_IMPL_DNS_TASK)
+
 // ------------------------------------------------------------------------
 // InitProxyResolver
 // ------------------------------------------------------------------------
 
 // The start/end of auto-detect + custom PAC URL configuration.
 EVENT_TYPE(PROXY_SCRIPT_DECIDER)
 
 // The start/end of when proxy autoconfig was artificially paused following
 // a network change event. (We wait some amount of time after being told of
 // network changes to avoid hitting spurious errors during auto-detect).
@@ skipping 1053 matching lines @@
 // DnsTransaction
 // ------------------------------------------------------------------------
 
 // The start/end of a DnsTransaction.
 //
 // The BEGIN phase contains the following parameters:
 //
 // {
 //   "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:
 //
 // {
 //   "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.
@@ skipping 10 matching lines @@
 //   "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 fully-qualified name.
 //
 // It has a single parameter:
 //
 //   {
-//     "socket_source": <Source id of the UDP socket created for the attempt>,
+//     "source_dependency": <Source id of the UDP socket created for the
+//                           attempt>,
 //   }
 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": <Source id of the UDP socket that received the
-//                       response>,
+//     "source_dependency": <Source id of the UDP socket that received the
+//                           response>,
 //   }
 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>,
-//   }
-EVENT_TYPE(ASYNC_HOST_RESOLVER)
-
-// The start/end of a host resolve (DNS) request.
-//
-// The BEGIN phase contains the following parameters:
-//
-//   {
-//     "hostname": <Hostname associated with the request>,
-//     "address_family": <Address family of the request>,
-//     "allow_cached_response": <Whether to allow cached response>,
-//     "only_use_cached_response": <Use cached results only>,
-//     "is_speculative": <Whether the lookup is speculative>,
-//     "priority": <Priority of the request>,
-//     "source_dependency": <Source id, if any, of what created the request>,
-//   }
-//
-// If an error occurred, the END phase will contain this parameter:
-//   {
-//     "net_error": <The net error code integer for the failure>,
-//   }
-EVENT_TYPE(ASYNC_HOST_RESOLVER_REQUEST)
-
-// This event is created when a new DnsTransaction is about to be created
-// for a request.
-EVENT_TYPE(ASYNC_HOST_RESOLVER_CREATE_DNS_TRANSACTION)
-
-// This event is logged when a request is handled by a cache entry.
-EVENT_TYPE(ASYNC_HOST_RESOLVER_CACHE_HIT)
-
-// ------------------------------------------------------------------------
 // ChromeExtension
 // ------------------------------------------------------------------------
 
 // TODO(eroman): This is a layering violation. Fix this in the context
 // of http://crbug.com/90674.
 
 // This event is created when a Chrome extension aborts a request.
 //
 //  {
 //    "extension_id": <Extension ID that caused the abortion>
@@ skipping 279 matching lines @@
 // This may occur even when the file is not open.
 EVENT_TYPE(FILE_STREAM_CLOSE)
 
 // This event is created when a file stream operation has an error.
 //   {
 //     "operation": <open, write, close, etc>,
 //     "os_error": <OS-dependent error code>,
 //     "net_error": <net::Error code>,
 //   }
 EVENT_TYPE(FILE_STREAM_ERROR)