5.23.1 File locations

The locations for the configuration file and the output trace file on the target device depend on the target OS.

Android

By default, trace files are saved to the $EXTERNAL_STORAGE/traces/ directory if the application loading the interceptor has the Android WRITE_EXTERNAL_STORAGE permission, or /data/user/<user_id>/<package_name> if the permission is not available.

Place the default configuration file in $EXTERNAL_STORAGE/aga-headless.conf if the application loading the interceptor library has the Android READ_EXTERNAL_STORAGE permission, or /data/user/<user_id>/<package_name>/aga-headless.conf if not.

Note:

  • If the target device is non-rooted, make sure that the application manifest contains the WRITE_EXTERNAL_STORAGE permission and that the application has that permission enabled in Settings. Without this permission, it is not possible to set the configuration file for the application or write the trace files, as internal application storage cannot be accessed without su, which requires the device to be rooted.
  • Android devices might implement specific SELinux policies which prevent Graphics Analyzer from reading the headless mode configuration file. You can verify if these policies are implemented by checking if there are any error messages using adb logcat -s audit. You can solve the issue by disabling SELinux on your rooted device.
  • The WRITE_EXTERNAL_STORAGE permission also implicitly grants READ_EXTERNAL_STORAGE, so if this permission is available, the interceptor always looks for the config file in $EXTERNAL_STORAGE/aga-headless.conf.
  • On most devices $EXTERNAL_STORAGE is /sdcard.

Linux

Trace files are saved to the $HOME/traces/ directory by default.

Place the configuration file in $HOME/aga-headless.conf.

Non-Confidential - RELPDF file icon PDF version101545__00_en
Copyright © 2020–2022, 2024 Arm Limited or its affiliates. All rights reserved.