1.13 gatord command-line options

When you start gatord from the command line, you can pass various options to it, including options that define the location of the gator.ko module and the configurable xml files it uses to define the parameters of the capture session.

You can use the following options with gatord:
-a
Allows users to run a command on the target during profiling. The command is specified in the Capture & Analysis Options dialog.

Caution

If you use this option, an unauthenticated user will be able to run arbitrary commands on the target using Streamline.
-c path/configuration.xml
Sets the location of the configuration.xml file that defines the capture options. Include the directory location and the file name. This option is useful when the directory containing gatord is not writable.
-d
Displays gatord debug messages.
-e path/events.xml
Specifies the location of the events.xml file to use with gatord. events.xml defines all of the counters that Streamline collects during the capture session. Include the directory location and the file name.
-E filename
Specifies an XML file that defines one or more event counters to append to the events.xml file. This option allows you to add new events to gator without having to rebuild gatord or to entirely replace events.xml.
The XML file must include the XML header and elements shown in the following example:
<?xml version="1.0" encoding="UTF-8"?>
<events>
  <category name="Filesystem">
    <event counter="filesystem_loginuid" path="/proc/self/loginuid" title="loginuid" name="loginuid" class="absolute" description="loginuid"/>
  </category>
</events>
-h
Lists all of the available gatord command-line options.
-m path/gator.ko
If gator.ko is located in a different directory to gatord, this option defines its location.
-p port_num
Sets the port number that gatord uses to communicate with the host.
-P filename
Specifies an XML file that defines a new PMU to add to the list of PMUs that gatord has built-in support for. The list is defined in pmus.xml, which is located in the gator daemon source directory.
This option, used in combination with -E to define the events generated by the PMU, allows you to add support for a new PMU without having to rebuild gatord.
-s path/session.xml
Defines the location of the session.xml file. Include the directory location and the file name. This option is most useful when performing a local capture.
-o apc_dir
When performing a local capture, defines the location of the resulting APC directory.
-v
Displays version information for gatord.
Related reference
3.2 Capture & Analysis Options dialog box settings
Non-ConfidentialPDF file icon PDF versionARM DUI0482U
Copyright © 2010-2015 ARM. All rights reserved.