trusty (1) procmeter3_modules.1.gz

Provided by: procmeter3_3.5d-1_amd64 bug

NAME

       procmeter3_modules  -  The  modules  that  are  used  by  the  procmeter3,  procmeter3-xaw,  gprocmeter3,
       procmeter3-gtk1, procmeter3-gtk2, procmeter3-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 paging (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
              available.   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 kernel 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), procmeterrc(5).

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

AUTHOR

       Andrew M. Bishop 1998-2007

                                                  July 3, 2010                             PROCMETER3_MODULES(1)