man-pages.7: wfix: s/null character/null byte/
[man-pages.git] / man7 / units.7
blob7c1c1a6a0143117ff7aeadeff8da79eeab98c7b2
1 .\" Copyright (C) 2001 Andries Brouwer <aeb@cwi.nl>
2 .\"
3 .\" %%%LICENSE_START(VERBATIM)
4 .\" Permission is granted to make and distribute verbatim copies of this
5 .\" manual provided the copyright notice and this permission notice are
6 .\" preserved on all copies.
7 .\"
8 .\" Permission is granted to copy and distribute modified versions of this
9 .\" manual under the conditions for verbatim copying, provided that the
10 .\" entire resulting derived work is distributed under the terms of a
11 .\" permission notice identical to this one.
12 .\"
13 .\" Since the Linux kernel and libraries are constantly changing, this
14 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
15 .\" responsibility for errors or omissions, or for damages resulting from
16 .\" the use of the information contained herein.  The author(s) may not
17 .\" have taken the same level of care in the production of this manual,
18 .\" which is licensed free of charge, as they might when working
19 .\" professionally.
20 .\"
21 .\" Formatted or processed versions of this manual, if unaccompanied by
22 .\" the source, must acknowledge the copyright and authors of this work.
23 .\" %%%LICENSE_END
24 .\"
25 .TH UNITS 7 2020-08-13 "Linux" "Linux Programmer's Manual"
26 .SH NAME
27 units \- decimal and binary prefixes
28 .SH DESCRIPTION
29 .SS Decimal prefixes
30 The SI system of units uses prefixes that indicate powers of ten.
31 A kilometer is 1000 meter, and a megawatt is 1000000 watt.
32 Below the standard prefixes.
33 .RS
34 .TS
35 l l l.
36 Prefix  Name    Value
37 y       yocto   10^\-24 = 0.000000000000000000000001
38 z       zepto   10^\-21 = 0.000000000000000000001
39 a       atto    10^\-18 = 0.000000000000000001
40 f       femto   10^\-15 = 0.000000000000001
41 p       pico    10^\-12 = 0.000000000001
42 n       nano    10^\-9  = 0.000000001
43 \(mc    micro   10^\-6  = 0.000001
44 m       milli   10^\-3  = 0.001
45 c       centi   10^\-2  = 0.01
46 d       deci    10^\-1  = 0.1
47 da      deka    10^ 1  = 10
48 h       hecto   10^ 2  = 100
49 k       kilo    10^ 3  = 1000
50 M       mega    10^ 6  = 1000000
51 G       giga    10^ 9  = 1000000000
52 T       tera    10^12  = 1000000000000
53 P       peta    10^15  = 1000000000000000
54 E       exa     10^18  = 1000000000000000000
55 Z       zetta   10^21  = 1000000000000000000000
56 Y       yotta   10^24  = 1000000000000000000000000
57 .TE
58 .RE
59 .PP
60 The symbol for micro is the Greek letter mu, often written u
61 in an ASCII context where this Greek letter is not available.
62 See also
63 .PP
64 .RS
65 .UR http://physics.nist.gov\:/cuu\:/Units\:/prefixes.html
66 .UE
67 .RE
68 .SS Binary prefixes
69 The binary prefixes resemble the decimal ones,
70 but have an additional \(aqi\(aq
71 (and "Ki" starts with a capital \(aqK\(aq).
72 The names are formed by taking the
73 first syllable of the names of the decimal prefix with roughly the same
74 size, followed by "bi" for "binary".
75 .RS
76 .TS
77 l l l.
78 Prefix  Name    Value
79 Ki      kibi    2^10 = 1024
80 Mi      mebi    2^20 = 1048576
81 Gi      gibi    2^30 = 1073741824
82 Ti      tebi    2^40 = 1099511627776
83 Pi      pebi    2^50 = 1125899906842624
84 Ei      exbi    2^60 = 1152921504606846976
85 .TE
86 .RE
87 .PP
88 See also
89 .PP
90 .UR http://physics.nist.gov\:/cuu\:/Units\:/binary.html
91 .UE
92 .SS Discussion
93 Before these binary prefixes were introduced, it was fairly
94 common to use k=1000 and K=1024, just like b=bit, B=byte.
95 Unfortunately, the M is capital already, and cannot be
96 capitalized to indicate binary-ness.
97 .PP
98 At first that didn't matter too much, since memory modules
99 and disks came in sizes that were powers of two, so everyone
100 knew that in such contexts "kilobyte" and "megabyte" meant
101 1024 and 1048576 bytes, respectively.
102 What originally was a
103 sloppy use of the prefixes "kilo" and "mega" started to become
104 regarded as the "real true meaning" when computers were involved.
105 But then disk technology changed, and disk sizes became arbitrary numbers.
106 After a period of uncertainty all disk manufacturers settled on the
107 standard, namely k=1000, M=1000\ k, G=1000\ M.
109 The situation was messy: in the 14k4 modems, k=1000; in the 1.44\ MB
110 .\" also common: 14.4k modem
111 diskettes, M=1024000; and so on.
112 In 1998 the IEC approved the standard
113 that defines the binary prefixes given above, enabling people
114 to be precise and unambiguous.
116 Thus, today, MB = 1000000\ B and MiB = 1048576\ B.
118 In the free software world programs are slowly
119 being changed to conform.
120 When the Linux kernel boots and says
122 .in +4n
124 hda: 120064896 sectors (61473 MB) w/2048KiB Cache
128 the MB are megabytes and the KiB are kibibytes.