From 23893646c9306b785f866fb9e976f3db673af0ca Mon Sep 17 00:00:00 2001 From: Jens Axboe Date: Mon, 17 Dec 2012 14:44:08 +0100 Subject: [PATCH] Add --cpuclock-test and clocksource= option help Signed-off-by: Jens Axboe --- HOWTO | 16 ++++++++++++++++ README | 1 + fio.1 | 21 +++++++++++++++++++++ init.c | 3 ++- 4 files changed, 40 insertions(+), 1 deletion(-) diff --git a/HOWTO b/HOWTO index b3496201..0930f337 100644 --- a/HOWTO +++ b/HOWTO @@ -1262,6 +1262,22 @@ percentile_list=float_list Overwrite the default list of percentiles the values of completion latency below which 99.5% and 99.9% of the observed latencies fell, respectively. +clocksource=str Use the given clocksource as the base of timing. The + supported options are: + + gettimeofday gettimeofday(2) + + clock_gettime clock_gettime(2) + + cpu Internal CPU clock source + + cpu is the preferred clocksource if it is reliable, as it + is very fast (and fio is heavy on time calls). Fio will + automatically use this clocksource if it's supported and + considered reliable on the system it is running on, unless + another clocksource is specifically set. For x86/x86-64 CPUs, + this means supporting TSC Invariant. + gtod_reduce=bool Enable all of the gettimeofday() reducing options (disable_clat, disable_slat, disable_bw) plus reduce precision of the timeout somewhat to really shrink diff --git a/README b/README index ceac3857..7c4552d9 100644 --- a/README +++ b/README @@ -129,6 +129,7 @@ $ fio --terse-version=type Terse version output format (default 3, or 2 or 4). --version Print version info and exit --help Print this page + --cpuclock-test Perform test/validation of CPU clock --cmdhelp=cmd Print command help, "all" for all of them --enghelp=engine Print ioengine help, or list available ioengines --enghelp=engine,cmd Print help for an ioengine cmd diff --git a/fio.1 b/fio.1 index b7abc4b6..22c32fd0 100644 --- a/fio.1 +++ b/fio.1 @@ -1027,6 +1027,27 @@ given time in milliseconds. .BI disk_util \fR=\fPbool Generate disk utilization statistics if the platform supports it. Default: true. .TP +.BI clocksource \fR=\fPstr +Use the given clocksource as the base of timing. The supported options are: +.RS +.TP +.B gettimeofday +gettimeofday(2) +.TP +.B clock_gettime +clock_gettime(2) +.TP +.B cpu +Internal CPU clock source +.TP +.RE +.P +\fBcpu\fR is the preferred clocksource if it is reliable, as it is very fast +(and fio is heavy on time calls). Fio will automatically use this clocksource +if it's supported and considered reliable on the system it is running on, +unless another clocksource is specifically set. For x86/x86-64 CPUs, this +means supporting TSC Invariant. +.TP .BI gtod_reduce \fR=\fPbool Enable all of the gettimeofday() reducing options (disable_clat, disable_slat, disable_bw) plus reduce precision of the timeout somewhat to really shrink the diff --git a/init.c b/init.c index c894af3a..e7b3303e 100644 --- a/init.c +++ b/init.c @@ -1260,6 +1260,7 @@ static void usage(const char *name) printf(" --terse-version=x\tSet terse version output format to 'x'\n"); printf(" --version\t\tPrint version info and exit\n"); printf(" --help\t\tPrint this page\n"); + printf(" --cpuclock-test\tPerform test/validation of CPU clock\n"); printf(" --cmdhelp=cmd\t\tPrint command help, \"all\" for all of" " them\n"); printf(" --enghelp=engine\tPrint ioengine help, or list" @@ -1280,7 +1281,7 @@ static void usage(const char *name) printf(" --daemonize=pidfile\tBackground fio server, write pid to file\n"); printf(" --client=hostname\tTalk to remote backend fio server at hostname\n"); printf("\nFio was written by Jens Axboe "); - printf("\n Jens Axboe \n"); + printf("\n Jens Axboe \n"); } #ifdef FIO_INC_DEBUG -- 2.25.1