<filename>src/clusterfuzz/_internal/platforms/android/sanitizer.py
# Copyright 2019 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""Sanitizer related functions."""

import os

from clusterfuzz._internal.metrics import logs
from clusterfuzz._internal.system import environment

from . import adb
from . import constants
from . import settings

try:
  from clusterfuzz._internal.system import new_process
except ImportError:
  # On App Engine.
  new_process = None

ASAN_SCRIPT_TIMEOUT = 15 * 60
SANITIZER_TOOL_TO_FILE_MAPPINGS = {
    'asan': 'asan.options',
}


def get_ld_library_path_for_sanitizers():
  """Return LD_LIBRARY_PATH setting for sanitizers, None otherwise."""
  if not settings.get_sanitizer_tool_name():
    return None

  sanitizer_libs = adb.run_shell_command(
      ['find', '/system/lib64/', '-name', '*san_standalone*'])
  if not sanitizer_libs:
    return None

  sanitizer_lib_directory = os.path.dirname(sanitizer_libs.splitlines()[0])
  return '/system/lib64:' + sanitizer_lib_directory


def get_options_file_path(sanitizer_tool_name):
  """Return path for the sanitizer options file."""
  # If this a full sanitizer system build, then update the options file in
  # /system, else just put it in device temp directory.
  sanitizer_directory = ('/system' if settings.get_sanitizer_tool_name() else
                         constants.DEVICE_TMP_DIR)

  sanitizer_filename = SANITIZER_TOOL_TO_FILE_MAPPINGS.get(
      sanitizer_tool_name.lower())
  if sanitizer_filename is None:
    logs.log_error('Unsupported sanitizer: ' + sanitizer_tool_name)
    return None

  return os.path.join(sanitizer_directory, sanitizer_filename)


def set_options(sanitizer_tool_name, sanitizer_options):
  """Set sanitizer options on the disk file."""
  sanitizer_options_file_path = get_options_file_path(sanitizer_tool_name)
  if not sanitizer_options_file_path:
    return

  adb.write_data_to_file(sanitizer_options, sanitizer_options_file_path)


def setup_asan_if_needed():
  """Set up asan on device."""
  if not environment.get_value('ASAN_DEVICE_SETUP'):
    # Only do this step if explicitly enabled in the job type. This cannot be
    # determined from libraries in application directory since they can go
    # missing in a bad build, so we want to catch that.
    return

  if settings.get_sanitizer_tool_name():
    # If this is a sanitizer build, no need to setup ASAN (incompatible).
    return

  app_directory = environment.get_value('APP_DIR')
  if not app_directory:
    # No app directory -> No ASAN runtime library. No work to do, bail out.
    return

  # Initialize variables.
  android_directory = environment.get_platform_resources_directory()
  device_id = environment.get_value('ANDROID_SERIAL')

  # Execute the script.
  logs.log('Executing ASan device setup script.')
  asan_device_setup_script_path = os.path.join(android_directory, 'third_party',
                                               'asan_device_setup.sh')
  extra_options_arg = 'include_if_exists=' + get_options_file_path('asan')
  asan_device_setup_script_args = [
      '--lib', app_directory, '--device', device_id, '--extra-options',
      extra_options_arg
  ]

  process = new_process.ProcessRunner(asan_device_setup_script_path,
                                      asan_device_setup_script_args)
  result = process.run_and_wait()
  if result.return_code:
    logs.log_error('Failed to setup ASan on device.', output=result.output)
    return

  logs.log(
      'ASan device setup script successfully finished, waiting for boot.',
      output=result.output)

  # Wait until fully booted as otherwise shell restart followed by a quick
  # reboot can trigger data corruption in /data/data.
  adb.wait_until_fully_booted()

<filename>src/clusterfuzz/_internal/platforms/android/sanitizer.py
# Copyright 2019 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""Sanitizer related functions."""

import os

from clusterfuzz._internal.metrics import logs
from clusterfuzz._internal.system import environment

from . import adb
from . import constants
from . import settings

try:
  from clusterfuzz._internal.system import new_process
except ImportError:
  # On App Engine.
  new_process = None

