envsetup.sh 48.6 KB
Newer Older
1
function hmm() {
2
cat <<EOF
3
Invoke ". build/envsetup.sh" from your shell to add the following functions to your environment:
4
- lunch:   lunch <product_name>-<build_variant>
5
- tapas:   tapas [<App1> <App2> ...] [arm|x86|mips|armv5|arm64|x86_64|mips64] [eng|userdebug|user]
6 7
- croot:   Changes directory to the top of the tree.
- m:       Makes from the top of the tree.
Ying Wang's avatar
Ying Wang committed
8 9
- mm:      Builds all of the modules in the current directory, but not their dependencies.
- mmm:     Builds all of the modules in the supplied directories, but not their dependencies.
10
           To limit the modules being built use the syntax: mmm dir/:target1,target2.
Ying Wang's avatar
Ying Wang committed
11 12
- mma:     Builds all of the modules in the current directory, and their dependencies.
- mmma:    Builds all of the modules in the supplied directories, and their dependencies.
13
- cgrep:   Greps on all local C/C++ files.
Jon Boekenoogen's avatar
ggrep  
Jon Boekenoogen committed
14
- ggrep:   Greps on all local Gradle files.
15 16
- jgrep:   Greps on all local Java files.
- resgrep: Greps on all local res/*.xml files.
17
- sgrep:   Greps on all local source files.
18
- godir:   Go to the directory containing a file.
19 20 21 22 23 24

Look at the source to view more functions. The complete list is:
EOF
    T=$(gettop)
    local A
    A=""
25
    for i in `cat $T/build/envsetup.sh | sed -n "/^[ \t]*function /s/function \([a-z_]*\).*/\1/p" | sort | uniq`; do
26 27 28 29 30 31 32 33 34 35 36 37 38
      A="$A $i"
    done
    echo $A
}

# Get the value of a build variable as an absolute path.
function get_abs_build_var()
{
    T=$(gettop)
    if [ ! "$T" ]; then
        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
        return
    fi
39
    (\cd $T; CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
40
      command make --no-print-directory -f build/core/config.mk dumpvar-abs-$1)
41 42 43 44 45 46 47 48 49 50
}

# Get the exact value of a build variable.
function get_build_var()
{
    T=$(gettop)
    if [ ! "$T" ]; then
        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
        return
    fi
51
    (\cd $T; CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
52
      command make --no-print-directory -f build/core/config.mk dumpvar-$1)
53 54 55 56 57 58 59 60 61 62
}

# check to see if the supplied product is one we can build
function check_product()
{
    T=$(gettop)
    if [ ! "$T" ]; then
        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
        return
    fi
63 64 65
        TARGET_PRODUCT=$1 \
        TARGET_BUILD_VARIANT= \
        TARGET_BUILD_TYPE= \
Joe Onorato's avatar
Joe Onorato committed
66
        TARGET_BUILD_APPS= \
67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83
        get_build_var TARGET_DEVICE > /dev/null
    # hide successful answers, but allow the errors to show
}

VARIANT_CHOICES=(user userdebug eng)

# check to see if the supplied variant is valid
function check_variant()
{
    for v in ${VARIANT_CHOICES[@]}
    do
        if [ "$v" = "$1" ]
        then
            return 0
        fi
    done
    return 1
84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104
}

function setpaths()
{
    T=$(gettop)
    if [ ! "$T" ]; then
        echo "Couldn't locate the top of the tree.  Try setting TOP."
        return
    fi

    ##################################################################
    #                                                                #
    #              Read me before you modify this code               #
    #                                                                #
    #   This function sets ANDROID_BUILD_PATHS to what it is adding  #
    #   to PATH, and the next time it is run, it removes that from   #
    #   PATH.  This is required so lunch can be run more than once   #
    #   and still have working paths.                                #
    #                                                                #
    ##################################################################

105 106 107
    # Note: on windows/cygwin, ANDROID_BUILD_PATHS will contain spaces
    # due to "C:\Program Files" being in the path.

108
    # out with the old
109
    if [ -n "$ANDROID_BUILD_PATHS" ] ; then
110 111
        export PATH=${PATH/$ANDROID_BUILD_PATHS/}
    fi
112
    if [ -n "$ANDROID_PRE_BUILD_PATHS" ] ; then
113
        export PATH=${PATH/$ANDROID_PRE_BUILD_PATHS/}
114 115
        # strip leading ':', if any
        export PATH=${PATH/:%/}
116
    fi
117 118 119

    # and in with the new
    prebuiltdir=$(getprebuilt)
120
    gccprebuiltdir=$(get_abs_build_var ANDROID_GCC_PREBUILTS)
121

122 123
    # defined in core/config.mk
    targetgccversion=$(get_build_var TARGET_GCC_VERSION)
124
    targetgccversion2=$(get_build_var 2ND_TARGET_GCC_VERSION)
125
    export TARGET_GCC_VERSION=$targetgccversion
126

127
    # The gcc toolchain does not exists for windows/cygwin. In this case, do not reference it.
128 129
    export ANDROID_TOOLCHAIN=
    export ANDROID_TOOLCHAIN_2ND_ARCH=
130 131
    local ARCH=$(get_build_var TARGET_ARCH)
    case $ARCH in
132
        x86) toolchaindir=x86/x86_64-linux-android-$targetgccversion/bin
Mark D Horn's avatar
Mark D Horn committed
133
            ;;
Pavel Chupin's avatar
Pavel Chupin committed
134 135
        x86_64) toolchaindir=x86/x86_64-linux-android-$targetgccversion/bin
            ;;
136
        arm) toolchaindir=arm/arm-linux-androideabi-$targetgccversion/bin
137
            ;;
138
        arm64) toolchaindir=aarch64/aarch64-linux-android-$targetgccversion/bin;
139
               toolchaindir2=arm/arm-linux-androideabi-$targetgccversion2/bin
140
            ;;
141
        mips|mips64) toolchaindir=mips/mips64el-linux-android-$targetgccversion/bin
Serban Constantinescu's avatar
Serban Constantinescu committed
142
            ;;
143 144 145
        *)
            echo "Can't find toolchain for unknown architecture: $ARCH"
            toolchaindir=xxxxxxxxx
Mark D Horn's avatar
Mark D Horn committed
146 147
            ;;
    esac
148
    if [ -d "$gccprebuiltdir/$toolchaindir" ]; then
149
        export ANDROID_TOOLCHAIN=$gccprebuiltdir/$toolchaindir
150
    fi
151

152 153 154 155 156
    if [ -d "$gccprebuiltdir/$toolchaindir2" ]; then
        export ANDROID_TOOLCHAIN_2ND_ARCH=$gccprebuiltdir/$toolchaindir2
    fi

    unset ANDROID_KERNEL_TOOLCHAIN_PATH
Ying Wang's avatar
Ying Wang committed
157
    case $ARCH in
Bruce Beare's avatar
Bruce Beare committed
158
        arm)
159
            # Legacy toolchain configuration used for ARM kernel compilation
160
            toolchaindir=arm/arm-eabi-$targetgccversion/bin
Bruce Beare's avatar
Bruce Beare committed
161
            if [ -d "$gccprebuiltdir/$toolchaindir" ]; then
162 163
                 export ARM_EABI_TOOLCHAIN="$gccprebuiltdir/$toolchaindir"
                 ANDROID_KERNEL_TOOLCHAIN_PATH="$ARM_EABI_TOOLCHAIN":
Bruce Beare's avatar
Bruce Beare committed
164
            fi
Ying Wang's avatar
Ying Wang committed
165 166
            ;;
        *)
Bruce Beare's avatar
Bruce Beare committed
167
            # No need to set ARM_EABI_TOOLCHAIN for other ARCHs
Ying Wang's avatar
Ying Wang committed
168 169 170
            ;;
    esac

171
    export ANDROID_DEV_SCRIPTS=$T/development/scripts:$T/prebuilts/devtools/tools
172
    export ANDROID_BUILD_PATHS=$(get_build_var ANDROID_BUILD_PATHS):$ANDROID_TOOLCHAIN:$ANDROID_TOOLCHAIN_2ND_ARCH:$ANDROID_KERNEL_TOOLCHAIN_PATH$ANDROID_DEV_SCRIPTS:
173 174 175 176 177 178 179 180 181 182 183 184 185 186 187

    # If prebuilts/android-emulator/<system>/ exists, prepend it to our PATH
    # to ensure that the corresponding 'emulator' binaries are used.
    case $(uname -s) in
        Darwin)
            ANDROID_EMULATOR_PREBUILTS=$T/prebuilts/android-emulator/darwin-x86_64
            ;;
        Linux)
            ANDROID_EMULATOR_PREBUILTS=$T/prebuilts/android-emulator/linux-x86_64
            ;;
        *)
            ANDROID_EMULATOR_PREBUILTS=
            ;;
    esac
    if [ -n "$ANDROID_EMULATOR_PREBUILTS" -a -d "$ANDROID_EMULATOR_PREBUILTS" ]; then
