Order files

android/tools/android-osx/platform-tools/systrace/AUTHORS

@@ -0,0 +1,12 @@
+# Names should be added to this file with this pattern:
+#
+# For individuals:
+#   Name <email address>
+#
+# For organizations:
+#   Organization <fnmatch pattern>
+#
+# See python fnmatch module documentation for more information.
+
+The Chromium Authors <*@chromium.org>
+Google Inc. <*@google.com>

android/tools/android-osx/platform-tools/systrace/LICENSE

@@ -0,0 +1,27 @@
+// Copyright (c) 2010 The Chromium Authors. All rights reserved.
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//    * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//    * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//    * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

android/tools/android-osx/platform-tools/systrace/NOTICE

@@ -0,0 +1,205 @@
+// Copyright (c) 2012 The Chromium Authors. All rights reserved.
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//    * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//    * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//    * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

android/tools/android-osx/platform-tools/systrace/UPSTREAM_REVISION

@@ -0,0 +1 @@
+775

android/tools/android-osx/platform-tools/systrace/prefix.html

@@ -0,0 +1,38 @@
+<!DOCTYPE HTML>
+<html>
+<head i18n-values="dir:textdirection;">
+<meta charset="utf-8"/>
+<title>Android System Trace</title>
+%s
+%s
+<script language="javascript">
+document.addEventListener('DOMContentLoaded', function() {
+  if (!linuxPerfData)
+    return;
+
+  var m = new tracing.TraceModel(linuxPerfData);
+  var timelineViewEl = document.querySelector('.view');
+  ui.decorate(timelineViewEl, tracing.TimelineView);
+  timelineViewEl.model = m;
+  timelineViewEl.tabIndex = 1;
+  timelineViewEl.timeline.focusElement = timelineViewEl;
+});
+</script>
+<style>
+  .view {
+    overflow: hidden;
+    position: absolute;
+    top: 0;
+    bottom: 0;
+    left: 0;
+    right: 0;
+  }
+</style>
+</head>
+<body>
+  <div>%s</div>
+  <div class="view">
+  </div>
+<!-- BEGIN TRACE -->
+  <script>
+  var linuxPerfData = "\

android/tools/android-osx/platform-tools/systrace/suffix.html

@@ -0,0 +1,5 @@
+\n";
+  </script>
+<!-- END TRACE -->
+</body>
+</html>

android/tools/android-osx/platform-tools/systrace/systrace-legacy.py

