envsetup.sh revision 513d7a4021bb4380a089908216628553d29e12d6
1function help() {
2cat <<EOF
3Invoke ". build/envsetup.sh" from your shell to add the following functions to your environment:
4- croot:   Changes directory to the top of the tree.
5- m:       Makes from the top of the tree.
6- mm:      Builds all of the modules in the current directory.
7- mmm:     Builds all of the modules in the supplied directories.
8- cgrep:   Greps on all local C/C++ files.
9- jgrep:   Greps on all local Java files.
10- resgrep: Greps on all local res/*.xml files.
11- godir:   Go to the directory containing a file.
12
13Look at the source to view more functions. The complete list is:
14EOF
15    T=$(gettop)
16    local A
17    A=""
18    for i in `cat $T/build/envsetup.sh | sed -n "/^function /s/function \([a-z_]*\).*/\1/p" | sort`; do
19      A="$A $i"
20    done
21    echo $A
22}
23
24# Get the value of a build variable as an absolute path.
25function get_abs_build_var()
26{
27    T=$(gettop)
28    if [ ! "$T" ]; then
29        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
30        return
31    fi
32    (cd $T; CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
33      make --no-print-directory -C "$T" -f build/core/config.mk dumpvar-abs-$1)
34}
35
36# Get the exact value of a build variable.
37function get_build_var()
38{
39    T=$(gettop)
40    if [ ! "$T" ]; then
41        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
42        return
43    fi
44    CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
45      make --no-print-directory -C "$T" -f build/core/config.mk dumpvar-$1
46}
47
48# check to see if the supplied product is one we can build
49function check_product()
50{
51    T=$(gettop)
52    if [ ! "$T" ]; then
53        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
54        return
55    fi
56    CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core \
57        TARGET_PRODUCT=$1 TARGET_BUILD_VARIANT= \
58        TARGET_SIMULATOR= TARGET_BUILD_TYPE= \
59        TARGET_BUILD_APPS= \
60        get_build_var TARGET_DEVICE > /dev/null
61    # hide successful answers, but allow the errors to show
62}
63
64VARIANT_CHOICES=(user userdebug eng)
65
66# check to see if the supplied variant is valid
67function check_variant()
68{
69    for v in ${VARIANT_CHOICES[@]}
70    do
71        if [ "$v" = "$1" ]
72        then
73            return 0
74        fi
75    done
76    return 1
77}
78
79function setpaths()
80{
81    T=$(gettop)
82    if [ ! "$T" ]; then
83        echo "Couldn't locate the top of the tree.  Try setting TOP."
84        return
85    fi
86
87    ##################################################################
88    #                                                                #
89    #              Read me before you modify this code               #
90    #                                                                #
91    #   This function sets ANDROID_BUILD_PATHS to what it is adding  #
92    #   to PATH, and the next time it is run, it removes that from   #
93    #   PATH.  This is required so lunch can be run more than once   #
94    #   and still have working paths.                                #
95    #                                                                #
96    ##################################################################
97
98    # out with the old
99    if [ -n $ANDROID_BUILD_PATHS ] ; then
100        export PATH=${PATH/$ANDROID_BUILD_PATHS/}
101    fi
102    if [ -n $ANDROID_PRE_BUILD_PATHS ] ; then
103        export PATH=${PATH/$ANDROID_PRE_BUILD_PATHS/}
104    fi
105
106    # and in with the new
107    CODE_REVIEWS=
108    prebuiltdir=$(getprebuilt)
109    export ANDROID_EABI_TOOLCHAIN=$prebuiltdir/toolchain/arm-linux-androideabi-4.4.x/bin
110    export ARM_EABI_TOOLCHAIN=$prebuiltdir/toolchain/arm-eabi-4.4.3/bin
111    export ANDROID_TOOLCHAIN=$ANDROID_EABI_TOOLCHAIN
112    export ANDROID_QTOOLS=$T/development/emulator/qtools
113    export ANDROID_BUILD_PATHS=:$(get_build_var ANDROID_BUILD_PATHS):$ANDROID_QTOOLS:$ANDROID_TOOLCHAIN:$ARM_EABI_TOOLCHAIN$CODE_REVIEWS
114    export PATH=$PATH$ANDROID_BUILD_PATHS
115
116    unset ANDROID_JAVA_TOOLCHAIN
117    if [ -n "$JAVA_HOME" ]; then
118        export ANDROID_JAVA_TOOLCHAIN=$JAVA_HOME/bin
119    fi
120    export ANDROID_PRE_BUILD_PATHS=$ANDROID_JAVA_TOOLCHAIN
121    if [ -n "$ANDROID_PRE_BUILD_PATHS" ]; then
122        export PATH=$ANDROID_PRE_BUILD_PATHS:$PATH
123    fi
124
125    unset ANDROID_PRODUCT_OUT
126    export ANDROID_PRODUCT_OUT=$(get_abs_build_var PRODUCT_OUT)
127    export OUT=$ANDROID_PRODUCT_OUT
128
129    # needed for building linux on MacOS
130    # TODO: fix the path
131    #export HOST_EXTRACFLAGS="-I "$T/system/kernel_headers/host_include
132
133    # needed for OProfile to post-process collected samples
134    export OPROFILE_EVENTS_DIR=$prebuiltdir/oprofile
135}
136
137function printconfig()
138{
139    T=$(gettop)
140    if [ ! "$T" ]; then
141        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
142        return
143    fi
144    get_build_var report_config
145}
146
147function set_stuff_for_environment()
148{
149    settitle
150    set_java_home
151    setpaths
152    set_sequence_number
153
154    # Don't try to do preoptimization until it works better on OSX.
155    export DISABLE_DEXPREOPT=true
156
157    export ANDROID_BUILD_TOP=$(gettop)
158}
159
160function set_sequence_number()
161{
162    export BUILD_ENV_SEQUENCE_NUMBER=10
163}
164
165function settitle()
166{
167    if [ "$STAY_OFF_MY_LAWN" = "" ]; then
168        local product=$TARGET_PRODUCT
169        local variant=$TARGET_BUILD_VARIANT
170        local apps=$TARGET_BUILD_APPS
171        if [ -z "$apps" ]; then
172            export PROMPT_COMMAND="echo -ne \"\033]0;[${product}-${variant}] ${USER}@${HOSTNAME}: ${PWD}\007\""
173        else
174            export PROMPT_COMMAND="echo -ne \"\033]0;[$apps $variant] ${USER}@${HOSTNAME}: ${PWD}\007\""
175        fi
176    fi
177}
178
179case `uname -s` in
180    Linux)
181        function choosesim()
182        {
183            echo "Build for the simulator or the device?"
184            echo "     1. Device"
185            echo "     2. Simulator"
186            echo
187
188            export TARGET_SIMULATOR=
189            local ANSWER
190            while [ -z $TARGET_SIMULATOR ]
191            do
192                echo -n "Which would you like? [1] "
193                if [ -z "$1" ] ; then
194                    read ANSWER
195                else
196                    echo $1
197                    ANSWER=$1
198                fi
199                case $ANSWER in
200                "")
201                    export TARGET_SIMULATOR=false
202                    ;;
203                1)
204                    export TARGET_SIMULATOR=false
205                    ;;
206                Device)
207                    export TARGET_SIMULATOR=false
208                    ;;
209                2)
210                    export TARGET_SIMULATOR=true
211                    ;;
212                Simulator)
213                    export TARGET_SIMULATOR=true
214                    ;;
215                *)
216                    echo
217                    echo "I didn't understand your response.  Please try again."
218                    echo
219                    ;;
220                esac
221                if [ -n "$1" ] ; then
222                    break
223                fi
224            done
225
226            set_stuff_for_environment
227        }
228        ;;
229    *)
230        function choosesim()
231        {
232            echo "Only device builds are supported for" `uname -s`
233            echo "     Forcing TARGET_SIMULATOR=false"
234            echo
235            if [ -z "$1" ]
236            then
237                echo -n "Press enter: "
238                read
239            fi
240
241            export TARGET_SIMULATOR=false
242            set_stuff_for_environment
243        }
244        ;;
245esac
246
247function choosetype()
248{
249    echo "Build type choices are:"
250    echo "     1. release"
251    echo "     2. debug"
252    echo
253
254    local DEFAULT_NUM DEFAULT_VALUE
255    if [ $TARGET_SIMULATOR = "false" ] ; then
256        DEFAULT_NUM=1
257        DEFAULT_VALUE=release
258    else
259        DEFAULT_NUM=2
260        DEFAULT_VALUE=debug
261    fi
262
263    export TARGET_BUILD_TYPE=
264    local ANSWER
265    while [ -z $TARGET_BUILD_TYPE ]
266    do
267        echo -n "Which would you like? ["$DEFAULT_NUM"] "
268        if [ -z "$1" ] ; then
269            read ANSWER
270        else
271            echo $1
272            ANSWER=$1
273        fi
274        case $ANSWER in
275        "")
276            export TARGET_BUILD_TYPE=$DEFAULT_VALUE
277            ;;
278        1)
279            export TARGET_BUILD_TYPE=release
280            ;;
281        release)
282            export TARGET_BUILD_TYPE=release
283            ;;
284        2)
285            export TARGET_BUILD_TYPE=debug
286            ;;
287        debug)
288            export TARGET_BUILD_TYPE=debug
289            ;;
290        *)
291            echo
292            echo "I didn't understand your response.  Please try again."
293            echo
294            ;;
295        esac
296        if [ -n "$1" ] ; then
297            break
298        fi
299    done
300
301    set_stuff_for_environment
302}
303
304#
305# This function isn't really right:  It chooses a TARGET_PRODUCT
306# based on the list of boards.  Usually, that gets you something
307# that kinda works with a generic product, but really, you should
308# pick a product by name.
309#
310function chooseproduct()
311{
312    if [ "x$TARGET_PRODUCT" != x ] ; then
313        default_value=$TARGET_PRODUCT
314    else
315        if [ "$TARGET_SIMULATOR" = true ] ; then
316            default_value=sim
317        else
318            default_value=generic
319        fi
320    fi
321
322    export TARGET_PRODUCT=
323    local ANSWER
324    while [ -z "$TARGET_PRODUCT" ]
325    do
326        echo -n "Which product would you like? [$default_value] "
327        if [ -z "$1" ] ; then
328            read ANSWER
329        else
330            echo $1
331            ANSWER=$1
332        fi
333
334        if [ -z "$ANSWER" ] ; then
335            export TARGET_PRODUCT=$default_value
336        else
337            if check_product $ANSWER
338            then
339                export TARGET_PRODUCT=$ANSWER
340            else
341                echo "** Not a valid product: $ANSWER"
342            fi
343        fi
344        if [ -n "$1" ] ; then
345            break
346        fi
347    done
348
349    set_stuff_for_environment
350}
351
352function choosevariant()
353{
354    echo "Variant choices are:"
355    local index=1
356    local v
357    for v in ${VARIANT_CHOICES[@]}
358    do
359        # The product name is the name of the directory containing
360        # the makefile we found, above.
361        echo "     $index. $v"
362        index=$(($index+1))
363    done
364
365    local default_value=eng
366    local ANSWER
367
368    export TARGET_BUILD_VARIANT=
369    while [ -z "$TARGET_BUILD_VARIANT" ]
370    do
371        echo -n "Which would you like? [$default_value] "
372        if [ -z "$1" ] ; then
373            read ANSWER
374        else
375            echo $1
376            ANSWER=$1
377        fi
378
379        if [ -z "$ANSWER" ] ; then
380            export TARGET_BUILD_VARIANT=$default_value
381        elif (echo -n $ANSWER | grep -q -e "^[0-9][0-9]*$") ; then
382            if [ "$ANSWER" -le "${#VARIANT_CHOICES[@]}" ] ; then
383                export TARGET_BUILD_VARIANT=${VARIANT_CHOICES[$(($ANSWER-1))]}
384            fi
385        else
386            if check_variant $ANSWER
387            then
388                export TARGET_BUILD_VARIANT=$ANSWER
389            else
390                echo "** Not a valid variant: $ANSWER"
391            fi
392        fi
393        if [ -n "$1" ] ; then
394            break
395        fi
396    done
397}
398
399function choosecombo()
400{
401    choosesim $1
402
403    echo
404    echo
405    choosetype $2
406
407    echo
408    echo
409    chooseproduct $3
410
411    echo
412    echo
413    choosevariant $4
414
415    echo
416    set_stuff_for_environment
417    printconfig
418}
419
420# Clear this variable.  It will be built up again when the vendorsetup.sh
421# files are included at the end of this file.
422unset LUNCH_MENU_CHOICES
423function add_lunch_combo()
424{
425    local new_combo=$1
426    local c
427    for c in ${LUNCH_MENU_CHOICES[@]} ; do
428        if [ "$new_combo" = "$c" ] ; then
429            return
430        fi
431    done
432    LUNCH_MENU_CHOICES=(${LUNCH_MENU_CHOICES[@]} $new_combo)
433}
434
435# add the default one here
436add_lunch_combo full-eng
437add_lunch_combo full_x86-eng
438
439# if we're on linux, add the simulator.  There is a special case
440# in lunch to deal with the simulator
441if [ "$(uname)" = "Linux" ] ; then
442    add_lunch_combo simulator
443fi
444
445function print_lunch_menu()
446{
447    local uname=$(uname)
448    echo
449    echo "You're building on" $uname
450    echo
451    echo "Lunch menu... pick a combo:"
452
453    local i=1
454    local choice
455    for choice in ${LUNCH_MENU_CHOICES[@]}
456    do
457        echo "     $i. $choice"
458        i=$(($i+1))
459    done
460
461    echo
462}
463
464function lunch()
465{
466    local answer
467
468    if [ "$1" ] ; then
469        answer=$1
470    else
471        print_lunch_menu
472        echo -n "Which would you like? [generic-eng] "
473        read answer
474    fi
475
476    local selection=
477
478    if [ -z "$answer" ]
479    then
480        selection=generic-eng
481    elif [ "$answer" = "simulator" ]
482    then
483        selection=simulator
484    elif (echo -n $answer | grep -q -e "^[0-9][0-9]*$")
485    then
486        if [ $answer -le ${#LUNCH_MENU_CHOICES[@]} ]
487        then
488            selection=${LUNCH_MENU_CHOICES[$(($answer-1))]}
489        fi
490    elif (echo -n $answer | grep -q -e "^[^\-][^\-]*-[^\-][^\-]*$")
491    then
492        selection=$answer
493    fi
494
495    if [ -z "$selection" ]
496    then
497        echo
498        echo "Invalid lunch combo: $answer"
499        return 1
500    fi
501
502    export TARGET_BUILD_APPS=
503
504    # special case the simulator
505    if [ "$selection" = "simulator" ]
506    then
507        export TARGET_PRODUCT=sim
508        export TARGET_BUILD_VARIANT=eng
509        export TARGET_SIMULATOR=true
510        export TARGET_BUILD_TYPE=debug
511    else
512        local product=$(echo -n $selection | sed -e "s/-.*$//")
513        check_product $product
514        if [ $? -ne 0 ]
515        then
516            echo
517            echo "** Don't have a product spec for: '$product'"
518            echo "** Do you have the right repo manifest?"
519            product=
520        fi
521
522        local variant=$(echo -n $selection | sed -e "s/^[^\-]*-//")
523        check_variant $variant
524        if [ $? -ne 0 ]
525        then
526            echo
527            echo "** Invalid variant: '$variant'"
528            echo "** Must be one of ${VARIANT_CHOICES[@]}"
529            variant=
530        fi
531
532        if [ -z "$product" -o -z "$variant" ]
533        then
534            echo
535            return 1
536        fi
537
538        export TARGET_PRODUCT=$product
539        export TARGET_BUILD_VARIANT=$variant
540        export TARGET_SIMULATOR=false
541        export TARGET_BUILD_TYPE=release
542    fi # !simulator
543
544    echo
545
546    set_stuff_for_environment
547    printconfig
548}
549
550# Tab completion for lunch.
551function _lunch()
552{
553    local cur prev opts
554    COMPREPLY=()
555    cur="${COMP_WORDS[COMP_CWORD]}"
556    prev="${COMP_WORDS[COMP_CWORD-1]}"
557
558    COMPREPLY=( $(compgen -W "${LUNCH_MENU_CHOICES[*]}" -- ${cur}) )
559    return 0
560}
561complete -F _lunch lunch
562
563# Configures the build to build unbundled apps.
564# Run tapas with one ore more app names (from LOCAL_PACKAGE_NAME)
565function tapas()
566{
567    local variant=$(echo -n $(echo $* | xargs -n 1 echo | grep -E '^(user|userdebug|eng)$'))
568    local apps=$(echo -n $(echo $* | xargs -n 1 echo | grep -E -v '^(user|userdebug|eng)$'))
569
570    if [ $(echo $variant | wc -w) -gt 1 ]; then
571        echo "tapas: Error: Multiple build variants supplied: $variant"
572        return
573    fi
574    if [ -z "$variant" ]; then
575        variant=eng
576    fi
577    if [ -z "$apps" ]; then
578        apps=all
579    fi
580
581    export TARGET_PRODUCT=generic
582    export TARGET_BUILD_VARIANT=$variant
583    export TARGET_SIMULATOR=false
584    export TARGET_BUILD_TYPE=release
585    export TARGET_BUILD_APPS=$apps
586
587    set_stuff_for_environment
588    printconfig
589}
590
591function gettop
592{
593    local TOPFILE=build/core/envsetup.mk
594    if [ -n "$TOP" -a -f "$TOP/$TOPFILE" ] ; then
595        echo $TOP
596    else
597        if [ -f $TOPFILE ] ; then
598            # The following circumlocution (repeated below as well) ensures
599            # that we record the true directory name and not one that is
600            # faked up with symlink names.
601            PWD= /bin/pwd
602        else
603            # We redirect cd to /dev/null in case it's aliased to
604            # a command that prints something as a side-effect
605            # (like pushd)
606            local HERE=$PWD
607            T=
608            while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
609                cd .. > /dev/null
610                T=`PWD= /bin/pwd`
611            done
612            cd $HERE > /dev/null
613            if [ -f "$T/$TOPFILE" ]; then
614                echo $T
615            fi
616        fi
617    fi
618}
619
620function m()
621{
622    T=$(gettop)
623    if [ "$T" ]; then
624        make -C $T $@
625    else
626        echo "Couldn't locate the top of the tree.  Try setting TOP."
627    fi
628}
629
630function findmakefile()
631{
632    TOPFILE=build/core/envsetup.mk
633    # We redirect cd to /dev/null in case it's aliased to
634    # a command that prints something as a side-effect
635    # (like pushd)
636    local HERE=$PWD
637    T=
638    while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
639        T=$PWD
640        if [ -f "$T/Android.mk" ]; then
641            echo $T/Android.mk
642            cd $HERE > /dev/null
643            return
644        fi
645        cd .. > /dev/null
646    done
647    cd $HERE > /dev/null
648}
649
650function mm()
651{
652    # If we're sitting in the root of the build tree, just do a
653    # normal make.
654    if [ -f build/core/envsetup.mk -a -f Makefile ]; then
655        make $@
656    else
657        # Find the closest Android.mk file.
658        T=$(gettop)
659        local M=$(findmakefile)
660        # Remove the path to top as the makefilepath needs to be relative
661        local M=`echo $M|sed 's:'$T'/::'`
662        if [ ! "$T" ]; then
663            echo "Couldn't locate the top of the tree.  Try setting TOP."
664        elif [ ! "$M" ]; then
665            echo "Couldn't locate a makefile from the current directory."
666        else
667            ONE_SHOT_MAKEFILE=$M make -C $T all_modules $@
668        fi
669    fi
670}
671
672function mmm()
673{
674    T=$(gettop)
675    if [ "$T" ]; then
676        local MAKEFILE=
677        local ARGS=
678        local DIR TO_CHOP
679        local DASH_ARGS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^-.*$/')
680        local DIRS=$(echo "$@" | awk -v RS=" " -v ORS=" " '/^[^-].*$/')
681        for DIR in $DIRS ; do
682            DIR=`echo $DIR | sed -e 's:/$::'`
683            if [ -f $DIR/Android.mk ]; then
684                TO_CHOP=`echo $T | wc -c | tr -d ' '`
685                TO_CHOP=`expr $TO_CHOP + 1`
686                START=`PWD= /bin/pwd`
687                MFILE=`echo $START | cut -c${TO_CHOP}-`
688                if [ "$MFILE" = "" ] ; then
689                    MFILE=$DIR/Android.mk
690                else
691                    MFILE=$MFILE/$DIR/Android.mk
692                fi
693                MAKEFILE="$MAKEFILE $MFILE"
694            else
695                if [ "$DIR" = snod ]; then
696                    ARGS="$ARGS snod"
697                elif [ "$DIR" = showcommands ]; then
698                    ARGS="$ARGS showcommands"
699                elif [ "$DIR" = dist ]; then
700                    ARGS="$ARGS dist"
701                else
702                    echo "No Android.mk in $DIR."
703                    return 1
704                fi
705            fi
706        done
707        ONE_SHOT_MAKEFILE="$MAKEFILE" make -C $T $DASH_ARGS all_modules $ARGS
708    else
709        echo "Couldn't locate the top of the tree.  Try setting TOP."
710    fi
711}
712
713function croot()
714{
715    T=$(gettop)
716    if [ "$T" ]; then
717        cd $(gettop)
718    else
719        echo "Couldn't locate the top of the tree.  Try setting TOP."
720    fi
721}
722
723function cproj()
724{
725    TOPFILE=build/core/envsetup.mk
726    # We redirect cd to /dev/null in case it's aliased to
727    # a command that prints something as a side-effect
728    # (like pushd)
729    local HERE=$PWD
730    T=
731    while [ \( ! \( -f $TOPFILE \) \) -a \( $PWD != "/" \) ]; do
732        T=$PWD
733        if [ -f "$T/Android.mk" ]; then
734            cd $T
735            return
736        fi
737        cd .. > /dev/null
738    done
739    cd $HERE > /dev/null
740    echo "can't find Android.mk"
741}
742
743function pid()
744{
745   local EXE="$1"
746   if [ "$EXE" ] ; then
747       local PID=`adb shell ps | fgrep $1 | sed -e 's/[^ ]* *\([0-9]*\).*/\1/'`
748       echo "$PID"
749   else
750       echo "usage: pid name"
751   fi
752}
753
754# systemstack - dump the current stack trace of all threads in the system process
755# to the usual ANR traces file
756function systemstack()
757{
758    adb shell echo '""' '>>' /data/anr/traces.txt && adb shell chmod 776 /data/anr/traces.txt && adb shell kill -3 $(pid system_server)
759}
760
761function gdbclient()
762{
763   local OUT_ROOT=$(get_abs_build_var PRODUCT_OUT)
764   local OUT_SYMBOLS=$(get_abs_build_var TARGET_OUT_UNSTRIPPED)
765   local OUT_SO_SYMBOLS=$(get_abs_build_var TARGET_OUT_SHARED_LIBRARIES_UNSTRIPPED)
766   local OUT_EXE_SYMBOLS=$(get_abs_build_var TARGET_OUT_EXECUTABLES_UNSTRIPPED)
767   local PREBUILTS=$(get_abs_build_var ANDROID_PREBUILTS)
768   if [ "$OUT_ROOT" -a "$PREBUILTS" ]; then
769       local EXE="$1"
770       if [ "$EXE" ] ; then
771           EXE=$1
772       else
773           EXE="app_process"
774       fi
775
776       local PORT="$2"
777       if [ "$PORT" ] ; then
778           PORT=$2
779       else
780           PORT=":5039"
781       fi
782
783       local PID
784       local PROG="$3"
785       if [ "$PROG" ] ; then
786           PID=`pid $3`
787           adb forward "tcp$PORT" "tcp$PORT"
788           adb shell gdbserver $PORT --attach $PID &
789           sleep 2
790       else
791               echo ""
792               echo "If you haven't done so already, do this first on the device:"
793               echo "    gdbserver $PORT /system/bin/$EXE"
794                   echo " or"
795               echo "    gdbserver $PORT --attach $PID"
796               echo ""
797       fi
798
799       echo >|"$OUT_ROOT/gdbclient.cmds" "set solib-absolute-prefix $OUT_SYMBOLS"
800       echo >>"$OUT_ROOT/gdbclient.cmds" "set solib-search-path $OUT_SO_SYMBOLS"
801       echo >>"$OUT_ROOT/gdbclient.cmds" "target remote $PORT"
802       echo >>"$OUT_ROOT/gdbclient.cmds" ""
803
804       arm-linux-androideabi-gdb -x "$OUT_ROOT/gdbclient.cmds" "$OUT_EXE_SYMBOLS/$EXE"
805  else
806       echo "Unable to determine build system output dir."
807   fi
808
809}
810
811case `uname -s` in
812    Darwin)
813        function sgrep()
814        {
815            find -E . -type f -iregex '.*\.(c|h|cpp|S|java|xml|sh|mk)' -print0 | xargs -0 grep --color -n "$@"
816        }
817
818        ;;
819    *)
820        function sgrep()
821        {
822            find . -type f -iregex '.*\.\(c\|h\|cpp\|S\|java\|xml\|sh\|mk\)' -print0 | xargs -0 grep --color -n "$@"
823        }
824        ;;
825esac
826
827function jgrep()
828{
829    find . -type f -name "*\.java" -print0 | xargs -0 grep --color -n "$@"
830}
831
832function cgrep()
833{
834    find . -type f \( -name '*.c' -o -name '*.cc' -o -name '*.cpp' -o -name '*.h' \) -print0 | xargs -0 grep --color -n "$@"
835}
836
837function resgrep()
838{
839    for dir in `find . -name res -type d`; do find $dir -type f -name '*\.xml' -print0 | xargs -0 grep --color -n "$@"; done;
840}
841
842case `uname -s` in
843    Darwin)
844        function mgrep()
845        {
846            find -E . -type f -iregex '.*/(Makefile|Makefile\..*|.*\.make|.*\.mak|.*\.mk)' -print0 | xargs -0 grep --color -n "$@"
847        }
848
849        function treegrep()
850        {
851            find -E . -type f -iregex '.*\.(c|h|cpp|S|java|xml)' -print0 | xargs -0 grep --color -n -i "$@"
852        }
853
854        ;;
855    *)
856        function mgrep()
857        {
858            find . -regextype posix-egrep -iregex '(.*\/Makefile|.*\/Makefile\..*|.*\.make|.*\.mak|.*\.mk)' -type f -print0 | xargs -0 grep --color -n "$@"
859        }
860
861        function treegrep()
862        {
863            find . -regextype posix-egrep -iregex '.*\.(c|h|cpp|S|java|xml)' -type f -print0 | xargs -0 grep --color -n -i "$@"
864        }
865
866        ;;
867esac
868
869function getprebuilt
870{
871    get_abs_build_var ANDROID_PREBUILTS
872}
873
874function tracedmdump()
875{
876    T=$(gettop)
877    if [ ! "$T" ]; then
878        echo "Couldn't locate the top of the tree.  Try setting TOP."
879        return
880    fi
881    local prebuiltdir=$(getprebuilt)
882    local KERNEL=$T/prebuilt/android-arm/kernel/vmlinux-qemu
883
884    local TRACE=$1
885    if [ ! "$TRACE" ] ; then
886        echo "usage:  tracedmdump  tracename"
887        return
888    fi
889
890    if [ ! -r "$KERNEL" ] ; then
891        echo "Error: cannot find kernel: '$KERNEL'"
892        return
893    fi
894
895    local BASETRACE=$(basename $TRACE)
896    if [ "$BASETRACE" = "$TRACE" ] ; then
897        TRACE=$ANDROID_PRODUCT_OUT/traces/$TRACE
898    fi
899
900    echo "post-processing traces..."
901    rm -f $TRACE/qtrace.dexlist
902    post_trace $TRACE
903    if [ $? -ne 0 ]; then
904        echo "***"
905        echo "*** Error: malformed trace.  Did you remember to exit the emulator?"
906        echo "***"
907        return
908    fi
909    echo "generating dexlist output..."
910    /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
911    echo "generating dmtrace data..."
912    q2dm -r $ANDROID_PRODUCT_OUT/symbols $TRACE $KERNEL $TRACE/dmtrace || return
913    echo "generating html file..."
914    dmtracedump -h $TRACE/dmtrace >| $TRACE/dmtrace.html || return
915    echo "done, see $TRACE/dmtrace.html for details"
916    echo "or run:"
917    echo "    traceview $TRACE/dmtrace"
918}
919
920# communicate with a running device or emulator, set up necessary state,
921# and run the hat command.
922function runhat()
923{
924    # process standard adb options
925    local adbTarget=""
926    if [ "$1" = "-d" -o "$1" = "-e" ]; then
927        adbTarget=$1
928        shift 1
929    elif [ "$1" = "-s" ]; then
930        adbTarget="$1 $2"
931        shift 2
932    fi
933    local adbOptions=${adbTarget}
934    echo adbOptions = ${adbOptions}
935
936    # runhat options
937    local targetPid=$1
938
939    if [ "$targetPid" = "" ]; then
940        echo "Usage: runhat [ -d | -e | -s serial ] target-pid"
941        return
942    fi
943
944    # confirm hat is available
945    if [ -z $(which hat) ]; then
946        echo "hat is not available in this configuration."
947        return
948    fi
949
950    # issue "am" command to cause the hprof dump
951    local devFile=/sdcard/hprof-$targetPid
952    echo "Poking $targetPid and waiting for data..."
953    adb ${adbOptions} shell am dumpheap $targetPid $devFile
954    echo "Press enter when logcat shows \"hprof: heap dump completed\""
955    echo -n "> "
956    read
957
958    local localFile=/tmp/$$-hprof
959
960    echo "Retrieving file $devFile..."
961    adb ${adbOptions} pull $devFile $localFile
962
963    adb ${adbOptions} shell rm $devFile
964
965    echo "Running hat on $localFile"
966    echo "View the output by pointing your browser at http://localhost:7000/"
967    echo ""
968    hat $localFile
969}
970
971function getbugreports()
972{
973    local reports=(`adb shell ls /sdcard/bugreports | tr -d '\r'`)
974
975    if [ ! "$reports" ]; then
976        echo "Could not locate any bugreports."
977        return
978    fi
979
980    local report
981    for report in ${reports[@]}
982    do
983        echo "/sdcard/bugreports/${report}"
984        adb pull /sdcard/bugreports/${report} ${report}
985        gunzip ${report}
986    done
987}
988
989function startviewserver()
990{
991    local port=4939
992    if [ $# -gt 0 ]; then
993            port=$1
994    fi
995    adb shell service call window 1 i32 $port
996}
997
998function stopviewserver()
999{
1000    adb shell service call window 2
1001}
1002
1003function isviewserverstarted()
1004{
1005    adb shell service call window 3
1006}
1007
1008function smoketest()
1009{
1010    if [ ! "$ANDROID_PRODUCT_OUT" ]; then
1011        echo "Couldn't locate output files.  Try running 'lunch' first." >&2
1012        return
1013    fi
1014    T=$(gettop)
1015    if [ ! "$T" ]; then
1016        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
1017        return
1018    fi
1019
1020    (cd "$T" && mmm tests/SmokeTest) &&
1021      adb uninstall com.android.smoketest > /dev/null &&
1022      adb uninstall com.android.smoketest.tests > /dev/null &&
1023      adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTestApp.apk &&
1024      adb install $ANDROID_PRODUCT_OUT/data/app/SmokeTest.apk &&
1025      adb shell am instrument -w com.android.smoketest.tests/android.test.InstrumentationTestRunner
1026}
1027
1028# simple shortcut to the runtest command
1029function runtest()
1030{
1031    T=$(gettop)
1032    if [ ! "$T" ]; then
1033        echo "Couldn't locate the top of the tree.  Try setting TOP." >&2
1034        return
1035    fi
1036    ("$T"/development/testrunner/runtest.py $@)
1037}
1038
1039function godir () {
1040    if [[ -z "$1" ]]; then
1041        echo "Usage: godir <regex>"
1042        return
1043    fi
1044    T=$(gettop)
1045    if [[ ! -f $T/filelist ]]; then
1046        echo -n "Creating index..."
1047        (cd $T; find . -wholename ./out -prune -o -wholename ./.repo -prune -o -type f > filelist)
1048        echo " Done"
1049        echo ""
1050    fi
1051    local lines
1052    lines=($(grep "$1" $T/filelist | sed -e 's/\/[^/]*$//' | sort | uniq)) 
1053    if [[ ${#lines[@]} = 0 ]]; then
1054        echo "Not found"
1055        return
1056    fi
1057    local pathname
1058    local choice
1059    if [[ ${#lines[@]} > 1 ]]; then
1060        while [[ -z "$pathname" ]]; do
1061            local index=1
1062            local line
1063            for line in ${lines[@]}; do
1064                printf "%6s %s\n" "[$index]" $line
1065                index=$(($index + 1)) 
1066            done
1067            echo
1068            echo -n "Select one: "
1069            unset choice
1070            read choice
1071            if [[ $choice -gt ${#lines[@]} || $choice -lt 1 ]]; then
1072                echo "Invalid choice"
1073                continue
1074            fi
1075            pathname=${lines[$(($choice-1))]}
1076        done
1077    else
1078        pathname=${lines[0]}
1079    fi
1080    cd $T/$pathname
1081}
1082
1083# Force JAVA_HOME to point to java 1.6 if it isn't already set
1084function set_java_home() {
1085    if [ ! "$JAVA_HOME" ]; then
1086        case `uname -s` in
1087            Darwin)
1088                export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home
1089                ;;
1090            *)
1091                export JAVA_HOME=/usr/lib/jvm/java-6-sun
1092                ;;
1093        esac
1094    fi
1095}
1096
1097case `ps -o command -p $$` in
1098    *bash*)
1099        ;;
1100    *)
1101        echo "WARNING: Only bash is supported, use of other shell would lead to erroneous results"
1102        ;;
1103esac
1104
1105# Execute the contents of any vendorsetup.sh files we can find.
1106for f in `/bin/ls vendor/*/vendorsetup.sh vendor/*/*/vendorsetup.sh device/*/*/vendorsetup.sh 2> /dev/null`
1107do
1108    echo "including $f"
1109    . $f
1110done
1111unset f
1112