.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32) .\" .\" 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 .. .if !\nF .nr F 0 .if \nF>0 \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} .\} .\" .\" 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 "TORRUS_SRVDERIVE 8" .TH TORRUS_SRVDERIVE 8 "2016-11-17" "torrus 2.09" "torrus" .\" 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" srvderive \- Derive a new service ID from sum or maximum of other service values .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBtorrus srvderive\fR \fI\s-1TIMESPAN\s0\fR \fI\s-1OUTPUT\s0\fR \fI\s-1FUNCTION\s0\fR \fI\s-1SOURCES\s0\fR... .SH "DESCRIPTION" .IX Header "DESCRIPTION" When the Torrus Reporting engine is set up, this command is used to combine several services data into a new service \s-1ID.\s0 The output data is either the maximum or the sum of input services. .PP See \fITorrus Reporting Setup Guide\fR for more information. .SH "TIMESPAN" .IX Header "TIMESPAN" Either \-\-month or \-\-end option must be defined .IP "\fB\-\-start\fR=\fIYYYY-MM-DD\fR" 4 .IX Item "--start=YYYY-MM-DD" Sets the start date of the calculation. .IP "\fB\-\-end\fR=\fIYYYY-MM-DD\fR" 4 .IX Item "--end=YYYY-MM-DD" Sets the next day after the eond of the period. .IP "\fB\-\-month\fR" 4 .IX Item "--month" Instead of setting the end data, it is convenient to use this option. It sets the end data in one calendar month after the start date. .SH "OUTPUT" .IX Header "OUTPUT" .IP "\fB\-\-out\fR=\fI\s-1SERVICEID\s0\fR" 4 .IX Item "--out=SERVICEID" Sets the output service \s-1ID.\s0 This should not be a service \s-1ID\s0 used in the Torrus datasource trees. \fBNote:\fR if \fIsrvderive\fR command is run twice with the same arguments, the produced data is doubled for the output service \s-1ID.\s0 .SH "FUNCTION" .IX Header "FUNCTION" .ie n .IP "\fB\-\-func\fR=""MAX""|""SUM""" 4 .el .IP "\fB\-\-func\fR=\f(CWMAX\fR|\f(CWSUM\fR" 4 .IX Item "--func=MAX|SUM" Sets the function to be used when combining the input service data. Currently only \f(CW\*(C`MAX\*(C'\fR and \f(CW\*(C`SUM\*(C'\fR are supportted. .SH "SOURCES" .IX Header "SOURCES" .IP "\fB\-\-in\fR=\fI\s-1SERVICEID\s0\fR ..." 4 .IX Item "--in=SERVICEID ..." Input service IDs are specified either by \fB\-\-in\fR option, or as command line arguments. At least 2 input service IDs should be specified. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-\-step\fR" 4 .IX Item "--step" Default: 300. Sets the data interval for derived service \s-1ID.\s0 It is recommended to leave this option at default value. .IP "\fB\-\-verbose\fR" 4 .IX Item "--verbose" Prints extra informatgion. .IP "\fB\-\-debug\fR" 4 .IX Item "--debug" Prints debugging information. .IP "\fB\-\-help\fR" 4 .IX Item "--help" Prints command usage information. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fItorrus\fR\|(8) .SH "NOTES" .IX Header "NOTES" See more documentation at Torrus home page: http://torrus.org .SH "AUTHOR" .IX Header "AUTHOR" Stanislav Sinyagin