diff options
Diffstat (limited to 'toolkit/crashreporter/google-breakpad/android/common-functions.sh')
| -rwxr-xr-x | toolkit/crashreporter/google-breakpad/android/common-functions.sh | 372 |
1 files changed, 0 insertions, 372 deletions
diff --git a/toolkit/crashreporter/google-breakpad/android/common-functions.sh b/toolkit/crashreporter/google-breakpad/android/common-functions.sh deleted file mode 100755 index c00e34f99..000000000 --- a/toolkit/crashreporter/google-breakpad/android/common-functions.sh +++ /dev/null @@ -1,372 +0,0 @@ -# Copyright (c) 2012 Google Inc. -# All rights reserved. -# -# Redistribution and use in source and binary forms, with or without -# modification, are permitted provided that the following conditions are -# met: -# -# * Redistributions of source code must retain the above copyright -# notice, this list of conditions and the following disclaimer. -# * Redistributions in binary form must reproduce the above -# copyright notice, this list of conditions and the following disclaimer -# in the documentation and/or other materials provided with the -# distribution. -# * Neither the name of Google Inc. nor the names of its -# contributors may be used to endorse or promote products derived from -# this software without specific prior written permission. -# -# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - -# Collection of common shell functions for 'run-checks.sh' et 'test-shell.sh' - -# All internal variables and functions use an underscore as a prefix -# (e.g. _VERBOSE, _ALL_CLEANUPS, etc..). - -# Sanitize the environment -export LANG=C -export LC_ALL=C - -if [ "$BASH_VERSION" ]; then - set -o posix -fi - -# Utility functions - -_ALL_CLEANUPS= - -# Register a function to be called when the script exits, even in case of -# Ctrl-C, logout, etc. -# $1: function name. -atexit () { - if [ -z "$_ALL_CLEANUPS" ]; then - _ALL_CLEANUPS=$1 - # Ensure a clean exit when the script is: - # - Exiting normally (EXIT) - # - Interrupted by Ctrl-C (INT) - # - Interrupted by log out (HUP) - # - Being asked to quit nicely (TERM) - # - Being asked to quit and dump core (QUIT) - trap "_exit_cleanups \$?" EXIT INT HUP QUIT TERM - else - _ALL_CLEANUPS="$_ALL_CLEANUPS $1" - fi -} - -# Called on exit if at least one function was registered with atexit -# $1: final exit status code -_exit_cleanups () { - local CLEANUP CLEANUPS - # Ignore calls to atexit during cleanups - CLEANUPS=$_ALL_CLEANUPS - _ALL_CLEANUPS= - for CLEANUP in $CLEANUPS; do - ($CLEANUP) - done - exit "$@" -} - - - - -# Dump a panic message then exit. -# $1+: message -panic () { - echo "ERROR: $@" >&2 - exit 1 -} - -# If the previous command failed, dump a panic message then exit. -# $1+: message. -fail_panic () { - if [ $? != 0 ]; then - panic "$@" - fi; -} - -_VERBOSE=0 - -# Increase verbosity for dump/log/run/run2 functions -increase_verbosity () { - _VERBOSE=$(( $_VERBOSE + 1 )) -} - -# Decrease verbosity -decrease_verbosity () { - _VERBOSE=$(( $_VERBOSE - 1 )) -} - -# Returns success iff verbosity level is higher than a specific value -# $1: verbosity level -verbosity_is_higher_than () { - [ "$_VERBOSE" -gt "$1" ] -} - -# Returns success iff verbosity level is lower than a specific value -# $1: verbosity level -verbosity_is_lower_than () { - [ "$_VERBOSE" -le "$1" ] -} - -# Dump message to stdout, unless verbosity is < 0, i.e. --quiet was called -# $1+: message -dump () { - if [ "$_VERBOSE" -ge 0 ]; then - printf "%s\n" "$*" - fi -} - -# If --verbose was used, dump a message to stdout. -# $1+: message -log () { - if [ "$_VERBOSE" -ge 1 ]; then - printf "%s\n" "$*" - fi -} - -_RUN_LOG= - -# Set a run log file that can be used to collect the output of commands that -# are not displayed. -set_run_log () { - _RUN_LOG=$1 -} - -# Run a command. Output depends on $_VERBOSE: -# $_VERBOSE <= 0: Run command, store output into the run log -# $_VERBOSE >= 1: Dump command, run it, output goest to stdout -# Note: Ideally, the command's output would go to the run log for $_VERBOSE >= 1 -# but the 'tee' tool doesn't preserve the status code of its input pipe -# in case of error. -run () { - local LOGILE - if [ "$_RUN_LOG" ]; then - LOGFILE=$_RUN_LOG - else - LOGFILE=/dev/null - fi - - if [ "$_VERBOSE" -ge 1 ]; then - echo "COMMAND: $@" - "$@" - else - "$@" >>$LOGFILE 2>&1 - fi -} - -# Same as run(), but only dump command output for $_VERBOSE >= 2 -run2 () { - local LOGILE - if [ "$_RUN_LOG" ]; then - LOGFILE=$_RUN_LOG - else - LOGFILE=/dev/null - fi - - if [ "$_VERBOSE" -ge 1 ]; then - echo "COMMAND: $@" - fi - if [ "$_VERBOSE" -ge 2 ]; then - "$@" - else - "$@" >>$LOGFILE 2>&1 - fi -} - -# Extract number of cores to speed up the builds -# Out: number of CPU cores -get_core_count () { - case $(uname -s) in - Linux) - grep -c -e '^processor' /proc/cpuinfo - ;; - Darwin) - sysctl -n hw.ncpu - ;; - CYGWIN*|*_NT-*) - echo $NUMBER_OF_PROCESSORS - ;; - *) - echo 1 - ;; - esac -} - - -# Check for the Android ADB program. -# -# On success, return nothing, but updates internal variables so later calls to -# adb_shell, adb_push, etc.. will work. You can get the path to the ADB program -# with adb_get_program if needed. -# -# On failure, returns 1, and updates the internal adb error message, which can -# be retrieved with adb_get_error. -# -# $1: optional ADB program path. -# Return: success or failure. -_ADB= -_ADB_STATUS= -_ADB_ERROR= - -adb_check () { - # First, try to find the executable in the path, or the SDK install dir. - _ADB=$1 - if [ -z "$_ADB" ]; then - _ADB=$(which adb 2>/dev/null) - if [ -z "$_ADB" -a "$ANDROID_SDK_ROOT" ]; then - _ADB=$ANDROID_SDK_ROOT/platform-tools/adb - if [ ! -f "$_ADB" ]; then - _ADB= - fi - fi - if [ -z "$_ADB" ]; then - _ADB_STATUS=1 - _ADB_ERROR="The Android 'adb' tool is not in your path." - return 1 - fi - fi - - log "Found ADB program: $_ADB" - - # Check that it works correctly - local ADB_VERSION - ADB_VERSION=$("$_ADB" version 2>/dev/null) - case $ADB_VERSION in - "Android Debug Bridge "*) # Pass - log "Found ADB version: $ADB_VERSION" - ;; - *) # Fail - _ADB_ERROR="Your ADB binary reports a bad version ($ADB_VERSION): $_ADB" - _ADB_STATUS=1 - return 1 - esac - - _ADB_STATUS=0 - return 0 -} - - -# Return the path to the Android ADB program, if correctly detected. -# On failure, return the empty string. -# Out: ADB program path (or empty on failure) -# Return: success or failure. -adb_get_program () { - # Return cached value as soon as possible. - if [ -z "$_ADB_STATUS" ]; then - adb_check $1 - fi - echo "$_ADB" - return $_ADB_STATUS -} - -# Return the error corresponding to the last ADB function failure. -adb_get_error () { - echo "$_ADB_ERROR" -} - -# Check that there is one device connected through ADB. -# In case of failure, use adb_get_error to know why this failed. -# $1: Optional adb program path -# Return: success or failure. -_ADB_DEVICE= -_ADB_DEVICE_STATUS= -adb_check_device () { - if [ "$_ADB_DEVICE_STATUS" ]; then - return $_ADB_DEVICE_STATUS - fi - - # Check for ADB. - if ! adb_check $1; then - _ADB_DEVICE_STATUS=$_ADB_STATUS - return 1 - fi - - local ADB_DEVICES NUM_DEVICES FINGERPRINT - - # Count the number of connected devices. - ADB_DEVICES=$("$_ADB" devices 2>/dev/null | awk '$2 == "device" { print $1; }') - NUM_DEVICES=$(echo "$ADB_DEVICES" | wc -l) - case $NUM_DEVICES in - 0) - _ADB_ERROR="No Android device connected. Please connect one to your machine." - _ADB_DEVICE_STATUS=1 - return 1 - ;; - 1) # Pass - # Ensure the same device will be called in later adb_shell calls. - export ANDROID_SERIAL=$ADB_DEVICES - ;; - *) # 2 or more devices. - if [ "$ANDROID_SERIAL" ]; then - ADB_DEVICES=$ANDROID_SERIAL - NUM_DEVICES=1 - else - _ADB_ERROR="More than one Android device connected. \ -Please define ANDROID_SERIAL in your environment" - _ADB_DEVICE_STATUS=1 - return 1 - fi - ;; - esac - - _ADB_DEVICE_STATUS=0 - _ADB_DEVICE=$ADB_DEVICES - - FINGERPRINT=$(adb_shell getprop ro.build.fingerprint) - log "Using ADB device: $ANDROID_SERIAL ($FINGERPRINT)" - return 0 -} - -# The 'adb shell' command is pretty hopeless, try to make sense of it by: -# 1/ Removing trailing \r from line endings. -# 2/ Ensuring the function returns the command's status code. -# -# $1+: Command -# Out: command output (stdout + stderr combined) -# Return: command exit status -adb_shell () { - local RET ADB_LOG - # Check for ADB device. - adb_check_device || return 1 - ADB_LOG=$(mktemp "${TMPDIR:-/tmp}/adb-XXXXXXXX") - "$_ADB" shell "$@" ";" echo \$? > "$ADB_LOG" 2>&1 - sed -i -e 's![[:cntrl:]]!!g' "$ADB_LOG" # Remove \r. - RET=$(sed -e '$!d' "$ADB_LOG") # Last line contains status code. - sed -e '$d' "$ADB_LOG" # Print everything except last line. - rm -f "$ADB_LOG" - return $RET -} - -# Push a file to a device. -# $1: source file path -# $2: device target file path -# Return: success or failure. -adb_push () { - adb_check_device || return 1 - run "$_ADB" push "$1" "$2" -} - -# Pull a file from a device -# $1: device file path -# $2: target host file path -# Return: success or failure. -adb_pull () { - adb_check_device || return 1 - run "$_ADB" pull "$1" "$2" -} - -# Same as adb_push, but will panic if the operations didn't succeed. -adb_install () { - adb_push "$@" - fail_panic "Failed to install $1 to the Android device at $2" -} - |