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 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359
|
""" This module contains functions used by the test cases to hide the
architecture and/or the platform dependent nature of the tests. """
from __future__ import absolute_import
# System modules
import itertools
import json
import re
import subprocess
import sys
import os
from urllib.parse import urlparse
from pkg_resources import packaging
# LLDB modules
import lldb
from . import configuration
from . import lldbtest_config
import lldbsuite.test.lldbplatform as lldbplatform
from lldbsuite.test.builders import get_builder
from lldbsuite.test.lldbutil import is_exe
def check_first_register_readable(test_case):
arch = test_case.getArchitecture()
if arch in ["x86_64", "i386"]:
test_case.expect("register read eax", substrs=["eax = 0x"])
elif arch in ["arm", "armv7", "armv7k", "armv8l", "armv7l"]:
test_case.expect("register read r0", substrs=["r0 = 0x"])
elif arch in ["aarch64", "arm64", "arm64e", "arm64_32"]:
test_case.expect("register read x0", substrs=["x0 = 0x"])
elif re.match("mips", arch):
test_case.expect("register read zero", substrs=["zero = 0x"])
elif arch in ["s390x"]:
test_case.expect("register read r0", substrs=["r0 = 0x"])
elif arch in ["powerpc64le"]:
test_case.expect("register read r0", substrs=["r0 = 0x"])
else:
# TODO: Add check for other architectures
test_case.fail(
"Unsupported architecture for test case (arch: %s)"
% test_case.getArchitecture()
)
def _run_adb_command(cmd, device_id):
device_id_args = []
if device_id:
device_id_args = ["-s", device_id]
full_cmd = ["adb"] + device_id_args + cmd
p = subprocess.Popen(full_cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
stdout, stderr = p.communicate()
return p.returncode, stdout, stderr
def target_is_android():
return configuration.lldb_platform_name == "remote-android"
def android_device_api():
if not hasattr(android_device_api, "result"):
assert configuration.lldb_platform_url is not None
device_id = None
parsed_url = urlparse(configuration.lldb_platform_url)
host_name = parsed_url.netloc.split(":")[0]
if host_name != "localhost":
device_id = host_name
if device_id.startswith("[") and device_id.endswith("]"):
device_id = device_id[1:-1]
retcode, stdout, stderr = _run_adb_command(
["shell", "getprop", "ro.build.version.sdk"], device_id
)
if retcode == 0:
android_device_api.result = int(stdout)
else:
raise LookupError(
">>> Unable to determine the API level of the Android device.\n"
">>> stdout:\n%s\n"
">>> stderr:\n%s\n" % (stdout, stderr)
)
return android_device_api.result
def match_android_device(device_arch, valid_archs=None, valid_api_levels=None):
if not target_is_android():
return False
if valid_archs is not None and device_arch not in valid_archs:
return False
if valid_api_levels is not None and android_device_api() not in valid_api_levels:
return False
return True
def finalize_build_dictionary(dictionary):
if target_is_android():
if dictionary is None:
dictionary = {}
dictionary["OS"] = "Android"
dictionary["PIE"] = 1
return dictionary
def _get_platform_os(p):
# Use the triple to determine the platform if set.
triple = p.GetTriple()
if triple:
platform = triple.split("-")[2]
if platform.startswith("freebsd"):
platform = "freebsd"
elif platform.startswith("netbsd"):
platform = "netbsd"
return platform
return ""
def getHostPlatform():
"""Returns the host platform running the test suite."""
return _get_platform_os(lldb.SBPlatform("host"))
def getDarwinOSTriples():
return lldbplatform.translate(lldbplatform.darwin_all)
def getPlatform():
"""Returns the target platform which the tests are running on."""
# Use the Apple SDK to determine the platform if set.
if configuration.apple_sdk:
platform = configuration.apple_sdk
dot = platform.find(".")
if dot != -1:
platform = platform[:dot]
if platform == "iphoneos":
platform = "ios"
return platform
return _get_platform_os(lldb.selected_platform)
def platformIsDarwin():
"""Returns true if the OS triple for the selected platform is any valid apple OS"""
return getPlatform() in getDarwinOSTriples()
def findMainThreadCheckerDylib():
if not platformIsDarwin():
return ""
if getPlatform() in lldbplatform.translate(lldbplatform.darwin_embedded):
return "/Developer/usr/lib/libMainThreadChecker.dylib"
with os.popen("xcode-select -p") as output:
xcode_developer_path = output.read().strip()
mtc_dylib_path = "%s/usr/lib/libMainThreadChecker.dylib" % xcode_developer_path
if os.path.isfile(mtc_dylib_path):
return mtc_dylib_path
return ""
class _PlatformContext(object):
"""Value object class which contains platform-specific options."""
def __init__(
self, shlib_environment_var, shlib_path_separator, shlib_prefix, shlib_extension
):
self.shlib_environment_var = shlib_environment_var
self.shlib_path_separator = shlib_path_separator
self.shlib_prefix = shlib_prefix
self.shlib_extension = shlib_extension
def createPlatformContext():
if platformIsDarwin():
return _PlatformContext("DYLD_LIBRARY_PATH", ":", "lib", "dylib")
elif getPlatform() in ("freebsd", "linux", "netbsd"):
return _PlatformContext("LD_LIBRARY_PATH", ":", "lib", "so")
else:
return _PlatformContext("PATH", ";", "", "dll")
def hasChattyStderr(test_case):
"""Some targets produce garbage on the standard error output. This utility function
determines whether the tests can be strict about the expected stderr contents."""
if match_android_device(
test_case.getArchitecture(), ["aarch64"], range(22, 25 + 1)
):
return True # The dynamic linker on the device will complain about unknown DT entries
return False
def builder_module():
return get_builder(sys.platform)
def getArchitecture():
"""Returns the architecture in effect the test suite is running with."""
module = builder_module()
arch = module.getArchitecture()
if arch == "amd64":
arch = "x86_64"
if arch in ["armv7l", "armv8l"]:
arch = "arm"
return arch
lldbArchitecture = None
def getLLDBArchitecture():
"""Returns the architecture of the lldb binary."""
global lldbArchitecture
if not lldbArchitecture:
# These two target settings prevent lldb from doing setup that does
# nothing but slow down the end goal of printing the architecture.
command = [
lldbtest_config.lldbExec,
"-x",
"-b",
"-o",
"settings set target.preload-symbols false",
"-o",
"settings set target.load-script-from-symbol-file false",
"-o",
"file " + lldbtest_config.lldbExec,
]
output = subprocess.check_output(command)
str = output.decode()
for line in str.splitlines():
m = re.search(r"Current executable set to '.*' \((.*)\)\.", line)
if m:
lldbArchitecture = m.group(1)
break
return lldbArchitecture
def getCompiler():
"""Returns the compiler in effect the test suite is running with."""
module = builder_module()
return module.getCompiler()
def getCompilerBinary():
"""Returns the compiler binary the test suite is running with."""
return getCompiler().split()[0]
def getCompilerVersion():
"""Returns a string that represents the compiler version.
Supports: llvm, clang.
"""
compiler = getCompilerBinary()
version_output = subprocess.check_output([compiler, "--version"], errors="replace")
m = re.search("version ([0-9.]+)", version_output)
if m:
return m.group(1)
return "unknown"
def getDwarfVersion():
"""Returns the dwarf version generated by clang or '0'."""
if configuration.dwarf_version:
return str(configuration.dwarf_version)
if "clang" in getCompiler():
try:
triple = builder_module().getTriple(getArchitecture())
target = ["-target", triple] if triple else []
driver_output = subprocess.check_output(
[getCompiler()] + target + "-g -c -x c - -o - -###".split(),
stderr=subprocess.STDOUT,
)
driver_output = driver_output.decode("utf-8")
for line in driver_output.split(os.linesep):
m = re.search("dwarf-version=([0-9])", line)
if m:
return m.group(1)
except subprocess.CalledProcessError:
pass
return "0"
def expectedCompilerVersion(compiler_version):
"""Returns True iff compiler_version[1] matches the current compiler version.
Use compiler_version[0] to specify the operator used to determine if a match has occurred.
Any operator other than the following defaults to an equality test:
'>', '>=', "=>", '<', '<=', '=<', '!=', "!" or 'not'
If the current compiler version cannot be determined, we assume it is close to the top
of trunk, so any less-than or equal-to comparisons will return False, and any
greater-than or not-equal-to comparisons will return True.
"""
if compiler_version is None:
return True
operator = str(compiler_version[0])
version_str = str(compiler_version[1])
if not version_str:
return True
test_compiler_version_str = getCompilerVersion()
if test_compiler_version_str == "unknown":
# Assume the compiler version is at or near the top of trunk.
return operator in [">", ">=", "!", "!=", "not"]
version = packaging.version.parse(version_str)
test_compiler_version = packaging.version.parse(test_compiler_version_str)
if operator == ">":
return test_compiler_version > version
if operator == ">=" or operator == "=>":
return test_compiler_version >= version
if operator == "<":
return test_compiler_version < version
if operator == "<=" or operator == "=<":
return test_compiler_version <= version
if operator == "!=" or operator == "!" or operator == "not":
return version_str not in test_compiler_version_str
return version_str in test_compiler_version_str
def expectedCompiler(compilers):
"""Returns True iff any element of compilers is a sub-string of the current compiler."""
if compilers is None:
return True
for compiler in compilers:
if compiler in getCompiler():
return True
# This is a helper function to determine if a specific version of Xcode's linker
# contains a TLS bug. We want to skip TLS tests if they contain this bug, but
# adding a linker/linker_version conditions to a decorator is challenging due to
# the number of ways linkers can enter the build process.
def xcode15LinkerBug(_self=None):
"""Returns true iff a test is running on a darwin platform and the host linker is between versions 1000 and 1109."""
darwin_platforms = lldbplatform.translate(lldbplatform.darwin_all)
if getPlatform() not in darwin_platforms:
return False
try:
raw_version_details = subprocess.check_output(
("xcrun", "ld", "-version_details")
)
version_details = json.loads(raw_version_details)
version = version_details.get("version", "0")
version_tuple = tuple(int(x) for x in version.split("."))
if (1000,) <= version_tuple <= (1109,):
return True
except:
pass
return False
|