.\" 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-UPTIME 1" .TH MRTG-UPTIME 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\-uptime \- Returns uptime and idle data from /proc/uptime .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBmrtg-uptime\fR ([\fB\-t\fR sys|idle] [\fB\-m\fR \fImultiplier\fR] [\fB\-u\fR s|m|h|d])*2 [\fB\-c\fR \fI#cores\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" mrtg-uptime returns the information from /proc/uptime. The output is written in a form useful as input for the \s-1MRTG\s0 utility. Every parameter can be accepted twice and allow to control the two values in the output, with the exception of \fB\-c\fR that only affects idle uptime. .IP "\fB\-t\fR sys|idle" 4 .IX Item "-t sys|idle" Sets the uptime parameter in the output. If just one is set, the other one will be zero. The parameter \fBsys\fR refers to the time the system has been up. The parameter \fBidle\fR refers to the time the machine has spent idle. .IP "\fB\-m\fR \fImultiplier\fR" 4 .IX Item "-m multiplier" Sets the multiplier to be used in the output. For example, if the value is 280936.41 and a multiplier of 100, the output would be 28093641. If it is defined once, affect both output values. The default multiplier is 1. .IP "\fB\-u\fR s|m|h|d" 4 .IX Item "-u s|m|h|d" Sets the unit of the parameter. It can be expressed in (s)econds, (m)inutes, (h)ours, or (d)ays. If it is defined once, affect both output values. The default is seconds. .IP "\fB\-c\fR \fI#cores\fR" 4 .IX Item "-c #cores" Because the idle uptime measures the cumulative time each processor, ignoring the amount of cores, the resulting value is the sum of how much time each core has spent idle. This parameter divides the value by \fI#cores\fR (an integer) to get the average idle time per core. Default is 1. .SH "EXAMPLES" .IX Header "EXAMPLES" Prints the average idle uptime of a core in a dual-core and the system uptime, both in minutes. .Sp .RS 4 mrtg-uptime \-t idle \-t sys \-u m \-c 2 .RE .PP Prints the uptime in hours and in seconds. .Sp .RS 4 mrtg-uptime \-t sys \-u h \-t sys \-u s .RE .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBmrtg\fR\|(1) .SH "AUTHORS" .IX Header "AUTHORS" Randolph Chung is the orginal writer of mrtgutils. .PP Luciano Bello wrote mrtg-uptime and this manpage. .SH "HISTORY" .IX Header "HISTORY" This document first appeared with mrtgutils\-0.8.2