human

convert bytes to human readable formats
git clone git://git.2f30.org/human
Log | Files | Refs | README | LICENSE

human.1 (1087B)


      1 .TH human 1 2014-09-03 "v3.0" "Human manual"
      2 .SH NAME
      3 human \- output a number in human-readable format
      4 .SH SYNOPSIS
      5 .B human
      6 .RI [ \-hbkmgtpe ]\ [ numbers ]
      7 .SH DESCRIPTION
      8 .PP
      9 .B human
     10 takes numbers as arguments on the CLI, or from stdin, and output it in a human
     11 readable format.
     12 .TP
     13 .B \-h
     14 Displays a help text
     15 .TP
     16 .B \-b, -k, -m, -g, -t, -p, -e
     17 Force output in, respectively, Bytes, KiB, MiB, GiB, TiB, PiB or EiB.
     18 .SH ENVIRONMENT
     19 .B SCALE
     20 The special variable SCALE will allow you to choose how many numbers you want after the decimal point.
     21 .SH EXAMPLES
     22 .TP
     23 \(buOutput a number in its best factorization form:
     24 .EX
     25 \fBhuman \fR12345
     26 \fR12K
     27 .EE
     28 .TP
     29 \(buOutput a number with \fI3\fR numbers after the decimal point:
     30 .EX
     31 \fRSCALE=\-3 \fBhuman \fR12345
     32 \fR12.056K
     33 .EE
     34 .TP
     35 \(buOutput a number in MiB, no matter what.
     36 .EX
     37 \fBhuman \fR-m 1234567890
     38 1177M
     39 .EE
     40 .TP
     41 \(buConvert a number from Mib to bytes
     42 .EX
     43 \fBhuman \fR-b 128M
     44 134217728
     45 .EE
     46 .SH REPORTING BUGS
     47 If you encounter any bugs, feel free to report them at \fIdev@z3bra.org\fR
     48 .SH AUTHORS / CONTRIBUTORS
     49 Willy Goiffon, Pranomostro