2004 Sun Microsystems 2001 2002 2004 Bill Day GNOME Documentation Project &legal; Sun GNOME Documentation Team Sun Microsystems Bill Day

billday@bellatlantic.net

System Monitor Manual V&manrevision; &date; Sun GNOME Documentation Team GNOME Documentation Project System Monitor Manual V2.0 November 2002 Bill Day billday@bellatlantic.net GNOME Documentation Project Procman Manual V0.11 January 2002 Bill Day billday@bellatlantic.net GNOME Documentation Project This manual describes version &appversion; of &app;. To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the GNOME Feedback Page. System Monitor gnome-system-monitor procman The &app; application enables you to monitor system processes and usage of system resources. You can also use &app; to modify the behavior of your system. The &app; window contains two tabbed sections: Process Listing Shows active processes, and how processes are related to each other. Provides detailed information about individual processes, and enables you to control active processes. Resource Monitor Displays the current usage of the following system resources: CPU (central processing unit) time Memory and swap space Disk space on each device You can start &app; in the following ways: Applications menu Choose System Tools System Monitor. Command line Execute the following command: gnome-system-monitor When you start &app;, the following window is displayed:

Shows System Monitor main window.

The &app; window contains the following elements: Menubar The menus on the menubar contain all of the commands that you need to work with &app;. Display area The display area contains the system monitor information. The display area contains the following tabbed sections: Process Listing Contains a Search text box, a View drop-down list, a list of processes organized as a table, a More Info button, and an End Process button. Do not confuse the View drop-down list on the Process Listing tabbed section with the View menu in the menubar. Resource Monitor Contains a CPU History graph, a Memory and Swap History graph, and a list of Devices organized as a table. Statusbar The statusbar displays information about current &app; activity and contextual information about the menu items. To display the process list, select the Process Listing tab. The Process Listing tab is displayed by default when you start &app;. In the Process Listing tab, the processes are organized as a table. The rows of the table display information about the processes. The columns represent information fields for the processes, such as the name of the user who owns the process, the amount of memory currently being used by the process, and so on. From left to right, the Process Listing tab displays the following columns by default: Process Name User Memory X Server Memory Nice ID For information about how to change the columns displayed in the process list, see . A parent process is a process that spawns another process. The spawned process is a child process of the original parent process. By default, &app; shows process dependencies. For information about how to change the default display behavior, see . A thread is a portion of a process that can run independently of and concurrently with other portions of the process. By default, &app; does not show threads. For information about how to change the default display behavior, see . Processes run in order of priority: high-priority processes run before low-priority processes. Child processes generally inherit their priority from their parent process. The priority of a process is set by the nice value of the process, as follows: A nice value of 0 means that the process has normal priority. The higher the nice value, the lower the priority. The lower the nice value, the higher the priority. For information about how to change the priority of a process, see . To sort the process list, perform the following steps: Select the Process Listing tab to display the process list. By default, the processes are listed by name, in alphabetical order. To list the processes in reverse alphabetical order, click on the Process Name column header. Click on any column header to sort the processes by the information in that column, in alphabetical or numerical order. Click again on the column header to sort the data in reverse alphabetical or reverse numerical order. You can modify the contents of the process list in several ways. To show all processes in the process list, perform the following steps: Select the Process Listing tab to display the process list. Click on the View drop-down list, then select All Processes. To show only the processes that are owned by the current user, perform the following steps: Select the Process Listing tab to display the process list. Click on the View drop-down list, then select My Processes. To show only the active processes in the process list, perform the following steps: Select the Process Listing tab to display the process list. Click on the View drop-down list, then select Active Processes. To show process dependencies in the process list, perform the following steps: Select the Process Listing tab to display the process list. Choose ViewProcess Dependencies. If the Process Dependencies menu item is selected, the processes are listed as follows: Parent processes are indicated by a triangle symbol to the left of the process name. Click on the triangle symbol to show or hide the associated child processes. Child processes are indented, and listed with their parent process. If the Process Dependencies menu item is not selected: Parent processes and child processes are not distinguishable. All processes are listed in alphabetical order. To show threads in the process list, perform the following steps: Select the Process Listing tab to display the process list. Choose ViewThreads. To hide a process, perform the following steps: Select the Process Listing tab to display the process list. Select the process that you want to hide. Choose EditHide Process. By default, a confirmation alert is displayed. For information about how to display or hide the confirmation alert, see . Click on the Hide Process button to confirm that you want to hide the process. To re-display hidden processes in the process list, perform the following steps: Choose EditHidden Processes. If no processes are currently hidden, an information alert is displayed. If any processes are currently hidden, the Manage Hidden Processes dialog is displayed. Select the processes that you want to re-display in the process list. Click on the Remove From List button. The processes are no longer hidden, and are displayed in the process list. Click Close to close the Manage Hidden Processes dialog. To find a process in the process list, perform the following steps: Select the Process Listing tab to display the process list. Type the name of the process in the Search text box. Wildcards are not supported. Press Return. If the process exists, &app; highlights the process name in the process list. Press Return repeatedly to highlight other occurrences of the process name in the process list. If the process does not exist, &app; displays an error dialog. To show additional information about a process, perform the following steps: Select the Process Listing tab to display the process list. Select the process in the process list. Click on the More Info button. &app; displays the following additional process information: Process Info Command The name of the command that started the process. Status The current status of the process: sleeping or running. Priority The priority of the process, and the associated nice value. Memory Usage Total The total amount of memory used by the process. RSS The amount of RSS or physical memory used by the process. Shared The amount of shared memory used by the process. To hide the additional process information, click on the Less Info button. You can also double-click on the process in the process list, to show or hide the additional process information. To display memory maps for a process, perform the following steps: Select the Process Listing tab to display the process list. Select the process in the process list. Choose ViewMemory Maps. The Memory Maps dialog displays the information in tabular format. The name of the process is displayed above the memory-map table. From left to right, the Memory Maps dialog displays the following columns: Filename The location of a shared library that is currently used by the process. If this field is blank, the memory information in this row describes memory that is owned by the process whose name is displayed above the memory-map table. VM Start The address at which the memory segment begins. VM End The address at which the memory segment ends. VM Size The size of the memory segment. Flags The following flags describe the different types of memory-segment access that the process can have: p The memory segment is private to the process, and is not accessible to other processes. r The process has permission to read from the memory segment. s The memory segment is shared with other processes. w The process has permission to write into the memory segment. x The process has permission to execute instructions that are contained within the memory segment. VM offset The virtual memory offset of the memory segment. Device The major and minor device numbers of the device on which the shared library filename is located. Inode The inode on the device from which the shared library location is loaded into memory. Click on any column header to sort the data by the information in that column, in alphabetical or numerical order. Click again on the column header to sort the data in reverse alphabetical or reverse numerical order. Click Close to close the Memory Maps dialog. To change the priority of a process, perform the following steps: Select the Process Listing tab to display the process list. Select the process for which you want to change the priority. Choose EditChange Priority. The Change Priority dialog is displayed. Use the slider to set the nice value of the process. The nice value sets the priority of the process: the lower the nice value, the higher the priority. To specify a nice value lower than zero, non-root users must enter the root password. Click on the Change Priority button. To end a process, perform the following steps: Select the Process Listing tab to display the process list. Select the process that you want to end. Choose EditEnd Process, or click on the End Process button. By default, a confirmation alert is displayed. For information about how to display or hide the confirmation alert, see . Click on the End Process button to confirm that you want to end the process. &app; forces the process to finish normally. This is the preferred way to stop a process. To terminate a process, perform the following steps: Select the Process Listing tab to display the process list. Select the process that you want to terminate. Choose EditKill Process. By default, a confirmation alert is displayed. For information about how to display or hide the confirmation alert, see . Click on the Kill Process button to confirm that you want to terminate the process. &app; forces the process to finish immediately. You usually terminate a process only if you cannot end the process normally as described in . To monitor CPU usage, select the Resource Monitor tab. &app; displays the CPU usage history in graphical format. Underneath the graph, &app; also displays the current CPU usage, as a percentage. To monitor memory and swap usage, select the Resource Monitor tab. &app; displays the memory usage history and the swap usage history in graphical format. Underneath the graph, &app; also displays the following numerical values: Used memory Total memory Used swap Total swap To monitor disk space usage, select the Resource Monitor tab. &app; displays the disk space usage information in tabular format. From left to right, the Devices table displays the following columns: Name The name of the device. Directory The location of the device. Type The type of the device. Total The total amount of disk space available on the device. Used The amount of disk space currently used on the device, expressed in bytes and as a percentage. You can customize the Resource Monitor tabbed section in the following ways: To change the background color of the &app; graphs, perform the following steps: Choose EditPreferences. The Preferences dialog is displayed. Select the Resource Monitor tab in the Preferences dialog. Click on the Background color button. The Pick a color dialog is displayed. Choose a color from the Palette, or use the color wheel or the spin boxes to customize the color. Click OK to close the Pick a color dialog. Click Close to close the Preferences dialog. To change the grid color of the &app; graphs, perform the following steps: Choose EditPreferences. The Preferences dialog is displayed. Select the Resource Monitor tab in the Preferences dialog. Click on the Grid color button. The Pick a color dialog is displayed. Choose a color from the Palette, or use the color wheel or the spin boxes to customize the color. Click OK to close the Pick a color dialog. Click Close to close the Preferences dialog. To change the color of the line that represents CPU usage in the CPU History graph, perform the following steps: Select the Resource Monitor tab in the System Monitor window, to display the graphs and table that provide information about the usage of system resources. Click on the CPU color button. The Pick a color dialog is displayed. Choose a color from the Palette, or use the color wheel or the spin boxes to customize the color. Click OK to close the Pick a color dialog. To change the color of the lines that represent memory and swap usage in the graph, perform the following steps: Select the Resource Monitor tab in the System Monitor window, to display the graphs and table that provide information about the usage of system resources. Click on the Used memory or Used swap button. The Pick a color dialog is displayed. Choose a color from the Palette, or use the color wheel or the spin boxes to customize the color. Click OK to close the Pick a color dialog. To configure &app;, choose EditPreferences. The Preferences dialog contains the following tabbed sections: Behavior Update interval ... seconds Use this spin box to specify the interval at which you want to update the process list. Show warning dialog when ending or killing processes Select this option to display a confirmation alert when you end a process or terminate a process. Show warning dialog when hiding processes Select this option to display a confirmation alert when you hide a process. Process Fields Use the following options to select which fields are displayed in the process list: Process Name Select this option to display the name of the process. This column may also contain an icon to indicate the application that is associated with the process. Arguments Select this option to display the name of the command, including arguments, that started the process. User Select this option to display the name of the user who owns the process. Status Select this option to display the current status of the process: sleeping or running. Memory Select this option to display the amount of system memory that is currently being used by the process. VM Size Select this option to display the amount of virtual memory that is allocated to the process. Resident Memory Select this option to display the amount of physical memory that is allocated to the process. Shared Memory Select this option to display the amount of shared memory that is allocated to the process. Shared memory is memory that can be accessed by another process. RSS Memory Select this option to display the amount of physical memory, excluding swapped-out pages, that is used by the process. X Server Memory Select this option to display the amount of X server memory that is used by the process. % CPU Select this option to display the percentage of CPU time currently being used by the process. Nice Select this option to display the nice value of the process. The nice value sets the priority of the process: the lower the nice value, the higher the priority. ID Select this option to display the process identifier, also known as the pid. The pid is a number that uniquely identifies the process. You can use the pid to manipulate the process on the command line. Graphs Update interval ... seconds Use this spin box to specify how often you want to update the &app; graphs. Background color Use this button to customize the background color of the &app; graphs, as described in . Grid color Use this button to customize the grid color of the &app; graphs, as described in . Devices Update interval ... seconds Use this spin box to specify how often you want to update the Devices table.