sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

dev-manual: Edits to "Running User-Space Tools" section. 

(From yocto-docs rev: bb3e5efe23d1bc890ad203e1c936937fb4fd8958)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2013-04-10 14:05:42 -07:00 committed by Richard Purdie
parent 7bc64bda4f
commit ef14eb8f98
1 changed files with 42 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

77
documentation/dev-manual/dev-manual-model.xml
View File

@ -1276,14 +1276,14 @@
your development experience.
These tools are aids in developing and debugging applications and images.
You can run these user-space tools from within the Eclipse IDE through the
<filename>YoctoTools</filename> menu.
"YoctoTools" menu.
</para>
<para>
Once you pick a tool, you need to configure it for the remote target.
Every tool needs to have the connection configured.
You must select an existing TCF-based RSE connection to the remote target.
If one does not exist, click <filename>New</filename> to create one.
If one does not exist, click "New" to create one.
</para>
<para>
@ -1298,10 +1298,10 @@
You must compile and install the <filename>oprofile-viewer</filename> from the source code
on your local host machine.
Furthermore, in order to convert the target's sample format data into a form that the
host can use, you must have <filename>oprofile</filename> version 0.9.4 or
host can use, you must have OProfile version 0.9.4 or
greater installed on the host.</para>
<para>You can locate both the viewer and server from
<ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi/oprofileui/'></ulink>
<ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi/oprofileui/'></ulink>.
You can also find more information on setting up and
using this tool in the
"<ulink url='&YOCTO_DOCS_PROF_URL;#profile-manual-oprofile'>OProfile</ulink>"
@ -1311,64 +1311,71 @@
<listitem><para><emphasis><filename>Lttng2.0 ust trace import</filename>:</emphasis>
Selecting this tool transfers the remote target's
<filename>Lttng</filename> tracing data back to the local host machine
and uses the <filename>Lttng</filename> Eclipse plug-in to graphically
and uses the Lttng Eclipse plug-in to graphically
display the output.
For information on how to use <filename>Lttng</filename> to trace an application,
see <ulink url='http://lttng.org/documentation'></ulink>.
For information on how to use Lttng to trace an application,
see <ulink url='http://lttng.org/documentation'></ulink>
and the
"<ulink url='&YOCTO_DOCS_PROF_URL;#lttng-linux-trace-toolkit-next-generation'>LTTng (Linux Trace Toolkit, next generation)</ulink>"
section, which is in the Yocto Project Profiling and Tracing Manual.
<note>Do not use <filename>Lttng-user space (legacy)</filename> tool.
This tool no longer has any upstream support.</note>
</para>
<para>Before you use the <filename>Lttng2.0 ust trace import</filename> tool,
you need to setup the <filename>Lttng</filename> Eclipse plug-in and create a
<filename>Tracing</filename> project.
you need to setup the Lttng Eclipse plug-in and create a
Tracing project.
Do the following:
<orderedlist>
<listitem><para>Select <filename>Window -> Open Perspective -> Other</filename>
and then select <filename>Tracing</filename>.</para></listitem>
<listitem><para>Click <filename>OK</filename> to change the Eclipse perspective
into the <filename>Tracing</filename> perspective.</para></listitem>
<listitem><para>Create a new <filename>Tracing</filename> project by selecting
<filename>File -> New -> Project</filename>.</para></listitem>
<listitem><para>Choose <filename>Tracing -> Tracing Project</filename>.
<listitem><para>Select "Open Perspective" from the
"Window" menu and then select "Tracing".</para></listitem>
<listitem><para>Click "OK" to change the Eclipse perspective
into the Tracing perspective.</para></listitem>
<listitem><para>Create a new Tracing project by selecting
"Project" from the "File -> New" menu.</para></listitem>
<listitem><para>Choose "Tracing Project" from the
"Tracing" menu.
</para></listitem>
<listitem><para>Generate your tracing data on the remote target.
</para></listitem>
<listitem><para>Click
<filename>Yocto Project Tools -> Lttng2.0 ust trace import</filename>
to start the data import process.</para></listitem>
<listitem><para>Select "Lttng2.0 ust trace import" from
the "Yocto Project Tools" menu to
start the data import process.</para></listitem>
<listitem><para>Specify your remote connection name.</para></listitem>
<listitem><para>For the Ust directory path, specify the location of
your remote tracing data.
Make sure the location ends with <filename>ust</filename> (e.g.
<filename>/usr/mysession/ust</filename>.</para></listitem>
<listitem><para>Click <filename>OK</filename> to complete the import process.
<filename>/usr/mysession/ust</filename>).</para></listitem>
<listitem><para>Click "OK" to complete the import process.
The data is now in the local tracing project you created.</para></listitem>
<listitem><para>Right click on the data and then use the menu to
<filename>Select Trace Type... -> Common Trace Format -> Generic CTF Trace</filename>
to map the tracing type.</para></listitem>
<listitem><para>Right click the mouse and select <filename>Open</filename>
to bring up the Eclipse <filename>Lttng</filename> Trace Viewer so you
Select "Generic CTF Trace" from the
"Trace Type... -> Common Trace Format" menu to map
the tracing type.</para></listitem>
<listitem><para>Right click the mouse and select "Open"
to bring up the Eclipse Lttng Trace Viewer so you
view the tracing data.</para></listitem>
</orderedlist></para></listitem>
<listitem><para><emphasis><filename>PowerTOP</filename>:</emphasis> Selecting this tool runs
<filename>powertop</filename> on the remote target machine and displays the results in a
new view called <filename>powertop</filename>.</para>
<para><filename>Time to gather data(sec):</filename> is the time passed in seconds before data
PowerTOP on the remote target machine and displays the results in a
new view called PowerTOP.</para>
<para>The "Time to gather data(sec):" field is the time passed in seconds before data
is gathered from the remote target for analysis.</para>
<para><filename>show pids in wakeups list:</filename> corresponds to the
<para>The "show pids in wakeups list:" field corresponds to the
<filename>-p</filename> argument
passed to <filename>powertop</filename>.</para></listitem>
<listitem><para><emphasis><filename>LatencyTOP and Perf</filename>:</emphasis>
<filename>latencytop</filename> identifies system latency, while
<filename>perf</filename> monitors the system's
performance counter registers.
passed to <filename>PowerTOP</filename>.</para></listitem>
<listitem><para><emphasis><filename>LatencyTOP and Perf</filename>:</emphasis>
LatencyTOP identifies system latency, while
Perf monitors the system's performance counter registers.
Selecting either of these tools causes an RSE terminal view to appear
from which you can run the tools.
Both tools refresh the entire screen to display results while they run.
For more informationi on setting up and using <filename>perf</filename>,
For more information on setting up and using <filename>perf</filename>,
see the
"<ulink url='&YOCTO_DOCS_PROF_URL;#profile-manual-perf'>perf</ulink>"
section in the Yocto Project Profiling and Tracing Manual.
For information on LatencyTOP, see the
<ulink url='https://latencytop.org/'>LatencyTOP</ulink>
website.
</para></listitem>
</itemizedlist>
</para>