X-Git-Url: https://git.kernel.dk/?p=fio.git;a=blobdiff_plain;f=fio.1;h=0517e33fa87e698c4ee08f6dc2eeeacedf7d9127;hp=a69922493c9f4e52ac36cb7f30d87e3e8615b2f1;hb=82c1ed38d6c90c03beda072ed064a445ecb56aca;hpb=85549ba02ac57942632c3d1903efa4aa3c72af6a diff --git a/fio.1 b/fio.1 index a6992249..0517e33f 100644 --- a/fio.1 +++ b/fio.1 @@ -329,6 +329,13 @@ default is to only fill it at init time and reuse that data. Only makes sense if zero_buffers isn't specified, naturally. If data verification is enabled, refill_buffers is also automatically enabled. .TP +.BI scramble_buffers \fR=\fPbool +If \fBrefill_buffers\fR is too costly and the target is using data +deduplication, then setting this option will slightly modify the IO buffer +contents to defeat normal de-dupe attempts. This is not enough to defeat +more clever block compression attempts, but it will stop naive dedupe +of blocks. Default: true. +.TP .BI nrfiles \fR=\fPint Number of files to use for this job. Default: 1. .TP @@ -409,8 +416,9 @@ itself and for debugging and testing purposes. .TP .B net Transfer over the network. \fBfilename\fR must be set appropriately to -`\fIhost\fR/\fIport\fR' regardless of data direction. If receiving, only the -\fIport\fR argument is used. +`\fIhost\fR,\fIport\fR,\fItype\fR' regardless of data direction. \fItype\fR +is one of \fBtcp\fR, \fBudp\fR, or \fBunix\fR. For UNIX domain sockets, +the \fIhost\fR parameter is a file system path. .TP .B netsplice Like \fBnet\fR, but uses \fIsplice\fR\|(2) and \fIvmsplice\fR\|(2) to map data @@ -666,6 +674,10 @@ Terminate all jobs when one finishes. Default: wait for each job to finish. Average bandwidth calculations over the given time in milliseconds. Default: 500ms. .TP +.BI iopsavgtime \fR=\fPint +Average IOPS calculations over the given time in milliseconds. Default: +500ms. +.TP .BI create_serialize \fR=\fPbool If true, serialize file creation for the jobs. Default: true. .TP @@ -826,31 +838,36 @@ is to replay the IOPS onto the major/minor device that each IOP was recorded from. Setting \fBreplay_redirect\fR causes all IOPS to be replayed onto the single specified device regardless of the device it was recorded from. .TP -.B write_bw_log \fR=\fPstr +.BI write_bw_log \fR=\fPstr If given, write a bandwidth log of the jobs in this job file. Can be used to store data of the bandwidth of the jobs in their lifetime. The included fio_generate_plots script uses gnuplot to turn these text files into nice graphs. See \fBwrite_log_log\fR for behaviour of given filename. For this option, the postfix is _bw.log. .TP -.B write_lat_log \fR=\fPstr +.BI write_lat_log \fR=\fPstr Same as \fBwrite_bw_log\fR, but writes I/O completion latencies. If no filename is given with this option, the default filename of "jobname_type.log" is used. Even if the filename is given, fio will still append the type of log. .TP -.B disable_lat \fR=\fPbool +.BI write_iops_log \fR=\fPstr +Same as \fBwrite_bw_log\fR, but writes IOPS. If no filename is given with this +option, the default filename of "jobname_type.log" is used. Even if the +filename is given, fio will still append the type of log. +.TP +.BI disable_lat \fR=\fPbool Disable measurements of total latency numbers. Useful only for cutting back the number of calls to gettimeofday, as that does impact performance at really high IOPS rates. Note that to really get rid of a large amount of these calls, this option must be used with disable_slat and disable_bw as well. .TP -.B disable_clat \fR=\fPbool +.BI disable_clat \fR=\fPbool Disable measurements of completion latency numbers. See \fBdisable_lat\fR. .TP -.B disable_slat \fR=\fPbool +.BI disable_slat \fR=\fPbool Disable measurements of submission latency numbers. See \fBdisable_lat\fR. .TP -.B disable_bw_measurement \fR=\fPbool +.BI disable_bw_measurement \fR=\fPbool Disable measurements of throughput/bandwidth numbers. See \fBdisable_lat\fR. .TP .BI lockmem \fR=\fPint @@ -924,7 +941,7 @@ Enable the reporting of percentiles of completion latencies. Overwrite the default list of percentiles for completion latencies. Each number is a floating number in the range (0,100], and the maximum length of the list is 20. Use ':' to separate the -numbers. For example, --percentile_list=99.5:99.9 will cause fio to +numbers. For example, \-\-percentile_list=99.5:99.9 will cause fio to report the values of completion latency below which 99.5% and 99.9% of the observed latencies fell, respectively. .SH OUTPUT