.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "MRTG-SENSORS 1" .TH MRTG-SENSORS 1 "2022-04-01" "mrtgutils 0.8.4" "MRTG helper utilities" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" mrtg\-sensors \- Returns data from lm\-sensors .SH "SYNOPSIS" .IX Header "SYNOPSIS" mrtg-sensors ([\fB\-m\fR multiplier])*2 chip label [chip label] .SH "DESCRIPTION" .IX Header "DESCRIPTION" mrtg-sensors uses the lm-sensors library to query various system sensors for information such as temperature, fan speed, etc. The output is written in a form useful as input for the \s-1MRTG\s0 utility. .PP Up to two pairs of chips and labels may be specified. The first is used for the incoming data value in \s-1MRTG,\s0 while the second is used for the outgoing data value. Of course, they need not correspond to incoming or outgoing data, that is merely what \s-1MRTG\s0 expects. .PP \&\*(L"chip\*(R" is the name of the chip to query, and \*(L"label\*(R" is the label of the piece of information that should be queried from the given chip. \fBsensors\fR\|(1) can be used to look up all available chips and labels on your system. .PP Wildcards may be used in chip names, but only the first matching chip will be queried. .PP If you use the special name \*(L"dummy\*(R" as a chip name, nothing will be queried, and a value of zero will be sent to \s-1MRTG.\s0 .IP "\fB\-m\fR \fImultiplier\fR" 4 .IX Item "-m multiplier" Sets the multiplier to be used in the output. For example, if the temperature is 59.2 and a multiplier of 100, the output would be 592. The option order is important, the first \-m will modify the first value and the second \-m, the second. Note that you may find it more useful to use \fBsensors.conf\fR\|(5) to set global multipliers for sensors. If it is defined once, affect both output values. The default multiplier is 1. .SH "EXAMPLES" .IX Header "EXAMPLES" .IP "mrtg-sensors dummy dummy adm9240\-\e* fan2" 4 .IX Item "mrtg-sensors dummy dummy adm9240-* fan2" Get the speed of fan #2 from the adm9240 chip. .IP "mrtg-sensors \-m 0.5 adm9240\-\e* fan1 adm9240\-\e* fan2" 4 .IX Item "mrtg-sensors -m 0.5 adm9240-* fan1 adm9240-* fan2" Get the speeds of both fan #1 and fan #2, halfing both. .IP "mrtg-sensors \-m 2 dummy dummy adm9240\-\e* temp" 4 .IX Item "mrtg-sensors -m 2 dummy dummy adm9240-* temp" Get the cpu temperature, and double it. .IP "mrtg-sensors \-m 0.5 adm9240\-\e* fan1 \-m 10 adm9240\-\e* temp" 4 .IX Item "mrtg-sensors -m 0.5 adm9240-* fan1 -m 10 adm9240-* temp" Get the fan #1 speed and halfing it, and the cpu temperature with one decimal (e.i multipled by 10). .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBsensors\fR\|(1) .PP \&\fBsensors.conf\fR\|(5) .SH "AUTHOR" .IX Header "AUTHOR" mrtg-sensors was written by Joey 'no pseudo\-code' Hess .