diff options
38 files changed, 415 insertions, 364 deletions
diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html index 69fe051be2..37b65b0756 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html @@ -32,9 +32,9 @@ <h1 id="SystemTap_Graphing">SystemTap Graphing</h1> <h2 id="Getting_Started_2">Getting Started</h2> <h3 id="Introduction">Introduction</h3> - <p>TWhen a SystemTap script is launched under a Run Configuration with the + <p>When a SystemTap script is launched under a Run Configuration with the <b>Graph the output of this script run</b> option enabled, it is possible to plot its output in graph form. (If you are unfamiliar with how to load or write a SystemTap script, please review the - <a href="SystemTap-IDE.html#IDE_Tutorial">IDE Tutorial</a> in the SystemTap IDE User's Guide.) A variety of graph types are available for plotting the output of Systemtap scripts: + <a href="SystemTap-IDE.html#IDE_Tutorial">IDE Tutorial</a> in the SystemTap IDE User's Guide.) A variety of graph types are available for plotting the output of SystemTap scripts: </p> <ul> <li> @@ -64,9 +64,10 @@ <b>Run As -> Run Configurations...</b> and view the configuration you created earlier. If not, follow that tutorial now, and return here when you have finished. </p> <p>Once the Run Configuration menu is opened with your configuration selected, click on the - <b>Graphing</b> tab. At the bottom of the window, a section labelled + <b>Graphing</b> tab. At the bottom of the window, a section labeled <b>Graph Set #</b> displays a list of all graphs created for the currently-selected - <b>Regular Expression</b> (the # in "Graph Set #" indicates which expression is chosen). There is also a set of buttons related to graph configuration: + <b>Regular Expression</b> (the # in + <b>Graph Set #</b> indicates which expression is chosen). There is also a set of buttons related to graph configuration: </p> <ul> <li> @@ -110,41 +111,42 @@ <b>Y Series 0</b> - The class of data that will provide the graph's Y series data, relative to the X axis. A capturing group from your regular expression must be used for this. </li> <li> - <b>Y Series 1, 2, 3</b>... - If you have included more than one capturing group in your regular expression, you may choose to provide your graph with multiple Y series data, each of which will be plotted relative to the same X series axis you specified earlier. They will appear as a seperate set of data points on your graph, labelled by title. When you do not want to include any extra Y series values, choose + <b>Y Series 1, 2, 3</b>... - If you have included more than one capturing group in your regular expression, you may choose to provide your graph with multiple Y series data, each of which will be plotted relative to the same X series axis you specified earlier. They will appear as a separate set of data points on your graph, labeled by title. When you do not want to include any extra Y series values, choose <b>NA</b>. </li> </ul> <p>Note that two different series may not share the same data selection.</p> <h2 id="Concepts_2">Concepts</h2> <h3 id="Data_Table">Data Table</h3> - <p>The Data Table is a view that is always available when running a script with the chart option. It intitially starts empty and populates as it recieves information parsed from the console originally from the script. The Data Table is a visualization of the data structure that every other graph type spawns from.</p> + <p>The Data Table is a view that is always available when running a script with the chart option. It initially starts empty and populates as it recieves information parsed from the console originally from the script. The Data Table is a visualization of the data structure that every other graph type spawns from.</p> <p> - <img border="0" src="images/SystemtapGraphDataView.png"/> + <img border="0" src="images/SystemtapGraphDataView.png"/> </p> - <p>The columns of the Data Table can be resized at will by dragging the seperation lines between column headers. In addition, the information in the data table can be - <a href="#Importing_a_Data_Set">saved and loaded</a> without having to re-run the script. Furthermore, the user can populate the Data Table without having to run a script if a script's output has been saved into a file, see - <a href="#Opening_Script_Output">Opening Script Output</a>.Right clicking the Data Table provides a menu with the following options: + <p>The columns of the Data Table can be resized at will by dragging the separation lines between column headers, as long as the + <b>Auto resize columns</b> option (in Preferences->SystemTap->Graphing->Data Table) has been deactivated. In addition, the information in the data table can be + <a href="#Importing_a_Data_Set">saved and loaded</a> without having to re-run the script. Furthermore, the user can populate the Data Table without having to run a script if a script's output has been saved into a file; see + <a href="#Opening_Script_Output">Opening Script Output</a>. Right clicking the Data Table provides a menu with the following options: </p> <ul> <li> - <b>Format as...</b> - Depending on which column the user right clicked, this allows the user to format that column's data as one of the following: + <b>Format as...</b> - Depending on which column the user right clicked, this allows the user to format that column's data as one of the following: <ul> - <li>Unformated - No formating is applied. </li> - <li>String </li> - <li>Date </li> - <li>Double </li> - <li>Hex </li> - <li>Octal </li> - <li>Binary </li> + <li>Unformatted - No formatting is applied.</li> + <li>String</li> + <li>Date</li> + <li>Double</li> + <li>Hex</li> + <li>Octal</li> + <li>Binary</li> </ul> </li> <li> <b>Add Filter...</b> - Adds a - <a href="#Filters">filter</a> to the Data Table. + <a href="#Filters">filter</a> to the Data Table. </li> <li> <b>Remove Filter...</b> - Removes a - <a href="#Filters">filter</a> from the Data Table. + <a href="#Filters">filter</a> from the Data Table. </li> <li> <b>Manually Resize</b> - Allows the user to resize column width without bouncing back to the minimum based on the largest value. @@ -156,48 +158,39 @@ <a href="#Create_Graph_Wizard">Create Graph</a> wizard once the Data Table is populated. The Graphing Perspective can support multiple graphs from one Data Table. Each are updated and can be viewed by navigating through the tabs shown at the top of each Graph Set while in the Graph Selector View. </p> <h4 id="Scatter_Graph">Scatter Graph</h4> - <p>A Scatter Graph uses Cartesian coordinates to show the relation of two or more quantitative variables.</p> - <p>Creating a Scatter Graph will prompt the user for three values. The first is the title and is fully cosmetic. The option to turn on and off the title is given to the user, and its off by default. The second option is X Series; here you select which series of data you want to plot along the X Axis. The third option is the Y Series; here you select which series of data you want to plot along the Y Axis. - Optionally you can add extra Y Series; here you select another series of data you want to plot along the Y Axis.</p> + <p>A Scatter Graph uses Cartesian coordinates to show the relation of two or more quantitative variables. All values must be numeric.</p> <p> <img border="0" src="images/Scatter.png"/> </p> <h4 id="Line_Graph">Line Graph</h4> - <p>The Line Graph is traditionally ideal for horozontally depicting non-cumulative data over, say, time.</p> - <p>Creating a Line Graph will prompt the user for three values. The first is the title and is fully cosmetic. The option to turn on and off the title is given to the user, and its off by default. The second option is X Series; here you select which series of data you want to plot along the X Axis. The third option is the Y Series; here you select which series of data you want to plot along the Y Axis. - Optionally you can add extra Y Series; here you select another series of data you want to plot along the Y Axis.</p> + <p>The Line Graph is traditionally ideal for horizontally depicting non-cumulative data over, say, time. All values must be numeric.</p> <p> <img border="0" src="images/Line.png"/> </p> <h4 id="Area_Graph">Area Graph</h4> - <p>The Area Graph is traditionally ideal for horozontally depicting non-cumulative data over, say, time.</p> - <p>Creating an Area Graph will prompt the user for three values. The first is the title and is fully cosmetic. The option to turn on and off the title is given to the user, and its off by default. The second option is X Series; here you select which series of data you want to plot along the X Axis. The third option is the Y Series; here you select which series of data you want to plot along the Y Axis. - Optionally you can add extra Y Series; here you select another series of data you want to plot along the Y Axis.</p> + <p>The Area Graph is traditionally ideal for horizontally depicting non-cumulative data over, say, time. All values must be numeric.</p> <p> <img border="0" src="images/Area.png"/> </p> <h4 id="Bar_Graph">Bar Graph</h4> - <p>The Bar Graph typically uses bars to show frequencies or values. </p> - <p>Creating a Bar Graph will prompt the user for three values. The first is the title and is fully cosmetic. The option to turn on and off the title is given to the user, and its off by default. The second option is X Series; here you select which series of data you want to plot along the X Axis. The third option is the Y Series; here you select which series of data you want to plot along the Y Axis. - Optionally you can add extra Y Series; here you select another series of data you want to plot along the Y Axis.</p> + <p>The Bar Graph typically uses bars to show frequencies or values. Labels can be given to bars by applying string values to the x-axis. Y-axis values, though, must be numeric.</p> <p> <img border="0" src="images/Bar.png"/> </p> <h4 id="Pie_Graph">Pie Graph</h4> - <p>The Pie Graph uses a pie to show percentages.</p> - <p>Creating a Pie Graph will prompt the user for three values. The first is the title and is fully cosmetic. The option to turn on and off the title is given to the user, and its off by default. The second option is X Series; here you select the series to be used as labels of each area of the pie chart. The third option is the Y Series; here you select which series of data will be used to calculate the percentages of each area of the pie chart. Optionally you can add extra Y Series, each of which will draw another Pie containing that series' data.</p> + <p>The Pie Graph uses a pie to show percentages. One pie is drawn for each data series provided. Titles can be given to slices by applying string values to the x-axis. Y-axis values, though, must be numeric.</p> <p> <img border="0" src="images/Pie.png"/> </p> <h3 id="Filters">Filters</h3> - <p>Filters are screens that you can set on your Data Table to limit the quantity of samples you wish to work with. Filters are very often used in restricting the sheer amount of information available to make data tables and graphs more substantial to people.</p> + <p>Filters are screens that you can set on your Data Table to limit the quantity of samples you wish to work with. Filters are very often used in restricting the sheer amount of information available to make data tables and graphs more substantial and manageable.</p> <p>The following options exist to work with Filters in the Data Table:</p> <ul> <li> - <b>Add Filter...</b> - Adds a Filter to the Data Table. + <b>Add Filter...</b> - Adds a Filter to the Data Table. Multiple filters may be applied at a time. </li> <li> - <b>Remove Filter...</b> - Removes a Filter from the Data Table. + <b>Remove Filter...</b> - Removes a Filter from the Data Table. All currently applied filters will be listed in a drop-down menu; the user may select which of them to remove. </li> </ul> <p>When you select @@ -206,13 +199,15 @@ <p> <img border="0" src="images/StapDataFilters.png"/> </p> - <p>What follows is a breakdown of each Filter type:</p> + <p>What follows is a breakdown of each Filter type, and an example of how each affects this sample data set:</p> + <p> + <img border="0" src="images/UnfilteredDataset.png"/> + </p> <ul> <li> - <b>Match Filter</b> - This filter removes everything from the data set where the selected column's + <b>Match Filter</b> - This filter either removes or keeps everything from the data set where the selected selected column's value matches the chosen value. </li> </ul> - <p>value does not match the chosen value.</p> <p> <img border="0" src="images/Match.png"/> </p> @@ -222,10 +217,9 @@ </p> <ul> <li> - <b>Range Filter</b> - This filter removes everything from the data set that is not included in the + <b>Range Filter</b> - This filter keeps everything from the data set that is either inside or outside the selected range of values. Note that it is possible to use unbounded ranges by leaving either the lower or upper bound blank. </li> </ul> - <p>selected range of values.</p> <p> <img border="0" src="images/Range.png"/> </p> @@ -278,25 +272,71 @@ </li> </ul> <h3 id="Graph_Interaction">Graph Interaction</h3> + <h4 id="Graph_Options">Graph Options</h4> <p>Each of the - <a href="#Data_Graph_Types">Graph Types</a> have similar options that can be used in the Graphical - Perspective: + <a href="#Data_Graph_Types">Graph Types</a> have similar options that can be used in the Graph Selector View: </p> <ul> <li> - <b>Zoom Bar</b> - The graph types that use axes (Scatter, Line, Area, and Bar graphs) support this control. This enables the user to reduce the number of X-axis values that are plotted on the graph, to effectively zoom in and out on the graph's display. Sliding the bar left reduces the range of the X-axis that is plotted (zoom in), and sliding right increases it (zoom out). + <b>Legend</b> - This option turns on and off the legend, particularly useful in the graph types that show multiple series. + </li> + <li> + <b>Graph Scrolling/Scaling</b> - It is possible to zoom & scroll through any graph axis. Different controls are provided for navigating through continuous and discrete axes. </li> </ul> <p> - <img border="0" src="images/ZoomX.png"/> + <img border="0" src="images/GraphNavBefore.png"/> + </p> + <p>To zoom in/out of a continuous axis (ie Scatter/Line/Area Graph), use the +/- buttons or the Scale bar beneath / to the left of a graph. To scroll through the viewing area, use the horizontal/vertical scroll bars provided.</p> + <p> + <img border="0" src="images/GraphNavAfter.png"/> + </p> + <p>Specialized controls are available for zooming & scrolling through discrete axis, namely the bars of a Bar Graph or the pies of a Pie Chart.</p> + <p> + <img border="0" src="images/BarNavBefore.png"/> + </p> + <p>Zooming is performed with the + <b>Zoom In/Out</b> buttons beneath the graph. To scroll to left or right, click + <b><</b> or + <b>></b> respectively. To jump to the beginning or end of the axis, click + <b><<</b> or + <b>>></b> respectively. + </p> + <p> + <img border="0" src="images/BarNavAfter.png"/> </p> <p>Use <a href="SystemTap-IDE.html#Preferences">Preferences</a> to configure other graph settings, such as grid lines and viewable data items. </p> + <h4 id="Graph_Coordinate_Tooltips">Graph Coordinate Tooltips</h4> + <p>Hover over any data point on a graph to display detailed information about that point's coordinates. This feature is available for all graph types.</p> + <p> + <img border="0" src="images/LineChartTooltip.png"/> + </p> + <h2 id="Graphing_Tasks">Graphing Tasks</h2> + <h3 id="Importing.2FExporting_Data_Sets">Importing/Exporting Data Sets</h3> + <p>A data set is comprised of the contents of a Graph Set's data table. From time to time the user may want to preserve this data for continued work at a later date/time or to share findings with others. The Importing and Exporting options provide an easy way to do this.</p> + <p>To save a data set, click the + <b>Export Data Set</b> toolbar button while viewing one of the tabs of the Graph Set data that is to be saved (either the Data Table or one of its graphs). To load & display a previously-exported data set, use the + <b>Import Data Set</b> toolbar button, which is available at all times. + </p> + <p> + <img border="0" src="images/DataSetImportExport.png"/> + <i>The Data Set toolbar buttons that appear while viewing a Graph Set. (Blue/left: Export. Red/Right: Import.)</i> + </p> + <p> + <img border="0" src="images/DataSetImportOnly.png"/> + <i>The Import Data Set button as it appears while a Graph Set is not being viewed.</i> + </p> + <p>In either case, a file dialog will appear to allow the user to choose the path on the filesystem where the data set should be exported to / imported from.</p> + <h3 id="Saving_a_Graph_Image">Saving a Graph Image</h3> + <p>It is possible to save graphs as image files. To do so, view the graph that is to be saved and click the + <b>Save Graph</b> button that appears in the toolbar. This opens a dialogue box where the user can navigate to the location they desire to save the image file. + </p> + <p> + <img border="0" src="images/SaveStapGraphButton.png"/> + </p> <h2 id="Reference_2">Reference</h2> - <p>This section of the Graphing User Guide is intended to provide the following resources should you have any - very specific questions regarding the graphing in general or one of the options associated with - it. It also contains example scripts and FAQs.</p> <h3 id="Frequently_Asked_Questions_2">Frequently Asked Questions</h3> <p>This section details frequently asked questions relating to graphing script output.</p> <p> @@ -304,7 +344,7 @@ </p> <p>A: Yes and yes. In the Run Configuration of the script you want to create plots of, you can create multiple graphs at once. Also, after a graph-enabled script is run, you may create several additional graphs by clicking the Graph Wizard button in the Graph Selector View.</p> <p> - <b>Can I increase the rate at which SystemTap GUI update the graph?</b> + <b>Can I increase the rate at which graphs are updated?</b> </p> <p>A: Yes. By default it is set to once per second, but you can increase this in <a href="SystemTap-IDE.html#Preferences">Preferences</a>. @@ -312,11 +352,16 @@ <p> <b>Is there any way to save or export the graph images?</b> </p> - <p>A: Currently, no. This feature will be restored in a newer version of Systemtap IDE.</p> + <p>A: Yes. A + <b>Save Graph</b> button appears in the toolbar whenever you are viewing a graph. Clicking it will allow you to save the graph currently in focus. + </p> <p> <b>What if I want to preserve this data for manipulation later?</b> </p> - <p>A: This feature will be restored in a newer version of Systemtap IDE.</p><hr/> + <p>A: While viewing a Data Table or one of the graphs it provides data to, the + <b>Export Data Set</b> toolbar button is available. Click this button to save the focused Data Table's contents into a .set file. Such files can be loaded back later with the + <b>Import Data Set</b> button on the toolbar (which is always available). + </p><hr/> <table class="navigation" style="width: 100%;" border="0" summary="navigation"> <tr> <td style="width: 20%" align="left"> diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html index 63816d718d..ca589e508d 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html @@ -33,77 +33,73 @@ <h2 id="Getting_Started">Getting Started</h2> <h3 id="IDE_Tutorial">IDE Tutorial</h3> <h4 id="Lesson_1:_Getting_Started">Lesson 1: Getting Started</h4> - <p>In this tutorial we will orient you with the Systemtap IDE and its functions. At this point we assume - that you are able to run Systemtap plug-in and are unfamiliar with how to proceed. If you cannot yet start + <p>In this tutorial we will orient you with the SystemTap IDE and its functions. At this point we assume + that you are able to run SystemTap plug-in and are unfamiliar with how to proceed. If you cannot yet start the application, please refer to our <a href="#Installation">Installation help page</a>. - <b>NOTE:</b> If this is your the first time opening the Systemtap IDE, it will take a while to load as it has to parse the tapsets. + <b>NOTE:</b> If this is your the first time opening the SystemTap IDE, it will take a while to load as it has to parse the tapsets. </p> - <p>The Systemtap IDE's purpose is to allow the user to create, view, and edit Systemtap scripts. There are - other editors built in (plain text and the C editor), however, they ultimately exist to facilitate the - writing of Systemtap scripts.</p> - <p>In this lesson we will open a new Systemtap script file to familiarize ourselves with the Systemtap IDE. - If you don't already have a project you plan to put your new script in start by creating a new one. + <p>The SystemTap IDE's purpose is to allow the user to create, view, and edit SystemTap scripts. There are + other editors built in (plain text and the C editor), however, they ultimately exist to facilitate the writing of SystemTap scripts.</p> + <p>In this lesson we will open a new SystemTap script file to familiarize ourselves with the SystemTap IDE. + If you don't already have a project you plan to put your new script in, start by creating a new one. Select the <u>F</u>ile menu -> New -> Project -> General -> Project. Follow the wizard to create a new project.</p> - <p>Now you are ready to create the script. Select File -> New -> Other -> Systemtap -> Systemtap Script. Follow the wizard to provide your script name and the project which will contain it (Use the project we created above).</p> + <p>Now you are ready to create the script. Select File -> New -> Other -> SystemTap -> SystemTap Script. Follow the wizard to provide your script name and the project which will contain it (use the project we created above).</p> <p>This should open up a new editor with a small stub of a script.</p> <p>At this point proceed to - <a href="#Lesson_2:_Writing_Your_First_Script">Lesson 2: Writing Your First Script</a> if you wish to learn how to write your - own script file or + <a href="#Lesson_2:_Writing_Your_First_Script">Lesson 2: Writing Your First Script</a> if you wish to learn how to write your own script file or <a href="#Lesson_3:_Running_Your_Script">Lesson 3: Running Your Script</a> if you wish to run this one. </p> <h4 id="Lesson_2:_Writing_Your_First_Script">Lesson 2: Writing Your First Script</h4> - <p>In this tutorial we will guide you through the process of writing your first Systemtap script. It is strongly recommended that you review the - <b>Systemtap website's tutorial</b> - - <a href="http://sourceware.org/systemtap/tutorial">http://sourceware.org/systemtap/tutorial</a> for up-to-date information on the latest version of Systemtap. + <p>In this tutorial we will guide you through the process of writing your first SystemTap script. It is strongly recommended that you review the + <b>SystemTap website's tutorial</b> - + <a href="http://sourceware.org/systemtap/tutorial">http://sourceware.org/systemtap/tutorial</a> for up-to-date information on the latest version of SystemTap. </p> - <p>In the previous lesson we created a new script and opened it in the editor. </p> + <p>In the previous lesson we created a new script and opened it in the editor.</p> <p> - <img border="0" src="images/Newfile.png"/> + <img border="0" src="images/Newfile.png"/> </p> - <p>Now try writing a new script or type/copy the following example: </p> - <pre> - global read, write, start + <p>Now try writing a new script or type/copy the following example:</p> + <pre>global read, write, start - probe begin { - start = gettimeofday_s() - } - probe syscall.write { - write += count - } +probe begin { + start = gettimeofday_s() +} - probe timer.ms(1000) { - printf("%d\t%d\t%d\n", (gettimeofday_s()-start), read, write) - read=0 - write=0 - } +probe syscall.write { + write += count +} + +probe timer.ms(1000) { + printf("%d\t%d\t%d\n", (gettimeofday_s()-start), read, write) + read=0 + write=0 +} </pre> - <p> - Now to demonstrate the functionality of the Probe Alias browser we will have you complete the read probe yourself. Start by opening the syscall folder in the Probe Alias browser. If you do not have any content in the browser you are experiencing a problem with Systemtap installation and should refer to our - <a href="#Installation">Installation help page</a>. Ensure your cursor is located at the end of the file. Now scroll down and double click the read probe alias. Systemtap GUI will insert the skeleton probe at the point at which your cursor is at, and should look similar to the following: + <p>Now to demonstrate the functionality of the Probe Alias browser we will have you complete the read probe yourself. Start by opening the syscall folder in the Probe Alias browser. If you do not have any content in the browser, you are experiencing a problem with SystemTap installation and should refer to our + <a href="#Installation">Installation help page</a>. Now search for the "syscall.read" probe alias and double click it. SystemTap IDE will insert the skeleton probe at the end of your script, and should look similar to the following: </p> <pre>probe syscall.read { /* * available variables on this probe: - * argstr, buf_uaddr, count, fd, name + * $buf:long int, $count:long int, $fd:long int, $ret:long int, + * argstr:string, buf_uaddr:long, count:long, fd:long, name:string */ } </pre> - <p> - Now insert the following line into the syscall.read probe: </p> + <p>Now insert the following line into the syscall.read probe:</p> <pre>read += count </pre> - <p> - You may remove the comment (/* ... */) if you wish This will count the number of bytes read and written each second and print it out. The begin probe executes first, by getting the time of day. The read and write probes increment each time the function is called. The timer probe prints the information every second. If you typed the script in manually you may have noticed that the editor provides code completion for probe alias. If you did not, type "syscall.". You'll see a box come up that you may use to select an item to complete your probe alias. </p> - <p>Another way to get assistance while writing a new probe is to press CTRL+Space at any point during editing. Doing so will provide autocompletion for partially spelled probe names, what variables and functions are available inside a probe and documentation where available. </p> + <p>You may remove the comment (/* ... */) if you wish. This will count the number of bytes read and written each second and print it out. The begin probe executes first, by getting the time of day. The read and write probes increment each time the function is called. The timer probe prints the information every second.</p> + <p>Another way to get assistance while writing a new probe is to press Ctrl+Space at any point during editing. Doing so will provide auto-completion for partially spelled probe names, what variables and functions are available inside a probe, and documentation where available.</p> <p> - <img border="0" src="images/ContextAssist.png"/> + <img border="0" src="images/ContextAssist.png"/> </p> <p>In - <a href="#Lesson_3:_Running_Your_Script">Lesson 3</a> you will learn how to run Systemtap scripts in the IDE Perspective. + <a href="#Lesson_3:_Running_Your_Script">Lesson 3</a> you will learn how to run SystemTap scripts. </p> <h4 id="Lesson_3:_Running_Your_Script">Lesson 3: Running Your Script</h4> <p>In this lesson we will cover running your script. You may use either the script you wrote in Lesson two or write a new one.</p> @@ -117,7 +113,7 @@ <b>Run Configuration</b> - For more control over running options, you can use a Run Configuration. To run a script with an existing Run Configuration, open the script file you want to run, then do any of the following: <ul> <li>right-click on the script editor or the script file in the Project Explorer, and select - <b>Run As->Systemtap Script</b> + <b>Run As->SystemTap Script</b> </li> <li>click on the <img border="0" src="images/Run_exc.gif"/> @@ -125,7 +121,7 @@ </li> <li>select either <b>Run->Run</b> or - <b>Run->Run As->Systemtap Script</b> on the menu bar + <b>Run->Run As->SystemTap Script</b> on the menu bar </li> <li>press Ctrl+F11 on the keyboard</li> </ul> @@ -143,50 +139,57 @@ <img border="0" src="images/RunConfigDropDown.png"/> </p> <p>To create a new Run Configuration, right-click on the script editor or the script file in the Project Explorer then select - <b>Run As -> Run Configurations...</b>. Once the dialogue pops up double click on the SystemTap tree item and you should be presented with the following dialogue: + <b>Run As -> Run Configurations...</b>. Once the dialogue pops up, double click on the SystemTap tree item and you should be presented with the following dialogue: </p> <p> <img border="0" src="images/SystemTapRunConfiguration.png"/> </p> - <p>Here you can specify the path of the script to run, enter remote host information, run as a different user, as well as various other options for running systemtap. Explore the various tabs and options. The tooltips should provide help in understanding what the various options do. When you are ready click Run to run your script.</p> - <p>Now we will demonstrate running Systemtap scripts with graphs. In order to run the chart example you'll need to use the code provided in + <p>Here you can specify the path of the script to run, enter remote host information, run as a different user, as well as various other options for running SystemTap. Explore the various tabs and options. The tooltips should provide help in understanding what the various options do. When you are ready, click Run to run your script.</p> + <p>Now we will demonstrate running SystemTap scripts with graphs. In order to run the chart example you'll need to use the code provided in <a href="#Lesson_2:_Writing_Your_First_Script">Lesson 2: Writing Your First Script</a>: </p> - <pre> global read, write, start -</pre> - <pre> probe begin { - start = gettimeofday_s() - } -</pre> - <pre> probe syscall.write { - write += count - } -</pre> - <pre> probe syscall.read { - read += count - } -</pre> - <pre> probe timer.ms(1000) { - printf("%d\t%d\t%d\n", (gettimeofday_s()-start), read, write) - read=0 - write=0 - } + <pre>global read, write, start + +probe begin { + start = gettimeofday_s() +} + +probe syscall.write { + write += count +} + +probe syscall.read { + read += count +} + +probe timer.ms(1000) { + printf("%d\t%d\t%d\n", (gettimeofday_s()-start), read, write) + read=0 + write=0 +} </pre> - <p>To do this select - <b>Run As -> Run Configurations...</b> and create a new SystemTap Launch Configuration as you did previously and switch to the graphing tab. + <p>To do this, select + <b>Run As -> Run Configurations...</b> and create a new SystemTap Launch Configuration as you did previously and switch to the Graphing tab. By the end of this tutorial, the tab will look like this: </p> <p> <img border="0" src="images/GraphingTab.png"/> </p> - <p>Select - <b>Graph the output of this script run</b>, and in the text box labelled + <p>The following instructions will walk you through the steps towards configuring the graph settings as shown above.</p> + <p>First, select + <b>Graph the output of this script run</b>, and in the text box labeled <b>Regular Expression</b>, enter a regular expression that will match the output of your script. Place parentheses () around whatever data you want to capture for graphing. </p> <p>For this example, enter the following as your <b>Regular Expression</b>: </p> - <pre> (\d+)\t(\d+)\t(\d+) + <pre>(\d+)\t(\d+)\t(\d+) </pre> + <p>Alternatively, you can click the button labeled + <b>Click here to generate regular expressions from printf statements.</b> Clicking this button will automatically create regular expressions that will capture output created by the script's printf statements. + </p> + <p> + <img border="0" src="images/AutoGraphAfter.png"/> + </p> <p>This expression will capture the output produced by the example script. Note that in order to capture data from script output, the output must be formatted into lines/rows. Output-parsing regular expressions try to match individual lines of script output, so make sure your scripts print a line break ("\n") to mark the end of a line. (The line break character does not need to be included in the regular expression.)</p> <p>Once this expression is entered, a table of <b>Title</b>s and @@ -196,15 +199,14 @@ <p>For this example, copy and paste the following line into the <b>Sample Output</b> box: </p> - <pre> 10 1000 100 + <pre>10 1000 100 </pre> <p>and enter the following as <b>Titles</b>: </p> - <pre> - Time - Read - Write + <pre>Time +Reads +Writes </pre> <p>The text boxes displayed under <b>Sample Extracted Value</b> now show you the values that are captured by your regular expression, which will be plotted in any graphs you create that use those values. @@ -215,14 +217,13 @@ <b>Graph Type</b>, and enter the following as your Title and series values, then click <b>Finish</b> to save your changes: </p> - <pre> - Title: Read Write Count - X Series: Time - Y Series 0: Read - Y Series 1: Write + <pre>Title: Read Write Count +X Series: Time +Y Series 0: Reads +Y Series 1: Writes </pre> <p>You may also specify additional regular expressions to capture output with. To do this, either press the Down arrow key while typing into the - <b>Regular Expression</b> text box, or click the drop-down arrow of the text box and click the entry labelled + <b>Regular Expression</b> text box, or click the drop-down arrow of the text box and click the entry labeled <b>New Regular Expression...</b> </p> <p> @@ -230,10 +231,10 @@ </p> <p>You will notice that all data entered in the Graphing menu so far, such as the sample output and graphs, will no longer visible after adding a new regular expression. This is because each regular expression has its own sample output, column titles, and set of graphs (or Graph Set) associated with it. Data for the currently-selected expression is displayed, and since the current expression is blank, so are the column & graph settings.</p> <p>To capture the example script's output only at intervals of 10 units of time, use the line below as your second regular expression:</p> - <pre> (\d+0)\t(\d+)\t(\d+) + <pre>(\d+0)\t(\d+)\t(\d+) </pre> <p>Enter the same sample output & title values that were used for the first regular expression. Also add a graph with the same series data as before, and with a title of "Decade Read Write Counts".</p> - <p>When the script is executed under this Run Configuration, the Graph Selector view is opened and it will contain a Data View and any graphs you have created, with a tab for each regular expression's set of graphs. The Data View chart is populated with the output from the console. If you click on the tab labelled + <p>When the script is executed under this Run Configuration, the Graph Selector view is opened and it will contain a Data View and any graphs you have created, with a tab for each regular expression's set of graphs. The Data View chart is populated with the output from the console. If you click on the tab labeled <b>Graph Set 1</b>, you should see a screen similar to the following: </p> <p> @@ -250,17 +251,16 @@ <b>Create Graph</b> button, which appears to the left of the Data View tab. This will bring up the same <a href="SystemTap-Graphing.html#Create_Graph_Wizard">Create Graph</a> wizard that appears when creating a graph in a script's Run Configurations menu. </p> - <p>Those are the basics behind running a script in Systemtap GUI.</p> <h2 id="Concepts">Concepts</h2> <h3 id="SystemTap_IDE_Perspective">SystemTap IDE Perspective</h3> <p>This is the primary perspective for SystemTap script writers. It contains the <a href="#Function_Browser">Function Browser</a>, <a href="#Kernel_Browser">Kernel Browser</a>, <a href="#Probe_Alias_Browser">Probe Alias Browser</a>, and - <a href="#Views_and_Editors">Views and Editors</a>. The IDE Perspective contains the features necessary execute SystemTap scripts and the syntax highlighting and code completion features that facilitate efficient development of scripts. + <a href="#Views_and_Editors">Views and Editors</a>. The IDE Perspective contains the features necessary execute SystemTap scripts and the syntax coloring and code completion features that facilitate efficient development of scripts. </p> <h3 id="STP_Editor">STP Editor</h3> - <p>This editor is the most commonly used; it is used for the authoring and editing of Systemtap scripts. It is invoked when the user starts a new file or opens a file with the .stp extension. It provides syntax highlighting, code completion, and run support.</p> + <p>This editor is the most commonly used; it is used for the authoring and editing of SystemTap scripts. It is invoked when the user starts a new file or opens a file with the .stp extension. It provides syntax highlighting, code completion, and run support.</p> <p> <img border="0" src="images/Editor.png"/> </p> @@ -271,7 +271,7 @@ <a href="#Toolbars">Toolbars</a> </p> <h3 id="Function_Browser">Function Browser</h3> - <p>The Funtion Browser lists all of the functions that are defined in the tapset library. Functions are grouped by the file that they are defined. Each listed function has an icon that corresponds to its return type.</p> + <p>The Function Browser lists all of the functions that are defined in the tapset library. Functions are grouped by the file that they are defined. Each listed function has an icon that corresponds to its return type.</p> <ul> <li> <img border="0" src="images/Var_str.gif"/> String @@ -282,8 +282,13 @@ <li> <img border="0" src="images/Var_void.gif"/> Void </li> + <li> + <img border="0" src="images/Var_unk.gif"/> Unknown + </li> </ul> - <p>If you double click on any function a call to that function will be added to the active editor at the current cursor location. Also if you right click on a function and click "View Definition" the tapset file where the function is defined will be opened.</p> + <p>If you double click on any function a call to that function will be added to the active editor at the current cursor location. Also if you right click on a function and click + <b>View Definition</b> the tapset file where the function is defined will be opened. + </p> <p> <img border="0" src="images/Function.png"/> </p> @@ -291,27 +296,32 @@ <i>Use remote connection to load SystemTap probes and functions</i> option. Don't forget to configure the remote server used by remote execution in SystemTap->Remote Server. </p> <h3 id="Kernel_Browser">Kernel Browser</h3> - <p>The Kernel Source Browser is used to display the kernel tree. This provides you with a quick way to locate places to add probes. Any file in the Kernel Source tree can be opened by double clicking on it. This will open up the selected file in the Editor view. You can then double click on the ruler next to any line that you wish to probe. If SystemTap can probe that line a probe point will be inserted at the end of the script you were most recently working on. If the line can't be probed, an error message will be displayed. </p> + <p>The Kernel Source Browser is used to display the kernel tree. This provides you with a quick way to locate places to add probes. Any file in the Kernel Source tree can be opened by double clicking on it. This will open up the selected file in the Editor view. You can then double click on the ruler next to any line that you wish to probe. If SystemTap can probe that line a probe point will be inserted at the end of the script you were most recently working on. If the line can't be probed, an error message will be displayed.</p> <p> <img border="0" src="images/KernelSource.png"/> </p> <p>To use this feature it is necessary to configure the - <a href="http://wiki.eclipse.org/Linux_Tools_Project/Systemtap/User_Guide#Kernel_Source_Location">Kernel Source Location</a>. + <a href="http://wiki.eclipse.org/Linux_Tools_Project/SystemTap/User_Guide#Kernel_Source_Location">Kernel Source Location</a>. </p> <h3 id="Probe_Alias_Browser">Probe Alias Browser</h3> - <p>The Probe Alias Browser lists all of the probe aliases that are defined in the tapset library. Probes are grouped based on their type. In addition to the list of probes, each probe lists all of the variables that it has access to. Each variable is listed with an icon that represents its type. Types are as follows: </p> + <p>The Probe Alias Browser lists all of the probe aliases that are defined in the tapset library, as well as all static probes defined internally by SystemTap. Probes are grouped by name. In addition to the list of probes, each probe lists all of the variables that it has access to. Each variable is listed with an icon that represents its data type. Types are as follows:</p> <ul> <li> - <img border="0" src="images/Var_str.gif"/> String + <img border="0" src="images/Var_str.gif"/> String </li> <li> - <img border="0" src="images/Var_long.gif"/> Long + <img border="0" src="images/Var_long.gif"/> Long + </li> + <li> + <img border="0" src="images/Var_struct.gif"/> Struct </li> <li> <img border="0" src="images/Var_unk.gif"/> Unknown </li> </ul> - <p>If you double click on any probe alias, probe point will be added to the end of the active editor. Also if you right click on a probe and click "View Definition" the tapset file where the probe is defined will be opened. </p> + <p>If you double click on any probe alias, probe point will be added to the end of the active editor. Also if you right click on a probe and click + <b>View Definition</b> the tapset file where the probe is defined will be opened. + </p> <p> <img border="0" src="images/ProbeAlias.png"/> </p> @@ -321,39 +331,72 @@ <h2 id="Tasks">Tasks</h2> <h3 id="Creating_SystemTap_Scripts">Creating SystemTap Scripts</h3> <p>Create a SystemTap script by selecting - <b>File -> New -> Other... -> Systemtap -> Systemtap Script</b> from the menu bar. You'll be prompted to enter a name for the file; + <b>File -> New -> Other... -> SystemTap -> SystemTap Script</b> from the menu bar. You'll be prompted to enter a name for the file; <i>make sure that you use a .stp extension or else the SystemTap IDE will not recognize the file as a SystemTap script and certain editor and run features will not be active.</i> </p> <p>Your new file will be open and ready for coding in the Editor pane.</p> <p>A <a href="#IDE_Tutorial">IDE Tutorial</a> is also provided in the help pages for a step by step demo. </p> - <p>For advanced SystemTap langauge help please see the SystemTap Development User's Guide and the documentation available at the SystemTap website's documentation page - + <p>For advanced SystemTap language help please see the SystemTap Development User's Guide and the documentation available at the SystemTap website's documentation page - <a href="http://sourceware.org/systemtap/documentation.html">http://sourceware.org/systemtap/documentation.html</a> </p> <h3 id="Using_the_STP_Editor">Using the STP Editor</h3> - <p>The STP Editor is used for the authoring and editing of Systemtap scripts. It is invoked when the user starts a new file or opens a file with the .stp extension. Using the editor is as easy as setting the focus to the editor pane and typing.</p> + <p>The STP Editor is used for the authoring and editing of SystemTap scripts. It is invoked when the user starts a new file or opens a file with the .stp extension. Using the editor is as easy as setting the focus to the editor pane and typing.</p> <p> <img border="0" src="images/Editor.png"/> </p> <p>There are certain features within the editor you may want to take advantage of:</p> <ul> - <li>Syntax Highlighting - Certain code items are colored in .stp and .c files based on a set of rules and colors. You can turn this on or off and change the colors in - <b><u>W</u>indow-><u>P</u>references</b>. - </li> - <li>Code Assist - SystemTap GUI will attempt to finish your probe alias names based on what you have already typed. You can then select the appropriate probe alias or continue typing to filter the list down even more. You can turn this feature on and off or set the speed on it in - <b><u>W</u>indow-><u>P</u>references</b>. - </li> + <li>Syntax Highlighting - Certain code items are colored in .stp and .c files based on a set of rules and colors.</li> + <li>Code Assist - SystemTap IDE will attempt to finish your probe alias names based on what you have already typed. You can then select the appropriate probe alias or continue typing to filter the list down even more.</li> <li>Run Support - See the - <a href="#Lesson_3:_Running_Your_Script">Lesson 3: Running Your Script</a> help page on a walk through use of the Run command. The Run command allows scripts to be executed directly through SystemTap GUI. + <a href="#Lesson_3:_Running_Your_Script">Lesson 3: Running Your Script</a> help page on a walk through use of the Run command. The Run command allows scripts to be executed directly through SystemTap IDE. </li> </ul> <p>See also: <a href="#Menus">Menus</a>, - <a href="#Toolbars">Toolbars</a>, <a href="#Example_SystemTap_Scripts">Example SystemTap Scripts</a> </p> + <h3 id="Creating_Run_Configurations">Creating Run Configurations</h3> + <p>Advanced options for running SystemTap scripts are available in the + <b>Run Configurations</b> menu. This menu may be accessed by right-clicking a script and choosing + <b>Run As->Run Configurations</b> from the context menu, by selecting + <b>Run->Run Configurations</b> in the menu bar, or by using the drop-down menu next to the + <img border="0" src="images/Run_exc.gif"/> + <b>Run</b> toolbar button. + </p> + <h4 id="Local.2FRemote_Runs">Local/Remote Runs</h4> + <p>It is possible to run scripts either locally or remotely, and as different users. To configure these settings, use the + <b>General</b> tab of the Run Configurations menu. + </p> + <p>The following options are available:</p> + <ul> + <li> + <b>Execute script as current user</b> - Uncheck this box to run the script as a different user. While unchecked, you may enter the + <b>User Name</b> and + <b>Password</b> of the user you wish to run the script as. + </li> + <li> + <b>Run script on localhost</b> - Uncheck this box to run the script on a remote machine. Type the name of the desired host to use in + <b>Host Name</b>. (This option is only available when running as a non-current user.) + </li> + <li> + <b>Use default port</b> - When unchecked, you may specify the port that is to be used for remote communication. The default port is 22. (This option is only available when running on a non-local host.) + </li> + </ul> + <h4 id="SystemTap_Options">SystemTap Options</h4> + <p>The + <b>SystemTap</b> tab allows for the specification of many command-line options to the stap command that is to be run. View the SystemTap manual for information on these options - + <a href="https://sourceware.org/systemtap/man/stap.1.html">https://sourceware.org/systemtap/man/stap.1.html</a> + </p> + <h4 id="Graphing">Graphing</h4> + <p>Many options and features are available in the + <b>Graphing</b> tab for creating graphs out of a script's output. For detailed information on how to create graphs, refer to + <a href="#Lesson_3:_Running_Your_Script">Lesson 3: Running Your Script</a> and the + <a href="SystemTap-Graphing.html#Graphing_Tutorial">Graphing Tutorial</a>. + </p> <h3 id="Viewing_Data_Charts">Viewing Data Charts</h3> <p>Viewing data charts from a SystemTap script is accomplished by running that script with the Run Configurations containing your graphs. This is covered in <a href="#Lesson_3:_Running_Your_Script">Lesson 3: Running Your Script</a>. After running a script with the graphing option, the user is presented with the Graph Selector View, and the last graph of the final Graph Set is loaded by default. When that view appears, click on the Data View tab of any Graph Set to see it begin populating as it receives input back through the console from the running SystemTap script. @@ -363,16 +406,16 @@ </p> <h2 id="Reference">Reference</h2> <h3 id="Views_and_Editors">Views and Editors</h3> - <p>This section details the views and editor in relation to the Systemtap IDE.</p> + <p>This section details the views and editor in relation to the SystemTap IDE.</p> <h4 id="Views">Views</h4> <p>The IDE Perspective consists of 5 views and and two editors.</p> <ul> <li> - <b>Probe Alias Browser</b> - A list of all probe aliases currently available in your version of Systemtap. Covered in detail + <b>Probe Alias Browser</b> - A list of all probe aliases currently available in your version of SystemTap and all active tapsets. Covered in detail <a href="#Probe_Alias_Browser">here</a>. </li> <li> - <b>Function Browser</b> - A list of functions currently supported in your version of Systemtap. Covered in detail + <b>Function Browser</b> - A list of functions currently supported in your version of SystemTap and all active tapsets. Covered in detail <a href="#Function_Browser">here</a>. </li> <li> @@ -380,8 +423,9 @@ <a href="#Kernel_Browser">here</a>. </li> <li> - <b>Console</b> - The console view is where all of the output from the running script is shown. If more then one script is running at the same time you are able to switch between which console is currently displayed by clicking on the "Display Selected Console" button. The script can halt execution here if the user selects the - <b>Stop</b> button. The user also has the option of saving the console output to a file, which can be done by clicking the + <b>Console</b> - The console view is where all of the output from the running script is shown. If more then one script is running at the same time you are able to switch between which console is currently displayed by clicking on the + <b>Display Selected Console</b> button. The script can halt execution here if the user selects the + <b>Stop</b> button. The user also has the option of saving the console output to a file, which can be done while the script is running by clicking the <b>Save log output</b> button at the top of the console. </li> </ul> @@ -390,17 +434,17 @@ </p> <ul> <li> - <b>Error Log</b> - If the script you tried to run contained errors, this view will become active and display the errors. You can double click on the eror message to jump to the line in the file where the error occured. + <b>Error Log</b> - If the script you tried to run contained errors, this view will become active and display the errors. You can double click on the error message to jump to the line in the file where the error occurred. </li> </ul> <p> <img border="0" src="images/ErrorLog.png"/> </p> <h4 id="Editors">Editors</h4> - <p>Three editors are available in the Systemtap IDE.</p> + <p>Three editors are available in the SystemTap IDE.</p> <ul> <li> - <b>STP Editor</b> - This editor is the most commonly used; it is used for the authoring and editing of Systemtap scripts. It is invoked when the user starts a new file or opens a file with the .stp extension. It provides syntax highlighting, code completion, and run support. + <b>STP Editor</b> - This editor is the most commonly used; it is used for the authoring and editing of SystemTap scripts. It is invoked when the user starts a new file or opens a file with the .stp extension. It provides syntax highlighting, code completion, and run support. </li> <li> <b>C Editor</b> - This editor is available for the read only viewing of kernel source. It is invoked when the user opens a file of extension .c. Syntax highlighting is supported in this mode. @@ -410,26 +454,26 @@ </li> </ul> <h3 id="Menus">Menus</h3> - <p>What follows is a comprehension list of the menu options available within the Systemtap IDE.</p> + <p>What follows is a comprehension list of the menu options available within the SystemTap IDE.</p> <h4 id="Edit">Edit</h4> <ul> <li> - <b><u>U</u>ndo</b> - Undos the previous editor related action. (Shortcut: Ctrl+Z) + <b><u>U</u>ndo</b> - Undos the previous editor related action. (Shortcut: Ctrl+Z) </li> <li> - <b><u>R</u>edo</b> - Redos the previous editor related action removed by Undo. (Shortcut: Ctrl+Y) + <b><u>R</u>edo</b> - Redos the previous editor related action removed by Undo. (Shortcut: Ctrl+Y) </li> <li> - <b>Cu<u>t</u></b> - Removes the selected text from the editor pane and places it in the clipboard. (Shortcut: Shift+Delete, Ctrl+X) + <b>Cu<u>t</u></b> - Removes the selected text from the editor pane and places it in the clipboard. (Shortcut: Shift+Delete, Ctrl+X) </li> <li> - <b><u>C</u>opy</b> - Copies the selected text from the editor pane and places it in the clipboard. (Shortcut: Ctrl+Insert, Ctrl+C) + <b><u>C</u>opy</b> - Copies the selected text from the editor pane and places it in the clipboard. (Shortcut: Ctrl+Insert, Ctrl+C) </li> <li> - <b><u>P</u>aste</b> - Copies the text from the clipboard to the location of the focus in the editor pane. (Shortcut: Shift+Insert, Ctrl+V) + <b><u>P</u>aste</b> - Copies the text from the clipboard to the location of the focus in the editor pane. (Shortcut: Shift+Insert, Ctrl+V) </li> <li> - <b>Select <u>A</u>ll</b> - Selects all text within the file in the editor that the focus is currently in. (Shortcut: Ctrl+A) + <b>Select <u>A</u>ll</b> - Selects all text within the file in the editor that the focus is currently in. (Shortcut: Ctrl+A) </li> <li> <b><u>F</u>ind/Replace</b> - Opens the Find/Replace dialogue in which users may specify a text string to find and/or replace, with options to search forwards or backwards, the entire document or just the selected lines, and whether or not they want the following options: @@ -457,7 +501,9 @@ <b><u>I</u>ncremental Find Next</b> - Finds the next occurrence of the text and updates the selection after each character typed. To use Incremental Find: <ul> <li>In the text (or Java) editor, press Ctrl+J or select Edit > Incremental Find Next from the menu bar.</li> - <li>The workbench status line displays "Incremental Find:". The editor is now in the Incremental Find mode.</li> + <li>The workbench status line displays + <b>Incremental Find:</b>. The editor is now in the Incremental Find mode. + </li> <li>As you type, the editor finds the next occurrence of the text and updates the selection after each character typed.</li> <li>Navigate to the next or previous match by pressing Arrow Down or Arrow Up.</li> <li>Undo the last action within the Incremental Find mode by pressing Backspace.</li> @@ -495,7 +541,7 @@ <h4 id="Run">Run</h4> <ul> <li> - <b><u>R</u>un</b> -Available when a Systemtap script is loaded into the editor, this feature runs the script. You will be prompted to run the script either locally, or on a remote machine running the systemtapgui server. If run locally and multiple Run Configurations exist for the script, you will be prompted to choose which of them to run. (Shortcut: Ctrl+F11) + <b><u>R</u>un</b> - Available when a SystemTap script is loaded into the editor, this feature runs the script. You will be prompted to run the script either locally or on a remote machine. If run locally and multiple Run Configurations exist for the script, you will be prompted to choose which of them to run. (Shortcut: Ctrl+F11) </li> </ul> <p> @@ -509,7 +555,7 @@ <li> <b><u>O</u>pen Perspective</b> - This submenu lists each of the available perspectives to open: <ul> - <li>Systemtap IDE</li> + <li>SystemTap IDE</li> <li>Other... - Lists all other perspectives available to Eclipse.</li> </ul> </li> @@ -520,7 +566,7 @@ <li>Functions</li> <li>Kernel Source</li> <li>Probe Alias</li> - <li>Systemtap Error Log</li> + <li>SystemTap Error Log</li> <li>Other... - Lists all views in the application.</li> </ul> </li> @@ -534,11 +580,11 @@ <ul> <li> <img border="0" src="images/New_wiz.gif"/> - <b>New File</b> - This button will bring up a dialogue to create a new file. When you click ok the file will be opened in the editor window. + <b>New File</b> - This button will bring up a dialogue to create a new file. When you click OK the file will be opened in the editor window. </li> <li> <img border="0" src="images/Run_exc.gif"/> - <b>Simple Run</b> - This will compile the open script and start running it, without using a Run Configuration. All output will be sent to the console. If there is an error in the script the error will be reported in the ErrorLog. + <b>Simple Run</b> - This will compile the open script and start running it, without using a Run Configuration. All output will be sent to the console. If there is an error in the script the error will be reported in the Error Log. </li> <li> <img border="0" src="images/Run_exc.gif"/> @@ -566,13 +612,13 @@ <b>Graphing</b> - Preferences related to the Graphing Perspective. <ul> <li> - <b><u>R</u>efresh Delay (ms)</b> - Milliseconds in between re-painting the graph. + <b><u>R</u>efresh Delay (ms)</b> - Milliseconds between graphs are updated with the latest data. </li> <li> <b>Data Table</b> - Preferences related to the data table. <ul> <li><u>J</u>ump to the newest entry - Determines whether the scroll bar maintains its location at the newest entry.</li> - <li><u>A</u>uto resize columns - Determines whether columns automatically resize to the width of the contents or whether they remain placed when moved.</li> + <li><u>A</u>uto resize columns - Determines whether columns automatically resize to the width of the contents or whether they can be adjusted by the user.</li> <li><u>M</u>ax data items - Maximum number of entries that the table shows, though the table itself may have more not visible.</li> </ul> </li> @@ -582,7 +628,7 @@ <li><u>S</u>how X/Y grid lines - Turns on and off painting of the grid lines for either axis.</li> <li><u>M</u>ax data items - Number of maximum samples read from a script's output.</li> <li><u>V</u>iewable data items - Number of maximum samples plotted at any time.</li> - <li><u>X</u>/<u>Y</u> series ticks - Specify the number of labelled number markers on either axis.</li> + <li><u>X</u>/<u>Y</u> series ticks - Specify the number of labeled number markers on either axis.</li> </ul> </li> </ul> @@ -591,49 +637,17 @@ <b>IDE</b> - Preferences when loading the IDE Perspective. <ul> <li> - <b>Use stored tapset trees</b> - Loads the stored tapset trees on initialization. + <b>Use stored tapset trees</b> - If checked, the next initialization of SystemTap IDE will load all tapset contents (probes & functions) from a local configuration file instead of having to search for them manually. This configuration file is saved whenever changes to tapsets are made while this box is checked, or when it is checked for the first time. </li> <li> - <b>Editor</b> - Preferences related to the editor. - <ul> - <li><u>E</u>ditor Background Color - Sets the color painted in the background of the editor pane.</li> - <li>Show Line <u>N</u>umbers - Option to turn on and off line numbers in the editor pane.</li> - <li>Code Assist - <ul> - <li><u>U</u>se Code Assist - Turns on and off the option to use Code Assist, which is a method that predicts what you are typing based on existing probe alias and opens a window that allows you to scroll down and select and/or continue typing for refined results.</li> - <li>How Code Assist adds code - Method used in Code Assist. - <ul> - <li><u>I</u>nsert - Inserts the selected text directly into the cursor point.</li> - <li><u>O</u>verwrite - Overwrites as you type.</li> - </ul> - </li> - <li>Activation <u>D</u>elay (requires restart) - Delay in milliseconds before the code assist routines attempts to run.</li> - <li>Activation <u>T</u>rigger - This is the key that actives Code Assist. For SystemTap GUI it is set to the divider between tapset and probe alias.</li> - </ul> - </li> - <li>Syntax Coloring - These options assign color values to identified types within the .stp and .c editors. - <ul> - <li>STP editor - <ul> - <li><u>D</u>efault Color - Color of normal code.</li> - <li><u>K</u>eyword Color - Color of keywords.</li> - <li><u>E</u>mbedded C Color - Color of embedded C code.</li> - <li><u>E</u>mbedded Color - Color of embedded code.</li> - <li><u>C</u>omment Color - Color of comments.</li> - <li><u>T</u>ype Color - Color of items identified as types.</li> - <li><u>S</u>tring Color - Color of strings.</li> - </ul> - </li> - </ul> - </li> - </ul> + <b>Use remote connection to load SystemTap probes and functions</b> - If checked, tapset contents (probes & functions) will be loaded from a remote machine (specified in Remote Server) instead of the local machine. </li> <li> - <b>Kernel Source Path</b> - Location of the directory that the kernel source code is pulled from. + <b>Kernel Source Path</b> - Location of the directory that the kernel source code is pulled from. A local or remote machine may be used. <ul> <li>Tapsets - Preferences related to tapsets. <ul> - <li><u>A</u>dditional Tapsets - Allows you to specify additional tapsets scripts to be added in with every script.</li> + <li><u>A</u>dditional Tapsets - Allows you to specify additional tapsets scripts to be added in with every script, and to be displayed in the Function and Probe Alias Browsers.</li> </ul> </li> </ul> @@ -641,22 +655,19 @@ </ul> </li> <li> - <b>Remote Server</b> - Details regarding the remote machine running the systemtapgui Server + <b>Remote Server</b> - Details regarding running SystemTap on a remote machine. Any operations that run SystemTap on a remote machine will use the one specified by the credentials provided here. <ul> <li> - <b>Host Name</b> - IP address of the remote machine + <b>Host Name</b> - IP address of the remote machine. </li> <li> <b>Port</b> - Port used for communication. Default is 22462. </li> <li> - <b>User Name</b> - User name that has sufficient permissions to transfer and run the script on the remote machine. - </li> - <li> - <b>Password</b> - Password for the above user. + <b>User Name</b> - User name that has sufficient permissions to transfer and run the script on the remote machine. </li> <li> - <b>Seconds to Save Data</b> + <b>Password</b> - Password for the above user. </li> </ul> </li> @@ -666,9 +677,9 @@ <h3 id="Frequently_Asked_Questions">Frequently Asked Questions</h3> <p>This section details frequently asked questions relating to the IDE Perspective.</p> <p> - <b>Where can I find information regarding the Systemtap scripting language?</b> + <b>Where can I find information regarding the SystemTap scripting language?</b> </p> - <p>A: The best place to look for up to date information regarding Systemtap itself is its homepage - + <p>A: The best place to look for up to date information regarding SystemTap itself is its homepage - <a href="http://sourceware.org/systemtap/documentation.html">http://sourceware.org/systemtap/documentation.html</a> </p> <p> @@ -681,15 +692,14 @@ </p> <p>Read <a href="#Lesson_3:_Running_Your_Script">Lesson 3: Running Your Script</a> and - <a href="#Menus">Menus</a> to learn more about the ways of running Systemtap scripts. + <a href="#Menus">Menus</a> to learn more about the ways of running SystemTap scripts. </p> <p> - <b>Why does the application seem to hang when switching to the Systemtap IDE?</b> + <b>Why does the application seem to hang when switching to the SystemTap IDE?</b> </p> - <p>A: If this is the first time you are trying to open the Systemtap IDE, or have recently gotten a new version of SystemTap this is expected. In order to generate a full list of all of the available probes, and functions the GUI has to run the stap command. If there are tapsets that do not run correctly using the 'stap -up2' comamnd this takes a long time. In order to build as complete a list as possible it will use a binary filtering algorithm to figure out which tapset function is broken and generate data for all of the others.</p> + <p>A: If this is the first time you are trying to open the SystemTap IDE, or have recently gotten a new version of SystemTap this is expected. In order to generate a full list of all of the available probes and functions, the GUI has to run a background SystemTap process and parse the results. A future update to SystemTap IDE will reduce the duration of this operation.</p> <h3 id="Example_SystemTap_Scripts">Example SystemTap Scripts</h3> - <p>What follows is a few SystemTap Scripts that you may use in SystemTap GUI, taken from and linked to - + <p>What follows is a few SystemTap Scripts that you may use in SystemTap IDE, taken from and linked to <a href="http://sourceware.org/systemtap/documentation.html">http://sourceware.org/systemtap/documentation.html</a> </p> <p>There is also a description of the examples - @@ -699,9 +709,9 @@ <a href="http://sourceware.org/systemtap/examples/top.stp">http://sourceware.org/systemtap/examples/top.stp</a>) </h4> <pre> -#!/usr/bin/env stap +#!/usr/bin/env stap # -# This script continuously lists the top 20 systemcalls on the system +# This script continuously lists the top 20 system calls on the system # global syscalls @@ -734,7 +744,7 @@ probe timer.ms(5000) { # This is an example of profiling a specific command or pid. # It works by recording the time when a system call is entered -# exited. +# exited. # Usage: prof.stp -c "top -n5" # Will start up "top" and after 5 iterations, will exit. @@ -760,7 +770,7 @@ probe kernel.function("sys_*").return { probe end { printf("\n") foreach (x in ttime) - printf("%-20s\tcalls:%6d\tavg time (ms):%5d\ttotal(ms):%7d\n", + printf("%-20s\tcalls:%6d\tavg time (ms):%5d\ttotal(ms):%7d\n", x, @count(ttime[x]), @avg(ttime[x]), @sum(ttime[x])) } @@ -773,7 +783,7 @@ global calltime, ttime #! /usr/bin/env stap # This is not useful, but it demonstrates that -# Systemtap can modify variables in a running kernel. +# SystemTap can modify variables in a running kernel. # Usage: ./keyhack.stp -g @@ -796,7 +806,7 @@ probe end { global kmalloc -probe kernel.function("__kmalloc") { +probe kernel.function("__kmalloc") { kmalloc <<< $size } @@ -823,7 +833,7 @@ probe end { global kmalloc -probe kernel.function("__kmalloc") { +probe kernel.function("__kmalloc") { kmalloc[execname()] <<< $size } @@ -852,7 +862,7 @@ probe end { <pre> Summary of regular-expression constructs Construct Matches - + Characters x The character x \\ The backslash character @@ -868,7 +878,7 @@ x The character x \a The alert (bell) character ('\u0007') \e The escape character ('\u001B') \cx The control character corresponding to x - + Character classes [abc] a, b, or c (simple class) [^abc] Any character except a, b, or c (negation) @@ -877,7 +887,7 @@ Character classes [a-z&&[def]] d, e, or f (intersection) [a-z&&[^bc]] a through z, except for b and c: [ad-z] (subtraction) [a-z&&[^m-p]] a through z, and not m through p: [a-lq-z](subtraction) - + Predefined character classes . Any character (may or may not match line terminators) \d A digit: [0-9] @@ -886,7 +896,7 @@ Predefined character classes \S A non-whitespace character: [^\s] \w A word character: [a-zA-Z_0-9] \W A non-word character: [^\w] - + POSIX character classes (US-ASCII only) \p{Lower} A lower-case alphabetic character: [a-z] \p{Upper} An upper-case alphabetic character:[A-Z] @@ -901,20 +911,20 @@ POSIX character classes (US-ASCII only) \p{Cntrl} A control character: [\x00-\x1F\x7F] \p{XDigit} A hexadecimal digit: [0-9a-fA-F] \p{Space} A whitespace character: [ \t\n\x0B\f\r] - + java.lang.Character classes (simple java character type) \p{javaLowerCase} Equivalent to java.lang.Character.isLowerCase() \p{javaUpperCase} Equivalent to java.lang.Character.isUpperCase() \p{javaWhitespace} Equivalent to java.lang.Character.isWhitespace() \p{javaMirrored} Equivalent to java.lang.Character.isMirrored() - + Classes for Unicode blocks and categories \p{InGreek} A character in the Greek block (simple block) \p{Lu} An uppercase letter (simple category) \p{Sc} A currency symbol \P{InGreek} Any character except one in the Greek block (negation) [\p{L}&&[^\p{Lu}]] Any letter except an uppercase letter (subtraction) - + Boundary matchers ^ The beginning of a line $ The end of a line @@ -924,7 +934,7 @@ $ The end of a line \G The end of the previous match \Z The end of the input but for the final terminator, if any \z The end of the input - + Greedy quantifiers X? X, once or not at all X* X, zero or more times @@ -932,7 +942,7 @@ X+ X, one or more times X{n} X, exactly n times X{n,} X, at least n times X{n,m} X, at least n but not more than m times - + Reluctant quantifiers X?? X, once or not at all X*? X, zero or more times @@ -940,7 +950,7 @@ X+? X, one or more times X{n}? X, exactly n times X{n,}? X, at least n times X{n,m}? X, at least n but not more than m times - + Possessive quantifiers X?+ X, once or not at all X*+ X, zero or more times @@ -948,20 +958,20 @@ X++ X, one or more times X{n}+ X, exactly n times X{n,}+ X, at least n times X{n,m}+ X, at least n but not more than m times - + Logical operators XY X followed by Y X|Y Either X or Y (X) X, as a capturing group - + Back references \n Whatever the nth capturing group matched - + Quotation \ Nothing, but quotes the following character \Q Nothing, but quotes all characters until \E \E Nothing, but ends quoting started by \Q - + Special constructs (non-capturing) (?:X) X, as a non-capturing group (?idmsux-idmsux) Nothing, but turns match flags on - off @@ -970,7 +980,7 @@ Special constructs (non-capturing) (?!X) X, via zero-width negative lookahead (?<=X) X, via zero-width positive lookbehind (?<!X) X, via zero-width negative lookbehind -(?>X) X, as an independent, non-capturing group +(?>X) X, as an independent, non-capturing group Match a position that is not a word boundary. </pre> <p>Information regarding regular expressions can be found all over the Internet. A few examples have been listed diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/Updating-This-Document.html b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/Updating-This-Document.html index 83189efddd..5589b5a6e5 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/Updating-This-Document.html +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/Updating-This-Document.html @@ -26,10 +26,9 @@ </tr> </table><hr/> <h1 id="Updating_This_Document">Updating This Document</h1> - <p> This document is maintained in a collaborative wiki. If you wish to update or modify this document please visit - - <a href="http://wiki.eclipse.org/Linux_Tools_Project/SystemTap/User_Guide">http://wiki.eclipse.org/Linux_Tools_Project/SystemTap/User_Guide</a> . - </p><hr/> + <pre> This document is maintained in a collaborative wiki. If you wish to update or modify this document please visit + <a href="http://wiki.eclipse.org/Linux_Tools_Project/SystemTap/User_Guide">http://wiki.eclipse.org/Linux_Tools_Project/SystemTap/User_Guide</a> . +</pre><hr/> <table class="navigation" style="width: 100%;" border="0" summary="navigation"> <tr> <td style="width: 20%" align="left"> diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html index 27ff2ea826..f0bedd65ec 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html @@ -28,11 +28,11 @@ <h1 id="Overview">Overview</h1> <p>Welcome to the SystemTap plug-in Help pages. This section is intended to provide users with information and links about the SystemTap scripting language itself, in addition to a brief introduction to SystemTap plug-in's structure for new users and a brief explanation of SystemTap.</p> <h2 id="The_SystemTap_Plugin">The SystemTap Plugin</h2> - <p>The SystemTap Plugin is designed to help you create, edit, and run Systemtap scripts. It also provides the ability to graph the output of your scripts and run Systemtap scripts remotely.</p> + <p>The SystemTap Plugin is designed to help you create, edit, and run SystemTap scripts. It also provides the ability to graph the output of your scripts and run SystemTap scripts remotely.</p> <p>It provides the - <b>SystemTap IDE</b> perspective. When in this perspective you should be able to see the Probe view, the Function view, and the Project Explorer. You should also be able to create Systemtap Scripts. + <b>SystemTap IDE</b> perspective. When in this perspective you should be able to see the Probe view, the Function view, and the Project Explorer. You should also be able to create SystemTap scripts. </p> - <h2 id="Systemtap">Systemtap</h2> + <h2 id="SystemTap">SystemTap</h2> <p>SystemTap provides free software (GPL) infrastructure to simplify the gathering of information about the running Linux kernel. This assists diagnosis of a performance or functional problem. SystemTap eliminates the need for the developer to go through the tedious and disruptive instrument, recompile, install, and reboot sequence that may be otherwise required to collect data.</p> <p>SystemTap provides a simple command line interface and scripting language for writing instrumentation for a live running kernel. The internal tapset library as well as the published samples can be used to aid reuse and abstraction.</p> <p>Current project members include Red Hat, IBM, Intel, and Hitachi.</p> @@ -45,7 +45,7 @@ <li>x86, x86_64, ppc64, s390</li> </ul> <p> - <b>Sotware Requirements:</b> + <b>Software Requirements:</b> </p> <ul> <li>Linux kernel v2.6.14 or newer @@ -56,26 +56,22 @@ <li>Eclipse v3.8/v4.2 or newer</li> <li>SystemTap v0.7 or newer</li> </ul> - <p>Once all dependencies are installed, the easiest way to install the SystemTap plug-in for Eclipse is through the + <p>Once all dependencies are installed, the easiest way to install the SystemTap plug-in for Eclipse is through the <b> <i>Software Updates and Add-ons</i> </b> menu. For information on how to use this menu, refer to <a href="http://wiki.eclipse.org/Linux_Tools_Project/PluginInstallHelp#Installing_Updates_From_the_Linux_Tools_Update_Site">this link</a>. </p> <h3 id="Kernel_Source_Location">Kernel Source Location</h3> - <p>In order to use the kernel source browser you'll need to point it to the kernel source initially. Do this by either selecting the Kernel Source Browser in the browser pane or by going to + <p>In order to use the kernel source browser, you will need to point it to the kernel source initially. SystemTap IDE will be set with a default kernel source path by default, but it may be necessary to set it manually. Do this by either selecting the Kernel Source Browser in the browser pane or by going to <b><u>W</u>indow-><u>P</u>references</b>, then going to the SystemTap->IDE->'Kernel Source Path' tab. It is possible to explore the kernel source in your local machine or in the same machine used to run SystemTap scripts. Enter your option and inform the kernel source location. If you selected the remote option, it is necessary to set up the remote machine information at SystemTap->'Remote Server' tab. </p> <h3 id="Tutorials">Tutorials</h3> <p>If you haven't already, you will want to take the IDE and Graphing tutorials. You can find them in the Getting Started section of each perspective's help pages. These tutorial provides fundamental knowledge on graphing in SystemTap plug-in.</p> <h3 id="Preferences_.28Optional.29">Preferences (Optional)</h3> - <p>Finally, you may want to set certain non-essential preferences before using SystemTap plug-in regularly. Use - - <b><u>W</u>indow-><u>P</u>references</b> to access the Preferences page. + <p>Finally, you may want to set certain non-essential preferences before using SystemTap plug-in regularly. Use + <b><u>W</u>indow-><u>P</u>references</b> to access the Preferences page. </p> - <p>Of particular note are - Logging->Log To, SystemTap->Environment Variables, SystemTap->Graphing->Refresh Delay, - SystemTap->IDE->Editor->Syntax Coloring.</p> <h2 id="Links_to_SystemTap_Resources">Links to SystemTap Resources</h2> <p>The following links contain information specific to the SystemTap scripting language.</p> <ul> @@ -95,17 +91,6 @@ <b>Full list of documentation</b> - <a href="http://sourceware.org/systemtap/documentation.html">http://sourceware.org/systemtap/documentation.html</a> </li> - </ul> - <p>The following links are related to the SystemTap GUI project:</p> - <ul> - <li> - <b>SystemTap GUI Sourceforge</b> - - <a href="https://sourceforge.net/projects/stapgui/">https://sourceforge.net/projects/stapgui/</a> - </li> - <li> - <b>SystemTap GUI Homepage</b> - - <a href="http://stapgui.sourceforge.net/">http://stapgui.sourceforge.net/</a> - </li> </ul><hr/> <table class="navigation" style="width: 100%;" border="0" summary="navigation"> <tr> diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Area.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Area.png Binary files differindex 065392cb7a..60aed7a9c6 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Area.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Area.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/AutoGraphAfter.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/AutoGraphAfter.png Binary files differnew file mode 100644 index 0000000000..59ca608908 --- /dev/null +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/AutoGraphAfter.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Bar.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Bar.png Binary files differindex 7233480eed..2ae7ad39b5 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Bar.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Bar.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/BarNavAfter.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/BarNavAfter.png Binary files differnew file mode 100644 index 0000000000..508bb307e7 --- /dev/null +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/BarNavAfter.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/BarNavBefore.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/BarNavBefore.png Binary files differnew file mode 100644 index 0000000000..be968d1551 --- /dev/null +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/BarNavBefore.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/DataSetImportExport.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/DataSetImportExport.png Binary files differnew file mode 100644 index 0000000000..7f11bfc680 --- /dev/null +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/DataSetImportExport.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/DataSetImportOnly.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/DataSetImportOnly.png Binary files differnew file mode 100644 index 0000000000..57402d9ed7 --- /dev/null +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/DataSetImportOnly.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Editor.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Editor.png Binary files differindex 4c4bf216c9..b73567dfba 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Editor.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Editor.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/ErrorLog.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/ErrorLog.png Binary files differindex 25823b052d..51313e4a32 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/ErrorLog.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/ErrorLog.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Function.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Function.png Binary files differindex dd0654514a..07d3001bf1 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Function.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Function.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/GraphNavAfter.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/GraphNavAfter.png Binary files differnew file mode 100644 index 0000000000..f178680569 --- /dev/null +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/GraphNavAfter.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/GraphNavBefore.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/GraphNavBefore.png Binary files differnew file mode 100644 index 0000000000..31d922aa5f --- /dev/null +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/GraphNavBefore.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/GraphingTab.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/GraphingTab.png Binary files differindex 82d0399dd2..6365976e16 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/GraphingTab.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/GraphingTab.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/IDEConsole.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/IDEConsole.png Binary files differindex 1a05212043..a23cdaf7bf 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/IDEConsole.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/IDEConsole.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/KernelSource.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/KernelSource.png Binary files differindex 6ac382ce64..bf7c5e43d3 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/KernelSource.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/KernelSource.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Line.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Line.png Binary files differindex dbdbfe36e9..d7964bdcb5 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Line.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Line.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/LineChartTooltip.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/LineChartTooltip.png Binary files differnew file mode 100644 index 0000000000..46e52049a1 --- /dev/null +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/LineChartTooltip.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Match.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Match.png Binary files differindex fcb5d4e91a..8410bb713a 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Match.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Match.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Match2.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Match2.png Binary files differindex fa636f875f..634848701e 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Match2.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Match2.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Newfile.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Newfile.png Binary files differindex 3d4735c96e..fa136dc82e 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Newfile.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Newfile.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Pie.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Pie.png Binary files differindex 5e06f58c6d..f456496872 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Pie.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Pie.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/ProbeAlias.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/ProbeAlias.png Binary files differindex 284d3a6c27..f8e4d596b8 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/ProbeAlias.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/ProbeAlias.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Range.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Range.png Binary files differindex 26d0eaaafb..f2d06700d6 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Range.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Range.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Range2.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Range2.png Binary files differindex 7bac7f86e5..2e115c1e31 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Range2.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Range2.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/SaveStapGraphButton.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/SaveStapGraphButton.png Binary files differnew file mode 100644 index 0000000000..dd6a382456 --- /dev/null +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/SaveStapGraphButton.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Scatter.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Scatter.png Binary files differindex 2ca45bb4da..7b3069ff4b 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Scatter.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Scatter.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Sort.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Sort.png Binary files differindex f07e646646..15383758a1 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Sort.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Sort.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Sort2.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Sort2.png Binary files differindex 9f29b1e59d..181b320e6a 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Sort2.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Sort2.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/SystemTapRunConfiguration.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/SystemTapRunConfiguration.png Binary files differindex fecb6389e0..113de7793f 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/SystemTapRunConfiguration.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/SystemTapRunConfiguration.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/SystemtapNewRegex.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/SystemtapNewRegex.png Binary files differindex fbacb04c32..72bf0ba3e4 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/SystemtapNewRegex.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/SystemtapNewRegex.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/UnfilteredDataset.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/UnfilteredDataset.png Binary files differnew file mode 100644 index 0000000000..01bbf15049 --- /dev/null +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/UnfilteredDataset.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Unique.png b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Unique.png Binary files differindex a1fda64c2f..4512e63a74 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Unique.png +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Unique.png diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Var_struct.gif b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Var_struct.gif Binary files differnew file mode 100644 index 0000000000..28d8326e56 --- /dev/null +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/Linux_Tools_Project/Systemtap/User_Guide/images/Var_struct.gif diff --git a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/toc.xml b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/toc.xml index d2283153a3..692291693c 100644 --- a/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/toc.xml +++ b/systemtap/org.eclipse.linuxtools.systemtap.ui.doc/toc.xml @@ -1,87 +1,99 @@ <?xml version='1.0' encoding='utf-8' ?> <toc topic="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html" label="SystemTap User Guide"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html" label="SystemTap User Guide"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html" label="Overview"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#The_SystemTap_Plugin" label="The SystemTap Plugin"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Systemtap" label="Systemtap"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Installing" label="Installing"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Requirements" label="Requirements"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Kernel_Source_Location" label="Kernel Source Location"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Tutorials" label="Tutorials"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Preferences_.28Optional.29" label="Preferences (Optional)"></topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Links_to_SystemTap_Resources" label="Links to SystemTap Resources"></topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html" label="SystemTap IDE"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Getting_Started" label="Getting Started"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#IDE_Tutorial" label="IDE Tutorial"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Lesson_1:_Getting_Started" label="Lesson 1: Getting Started"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Lesson_2:_Writing_Your_First_Script" label="Lesson 2: Writing Your First Script"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Lesson_3:_Running_Your_Script" label="Lesson 3: Running Your Script"></topic> - </topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Concepts" label="Concepts"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#SystemTap_IDE_Perspective" label="SystemTap IDE Perspective"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#STP_Editor" label="STP Editor"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Function_Browser" label="Function Browser"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Kernel_Browser" label="Kernel Browser"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Probe_Alias_Browser" label="Probe Alias Browser"></topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Tasks" label="Tasks"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Creating_SystemTap_Scripts" label="Creating SystemTap Scripts"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Using_the_STP_Editor" label="Using the STP Editor"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Viewing_Data_Charts" label="Viewing Data Charts"></topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Reference" label="Reference"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Views_and_Editors" label="Views and Editors"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Views" label="Views"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Editors" label="Editors"></topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Menus" label="Menus"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Edit" label="Edit"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Navigate" label="Navigate"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Run" label="Run"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Window" label="Window"></topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Toolbars" label="Toolbars"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Action_Bar" label="Action Bar"></topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Preferences" label="Preferences"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Frequently_Asked_Questions" label="Frequently Asked Questions"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Example_SystemTap_Scripts" label="Example SystemTap Scripts"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#top.stp_-_Prints_the_top_20_system_calls_.28http:.2F.2Fsourceware.org.2Fsystemtap.2Fexamples.2Ftop.stp.29" label="top.stp - Prints the top 20 system calls (http://sourceware.org/systemtap/examples/top.stp)"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#prof.stp_-_Simple_profiling_.28http:.2F.2Fsourceware.org.2Fsystemtap.2Fexamples.2Fprof.stp.29" label="prof.stp - Simple profiling (http://sourceware.org/systemtap/examples/prof.stp)"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#keyhack.stp_-_Modifying_variables_in_the_kernel._.28http:.2F.2Fsourceware.org.2Fsystemtap.2Fexamples.2Fkeyhack.stp.29" label="keyhack.stp - Modifying variables in the kernel. (http://sourceware.org/systemtap/examples/keyhack.stp)"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#kmalloc.stp_-_Statistics_example._.28http:.2F.2Fsourceware.org.2Fsystemtap.2Fexamples.2Fkmalloc.stp.29" label="kmalloc.stp - Statistics example. (http://sourceware.org/systemtap/examples/kmalloc.stp)"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#kmalloc2.stp_-_Example_using_arrays_of_statistics._.28http:.2F.2Fsourceware.org.2Fsystemtap.2Fexamples.2Fkmalloc2.stp.29" label="kmalloc2.stp - Example using arrays of statistics. (http://sourceware.org/systemtap/examples/kmalloc2.stp)"></topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Guide_to_Regular_Expressions" label="Guide to Regular Expressions"></topic> - </topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html" label="SystemTap Graphing"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Getting_Started_2" label="Getting Started"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Introduction" label="Introduction"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Graphing_Tutorial" label="Graphing Tutorial"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Create_Graph_Wizard" label="Create Graph Wizard"></topic> - </topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Concepts_2" label="Concepts"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Data_Table" label="Data Table"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Data_Graph_Types" label="Data Graph Types"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Scatter_Graph" label="Scatter Graph"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Line_Graph" label="Line Graph"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Area_Graph" label="Area Graph"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Bar_Graph" label="Bar Graph"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Pie_Graph" label="Pie Graph"></topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Filters" label="Filters"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Graph_Interaction" label="Graph Interaction"></topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Reference_2" label="Reference"> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Frequently_Asked_Questions_2" label="Frequently Asked Questions"></topic> - </topic> - </topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/Copyright-Information.html" label="Copyright Information"></topic> - <topic href="Linux_Tools_Project/Systemtap/User_Guide/Updating-This-Document.html" label="Updating This Document"></topic> - </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html" label="SystemTap User Guide"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html" label="Overview"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#The_SystemTap_Plugin" label="The SystemTap Plugin"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#SystemTap" label="SystemTap"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Installing" label="Installing"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Requirements" label="Requirements"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Kernel_Source_Location" label="Kernel Source Location"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Tutorials" label="Tutorials"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Preferences_.28Optional.29" label="Preferences (Optional)"></topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/User-Guide.html#Links_to_SystemTap_Resources" label="Links to SystemTap Resources"></topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html" label="SystemTap IDE"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Getting_Started" label="Getting Started"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#IDE_Tutorial" label="IDE Tutorial"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Lesson_1:_Getting_Started" label="Lesson 1: Getting Started"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Lesson_2:_Writing_Your_First_Script" label="Lesson 2: Writing Your First Script"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Lesson_3:_Running_Your_Script" label="Lesson 3: Running Your Script"></topic> + </topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Concepts" label="Concepts"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#SystemTap_IDE_Perspective" label="SystemTap IDE Perspective"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#STP_Editor" label="STP Editor"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Function_Browser" label="Function Browser"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Kernel_Browser" label="Kernel Browser"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Probe_Alias_Browser" label="Probe Alias Browser"></topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Tasks" label="Tasks"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Creating_SystemTap_Scripts" label="Creating SystemTap Scripts"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Using_the_STP_Editor" label="Using the STP Editor"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Creating_Run_Configurations" label="Creating Run Configurations"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Local.2FRemote_Runs" label="Local/Remote Runs"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#SystemTap_Options" label="SystemTap Options"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Graphing" label="Graphing"></topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Viewing_Data_Charts" label="Viewing Data Charts"></topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Reference" label="Reference"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Views_and_Editors" label="Views and Editors"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Views" label="Views"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Editors" label="Editors"></topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Menus" label="Menus"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Edit" label="Edit"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Navigate" label="Navigate"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Run" label="Run"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Window" label="Window"></topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Toolbars" label="Toolbars"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Action_Bar" label="Action Bar"></topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Preferences" label="Preferences"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Frequently_Asked_Questions" label="Frequently Asked Questions"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Example_SystemTap_Scripts" label="Example SystemTap Scripts"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#top.stp_-_Prints_the_top_20_system_calls_.28http:.2F.2Fsourceware.org.2Fsystemtap.2Fexamples.2Ftop.stp.29" label="top.stp - Prints the top 20 system calls (http://sourceware.org/systemtap/examples/top.stp)"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#prof.stp_-_Simple_profiling_.28http:.2F.2Fsourceware.org.2Fsystemtap.2Fexamples.2Fprof.stp.29" label="prof.stp - Simple profiling (http://sourceware.org/systemtap/examples/prof.stp)"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#keyhack.stp_-_Modifying_variables_in_the_kernel._.28http:.2F.2Fsourceware.org.2Fsystemtap.2Fexamples.2Fkeyhack.stp.29" label="keyhack.stp - Modifying variables in the kernel. (http://sourceware.org/systemtap/examples/keyhack.stp)"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#kmalloc.stp_-_Statistics_example._.28http:.2F.2Fsourceware.org.2Fsystemtap.2Fexamples.2Fkmalloc.stp.29" label="kmalloc.stp - Statistics example. (http://sourceware.org/systemtap/examples/kmalloc.stp)"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#kmalloc2.stp_-_Example_using_arrays_of_statistics._.28http:.2F.2Fsourceware.org.2Fsystemtap.2Fexamples.2Fkmalloc2.stp.29" label="kmalloc2.stp - Example using arrays of statistics. (http://sourceware.org/systemtap/examples/kmalloc2.stp)"></topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-IDE.html#Guide_to_Regular_Expressions" label="Guide to Regular Expressions"></topic> + </topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html" label="SystemTap Graphing"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Getting_Started_2" label="Getting Started"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Introduction" label="Introduction"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Graphing_Tutorial" label="Graphing Tutorial"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Create_Graph_Wizard" label="Create Graph Wizard"></topic> + </topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Concepts_2" label="Concepts"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Data_Table" label="Data Table"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Data_Graph_Types" label="Data Graph Types"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Scatter_Graph" label="Scatter Graph"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Line_Graph" label="Line Graph"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Area_Graph" label="Area Graph"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Bar_Graph" label="Bar Graph"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Pie_Graph" label="Pie Graph"></topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Filters" label="Filters"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Graph_Interaction" label="Graph Interaction"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Graph_Options" label="Graph Options"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Graph_Coordinate_Tooltips" label="Graph Coordinate Tooltips"></topic> + </topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Graphing_Tasks" label="Graphing Tasks"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Importing.2FExporting_Data_Sets" label="Importing/Exporting Data Sets"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Saving_a_Graph_Image" label="Saving a Graph Image"></topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Reference_2" label="Reference"> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/SystemTap-Graphing.html#Frequently_Asked_Questions_2" label="Frequently Asked Questions"></topic> + </topic> + </topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/Copyright-Information.html" label="Copyright Information"></topic> + <topic href="Linux_Tools_Project/Systemtap/User_Guide/Updating-This-Document.html" label="Updating This Document"></topic> + </topic> </toc>
\ No newline at end of file |
