1fio(1)                      General Commands Manual                     fio(1)
2
3
4

NAME

6       fio - flexible I/O tester
7

SYNOPSIS

9       fio [options] [jobfile]...
10

DESCRIPTION

12       fio  is a tool that will spawn a number of threads or processes doing a
13       particular type of I/O action as specified by the  user.   The  typical
14       use  of  fio  is to write a job file matching the I/O load one wants to
15       simulate.
16

OPTIONS

18       --debug=type
19              Enable verbose tracing type of various fio actions. May be `all'
20              for  all  types  or  individual types separated by a comma (e.g.
21              `--debug=file,mem'  will  enable  file  and  memory  debugging).
22              `help' will list all available tracing options.
23
24       --parse-only
25              Parse options only, don't start any I/O.
26
27       --output=filename
28              Write output to filename.
29
30       --output-format=format
31              Set  the  reporting  format  to  `normal',  `terse',  `json', or
32              `json+'. Multiple formats can be selected, separate by a  comma.
33              `terse' is a CSV based format. `json+' is like `json', except it
34              adds a full dump of the latency buckets.
35
36       --bandwidth-log
37              Generate aggregate bandwidth logs.
38
39       --minimal
40              Print statistics in a terse, semicolon-delimited format.
41
42       --append-terse
43              Print statistics in selected mode AND terse, semicolon-delimited
44              format.   Deprecated, use --output-format instead to select mul‐
45              tiple formats.
46
47       --terse-version=version
48              Set terse version output format (default `3', or `2', `4', `5').
49
50       --version
51              Print version information and exit.
52
53       --help Print a summary of the command line options and exit.
54
55       --cpuclock-test
56              Perform test and validation of internal CPU clock.
57
58       --crctest=[test]
59              Test the speed of the built-in  checksumming  functions.  If  no
60              argument  is  given,  all  of  them are tested. Alternatively, a
61              comma separated list can be passed, in which case the given ones
62              are tested.
63
64       --cmdhelp=command
65              Print  help  information  for command. May be `all' for all com‐
66              mands.
67
68       --enghelp=[ioengine[,command]]
69              List all commands defined by ioengine, or print help for command
70              defined by ioengine. If no ioengine is given, list all available
71              ioengines.
72
73       --showcmd=jobfile
74              Convert jobfile to a set of command-line options.
75
76       --readonly
77              Turn on safety read-only checks, preventing writes. The  --read‐
78              only option is an