188
        ANDROID_BUILD_PATHS=$ANDROID_BUILD_PATHS$ANDROID_EMULATOR_PREBUILTS:
189 190 191
        export ANDROID_EMULATOR_PREBUILTS
    fi

192
    export PATH=$ANDROID_BUILD_PATHS$PATH
193

194
    unset ANDROID_JAVA_TOOLCHAIN
195
    unset ANDROID_PRE_BUILD_PATHS
196 197
    if [ -n "$JAVA_HOME" ]; then
        export ANDROID_JAVA_TOOLCHAIN=$JAVA_HOME/bin
198 199
        export ANDROID_PRE_BUILD_PATHS=$ANDROID_JAVA_TOOLCHAIN:
        export PATH=$ANDROID_PRE_BUILD_PATHS$PATH
200 201
    fi

202
    unset ANDROID_PRODUCT_OUT
203 204 205
    export ANDROID_PRODUCT_OUT=$(get_abs_build_var PRODUCT_OUT)
    export OUT=$ANDROID_PRODUCT_OUT

206 207 208
    unset ANDROID_HOST_OUT
    export ANDROID_HOST_OUT=$(get_abs_build_var HOST_OUT)

209
    # needed for building linux on MacOS
210 211 212 213 214 215
    # TODO: fix the path
    #export HOST_EXTRACFLAGS="-I "$T/system/kernel_headers/host_include
}

function printconfig()
{
216 217 218 219 220 221
    T=$(gettop)
    if [ ! "$T" ]; then
        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
        return
    fi
    get_build_var report_config
222 223 224 225
}

function set_stuff_for_environment()
{
226
    settitle
227
    set_java_home
228 229
    setpaths
    set_sequence_number
230

231
    export ANDROID_BUILD_TOP=$(gettop)
Ben Cheng's avatar
Ben Cheng committed
232 233
    # With this environment variable new GCC can apply colors to warnings/errors
    export GCC_COLORS='error=01;31:warning=01;35:note=01;36:caret=01;32:locus=01:quote=01'
234 235 236 237
}

function set_sequence_number()
{
238
    export BUILD_ENV_SEQUENCE_NUMBER=10
239 240 241 242
}

function settitle()
{
243
    if [ "$STAY_OFF_MY_LAWN" = "" ]; then
244
        local arch=$(gettargetarch)
Joe Onorato's avatar
Joe Onorato committed
245 246 247 248
        local product=$TARGET_PRODUCT
        local variant=$TARGET_BUILD_VARIANT
        local apps=$TARGET_BUILD_APPS
        if [ -z "$apps" ]; then
249
            export PROMPT_COMMAND="echo -ne \"\033]0;[${arch}-${product}-${variant}] ${USER}@${HOSTNAME}: ${PWD}\007\""
Joe Onorato's avatar
Joe Onorato committed
250
        else
251
            export PROMPT_COMMAND="echo -ne \"\033]0;[$arch $apps $variant] ${USER}@${HOSTNAME}: ${PWD}\007\""
Joe Onorato's avatar
Joe Onorato committed
252
        fi
253
    fi
254 255
}

Kenny Root's avatar
Kenny Root committed
256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271
function addcompletions()
{
    local T dir f

    # Keep us from trying to run in something that isn't bash.
    if [ -z "${BASH_VERSION}" ]; then
        return
    fi

    # Keep us from trying to run in bash that's too old.
    if [ ${BASH_VERSINFO[0]} -lt 3 ]; then
        return
    fi

    dir="sdk/bash_completion"
    if [ -d ${dir} ]; then
272
        for f in `/bin/ls ${dir}/[a-z]*.bash 2> /dev/null`; do
Kenny Root's avatar
Kenny Root committed
273 274 275 276 277 278
            echo "including $f"
            . $f
        done
    fi
}

279 280 281 282 283 284 285
function choosetype()
{
    echo "Build type choices are:"
    echo "     1. release"
    echo "     2. debug"
    echo

286
    local DEFAULT_NUM DEFAULT_VALUE
287 288
    DEFAULT_NUM=1
    DEFAULT_VALUE=release
289

290 291
    export TARGET_BUILD_TYPE=
    local ANSWER
292 293 294
    while [ -z $TARGET_BUILD_TYPE ]
    do
        echo -n "Which would you like? ["$DEFAULT_NUM"] "
295 296 297 298 299 300
        if [ -z "$1" ] ; then
            read ANSWER
        else
            echo $1
            ANSWER=$1
        fi
301 302 303 304 305 306 307
        case $ANSWER in
        "")
            export TARGET_BUILD_TYPE=$DEFAULT_VALUE
            ;;
        1)
            export TARGET_BUILD_TYPE=release
            ;;
308 309 310
        release)
            export TARGET_BUILD_TYPE=release
            ;;
311 312 313
        2)
            export TARGET_BUILD_TYPE=debug
            ;;
314 315 316
        debug)
            export TARGET_BUILD_TYPE=debug
            ;;
317 318 319 320 321 322
        *)
            echo
            echo "I didn't understand your response.  Please try again."
            echo
            ;;
        esac
323 324 325
        if [ -n "$1" ] ; then
            break
        fi
326 327 328 329 330
    done

    set_stuff_for_environment
}

331 332 333 334 335 336
#
# This function isn't really right:  It chooses a TARGET_PRODUCT
# based on the list of boards.  Usually, that gets you something
# that kinda works with a generic product, but really, you should
# pick a product by name.
#
337 338 339 340 341
function chooseproduct()
{
    if [ "x$TARGET_PRODUCT" != x ] ; then
        default_value=$TARGET_PRODUCT
    else
342
        default_value=full
343 344
    fi

345 346
    export TARGET_PRODUCT=
    local ANSWER
347 348
    while [ -z "$TARGET_PRODUCT" ]
    do
349
        echo -n "Which product would you like? [$default_value] "
350 351 352 353 354 355 356
        if [ -z "$1" ] ; then
            read ANSWER
        else
            echo $1
            ANSWER=$1
        fi

357 358
        if [ -z "$ANSWER" ] ; then
            export TARGET_PRODUCT=$default_value
359 360 361 362 363 364 365 366 367 368
        else
            if check_product $ANSWER
            then
                export TARGET_PRODUCT=$ANSWER
            else
                echo "** Not a valid product: $ANSWER"
            fi
        fi
        if [ -n "$1" ] ; then
            break
369 370 371 372 373 374
        fi
    done

    set_stuff_for_environment
}

375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405
function choosevariant()
{
    echo "Variant choices are:"
    local index=1
    local v
    for v in ${VARIANT_CHOICES[@]}
    do
        # The product name is the name of the directory containing
        # the makefile we found, above.
        echo "     $index. $v"
        index=$(($index+1))
    done

    local default_value=eng
    local ANSWER

    export TARGET_BUILD_VARIANT=
    while [ -z "$TARGET_BUILD_VARIANT" ]
    do
        echo -n "Which would you like? [$default_value] "
        if [ -z "$1" ] ; then
            read ANSWER
        else
            echo $1
            ANSWER=$1
        fi

        if [ -z "$ANSWER" ] ; then
            export TARGET_BUILD_VARIANT=$default_value
        elif (echo -n $ANSWER | grep -q -e "^[0-9][0-9]*$") ; then
            if [ "$ANSWER" -le "${#VARIANT_CHOICES[@]}" ] ; then
406
                export TARGET_BUILD_VARIANT=${VARIANT_CHOICES[$(($ANSWER-1))]}
407 408 409 410 411 412 413 414 415 416 417 418 419 420 421
            fi
        else
            if check_variant $ANSWER
            then
                export TARGET_BUILD_VARIANT=$ANSWER
            else
                echo "** Not a valid variant: $ANSWER"
            fi
        fi
        if [ -n "$1" ] ; then
            break
        fi
    done
}

422 423
function choosecombo()
{
424
    choosetype $1
425 426 427

    echo
    echo
428
    chooseproduct $2
429 430 431

    echo
    echo
432
    choosevariant $3
433

434 435
    echo
    set_stuff_for_environment
436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451
    printconfig
}

# Clear this variable.  It will be built up again when the vendorsetup.sh
# files are included at the end of this file.
unset LUNCH_MENU_CHOICES
function add_lunch_combo()
{
    local new_combo=$1
    local c
    for c in ${LUNCH_MENU_CHOICES[@]} ; do
        if [ "$new_combo" = "$c" ] ; then
            return
        fi
    done
    LUNCH_MENU_CHOICES=(${LUNCH_MENU_CHOICES[@]} $new_combo)
452 453
}

