Headless mode assumes that the Graphics Analyzer daemon is already installed on the target device. Instructions are available in Chapter 2 Before you begin.

Graphics Analyzer requires you to provide details about the device to connect. Use an IP address to connect using the --device-ip switch. Make sure that the aga-daemon executable is running on the target. Graphics Analyzer attempts to connect using port 5002.

You must specify a process name with --process. Headless mode does not support tracing multiple processes.

You must provide a file name with --trace-file-output. This file is where the trace is written to when the session ends. You must provide a file path that points to a writable location and include the file name you want to use, for example /path/to/my-trace.mgd. Use the .mgd extension so that Graphics Analyzer recognizes it as a trace file. If you do not use the standard extension, it is appended to the file name automatically.

To tell Graphics Analyzer when to stop tracing, use --timeout to set a timeout in seconds, or --exit-at-frame to set a frame limit for the trace.

You can also use the command line to set the trace configuration. Use the preset configurations, such as Full Trace, using the --trace-config switch. Alternatively, you can manually tell the interceptor to collect specific data, depending on your needs. For the full list of switches and valid inputs, run headless without any arguments to generate the help message.