[BUG] wrap.sh prevents debugger from attaching

[polishcode]

NDK latest version (19.2.5345600)
gradle/externalNativeBuild/ndkBuild
host OS: Windows 10
compiler: clang
abi checked: arm*, x86*
stl c++_shared
NDK API level 26
device API level: 26-28 (emulator, Nexus 5X)
ASAN used with build + wrap.sh bundled

When wrap.sh is bundled with the apk, the AS debugger (native)/adb does not see any debuggable processes on the device. Therefore no debugging session can be started.

When wrap.sh is not bundled with the apk (just libclang_rt.asan-*.so), debugging session starts with no problem.

I use standard contents (generated by ndk-build) for wrap.sh:

#!/system/bin/sh
HERE="$(cd "$(dirname "$0")" && pwd)"
export ASAN_OPTIONS=log_to_syslog=false,allow_user_segv_handler=1
export LD_PRELOAD=$HERE/libclang_rt.asan-i686-android.so
$@

[enh]

the ART folks seem to consider this working as intended, so i'm working on at least getting the documentation fixed to include the workaround. in the meantime, here's what the workaround looks like:

#!/system/bin/sh

cmd=$1
shift

os_version=$(getprop ro.build.version.sdk)

if [ "$os_version" -eq "27" ]; then
  cmd="$cmd -Xrunjdwp:transport=dt_android_adb,suspend=n,server=y -Xcompiler-option --debuggable $@"
elif [ "$os_version" -eq "28" ]; then
  cmd="$cmd -XjdwpProvider:adbconnection -XjdwpOptions:suspend=n,server=y -Xcompiler-option --debuggable $@"
else
  cmd="$cmd -XjdwpProvider:adbconnection $@"
fi

exec $cmd

(you'll need to add your lines back in there, of course!)

[polishcode]

Thank you. I will try that tomorrow.

[polishcode]

Ok, took me more than a day to focus on this again :)
Thank you for update: https://developer.android.com/ndk/guides/wrap-script#debugging_when_using_wrapsh

Few minor issues though after making it work for me.

1. It would be nice to have a consistent view on using 'exec' for wrap.sh:

• no exec: https://github.com/google/sanitizers/wiki/AddressSanitizerOnAndroid#Running
• exec: https://developer.android.com/ndk/guides/wrap-script#debugging_when_using_wrapsh

2. It would be nice to mention that a change in e.g. abi requires stopping application (or uninstalling it) between app re-runs. I can only guess the reasons, but the failure to do that results in the application not being able to start (it just hangs, white screen as the UI does not render). After reinstall it is ok.

3. After application installation from AS the Attach Debugger to Android Process windows shows dreaded "Error/Warning debug info can be unavailable...". adb usb in a cmd fixes the situation. This does not happen to me without wrap.sh.

4. It would be great to mention that when running e.g. armeabi on a 64-bit device linker will not find getprop symbol. In runtime it will throw:

03-25 12:55:35.656 29330 29330 F DEBUG : *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
03-25 12:55:35.657 29330 29330 F DEBUG : Build fingerprint: 'google/bullhead/bullhead:8.1.0/OPM7.181205.001/5080180:user/release-keys'
03-25 12:55:35.657 29330 29330 F DEBUG : Revision: 'rev_1.0'
03-25 12:55:35.657 29330 29330 F DEBUG : ABI: 'arm64'
03-25 12:55:35.657 29330 29330 F DEBUG : pid: 29327, tid: 29327, name: getprop >>> getprop <<<
03-25 12:55:35.657 29330 29330 F DEBUG : signal 6 (SIGABRT), code -6 (SI_TKILL), fault addr --------
03-25 12:55:35.658 29330 29330 F DEBUG : Abort message: 'CANNOT LINK EXECUTABLE "getprop": "/data/app/softax.wallet.showcase-NX3ASEF5eLcHDAqbeBZhJw==/lib/arm/libclang_rt.asan-arm-android.so" is 32-bit instead of 64-bit'
03-25 12:55:35.658 29330 29330 F DEBUG : x0 0000000000000000 x1 000000000000728f x2 0000000000000006 x3 0000000000000008
...

Nevertheless, thank you for your work.

[polishcode]

5. One or more ASAN arguments from list below prevent app from running with your fix (app freezes, UI does not render):
   abort_on_error=1,debug=true,print_stats=true,log_path=stdout
   verbosity=1,detect_stack_use_after_return=true,print_stats=true

[polishcode]

5.1 Turns out option: "log_path=stdout" is not compatible with your solution.

[enh]

@eugenis for 1 and 5.

for 4 instead of shelling out to getprop you probably just want to call the bionic system property APIs directly (see <sys/system_properties.h>).

[eugenis]

1. It does not really matter, but it's better to use "exec" if it works. I'll update asan docs.

2. That's a common problem with LD_LIBRARY_PATH in multiarch systems. We used a symlink trick in the previous iteration of asan-on-android:
   https://github.com/llvm-mirror/compiler-rt/blob/master/lib/asan/scripts/asan_device_setup#L429
   It's better to avoid this problem altogether by using the libc API.

3. I'm not sure what's going on with log_path=stdout. Try log_path=stderr? Writing random stuff to stdout is known to break programs (just imagine doing this to "cat" or "grep").

[Wizermil]

Thanks @enh your script works like a charm.

Maybe the scripts in folder wrap.sh should be updated too?

#!/system/bin/sh

cmd=$1
shift

HERE="$(cd "$(dirname "$0")" && pwd)"
export ASAN_OPTIONS=abort_on_error=true,debug=true,print_stats=true,log_path=stderr,verbosity=true,detect_stack_use_after_return=true,print_stats=true
export LD_PRELOAD=$HERE/libclang_rt.asan-aarch64-android.so

os_version=$(getprop ro.build.version.sdk)
if [ "$os_version" -eq "27" ]; then
    cmd="$cmd -Xrunjdwp:transport=dt_android_adb,suspend=n,server=y -Xcompiler-option --debuggable $@"
elif [ "$os_version" -eq "28" ]; then
    cmd="$cmd -XjdwpProvider:adbconnection -XjdwpOptions:suspend=n,server=y -Xcompiler-option --debuggable $@"
else
    cmd="$cmd -XjdwpProvider:adbconnection $@"
fi
exec $cmd

[HaiPhan2002]

Hello, I stuck with the wrap.sh until I read this thread. It is very useful, I understand the step what I need to do.
Unfortunately, I still can not debug my App on Pixel 3 - Android 10, Build number QQ2A.200305.002.
The Debugger still shows Could not connect to remote process. Aborting debug session.

Here is my wrap.sh

#!/system/bin/sh

cmd=$1
shift

HERE="$(cd "$(dirname "$0")" && pwd)"
export ASAN_OPTIONS=log_to_syslog=false,allow_user_segv_handler=1
export LD_PRELOAD=$HERE/libclang_rt.asan-aarch64-android.so

os_version=$(getprop ro.build.version.sdk)
if [ "$os_version" -eq "27" ]; then
    cmd="$cmd -Xrunjdwp:transport=dt_android_adb,suspend=n,server=y -Xcompiler-option --debuggable $@"
elif [ "$os_version" -eq "28" ]; then
    cmd="$cmd -XjdwpProvider:adbconnection -XjdwpOptions:suspend=n,server=y -Xcompiler-option --debuggable $@"
else
    cmd="$cmd -XjdwpProvider:adbconnection $@"
fi
echo $cmd
exec $cmd

[DanAlbert]

@enh-google anything else you want to do on the docs here?