From 8116fd24b737c9d878ccb6a4cc13cc4f974dc2dc Mon Sep 17 00:00:00 2001 From: Jens Axboe Date: Thu, 3 Mar 2016 14:00:54 -0700 Subject: [PATCH] Update documentation for random_distribution=gauss For some reason this was never committed, add it now. Signed-off-by: Jens Axboe --- HOWTO | 5 ++++- fio.1 | 16 ++++++++++------ 2 files changed, 14 insertions(+), 7 deletions(-) diff --git a/HOWTO b/HOWTO index c37a9e09..d70c9afe 100644 --- a/HOWTO +++ b/HOWTO @@ -963,6 +963,7 @@ random_distribution=str:float By default, fio will use a completely uniform random Uniform random distribution zipf Zipf distribution pareto Pareto distribution + gauss Normal (guassian) distribution When using a zipf or pareto distribution, an input value is also needed to define the access pattern. For zipf, this @@ -971,7 +972,9 @@ random_distribution=str:float By default, fio will use a completely uniform what the given input values will yield in terms of hit rates. If you wanted to use zipf with a theta of 1.2, you would use random_distribution=zipf:1.2 as the option. If a non-uniform - model is used, fio will disable use of the random map. + model is used, fio will disable use of the random map. For + the gauss distribution, a normal deviation is supplied as + a value between 0 and 100. percentage_random=int For a random workload, set how big a percentage should be random. This defaults to 100%, in which case the workload diff --git a/fio.1 b/fio.1 index f98802aa..81c266b8 100644 --- a/fio.1 +++ b/fio.1 @@ -874,15 +874,19 @@ Zipf distribution .B pareto Pareto distribution .TP +.B gauss +Normal (gaussian) distribution +.TP .RE .P -When using a zipf or pareto distribution, an input value is also needed to -define the access pattern. For zipf, this is the zipf theta. For pareto, -it's the pareto power. Fio includes a test program, genzipf, that can be -used visualize what the given input values will yield in terms of hit rates. -If you wanted to use zipf with a theta of 1.2, you would use +When using a \fBzipf\fR or \fBpareto\fR distribution, an input value is also +needed to define the access pattern. For \fBzipf\fR, this is the zipf theta. +For \fBpareto\fR, it's the pareto power. Fio includes a test program, genzipf, +that can be used visualize what the given input values will yield in terms of +hit rates. If you wanted to use \fBzipf\fR with a theta of 1.2, you would use random_distribution=zipf:1.2 as the option. If a non-uniform model is used, -fio will disable use of the random map. +fio will disable use of the random map. For the \fBgauss\fR distribution, a +normal deviation is supplied as a value between 0 and 100. .TP .BI percentage_random \fR=\fPint For a random workload, set how big a percentage should be random. This defaults -- 2.25.1