RE: [PATCH 2/4] HOWTO: fix unit type suffix in "Parameter types" section

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 




> -----Original Message-----
> From: fio-owner@xxxxxxxxxxxxxxx [mailto:fio-owner@xxxxxxxxxxxxxxx] On Behalf
> Of kusumi.tomohiro@xxxxxxxxx
> Sent: Monday, August 07, 2017 12:38 PM
> To: axboe@xxxxxxxxx; fio@xxxxxxxxxxxxxxx
> Cc: Tomohiro Kusumi <tkusumi@xxxxxxxxxx>
> Subject: [PATCH 2/4] HOWTO: fix unit type suffix in "Parameter types" section
> 
> From: Tomohiro Kusumi <tkusumi@xxxxxxxxxx>
> 
> These should be all in lower case or all in upper case, but not both.
> Given the examples of these are mostly in lower case, this commit
> uses lower.
> 
> The man page already has these in lower case.
> 
> Signed-off-by: Tomohiro Kusumi <tkusumi@xxxxxxxxxx>
> ---
>  HOWTO | 18 +++++++++---------
>  1 file changed, 9 insertions(+), 9 deletions(-)
> 
> diff --git a/HOWTO b/HOWTO
> index ee2b996..cad9500 100644
> --- a/HOWTO
> +++ b/HOWTO
> @@ -505,19 +505,19 @@ Parameter types
>  	prefixes.  To specify power-of-10 decimal values defined in the
>  	International System of Units (SI):
> 
> -		* *Ki* -- means kilo (K) or 1000
> -		* *Mi* -- means mega (M) or 1000**2
> -		* *Gi* -- means giga (G) or 1000**3
> -		* *Ti* -- means tera (T) or 1000**4
> -		* *Pi* -- means peta (P) or 1000**5
> +		* *ki* -- means kilo (K) or 1000
> +		* *mi* -- means mega (M) or 1000**2
> +		* *gi* -- means giga (G) or 1000**3
> +		* *ti* -- means tera (T) or 1000**4
> +		* *pi* -- means peta (P) or 1000**5
> 
>  	To specify power-of-2 binary values defined in IEC 80000-13:
> 
>  		* *k* -- means kibi (Ki) or 1024
> -		* *M* -- means mebi (Mi) or 1024**2
> -		* *G* -- means gibi (Gi) or 1024**3
> -		* *T* -- means tebi (Ti) or 1024**4
> -		* *P* -- means pebi (Pi) or 1024**5
> +		* *m* -- means mebi (Mi) or 1024**2
> +		* *g* -- means gibi (Gi) or 1024**3
> +		* *t* -- means tebi (Ti) or 1024**4
> +		* *p* -- means pebi (Pi) or 1024**5
> 
>  	With :option:`kb_base`\=1024 (the default), the unit prefixes are
> opposite
>  	from those specified in the SI and IEC 80000-13 standards to provide
> --

SI prefixes are case-sensitive, with several conflicts:
* m means milli (10**-3)
* p means pico (10**-12)

and more looming if fio ever suported even bigger quantities:
* z means zepto (10**-21) vs. zetta (10**21)
* y means yocto (10**-24) vs. yotta (10**24)

Since fio never deals with subdivisions of a byte, it allows the
job file to be sloppy and use the wrong case.  However, I recommend
that we stick to the correct capitalization in the documentation.


---
Robert Elliott, HPE Persistent Memory


--
To unsubscribe from this list: send the line "unsubscribe fio" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Linux Kernel]     [Linux SCSI]     [Linux IDE]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux SCSI]

  Powered by Linux