1
    2
    3
    4
    5
    6
    7
    8
    9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
   81
   82
   83
   84
   85
   86
   87
   88
   89
   90
   91
   92
   93
   94
   95
   96
   97
   98
   99
  100
  101
  102
  103
  104
  105
  106
  107
  108
  109
  110
  111
  112

tools / diagnose-me.py [blame]

#!/usr/bin/env python3
# Copyright 2012 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.

"""Diagnose some common system configuration problems on Linux, and
suggest fixes."""

from __future__ import print_function

import os
import subprocess
import sys

all_checks = []

def Check(name):
  """Decorator that defines a diagnostic check."""

  def wrap(func):
    all_checks.append((name, func))
    return func

  return wrap


@Check("/usr/bin/ld is not gold")
def CheckSystemLd():
  proc = subprocess.Popen(['/usr/bin/ld', '-v'], stdout=subprocess.PIPE)
  stdout = proc.communicate()[0].decode('utf-8')
  if 'GNU gold' in stdout:
    return ("When /usr/bin/ld is gold, system updates can silently\n"
            "corrupt your graphics drivers.\n"
            "Try 'sudo apt-get remove binutils-gold'.\n")
  return None


@Check("random lds are not in the $PATH")
def CheckPathLd():
  proc = subprocess.Popen(['which', '-a', 'ld'], stdout=subprocess.PIPE)
  stdout = proc.communicate()[0].decode('utf-8')
  instances = stdout.split()
  if len(instances) > 1:
    return ("You have multiple 'ld' binaries in your $PATH:\n" +
            '\n'.join(' - ' + i for i in instances) + "\n"
            "You should delete all of them but your system one.\n"
            "gold is hooked into your build via depot tools.\n")
  return None


@Check("/usr/bin/ld doesn't point to gold")
def CheckLocalGold():
  # Check /usr/bin/ld* symlinks.
  for path in ('ld.bfd', 'ld'):
    path = '/usr/bin/' + path
    try:
      target = os.readlink(path)
    except OSError as e:
      if e.errno == 2:
        continue  # No such file
      if e.errno == 22:
        continue  # Not a symlink
      raise
    if '/usr/local/gold' in target:
      return ("%s is a symlink into /usr/local/gold.\n"
              "It's difficult to make a recommendation, because you\n"
              "probably set this up yourself.  But you should make\n"
              "/usr/bin/ld be the standard linker, which you likely\n"
              "renamed /usr/bin/ld.bfd or something like that.\n" % path)

  return None


@Check("random ninja binaries are not in the $PATH")
def CheckPathNinja():
  proc = subprocess.Popen(['which', 'ninja'], stdout=subprocess.PIPE)
  stdout = proc.communicate()[0].decode('utf-8')
  if not 'depot_tools' in stdout:
    return ("The ninja binary in your path isn't from depot_tools:\n" + "    " +
            stdout + "Remove custom ninjas from your path so that the one\n"
            "in depot_tools is used.\n")
  return None


@Check("build dependencies are satisfied")
def CheckBuildDeps():
  script_path = os.path.join(
      os.path.dirname(os.path.dirname(os.path.abspath(__file__))), 'build',
      'install-build-deps.sh')
  proc = subprocess.Popen([script_path, '--quick-check'],
                          stdout=subprocess.PIPE)
  stdout = proc.communicate()[0].decode('utf-8')
  if 'WARNING' in stdout:
    return ("Your build dependencies are out-of-date.\n"
            "Run '" + script_path + "' to update.")
  return None


def RunChecks():
  for name, check in all_checks:
    sys.stdout.write("* Checking %s: " % name)
    sys.stdout.flush()
    error = check()
    if not error:
      print("ok")
    else:
      print("FAIL")
      print(error)


if __name__ == '__main__':
  RunChecks()