454
# add the default one here
455
add_lunch_combo aosp_arm-eng
Serban Constantinescu's avatar
Serban Constantinescu committed
456
add_lunch_combo aosp_arm64-eng
457
add_lunch_combo aosp_mips-eng
Chris Dearman's avatar
Chris Dearman committed
458
add_lunch_combo aosp_mips64-eng
Serban Constantinescu's avatar
Serban Constantinescu committed
459
add_lunch_combo aosp_x86-eng
Pavel Chupin's avatar
Pavel Chupin committed
460
add_lunch_combo aosp_x86_64-eng
461

462 463 464 465 466 467 468
function print_lunch_menu()
{
    local uname=$(uname)
    echo
    echo "You're building on" $uname
    echo
    echo "Lunch menu... pick a combo:"
469 470 471 472 473 474 475 476 477

    local i=1
    local choice
    for choice in ${LUNCH_MENU_CHOICES[@]}
    do
        echo "     $i. $choice"
        i=$(($i+1))
    done

478 479 480 481 482
    echo
}

function lunch()
{
483 484
    local answer

485
    if [ "$1" ] ; then
486
        answer=$1
487 488
    else
        print_lunch_menu
489
        echo -n "Which would you like? [aosp_arm-eng] "
490
        read answer
491 492
    fi

493 494 495 496
    local selection=

    if [ -z "$answer" ]
    then
497
        selection=aosp_arm-eng
498 499 500 501
    elif (echo -n $answer | grep -q -e "^[0-9][0-9]*$")
    then
        if [ $answer -le ${#LUNCH_MENU_CHOICES[@]} ]
        then
502
            selection=${LUNCH_MENU_CHOICES[$(($answer-1))]}
503 504
        fi
    elif (echo -n $answer | grep -q -e "^[^\-][^\-]*-[^\-][^\-]*$")
505
    then
506
        selection=$answer
507 508
    fi

509 510 511 512 513 514 515
    if [ -z "$selection" ]
    then
        echo
        echo "Invalid lunch combo: $answer"
        return 1
    fi

Joe Onorato's avatar
Joe Onorato committed
516 517
    export TARGET_BUILD_APPS=

518 519 520
    local product=$(echo -n $selection | sed -e "s/-.*$//")
    check_product $product
    if [ $? -ne 0 ]
521
    then
522 523 524 525 526
        echo
        echo "** Don't have a product spec for: '$product'"
        echo "** Do you have the right repo manifest?"
        product=
    fi
527

528 529 530 531 532 533 534 535 536
    local variant=$(echo -n $selection | sed -e "s/^[^\-]*-//")
    check_variant $variant
    if [ $? -ne 0 ]
    then
        echo
        echo "** Invalid variant: '$variant'"
        echo "** Must be one of ${VARIANT_CHOICES[@]}"
        variant=
    fi
537

538 539 540 541 542
    if [ -z "$product" -o -z "$variant" ]
    then
        echo
        return 1
    fi
543

544 545 546
    export TARGET_PRODUCT=$product
    export TARGET_BUILD_VARIANT=$variant
    export TARGET_BUILD_TYPE=release
547

548 549 550 551
    echo

    set_stuff_for_environment
    printconfig
552 553
}

Jeff Davidson's avatar
Jeff Davidson committed
554 555 556 557 558 559 560 561 562 563 564 565 566
# Tab completion for lunch.
function _lunch()
{
    local cur prev opts
    COMPREPLY=()
    cur="${COMP_WORDS[COMP_CWORD]}"
    prev="${COMP_WORDS[COMP_CWORD-1]}"

    COMPREPLY=( $(compgen -W "${LUNCH_MENU_CHOICES[*]}" -- ${cur}) )
    return 0
}
complete -F _lunch lunch

Joe Onorato's avatar
Joe Onorato committed
567
# Configures the build to build unbundled apps.
568
# Run tapas with one or more app names (from LOCAL_PACKAGE_NAME)
Joe Onorato's avatar
Joe Onorato committed
569 570
function tapas()
{
571
    local arch="$(echo $* | xargs -n 1 echo | \grep -E '^(arm|x86|mips|armv5|arm64|x86_64|mips64)$' | xargs)"
572
    local variant="$(echo $* | xargs -n 1 echo | \grep -E '^(user|userdebug|eng)$' | xargs)"
Jeff Hamilton's avatar
Jeff Hamilton committed
573 574
    local density="$(echo $* | xargs -n 1 echo | \grep -E '^(ldpi|mdpi|tvdpi|hdpi|xhdpi|xxhdpi|xxxhdpi|alldpi)$' | xargs)"
    local apps="$(echo $* | xargs -n 1 echo | \grep -E -v '^(user|userdebug|eng|arm|x86|mips|armv5|arm64|x86_64|mips64|ldpi|mdpi|tvdpi|hdpi|xhdpi|xxhdpi|xxxhdpi|alldpi)$' | xargs)"
Joe Onorato's avatar
Joe Onorato committed
575

576 577 578 579
    if [ $(echo $arch | wc -w) -gt 1 ]; then
        echo "tapas: Error: Multiple build archs supplied: $arch"
        return
    fi
Joe Onorato's avatar
Joe Onorato committed
580 581 582 583
    if [ $(echo $variant | wc -w) -gt 1 ]; then
        echo "tapas: Error: Multiple build variants supplied: $variant"
        return
    fi
Jeff Hamilton's avatar
Jeff Hamilton committed
584 585 586 587
    if [ $(echo $density | wc -w) -gt 1 ]; then
        echo "tapas: Error: Multiple densities supplied: $density"
        return
    fi
588 589 590

    local product=full
    case $arch in
591 592 593 594 595 596
      x86)    product=full_x86;;
      mips)   product=full_mips;;
      armv5)  product=generic_armv5;;
      arm64)  product=aosp_arm64;;
      x86_64) product=aosp_x86_64;;
      mips64)  product=aosp_mips64;;
597
    esac
Joe Onorato's avatar
Joe Onorato committed
598 599 600
    if [ -z "$variant" ]; then
        variant=eng
    fi
601 602 603
    if [ -z "$apps" ]; then
        apps=all
    fi
604 605 606
    if [ -z "$density" ]; then
        density=alldpi
    fi
Joe Onorato's avatar
Joe Onorato committed
607

608
    export TARGET_PRODUCT=$product
Joe Onorato's avatar
Joe Onorato committed
609
    export TARGET_BUILD_VARIANT=$variant
Jeff Hamilton's avatar
Jeff Hamilton committed
610
    export TARGET_BUILD_DENSITY=$density
Joe Onorato's avatar
Joe Onorato committed
611 612 613 614 615 616 617
    export TARGET_BUILD_TYPE=release
    export TARGET_BUILD_APPS=$apps

    set_stuff_for_environment
    printconfig
}

618 619
function gettop
{
620
    local TOPFILE=build/core/envsetup.mk
621
    if [ -n "$TOP" -a -f "$TOP/$TOPFILE" ] ; then
622 623
        # The following circumlocution ensures we remove symlinks from TOP.
        (cd $TOP; PWD= /bin/pwd)
624 625
    else
        if [ -f $TOPFILE ] ; then
626 627 628 629
            # The following circumlocution (repeated below as well) ensures
            # that we record the true directory name and not one that is
            # faked up with symlink names.
            PWD= /bin/pwd
630
        else
631
            local HERE=$PWD
632 633
            T=
            while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
634
                \cd ..
synergy's avatar
synergy committed
635
                T=`PWD= /bin/pwd -P`
636
            done
637
            \cd $HERE
638 639 640 641 642 643 644
            if [ -f "$T/$TOPFILE" ]; then
                echo $T
            fi
        fi
    fi
}

645 646 647 648 649 650 651
# Return driver for "make", if any (eg. static analyzer)
function getdriver()
{
    local T="$1"
    test "$WITH_STATIC_ANALYZER" = "0" && unset WITH_STATIC_ANALYZER
    if [ -n "$WITH_STATIC_ANALYZER" ]; then
        echo "\
652 653
$T/prebuilts/misc/linux-x86/analyzer/tools/scan-build/scan-build \
--use-analyzer $T/prebuilts/misc/linux-x86/analyzer/bin/analyzer \
654 655 656 657 658
--status-bugs \
--top=$T"
    fi
}

659 660
function m()
{
661 662
    local T=$(gettop)
    local DRV=$(getdriver $T)
663
    if [ "$T" ]; then
664
        $DRV make -C $T -f build/core/main.mk $@
665 666 667 668 669 670 671 672
    else
        echo "Couldn't locate the top of the tree.  Try setting TOP."
    fi
}