ASAN_SCRIPT_TIMEOUT = 15 * 60
SANITIZER_TOOL_TO_FILE_MAPPINGS = {
    'asan': 'asan.options',
}


def get_ld_library_path_for_sanitizers():
  """Return LD_LIBRARY_PATH setting for sanitizers, None otherwise."""
  if not settings.get_sanitizer_tool_name():
    return None

  sanitizer_libs = adb.run_shell_command(
      ['find', '/system/lib64/', '-name', '*san_standalone*'])
  if not sanitizer_libs:
    return None

  sanitizer_lib_directory = os.path.dirname(sanitizer_libs.splitlines()[0])
  return '/system/lib64:' + sanitizer_lib_directory


def get_options_file_path(sanitizer_tool_name):
  """Return path for the sanitizer options file."""
  # If this a full sanitizer system build, then update the options file in
  # /system, else just put it in device temp directory.
  sanitizer_directory = ('/system' if settings.get_sanitizer_tool_name() else
                         constants.DEVICE_TMP_DIR)

  sanitizer_filename = SANITIZER_TOOL_TO_FILE_MAPPINGS.get(
      sanitizer_tool_name.lower())
  if sanitizer_filename is None:
    logs.log_error('Unsupported sanitizer: ' + sanitizer_tool_name)
    return None

  return os.path.join(sanitizer_directory, sanitizer_filename)


def set_options(sanitizer_tool_name, sanitizer_options):
  """Set sanitizer options on the disk file."""
  sanitizer_options_file_path = get_options_file_path(sanitizer_tool_name)
  if not sanitizer_options_file_path:
    return

  adb.write_data_to_file(sanitizer_options, sanitizer_options_file_path)


def setup_asan_if_needed():
  """Set up asan on device."""
  if not environment.get_value('ASAN_DEVICE_SETUP'):
    # Only do this step if explicitly enabled in the job type. This cannot be
    # determined from libraries in application directory since they can go
    # missing in a bad build, so we want to catch that.
    return

  if settings.get_sanitizer_tool_name():
    # If this is a sanitizer build, no need to setup ASAN (incompatible).
    return

  app_directory = environment.get_value('APP_DIR')
  if not app_directory:
    # No app directory -> No ASAN runtime library. No work to do, bail out.
    return

  # Initialize variables.
  android_directory = environment.get_platform_resources_directory()
  device_id = environment.get_value('ANDROID_SERIAL')

  # Execute the script.
  logs.log('Executing ASan device setup script.')
  asan_device_setup_script_path = os.path.join(android_directory, 'third_party',
                                               'asan_device_setup.sh')
  extra_options_arg = 'include_if_exists=' + get_options_file_path('asan')
  asan_device_setup_script_args = [
      '--lib', app_directory, '--device', device_id, '--extra-options',
      extra_options_arg
  ]

  process = new_process.ProcessRunner(asan_device_setup_script_path,
                                      asan_device_setup_script_args)
  result = process.run_and_wait()
  if result.return_code:
    logs.log_error('Failed to setup ASan on device.', output=result.output)
    return

  logs.log(
      'ASan device setup script successfully finished, waiting for boot.',
      output=result.output)

  # Wait until fully booted as otherwise shell restart followed by a quick
  # reboot can trigger data corruption in /data/data.
  adb.wait_until_fully_booted()

# Copyright 2019 Google LLC # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # #      http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. Sanitizer related functions. # On App Engine. Return LD_LIBRARY_PATH setting for sanitizers, None otherwise. Return path for the sanitizer options file. # If this a full sanitizer system build, then update the options file in # /system, else just put it in device temp directory. Set sanitizer options on the disk file. Set up asan on device. # Only do this step if explicitly enabled in the job type. This cannot be # determined from libraries in application directory since they can go # missing in a bad build, so we want to catch that. # If this is a sanitizer build, no need to setup ASAN (incompatible). # No app directory -> No ASAN runtime library. No work to do, bail out. # Initialize variables. # Execute the script. # Wait until fully booted as otherwise shell restart followed by a quick # reboot can trigger data corruption in /data/data.