The Tor Browser: media/webrtc/trunk/build/android/gdb

media/webrtc/trunk/build/android/gdb_apk@8bccb770b82d (annotated)

media/webrtc/trunk/build/android/gdb_apk

Wed, 31 Dec 2014 13:27:57 +0100

author: Michael Schloh von Bennewitz <michael@schloh.com>
date: Wed, 31 Dec 2014 13:27:57 +0100
branch: TOR_BUG_3246
changeset 6: 8bccb770b82d
permissions: -rwxr-xr-x

Ignore runtime configuration files generated during quality assurance.

 #!/bin/bash
 #
 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 #
 # Attach gdb to a running android application.  Similar to ndk-gdb.
 # Run with --annotate=3 if running under emacs (M-x gdb).
 #
 # By default it is used to debug content shell, if it is used to
 # debug other piceces, '-p' and '-l' options are needed.
 # For *unittests_apk (like base_unittests_apk), run with:
 #  "gdb_apk -p org.chromium.native_test -l out/Release/lib.target -r"
 # Run a command through adb shell, strip the extra \r from the output
 # and return the correct status code to detect failures. This assumes
 # that the adb shell command prints a final \n to stdout.
 # args: command to run
 # Prints the command's stdout on stdout
 # Returns the command's status
 # Note: the command's stderr is lost
 adb_shell () {
   local TMPOUT="$(mktemp)"
   local LASTLINE RET
   local ADB=${ADB:-adb}
   # The weird sed rule is to strip the final \r on each output line
   # Since 'adb shell' never returns the command's proper exit/status code,
   # we force it to print it as '%%<status>' in the temporary output file,
   # which we will later strip from it.
   $ADB shell $@ ";" echo "%%\$?" 2>/dev/null | sed -e 's![[:cntrl:]]!!g' > $TMPOUT
   # Get last line in log, which contains the exit code from the command
   LASTLINE=$(sed -e '$!d' $TMPOUT)
   # Extract the status code from the end of the line, which must be '%%<code>'
   RET=$(echo "$LASTLINE" | awk '{ if (match($0, "%%[0-9]+$")) { print substr($0,RSTART+2); } }')
   # Remove the status code from the last line. Note that this may result in an empty line
   LASTLINE=$(echo "$LASTLINE" | awk '{ if (match($0, "%%[0-9]+$")) { print substr($0,1,RSTART-1); } }')
   # The output itself: all lines except the status code
   sed -e '$d' $TMPOUT && echo -n "$LASTLINE"
   # Remove temp file
   rm -f $TMPOUT
   # Exit with the appropriate status
   return $RET
 }
 adb=$(which adb)
 if [[ "$adb" = "" ]] ; then
   echo "Need adb in your path"
   exit 1
 fi
 usage() {
   echo "usage: ${0##*/} [-p package_name] [-l shared_lib_dir] [-g gdb] [-r]"
   echo "-p package_name     the android APK package to be debugged"
   echo "-l shared_lib_dir   directory containes native shared library"
   echo "-g gdb_args         agruments for gdb, eg: -g '-n -write'"
   echo "-r                  the target device is rooted"
 }
 process_options() {
   local OPTNAME OPTIND OPTERR OPTARG
   while getopts ":p:l:g:r" OPTNAME; do
     case "$OPTNAME" in
       p)
         package_name="$OPTARG"
         ;;
       l)
         shared_lib_dir="$OPTARG"
         ;;
       g)
         gdb_args="$OPTARG"
 		;;
       r)
         rooted_phone=1
         ;;
       \:)
         echo "'-$OPTARG' needs an argument."
         usage
         exit 1
         ;;
       *)
         echo "invalid command line option: $OPTARG"
         usage
         exit 1
         ;;
     esac
   done
   if [ $# -ge ${OPTIND} ]; then
     eval echo "Unexpected command line argument: \${${OPTIND}}"
     usage
     exit 1
   fi
 }
 rooted_phone=0
 root=$(dirname $0)/../..
 package_name=org.chromium.content_shell
 shared_lib_dir=$root/out/${BUILDTYPE:-Debug}/lib.target
 gdb_args=''
 #process options
 process_options "$@"
 echo "Debug package $package_name"
 echo "Assume native shared library is under $shared_lib_dir"
 data_dir=/data/data/$package_name
 gdb_server_on_device=$data_dir/lib/gdbserver
 # Kill any running gdbserver
 pid=$(adb shell ps | awk '/gdbserver/ {print $2}')
 if [[ "$pid" != "" ]] ; then
   if [[ $rooted_phone -eq 1 ]] ; then
     adb shell kill $pid
   else
     adb shell run-as $package_name kill $pid
   fi
 fi
 pid=$(adb_shell ps | awk "/$package_name$/ {print \$2}")
 if [[ "$pid" = "" ]] ; then
   echo "No $package_name running?"
   echo "Try this: adb shell am start -a android.intent.action.VIEW " \
     "-n $package_name/.SomethingActivity (Something might be ContentShell)"
   exit 2
 fi
 no_gdb_server=$(adb shell ls $gdb_server_on_device | grep 'No such file')
 if [[ "$no_gdb_server" != "" ]] ; then
   echo "No gdb server on device at $gdb_server_on_device"
   echo "Please install a debug build."
   exit 3
 fi
 if [[ $rooted_phone -eq 1 ]] ; then
   adb shell $gdb_server_on_device :4321 --attach $pid &
   adb forward tcp:4321 tcp:4321
 else
   adb shell run-as $package_name lib/gdbserver +debug-socket --attach $pid &
   adb forward tcp:4321 localfilesystem:$data_dir/debug-socket
 fi
 sleep 2
 # Pull app_process and C libraries from device if needed
 app_process=${shared_lib_dir}/app_process
 if [[ ! -f ${app_process} ]] ; then
   adb pull /system/bin/app_process ${app_process}
   adb pull /system/lib/libc.so ${shared_lib_dir}
 fi
 # gdb commands
 cmdfile=$(mktemp /tmp/gdb_android_XXXXXXXX)
 cat >$cmdfile<<EOF
 # set solib-absolute-prefix null
 set solib-search-path ${shared_lib_dir}
 file ${app_process}
 target remote :4321
 EOF
 gdb=$(echo $ANDROID_TOOLCHAIN/../../linux-x86/bin/*gdb)
 if [[ ! -f ${gdb} ]] ; then
   echo "Wow no gdb in env var ANDROID_TOOLCHAIN which is $ANDROID_TOOLCHAIN"
   exit 4
 else
   echo Using $gdb
 fi
 # ${gdb} -x $cmdfile $* $app_process
 ${gdb} -x $cmdfile $gdb_args
 rm $cmdfile

The Tor Browser / annotate

media/webrtc/trunk/build/android/gdb_apk@8bccb770b82d (annotated)

media/webrtc/trunk/build/android/gdb_apk