diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2019-04-12 14:17:50 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2019-05-07 10:23:41 +0100 |
commit | 7625e3cffe18bb9e74fe76653d0f10fff60488ac (patch) | |
tree | 07b4f7678ddf23678020114153853cc81eed3629 /documentation/profile-manual/profile-manual-usage.xml | |
parent | f2c6d6c84b70d587010b157dd11251a2a3655d57 (diff) | |
download | poky-7625e3cffe18bb9e74fe76653d0f10fff60488ac.tar.gz |
profile-manual: Removed all references to Eclipse
One figure was removed and files modified.
(From yocto-docs rev: f5d7024c3c38bc7737894a5ad4b750d4d633f173)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/profile-manual/profile-manual-usage.xml')
-rw-r--r-- | documentation/profile-manual/profile-manual-usage.xml | 180 |
1 files changed, 0 insertions, 180 deletions
diff --git a/documentation/profile-manual/profile-manual-usage.xml b/documentation/profile-manual/profile-manual-usage.xml index a1b565157d..5999b29603 100644 --- a/documentation/profile-manual/profile-manual-usage.xml +++ b/documentation/profile-manual/profile-manual-usage.xml | |||
@@ -2350,22 +2350,8 @@ | |||
2350 | <para> | 2350 | <para> |
2351 | For this section, we'll assume you've already performed the | 2351 | For this section, we'll assume you've already performed the |
2352 | basic setup outlined in the General Setup section. | 2352 | basic setup outlined in the General Setup section. |
2353 | </para> | ||
2354 | |||
2355 | <para> | ||
2356 | LTTng is run on the target system by ssh'ing to it. | 2353 | LTTng is run on the target system by ssh'ing to it. |
2357 | However, if you want to see the traces graphically, | ||
2358 | install Eclipse as described in section | ||
2359 | "<link linkend='manually-copying-a-trace-to-the-host-and-viewing-it-in-eclipse'>Manually copying a trace to the host and viewing it in Eclipse (i.e. using Eclipse without network support)</link>" | ||
2360 | and follow the directions to manually copy traces to the host and | ||
2361 | view them in Eclipse (i.e. using Eclipse without network support). | ||
2362 | </para> | 2354 | </para> |
2363 | |||
2364 | <note> | ||
2365 | Be sure to download and install/run the 'SR1' or later Juno release | ||
2366 | of eclipse e.g.: | ||
2367 | <ulink url='http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/juno/SR1/eclipse-cpp-juno-SR1-linux-gtk-x86_64.tar.gz'>http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/juno/SR1/eclipse-cpp-juno-SR1-linux-gtk-x86_64.tar.gz</ulink> | ||
2368 | </note> | ||
2369 | </section> | 2355 | </section> |
2370 | 2356 | ||
2371 | <section id='collecting-and-viewing-traces'> | 2357 | <section id='collecting-and-viewing-traces'> |
@@ -2564,163 +2550,6 @@ | |||
2564 | </para> | 2550 | </para> |
2565 | </section> | 2551 | </section> |
2566 | 2552 | ||
2567 | <section id='manually-copying-a-trace-to-the-host-and-viewing-it-in-eclipse'> | ||
2568 | <title>Manually copying a trace to the host and viewing it in Eclipse (i.e. using Eclipse without network support)</title> | ||
2569 | |||
2570 | <para> | ||
2571 | If you already have an LTTng trace on a remote target and | ||
2572 | would like to view it in Eclipse on the host, you can easily | ||
2573 | copy it from the target to the host and import it into | ||
2574 | Eclipse to view it using the LTTng Eclipse plug-in already | ||
2575 | bundled in the Eclipse (Juno SR1 or greater). | ||
2576 | </para> | ||
2577 | |||
2578 | <para> | ||
2579 | Using the trace we created in the previous section, archive | ||
2580 | it and copy it to your host system: | ||
2581 | <literallayout class='monospaced'> | ||
2582 | root@crownbay:~/lttng-traces# tar zcvf auto-20121015-232120.tar.gz auto-20121015-232120 | ||
2583 | auto-20121015-232120/ | ||
2584 | auto-20121015-232120/kernel/ | ||
2585 | auto-20121015-232120/kernel/metadata | ||
2586 | auto-20121015-232120/kernel/channel0_1 | ||
2587 | auto-20121015-232120/kernel/channel0_0 | ||
2588 | |||
2589 | $ scp root@192.168.1.47:lttng-traces/auto-20121015-232120.tar.gz . | ||
2590 | root@192.168.1.47's password: | ||
2591 | auto-20121015-232120.tar.gz 100% 1566KB 1.5MB/s 00:01 | ||
2592 | </literallayout> | ||
2593 | Unarchive it on the host: | ||
2594 | <literallayout class='monospaced'> | ||
2595 | $ gunzip -c auto-20121015-232120.tar.gz | tar xvf - | ||
2596 | auto-20121015-232120/ | ||
2597 | auto-20121015-232120/kernel/ | ||
2598 | auto-20121015-232120/kernel/metadata | ||
2599 | auto-20121015-232120/kernel/channel0_1 | ||
2600 | auto-20121015-232120/kernel/channel0_0 | ||
2601 | </literallayout> | ||
2602 | We can now import the trace into Eclipse and view it: | ||
2603 | <orderedlist> | ||
2604 | <listitem><para>First, start eclipse and open the | ||
2605 | 'LTTng Kernel' perspective by selecting the following | ||
2606 | menu item: | ||
2607 | <literallayout class='monospaced'> | ||
2608 | Window | Open Perspective | Other... | ||
2609 | </literallayout></para></listitem> | ||
2610 | <listitem><para>In the dialog box that opens, select | ||
2611 | 'LTTng Kernel' from the list.</para></listitem> | ||
2612 | <listitem><para>Back at the main menu, select the | ||
2613 | following menu item: | ||
2614 | <literallayout class='monospaced'> | ||
2615 | File | New | Project... | ||
2616 | </literallayout></para></listitem> | ||
2617 | <listitem><para>In the dialog box that opens, select | ||
2618 | the 'Tracing | Tracing Project' wizard and press | ||
2619 | 'Next>'.</para></listitem> | ||
2620 | <listitem><para>Give the project a name and press | ||
2621 | 'Finish'.</para></listitem> | ||
2622 | <listitem><para>In the 'Project Explorer' pane under | ||
2623 | the project you created, right click on the | ||
2624 | 'Traces' item.</para></listitem> | ||
2625 | <listitem><para>Select 'Import..." and in the dialog | ||
2626 | that's displayed:</para></listitem> | ||
2627 | <listitem><para>Browse the filesystem and find the | ||
2628 | select the 'kernel' directory containing the trace | ||
2629 | you copied from the target | ||
2630 | e.g. auto-20121015-232120/kernel</para></listitem> | ||
2631 | <listitem><para>'Checkmark' the directory in the tree | ||
2632 | that's displayed for the trace</para></listitem> | ||
2633 | <listitem><para>Below that, select 'Common Trace Format: | ||
2634 | Kernel Trace' for the 'Trace Type'</para></listitem> | ||
2635 | <listitem><para>Press 'Finish' to close the dialog | ||
2636 | </para></listitem> | ||
2637 | <listitem><para>Back in the 'Project Explorer' pane, | ||
2638 | double-click on the 'kernel' item for the | ||
2639 | trace you just imported under 'Traces' | ||
2640 | </para></listitem> | ||
2641 | </orderedlist> | ||
2642 | You should now see your trace data displayed graphically | ||
2643 | in several different views in Eclipse: | ||
2644 | </para> | ||
2645 | |||
2646 | <para> | ||
2647 | <imagedata fileref="figures/lttngmain0.png" width="6in" depth="6in" align="center" scalefit="1" /> | ||
2648 | </para> | ||
2649 | |||
2650 | <para> | ||
2651 | You can access extensive help information on how to use | ||
2652 | the LTTng plug-in to search and analyze captured traces via | ||
2653 | the Eclipse help system: | ||
2654 | <literallayout class='monospaced'> | ||
2655 | Help | Help Contents | LTTng Plug-in User Guide | ||
2656 | </literallayout> | ||
2657 | </para> | ||
2658 | </section> | ||
2659 | |||
2660 | <section id='collecting-and-viewing-a-trace-in-eclipse'> | ||
2661 | <title>Collecting and viewing a trace in Eclipse</title> | ||
2662 | |||
2663 | <note> | ||
2664 | This section on collecting traces remotely doesn't currently | ||
2665 | work because of Eclipse 'RSE' connectivity problems. Manually | ||
2666 | tracing on the target, copying the trace files to the host, | ||
2667 | and viewing the trace in Eclipse on the host as outlined in | ||
2668 | previous steps does work however - please use the manual | ||
2669 | steps outlined above to view traces in Eclipse. | ||
2670 | </note> | ||
2671 | |||
2672 | <para> | ||
2673 | In order to trace a remote target, you also need to add | ||
2674 | a 'tracing' group on the target and connect as a user | ||
2675 | who's part of that group e.g: | ||
2676 | <literallayout class='monospaced'> | ||
2677 | # adduser tomz | ||
2678 | # groupadd -r tracing | ||
2679 | # usermod -a -G tracing tomz | ||
2680 | </literallayout> | ||
2681 | <orderedlist> | ||
2682 | <listitem><para>First, start eclipse and open the | ||
2683 | 'LTTng Kernel' perspective by selecting the following | ||
2684 | menu item: | ||
2685 | <literallayout class='monospaced'> | ||
2686 | Window | Open Perspective | Other... | ||
2687 | </literallayout></para></listitem> | ||
2688 | <listitem><para>In the dialog box that opens, select | ||
2689 | 'LTTng Kernel' from the list.</para></listitem> | ||
2690 | <listitem><para>Back at the main menu, select the | ||
2691 | following menu item: | ||
2692 | <literallayout class='monospaced'> | ||
2693 | File | New | Project... | ||
2694 | </literallayout></para></listitem> | ||
2695 | <listitem><para>In the dialog box that opens, select | ||
2696 | the 'Tracing | Tracing Project' wizard and | ||
2697 | press 'Next>'.</para></listitem> | ||
2698 | <listitem><para>Give the project a name and press | ||
2699 | 'Finish'. That should result in an entry in the | ||
2700 | 'Project' subwindow.</para></listitem> | ||
2701 | <listitem><para>In the 'Control' subwindow just below | ||
2702 | it, press 'New Connection'.</para></listitem> | ||
2703 | <listitem><para>Add a new connection, giving it the | ||
2704 | hostname or IP address of the target system. | ||
2705 | </para></listitem> | ||
2706 | <listitem><para>Provide the username and password | ||
2707 | of a qualified user (a member of the 'tracing' group) | ||
2708 | or root account on the target system. | ||
2709 | </para></listitem> | ||
2710 | <listitem><para>Provide appropriate answers to whatever | ||
2711 | else is asked for e.g. 'secure storage password' | ||
2712 | can be anything you want. | ||
2713 | If you get an 'RSE Error' it may be due to proxies. | ||
2714 | It may be possible to get around the problem by | ||
2715 | changing the following setting: | ||
2716 | <literallayout class='monospaced'> | ||
2717 | Window | Preferences | Network Connections | ||
2718 | </literallayout> | ||
2719 | Switch 'Active Provider' to 'Direct' | ||
2720 | </para></listitem> | ||
2721 | </orderedlist> | ||
2722 | </para> | ||
2723 | </section> | ||
2724 | </section> | 2553 | </section> |
2725 | 2554 | ||
2726 | <section id='lltng-documentation'> | 2555 | <section id='lltng-documentation'> |
@@ -2742,15 +2571,6 @@ | |||
2742 | You can find a "Getting Started" link on this site that takes | 2571 | You can find a "Getting Started" link on this site that takes |
2743 | you to an LTTng Quick Start. | 2572 | you to an LTTng Quick Start. |
2744 | </para> | 2573 | </para> |
2745 | |||
2746 | <para> | ||
2747 | Finally, you can access extensive help information on how to use | ||
2748 | the LTTng plug-in to search and analyze captured traces via the | ||
2749 | Eclipse help system: | ||
2750 | <literallayout class='monospaced'> | ||
2751 | Help | Help Contents | LTTng Plug-in User Guide | ||
2752 | </literallayout> | ||
2753 | </para> | ||
2754 | </section> | 2574 | </section> |
2755 | </section> | 2575 | </section> |
2756 | 2576 | ||