Set up your target

To profile your software using Streamline, you must have a suitably configured Linux kernel and gatord running on an Arm^®-based hardware target.

Before you begin

Download Arm Development Studio. See Arm Development Studio Arm Development Studio Downloads.
Install Arm Development Studio. Follow the instructions in the Arm Development Studio Getting Started Guide.
If you intend to use the Statistical Profiling Extension (SPE) in Streamline, there are some additional system requirements. Refer to System requirements for SPE support.

Procedure

Validate the Linux kernel configuration.

The kernel configuration must include the options that are described in Kernel configuration menu options. You can usually find your kernel configuration in /proc/config.gz. If this file is not visible, depending how your system is configured, you can create it by running:
```
sudo modprobe configs
```
The following command confirms whether an option is enabled:
```
zcat /proc/config.gz | grep <OPTION>
```
For example:
```
zcat /proc/config.gz | grep CONFIG_PROFILING
```
Install gatord on your target.

Two pre-built gatord binaries are available:
- For Armv7 targets, and Armv8 targets that support AArch32 execution state.
- For Armv8 AArch64 targets.
The pre-built gatord binaries are available from the Arm Development Studio installation directory <install_directory>/sw/streamline/bin/linux/

The source code for gatord is available from the following locations:
- The Arm Development Studio installation directory <install_directory>/sw/streamline/gator/daemon/
- https://github.com/ARM-software/gator. This site is the official distribution channel for all gator releases,and contains the latest source updates between Arm Development Studio releases.
The version of gatord running on the target must be compatible with the version of Streamline that you are using. Use the same version of gatord as the version of Streamline.

For more information, see gatord.
To ensure gatord has execute permission, enter the following command:
```
chmod +x gatord
```
Ensure that you have root privileges, if necessary, then enter the following to execute gatord:
```
./gatord
```
By default, gatord uses port 8080 for communication with the host, but you can specify the port by launching gatord with the port number as a parameter. For example:
```
./gatord -p 5050
```
If the target runs a firewall that prevents Streamline from connecting to gatord, Arm recommends that you change the firewall settings to allow connections to gatord.

Next steps

Capture a profile of your application as described in Capture a Streamline profile.
To stop gatord at the end of a capture, press Ctrl+C.