The Connection Browser dialog box
The Connection Browser dialog box, opened from the Streamline Data view, enables you to select a target without having to look up its name or IP address.
Figure 2-3 Connection Browser in Streamline
When you click the Browse for a target button in the Connection field of the Streamline Data view, Streamline searches your network and provides a selectable list of possible targets. The Connection Browser sorts the targets by type:
- Streamline Agent
- Lists all targets connected directly to the network that have gator installed and running. These are the most common targets for Streamline.
- Streamline Agent via ADB
- Lists all Android targets that have gator installed and running and are connected to the host using ADB. You must have installed ADB and specified its location in the Capture & Analysis Options dialog in order for this list to be populated.
Clicking the Setup Target... button opens a dialog that allows you to automatically set up Streamline on a rooted Android or Linux target. You can specify an ADB connection for an Android target, or the IP address, user name, and password for a Linux target connected using SSH.
Click Install to install and
start a pre-built user space gator binary which runs on Android or Linux and on
ARMv7 or ARMv8 targets.
gatord runs using the
-a flag, so that you can enter a command in the
Capture & Analysis Options dialog box
without having to restart
Clicking Install also installs a
pre-built file called notify.dex into the same
gatord on the target.
gatord uses this file on Android targets to read
ATRACE_END() annotations and pass them to Streamline for processing.
This feature is supported on Linux kernel versions 3.10 and later.
The Setup Target dialog allows
you to run a capture session without having to carry out the manual steps for
configuring and running
gatordmust run as root. If you are using ADB,
adbdalso must run as root.
Setup Target... does not set up
gatordto start automatically on boot, so it needs to be done every time the device is rebooted
User space gator runs without the gator driver, gator.ko and does not support all Streamline features. For example, some counters might not be available. Kernel space gator provides a complete set of available features. To use it you must build gator.ko.
Figure 2-4 Automatically setting up Streamline on the target