function findmakefile()
{
    TOPFILE=build/core/envsetup.mk
673
    local HERE=$PWD
674 675
    T=
    while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
676
        T=`PWD= /bin/pwd`
677 678
        if [ -f "$T/Android.mk" ]; then
            echo $T/Android.mk
679
            \cd $HERE
680 681
            return
        fi
682
        \cd ..
683
    done
684
    \cd $HERE
685 686 687 688
}

function mm()
{
689 690
    local T=$(gettop)
    local DRV=$(getdriver $T)
691 692 693
    # If we're sitting in the root of the build tree, just do a
    # normal make.
    if [ -f build/core/envsetup.mk -a -f Makefile ]; then
694
        $DRV make $@
695 696
    else
        # Find the closest Android.mk file.
697
        local M=$(findmakefile)
Ying Wang's avatar
Ying Wang committed
698 699 700
        local MODULES=
        local GET_INSTALL_PATH=
        local ARGS=
701 702
        # Remove the path to top as the makefilepath needs to be relative
        local M=`echo $M|sed 's:'$T'/::'`
703 704 705 706 707
        if [ ! "$T" ]; then
            echo "Couldn't locate the top of the tree.  Try setting TOP."
        elif [ ! "$M" ]; then
            echo "Couldn't locate a makefile from the current directory."
        else
Ying Wang's avatar
Ying Wang committed
708 709 710 711 712 713 714 715 716 717 718 719
            for ARG in $@; do
                case $ARG in
                  GET-INSTALL-PATH) GET_INSTALL_PATH=$ARG;;
                esac
            done
            if [ -n "$GET_INSTALL_PATH" ]; then
              MODULES=
              ARGS=GET-INSTALL-PATH
            else
              MODULES=all_modules
              ARGS=$@
            fi
720
            ONE_SHOT_MAKEFILE=$M $DRV make -C $T -f build/core/main.mk $MODULES $ARGS
721 722 723 724 725 726
        fi
    fi
}

function mmm()
{
727 728
    local T=$(gettop)
    local DRV=$(getdriver $T)
729
    if [ "$T" ]; then
730
        local MAKEFILE=
731
        local MODULES=
732 733
        local ARGS=
        local DIR TO_CHOP
Ying Wang's avatar
Ying Wang committed
734
        local GET_INSTALL_PATH=
735 736 737
        local DASH_ARGS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^-.*$/')
        local DIRS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^[^-].*$/')
        for DIR in $DIRS ; do
738 739 740 741 742
            MODULES=`echo $DIR | sed -n -e 's/.*:\(.*$\)/\1/p' | sed 's/,/ /'`
            if [ "$MODULES" = "" ]; then
                MODULES=all_modules
            fi
            DIR=`echo $DIR | sed -e 's/:.*//' -e 's:/$::'`
743
            if [ -f $DIR/Android.mk ]; then
Ying Wang's avatar
Ying Wang committed
744 745 746 747
                local TO_CHOP=`(\cd -P -- $T && pwd -P) | wc -c | tr -d ' '`
                local TO_CHOP=`expr $TO_CHOP + 1`
                local START=`PWD= /bin/pwd`
                local MFILE=`echo $START | cut -c${TO_CHOP}-`
748 749 750 751 752 753 754
                if [ "$MFILE" = "" ] ; then
                    MFILE=$DIR/Android.mk
                else
                    MFILE=$MFILE/$DIR/Android.mk
                fi
                MAKEFILE="$MAKEFILE $MFILE"
            else
Ying Wang's avatar
Ying Wang committed
755 756 757 758 759
                case $DIR in
                  showcommands | snod | dist | incrementaljavac) ARGS="$ARGS $DIR";;
                  GET-INSTALL-PATH) GET_INSTALL_PATH=$DIR;;
                  *) echo "No Android.mk in $DIR."; return 1;;
                esac
760 761
            fi
        done
Ying Wang's avatar
Ying Wang committed
762 763 764 765
        if [ -n "$GET_INSTALL_PATH" ]; then
          ARGS=$GET_INSTALL_PATH
          MODULES=
        fi
766
        ONE_SHOT_MAKEFILE="$MAKEFILE" $DRV make -C $T -f build/core/main.mk $DASH_ARGS $MODULES $ARGS
767 768 769 770 771
    else
        echo "Couldn't locate the top of the tree.  Try setting TOP."
    fi
}

Ying Wang's avatar
Ying Wang committed
772 773
function mma()
{
774 775
  local T=$(gettop)
  local DRV=$(getdriver $T)
Ying Wang's avatar
Ying Wang committed
776
  if [ -f build/core/envsetup.mk -a -f Makefile ]; then
777
    $DRV make $@
Ying Wang's avatar
Ying Wang committed
778 779 780 781 782
  else
    if [ ! "$T" ]; then
      echo "Couldn't locate the top of the tree.  Try setting TOP."
    fi
    local MY_PWD=`PWD= /bin/pwd|sed 's:'$T'/::'`
783
    $DRV make -C $T -f build/core/main.mk $@ all_modules BUILD_MODULES_IN_PATHS="$MY_PWD"
Ying Wang's avatar
Ying Wang committed
784 785 786 787 788
  fi
}

function mmma()
{
789 790
  local T=$(gettop)
  local DRV=$(getdriver $T)
Ying Wang's avatar
Ying Wang committed
791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816
  if [ "$T" ]; then
    local DASH_ARGS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^-.*$/')
    local DIRS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^[^-].*$/')
    local MY_PWD=`PWD= /bin/pwd`
    if [ "$MY_PWD" = "$T" ]; then
      MY_PWD=
    else
      MY_PWD=`echo $MY_PWD|sed 's:'$T'/::'`
    fi
    local DIR=
    local MODULE_PATHS=
    local ARGS=
    for DIR in $DIRS ; do
      if [ -d $DIR ]; then
        if [ "$MY_PWD" = "" ]; then
          MODULE_PATHS="$MODULE_PATHS $DIR"
        else
          MODULE_PATHS="$MODULE_PATHS $MY_PWD/$DIR"
        fi
      else
        case $DIR in
          showcommands | snod | dist | incrementaljavac) ARGS="$ARGS $DIR";;
          *) echo "Couldn't find directory $DIR"; return 1;;
        esac
      fi
    done
817
    $DRV make -C $T -f build/core/main.mk $DASH_ARGS $ARGS all_modules BUILD_MODULES_IN_PATHS="$MODULE_PATHS"
Ying Wang's avatar
Ying Wang committed
818 819 820 821 822
  else
    echo "Couldn't locate the top of the tree.  Try setting TOP."
  fi
}

823 824 825 826
function croot()
{
    T=$(gettop)
    if [ "$T" ]; then
827
        \cd $(gettop)
828 829 830 831 832
    else
        echo "Couldn't locate the top of the tree.  Try setting TOP."
    fi
}

833 834 835 836 837 838 839 840
function cproj()
{
    TOPFILE=build/core/envsetup.mk
    local HERE=$PWD
    T=
    while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
        T=$PWD
        if [ -f "$T/Android.mk" ]; then
841
            \cd $T
842 843
            return
        fi
844
        \cd ..
845
    done
846
    \cd $HERE
847 848 849
    echo "can't find Android.mk"
}

850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865
# simplified version of ps; output in the form
# <pid> <procname>
function qpid() {
    local prepend=''
    local append=''
    if [ "$1" = "--exact" ]; then
        prepend=' '
        append='$'
        shift
    elif [ "$1" = "--help" -o "$1" = "-h" ]; then
		echo "usage: qpid [[--exact] <process name|pid>"
		return 255
	fi

    local EXE="$1"
    if [ "$EXE" ] ; then
866
		qpid | \grep "$prepend$EXE$append"
867 868 869 870 871 872 873
	else
		adb shell ps \
			| tr -d '\r' \
			| sed -e 1d -e 's/^[^ ]* *\([0-9]*\).* \([^ ]*\)$/\1 \2/'
	fi
}

874 875
function pid()
{
876 877 878 879 880 881 882 883 884 885 886
    local prepend=''
    local append=''
    if [ "$1" = "--exact" ]; then
        prepend=' '
        append='$'
        shift
    fi
    local EXE="$1"
    if [ "$EXE" ] ; then
        local PID=`adb shell ps \
            | tr -d '\r' \
887
            | \grep "$prepend$EXE$append" \
888 889 890 891 892 893
            | sed -e 's/^[^ ]* *\([0-9]*\).*$/\1/'`
        echo "$PID"
    else
        echo "usage: pid [--exact] <process name>"
		return 255
    fi
894 895
}

