X-Git-Url: https://git.kernel.dk/?p=fio.git;a=blobdiff_plain;f=README;h=2a245dce1850bd7bc7e265d35d4616a828c65d3a;hp=d6ff1096ce4c8482adab333b626e8aac2f2fd07c;hb=e29d1b70a21e29801fb35dfbc1b236b7c8514055;hpb=c6ae0a5b8123ea9af2ce70319081fbd5d65c8093 diff --git a/README b/README index d6ff1096..2a245dce 100644 --- a/README +++ b/README @@ -46,7 +46,6 @@ $ fio -t Runtime in seconds -l Generate per-job latency logs -w Generate per-job bandwidth logs - -f Read for job descriptions -o Log output to file -m Minimal (terse) output -h Print help info @@ -89,6 +88,8 @@ The job file parameters are: usb-storage or sata/libata driven) devices. iodepth=x For async io, allow 'x' ios in flight overwrite=x If 'x', layout a write file first. + nrfiles=x Spread io load over 'x' number of files per job, + if possible. prio=x Run io at prio X, 0-7 is the kernel allowed range prioclass=x Run io at prio class X bs=x Use 'x' for thread blocksize. May include k/m postfix. @@ -102,7 +103,9 @@ The job file parameters are: cpumask=x Only allow job to run on CPUs defined by mask. fsync=x If writing, fsync after every x blocks have been written startdelay=x Start this thread x seconds after startup - timeout=x Terminate x seconds after startup + timeout=x Terminate x seconds after startup. Can include a + normal time suffix if not given in seconds, such as + 'm' for minutes, 'h' for hours, and 'd' for days. offset=x Start io at offset x (x string can include k/m/g) invalidate=x Invalidate page cache for file prior to doing io sync=x Use sync writes if x and writing @@ -112,6 +115,7 @@ The job file parameters are: bwavgtime=x Average bandwidth stats over an x msec window. create_serialize=x If 'x', serialize file creation. create_fsync=x If 'x', run fsync() after file creation. + unlink If set, unlink files when done. end_fsync=x If 'x', run fsync() after end-of-job. loops=x Run the job 'x' number of times. verify=x If 'x' == md5, use md5 for verifies. If 'x' == crc32, @@ -141,6 +145,9 @@ The job file parameters are: exec_prerun=x Run 'x' before job io is begun. exec_postrun=x Run 'x' after job io has finished. ioscheduler=x Use ioscheduler 'x' for this job. + cpuload=x For a CPU io thread, percentage of CPU time to attempt + to burn. + cpuchunks=x Split burn cycles into pieces of x. Examples using a job file @@ -332,11 +339,11 @@ Split up, the format is as follows: Author ------ -Fio was written by Jens Axboe to enable flexible testing +Fio was written by Jens Axboe to enable flexible testing of the Linux IO subsystem and schedulers. He got tired of writing specific test applications to simulate a given workload, and found that the existing io benchmark/test tools out there weren't flexible enough to do what he wanted. -Jens Axboe 20060609 +Jens Axboe 20060905