OS Manuals

/usr/bin/fio

Flexible I/O Tester

From fio 3.43-r0 (os), captured 2026-11-05 by running fio --help (exit 0). permalink

fio-3.43
/usr/bin/fio [options] [job options] <job file(s)>
  --debug=options	Enable debug logging. May be one/more of:
			process,file,io,mem,blktrace,verify,random,parse,
			diskutil,job,mutex,profile,time,net,rate,compress,
			steadystate,helperthread,zbd,sprandom
  --parse-only		Parse options only, don't start any IO
  --merge-blktrace-only	Merge blktraces only, don't start any IO
  --output		Write output to file
  --bandwidth-log	Generate aggregate bandwidth logs
  --minimal		Minimal (terse) output
  --output-format=type	Output format (terse,json,json+,normal)
  --terse-version=type	Set terse version output format (default 3, or 2 or 4 or 5)
  --version		Print version info and exit
  --help		Print this page
  --cpuclock-test	Perform test/validation of CPU clock
  --crctest=[type]	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
  --showcmd		Turn a job file into command line options
  --eta=when		When ETA estimate should be printed
            		May be "always", "never" or "auto"
  --eta-newline=t	Force a new line for every 't' period passed
  --status-interval=t	Force full status dump every 't' period passed
  --readonly		Turn on safety read-only checks, preventing writes
  --section=name	Only run specified section in job file, multiple sections can be specified
  --alloc-size=kb	Set smalloc pool to this size in kb (def 16384)
  --warnings-fatal	Fio parser warnings are fatal
  --max-jobs=nr		Maximum number of threads/processes to support
  --server=args		Start a backend fio server
  --daemonize=pidfile	Background fio server, write pid to file
  --client=hostname	Talk to remote backend(s) fio server at hostname
  --remote-config=file	Tell fio server to load this local job 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
  --trigger-file=file	Execute trigger cmd when file exists
  --trigger-timeout=t	Execute trigger at this time
  --trigger=cmd		Set this command as local trigger
  --trigger-remote=cmd	Set this command as remote trigger
  --aux-path=path	Use this path for fio state generated files

Fio was written by Jens Axboe <axboe@kernel.dk>
Options (36)
OptionDescriptionSource
--debug optionsEnable verbose tracing type of various fio actions.help + man
--parse-onlyParse options only, don't start any I/O.help + man
--merge-blktrace-onlyMerge blktraces only, don't start any I/O.help + man
--output filenameWrite output to filename.help + man
--bandwidth-logGenerate aggregate bandwidth logs.help + man
--minimalPrint statistics in a terse, semicolon-delimited format.help + man
--output-format typeSet the reporting format to normal', terse', json', or json+'.help + man
--terse-version typeSet terse version output format (default 3', or 2', 4', 5').help + man
--versionPrint version information and exit.help + man
--helpPrint a summary of the command line options and exit.help + man
--cpuclock-testPerform test and validation of internal CPU clock.help + man
--crctest typeTest speed of checksum functionshelp
--cmdhelp cmdPrint command help, "all" for all of themhelp + man
--enghelp enginePrint ioengine help, or list available ioengineshelp
--showcmdConvert given jobfiles to a set of command-line options.help + man
--eta whenWhen ETA estimate should be printed May be "always", "never" or "auto"help + man
--eta-newline tForce a new line for every time period passed.help + man
--status-interval tForce a full status dump of cumulative (from job start) values at time intervals.help + man
--readonlyTurn on safety read-only checks, preventing writes and trims.help + man
--section nameOnly run specified section in job file, multiple sections can be specifiedhelp + man
--alloc-size kbAllocate additional internal smalloc pools of size kb in KiB.help + man
--warnings-fatalAll fio parser warnings are fatal, causing fio to exit with an error.help + man
--max-jobs nrSet the maximum number of threads/processes to support to nr.help + man
--server argsStart a backend server, with args specifying what to listen to.help + man
--daemonize pidfileBackground a fio server, writing the pid to the given pidfile file.help + man
--client hostnameInstead of running the jobs locally, send and run them on the given hostname or set of hostnames.help + man
--remote-config fileTell fio server to load this local job filehelp + man
--idle-prof optionReport cpu idleness on a system or percpu basis (option=system,percpu) or run unit work calibration only (option=calibrate)help + man
--inflate-log logInflate and output compressed log.help + man
--trigger-file fileExecute trigger command when file exists.help + man
--trigger-timeout tExecute trigger at this time.help + man
--trigger cmdSet this command as local trigger.help + man
--trigger-remote cmdSet this command as remote trigger.help + man
--aux-path pathUse the directory specified by path for generated state files instead of the current working directory.help + man
--append-tersePrint statistics in selected mode AND terse, semicolon-delimited format. (in the manual page but not in --help)man
--eta-interval timeBy default, fio requests client ETA status roughly every second. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.