| OLD | NEW |
| (Empty) |
| 1 // Copyright 2013 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef CHROME_BROWSER_NET_DNS_PROBE_RUNNER_H_ | |
| 6 #define CHROME_BROWSER_NET_DNS_PROBE_RUNNER_H_ | |
| 7 | |
| 8 #include "base/basictypes.h" | |
| 9 #include "base/bind.h" | |
| 10 #include "base/memory/scoped_ptr.h" | |
| 11 #include "base/memory/weak_ptr.h" | |
| 12 | |
| 13 namespace net { | |
| 14 class DnsClient; | |
| 15 class DnsResponse; | |
| 16 class DnsTransaction; | |
| 17 } | |
| 18 | |
| 19 namespace chrome_browser_net { | |
| 20 | |
| 21 // Runs DNS probes using a single DnsClient and evaluates the responses. | |
| 22 // (Currently requests A records for google.com and expects at least one IP | |
| 23 // address in the response.) | |
| 24 // Used by DnsProbeService to probe the system and public DNS configurations. | |
| 25 class DnsProbeRunner { | |
| 26 public: | |
| 27 static const char* kKnownGoodHostname; | |
| 28 | |
| 29 // Used in histograms; add new entries at the bottom, and don't remove any. | |
| 30 enum Result { | |
| 31 UNKNOWN, | |
| 32 CORRECT, // Response contains at least one A record. | |
| 33 INCORRECT, // Response claimed success but included no A records. | |
| 34 FAILING, // Response included an error or was malformed. | |
| 35 UNREACHABLE // No response received (timeout, network unreachable, etc.). | |
| 36 }; | |
| 37 | |
| 38 DnsProbeRunner(); | |
| 39 ~DnsProbeRunner(); | |
| 40 | |
| 41 // Sets the DnsClient that will be used for DNS probes sent by this runner. | |
| 42 // Must be called before RunProbe; can be called repeatedly, including during | |
| 43 // a probe. It will not affect an in-flight probe, if one is running. | |
| 44 void SetClient(scoped_ptr<net::DnsClient> client); | |
| 45 | |
| 46 // Starts a probe using the client specified with SetClient, which must have | |
| 47 // been called before RunProbe. |callback| will be called asynchronously | |
| 48 // when the result is ready, even if it is ready synchronously. Must not | |
| 49 // be called again until the callback is called, but may be called during the | |
| 50 // callback. | |
| 51 void RunProbe(const base::Closure& callback); | |
| 52 | |
| 53 // Returns true if a probe is running. Guaranteed to return true after | |
| 54 // RunProbe returns, and false during and after the callback. | |
| 55 bool IsRunning() const; | |
| 56 | |
| 57 // Returns the result of the last probe. | |
| 58 Result result() const { return result_; } | |
| 59 | |
| 60 private: | |
| 61 void OnTransactionComplete(net::DnsTransaction* transaction, | |
| 62 int net_error, | |
| 63 const net::DnsResponse* response); | |
| 64 void CallCallback(); | |
| 65 | |
| 66 base::WeakPtrFactory<DnsProbeRunner> weak_factory_; | |
| 67 | |
| 68 scoped_ptr<net::DnsClient> client_; | |
| 69 | |
| 70 // The callback passed to |RunProbe|. Cleared right before calling the | |
| 71 // callback. | |
| 72 base::Closure callback_; | |
| 73 | |
| 74 // The transaction started in |RunProbe| for the DNS probe. Reset once the | |
| 75 // results have been examined. | |
| 76 scoped_ptr<net::DnsTransaction> transaction_; | |
| 77 | |
| 78 Result result_; | |
| 79 | |
| 80 DISALLOW_COPY_AND_ASSIGN(DnsProbeRunner); | |
| 81 }; | |
| 82 | |
| 83 } // namespace chrome_browser_net | |
| 84 | |
| 85 #endif // CHROME_BROWSER_NET_DNS_PROBE_RUNNER_H_ | |
| OLD | NEW |