X-Git-Url: https://git.kernel.dk/?p=fio.git;a=blobdiff_plain;f=README;h=ef614a28f250bc424c0b3c36f1e4ba95a003568c;hp=3ef13eaa1a36d1453561ebd1dc330948637eb8b1;hb=b2bd2bd96a09540b3add0ec74db2cdb1c145ca33;hpb=5a32012f174baf33978b041cffa36453f2d92947

diff --git a/README b/README
index 3ef13eaa..ef614a28 100644
--- a/README
+++ b/README
@@ -62,8 +62,9 @@ Command line
 ------------
 
 $ fio
+        --debug         Enable some debugging options (see below)
         --output        Write output to file
-        --runtime       Runtime in seconds
+        --timeout       Runtime in seconds
         --latency-log   Generate per-job latency logs
         --bandwidth-log Generate per-job bandwidth logs
         --minimal       Minimal (terse) output
@@ -71,9 +72,10 @@ $ fio
 	--help		Print this page
 	--cmdhelp=cmd	Print command help, "all" for all of them
 	--showcmd	Turn a job file into command line options
-	--readonly	Turn on safety read-only checks
+	--readonly	Turn on safety read-only checks, preventing writes
 	--eta=when	When ETA estimate should be printed
 			May be "always", "never" or "auto"
+	--section=name	Only run specified section in job file
 
 
 Any parameters following the options will be assumed to be job files,
@@ -87,6 +89,30 @@ if rw=write/randwrite/rw/randrw is given, but this extra safety net can
 be used as an extra precaution. It will also enable a write check in the
 io engine core to prevent an accidental write due to a fio bug.
 
+The debug switch allows adding options that trigger certain logging
+options in fio. Currently the options are:
+
+	process		Dump info related to processes
+	file		Dump info related to file actions
+	io		Dump info related to IO queuing
+	mem		Dump info related to memory allocations
+	blktrace	Dump info related to blktrace setup
+	verify		Dump info related to IO verification
+	all		Enable all debug options
+	random		Dump info related to random offset generation
+	parse		Dump info related to option matching and parsing
+	? or help	Show available debug options.
+
+You can specify as many as you want, eg --debug=file,mem will enable
+file and memory debugging.
+
+The section switch is meant to make it easier to ship a bigger job file
+instead of several smaller ones. Say you define a job file with light,
+moderate, and heavy parts. Then you can ask fio to run the given part
+only by giving it a --section=heavy command line option. The section
+option only applies to job sections, the reserved 'global' section is
+always parsed and taken into account.
+
 
 Job file
 --------
@@ -120,14 +146,16 @@ The job file parameters are:
 	size=x		Set file size to x bytes (x string can include k/m/g)
 	ioengine=x	'x' may be: aio/libaio/linuxaio for Linux aio,
 			posixaio for POSIX aio, sync for regular read/write io,
-			psync for regular pread/pwrite io, mmap for mmap'ed io,
-			syslet-rw for syslet driven read/write, splice for using
-			splice/vmsplice, sgio for direct SG_IO io, net for
-			network io, or cpuio for a cycler burner load. sgio only
-			works on Linux on SCSI (or SCSI-like devices, such as
-			usb-storage or sata/libata driven) devices. Fio also has
-			a null io engine, which is mainly used for testing fio
-			itself.
+			psync for regular pread/pwrite io, vsync for regular
+			readv/writev (with queuing emulation) mmap for mmap'ed
+			io, syslet-rw for syslet driven read/write, splice for
+			using splice/vmsplice, sgio for direct SG_IO io, net
+			for network io, or cpuio for a cycler burner load. sgio
+			only works on Linux on SCSI (or SCSI-like devices, such
+			as usb-storage or sata/libata driven) devices. Fio also
+			has a null io engine, which is mainly used for testing
+			fio itself.
+
 	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,