GDB support for Android in devtools' debugger.

mojo/devtools/common/android_gdb/remote_file_connection.py

+# Copyright 2015 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.
+
+import socket
+import struct
+
+
+class RemoteFileConnectionException(Exception):
+  def __init__(self, *args, **kwargs):
+    Exception.__init__(self, *args, **kwargs)
+
+
+class RemoteFileConnection(object):
+  """Client for remote_file_reader server, allowing to read files on an
+  remote device.
+  """
+  def __init__(self, host, port):
+    self._host = host
+    self._port = port
+    self._socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    self._size_struct = struct.Struct("!i")
+
+  def __del__(self):
+    self.disconnect()
+
+  def connect(self):
+    self._socket.connect((self._host, self._port))
+
+  def disconnect(self):
+    self._socket.close()
+
+  def open(self, filename):
+    self._send("O %s\n" % filename)
+    result = self._receive(1)
+    if result != 'O':
+      raise RemoteFileConnectionException("Unable to open file " + filename)
+
+  def seek(self, pos, mode=0):
+    self._send("S %d %d\n" % (pos, mode))
+    result = self._receive(1)
+    if result != 'O':
+      raise RemoteFileConnectionException("Unable to seek in file.")
+
+  def read(self, size=0):
+    assert size > 0
+    self._send("R %d\n" % size)
+    result = self._receive(1)
+    if result != 'O':
+      raise RemoteFileConnectionException("Unable to read file.")
+    read_size = self._size_struct.unpack(self._receive(4))[0]
+    return self._receive(read_size)
+
+  def _send(self, data):
+    while len(data) > 0:
+      sent = self._socket.send(data)
+      if sent == 0:
+        raise RemoteFileConnectionException("Socket connection broken.")
+      data = data[sent:]
+
+  def _receive(self, length):
+    result = []
+    while length > 0:
+      chunk = self._socket.recv(length)
+      if chunk == '':
+        raise RemoteFileConnectionException("Socket connection broken.")
+      result.append(chunk)
+      length -= len(chunk)
+    return ''.join(result)