debugd: Add TestICMP functionality.

chromeos/dbus/debug_daemon_client.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.
 
 #ifndef CHROMEOS_DBUS_DEBUG_DAEMON_CLIENT_H_
 #define CHROMEOS_DBUS_DEBUG_DAEMON_CLIENT_H_
 
 #include "base/callback.h"
 #include "base/platform_file.h"
 #include "base/memory/ref_counted_memory.h"
@@ skipping 78 matching lines @@
   typedef base::Callback<void(const scoped_refptr<base::RefCountedString>&
       result)> StopSystemTracingCallback;
 
   // Requests to stop system tracing and calls |callback| when completed.
   virtual bool RequestStopSystemTracing(const StopSystemTracingCallback&
       callback) = 0;
 
   // Returns an empty SystemTracingCallback that does nothing.
   static StopSystemTracingCallback EmptyStopSystemTracingCallback();
 
+  // Called once TestICMP() is complete. Takes two parameters:
+  // - succeeded: information was obtained successfully.
+  // - status: information about ICMP connectivity to a specified host as json.
+  //   For details please refer to
+  //   https://gerrit.chromium.org/gerrit/#/c/30310/2/src/helpers/icmp.cc
+  typedef base::Callback<void(bool succeeded, const std::string& status)>
+      TestICMPCallback;
+
+  // Tests ICMP connectivity to a specified host. The |host| contains an IPv4
+  // or IPv6 address.

[satorux1, 2012/08/17 21:13:16]

could you add some examples? can this be a host name like www.google.com?

[hshi1, 2012/08/17 21:23:00]

No this must be numeric IP address. Done.

+  virtual void TestICMP(
+      const std::string& host,

[satorux1, 2012/08/17 21:13:16]

if this only accepts IP address, host -> ip_address

nit: move this to the previous line? 

[hshi1, 2012/08/17 21:23:00]

Done.

+      const TestICMPCallback& callback) = 0;
+
   // Factory function, creates a new instance and returns ownership.
   // For normal usage, access the singleton via DBusThreadManager::Get().
   static DebugDaemonClient* Create(DBusClientImplementationType type,
                                    dbus::Bus* bus);
  protected:
   // Create() should be used instead.
   DebugDaemonClient();
 
  private:
   DISALLOW_COPY_AND_ASSIGN(DebugDaemonClient);
 };
 
 }  // namespace chromeos
 
 #endif  // CHROMEOS_DBUS_DEBUG_DAEMON_CLIENT_H_