896
# coredump_setup - enable core dumps globally for any process
897 898
#                  that has the core-file-size limit set correctly
#
899
# NOTE: You must call also coredump_enable for a specific process
900 901 902
#       if its core-file-size limit is not set already.
# NOTE: Core dumps are written to ramdisk; they will not survive a reboot!

903
function coredump_setup()
904 905 906 907 908 909 910 911 912 913
{
	echo "Getting root...";
	adb root;
	adb wait-for-device;

	echo "Remounting root parition read-write...";
	adb shell mount -w -o remount -t rootfs rootfs;
	sleep 1;
	adb wait-for-device;
	adb shell mkdir -p /cores;
Nick Kralevich's avatar
Nick Kralevich committed
914
	adb shell mount -t tmpfs tmpfs /cores;
915 916 917 918 919 920 921 922 923 924 925
	adb shell chmod 0777 /cores;

	echo "Granting SELinux permission to dump in /cores...";
	adb shell restorecon -R /cores;

	echo "Set core pattern.";
	adb shell 'echo /cores/core.%p > /proc/sys/kernel/core_pattern';

	echo "Done."
}

926
# coredump_enable - enable core dumps for the specified process
927 928
# $1 = PID of process (e.g., $(pid mediaserver))
#
929
# NOTE: coredump_setup must have been called as well for a core
930 931
#       dump to actually be generated.

932
function coredump_enable()
933 934 935 936 937 938 939 940 941 942 943 944 945
{
	local PID=$1;
	if [ -z "$PID" ]; then
		printf "Expecting a PID!\n";
		return;
	fi;
	echo "Setting core limit for $PID to infinite...";
	adb shell prlimit $PID 4 -1 -1
}

# core - send SIGV and pull the core for process
# $1 = PID of process (e.g., $(pid mediaserver))
#
946
# NOTE: coredump_setup must be called once per boot for core dumps to be
947 948 949 950 951 952 953 954 955 956 957 958 959 960 961
#       enabled globally.

function core()
{
	local PID=$1;

	if [ -z "$PID" ]; then
		printf "Expecting a PID!\n";
		return;
	fi;

	local CORENAME=core.$PID;
	local COREPATH=/cores/$CORENAME;
	local SIG=SEGV;

962
	coredump_enable $1;
963 964 965 966 967 968 969 970 971 972 973 974

	local done=0;
	while [ $(adb shell "[ -d /proc/$PID ] && echo -n yes") ]; do
		printf "\tSending SIG%s to %d...\n" $SIG $PID;
		adb shell kill -$SIG $PID;
		sleep 1;
	done;

	adb shell "while [ ! -f $COREPATH ] ; do echo waiting for $COREPATH to be generated; sleep 1; done"
	echo "Done: core is under $COREPATH on device.";
}

975 976 977 978
# systemstack - dump the current stack trace of all threads in the system process
# to the usual ANR traces file
function systemstack()
{
979 980 981 982 983 984 985 986
    stacks system_server
}

function stacks()
{
    if [[ $1 =~ ^[0-9]+$ ]] ; then
        local PID="$1"
    elif [ "$1" ] ; then
987 988 989 990 991 992 993 994
        local PIDLIST="$(pid $1)"
        if [[ $PIDLIST =~ ^[0-9]+$ ]] ; then
            local PID="$PIDLIST"
        elif [ "$PIDLIST" ] ; then
            echo "more than one process: $1"
        else
            echo "no such process: $1"
        fi
995 996 997 998 999
    else
        echo "usage: stacks [pid|process name]"
    fi

    if [ "$PID" ] ; then
1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023
        # Determine whether the process is native
        if adb shell ls -l /proc/$PID/exe | grep -q /system/bin/app_process ; then
            # Dump stacks of Dalvik process
            local TRACES=/data/anr/traces.txt
            local ORIG=/data/anr/traces.orig
            local TMP=/data/anr/traces.tmp

            # Keep original traces to avoid clobbering
            adb shell mv $TRACES $ORIG

            # Make sure we have a usable file
            adb shell touch $TRACES
            adb shell chmod 666 $TRACES

            # Dump stacks and wait for dump to finish
            adb shell kill -3 $PID
            adb shell notify $TRACES >/dev/null

            # Restore original stacks, and show current output
            adb shell mv $TRACES $TMP
            adb shell mv $ORIG $TRACES
            adb shell cat $TMP
        else
            # Dump stacks of native process
1024 1025
            local USE64BIT="$(is64bit $PID)"
            adb shell debuggerd$USE64BIT -b $PID
1026
        fi
1027
    fi
1028 1029
}

John Michelau's avatar
John Michelau committed
1030 1031
function gdbwrapper()
{
1032 1033 1034 1035 1036
    local GDB_CMD="$1"
    shift 1
    $GDB_CMD -x "$@"
}

1037 1038 1039 1040 1041
function get_symbols_directory()
{
    echo $(get_abs_build_var TARGET_OUT_UNSTRIPPED)
}

1042 1043
# Read the ELF header from /proc/$PID/exe to determine if the process is
# 64-bit.
1044 1045 1046 1047
function is64bit()
{
    local PID="$1"
    if [ "$PID" ] ; then
1048
        if [[ "$(adb shell cat /proc/$PID/exe | xxd -l 1 -s 4 -ps)" -eq "02" ]] ; then
1049 1050 1051 1052 1053 1054 1055
            echo "64"
        else
            echo ""
        fi
    else
        echo ""
    fi
John Michelau's avatar
John Michelau committed
1056 1057
}

Dmitriy Ivanov's avatar
Dmitriy Ivanov committed
1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198
function adb_get_product_device() {
  echo `adb shell getprop ro.product.device | sed s/.$//`
}

# returns 0 when process is not traced
function adb_get_traced_by() {
  echo `adb shell cat /proc/$1/status | grep -e "^TracerPid:" | sed "s/^TracerPid:\t//" | sed s/.$//`
}

