X-Git-Url: https://git.kernel.dk/?p=fio.git;a=blobdiff_plain;f=HOWTO;h=ec4f3e21170a49a0cbae4a26571739f36c1e0d6a;hp=d1a3ad1e3291bb5b23555ec5c388c2ab48185322;hb=ebb1415f729c123b8a13bcbd667bf4b4cc95b4d4;hpb=390b1537a0b5a25ee002e6ec4b7749e7e2527777

diff --git a/HOWTO b/HOWTO
index d1a3ad1e..ec4f3e21 100644
--- a/HOWTO
+++ b/HOWTO
@@ -205,7 +205,11 @@ filename=str	Fio normally makes up a filename based on the job name,
 		files between threads in a job or several jobs, specify
 		a filename for each of them to override the default. If
 		the ioengine used is 'net', the filename is the host and
-		port to connect to in the format of =host:port.
+		port to connect to in the format of =host/port. If the
+		ioengine is file based, you can specify a number of files
+		by seperating the names with a ':' colon. So if you wanted
+		a job to open /dev/sda and /dev/sdb as the two working files,
+		you would use filename=/dev/sda:/dev/sdb
 
 rw=str		Type of io pattern. Accepted values are:
 
@@ -265,6 +269,11 @@ file_service_type=str  Defines how fio decides which file from a job to
 			roundrobin  Round robin over open files. This
 				is the default.
 
+		The string can have a number appended, indicating how
+		often to switch to a new file. So if option random:4 is
+		given, fio will switch to a new random file after 4 ios
+		have been issued.
+
 ioengine=str	Defines how the job issues io to the file. The following
 		types are defined:
 
@@ -297,10 +306,16 @@ ioengine=str	Defines how the job issues io to the file. The following
 
 			net	Transfer over the network to given host:port.
 				'filename' must be set appropriately to
-				filename=host:port regardless of send
+				filename=host/port regardless of send
 				or receive, if the latter only the port
 				argument is used.
 
+			cpu	Doesn't transfer any data, but burns CPU
+				cycles according to the cpuload= and
+				cpucycle= options. Setting cpuload=85
+				will cause that job to do nothing but burn
+				85% of the CPU.
+
 			external Prefix to specify loading an external
 				IO engine object file. Append the engine
 				filename, eg ioengine=external:/tmp/foo.o
@@ -343,6 +358,10 @@ overwrite=bool	If writing to a file, setup the file first and do overwrites.
 
 end_fsync=bool	If true, fsync file contents when the job exits.
 
+fsync_on_close=bool	If true, fio will fsync() a dirty file on close.
+		This differs from end_fsync in that it will happen on every
+		file close, not just at the end of the job.
+
 rwmixcycle=int	Value in milliseconds describing how often to switch between
 		reads and writes for a mixed workload. The default is
 		500 msecs.