@@ -0,0 +1,251 @@
+#!/usr/bin/env python
+
+# Copyright (c) 2011 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.
+
+"""Android system-wide tracing utility.
+
+This is a tool for capturing a trace that includes data from both userland and
+the kernel.  It creates an HTML file for visualizing the trace.
+"""
+
+import errno, optparse, os, select, subprocess, sys, time, zlib
+
+# This list is based on the tags in frameworks/native/include/utils/Trace.h.
+trace_tag_bits = {
+  'gfx':      1<<1,
+  'input':    1<<2,
+  'view':     1<<3,
+  'webview':  1<<4,
+  'wm':       1<<5,
+  'am':       1<<6,
+  'sync':     1<<7,
+  'audio':    1<<8,
+  'video':    1<<9,
+  'camera':   1<<10,
+}
+
+flattened_css_file = 'style.css'
+flattened_js_file = 'script.js'
+
+def add_adb_serial(command, serial):
+  if serial != None:
+    command.insert(1, serial)
+    command.insert(1, '-s')
+
+def main():
+  parser = optparse.OptionParser()
+  parser.add_option('-o', dest='output_file', help='write HTML to FILE',
+                    default='trace.html', metavar='FILE')
+  parser.add_option('-t', '--time', dest='trace_time', type='int',
+                    help='trace for N seconds', metavar='N')
+  parser.add_option('-b', '--buf-size', dest='trace_buf_size', type='int',
+                    help='use a trace buffer size of N KB', metavar='N')
+  parser.add_option('-d', '--disk', dest='trace_disk', default=False,
+                    action='store_true', help='trace disk I/O (requires root)')
+  parser.add_option('-f', '--cpu-freq', dest='trace_cpu_freq', default=False,
+                    action='store_true', help='trace CPU frequency changes')
+  parser.add_option('-i', '--cpu-idle', dest='trace_cpu_idle', default=False,
+                    action='store_true', help='trace CPU idle events')
+  parser.add_option('-l', '--cpu-load', dest='trace_cpu_load', default=False,
+                    action='store_true', help='trace CPU load')
+  parser.add_option('-s', '--no-cpu-sched', dest='trace_cpu_sched', default=True,
+                    action='store_false', help='inhibit tracing CPU ' +
+                    'scheduler (allows longer trace times by reducing data ' +
+                    'rate into buffer)')
+  parser.add_option('-u', '--bus-utilization', dest='trace_bus_utilization',
+                    default=False, action='store_true',
+                    help='trace bus utilization (requires root)')
+  parser.add_option('-w', '--workqueue', dest='trace_workqueue', default=False,
+                    action='store_true', help='trace the kernel workqueues ' +
+                    '(requires root)')
+  parser.add_option('--set-tags', dest='set_tags', action='store',
+                    help='set the enabled trace tags and exit; set to a ' +
+                    'comma separated list of: ' +
+                    ', '.join(trace_tag_bits.iterkeys()))
+  parser.add_option('--link-assets', dest='link_assets', default=False,
+                    action='store_true', help='link to original CSS or JS resources '
+                    'instead of embedding them')
+  parser.add_option('--from-file', dest='from_file', action='store',
+                    help='read the trace from a file rather than running a live trace')
+  parser.add_option('--asset-dir', dest='asset_dir', default='trace-viewer',
+                    type='string', help='')
+  parser.add_option('-e', '--serial', dest='device_serial', type='string',
+                    help='adb device serial number')
+  options, args = parser.parse_args()
+
+  if options.set_tags:
+    flags = 0
+    tags = options.set_tags.split(',')
+    for tag in tags:
+      try:
+        flags |= trace_tag_bits[tag]
+      except KeyError:
+        parser.error('unrecognized tag: %s\nknown tags are: %s' %
+                     (tag, ', '.join(trace_tag_bits.iterkeys())))
+    atrace_args = ['adb', 'shell', 'setprop', 'debug.atrace.tags.enableflags', hex(flags)]
+    add_adb_serial(atrace_args, options.device_serial)
+    try:
+      subprocess.check_call(atrace_args)
+    except subprocess.CalledProcessError, e:
+      print >> sys.stderr, 'unable to set tags: %s' % e
+    print '\nSet enabled tags to: %s\n' % ', '.join(tags)
+    print ('You will likely need to restart the Android framework for this to ' +
+          'take effect:\n\n    adb shell stop\n    adb shell ' +
+          'start\n')
+    return
+
+  atrace_args = ['adb', 'shell', 'atrace', '-z']
+  add_adb_serial(atrace_args, options.device_serial)
+
+  if options.trace_disk:
+    atrace_args.append('-d')
+  if options.trace_cpu_freq:
+    atrace_args.append('-f')
+  if options.trace_cpu_idle:
+    atrace_args.append('-i')
+  if options.trace_cpu_load:
+    atrace_args.append('-l')
+  if options.trace_cpu_sched:
+    atrace_args.append('-s')
+  if options.trace_bus_utilization:
+    atrace_args.append('-u')
+  if options.trace_workqueue:
+    atrace_args.append('-w')
+  if options.trace_time is not None:
+    if options.trace_time > 0:
+      atrace_args.extend(['-t', str(options.trace_time)])
+    else:
+      parser.error('the trace time must be a positive number')
+  if options.trace_buf_size is not None:
+    if options.trace_buf_size > 0:
+      atrace_args.extend(['-b', str(options.trace_buf_size)])
+    else:
+      parser.error('the trace buffer size must be a positive number')
+
+  if options.from_file is not None:
+    atrace_args = ['cat', options.from_file]
+
+  script_dir = os.path.dirname(os.path.abspath(sys.argv[0]))
+
+  if options.link_assets:
+    src_dir = os.path.join(script_dir, options.asset_dir, 'src')
+    build_dir = os.path.join(script_dir, options.asset_dir, 'build')
+
+    js_files, js_flattenizer, css_files, templates = get_assets(src_dir, build_dir)
+
+    css = '\n'.join(linked_css_tag % (os.path.join(src_dir, f)) for f in css_files)
+    js = '<script language="javascript">\n%s</script>\n' % js_flattenizer
+    js += '\n'.join(linked_js_tag % (os.path.join(src_dir, f)) for f in js_files)
+
+  else:
+    css_filename = os.path.join(script_dir, flattened_css_file)
+    js_filename = os.path.join(script_dir, flattened_js_file)
+    css = compiled_css_tag % (open(css_filename).read())
+    js = compiled_js_tag % (open(js_filename).read())
+    templates = ''
+
+  html_filename = options.output_file
+
+  trace_started = False
+  leftovers = ''
+  adb = subprocess.Popen(atrace_args, stdout=subprocess.PIPE,
+                         stderr=subprocess.PIPE)
+  dec = zlib.decompressobj()
+  while True:
+    ready = select.select([adb.stdout, adb.stderr], [], [adb.stdout, adb.stderr])
+    if adb.stderr in ready[0]:
+      err = os.read(adb.stderr.fileno(), 4096)
+      sys.stderr.write(err)
+      sys.stderr.flush()
+    if adb.stdout in ready[0]:
+      out = leftovers + os.read(adb.stdout.fileno(), 4096)
+      if options.from_file is None:
+        out = out.replace('\r\n', '\n')
+      if out.endswith('\r'):
+        out = out[:-1]
+        leftovers = '\r'
+      else:
+        leftovers = ''
+      if not trace_started:
+        lines = out.splitlines(True)
+        out = ''
+        for i, line in enumerate(lines):
+          if line == 'TRACE:\n':
+            sys.stdout.write("downloading trace...")
+            sys.stdout.flush()
+            out = ''.join(lines[i+1:])
+            html_prefix = read_asset(script_dir, 'prefix.html')
+            html_file = open(html_filename, 'w')
+            html_file.write(html_prefix % (css, js, templates))
+            trace_started = True
+            break
+          elif 'TRACE:'.startswith(line) and i == len(lines) - 1:
+            leftovers = line + leftovers
+          else:
+            sys.stdout.write(line)
+            sys.stdout.flush()
+      if len(out) > 0:
+        out = dec.decompress(out)
+      html_out = out.replace('\n', '\\n\\\n')
+      if len(html_out) > 0:
+        html_file.write(html_out)
+    result = adb.poll()
+    if result is not None:
+      break
+  if result != 0:
+    print >> sys.stderr, 'adb returned error code %d' % result
+  elif trace_started:
+    html_out = dec.flush().replace('\n', '\\n\\\n').replace('\r', '')
+    if len(html_out) > 0:
+      html_file.write(html_out)
+    html_suffix = read_asset(script_dir, 'suffix.html')
+    html_file.write(html_suffix)
+    html_file.close()
+    print " done\n\n    wrote file://%s\n" % (os.path.abspath(options.output_file))
+  else:
+    print >> sys.stderr, ('An error occured while capturing the trace.  Output ' +
+      'file was not written.')
+
+def read_asset(src_dir, filename):
+  return open(os.path.join(src_dir, filename)).read()
+
+def get_assets(src_dir, build_dir):
+  sys.path.append(build_dir)
+  gen = __import__('generate_standalone_timeline_view', {}, {})
+  parse_deps = __import__('parse_deps', {}, {})
+  gen_templates = __import__('generate_template_contents', {}, {})
+  filenames = gen._get_input_filenames()
+  load_sequence = parse_deps.calc_load_sequence(filenames, src_dir)
+
+  js_files = []
+  js_flattenizer = "window.FLATTENED = {};\n"
+  js_flattenizer += "window.FLATTENED_RAW_SCRIPTS = {};\n"
+  css_files = []
+
+  for module in load_sequence:
+    js_files.append(os.path.relpath(module.filename, src_dir))
+    js_flattenizer += "window.FLATTENED['%s'] = true;\n" % module.name
+    for dependent_raw_script_name in module.dependent_raw_script_names:
+      js_flattenizer += (
+        "window.FLATTENED_RAW_SCRIPTS['%s'] = true;\n" %
+        dependent_raw_script_name)
+
+    for style_sheet in module.style_sheets:
+      css_files.append(os.path.relpath(style_sheet.filename, src_dir))
+
+  templates = gen_templates.generate_templates()
+
+  sys.path.pop()
+
+  return (js_files, js_flattenizer, css_files, templates)
+
+compiled_css_tag = """<style type="text/css">%s</style>"""
+compiled_js_tag = """<script language="javascript">%s</script>"""
+
+linked_css_tag = """<link rel="stylesheet" href="%s"></link>"""
+linked_js_tag = """<script language="javascript" src="%s"></script>"""
+
+if __name__ == '__main__':
+  main()