function gdbclient() {
  # TODO:
  # 1. Check for ANDROID_SERIAL/multiple devices
  local PROCESS_NAME="n/a"
  local PID=$1
  local PORT=5039
  if [ -z "$PID" ]; then
    echo "Usage: gdbclient <pid|processname> [port number]"
    return -1
  fi
  local DEVICE=$(adb_get_product_device)

  if [ -z "$DEVICE" ]; then
    echo "Error: Unable to get device name. Please check if device is connected and ANDROID_SERIAL is set."
    return -2
  fi

  if [ -n "$2" ]; then
    PORT=$2
  fi

  local ROOT=$(gettop)
  if [ -z "$ROOT" ]; then
    # This is for the situation with downloaded symbols (from the build server)
    # we check if they are available.
    ROOT=`realpath .`
  fi

  local OUT_ROOT="$ROOT/out/target/product/$DEVICE"
  local SYMBOLS_DIR="$OUT_ROOT/symbols"

  if [ ! -d $SYMBOLS_DIR ]; then
    echo "Error: couldn't find symbols: $SYMBOLS_DIR does not exist or is not a directory."
    return -3
  fi

  # let's figure out which executable we are about to debug

  # check if user specified a name -> resolve to pid
  if [[ ! "$PID" =~ ^[0-9]+$ ]] ; then
    PROCESS_NAME=$PID
    PID=$(pid --exact $PROCESS_NAME)
    if [ -z "$PID" ]; then
      echo "Error: couldn't resolve pid by process name: $PROCESS_NAME"
      return -4
    fi
  fi

  local EXE=`adb shell readlink /proc/$PID/exe | sed s/.$//`
  # TODO: print error in case there is no such pid
  local LOCAL_EXE_PATH=$SYMBOLS_DIR$EXE

  if [ ! -f $LOCAL_EXE_PATH ]; then
    echo "Error: unable to find symbols for executable $EXE: file $LOCAL_EXE_PATH does not exist"
    return -5
  fi

  local USE64BIT=""

  if [[ "$(file $LOCAL_EXE_PATH)" =~ 64-bit ]]; then
    USE64BIT="64"
  fi

  local GDB=
  local GDB64=
  local CPU_ABI=`adb shell getprop ro.product.cpu.abilist | sed s/.$//`
  # TODO: we assume these are available via $PATH
  if [[ $CPU_ABI =~ (^|,)arm64 ]]; then
    GDB=arm-linux-androideabi-gdb
    GDB64=aarch64-linux-android-gdb
  elif [[ $CPU_ABI =~ (^|,)arm ]]; then
    GDB=arm-linux-androideabi-gdb
  elif [[ $CPU_ABI =~ (^|,)x86_64 ]]; then
    GDB=x86_64-linux-androideabi-gdb
  elif [[ $CPU_ABI =~ (^|,)x86 ]]; then
    GDB=x86_64-linux-androideabi-gdb
  elif [[ $CPU_ABI =~ (^|,)mips64 ]]; then
    GDB=mipsel-linux-android-gdb
    GDB64=mips64el-linux-android-gdb
  elif [[ $CPU_ABI =~ (^|,)mips ]]; then
    GDB=mipsel-linux-android-gdb
  else
    echo "Error: unrecognized cpu.abilist: $CPU_ABI"
    return -6
  fi

  # TODO: check if tracing process is gdbserver and not some random strace...
  if [ $(adb_get_traced_by $PID) -eq 0 ]; then
    # start gdbserver
    echo "Starting gdbserver..."
    # TODO: check if adb is already listening $PORT
    # to avoid unnecessary calls
    echo ". adb forward for port=$PORT..."
    adb forward tcp:$PORT tcp:$PORT
    echo ". starting gdbserver to attach to pid=$PID..."
    adb shell gdbserver$USE64BIT :$PORT --attach $PID &
    echo ". give it couple of seconds to start..."
    sleep 2
    echo ". done"
  else
    echo "It looks like gdbserver is already attached to $PID (process is traced), trying to connect to it using local port=$PORT"
  fi

  local OUT_SO_SYMBOLS=$SYMBOLS_DIR/system/lib$USE64BIT
  local OUT_VENDOR_SO_SYMBOLS=$SYMBOLS_DIR/vendor/lib$USE64BIT
  local ART_CMD=""

  echo >|"$OUT_ROOT/gdbclient.cmds" "set solib-absolute-prefix $SYMBOLS_DIR"
  echo >>"$OUT_ROOT/gdbclient.cmds" "set solib-search-path $OUT_SO_SYMBOLS:$OUT_SO_SYMBOLS/hw:$OUT_SO_SYMBOLS/ssl/engines:$OUT_SO_SYMBOLS/drm:$OUT_SO_SYMBOLS/egl:$OUT_SO_SYMBOLS/soundfx:$OUT_VENDOR_SO_SYMBOLS:$OUT_VENDOR_SO_SYMBOLS/hw:$OUT_VENDOR_SO_SYMBOLS/egl"
  local DALVIK_GDB_SCRIPT=$ROOT/development/scripts/gdb/dalvik.gdb
  if [ -f $DALVIK_GDB_SCRIPT ]; then
    echo >>"$OUT_ROOT/gdbclient.cmds" "source $DALVIK_GDB_SCRIPT"
    ART_CMD="art-on"
  else
    echo "Warning: couldn't find $DALVIK_GDB_SCRIPT - ART debugging options will not be available"
  fi
  echo >>"$OUT_ROOT/gdbclient.cmds" "target remote :$PORT"
  if [[ $EXE =~ (^|/)(app_process|dalvikvm)(|32|64)$ ]]; then
    echo >> "$OUT_ROOT/gdbclient.cmds" $ART_CMD
  fi

  echo >>"$OUT_ROOT/gdbclient.cmds" ""

  local WHICH_GDB=$GDB

  if [ -n "$USE64BIT" -a -n "$GDB64" ]; then
    WHICH_GDB=$GDB64
  fi

  gdbwrapper $WHICH_GDB "$OUT_ROOT/gdbclient.cmds" "$LOCAL_EXE_PATH"
}

1199 1200 1201
# gdbclient now determines whether the user wants to debug a 32-bit or 64-bit
# executable, set up the approriate gdbserver, then invokes the proper host
# gdb.
Dmitriy Ivanov's avatar
Dmitriy Ivanov committed
1202
function gdbclient_old()
1203
{
1204 1205 1206
   local OUT_ROOT=$(get_abs_build_var PRODUCT_OUT)
   local OUT_SYMBOLS=$(get_abs_build_var TARGET_OUT_UNSTRIPPED)
   local OUT_SO_SYMBOLS=$(get_abs_build_var TARGET_OUT_SHARED_LIBRARIES_UNSTRIPPED)
1207
   local OUT_VENDOR_SO_SYMBOLS=$(get_abs_build_var TARGET_OUT_VENDOR_SHARED_LIBRARIES_UNSTRIPPED)
1208
   local OUT_EXE_SYMBOLS=$(get_symbols_directory)
1209
   local PREBUILTS=$(get_abs_build_var ANDROID_PREBUILTS)
Nick Kralevich's avatar
Nick Kralevich committed
1210 1211 1212 1213
   local ARCH=$(get_build_var TARGET_ARCH)
   local GDB
   case "$ARCH" in
       arm) GDB=arm-linux-androideabi-gdb;;
1214
       arm64) GDB=arm-linux-androideabi-gdb; GDB64=aarch64-linux-android-gdb;;
1215
       mips|mips64) GDB=mips64el-linux-android-gdb;;
Serban Constantinescu's avatar
Serban Constantinescu committed
1216 1217
       x86) GDB=x86_64-linux-android-gdb;;
       x86_64) GDB=x86_64-linux-android-gdb;;
Nick Kralevich's avatar
Nick Kralevich committed
1218 1219 1220
       *) echo "Unknown arch $ARCH"; return 1;;
   esac

1221 1222 1223 1224
   if [ "$OUT_ROOT" -a "$PREBUILTS" ]; then
       local EXE="$1"
       if [ "$EXE" ] ; then
           EXE=$1
Brigid Smith's avatar
Brigid Smith committed
1225 1226 1227
           if [[ $EXE =~ ^[^/].* ]] ; then
               EXE="system/bin/"$EXE
           fi
1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238
       else
           EXE="app_process"
       fi

       local PORT="$2"
       if [ "$PORT" ] ; then
           PORT=$2
       else
           PORT=":5039"
       fi

Chris Craik's avatar
Chris Craik committed
1239 1240 1241
       local PID="$3"
       if [ "$PID" ] ; then
           if [[ ! "$PID" =~ ^[0-9]+$ ]] ; then
1242
               PID=`pid $3`
Chris Craik's avatar
Chris Craik committed
1243 1244 1245
               if [[ ! "$PID" =~ ^[0-9]+$ ]] ; then
                   # that likely didn't work because of returning multiple processes
                   # try again, filtering by root processes (don't contain colon)
1246
                   PID=`adb shell ps | \grep $3 | \grep -v ":" | awk '{print $2}'`
Chris Craik's avatar
Chris Craik committed
1247 1248 1249 1250 1251 1252 1253 1254 1255 1256
                   if [[ ! "$PID" =~ ^[0-9]+$ ]]
                   then
                       echo "Couldn't resolve '$3' to single PID"
                       return 1
                   else
                       echo ""
                       echo "WARNING: multiple processes matching '$3' observed, using root process"
                       echo ""
                   fi
               fi
1257
           fi
1258
           adb forward "tcp$PORT" "tcp$PORT"
1259 1260
           local USE64BIT="$(is64bit $PID)"
           adb shell gdbserver$USE64BIT $PORT --attach $PID &
1261 1262 1263 1264 1265 1266
           sleep 2
       else
               echo ""
               echo "If you haven't done so already, do this first on the device:"
               echo "    gdbserver $PORT /system/bin/$EXE"
                   echo " or"
Chris Craik's avatar
Chris Craik committed
1267
               echo "    gdbserver $PORT --attach <PID>"
1268 1269 1270
               echo ""
       fi

1271
       OUT_SO_SYMBOLS=$OUT_SO_SYMBOLS$USE64BIT
Colin Cross's avatar
Colin Cross committed
1272
       OUT_VENDOR_SO_SYMBOLS=$OUT_VENDOR_SO_SYMBOLS$USE64BIT
1273

1274
       echo >|"$OUT_ROOT/gdbclient.cmds" "set solib-absolute-prefix $OUT_SYMBOLS"
1275
       echo >>"$OUT_ROOT/gdbclient.cmds" "set solib-search-path $OUT_SO_SYMBOLS:$OUT_SO_SYMBOLS/hw:$OUT_SO_SYMBOLS/ssl/engines:$OUT_SO_SYMBOLS/drm:$OUT_SO_SYMBOLS/egl:$OUT_SO_SYMBOLS/soundfx:$OUT_VENDOR_SO_SYMBOLS:$OUT_VENDOR_SO_SYMBOLS/hw:$OUT_VENDOR_SO_SYMBOLS/egl"
1276
       echo >>"$OUT_ROOT/gdbclient.cmds" "source $ANDROID_BUILD_TOP/development/scripts/gdb/dalvik.gdb"
1277
       echo >>"$OUT_ROOT/gdbclient.cmds" "target remote $PORT"
1278 1279 1280 1281
       # Enable special debugging for ART processes.
       if [[ $EXE =~ (^|/)(app_process|dalvikvm)(|32|64)$ ]]; then
          echo >> "$OUT_ROOT/gdbclient.cmds" "art-on"
       fi
