Provided by: procmeter3_3.5d-1_amd64 
NAME
procmetetrc - The procmeterrc configuration file for procmeter3, procmeter3-xaw, gprocmeter3,
procmeter3-gtk1, procmeter3-gtk2, procmeter3-log and procmeter3-lcd programs.
SYNOPSIS
This file contains the run-time options for the procmeter3, procmeter3-xaw, gprocmeter3, procmeter3-gtk1,
procmeter3-gtk2, procmeter3-log and procmeter3-lcd programs. These include the outputs that are
displayed, the colours and fonts that are used (for X window outputs), the LCDproc server (for the
procmeter-lcd version) and other program options.
DESCRIPTION
The resources for ProcMeter version 3.x are stored in the .procmeterrc file instead of using X resources.
This gives more flexibility and allows for much simpler customisation.
When the procmeter3, procmeter3-xaw, gprocmeter3, procmeter3-gtk1, procmeter3-gtk2, procmeter3-log or
procmeter3-lcd programs start the .procmeterrc file is searched for in the current directory, the current
users home directory or the system default installation directory (named procmeterrc). The file is used
from the first one of these locations that matches.
The format of the .procmeterrc file is a number of sections with the section names marked in '[]'. As
well as the fixed sections (described below) there is a section for each module that is named using the
name that the module reports itself to be. There are then further sections for each of the possible
outputs of each module. The names of the sections and parameters are not case sensitive although the
values that they are given may be. Lines beginning with the characters ';' or '#' are comments and
continuation using the '\' character at the end of a line is allowed.
Below is listed the resource values and the sections of the .procmeterrc file that they can exist in.
library SECTION
This section contains the information about the ProcMeter modules that are available. This applies to
all versions of the program.
path=...
The pathname of the library that contains the compiled ProcMeter modules. (defaults to the
program's compiled-in installation location).
others=...
A list of other modules to be loaded (full pathnames separated by spaces).
startup SECTION
This section controls how the ProcMeter window should look when the program is started.
order=...
A list of the outputs that are to be started up in the order that they are to be displayed
(separated by spaces). If command line options are also specified then they appear after those
specified here.
resources SECTION
This section contains the general program display resources. Not all of the options apply to all of the
versions of the program. Specific versions that the options apply to are specified below.
horizontal=...
A Boolean to indicate that the outputs are stacked horizontally instead of the default which is
vertically. (For X versions of procmeter3 only.)
background=...
The colour to use as the default background for all outputs. (An X11 colour name or an RGB value
in hex as #RRGGBB.) (For X versions of procmeter3 only.)
foreground=...
The colour to use as the default foreground for all outputs. (An X11 colour name or an RGB value
in hex as #RRGGBB.) (For X versions of procmeter3 only.)
label-font=...
The font to use for the label that describes the output. (An X11 font name.) (For X versions of
procmeter3 only.)
label-foreground=...
The colour to use as the foreground for the label. (An X11 colour name or an RGB value in hex as
#RRGGBB.) (For X versions of procmeter3 only.)
label-position=...
The position of the label relative to the body of the output. (Either top, bottom or none.) (For
X versions of procmeter3 only.)
grid-foreground=...
The colour to use for the grid lines. (An X11 colour name or an RGB value in hex as #RRGGBB.)
(For X versions of procmeter3 only.)
graph-solid=...
A boolean to indicate if the graph should be solid (the default) or a single line. (yes or no,
true or false, 0 or 1.) (For X versions of procmeter3 only.)
grid-min=...
The minimum number of grid lines to display on a graph or bar chart. (An integer.) (For X and
LCD versions of procmeter3 only.) This is particularly important with the bar chart because with
this set too low the bar will always be the same length on screen and the number of grid lines
will change with the data.
grid-max=...
The maximum number of grid lines to display on a graph or bar chart. (An integer.) (For X and
LCD versions of procmeter3 only.)
text-font=...
The font to use for the textual outputs. (An X11 font name.) (For X versions of procmeter3
only.)
menu-foreground=...
The colour to use as the foreground for the menus. (An X11 colour name or an RGB value in hex as
#RRGGBB.) (For procmeter3 and procmeter3-xaw only.)
menu-background=...
The colour to use as the background for the menus. (An X11 colour name or an RGB value in hex as
#RRGGBB.) (For procmeter3 and procmeter3-xaw only.) (The background of all items on the same
menu must be the same due to the Xaw Widget set used.)
menu-font=...
The font to use for the menus. (An X11 font name.) (For procmeter3 and procmeter3-xaw only.)
update=...
The update interval for the output in seconds (an integer).
LCD SECTION
This section contains parameters that are only used by the procmeter3-lcd version of the program.
host=...
The name of the host that the LCDd daemon is running on.
port=...
The port number that the LCDd daemon is running on.
duration=...
The length of time that all of the ProcMeter outputs are displayed on the LCD display for before
cycling to the next.
priority=...
The priority of all of the ProcMeter outputs when they are displayed on the LCD display. This
values should be a numeric value for LCDd verions before 0.5 or priority names for later versions.
Using numeric values will likely fail for LCDd versions after 0.5 due to a bug in LCDd. The
safest solution is not to use this option unless you are sure what value to use.
MODULE SECTION
The name of the section is the name of the ProcMeter module (see the help, procmeter3 -h), for example:
ProcMeter
These can contain any of the resource values which will then apply to all outputs of this module. There
are also extra options that can be applied to the module and as defaults for the all of the outputs of
that module.
options=...
A string containing options that are passed to the module at startup, different modules have
different options, see the procmeter3_modules(1) manual page.
graph-scale=...
The scaling of the graph or bar chart, the number of units between each of the grid lines (an
integer).
run=...
A string that specifies a program that can be run by selecting it from the menu for the left mouse
button. (For X versions of procmeter3 only.) The way that the command is run can be specified
using one of the following abbreviations; XTerm( command ) to run command in an xterm then exit.
XTermWait( command ) to run command in an xterm and wait for user input before exiting. Shell(
command ) to run command in an shell and exit. This last one is equivalent to using none of these
abbreviations.
OUTPUT SECTION
The name of the section is the name of the ProcMeter output (see the help, procmeter3 -h), for example:
ProcMeter.Version
The output sections can contain any of the resource or module options (except ´options') which will then
apply only to the specified output. There are also options that can only be applied to individual
outputs.
label=...
Changes the default label for the output to the specified string.
EXAMPLE
Below is an example .procmeterrc file, it is a much reduced version of the system default procmeterrc
file.
[startup]
# ProcMeter version, clock, CPU graph, load text
order=ProcMeter.Version Date_Time.Time_HM \
Statistics.CPU-g Processes.Load-t
[resources]
# The outputs, black on white
foreground = black
background = white
# A large-medium size text font.
text-font = 8x13
# Solid graphs with at least 5 grid lines in grey.
graph-solid = yes
grid-min = 5
grid-foreground = grey50
# Black on white output labels, small font, below the data.
label-font = 5x7
label-foreground = black
label-position = bottom
# Black on white menu items in a small-medium size font.
menu-foreground = black
menu-background = white
menu-font = 7x13
[ProcMeter.Version]
# A smaller font than normal with no label.
text-font = 6x10
label-position = none
[Statistics]
[Statistics.CPU]
# The minimum number of grid lines, they are 20% each.
grid-min = 5
[Processes]
run = XTerm(top)
[Network]
# To pick up extra devices not automatically recognised.
#options=ppp0 slip0
FILES
./.procmeterrc
~/.procmeterrc
/usr/local/lib/X11/ProcMeter3/procmeterrc or /usr/lib/X11/ProcMeter3/procmeterrc
SEE ALSO
procmeter3(1), procmeter3-xaw(1), gprocmeter3(1), procmeter3-gtk1(1), procmeter3-gtk2(1),
procmeter3-log(1), procmeter3-lcd(1), procmeter3_modules(1).
AUTHOR
Andrew M. Bishop 1998-2007
July 3, 2010 PROCMETERRC(5)