XZET(1)

NAME
xzet - Graphical System Activity Monitor

SYNOPSIS
xzet

DESCRIPTION
xzet is an X windows application which is Zmans' version of xEtat and Top , hence the name XZET. It provides 3 different types of real time system resource monitoring windows. When it is first started, the user is presented with its main menu and an About Xzet window, which gives a brief description of xzet and shows the known copyright holders of xzet and its constituent parts.

Selecting Activity from the main menu will bring up the first of the three monitor windows, the System Activity Window , which displays stripcharts of the CPU idle, user, system and nice times, expressed as a percentage. This window also has memory stripcharts for free swap space and free physical memory. Across the top of the window is a count and overview of all of the currently running processes. This is broken down into the number of sleeping, running, zombie and stopped process. On the right hand side of this window there are freespace monitors for up to three user selected file systems. Both the total bytes available in the file system and the total bytes available to the super-user are given. Under these monitors, the size of available User Physical Memory and of the System Swap space is also listed.

Selecting Processes from the main menu brings up the next window available from xzet ,the global Process Status List. This window has three formats and two modes, which can be selected by the user via buttons located at the bottom of the window. The user can choose between a single or double column short format listing and single column long format. The long format includes the following fields, in the order specified:

Process Id
    Self explanatory.

Parent Process Id
    Self explantory.

Status
    The current status of the process. This will be 'R' for running, 'S' for sleeping, 'D' for uninterruptible sleep, 'T' for stopped or traced, and 'Z' for zombie. Non-zombie processes with a resident size (see below) of zero will have a 'W' appended. Processes with a priority greater than "standard" ( 15 for xzet ) will have a '<' appended, while processes with a priority less than "standard" will have an 'N' appended.

Priority
    The priority of the process. A 'P' is appended to all entries in this field for clarity.

Nice Priority
    The Nice value of the process. Negative values represent lower priorities. An 'N' is appended to all entries in this field for clarity.

Memory
    The number of kilobytes used by the processes code + data + stack. An 'M' is appended to all entries in this field for clarity.

Physical Memory
    The number of kilobytes of physical memory used by the process. (The "Resident" size) An 'R' is appended to all entries in this field for clarity.

Notes regarding Memory & Physical Memory:
    These two fields do not include the page tables and task_struct of the process. For Linux, this is at least 12k of resident memory.

Shared Memory
    The number of kilobytes of shared memory used by the process. An 'S' is appended to all entries in this field for clarity.

CPU Time
    The processes total cpu time ( utime + stime ) since it began execution.

Percent Memory
    The processes share of the available physical memory, expressed as a percentage. Note that the available memory will be less then the amount of memory installed in your machine. The resident size of the process is used in this calculation. Entries in this field have 'M%' appended to them.

Percent CPU
    The processes share of CPU time since the last update interval, expressed as a percentage. Entries in this field have 'C%' appended to them.

Control Device
    The "user I/O device" associated with the process. Not necessarily a physical terminal. Typical identifiers examples are: 'v06' for virtual console 6; 'pp0' for pseudo-tty 0; and '?' for processes auto-started at system start-up (and therefore not associated with any control device).

User Name
    Self explanatory.

Command Line
    The command line used to start the process is shown here. If no command line was used or if the process has been swapped out to disk, it is typical to see the name of the process, without command line arguments, in parenthesis (eg "(init)"). This field is truncated to 20 characters if necessary.

If the short format is selected only the Process ID, Parent Process ID, Status, CPU Time, Percent Memory, Percent CPU, User Name, and Command Line Fields will be displayed.

The user can select between an Auto Update and Freeze mode for the process list using the command button immediately to the right of the 'quit' button at the bottom of the window. This is a toggle button whose label will change between 'Auto Update' and 'Freeze' to indicate which action will occur the next time the button is pressed. In auto update mode, the process list will be updated approximately every three seconds.

The final window offered by xzet is the Individual Process Pop-up Window , available by selecting (left-clicking) a process entry from the global process list. The title of this window is of the form host-name:process id - command line. The following labeled fields are presented in the main body of the window:

PPID
    The parent process id of the process.

TTY See the above description for the Control Device field

STIME
    The total amount of system time accumulated by the process since it first began execution.

UTIME
    The total amount of user time accumulated by the process since it first began execution.

USER
    The name of the user that started the process.

On the right hand side of this window are two fields, one with the prefix T: and the other with the prefix F:. These enumerate the size (see the above description for the Memory field) of the process, and the total system-wide free physical memory, both expressed in bytes.

The main feature of this window is two Ztach widgets, one of which is labeled % CPU and the other % MEM. These are graphical representations of the data in the Percent CPU and Percent Memory fields described above. Two relevant notes apply. First the numeric fields under the indicator arms are scaled to 10 times the percentage value (eg 23.4 percent is expressed as 234). Second, the memory gauges indicator arm rotates in the opposite direction of the cpu gauges indicator arm, hence the zero point is on the right side of the gauge. This is configurable in the applcation defaults file for xzet.

If a process terminates while a pop-up window is active for it, the pop-up will be automatically closed and removed from the display.

NOTES
The application defaults file for xzet should be changed, at the very least, to include the mount points of the file systems to be monitored.

See the README file for notes on the developement, undocumented features (bugs), future, building and other information about xzet.

COPYRIGHT
Xzet is Copyright (C) 1994 Loganville Technical Resources, Incorporated. (See Authors below for other related copyrights.) Xzet is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. Xzet is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with xzet; see the file COPYING. If not, write to the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.

AUTHOR
Zman, Loganville Technical Resources, Incorporated. 5145 Ozora Church Road, Loganville Georgia 30249, USA.

The author of Xetat is Pierre FICHEUX, Lectra-Systemes R&D. ZI Marticot 33610 Cestas FRANCE.

The authors of Top are

Branko Lankester (Copyright (c) 1992)
Roger Binns (Copyright (c) 1992)
Michael K. Johnson, johnsonm@stolaf.edu.
Robert J. Nation (nation@rocket.sanders.lockheed.com).

Only Zman was involved in the development of xzet , so the other people should not be contacted regarding bugs in it.