1282 1283
       echo >>"$OUT_ROOT/gdbclient.cmds" ""

1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294
       local WHICH_GDB=
       # 64-bit exe found
       if [ "$USE64BIT" != "" ] ; then
           WHICH_GDB=$ANDROID_TOOLCHAIN/$GDB64
       # 32-bit exe / 32-bit platform
       elif [ "$(get_build_var TARGET_2ND_ARCH)" = "" ]; then
           WHICH_GDB=$ANDROID_TOOLCHAIN/$GDB
       # 32-bit exe / 64-bit platform
       else
           WHICH_GDB=$ANDROID_TOOLCHAIN_2ND_ARCH/$GDB
       fi
1295

1296
       gdbwrapper $WHICH_GDB "$OUT_ROOT/gdbclient.cmds" "$OUT_EXE_SYMBOLS/$EXE"
1297 1298 1299 1300 1301 1302 1303 1304 1305 1306
  else
       echo "Unable to determine build system output dir."
   fi

}

case `uname -s` in
    Darwin)
        function sgrep()
        {
1307
            find -E . -name .repo -prune -o -name .git -prune -o  -type f -iregex '.*\.(c|h|cc|cpp|S|java|xml|sh|mk|aidl)' -print0 | xargs -0 grep --color -n "$@"
1308 1309 1310 1311 1312 1313
        }

        ;;
    *)
        function sgrep()
        {
1314
            find . -name .repo -prune -o -name .git -prune -o  -type f -iregex '.*\.\(c\|h\|cc\|cpp\|S\|java\|xml\|sh\|mk\|aidl\)' -print0 | xargs -0 grep --color -n "$@"
1315 1316 1317 1318
        }
        ;;
esac

1319 1320 1321 1322 1323
function gettargetarch
{
    get_build_var TARGET_ARCH
}

Jon Boekenoogen's avatar
ggrep  
Jon Boekenoogen committed
1324 1325 1326 1327 1328
function ggrep()
{
    find . -name .repo -prune -o -name .git -prune -o -name out -prune -o -type f -name "*\.gradle" -print0 | xargs -0 grep --color -n "$@"
}

1329 1330
function jgrep()
{
1331
    find . -name .repo -prune -o -name .git -prune -o -name out -prune -o -type f -name "*\.java" -print0 | xargs -0 grep --color -n "$@"
1332 1333 1334 1335
}

function cgrep()
{
1336
    find . -name .repo -prune -o -name .git -prune -o -name out -prune -o -type f \( -name '*.c' -o -name '*.cc' -o -name '*.cpp' -o -name '*.h' \) -print0 | xargs -0 grep --color -n "$@"
1337 1338 1339 1340
}

function resgrep()
{
1341
    for dir in `find . -name .repo -prune -o -name .git -prune -o -name out -prune -o -name res -type d`; do find $dir -type f -name '*\.xml' -print0 | xargs -0 grep --color -n "$@"; done;
1342 1343
}

1344 1345 1346 1347 1348
function mangrep()
{
    find . -name .repo -prune -o -name .git -prune -o -path ./out -prune -o -type f -name 'AndroidManifest.xml' -print0 | xargs -0 grep --color -n "$@"
}

1349 1350 1351 1352 1353
function sepgrep()
{
    find . -name .repo -prune -o -name .git -prune -o -path ./out -prune -o -name sepolicy -type d -print0 | xargs -0 grep --color -n -r --exclude-dir=\.git "$@"
}

1354 1355 1356 1357
case `uname -s` in
    Darwin)
        function mgrep()
        {
1358
            find -E . -name .repo -prune -o -name .git -prune -o -path ./out -prune -o -type f -iregex '.*/(Makefile|Makefile\..*|.*\.make|.*\.mak|.*\.mk)' -print0 | xargs -0 grep --color -n "$@"
1359 1360 1361 1362
        }

        function treegrep()
        {
1363
            find -E . -name .repo -prune -o -name .git -prune -o -type f -iregex '.*\.(c|h|cpp|S|java|xml)' -print0 | xargs -0 grep --color -n -i "$@"
1364 1365 1366 1367 1368 1369
        }

        ;;
    *)
        function mgrep()
        {
1370
            find . -name .repo -prune -o -name .git -prune -o -path ./out -prune -o -regextype posix-egrep -iregex '(.*\/Makefile|.*\/Makefile\..*|.*\.make|.*\.mak|.*\.mk)' -type f -print0 | xargs -0 grep --color -n "$@"
1371 1372 1373 1374
        }

        function treegrep()
        {
1375
            find . -name .repo -prune -o -name .git -prune -o -regextype posix-egrep -iregex '.*\.(c|h|cpp|S|java|xml)' -type f -print0 | xargs -0 grep --color -n -i "$@"
1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392
        }

        ;;
esac

function getprebuilt
{
    get_abs_build_var ANDROID_PREBUILTS
}

