SYNOPSIS

  echo <percentage> | dbar [options] <indicator text>

DESCRIPTION

dbar lets you define static 0% and 100% marks or you can define these marks dynamically at runtime. Static and dynamic marks can be mixed, in this case the value specified at runtime will have a higher priority.

You can specify ranges of numbers, negative, positive or ranges with a negative min value and positive max value.

All numbers are treated as double precision floating point, i.e. the input is \s-1NOT\s0 limited to integers.

OPTIONS

-l

Label to be prepended to the bar (default: "" ).

-nonl

no new line, don't put '\n' at the end of the bar (default: do print \*(L"\n\*(R")

-max

Value to be considered 100% (default: 100).

-min

Value to be considered 0% (default: 0).

-s

Symbol represeting the percentage value in the meter (default: \*(L"=\*(R").

-w

Number of charcaters to be considered 100% in the meter (default: 25)

EXAMPLES

Static 100% mark or single value input:

echo 25 | dbar -max 100 -l text

Output: text 25% [====== ]

If your 100% mark changes dynamically or 2-values input:

echo "50 150" | dbar | | | |_\|_ max value | |_\|_ value to display

Output: 33% [======== ]

If your value range is not between [0, maxval] or 3-values input:

echo "50 -25 150" | dbar | | | | | |_\|_ max value 100% mark | | | |_\|_\|_\|_\|_ min value 0% mark | |_\|_\|_\|_\|_\|_\|_\|_ value to display

Output: 43% [=========== ]

Multiple runs:

for i in 2 20 50 75 80; do echo $i; sleep 1; done | dbar | dzen2

Output: Find out yourself.

ENVIRONMENT

None.

FILES

None.

RELATED TO dbar…

dzen2\|(1)

AUTHORS

Program was written by Robert Manea <[email protected]>.

This manual page was written by Jari Aalto <[email protected]> for the Debian \s-1GNU\s0 system (but may be used by others). Released under license \s-1GNU\s0 \s-1GPL\s0 version 2 or (at your option) any later version. For more information about license, visit <http://www.gnu.org/copyleft/gpl.html>.