YAMM(1)

NAME
yamm - Yet Another Micro Monitor

SYNOPSIS
yamm [ -m ] [ -s ] [ -t ] [ -c ] [ -d ] [ -D ] [ -E ] [ -r ] [ -% ] [ -L ] [ -u uid|name ] [ -i ] [ -e ] [ -S ] [ -U ] [ -p process ] [ -C ] [ -V ] [ -I uid|name ] [ -w ] [ -N number ] [ -/ string ] [ -W second ]

DESCRIPTION
yamm , a great system monitor program using the curses library. Display tasks info, memory info, system info, CPU activity and much more. Help the system manager to easily manage processes and users, to do tasks like renice and kill processes, in a friendly environment.

OPTIONS

-m  Display only processes.

-s  Sort by time.

-t  Sort by process

-c  Sort by process % time, default.

-d  Sort by process size ( + text + stack ).

-D  Sort by process resident set size.

-E  Show processes with uid != euid.

-r  Allow display of process.

-%  Switch between STIME/TIME and WCPU/WCHAN fields.

-L  In curses version, activate the Load Average 1 min bar chart. In no-curses version activate the output in long format.

-u uid|name
    Restrict to a specific

-i  sorting order.

-e  Display the in utmp.

-S  Display only time to field "TIME" that normally is system_time + user_time.

-U  Display only time to field "TIME".

-p process
    Analyze a single

-C  Display of machine.

-V  memory info.

-I uid|name
    User

-w  Like

-N number
    Display only process.

-/ string
    Search string in command line of a process.

-W second
    Loop forever "second" for each loop ( type DELETE or QUIT to exit ).

MAIN SCREEN FIELD DESCRIPTION
The main screen of yamm, displays various informations about all the processes currently running, including:

  Top of screen

Load averages
    The average number of processes ready to run in the last 1/5/15 minutes.

Idle
    The rate of idle CPU between two updates.

Processes
    A summary of the status of processes.

Memory
    A summary of the status of memory ( physical and virtual ).

  Tasks screen

SWN These are three columns showing different states of the process: S Status of the task ( swapping or uninterruptible, s opped, other). W Swap status of the task ( show if the task is totally s apped out). N Nice status of the process ( more priority, less priority).

USER
    Username of the user owning the task.

UID User ID of the user owning the task. When using drv_yamm module, this field is the SUID.

PID Process ID of the task.

NI  Nice-value of the task. The less the nice-value, the lower is the priority of the task.

PRI Priority of the task.

SIZE
    Virtual memory size of the task: vsize=(brk-start_code+PAGE_SIZE-1)+(TASK_SIZE-esp)

RSS Resident Set Size, the amount of physical memory used by the task.

STIME
    Start time of the task.

TIME|sTIME|uTIME
    Total, or System, or User, time used by the task from when it was launched.

%WCPU
    % of CPU used by the task while running.

WCHAN
    Name of the kernel function where the process is sleeping (0 if the task is running). The name of the function is got from /etc/System.map file. If yamm don't find an /etc/System.map, it search for /usr/src/linux/System.map, and copy it to /etc/System.map. If no System.map file is found, yamm displays the address (in hex numbers) of the function, instead of its name. The name (if known) and the address (in hex) of the function, are displayed in per-process informations screen too.

CMD Name of the task. Enclosed in brackets if the process is totally or partially swapped out.

NOTES
Yamm can be navigated with the key pad if the OS and curses library support it. With keypad you can use LEFT and RIGHT arrows to change the foreground colors, UP and DOWN arrows to move the slide bar up and down, PAGEUP and PAGEDOWN to go one page up or down, HOME to go to page 0, DELETE key to kill a process. Currently it works under Linux with ncurses package. I have not tryed using ncurses under HP-UX but should work too.

BUGS
It has no known bugs, only more or less little mistakes. Anyway if you find one of them (bugs or mistakes of course :) please let me know, e-mail me!

SEE ALSO
free(1), kill(1), proc(5), ps(1), renice(8), top(1), uptime(1), w(1).

AUTHORS
YAMM was originally written by Andrea Marangoni ( marangon@ghost.dsi.unimi.it ) to be a system monitor for HP-UX unix systems. For its beauty I, Riccardo Facchetti ( riccardo@cdc8g5.cdc.polimi.it ), have decided to port the program to the Linux Operating System and adopt it as system monitor.

COPYRIGHT
Copyright (C) 1992 Andrea Marangoni
Copyright (C) 1994, 1995 Riccardo Facchetti