PROCMETER3_MODULES(1)					      General Commands Manual					     PROCMETER3_MODULES(1)

NAME

       procmeter3_modules  -  The  modules that are used by the procmeter3, procmeter3-xaw, gprocmeter3, procmeter3-gtk1, procmeter3-gtk2, procme-
       ter3-log and procmeter3-lcd programs.

DESCRIPTION

       The ProcMeter3 programs provide a framework that allows displaying of information in various formats.  The collection of  the  data  to	be
       displayed is performed by a set of loadable modules.

MODULES

       The modules that are provided with the program are the following:

       APM    Advanced	Power  Management  information.   These outputs are only available if you have configured the Linux kernel to have the APM
	      feature and you have the appropriate hardware.  The outputs can tell you the amount of time remaining and the state of charge of the
	      battery.

       Biff   Monitors	the  e-mail  inbox  (in  /var/spool/mail/<username> or /var/mail/<username> ) and indicates the number of e-mails that are
	      waiting and the size of the inbox.  The options parameter in the .procmeterrc file can be used to specify an alternate  filename	to
	      use for the inbox.

       Date_Time
	      The  current  date and time and the amount of time since the system was last booted.  Different outputs are available that allow the
	      format of the date and time information to be changed.  For the time outputs the options parameter in the .procmeterrc file  can	be
	      set to 12 to indicate that a 12 hour format with AM/PM is to be used.

       DiskUsage
	      Shows  the percentage of the disk that is used and the amount of free space for each of the local disks that it finds are mounted or
	      can be mounted when the program starts.  Extra disks can be passed as options using the options parameter in the	.procmeterrc  file
	      to contain a space separated list of mount points.

       LogFile
	      Monitors	the  size  and number of lines and the rate of increase of the size or number of lines in a set of log files.  The options
	      parameter in the .procmeterrc file contains a space separated list of log file names.

       Memory The amount of memory that is used for programs, buffers, cache and the amount that is free.  This is the same  information  that	is
	      available from the free program, but is available here as a graph, bar or as text.

       Network
	      The  network devices and the amount of traffic on each of them.  It will automatically pick up available devices when it starts.	To
	      specify others use the options parameter in the .procmeterrc configuration file which is a space separated list of device names.

       Processes
	      The load average and the number of processes running and starting.

       ProcMeter
	      Information about the procmeter program itself.

       Sensors
	      Information from hardware sensors for temperature and fan speed (simple version with fixed scaling).

       FanSpeed
	      Information from hardware sensors for fan speed (requires libsensors library installed but does read sensors.conf  file  for  system
	      customisation).	The  options parameter in the .procmeterrc file can be used to specify an alternate sensors configuration filename
	      to use instead of the default.  If this is used then it must be used in each of the FanSpeed, Temperature and Voltage modules.

       Temperature
	      Information from hardware sensors for temperature (requires libsensors library installed but does read sensors.conf file for  system
	      customisation).	The  options parameter in the .procmeterrc file can be used to specify an alternate sensors configuration filename
	      to use instead of the default.  If this is used then it must be used in each of the FanSpeed, Temperature and Voltage modules.

       Voltage
	      Information from hardware sensors for voltages (requires libsensors library installed but does read  sensors.conf  file  for  system
	      customisation).	The  options parameter in the .procmeterrc file can be used to specify an alternate sensors configuration filename
	      to use instead of the default.  If this is used then it must be used in each of the FanSpeed, Temperature and Voltage modules.

       Statistics
	      Low level system statistics.  For example CPU usage, context switches, interrupts, disk usage (before kernel 2.6), swapping and pag-
	      ing (before kernel 2.6).

       Stat-CPU
	      More detailed statistics about individual CPU usage including individual CPU usage for SMP machines.

       Stat-Disk
	      More  detailed  statistics  about  individual disk usage read and write.	For older Linux kernels (before version 2.4) there is only
	      support for up to 4 disks (this limit is set by the kernel and not by ProcMeter).  For version 2.4 or later  kernels  the  limit	is
	      removed and the disk names are picked up when the program starts.  For version 2.6 or later kernels individual partitions are avail-
	      able.  To force other disks to be listed use the options parameter in the .procmeterrc configuration file which is a space separated
	      list of device names (e.g. /dev/fd0).

       Stat-Intr
	      More  detailed  statistics  about  individual interrupts including support for up to 256 interrupts.  If fewer interrupts are wanted
	      then the options parameter in the .procmeterrc configuration file can be set to the maximum number to display.

       Uname  The system information, hostname and Linux kernel version, the same as the output of the uname program.

       Wireless
	      Information about wireless network devices. It will automatically pick up available devices when it starts. To  specify  others  use
	      the options parameter in the .procmeterrc configuration file which is a space separated list of device names.

       Longrun
	      For  systems with the Transmeta Crueso processor, information about longrun.  Will not work unless the kernel is compiled with CPUID
	      support, and /dev/cpu/0/cpuid must be readable by ProcMeter. (Allow regular users to access the cpuid device at your own risk!)

       ACPI   Advanced Configuration and Power Interface information. These outputs are only available if you have enabled ACPI in the Linux  ker-
	      nel  and you have the appropriate hardware.  ACPI can report various information about a system's battery, and may also have thermal
	      outputs available.

       VM_Statistics
	      Low level system statistics about virtual memory (swapping and paging) for kernel version 2.6 where the information has  moved  from
	      the Statistics section.

       CPUInfo
	      Information about the CPUs in the system, currently only the CPU speed in MHz.

SEE ALSO

       procmeter3(1),  procmeter3-xaw(1),  gprocmeter3(1),  procmeter3-gtk1(1),  procmeter3-gtk2(1), procmeter3-log(1), procmeter3-lcd(1), procme-
       terrc(5).

       biff(1) free(1) uname(1)

AUTHOR

       Andrew M. Bishop 1998-2007

								   July 3, 2010 					     PROCMETER3_MODULES(1)