2.4.2 Install Graphics Analyzer on a Linux target

To install Graphics Analyzer on a Linux target, take the following steps.

  1. Navigate to the ./target/linux/ directory, and then to the appropriate directory for your configuration.

    Inside each of these directories, there are the following files:

    • libinterceptor.so
    • aga-daemon

    Note:

    • The Linux interceptor supports all Arm®v7 and later architecture-based CPUs running Linux.
    • Make sure that you use the correct libraries for your target architecture. If you are running on Armv7, you must use either the soft float libraries or the hard float libraries, depending on the requirements of your system.
    • You can use the appropriate 64-bit build of the daemon when capturing either 64-bit or 32-bit applications.
  2. Install the daemon by copying aga-daemon to anywhere on your target device, and setting the execute permission bit on the file. You can set the execute permission bit by running the following command from inside the directory that you copied aga-daemon into:
    chmod +x aga-daemon
  3. Install the OpenGL ES, EGL, and OpenCL interceptor by copying libinterceptor.so to anywhere on your target device.
  4. Install the Vulkan layer:
    1. Copy libinterceptor.so to anywhere on your target device, and rename it to libVK_layer_aga.so.

      Note:

      Graphics Analyzer supports capturing Vulkan applications on all Linux targets except for Arm soft-float.
    2. <install_directory>/target/linux contains the VK_LAYER_ARM_AGA.json manifest file. Copy this file into the same directory as libVK_layer_aga.so.

      Note:

      If the application does not query or request them, loading layers and extensions might be expensive and unnecessary. Manifests allow the Vulkan loader to identify the names and attributes of layers and extensions without needing to load them.
Non-Confidential - RELPDF file icon PDF version101545__00_en
Copyright © 2020–2022, 2024 Arm Limited or its affiliates. All rights reserved.