saidar(1) [debian man page]

saidar(1)						      General Commands Manual							 saidar(1)

NAME

       saidar - a curses-based tool for viewing system statistics

SYNOPSIS

       saidar [-d delay] [-c] [-v] [-h]

DESCRIPTION

       saidar  is  a  curses-based  tool for viewing the system statistics available through libstatgrab. Statistics include CPU, processes, load,
       memory, swap, network I/O, disk I/O, and file system information.

OPTIONS

       The following options are supported.

       -d DELAY
	      Wait DELAY seconds between updates (default 3)

       -c     Enables coloured output

       -v     Prints the version number

       -h     Display help and exits

COLOURED OUTPUT

       When the -c option is used saidar uses colours to display the data. Each area has a different colour to	distinguish  it  from  the  nearby
       fields. Bold and reverse video effects are used to emphasis fields where necessary.

       The  load  average  figures  are  displayed in bold when they're notably (greater that 1) different to each other. This purely shows that a
       change in the load is occurring.

       When CPU usage goes over 60% it will be displayed in bold.  At 90% the field is displayed using reverse video. Likewise	for  memory,  swap
       and disk usage at 75% and 90%. Zombie processes are also highlighted.

       Other  values  (paging,	disk  I/O  and	network  I/O) are not highlighted due to the nature of the values; it's not easy to determine what
       thresholds are significant.

SEE ALSO

       statgrab(1) statgrab(3)

AUTHORS

       This man page was written by Bartosz Fenski for the Debian GNU/Linux distribution.

WEBSITE

       http://www.i-scream.org/libstatgrab/

i-scream						   $Date: 2006/11/30 23:42:42 $ 						 saidar(1)

sg_get_mem_stats(3)					     Library Functions Manual					       sg_get_mem_stats(3)

NAME

       sg_get_mem_stats, sg_get_swap_stats - get VM statistics

SYNOPSIS

       #include <statgrab.h>

       sg_mem_stats *sg_get_mem_stats(void);

       sg_swap_stats *sg_get_swap_stats(void);

DESCRIPTION

       Memory statistics are accessed through the sg_get_mem_stats function. It returns a pointer to a static sg_mem_stats.

       The sg_get_swap_stats returns returns swap statistics. It returns a pointer to a static sg_swap_stats.

       On  the	FreeBSD  operating system elevated privileges are required to access the swap statistics. Making the program setgid kmem should be
       sufficient. Programs running as root will not have this problem.

RETURN VALUES

       The VM system calls can return a pointer to either a sg_mem_stats or a sg_swap_stats.

       typedef struct{
	       long long total;
	       long long free;
	       long long used;
	       long long cache;
       }sg_mem_stats;

       total  The total amount of memory in bytes.

       free   The total free memory in bytes.

       used   The total used memory in bytes.

       cache  The amount of cache used in bytes.

       typedef struct{
	       long long total;
	       long long used;
	       long long free;
       }sg_swap_stats;

       total  The total swap space in bytes.

       used   The used swap in bytes.

       free   The free swap in bytes.

TODO

       Add a function to hold open the file descriptor to the kernel memory structures. Doing this would  allow  the  elevated	privileges  to	be
       dropped early on.

SEE ALSO

       statgrab(3)

WEBSITE

       http://www.i-scream.org/libstatgrab/

i-scream						   $Date: 2005/04/25 11:25:45 $ 				       sg_get_mem_stats(3)