snippetbashTip

fio — Flexible I/O tester: do an I/O action spawning multiple threads or processes. More information: <htt

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

fiocommandmultipleclispawningtesterflexibleaction

Problem

How to use the fio command: Flexible I/O tester: do an I/O action spawning multiple threads or processes. More information: <https://fio.readthedocs.io/en/latest/fio_doc.html>.

Solution

fio — Flexible I/O tester: do an I/O action spawning multiple threads or processes. More information: <https://fio.readthedocs.io/en/latest/fio_doc.html>.

Test random reads:

fio --filename={{path/to/file}} --direct=1 --rw=randread --bs=4k --ioengine=libaio --iodepth=256 --runtime=120 --numjobs=4 --time_based --group_reporting --name={{job_name}} --eta-newline=1 --readonly

Test sequential reads:

fio --filename={{path/to/file}} --direct=1 --rw=read --bs=4k --ioengine=libaio --iodepth=256 --runtime=120 --numjobs=4 --time_based --group_reporting --name={{job_name}} --eta-newline=1 --readonly

Test random read/write:

fio --filename={{path/to/file}} --direct=1 --rw=randrw --bs=4k --ioengine=libaio --iodepth=256 --runtime=120 --numjobs=4 --time_based --group_reporting --name={{job_name}} --eta-newline=1

Test with parameters from a job file:

fio {{path/to/job_file}}

Convert a specific job file to command-line options:

fio --showcmd {{path/to/job_file}}

Code Snippets

Test random reads

fio --filename={{path/to/file}} --direct=1 --rw=randread --bs=4k --ioengine=libaio --iodepth=256 --runtime=120 --numjobs=4 --time_based --group_reporting --name={{job_name}} --eta-newline=1 --readonly

Test sequential reads

fio --filename={{path/to/file}} --direct=1 --rw=read --bs=4k --ioengine=libaio --iodepth=256 --runtime=120 --numjobs=4 --time_based --group_reporting --name={{job_name}} --eta-newline=1 --readonly

Test random read/write

fio --filename={{path/to/file}} --direct=1 --rw=randrw --bs=4k --ioengine=libaio --iodepth=256 --runtime=120 --numjobs=4 --time_based --group_reporting --name={{job_name}} --eta-newline=1

Test with parameters from a job file

fio {{path/to/job_file}}

Convert a specific job file to command-line options

fio --showcmd {{path/to/job_file}}

Context

tldr-pages: common/fio

Revisions (0)

No revisions yet.