run_app Command-Line Syntax

To launch an OpenGL* Desktop application for analysis with System Analyzer on an Ubuntu* host, run:

run_app [options] <application-name> [application-options]

where

  • options provide additional settings for the application launch:
    -s Starts the System Analyzer locally, together with the application to profile. This option is useful if you are going to profile the application on the same system where it runs.
    -t <process-name> Specifies the child process to profile. Use this option for games that cannot be launched directly. For example, if your game is using a separate launcher.
    -p Specifies the current working directory for the analyzed application. By default, it is the directory from which you run the command.
    -i <ip1[,ip2,...]> Specifies one or more IP addresses to enable remote analysis. Once the application starts rendering, you can connect the System Analyzer to this application from the system with the specified IP address.  By default, you can only connect to the application from the local system.
    -o <override-name> Enables one of the System Analyzer state overrides. You can choose from the following overrides:
    • Disable All
    • Show Wireframe
    • Texture 2x2
    • Disable Draw Calls
    • Disable Alpha Blending
    • Disable Z-Test
    • 1x1 Scissor Rect
    • Simple Fragment Shader
    --enable-dir3 Enables DRI3. By default, DRI2 is used.

    CAUTION

    Some drivers do not fully support DRI3. If you enable DRI3, you might run into unexpected issues.

  • application-name specifies the name of the application you want to analyze.
  • application-options are any additional parameters required for your application launch.

 

To view help for run_app from the command line, enter:

run_app -h

For more complete information about compiler optimizations, see our Optimization Notice.