X-Git-Url: https://git.kernel.dk/?a=blobdiff_plain;f=README;h=25189f8e4a49294bc64d763c212047f398850410;hb=16dc07107d2abddccf7e42f684c16c3d8657b324;hp=4da0d249132ad0d327b0f157862a317a25bc9c6c;hpb=9aa5fe3290fd49c70e498d5e072a5b27e1c3034f;p=fio.git diff --git a/README b/README index 4da0d249..25189f8e 100644 --- a/README +++ b/README @@ -26,6 +26,18 @@ Snapshots can download from: http://brick.kernel.dk/snaps/ +There are also two official mirrors. Both of these are synced within +an hour of commits landing at git.kernel.dk. So if the main repo is +down for some reason, either one of those is safe to use: + + git://git.kernel.org/pub/scm/linux/kernel/git/axboe/fio.git + https://git.kernel.org/pub/scm/linux/kernel/git/axboe/fio.git + +or + + git://github.com/axboe/fio.git + https://github.com/axboe/fio.git + Binary packages --------------- @@ -101,6 +113,9 @@ To build FIO with a cross-compiler: $ make CROSS_COMPILE=/path/to/toolchain/prefix Configure will attempt to determine the target platform automatically. +It's possible to build fio for ESX as well, use the --esx switch to +configure. + Windows ------- @@ -134,7 +149,6 @@ $ fio --parse-only Parse options only, don't start any IO --output Write output to file --runtime Runtime in seconds - --latency-log Generate per-job latency logs --bandwidth-log Generate per-job bandwidth logs --minimal Minimal (terse) output --output-format=type Output format (terse,json,normal) @@ -142,6 +156,7 @@ $ fio --version Print version info and exit --help Print this page --cpuclock-test Perform test/validation of CPU clock + --crctest[=test] Test speed of checksum functions --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 @@ -158,10 +173,12 @@ $ fio --warnings-fatal Fio parser warnings are fatal --max-jobs Maximum number of threads/processes to support --server=args Start backend server. See Client/Server section. - --client=host Connect to specified backend. + --client=host Connect to specified backend(s). + --remote-config=file Tell fio server to load this local file --idle-prof=option Report cpu idleness on a system or percpu basis (option=system,percpu) or run unit work calibration only (option=calibrate). + --inflate-log=log Inflate and output compressed log Any parameters following the options will be assumed to be job files, @@ -195,6 +212,7 @@ Currently, additional logging is available for: time Dump info related to internal time keeping net Dump info related to networking connections rate Dump info related to IO rate switching + compress Dump info related to log compress/decompress ? or help Show available debug options. One can specify multiple debug options: e.g. --debug=file,mem will enable @@ -289,6 +307,39 @@ Fio can connect to multiple servers this way: fio --client= --client= +If the job file is located on the fio server, then you can tell the server +to load a local file as well. This is done by using --remote-config: + +fio --client=server --remote-config /path/to/file.fio + +Then fio will open this local (to the server) job file instead +of being passed one from the client. + +If you have many servers (example: 100 VMs/containers), +you can input a pathname of a file containing host IPs/names as the parameter +value for the --client option. For example, here is an example "host.list" +file containing 2 hostnames: + +host1.your.dns.domain +host2.your.dns.domain + +The fio command would then be: + +fio --client=host.list + +In this mode, you cannot input server-specific parameters or job files -- all +servers receive the same job file. + +In order to let fio --client runs use a shared filesystem +from multiple hosts, fio --client now prepends the IP address of the +server to the filename. For example, if fio is using directory /mnt/nfs/fio +and is writing filename fileio.tmp, with a --client hostfile containing +two hostnames h1 and h2 with IP addresses 192.168.10.120 and 192.168.10.121, +then fio will create two files: + + /mnt/nfs/fio/192.168.10.120.fileio.tmp + /mnt/nfs/fio/192.168.10.121.fileio.tmp + Platforms ---------