build/get_landmines.py

   1 #!/usr/bin/env python
   2 # Copyright 2013 The Chromium Authors. All rights reserved.
   3 # Use of this source code is governed by a BSD-style license that can be
   4 # found in the LICENSE file.
   5
   6 """
   7 This file emits the list of reasons why a particular build needs to be clobbered
   8 (or a list of 'landmines').
   9 """
  10
  11 import sys
  12
  13 import landmine_utils
  14
  15
  16 host_os = landmine_utils.host_os
  17
  18
  19 def print_landmines():
  20   """
  21   ALL LANDMINES ARE EMITTED FROM HERE.
  22   """
  23   # DO NOT add landmines as part of a regular CL. Landmines are a last-effort
  24   # bandaid fix if a CL that got landed has a build dependency bug and all bots
  25   # need to be cleaned up. If you're writing a new CL that causes build
  26   # dependency problems, fix the dependency problems instead of adding a
  27   # landmine.
  28   #
  29   # Before adding or changing a landmine consider the consequences of doing so.
  30   # Doing so will wipe out every output directory on every Chrome developer's
  31   # machine. This can be particularly problematic on Windows where the directory
  32   # deletion may well fail (locked files, command prompt in the directory,
  33   # etc.), and generated .sln and .vcxproj files will be deleted.
  34   #
  35   # This output directory deletion will be repeated when going back and forth
  36   # across the change that added the landmine, adding to the cost. There are
  37   # usually less troublesome alternatives.
  38
  39   if host_os() == 'win':
  40     print 'Compile on cc_unittests fails due to symbols removed in r185063.'
  41   if host_os() == 'linux':
  42     print 'Builders switching from make to ninja will clobber on this.'
  43   if host_os() == 'mac':
  44     print 'Switching from bundle to unbundled dylib (issue 14743002).'
  45   if host_os() in ('win', 'mac'):
  46     print ('Improper dependency for create_nmf.py broke in r240802, '
  47            'fixed in r240860.')
  48   if host_os() == 'win':
  49     print 'Switch to VS2015 Update 3, 14393 SDK'
  50   print 'Need to clobber everything due to an IDL change in r154579 (blink)'
  51   print 'Need to clobber everything due to gen file moves in r175513 (Blink)'
  52   print 'Clobber to get rid of obselete test plugin after r248358'
  53   print 'Clobber to rebuild GN files for V8'
  54   print 'Clobber to get rid of stale generated mojom.h files'
  55   print 'Need to clobber everything due to build_nexe change in nacl r13424'
  56   print '[chromium-dev] PSA: clobber build needed for IDR_INSPECTOR_* compil...'
  57   print 'blink_resources.grd changed: crbug.com/400860'
  58   print 'ninja dependency cycle: crbug.com/408192'
  59   print 'Clobber to fix missing NaCl gyp dependencies (crbug.com/427427).'
  60   print 'Another clobber for missing NaCl gyp deps (crbug.com/427427).'
  61   print 'Clobber to fix GN not picking up increased ID range (crbug.com/444902)'
  62   print 'Remove NaCl toolchains from the output dir (crbug.com/456902)'
  63   if host_os() == 'win':
  64     print 'Clobber to delete stale generated files (crbug.com/510086)'
  65   if host_os() == 'mac':
  66     print 'Clobber to get rid of evil libsqlite3.dylib (crbug.com/526208)'
  67   if host_os() == 'mac':
  68     print 'Clobber to remove libsystem.dylib. See crbug.com/620075'
  69   if host_os() == 'mac':
  70     print 'Clobber to get past mojo gen build error (crbug.com/679607)'
  71   if host_os() == 'win':
  72     print 'Clobber Windows to fix strange PCH-not-rebuilt errors.'
  73   print 'CLobber all to fix GN breakage (crbug.com/736215)'
  74   print 'The Great Blink mv for source files (crbug.com/768828)'
  75
  76 def main():
  77   print_landmines()
  78   return 0
  79
  80
  81 if __name__ == '__main__':
  82   sys.exit(main())