Linux Tools Project/Systemtap/User Guide/graphing/preferences.html

Preferences

This section details each of the options listed under Window->Preferences. The Preferences dialog is the dialog used to set user preferences. The Preferences dialog pages can be searched using the filter function. To filter by matching the page title, simply type the name of the page you are seeking and the available pages will be presented below. The filter also searches on keywords such as appearance and java.

• Logging
  • Enable logging - This option turns on and off the ability to log data from the console.
  • Logging level - This dropdown box allows you to select one of our levels of logging.
    • Debug - A very large quantity of debug information, difficult to identify what you are looking for but extremely exhaustive.
    • Info - Displays most information regarding program execution; the default level.
    • Critical - Lists only critical errors duration execution.
    • Fatal - Lists only fatal errors during execution.
  • Log to - Specifies where you wish the logging to be written:
    • Console - Writes the debug information directly to the console.
    • File - Write the debug information to a file.
  • File - The location of the file that logging sends the debug information to.
• SystemTap - This section contains options relevent to SystemTap itself.
  • Remember window state - Preserves the state of the window on exitting SystemTap GUI.
  • Dashboard Preferences - Preferences relate to the Dashboard Perspective.
    • Additional Modules - Provides for the addition of more modules to the Dashboard. Modules are files containing a SystemTap script and associated metadata.
  • Environment Variables - Allows the user to set specific values to the following environment variables
    • LD_LIBRARY_PATH
    • PATH
    • SYSTEMTAP_TAPSET
    • SYSTEMTAP_RUNTIME
  • Graphing - Preferences related to the Graphing Perspective.
    • Refresh Delay (ms) - Milliseconds in between re-painting the graph.
    • Data Table - Preferences related to the data table.
      • Jump to the newest entry - Determines whether the scroll bar maintains its location at the newest entry.
      • Auto resize columns - Determines whether columns automatically resize to the width of the contents or whether they remain placed when moved.
      • Max data items - Maximum number of entries that the table shows, though the table itself may have more not visible.
    • Graph - Preferences related to graphs.
      • Show grid lines - Turns on and off painting of the grid lines.
      • Viewable data items - Number of maximum samples plotted at any time.
  • IDE - Preferences when loading the IDE Perspective.
    • Use stored tapset trees - Loads the stored tapset trees on initialization.
    • Editor - Preferences related to the editor.
      • Editor Background Color - Sets the color painted in the background of the editor pane.
      • Show Line Numbers - Option to turn on and off line numbers in the editor pane.
      • Code Assist
        • Use 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 aliasi and opens a window that allows you to scroll down and select and/or continue typing for refined results.
        • How Code Assist adds code - Method used in Code Assist.
          • Insert - Inserts the selected text directly into the cursor point.
          • Overwrite - Overwrites as you type.
        • Activation Delay (requires restart) - Delay in milliseconds before the code assist routines attempts to run.
        • Activation Trigger - This is the key that actives Code Assist. For SystemTap GUI it is set to the divider between tapset and probe alias.
      • Syntax Coloring - These options assign color values to identified types within the .stp and .c editors.
        • STP editor
          • Default Color - Color of normal code.
          • Keyword Color - Color of keywords.
          • Embedded C Color - Color of embedded C code.
          • Embedded Color - Color of embedded code.
          • Comment Color - Color of comments.
          • Type Color - Color of items identified as types.
          • String Color - Color of strings.
        • C editor
          • Default Color - Color of normal code.
          • Keyword Color - Color of keywords.
          • Preprocessor Color - Color of preprocessor code.
          • Comment Color - Color of comments.
          • Type Color - Color of items identified as types.
          • String Color - Color of strings.

        </ul

        • Typeing - No options available at this time.
      • Path
        • Kernel Source Directory - Location of the directory that the kernel source code is pulled from.
        • Stap - No options available at this time.
          • Tapsets - Preferences related to tapsets.
            • Additional Tapsets - Allows you to specify additional tapsets scripts to be added in with every script.
    • Remote Server - Details regarding the remote machine running the systemtapgui Server
      • Host Name - IP address of the remote machine
      • Port - Port used for communication. Default is 22462.
      • User Name - User name that has sufficient permissions to transfer and run the script on the remote machine.
      • Password - Password for the above user.