summaryrefslogtreecommitdiff
path: root/humanify.1
blob: dcb80fb05a123fe18f09b833a630f52071b0e832 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
.\" Copyright 2011 Lars Wirzenius <liw@liw.fi>
.\" 
.\" This program is free software: you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation, either version 3 of the License, or
.\" (at your option) any later version.
.\" 
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\" 
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
.\"
.TH HUMANIFY 1
.SH NAME
humanify \- format bit- and byte-sizes into human-readable form
.SH SYNOPSIS
.B humanify
.RB [ \-\-binary ]
.RI [ size ...]
.SH DESCRIPTION
.B humanify
formats in human-readable form data sizes (number of bits or bytes).
For example,
it can turn
.I 1234
into
.I "1 kB"
or
.IR "1 KiB" .
Sizes are given on the command line,
or one-per line in the standard input.
Sizes are rounded to the nearest integer.
.SH OPTIONS
.TP
.BR \-\-binary
Use 2-based prefixes (from IEC),
rather than 10-based ones (from ISO).
In other words, "kibibyte" instead of "kilobyte".
.TP
.BR \-\-bits
Inputs give number of bits, instead of bytes.