Connectivity Diagnostics API: chrome.diagnostics.sendPacket

chrome/browser/extensions/api/diagnostics/send_ping_packet.h

+// Copyright (c) 2013 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 CHROME_BROWSER_EXTENSIONS_API_DIAGNOSTICS_SEND_PING_PACKET_H_
+#define CHROME_BROWSER_EXTENSIONS_API_DIAGNOSTICS_SEND_PING_PACKET_H_
+
+#include <string>
+
+#include "base/callback.h"
+
+namespace extensions {

[asargent_no_longer_on_chrome, 2013/06/20 22:51:29]

optional suggestion: It might make more sense to have this namespace be
"extensions::api::diagnostics", and then perhaps rename SendPingPacket to
"SendPacketImpl" Alternatively, consider leaving in extensions namespace but
renaming SendPingPacket to "DiagnosticsSendPacket".

+
+enum SendPingPacketResultCode {
+  SEND_PING_PACKET_OK,
+  SEND_PING_PACKET_NOT_IMPLEMENTED,
+  SEND_PING_PACKET_FAILED,
+};
+
+// Callback for extensions::SendPingPacket
+typedef base::Callback<void(SendPingPacketResultCode result_code,
+                            const std::string& ip,
+                            double latency)>
+  SendPingPacketCallback;
+
+// Sends an ICMP packet with given parameters.
+// Passes NULL for omitted arguments.
+void SendPingPacket(
+    const std::string& ip,
+    const int* ttl,
+    const int* timeout,
+    const int* size,

[asargent_no_longer_on_chrome, 2013/06/20 22:51:29]

nit: you should just pass the integer values here by value, not by const
pointer. (Usually we only use pointer arguments for objects/structs or
out-params). 

[Bei Zhang, 2013/06/21 08:31:07]

Done.

+    const SendPingPacketCallback& callback);
+
+}  // namespace extensions
+
+#endif  // CHROME_BROWSER_EXTENSIONS_API_DIAGNOSTICS_SEND_PING_PACKET_H_