android/tools/android-osx/platform-tools/systrace/systrace.py

@@ -0,0 +1,313 @@
+#!/usr/bin/env python
+
+# Copyright (c) 2011 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.
+
+"""Android system-wide tracing utility.
+
+This is a tool for capturing a trace that includes data from both userland and
+the kernel.  It creates an HTML file for visualizing the trace.
+"""
+
+import errno, optparse, os, re, select, subprocess, sys, time, zlib
+
+flattened_css_file = 'style.css'
+flattened_js_file = 'script.js'
+
+class OptionParserIgnoreErrors(optparse.OptionParser):
+  def error(self, msg):
+    pass
+
+  def exit(self):
+    pass
+
+  def print_usage(self):
+    pass
+
+  def print_help(self):
+    pass
+
+  def print_version(self):
+    pass
+
+def get_device_sdk_version():
+  getprop_args = ['adb', 'shell', 'getprop', 'ro.build.version.sdk']
+
+  parser = OptionParserIgnoreErrors()
+  parser.add_option('-e', '--serial', dest='device_serial', type='string')
+  options, args = parser.parse_args()
+  if options.device_serial is not None:
+    getprop_args[1:1] = ['-s', options.device_serial]
+
+  adb = subprocess.Popen(getprop_args, stdout=subprocess.PIPE,
+                         stderr=subprocess.PIPE)
+  out, err = adb.communicate()
+  if adb.returncode != 0:
+    print >> sys.stderr, 'Error querying device SDK-version:'
+    print >> sys.stderr, err
+    sys.exit(1)
+
+  version = int(out)
+  return version
+
+def add_adb_serial(command, serial):
+  if serial is not None:
+    command.insert(1, serial)
+    command.insert(1, '-s')
+
+def main():
+  device_sdk_version = get_device_sdk_version()
+  if device_sdk_version < 18:
+    legacy_script = os.path.join(os.path.dirname(sys.argv[0]), 'systrace-legacy.py')
+    os.execv(legacy_script, sys.argv)
+
+  usage = "Usage: %prog [options] [category1 [category2 ...]]"
+  desc = "Example: %prog -b 32768 -t 15 gfx input view sched freq"
+  parser = optparse.OptionParser(usage=usage, description=desc)
+  parser.add_option('-o', dest='output_file', help='write HTML to FILE',
+                    default='trace.html', metavar='FILE')
+  parser.add_option('-t', '--time', dest='trace_time', type='int',
+                    help='trace for N seconds', metavar='N')
+  parser.add_option('-b', '--buf-size', dest='trace_buf_size', type='int',
+                    help='use a trace buffer size of N KB', metavar='N')
+  parser.add_option('-k', '--ktrace', dest='kfuncs', action='store',
+                    help='specify a comma-separated list of kernel functions to trace')
+  parser.add_option('-l', '--list-categories', dest='list_categories', default=False,
+                    action='store_true', help='list the available categories and exit')
+  parser.add_option('-a', '--app', dest='app_name', default=None, type='string',
+                    action='store', help='enable application-level tracing for comma-separated ' +
+                    'list of app cmdlines')
+  parser.add_option('--no-fix-threads', dest='fix_threads', default=True,
+                    action='store_false', help='don\'t fix missing or truncated thread names')
+
+  parser.add_option('--link-assets', dest='link_assets', default=False,
+                    action='store_true', help='link to original CSS or JS resources '
+                    'instead of embedding them')
+  parser.add_option('--from-file', dest='from_file', action='store',
+                    help='read the trace from a file (compressed) rather than running a live trace')
+  parser.add_option('--asset-dir', dest='asset_dir', default='trace-viewer',
+                    type='string', help='')
+  parser.add_option('-e', '--serial', dest='device_serial', type='string',
+                    help='adb device serial number')
+
+  options, args = parser.parse_args()
+
+  if options.list_categories:
+    atrace_args = ['adb', 'shell', 'atrace', '--list_categories']
+    expect_trace = False
+  elif options.from_file is not None:
+    atrace_args = ['cat', options.from_file]
+    expect_trace = True
+  else:
+    atrace_args = ['adb', 'shell', 'atrace', '-z']
+    expect_trace = True
+
+    if options.trace_time is not None:
+      if options.trace_time > 0:
+        atrace_args.extend(['-t', str(options.trace_time)])
+      else:
+        parser.error('the trace time must be a positive number')
+
+    if options.trace_buf_size is not None:
+      if options.trace_buf_size > 0:
+        atrace_args.extend(['-b', str(options.trace_buf_size)])
+      else:
+        parser.error('the trace buffer size must be a positive number')
+
+    if options.app_name is not None:
+      atrace_args.extend(['-a', options.app_name])
+
+    if options.kfuncs is not None:
+      atrace_args.extend(['-k', options.kfuncs])
+
+    atrace_args.extend(args)
+
+    if options.fix_threads:
+      atrace_args.extend([';', 'ps', '-t'])
+
+  if atrace_args[0] == 'adb':
+    add_adb_serial(atrace_args, options.device_serial)
+
+  script_dir = os.path.dirname(os.path.abspath(sys.argv[0]))
+
+  if options.link_assets:
+    src_dir = os.path.join(script_dir, options.asset_dir, 'src')
+    build_dir = os.path.join(script_dir, options.asset_dir, 'build')
+
+    js_files, js_flattenizer, css_files, templates = get_assets(src_dir, build_dir)
+
+    css = '\n'.join(linked_css_tag % (os.path.join(src_dir, f)) for f in css_files)
+    js = '<script language="javascript">\n%s</script>\n' % js_flattenizer
+    js += '\n'.join(linked_js_tag % (os.path.join(src_dir, f)) for f in js_files)
+
+  else:
+    css_filename = os.path.join(script_dir, flattened_css_file)
+    js_filename = os.path.join(script_dir, flattened_js_file)
+    css = compiled_css_tag % (open(css_filename).read())
+    js = compiled_js_tag % (open(js_filename).read())
+    templates = ''
+
+  html_filename = options.output_file
+
+  adb = subprocess.Popen(atrace_args, stdout=subprocess.PIPE,
+                         stderr=subprocess.PIPE)
+
+  result = None
+  data = []
+
+  # Read the text portion of the output and watch for the 'TRACE:' marker that
+  # indicates the start of the trace data.
+  while result is None:
+    ready = select.select([adb.stdout, adb.stderr], [], [adb.stdout, adb.stderr])
+    if adb.stderr in ready[0]:
+      err = os.read(adb.stderr.fileno(), 4096)
+      sys.stderr.write(err)
+      sys.stderr.flush()
+    if adb.stdout in ready[0]:
+      out = os.read(adb.stdout.fileno(), 4096)
+      parts = out.split('\nTRACE:', 1)
+
+      txt = parts[0].replace('\r', '')
+      if len(parts) == 2:
+        # The '\nTRACE:' match stole the last newline from the text, so add it
+        # back here.
+        txt += '\n'
+      sys.stdout.write(txt)
+      sys.stdout.flush()
+
+      if len(parts) == 2:
+        data.append(parts[1])
+        sys.stdout.write("downloading trace...")
+        sys.stdout.flush()
+        break
+
+    result = adb.poll()
+
+  # Read and buffer the data portion of the output.
+  while True:
+    ready = select.select([adb.stdout, adb.stderr], [], [adb.stdout, adb.stderr])
+    keepReading = False
+    if adb.stderr in ready[0]:
+      err = os.read(adb.stderr.fileno(), 4096)
+      if len(err) > 0:
+        keepReading = True
+        sys.stderr.write(err)
+        sys.stderr.flush()
+    if adb.stdout in ready[0]:
+      out = os.read(adb.stdout.fileno(), 4096)
+      if len(out) > 0:
+        keepReading = True
+        data.append(out)
+
+    if result is not None and not keepReading:
+      break
+
+    result = adb.poll()
+
+  if result == 0:
+    if expect_trace:
+      data = ''.join(data)
+
+      # Collapse CRLFs that are added by adb shell.
+      if data.startswith('\r\n'):
+        data = data.replace('\r\n', '\n')
+
+      # Skip the initial newline.
+      data = data[1:]
+
+      if not data:
+        print >> sys.stderr, ('No data was captured.  Output file was not ' +
+          'written.')
+        sys.exit(1)
+      else:
+        # Indicate to the user that the data download is complete.
+        print " done\n"
+
+      # Extract the thread list dumped by ps.
+      threads = {}
+      if options.fix_threads:
+        parts = data.split('USER     PID   PPID  VSIZE  RSS     WCHAN    PC        NAME', 1)
+        if len(parts) == 2:
+          data = parts[0]
+          for line in parts[1].splitlines():
+            cols = line.split(None, 8)
+            if len(cols) == 9:
+              tid = int(cols[1])
+              name = cols[8]
+              threads[tid] = name
+
+      # Decompress and preprocess the data.
+      out = zlib.decompress(data)
+      if options.fix_threads:
+        def repl(m):
+          tid = int(m.group(2))
+          if tid > 0:
+            name = threads.get(tid)
+            if name is None:
+              name = m.group(1)
+              if name == '<...>':
+                name = '<' + str(tid) + '>'
+              threads[tid] = name
+            return name + '-' + m.group(2)
+          else:
+            return m.group(0)
+        out = re.sub(r'^\s*(\S+)-(\d+)', repl, out, flags=re.MULTILINE)
+
+      html_prefix = read_asset(script_dir, 'prefix.html')
+      html_suffix = read_asset(script_dir, 'suffix.html')
+
+      html_file = open(html_filename, 'w')
+      html_file.write(html_prefix % (css, js, templates))
+      html_out = out.replace('\n', '\\n\\\n')
+      html_file.write(html_out)
+      html_file.write(html_suffix)
+      html_file.close()
+      print "\n    wrote file://%s\n" % os.path.abspath(options.output_file)
+
+  else: # i.e. result != 0
+    print >> sys.stderr, 'adb returned error code %d' % result
+    sys.exit(1)
+
+def read_asset(src_dir, filename):
+  return open(os.path.join(src_dir, filename)).read()
+
+def get_assets(src_dir, build_dir):
+  sys.path.append(build_dir)
+  gen = __import__('generate_standalone_timeline_view', {}, {})
+  parse_deps = __import__('parse_deps', {}, {})
+  gen_templates = __import__('generate_template_contents', {}, {})
+  filenames = gen._get_input_filenames()
+  load_sequence = parse_deps.calc_load_sequence(filenames, src_dir)
+
+  js_files = []
+  js_flattenizer = "window.FLATTENED = {};\n"
+  js_flattenizer += "window.FLATTENED_RAW_SCRIPTS = {};\n"
+  css_files = []
+
+  for module in load_sequence:
+    js_files.append(os.path.relpath(module.filename, src_dir))
+    js_flattenizer += "window.FLATTENED['%s'] = true;\n" % module.name
+    for dependent_raw_script_name in module.dependent_raw_script_names:
+      js_flattenizer += (
+        "window.FLATTENED_RAW_SCRIPTS['%s'] = true;\n" %
+        dependent_raw_script_name)
+
+    for style_sheet in module.style_sheets:
+      css_files.append(os.path.relpath(style_sheet.filename, src_dir))
+
+  templates = gen_templates.generate_templates()
+
+  sys.path.pop()
+
+  return (js_files, js_flattenizer, css_files, templates)
+
+
+compiled_css_tag = """<style type="text/css">%s</style>"""
+compiled_js_tag = """<script language="javascript">%s</script>"""
+
+linked_css_tag = """<link rel="stylesheet" href="%s"></link>"""
+linked_js_tag = """<script language="javascript" src="%s"></script>"""
+
+if __name__ == '__main__':
+  main()