sys/man/8/statusbar

   1 .TH STATUSBAR 8
   2 .SH NAME
   3 statusbar \- display a bar graph status window
   4 .SH SYNOPSIS
   5 .B aux/statusbar
   6 [
   7 .B -kt
   8 ]
   9 [
  10 .B -w
  11 .I minx,miny,maxx,maxy
  12 ]
  13 .I title
  14 .SH DESCRIPTION
  15 .I Aux/statusbar
  16 reads textual status lines
  17 from standard input, converting them into a
  18 continuously updated bar graph displayed in a new window
  19 on the screen.
  20 The
  21 .I title
  22 is displayed on a line above the bar graph.
  23 Each input line is two space-separated decimal numbers:
  24 the numerator and denominator of a fraction.
  25 .PP
  26 .I Statusbar
  27 exits when it reaches end-of-file on standard input.
  28 Typing
  29 .SM DEL
  30 or control-C
  31 will also cause it to exit.
  32 .PP
  33 The options are:
  34 .TP
  35 .B -k
  36 do not allow typing to cause
  37 .I statusbar
  38 to exit
  39 .TP
  40 .B -t
  41 print an ASCII status bar to standard output, using
  42 backspace to redraw it
  43 .TP
  44 .B -w
  45 set the coordinates of the statusbar window created
  46 .PD
  47 .SH EXAMPLE
  48 The
  49 .B -v
  50 option to
  51 .IR hget (1)
  52 .\" and the
  53 .\" .B -d
  54 .\" option to
  55 .\" .IR venti/fmtarenas
  56 .\" and
  57 .\" .I venti/fmtisect
  58 .\" (see
  59 .\" .IR venti-fmt (8))
  60 causes it to print status lines suitable for
  61 input to
  62 .IR statusbar .
  63 .PP
  64 Monitor a long download:
  65 .IP
  66 .EX
  67 hget -v -o bigfile http://server.com/bigfile |[2]
  68   aux/statusbar 'big file download'
  69 .EE
  70 .SH SOURCE
  71 .B /sys/src/cmd/aux/statusbar.c