OLD | NEW |
1 # Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 # Copyright (c) 2012 The Chromium Authors. All rights reserved. |
2 # Use of this source code is governed by a BSD-style license that can be | 2 # Use of this source code is governed by a BSD-style license that can be |
3 # found in the LICENSE file. | 3 # found in the LICENSE file. |
4 | 4 |
5 """ | 5 """ |
6 Classes in this file define additional actions that need to be taken to run a | 6 Classes in this file define additional actions that need to be taken to run a |
7 test under some kind of runtime error detection tool. | 7 test under some kind of runtime error detection tool. |
8 | 8 |
9 The interface is intended to be used as follows. | 9 The interface is intended to be used as follows. |
10 | 10 |
11 1. For tests that simply run a native process (i.e. no activity is spawned): | 11 1. For tests that simply run a native process (i.e. no activity is spawned): |
12 | 12 |
13 Call tool.CopyFiles(). | 13 Call tool.CopyFiles(device). |
14 Prepend test command line with tool.GetTestWrapper(). | 14 Prepend test command line with tool.GetTestWrapper(). |
15 | 15 |
16 2. For tests that spawn an activity: | 16 2. For tests that spawn an activity: |
17 | 17 |
18 Call tool.CopyFiles(). | 18 Call tool.CopyFiles(device). |
19 Call tool.SetupEnvironment(). | 19 Call tool.SetupEnvironment(). |
20 Run the test as usual. | 20 Run the test as usual. |
21 Call tool.CleanUpEnvironment(). | 21 Call tool.CleanUpEnvironment(). |
22 """ | 22 """ |
23 # pylint: disable=R0201 | 23 # pylint: disable=R0201 |
24 | 24 |
25 import glob | 25 import glob |
26 import logging | 26 import logging |
27 import os.path | 27 import os.path |
28 import subprocess | 28 import subprocess |
(...skipping 26 matching lines...) Expand all Loading... |
55 | 55 |
56 def GetUtilWrapper(self): | 56 def GetUtilWrapper(self): |
57 """Returns the wrapper name for the utilities. | 57 """Returns the wrapper name for the utilities. |
58 | 58 |
59 Returns: | 59 Returns: |
60 A string that is to be prepended to the command line of utility | 60 A string that is to be prepended to the command line of utility |
61 processes (forwarder, etc.). | 61 processes (forwarder, etc.). |
62 """ | 62 """ |
63 return '' | 63 return '' |
64 | 64 |
65 def CopyFiles(self): | 65 @classmethod |
| 66 def CopyFiles(cls, device): |
66 """Copies tool-specific files to the device, create directories, etc.""" | 67 """Copies tool-specific files to the device, create directories, etc.""" |
67 pass | 68 pass |
68 | 69 |
69 def SetupEnvironment(self): | 70 def SetupEnvironment(self): |
70 """Sets up the system environment for a test. | 71 """Sets up the system environment for a test. |
71 | 72 |
72 This is a good place to set system properties. | 73 This is a good place to set system properties. |
73 """ | 74 """ |
74 pass | 75 pass |
75 | 76 |
(...skipping 23 matching lines...) Expand all Loading... |
99 # nothing we can do about that. | 100 # nothing we can do about that. |
100 EXTRA_OPTIONS = 'strict_memcmp=0,use_sigaltstack=1' | 101 EXTRA_OPTIONS = 'strict_memcmp=0,use_sigaltstack=1' |
101 | 102 |
102 def __init__(self, device): | 103 def __init__(self, device): |
103 super(AddressSanitizerTool, self).__init__() | 104 super(AddressSanitizerTool, self).__init__() |
104 self._device = device | 105 self._device = device |
105 # Configure AndroidCommands to run utils (such as md5sum_bin) under ASan. | 106 # Configure AndroidCommands to run utils (such as md5sum_bin) under ASan. |
106 # This is required because ASan is a compiler-based tool, and md5sum | 107 # This is required because ASan is a compiler-based tool, and md5sum |
107 # includes instrumented code from base. | 108 # includes instrumented code from base. |
108 device.old_interface.SetUtilWrapper(self.GetUtilWrapper()) | 109 device.old_interface.SetUtilWrapper(self.GetUtilWrapper()) |
| 110 |
| 111 @classmethod |
| 112 def CopyFiles(cls, device): |
| 113 """Copies ASan tools to the device.""" |
109 libs = glob.glob(os.path.join(DIR_SOURCE_ROOT, | 114 libs = glob.glob(os.path.join(DIR_SOURCE_ROOT, |
110 'third_party/llvm-build/Release+Asserts/', | 115 'third_party/llvm-build/Release+Asserts/', |
111 'lib/clang/*/lib/linux/', | 116 'lib/clang/*/lib/linux/', |
112 'libclang_rt.asan-arm-android.so')) | 117 'libclang_rt.asan-arm-android.so')) |
113 assert len(libs) == 1 | 118 assert len(libs) == 1 |
114 self._lib = libs[0] | |
115 | |
116 def CopyFiles(self): | |
117 """Copies ASan tools to the device.""" | |
118 subprocess.call([os.path.join(DIR_SOURCE_ROOT, | 119 subprocess.call([os.path.join(DIR_SOURCE_ROOT, |
119 'tools/android/asan/asan_device_setup.sh'), | 120 'tools/android/asan/asan_device_setup.sh'), |
120 '--device', str(self._device), | 121 '--device', str(device), |
121 '--lib', self._lib, | 122 '--lib', libs[0], |
122 '--extra-options', AddressSanitizerTool.EXTRA_OPTIONS]) | 123 '--extra-options', AddressSanitizerTool.EXTRA_OPTIONS]) |
123 self._device.WaitUntilFullyBooted() | 124 device.WaitUntilFullyBooted() |
124 | 125 |
125 def GetTestWrapper(self): | 126 def GetTestWrapper(self): |
126 return AddressSanitizerTool.WRAPPER_NAME | 127 return AddressSanitizerTool.WRAPPER_NAME |
127 | 128 |
128 def GetUtilWrapper(self): | 129 def GetUtilWrapper(self): |
129 """Returns the wrapper for utilities, such as forwarder. | 130 """Returns the wrapper for utilities, such as forwarder. |
130 | 131 |
131 AddressSanitizer wrapper must be added to all instrumented binaries, | 132 AddressSanitizer wrapper must be added to all instrumented binaries, |
132 including forwarder and the like. This can be removed if such binaries | 133 including forwarder and the like. This can be removed if such binaries |
133 were built without instrumentation. """ | 134 were built without instrumentation. """ |
(...skipping 23 matching lines...) Expand all Loading... |
157 VG_DIR = '/data/local/tmp/valgrind' | 158 VG_DIR = '/data/local/tmp/valgrind' |
158 VGLOGS_DIR = '/data/local/tmp/vglogs' | 159 VGLOGS_DIR = '/data/local/tmp/vglogs' |
159 | 160 |
160 def __init__(self, device): | 161 def __init__(self, device): |
161 super(ValgrindTool, self).__init__() | 162 super(ValgrindTool, self).__init__() |
162 self._device = device | 163 self._device = device |
163 # exactly 31 chars, SystemProperties::PROP_NAME_MAX | 164 # exactly 31 chars, SystemProperties::PROP_NAME_MAX |
164 self._wrap_properties = ['wrap.com.google.android.apps.ch', | 165 self._wrap_properties = ['wrap.com.google.android.apps.ch', |
165 'wrap.org.chromium.native_test'] | 166 'wrap.org.chromium.native_test'] |
166 | 167 |
167 def CopyFiles(self): | 168 @classmethod |
| 169 def CopyFiles(cls, device): |
168 """Copies Valgrind tools to the device.""" | 170 """Copies Valgrind tools to the device.""" |
169 self._device.RunShellCommand( | 171 device.RunShellCommand( |
170 'rm -r %s; mkdir %s' % (ValgrindTool.VG_DIR, ValgrindTool.VG_DIR)) | 172 'rm -r %s; mkdir %s' % (ValgrindTool.VG_DIR, ValgrindTool.VG_DIR)) |
171 self._device.RunShellCommand( | 173 device.RunShellCommand( |
172 'rm -r %s; mkdir %s' % (ValgrindTool.VGLOGS_DIR, | 174 'rm -r %s; mkdir %s' % (ValgrindTool.VGLOGS_DIR, |
173 ValgrindTool.VGLOGS_DIR)) | 175 ValgrindTool.VGLOGS_DIR)) |
174 files = self.GetFilesForTool() | 176 files = cls.GetFilesForTool() |
175 self._device.PushChangedFiles( | 177 device.PushChangedFiles( |
176 [((os.path.join(DIR_SOURCE_ROOT, f), | 178 [((os.path.join(DIR_SOURCE_ROOT, f), |
177 os.path.join(ValgrindTool.VG_DIR, os.path.basename(f))) | 179 os.path.join(ValgrindTool.VG_DIR, os.path.basename(f))) |
178 for f in files)]) | 180 for f in files)]) |
179 | 181 |
180 def SetupEnvironment(self): | 182 def SetupEnvironment(self): |
181 """Sets up device environment.""" | 183 """Sets up device environment.""" |
182 self._device.RunShellCommand('chmod 777 /data/local/tmp') | 184 self._device.RunShellCommand('chmod 777 /data/local/tmp') |
183 self._device.RunShellCommand('setenforce 0') | 185 self._device.RunShellCommand('setenforce 0') |
184 for prop in self._wrap_properties: | 186 for prop in self._wrap_properties: |
185 self._device.RunShellCommand( | 187 self._device.RunShellCommand( |
186 'setprop %s "logwrapper %s"' % (prop, self.GetTestWrapper())) | 188 'setprop %s "logwrapper %s"' % (prop, self.GetTestWrapper())) |
187 SetChromeTimeoutScale(self._device, self.GetTimeoutScale()) | 189 SetChromeTimeoutScale(self._device, self.GetTimeoutScale()) |
188 | 190 |
189 def CleanUpEnvironment(self): | 191 def CleanUpEnvironment(self): |
190 """Cleans up device environment.""" | 192 """Cleans up device environment.""" |
191 for prop in self._wrap_properties: | 193 for prop in self._wrap_properties: |
192 self._device.RunShellCommand('setprop %s ""' % (prop,)) | 194 self._device.RunShellCommand('setprop %s ""' % (prop,)) |
193 SetChromeTimeoutScale(self._device, None) | 195 SetChromeTimeoutScale(self._device, None) |
194 | 196 |
195 def GetFilesForTool(self): | 197 @staticmethod |
| 198 def GetFilesForTool(): |
196 """Returns a list of file names for the tool.""" | 199 """Returns a list of file names for the tool.""" |
197 raise NotImplementedError() | 200 raise NotImplementedError() |
198 | 201 |
199 def NeedsDebugInfo(self): | 202 def NeedsDebugInfo(self): |
200 """Whether this tool requires debug info. | 203 """Whether this tool requires debug info. |
201 | 204 |
202 Returns: | 205 Returns: |
203 True if this tool can not work with stripped binaries. | 206 True if this tool can not work with stripped binaries. |
204 """ | 207 """ |
205 return True | 208 return True |
206 | 209 |
207 | 210 |
208 class MemcheckTool(ValgrindTool): | 211 class MemcheckTool(ValgrindTool): |
209 """Memcheck tool.""" | 212 """Memcheck tool.""" |
210 | 213 |
211 def __init__(self, device): | 214 def __init__(self, device): |
212 super(MemcheckTool, self).__init__(device) | 215 super(MemcheckTool, self).__init__(device) |
213 | 216 |
214 def GetFilesForTool(self): | 217 @staticmethod |
| 218 def GetFilesForTool(): |
215 """Returns a list of file names for the tool.""" | 219 """Returns a list of file names for the tool.""" |
216 return ['tools/valgrind/android/vg-chrome-wrapper.sh', | 220 return ['tools/valgrind/android/vg-chrome-wrapper.sh', |
217 'tools/valgrind/memcheck/suppressions.txt', | 221 'tools/valgrind/memcheck/suppressions.txt', |
218 'tools/valgrind/memcheck/suppressions_android.txt'] | 222 'tools/valgrind/memcheck/suppressions_android.txt'] |
219 | 223 |
220 def GetTestWrapper(self): | 224 def GetTestWrapper(self): |
221 """Returns a string that is to be prepended to the test command line.""" | 225 """Returns a string that is to be prepended to the test command line.""" |
222 return ValgrindTool.VG_DIR + '/' + 'vg-chrome-wrapper.sh' | 226 return ValgrindTool.VG_DIR + '/' + 'vg-chrome-wrapper.sh' |
223 | 227 |
224 def GetTimeoutScale(self): | 228 def GetTimeoutScale(self): |
225 """Returns a multiplier that should be applied to timeout values.""" | 229 """Returns a multiplier that should be applied to timeout values.""" |
226 return 30 | 230 return 30 |
227 | 231 |
228 | 232 |
229 class TSanTool(ValgrindTool): | 233 class TSanTool(ValgrindTool): |
230 """ThreadSanitizer tool. See http://code.google.com/p/data-race-test .""" | 234 """ThreadSanitizer tool. See http://code.google.com/p/data-race-test .""" |
231 | 235 |
232 def __init__(self, device): | 236 def __init__(self, device): |
233 super(TSanTool, self).__init__(device) | 237 super(TSanTool, self).__init__(device) |
234 | 238 |
235 def GetFilesForTool(self): | 239 @staticmethod |
| 240 def GetFilesForTool(): |
236 """Returns a list of file names for the tool.""" | 241 """Returns a list of file names for the tool.""" |
237 return ['tools/valgrind/android/vg-chrome-wrapper-tsan.sh', | 242 return ['tools/valgrind/android/vg-chrome-wrapper-tsan.sh', |
238 'tools/valgrind/tsan/suppressions.txt', | 243 'tools/valgrind/tsan/suppressions.txt', |
239 'tools/valgrind/tsan/suppressions_android.txt', | 244 'tools/valgrind/tsan/suppressions_android.txt', |
240 'tools/valgrind/tsan/ignores.txt'] | 245 'tools/valgrind/tsan/ignores.txt'] |
241 | 246 |
242 def GetTestWrapper(self): | 247 def GetTestWrapper(self): |
243 """Returns a string that is to be prepended to the test command line.""" | 248 """Returns a string that is to be prepended to the test command line.""" |
244 return ValgrindTool.VG_DIR + '/' + 'vg-chrome-wrapper-tsan.sh' | 249 return ValgrindTool.VG_DIR + '/' + 'vg-chrome-wrapper-tsan.sh' |
245 | 250 |
(...skipping 23 matching lines...) Expand all Loading... |
269 if not tool_name: | 274 if not tool_name: |
270 return BaseTool() | 275 return BaseTool() |
271 | 276 |
272 ctor = TOOL_REGISTRY.get(tool_name) | 277 ctor = TOOL_REGISTRY.get(tool_name) |
273 if ctor: | 278 if ctor: |
274 return ctor(device) | 279 return ctor(device) |
275 else: | 280 else: |
276 print 'Unknown tool %s, available tools: %s' % ( | 281 print 'Unknown tool %s, available tools: %s' % ( |
277 tool_name, ', '.join(sorted(TOOL_REGISTRY.keys()))) | 282 tool_name, ', '.join(sorted(TOOL_REGISTRY.keys()))) |
278 sys.exit(1) | 283 sys.exit(1) |
| 284 |
| 285 def PushFilesForTool(tool_name, device): |
| 286 """Pushes the files required for |tool_name| to |device|. |
| 287 |
| 288 Args: |
| 289 tool_name: Name of the tool to create. |
| 290 device: A DeviceUtils instance. |
| 291 """ |
| 292 if not tool_name: |
| 293 return |
| 294 |
| 295 clazz = TOOL_REGISTRY.get(tool_name) |
| 296 if clazz: |
| 297 clazz.CopyFiles(device) |
| 298 else: |
| 299 print 'Unknown tool %s, available tools: %s' % ( |
| 300 tool_name, ', '.join(sorted(TOOL_REGISTRY.keys()))) |
| 301 sys.exit(1) |
| 302 |
OLD | NEW |