2024-02-15 06:31:54 +00:00
|
|
|
.\" Copyright (c) 2024 Emma Tebibyte <emma@tebibyte.media>
|
|
|
|
.\"
|
|
|
|
.\" This work is licensed under CC BY-SA 4.0. To see a copy of this license,
|
|
|
|
.\" visit <http://creativecommons.org/licenses/by-sa/4.0/>.
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-06-06 19:32:54 +00:00
|
|
|
.TH HRU 1 2024-06-06 "Bonsai Core Utilites 0.13.8"
|
2024-02-15 06:31:54 +00:00
|
|
|
.SH NAME
|
|
|
|
hru \(en human readable units
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-02-15 06:31:54 +00:00
|
|
|
.SH SYNOPSIS
|
2024-06-04 05:07:19 +00:00
|
|
|
|
2024-02-15 06:31:54 +00:00
|
|
|
hru
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-02-15 06:31:54 +00:00
|
|
|
.SH DESCRIPTION
|
2024-06-04 05:07:19 +00:00
|
|
|
|
2024-03-27 01:22:30 +00:00
|
|
|
Convert counts to higher units.
|
2024-06-04 05:07:19 +00:00
|
|
|
|
2024-03-27 01:22:30 +00:00
|
|
|
The program will read byte counts in the form of whole numbers from the standard
|
2024-06-03 00:47:14 +00:00
|
|
|
input and write to the standard output the same number converted to a higher
|
2024-03-27 01:22:30 +00:00
|
|
|
unit of data as defined by the International System of Units.
|
2024-06-04 05:07:19 +00:00
|
|
|
|
2024-02-18 21:59:12 +00:00
|
|
|
The program will convert the byte count to the highest unit possible where the
|
|
|
|
value is greater than one.
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-02-15 06:31:54 +00:00
|
|
|
.SH DIAGNOSTICS
|
2024-06-04 05:07:19 +00:00
|
|
|
|
2024-03-27 01:22:30 +00:00
|
|
|
If encountering non-integer characters in the standard input, the program will
|
2024-06-04 05:52:28 +00:00
|
|
|
exit with the appropriate error code as defined by
|
|
|
|
.BR sysexits.h (3)
|
|
|
|
and print an error message.
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-02-15 06:31:54 +00:00
|
|
|
.SH RATIONALE
|
2024-06-04 05:07:19 +00:00
|
|
|
|
2024-06-04 05:52:28 +00:00
|
|
|
The GNU project\(cqs
|
|
|
|
.BR ls (1)
|
|
|
|
implementation contains a human-readable option (\fB-h\fP) that, when specified,
|
2024-06-06 05:07:15 +00:00
|
|
|
makes the tool print size information in a format more immediately
|
|
|
|
readable. This functionality is useful not only in the context of
|
2024-06-04 05:52:28 +00:00
|
|
|
.BR ls (1)
|
|
|
|
so the decision was made to split it into a new tool. The original functionality
|
|
|
|
in GNU\(cqs
|
|
|
|
.BR ls (1)
|
|
|
|
can be emulated with
|
|
|
|
.BR fop (1)
|
|
|
|
combined with this program.
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-02-15 06:31:54 +00:00
|
|
|
.SH STANDARDS
|
2024-06-04 05:07:19 +00:00
|
|
|
|
2024-03-27 01:22:30 +00:00
|
|
|
The standard unit prefixes as specified by the Bureau International des Poids
|
2024-06-04 05:52:28 +00:00
|
|
|
et Mesures (BIPM) in the ninth edition of The International System of Units (SI)
|
|
|
|
are utilized for the ouput of conversions.
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-02-15 06:31:54 +00:00
|
|
|
.SH AUTHOR
|
2024-06-04 05:07:19 +00:00
|
|
|
|
2024-06-03 00:47:14 +00:00
|
|
|
Written by Emma Tebibyte
|
|
|
|
.MT emma@tebibyte.media
|
|
|
|
.ME .
|
|
|
|
.\"
|
2024-02-15 06:31:54 +00:00
|
|
|
.SH COPYRIGHT
|
2024-06-04 05:07:19 +00:00
|
|
|
|
2024-06-03 00:47:14 +00:00
|
|
|
Copyright \(co 2024 Emma Tebibyte. License AGPLv3+: GNU AGPL version 3 or later
|
2024-02-15 06:31:54 +00:00
|
|
|
<https://gnu.org/licenses/agpl.html>.
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-02-15 06:31:54 +00:00
|
|
|
.SH SEE ALSO
|
2024-06-03 00:47:14 +00:00
|
|
|
GNU
|
|
|
|
.BR ls (1),
|
|
|
|
The International System of Units (SI) 9th Edition
|