gkrellm.1

系统任务管理器

.TH gkrellm 1 "June 7, 2003" "GNU/Linux" "User's Manual"

.SH "NAME"
gkrellm \- The GNU Krell Monitors

.SH "SYNOPSIS"
.B gkrellm
[
.B \-\-help
]
[
.B \-t
|
.B \-\-theme
dir
]
[
.B \-g
|
.B \-\-geometry
+x+y
]
[
.B \-wm
]
[
.B \-w
|
.B \-\-withdrawn
]
[
.B \-c
|
.B \-\-config
suffix
]
[
.B \-nc
]
[
.B \-f
|
.B \-\-force\-host\-config
]
[
.B \-demo
]
[
.B \-p
|
.B \-\-plugin
plugin.so
]
[
.B \-s
|
.B \-\-server
hostname
]
[
.B \-P
|
.B \-\-port
server_port
]

.SH "DESCRIPTION"
.PP
With a single process,
.B gkrellm
manages multiple stacked monitors and supports applying
themes to match the monitors appearance to your window manager, Gtk, or any
other theme.

.SS "FEATURES"
.IP \(bu 4
SMP CPU, Disk, Proc, and active net interface monitors with LEDs.
.IP \(bu 4
Internet monitor that displays current and charts historical port hits.
.IP \(bu 4
Memory and swap space usage meters and a system uptime monitor.
.IP \(bu 4
File system meters show capacity/free space and can mount/umount.
.IP \(bu 4
A mbox/maildir/MH/POP3/IMAP mail monitor which can launch a mail reader or
remote mail fetch program.
.IP \(bu 4
Clock/calendar and hostname display.
.IP \(bu 4
Laptop Battery monitor.
.IP \(bu 4
CPU/motherboard temperature/fan/voltages display with warnings and
alarms.  Linux requires a sensor configured sysfs, lm_sensors modules or
a running mbmon daemon.  FreeBSD can also read the mbmon daemon.
Windows requires MBM.
.IP \(bu 4
Disk temperatures if there's a running hddtemp daemon.
.IP \(bu 4
Multiple monitors managed by a single process to reduce system load.
.IP \(bu 4
A timer button that can execute PPP or ISDN logon/logoff scripts.
.IP \(bu 4
Charts are autoscaling with configurable grid line resolution, or
.IP \(bu 4
can be set to a fixed scale mode.
.IP \(bu 4
Separate colors for "in" and "out" data.  The in color is used for
CPU user time, disk read, forks, and net receive data.  The out color
is used for CPU sys time, disk write, load, and net transmit data.
.IP \(bu 4
Commands can be configured to run when monitor labels are clicked.
.IP \(bu 4
Data can be collected from a
.B gkrellmd
server running on a remote machine.
.IP \(bu 4
.B gkrellm
is plugin capable so special interest monitors can be created.
.IP \(bu 4
Many themes are available.

.SS "USER INTERFACE"
.B
.IP "\(bu Top frame"
.RS
.TP
.I "Btn 1"
Press and drag to move
.B gkrellm
window.
.TP
.I "Btn 3"
Popup main menu.
.RE
.B
.IP "\(bu Side frames"
.RS
.TP
.I "Btn 2"
Slide
.B gkrellm
window shut (Btn1 if -m2 option).
.TP
.I "Btn 3"
Popup main menu.
.RE
.B
.IP "\(bu All charts"
.RS
.TP
.I "Btn 1"
Toggle draw of extra info on the chart.
.TP
.I "Btn 3"
Brings up a chart configuration window.
.RE
.B
.B
.IP "\(bu Inet charts"
.RS
.TP
.I "Btn 2"
Toggle between port hits per minute and hour.
.RE
.B
.IP "\(bu Most panels"
.RS
.TP
.I "Btn 3"
Opens the configuration window directly to a monitor's configuration page.
.RE
.B
.IP "\(bu File System meter panels"
.RS
.TP
.I "Btn 1,2"
Toggle display of label and fs capacity scrolling display.
The mount button runs mount/umount commands.
If ejectable, left click the eject button to open tray, right click to close.
.RE
.B
.IP "\(bu Mem and Swap meter panels"
.RS
.TP
.I "Btn 1,2"
Toggle display of label and memory or swap capacity scrolling display.
.RE
.B
.IP "\(bu Mailbox monitor message count button"
.RS
.TP
.I "Btn 1"
Launch a mail reader program.  If options permit, also
stop animations and reset remote message counts.
.TP
.I "Btn 2"
Toggle mail check mute mode which inhibits the sound
notify program, and optionally inhibits all mail checking.
.RE
.B
.IP "\(bu Mailbox monitor envelope decal"
.RS
.TP
.I "Btn 1"
Force a mail check regardless of mute or timeout state.
.RE
.B
.B
.IP "\(bu Battery monitor panel"
.RS
.TP
.I "Btn 1"
On the charging state decal toggles battery minutes left,
percent level, and charge rate display.
.TP
.I "Btn 2"
Anywhere on the panel also toggles the display.
.RE
.B
.IP "\(bu Keyboard shortcuts"
.RS
.TP
.I "F1"
popup the user config window.
.TP
.I "F2"
popup the main menu.
.TP
.I "Page_Up"
previous theme or theme alternative.
.TP
.I "Page_Down"
next theme or theme alternative.
.TP
.I "<Ctl>Page_Up"
previous theme, skipping any theme alternatives.
.TP
.I "<Ctl>Page_Down"
next theme, skipping any theme alternatives.
.RE
.PP
If a command has been configured to be launched for a monitor, then
a button will appear when the mouse enters the panel of that monitor.
Clicking the button will launch the command.
.PP
A right button mouse click on the side or top frames of the
.B gkrellm
window will pop up a user configuration window where you can configure
all the builtin and plugin monitors.  Chart appearance may be configured
by right clicking on a chart, and right clicking on many panels will open
the configuration window directly to the corresponding monitor's
configuration page.

.SH "OPTIONS"
.TP
.B \-\-help
Displays this manual page.
.TP
.B \-t, \-\-theme dir
.B gkrellm
will load all theme image files it finds in
.I dir
and parse the
.IR gkrellmrc
file if one exists.  This option overrides
the loading of the last theme you configured to be loaded in
the Themes configuration window.  Theme changes are not saved
when
.B gkrellm
is run with this option.
.TP
.B \-g, \-\-geometry +x+y
Makes
.B gkrellm
move to an
.I (x,y)
position on the screen at startup.  Standard X window geometry position
(not size) formats are parsed, ie +x+y -x+y +x-y -x-y.  Except, negative
geometry positions are not recognized (ie +-x--y ).
.TP
.B \-wm
Forces
.B gkrellm
to start up with window manager decorations.  The
default is no decorations because there are themed borders.
.TP
.B \-w, \-\-withdrawn
.B gkrellm
starts up in withdrawn mode so it can go into the Blackbox
slit (and maybe WindowMaker dock).
.TP
.B \-c, \-\-config suffix
Use alternate config files generated by appending
.I suffix
to config file names.  This overrides any previous host config which may have
been setup with the below option.
.TP
.B \-f, \-\-force\-host\-config
If
.B gkrellm
is run once with this option and then the configuration
or theme is changed, the config files that are written will have
a
.I -hostname
appended to them.  Subsequent runs will detect the
.IR user-config-hostname
and
.I gkrellm_theme.cfg-hostname
files and use
them instead of the normal configuration files (unless the
.B \-\-config
option is specified).   This is a convenience for allowing
remote
.B gkrellm
independent config files in a shared home directory,
and for the hostname to show up in the X title for window management.
This option has no effect in client mode.
.TP
.B \-s, \-\-server hostname
Run in client mode by connecting to and collecting data from a
.B gkrellmd
server on 
.I hostname
.TP
.B \-P, \-\-port server_port
Use
.I server_port
for the
.B gkrellmd
server connection.
.TP
.B \-nc
No config mode.  The config menu is blocked so no config changes
can be made.  Useful in certain environments, or maybe for running
on a
.BR xdm (1)
login screen or during a screensaver mode?
.TP
.B \-demo
Force enabling of many monitors so themers can see everything. All
config saving is inhibited.
.TP
.B \-p, \-\-plugin plugin.so
For plugin development, load the command line specified plugin so you
can avoid repeated install steps in the development cycle.

.SH "BUILTIN MONITORS"

.SS "Charts"
.PP
The default for most charts is to automatically adjust the number of
grid lines drawn and the resolution per grid so drawn data will be
nicely visible.  You may change this to fixed grids of 1-5 and/or
fixed grid resolutions in the chart configuration windows.  However,
some combination of the auto scaling modes may give best results.
.PP
Auto grid resolution has the following behavior.
.PP
.B Auto mode sticks at peak value
is not set:
.TP
.B ""
1) If using auto number of grids, set the resolution per grid and the
number of grids to optimize the visibility of data drawn on the chart.
Try to keep the number of grids between 1 and 7.
.TP
.B ""
2) If using a fixed number of grids, set the resolution per grid to the
smallest value that draws data without clipping.
.PP
.B Auto mode sticks at peak value
is set:
.TP
.B ""
1) If using auto number of grids, set the resolution per grid such that
drawing the peak value encountered would require at least 5 grids.
.TP
.B ""
2) If using a fixed number of grids, set the resolution per grid such
that the peak value encountered could be drawn without clipping.
This means the resolution per grid never decreases.
.PP
All resolution per grid values are constrained to a set of values in
either a 1, 2, 5 sequence or a 1, 1.5, 2, 3, 5, 7 sequence.  If you set
.B Auto mode sticks at peak value
a manual
.B Auto mode recalibrate
may occasionally be required if the chart data has a wide dynamic range.