Capturing data on your target
Typically, ARM Streamline uses an active network connection to send captured data from the target to the host. If this is not possible because of limitations with your target, you can save the data to local target storage for a later manual transfer to your host.
To capture data locally, follow these steps:
Create a session.xml file. For an example session.xml file, see the
end of this topic.
gatordaccepts existing session.xml files. You can copy a session.xml file from an existing capture.
Enter the following command: ./gatord -s
session.xml_location/session.xml -o YourFileName.apc &
-soption defines the location of session.xml, while the
-ooption defines the name and location of the resulting .apc output file.
Stop the capture session. You can do so in a number of different ways:
- Specify a duration using the duration attribute in session.xml.
- In session.xml, set the value of the
buffer_modevariable to something other than streaming. Use one of the following values: Large, Normal, or Small. A Large store-and-forward buffer is 16MB, while Normal is 4MB and Small is 1MB. The profiling session terminates automatically when it reaches the set buffer size.
- Press Ctrl+C on the console to interrupt the gator daemon. The daemon must be running in the foreground.
- Determine the process id of gatord and enter the kill command: kill process_ID.
- Transfer the newly created .apc directory to your host.
- Open Eclipse for DS-5.
- If the Streamline Data view is not already open, select Window > Show View > Other and choose Streamline Data from the list of available views.
- Click the Edit Locations... button in the upper right of the Streamline Data View.
- Choose the directory that contains the .apc directory that you transferred from your target.
- Double-click on the .apc directory in the Streamline Data view to open the Analyze dialog box.
- Define your image files using the Analyze dialog box. Image files must match the images that you ran on your target during the local capture session.
- Click Analyze.
- Double-click on the Streamline Analysis Report in the Streamline Data View.
An example session.xml file:
<?xml version="1.0" encoding="US-ASCII" ?> <session version="1" output_path="x" call_stack_unwinding="yes" parse_debug_info="yes" high_resolution="no" buffer_mode="streaming" sample_rate="normal" duration="0" target_host="snowball" target_port="8080"> </session>