function tracedmdump()
{
    T=$(gettop)
    if [ ! "$T" ]; then
        echo "Couldn't locate the top of the tree.  Try setting TOP."
        return
    fi
1393
    local prebuiltdir=$(getprebuilt)
1394 1395
    local arch=$(gettargetarch)
    local KERNEL=$T/prebuilts/qemu-kernel/$arch/vmlinux-qemu
1396

1397
    local TRACE=$1
1398 1399 1400 1401 1402
    if [ ! "$TRACE" ] ; then
        echo "usage:  tracedmdump  tracename"
        return
    fi

1403 1404 1405 1406 1407
    if [ ! -r "$KERNEL" ] ; then
        echo "Error: cannot find kernel: '$KERNEL'"
        return
    fi

1408
    local BASETRACE=$(basename $TRACE)
1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 1430 1431 1432
    if [ "$BASETRACE" = "$TRACE" ] ; then
        TRACE=$ANDROID_PRODUCT_OUT/traces/$TRACE
    fi

    echo "post-processing traces..."
    rm -f $TRACE/qtrace.dexlist
    post_trace $TRACE
    if [ $? -ne 0 ]; then
        echo "***"
        echo "*** Error: malformed trace.  Did you remember to exit the emulator?"
        echo "***"
        return
    fi
    echo "generating dexlist output..."
    /bin/ls $ANDROID_PRODUCT_OUT/system/framework/*.jar $ANDROID_PRODUCT_OUT/system/app/*.apk $ANDROID_PRODUCT_OUT/data/app/*.apk 2>/dev/null | xargs dexlist > $TRACE/qtrace.dexlist
    echo "generating dmtrace data..."
    q2dm -r $ANDROID_PRODUCT_OUT/symbols $TRACE $KERNEL $TRACE/dmtrace || return
    echo "generating html file..."
    dmtracedump -h $TRACE/dmtrace >| $TRACE/dmtrace.html || return
    echo "done, see $TRACE/dmtrace.html for details"
    echo "or run:"
    echo "    traceview $TRACE/dmtrace"
}

1433 1434
# communicate with a running device or emulator, set up necessary state,
# and run the hat command.
1435 1436
function runhat()
{
1437 1438
    # process standard adb options
    local adbTarget=""
1439
    if [ "$1" = "-d" -o "$1" = "-e" ]; then
1440 1441
        adbTarget=$1
        shift 1
1442
    elif [ "$1" = "-s" ]; then
1443 1444 1445 1446
        adbTarget="$1 $2"
        shift 2
    fi
    local adbOptions=${adbTarget}
1447
    #echo adbOptions = ${adbOptions}
1448 1449 1450

    # runhat options
    local targetPid=$1
1451 1452

    if [ "$targetPid" = "" ]; then
1453
        echo "Usage: runhat [ -d | -e | -s serial ] target-pid"
1454 1455 1456
        return
    fi

1457 1458 1459 1460 1461 1462
    # confirm hat is available
    if [ -z $(which hat) ]; then
        echo "hat is not available in this configuration."
        return
    fi

1463
    # issue "am" command to cause the hprof dump
Nick Kralevich's avatar
Nick Kralevich committed
1464
    local devFile=/data/local/tmp/hprof-$targetPid
1465
    echo "Poking $targetPid and waiting for data..."
1466
    echo "Storing data at $devFile"
1467
    adb ${adbOptions} shell am dumpheap $targetPid $devFile
1468
    echo "Press enter when logcat shows \"hprof: heap dump completed\""
1469 1470 1471
    echo -n "> "
    read

1472
    local localFile=/tmp/$$-hprof
1473

1474 1475
    echo "Retrieving file $devFile..."
    adb ${adbOptions} pull $devFile $localFile
1476

1477
    adb ${adbOptions} shell rm $devFile
1478

1479
    echo "Running hat on $localFile"
1480 1481
    echo "View the output by pointing your browser at http://localhost:7000/"
    echo ""
Dianne Hackborn's avatar
Dianne Hackborn committed
1482
    hat -JXmx512m $localFile
1483 1484 1485 1486
}

function getbugreports()
{
1487
    local reports=(`adb shell ls /sdcard/bugreports | tr -d '\r'`)
1488 1489 1490 1491 1492 1493

    if [ ! "$reports" ]; then
        echo "Could not locate any bugreports."
        return
    fi

1494 1495
    local report
    for report in ${reports[@]}
1496
    do
1497 1498 1499
        echo "/sdcard/bugreports/${report}"
        adb pull /sdcard/bugreports/${report} ${report}
        gunzip ${report}
1500 1501 1502
    done
}

1503 1504 1505 1506 1507 1508 1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524
function getsdcardpath()
{
    adb ${adbOptions} shell echo -n \$\{EXTERNAL_STORAGE\}
}

function getscreenshotpath()
{
    echo "$(getsdcardpath)/Pictures/Screenshots"
}

function getlastscreenshot()
{
    local screenshot_path=$(getscreenshotpath)
    local screenshot=`adb ${adbOptions} ls ${screenshot_path} | grep Screenshot_[0-9-]*.*\.png | sort -rk 3 | cut -d " " -f 4 | head -n 1`
    if [ "$screenshot" = "" ]; then
        echo "No screenshots found."
        return
    fi
    echo "${screenshot}"
    adb ${adbOptions} pull ${screenshot_path}/${screenshot}
}

1525 1526
function startviewserver()
{
1527
    local port=4939
1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543
    if [ $# -gt 0 ]; then
            port=$1
    fi
    adb shell service call window 1 i32 $port
}

function stopviewserver()
{
    adb shell service call window 2
}

function isviewserverstarted()
{
    adb shell service call window 3
}

1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558
function key_home()
{
    adb shell input keyevent 3
}

function key_back()
{
    adb shell input keyevent 4
}

function key_menu()
{
    adb shell input keyevent 82
}

1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570
function smoketest()
{
    if [ ! "$ANDROID_PRODUCT_OUT" ]; then
        echo "Couldn't locate output files.  Try running 'lunch' first." >&2
        return
    fi
    T=$(gettop)
    if [ ! "$T" ]; then
        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
        return
    fi

1571
    (\cd "$T" && mmm tests/SmokeTest) &&
1572 1573 1574 1575 1576 1577 1578
      adb uninstall com.android.smoketest > /dev/null &&
      adb uninstall com.android.smoketest.tests > /dev/null &&
      adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTestApp.apk &&
      adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTest.apk &&
      adb shell am instrument -w com.android.smoketest.tests/android.test.InstrumentationTestRunner
}

1579 1580 1581 1582 1583 1584 1585 1586
# simple shortcut to the runtest command
function runtest()
{
    T=$(gettop)
    if [ ! "$T" ]; then
        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
        return
    fi
1587
    ("$T"/development/testrunner/runtest.py $@)
1588 1589
}

1590 1591 1592 1593 1594
function godir () {
    if [[ -z "$1" ]]; then
        echo "Usage: godir <regex>"
        return
    fi
1595
    T=$(gettop)
1596 1597
    if [[ ! -f $T/filelist ]]; then
        echo -n "Creating index..."
1598
        (\cd $T; find . -wholename ./out -prune -o -wholename ./.repo -prune -o -type f > filelist)
1599 1600 1601 1602
        echo " Done"
        echo ""
    fi
    local lines
1603
    lines=($(\grep "$1" $T/filelist | sed -e 's/\/[^/]*$//' | sort | uniq))
1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615
    if [[ ${#lines[@]} = 0 ]]; then
        echo "Not found"
        return
    fi
    local pathname
    local choice
    if [[ ${#lines[@]} > 1 ]]; then
        while [[ -z "$pathname" ]]; do
            local index=1
            local line
            for line in ${lines[@]}; do
                printf "%6s %s\n" "[$index]" $line
1616
                index=$(($index + 1))
1617 1618 1619 1620 1621 1622 1623 1624 1625
            done
            echo
            echo -n "Select one: "
            unset choice
            read choice
            if [[ $choice -gt ${#lines[@]} || $choice -lt 1 ]]; then
                echo "Invalid choice"
                continue
            fi
1626
            pathname=${lines[$(($choice-1))]}
1627 1628 1629 1630
        done
    else
        pathname=${lines[0]}
    fi
1631
    \cd $T/$pathname
1632 1633
}

1634 1635 1636 1637 1638
# Force JAVA_HOME to point to java 1.7 or java 1.6  if it isn't already set.
#
# Note that the MacOS path for java 1.7 includes a minor revision number (sigh).
# For some reason, installing the JDK doesn't make it show up in the
# JavaVM.framework/Versions/1.7/ folder.
1639
function set_java_home() {
1640
    # Clear the existing JAVA_HOME value if we set it ourselves, so that
Narayan Kamath's avatar
Narayan Kamath committed
1641 1642
    # we can reset it later, depending on the version of java the build
    # system needs.
1643 1644 1645 1646 1647 1648 1649
    #
    # If we don't do this, the JAVA_HOME value set by the first call to
    # build/envsetup.sh will persist forever.
    if [ -n "$ANDROID_SET_JAVA_HOME" ]; then
      export JAVA_HOME=""
    fi

1650
    if [ ! "$JAVA_HOME" ]; then
Narayan Kamath's avatar
Narayan Kamath committed
1651
      if [ -n "$LEGACY_USE_JAVA6" ]; then
1652 1653 1654 1655 1656 1657 1658 1659
        case `uname -s` in
            Darwin)
                export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home
                ;;
            *)
                export JAVA_HOME=/usr/lib/jvm/java-6-sun
                ;;
        esac
1660 1661 1662
      else
        case `uname -s` in
            Darwin)
1663
                export JAVA_HOME=$(/usr/libexec/java_home -v 1.7)
1664 1665 1666 1667 1668 1669 1670 1671 1672 1673
                ;;
            *)
                export JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64
                ;;
        esac
      fi

      # Keep track of the fact that we set JAVA_HOME ourselves, so that
      # we can change it on the next envsetup.sh, if required.
      export ANDROID_SET_JAVA_HOME=true
1674
    fi
1675
}
1676

1677 1678
# Print colored exit condition
function pez {
1679 1680 1681 1682 1683 1684 1685 1686 1687
    "$@"
    local retval=$?
    if [ $retval -ne 0 ]
    then
        echo -e "\e[0;31mFAILURE\e[00m"
    else
        echo -e "\e[0;32mSUCCESS\e[00m"
    fi
    return $retval
1688 1689
}

1690 1691 1692 1693 1694
function get_make_command()
{
  echo command make
}

1695 1696 1697
function make()
{
    local start_time=$(date +"%s")
1698
    $(get_make_command) "$@"
1699 1700 1701 1702 1703 1704 1705 1706
    local ret=$?
    local end_time=$(date +"%s")
    local tdiff=$(($end_time-$start_time))
    local hours=$(($tdiff / 3600 ))
    local mins=$((($tdiff % 3600) / 60))
    local secs=$(($tdiff % 60))
    echo
    if [ $ret -eq 0 ] ; then
1707
        echo -n -e "#### make completed successfully "
1708
    else
1709
        echo -n -e "#### make failed to build some targets "
1710 1711 1712 1713 1714 1715 1716 1717
    fi
    if [ $hours -gt 0 ] ; then
        printf "(%02g:%02g:%02g (hh:mm:ss))" $hours $mins $secs
    elif [ $mins -gt 0 ] ; then
        printf "(%02g:%02g (mm:ss))" $mins $secs
    elif [ $secs -gt 0 ] ; then
        printf "(%s seconds)" $secs
    fi
1718
    echo -e " ####"
1719 1720 1721 1722 1723 1724
    echo
    return $ret
}



1725 1726 1727 1728 1729 1730 1731 1732 1733
if [ "x$SHELL" != "x/bin/bash" ]; then
    case `ps -o command -p $$` in
        *bash*)
            ;;
        *)
            echo "WARNING: Only bash is supported, use of other shell would lead to erroneous results"
            ;;
    esac
fi
1734 1735

# Execute the contents of any vendorsetup.sh files we can find.
1736 1737
for f in `test -d device && find -L device -maxdepth 4 -name 'vendorsetup.sh' 2> /dev/null` \
         `test -d vendor && find -L vendor -maxdepth 4 -name 'vendorsetup.sh' 2> /dev/null`
1738 1739 1740 1741 1742
do
    echo "including $f"
    . $f
done
unset f
Kenny Root's avatar
Kenny Root committed
1743 1744

addcompletions