File: wmgtemp.1

package info (click to toggle)
wmgtemp 0.5-4
  • links: PTS
  • area: main
  • in suites: woody
  • size: 164 kB
  • ctags: 164
  • sloc: ansic: 1,358; makefile: 74
file content (120 lines) | stat: -rw-r--r-- 3,781 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
.\" Hey, Emacs!  This is an -*- nroff -*- source file.
.TH "wmgtemp" 1 "February 2001" ""
.SH NAME
wmgtemp \- Temperature sensor dock app for Window Maker
.SH SYNOPSIS
.B wmgtemp
.I "[options]"
.SH "DESCRIPTION"
wmgtemp is a dock-app for Window Maker that graphically displays the CPU and System temperatures using the lm_sensors package. It was originally intended to work with the VIA686A chipset but also supports some other sensors. It displays the CPU and System temperature values, a scaling graph of temperature history,high-temperature warning lights and temperatures in celcius, fahrenheit or kelvin.
.PP
The temperature graph is auto scaling, meaning that if the max or min temperature boundary is crossed the graph will be scaled to display the temperature. A red line marks the upper boundary whereas a blue line indicates the lower boundary. When all the temperatures being displayed are within the boundaries the graph will be scaled back to the preset values for min/max and the boundary indicator lines will be removed.
.PP
The high temperature warning lights located on the left of the temperature type indicators show amber or red when the warning or high temperatures are reached respectively. Normal operating temperature is indicated by no light.
.SH "OPTIONS"
.TP
.B \-h, \-\-help
display the usage information
.TP
.B \-s, \-\-scale=SCALE
show temperatures using SCALE temperature scale. SCALE=celcius, fahrenheit or kelvin.
.br
\fBDefault\fP: celcius
.TP
.B \-g, \-\-graph=STYLE
display graph as STYLE. STYLE=line or block.
.br
\fBDefault\fP: line
.TP

.B \-H, \-\-high=TEMP
display red warning light at TEMP degrees celcius.
.br
\fBDefault\fP: 50
.TP

.B \-w, \-\-warn=TEMP
display amber warning light at TEMP degrees celcius.
.br
\fBDefault\fP: 45

.TP
.B \-u, \-\-update=SEC
update the display every SEC seconds.
.br
\fBDefault\fP: 1

.TP
.B \-m, \-\-min=TEMP
set the lower bound of the graph to TEMP degrees celcius.
.br
\fBDefault\fP: 20

.TP
.B \-M, \-\-max=TEMP
set the upper bound of the graph to TEMP degrees celcius.
.br
\fBDefault\fP: 35

.TP
.B \-a, \-\-execat=TEMP
execute a command at TEMP degrees celcius.
.br
\fBDefault\fP: none

.TP
.B \-e, \-\-exec=COMMAND
execute COMMAND when the 'execat' temperature is reached.
.br
\fBDefault\fP: none

.TP
.B \-t, \-\-swap
swap/transpose temperature values

.PP
.SH FILES
~/.wmgtemprc	User configuration.
.PP
The format of this file is:
.nf
.IP
# wmgtemp example config
scale:celcius
graph:line
high:50
warn:45
update:sec
min:25
max:35
execat:80
exec:shutdown -h 10
swap:n
.PP
.SH USAGE
.SS Graph
You can cycle through the graph types by clicking on the graph display area.
.PP
.SS High Temperature Toggle
You can toggle the displaying of high temperatures by click on the temperature for the corrosponding temperature. The viewing of high temperatures is indicated by an amber arrow to the left of the temperature. The current temperatures will continue to be displayed on the graph.
.PP
.SH
.SS Temperature display TOGGLE
You may toggle the displaying of a temperature on the graph by clicking on the corrosponding type. e.g To toggle the display of the CPU temperature click on CPU. The type indicator (CPU or SYS) will disappear and the temperature will not be displayed on the graph, although the temperature value will continue to be displayed.
.PP
.SH
.SS Temperature Scale Cycling
You may change the scale the temperatures are displayed in by clicking on either of the CPU or SYS scale indicators. The cycle order is \fBC\fP -> \fBK\fP -> \fBF\fP
.PP
.SH SUPPORTED SENSORS
VIA686A, W83781D, W83627HF, AS99127F, ADM1021
.PP
.SH BUGS
Blank lines in the config file cause a Segmentation Fault.
.PP
.SH SEE ALSO
.BR wmaker (1x)
.SH AUTHOR
wmgtemp was written by Roger Dunce <kronos@nanunanu.org>