bcal (Byte CALculator) is a REPL CLI utility for storage expression (e.g.
"(2GiB * 2) / (2KiB >> 2)") evaluation, SI/IEC conversion, byte address calculation, base conversion and LBA/CHS calculation. It's very useful for those who deal with bits, bytes, addresses and binary prefixes frequently.
bcal uses SI and IEC binary prefixes and supports 64-bit Operating Systems only.
bcal is written in C and depends on standard libc and libreadline. It invokes GNU
calc for non-storage expressions.
bcal from your package manager. If the version available is dated try an alternative installation method.
Install to default location (
$ make $ sudo make strip install
To uninstall, run:
$ sudo make uninstall
PREFIX is supported, in case you want to install to a different location.
bcal can be compiled and installed from source in the Termux environment on
aarch64 Android devices. Instructions:
$ wget https://github.com/jarun/bcal/archive/master.zip $ unzip bcal-master.zip $ cd bcal-master/ $ pkg install make clang readline-dev $ make strip install
usage: bcal [-c N] [-f loc] [-s bytes] [expr] [N [unit]] [-b [expr]] [-m] [-d] [-h] Storage expression calculator. positional arguments: expr expression in decimal/hex operands N [unit] capacity in B/KiB/MiB/GiB/TiB/kB/MB/GB/TB https://en.wikipedia.org/wiki/Binary_prefix default unit is B (byte), case is ignored N can be decimal or '0x' prefixed hex value optional arguments: -c N show +ve integer N in binary, decimal, hex -f loc convert CHS to LBA or LBA to CHS refer to the operational notes in man page -s bytes sector size [default 512] -b [expr] enter bc mode or evaluate expression in bc -m show minimal output (e.g. decimal bytes) -d enable debug information and logs -h show this help prompt keys: b toggle bc mode r show result from last operation s show sizes of storage types ? show prompt help q/double ↵ quit program
bcalenters the REPL mode if no arguments are provided. Storage unit conversion, base conversion and expression evaluation are supported in this mode. The last valid result is stored in the variable r.
%and C bitwise operators (except
~due to storage width dependency).
Ncan be a decimal or '0x' prefixed hex value.
unitcan be B/KiB/MiB/GiB/TiB/kB/MB/GB/TB. Default is Byte. As all of these tokens are unique,
0x, binary inputs with
__uint128_tis available or 64 bits for numerical conversions. Floating point operations use
long double. Negative values in storage expressions are unsupported. Only 64-bit operating systems are supported.
bcalshows the floor value of non-integer bytes.
lLBA-MAX_HEAD-MAX_SECTOR[NOTE: LBA starts with
cC-H-S-MAX_HEAD-MAX_SECTOR[NOTE: CHS starts with
-to the one following the last
-, is considered
c-50--0x12--> C = 0, H = 50, S = 0, MH = 0x12, MS = 0
l50-0x12-> LBA = 50, MH = 0x12, MS = 0
ris synced and can be used in expressions.
bcis not called in minimal output mode.
Evaluate arithmetic expression of storage units.
$ bcal "(5kb+2mb)/3" $ bcal "5 tb / 12" $ bcal "2.5mb*3" $ bcal "(2giB * 2) / (2kib >> 2)"
Convert storage capacity to other units and get address, LBA.
$ bcal 20140115 b $ bcal 0x1335053 B $ bcal 0xaabbcc kb $ bcal 0xdef Gib
Note that the units are case-insensitive.
Convert storage capacity, set sector size to 4096 to calculate LBA.
$ bcal 0xaabbcc kb -s 4096
Convert LBA to CHS.
$ bcal -f l500 $ bcal -f l0x600-18-0x7e $ bcal -f l0x300-0x12-0x7e
Convert CHS to LBA.
$ bcal -f c10-10-10 $ bcal -f c0x10-0x10-0x10 $ bcal -f c0x10-10-2-0x12 $ bcal -f c-10-2-0x12 $ bcal -f c0x10-10--0x12
Show binary, decimal and hex representations of a number.
$ bcal -c 20140115 $ bcal -c 0b1001100110101000001010011 $ bcal -c 0x1335053 bcal> c 20140115 // Interactive mode
$ bcal -b '3.5 * 2.1 + 5.7' bcal> b // Interactive mode bc vars: scale = 10, ibase = 10, last = r bc> 3.5 * 2.1 + 5.7
$ printf '15 kib + 15 gib \n r / 5' | bcal -m $ printf '15 + 15 + 2' | bcal -bm
Redirect from file.
$ cat expr 15 gib + 15 kib r / 5 $ bcal -m < expr
Use as a general-purpose calculator.
$ bcal -b
Due to the nature of the project, it's extremely important to test existing functionality before raising any PR.
bcal has several test cases written in
test.py. To execute the test cases locally, install
pytest and run:
$ make $ python3 -m pytest test.py
Copyright © 2016 Arun Prakash Jana