blob: c4ecf02b6a868c4240a4cdc52d424884826bddf5 [file] [log] [blame]
Jens Axboe214e1ec2007-03-15 10:48:13 +01001#include <stdio.h>
2#include <stdlib.h>
3#include <unistd.h>
4#include <ctype.h>
5#include <string.h>
Jens Axboe214e1ec2007-03-15 10:48:13 +01006#include <assert.h>
Jens Axboe921c7662008-03-26 09:17:55 +01007#include <libgen.h>
Jens Axboe5921e802008-05-30 15:02:38 +02008#include <fcntl.h>
9#include <sys/types.h>
10#include <sys/stat.h>
Jens Axboe214e1ec2007-03-15 10:48:13 +010011
12#include "fio.h"
Jens Axboe4f5af7b2009-06-03 08:45:40 +020013#include "verify.h"
Jens Axboe214e1ec2007-03-15 10:48:13 +010014#include "parse.h"
Jens Axboeeef32352008-06-02 13:31:26 +020015#include "lib/fls.h"
Jens Axboe9f988e22010-03-04 10:42:38 +010016#include "options.h"
Jens Axboe214e1ec2007-03-15 10:48:13 +010017
Jens Axboe5d7c5d32010-06-21 15:08:17 +020018#include "crc/crc32c.h"
19
Jens Axboe214e1ec2007-03-15 10:48:13 +010020/*
21 * Check if mmap/mmaphuge has a :/foo/bar/file at the end. If so, return that.
22 */
23static char *get_opt_postfix(const char *str)
24{
25 char *p = strstr(str, ":");
26
27 if (!p)
28 return NULL;
29
30 p++;
31 strip_blank_front(&p);
32 strip_blank_end(p);
33 return strdup(p);
34}
35
Radha Ramachandran0e92f872009-10-27 20:14:27 +010036static int converthexchartoint(char a)
37{
38 int base;
39
Jens Axboe3c3ed072012-03-27 09:12:39 +020040 switch (a) {
Radha Ramachandran0e92f872009-10-27 20:14:27 +010041 case '0'...'9':
42 base = '0';
43 break;
44 case 'A'...'F':
45 base = 'A' - 10;
46 break;
47 case 'a'...'f':
48 base = 'a' - 10;
49 break;
50 default:
51 base = 0;
52 }
Jens Axboe3c3ed072012-03-27 09:12:39 +020053 return a - base;
Radha Ramachandran0e92f872009-10-27 20:14:27 +010054}
55
Jens Axboe564ca972007-12-14 12:21:19 +010056static int bs_cmp(const void *p1, const void *p2)
57{
58 const struct bssplit *bsp1 = p1;
59 const struct bssplit *bsp2 = p2;
60
61 return bsp1->perc < bsp2->perc;
62}
63
Jens Axboe83ea4222012-03-28 14:01:46 +020064static int bssplit_ddir(struct thread_options *o, int ddir, char *str)
Jens Axboe564ca972007-12-14 12:21:19 +010065{
Jens Axboe720e84a2009-04-21 08:29:55 +020066 struct bssplit *bssplit;
Jens Axboe564ca972007-12-14 12:21:19 +010067 unsigned int i, perc, perc_missing;
68 unsigned int max_bs, min_bs;
69 long long val;
Jens Axboe720e84a2009-04-21 08:29:55 +020070 char *fname;
Jens Axboe564ca972007-12-14 12:21:19 +010071
Jens Axboe83ea4222012-03-28 14:01:46 +020072 o->bssplit_nr[ddir] = 4;
Jens Axboe720e84a2009-04-21 08:29:55 +020073 bssplit = malloc(4 * sizeof(struct bssplit));
Jens Axboe564ca972007-12-14 12:21:19 +010074
75 i = 0;
76 max_bs = 0;
77 min_bs = -1;
78 while ((fname = strsep(&str, ":")) != NULL) {
79 char *perc_str;
80
81 if (!strlen(fname))
82 break;
83
84 /*
85 * grow struct buffer, if needed
86 */
Jens Axboe83ea4222012-03-28 14:01:46 +020087 if (i == o->bssplit_nr[ddir]) {
88 o->bssplit_nr[ddir] <<= 1;
89 bssplit = realloc(bssplit, o->bssplit_nr[ddir]
Jens Axboe5ec10ea2008-03-06 15:42:00 +010090 * sizeof(struct bssplit));
Jens Axboe564ca972007-12-14 12:21:19 +010091 }
92
93 perc_str = strstr(fname, "/");
94 if (perc_str) {
95 *perc_str = '\0';
96 perc_str++;
97 perc = atoi(perc_str);
98 if (perc > 100)
99 perc = 100;
100 else if (!perc)
101 perc = -1;
102 } else
103 perc = -1;
104
Jens Axboe83ea4222012-03-28 14:01:46 +0200105 if (str_to_decimal(fname, &val, 1, o)) {
Jens Axboe564ca972007-12-14 12:21:19 +0100106 log_err("fio: bssplit conversion failed\n");
Jens Axboe83ea4222012-03-28 14:01:46 +0200107 free(o->bssplit);
Jens Axboe564ca972007-12-14 12:21:19 +0100108 return 1;
109 }
110
111 if (val > max_bs)
112 max_bs = val;
113 if (val < min_bs)
114 min_bs = val;
115
Jens Axboe720e84a2009-04-21 08:29:55 +0200116 bssplit[i].bs = val;
117 bssplit[i].perc = perc;
Jens Axboe564ca972007-12-14 12:21:19 +0100118 i++;
119 }
120
Jens Axboe83ea4222012-03-28 14:01:46 +0200121 o->bssplit_nr[ddir] = i;
Jens Axboe564ca972007-12-14 12:21:19 +0100122
123 /*
124 * Now check if the percentages add up, and how much is missing
125 */
126 perc = perc_missing = 0;
Jens Axboe83ea4222012-03-28 14:01:46 +0200127 for (i = 0; i < o->bssplit_nr[ddir]; i++) {
Jens Axboe720e84a2009-04-21 08:29:55 +0200128 struct bssplit *bsp = &bssplit[i];
Jens Axboe564ca972007-12-14 12:21:19 +0100129
130 if (bsp->perc == (unsigned char) -1)
131 perc_missing++;
132 else
133 perc += bsp->perc;
134 }
135
136 if (perc > 100) {
137 log_err("fio: bssplit percentages add to more than 100%%\n");
Jens Axboe720e84a2009-04-21 08:29:55 +0200138 free(bssplit);
Jens Axboe564ca972007-12-14 12:21:19 +0100139 return 1;
140 }
141 /*
142 * If values didn't have a percentage set, divide the remains between
143 * them.
144 */
145 if (perc_missing) {
Jens Axboe83ea4222012-03-28 14:01:46 +0200146 for (i = 0; i < o->bssplit_nr[ddir]; i++) {
Jens Axboe720e84a2009-04-21 08:29:55 +0200147 struct bssplit *bsp = &bssplit[i];
Jens Axboe564ca972007-12-14 12:21:19 +0100148
149 if (bsp->perc == (unsigned char) -1)
150 bsp->perc = (100 - perc) / perc_missing;
151 }
152 }
153
Jens Axboe83ea4222012-03-28 14:01:46 +0200154 o->min_bs[ddir] = min_bs;
155 o->max_bs[ddir] = max_bs;
Jens Axboe564ca972007-12-14 12:21:19 +0100156
157 /*
158 * now sort based on percentages, for ease of lookup
159 */
Jens Axboe83ea4222012-03-28 14:01:46 +0200160 qsort(bssplit, o->bssplit_nr[ddir], sizeof(struct bssplit), bs_cmp);
161 o->bssplit[ddir] = bssplit;
Jens Axboe720e84a2009-04-21 08:29:55 +0200162 return 0;
Jens Axboe720e84a2009-04-21 08:29:55 +0200163}
164
165static int str_bssplit_cb(void *data, const char *input)
166{
167 struct thread_data *td = data;
Shaohua Li6eaf09d2012-09-14 08:49:43 +0200168 char *str, *p, *odir, *ddir;
Jens Axboe720e84a2009-04-21 08:29:55 +0200169 int ret = 0;
170
171 p = str = strdup(input);
172
173 strip_blank_front(&str);
174 strip_blank_end(str);
175
176 odir = strchr(str, ',');
177 if (odir) {
Shaohua Li6eaf09d2012-09-14 08:49:43 +0200178 ddir = strchr(odir + 1, ',');
179 if (ddir) {
Jens Axboed79db122012-09-24 08:51:24 +0200180 ret = bssplit_ddir(&td->o, DDIR_TRIM, ddir + 1);
Shaohua Li6eaf09d2012-09-14 08:49:43 +0200181 if (!ret)
182 *ddir = '\0';
183 } else {
184 char *op;
185
186 op = strdup(odir + 1);
Jens Axboed79db122012-09-24 08:51:24 +0200187 ret = bssplit_ddir(&td->o, DDIR_TRIM, op);
Shaohua Li6eaf09d2012-09-14 08:49:43 +0200188
189 free(op);
190 }
Jens Axboed79db122012-09-24 08:51:24 +0200191 if (!ret)
192 ret = bssplit_ddir(&td->o, DDIR_WRITE, odir + 1);
Jens Axboe720e84a2009-04-21 08:29:55 +0200193 if (!ret) {
194 *odir = '\0';
Jens Axboe83ea4222012-03-28 14:01:46 +0200195 ret = bssplit_ddir(&td->o, DDIR_READ, str);
Jens Axboe720e84a2009-04-21 08:29:55 +0200196 }
197 } else {
198 char *op;
199
200 op = strdup(str);
Jens Axboed79db122012-09-24 08:51:24 +0200201 ret = bssplit_ddir(&td->o, DDIR_WRITE, op);
Jens Axboe720e84a2009-04-21 08:29:55 +0200202 free(op);
Shaohua Li6eaf09d2012-09-14 08:49:43 +0200203
204 if (!ret) {
205 op = strdup(str);
Jens Axboed79db122012-09-24 08:51:24 +0200206 ret = bssplit_ddir(&td->o, DDIR_TRIM, op);
Shaohua Li6eaf09d2012-09-14 08:49:43 +0200207 free(op);
208 }
Jens Axboed79db122012-09-24 08:51:24 +0200209 ret = bssplit_ddir(&td->o, DDIR_READ, str);
Jens Axboe720e84a2009-04-21 08:29:55 +0200210 }
Jens Axboe564ca972007-12-14 12:21:19 +0100211
212 free(p);
Jens Axboe720e84a2009-04-21 08:29:55 +0200213 return ret;
Jens Axboe564ca972007-12-14 12:21:19 +0100214}
215
Dmitry Monakhov8b28bd42012-09-23 15:46:09 +0400216static int str2error(char *str)
217{
Jens Axboea94eb992012-09-24 18:46:34 +0200218 const char *err[] = { "EPERM", "ENOENT", "ESRCH", "EINTR", "EIO",
Dmitry Monakhov8b28bd42012-09-23 15:46:09 +0400219 "ENXIO", "E2BIG", "ENOEXEC", "EBADF",
220 "ECHILD", "EAGAIN", "ENOMEM", "EACCES",
221 "EFAULT", "ENOTBLK", "EBUSY", "EEXIST",
222 "EXDEV", "ENODEV", "ENOTDIR", "EISDIR",
223 "EINVAL", "ENFILE", "EMFILE", "ENOTTY",
224 "ETXTBSY","EFBIG", "ENOSPC", "ESPIPE",
Jens Axboea94eb992012-09-24 18:46:34 +0200225 "EROFS","EMLINK", "EPIPE", "EDOM", "ERANGE" };
Dmitry Monakhov8b28bd42012-09-23 15:46:09 +0400226 int i = 0, num = sizeof(err) / sizeof(void *);
227
Jens Axboea94eb992012-09-24 18:46:34 +0200228 while (i < num) {
Dmitry Monakhov8b28bd42012-09-23 15:46:09 +0400229 if (!strcmp(err[i], str))
230 return i + 1;
231 i++;
232 }
233 return 0;
234}
235
236static int ignore_error_type(struct thread_data *td, int etype, char *str)
237{
238 unsigned int i;
239 int *error;
240 char *fname;
241
242 if (etype >= ERROR_TYPE_CNT) {
243 log_err("Illegal error type\n");
244 return 1;
245 }
246
247 td->o.ignore_error_nr[etype] = 4;
248 error = malloc(4 * sizeof(struct bssplit));
249
250 i = 0;
251 while ((fname = strsep(&str, ":")) != NULL) {
252
253 if (!strlen(fname))
254 break;
255
256 /*
257 * grow struct buffer, if needed
258 */
259 if (i == td->o.ignore_error_nr[etype]) {
260 td->o.ignore_error_nr[etype] <<= 1;
261 error = realloc(error, td->o.ignore_error_nr[etype]
262 * sizeof(int));
263 }
264 if (fname[0] == 'E') {
265 error[i] = str2error(fname);
266 } else {
267 error[i] = atoi(fname);
268 if (error[i] < 0)
269 error[i] = error[i];
270 }
271 if (!error[i]) {
272 log_err("Unknown error %s, please use number value \n",
273 fname);
274 return 1;
275 }
276 i++;
277 }
278 if (i) {
279 td->o.continue_on_error |= 1 << etype;
280 td->o.ignore_error_nr[etype] = i;
281 td->o.ignore_error[etype] = error;
282 }
283 return 0;
284
285}
286
287static int str_ignore_error_cb(void *data, const char *input)
288{
289 struct thread_data *td = data;
290 char *str, *p, *n;
291 int type = 0, ret = 1;
292 p = str = strdup(input);
293
294 strip_blank_front(&str);
295 strip_blank_end(str);
296
297 while (p) {
298 n = strchr(p, ',');
299 if (n)
300 *n++ = '\0';
301 ret = ignore_error_type(td, type, p);
302 if (ret)
303 break;
304 p = n;
305 type++;
306 }
307 free(str);
308 return ret;
309}
310
Jens Axboe211097b2007-03-22 18:56:45 +0100311static int str_rw_cb(void *data, const char *str)
312{
313 struct thread_data *td = data;
Jens Axboe83ea4222012-03-28 14:01:46 +0200314 struct thread_options *o = &td->o;
Jens Axboe211097b2007-03-22 18:56:45 +0100315 char *nr = get_opt_postfix(str);
316
Jens Axboe83ea4222012-03-28 14:01:46 +0200317 o->ddir_seq_nr = 1;
318 o->ddir_seq_add = 0;
Jens Axboe059b0802011-08-25 09:09:37 +0200319
320 if (!nr)
321 return 0;
322
323 if (td_random(td))
Jens Axboe83ea4222012-03-28 14:01:46 +0200324 o->ddir_seq_nr = atoi(nr);
Jens Axboe059b0802011-08-25 09:09:37 +0200325 else {
326 long long val;
327
Jens Axboe83ea4222012-03-28 14:01:46 +0200328 if (str_to_decimal(nr, &val, 1, o)) {
Jens Axboe059b0802011-08-25 09:09:37 +0200329 log_err("fio: rw postfix parsing failed\n");
330 free(nr);
331 return 1;
332 }
333
Jens Axboe83ea4222012-03-28 14:01:46 +0200334 o->ddir_seq_add = val;
Jens Axboe182ec6e2008-11-14 13:06:06 +0100335 }
Jens Axboe211097b2007-03-22 18:56:45 +0100336
Jens Axboe059b0802011-08-25 09:09:37 +0200337 free(nr);
Jens Axboe211097b2007-03-22 18:56:45 +0100338 return 0;
339}
340
Jens Axboe214e1ec2007-03-15 10:48:13 +0100341static int str_mem_cb(void *data, const char *mem)
342{
343 struct thread_data *td = data;
Jens Axboe83ea4222012-03-28 14:01:46 +0200344 struct thread_options *o = &td->o;
Jens Axboe214e1ec2007-03-15 10:48:13 +0100345
Jens Axboe83ea4222012-03-28 14:01:46 +0200346 if (o->mem_type == MEM_MMAPHUGE || o->mem_type == MEM_MMAP) {
347 o->mmapfile = get_opt_postfix(mem);
348 if (o->mem_type == MEM_MMAPHUGE && !o->mmapfile) {
Jens Axboe214e1ec2007-03-15 10:48:13 +0100349 log_err("fio: mmaphuge:/path/to/file\n");
350 return 1;
351 }
352 }
353
354 return 0;
355}
356
Jens Axboec223da82010-03-24 13:23:53 +0100357static int fio_clock_source_cb(void *data, const char *str)
358{
359 struct thread_data *td = data;
360
361 fio_clock_source = td->o.clocksource;
362 fio_time_init();
363 return 0;
364}
365
Cigy Cyriac85bc8332010-08-10 19:21:09 -0400366static int str_rwmix_read_cb(void *data, unsigned long long *val)
Jens Axboecb499fc2008-05-28 10:33:32 +0200367{
368 struct thread_data *td = data;
369
370 td->o.rwmix[DDIR_READ] = *val;
371 td->o.rwmix[DDIR_WRITE] = 100 - *val;
372 return 0;
373}
374
Cigy Cyriac85bc8332010-08-10 19:21:09 -0400375static int str_rwmix_write_cb(void *data, unsigned long long *val)
Jens Axboecb499fc2008-05-28 10:33:32 +0200376{
377 struct thread_data *td = data;
378
379 td->o.rwmix[DDIR_WRITE] = *val;
380 td->o.rwmix[DDIR_READ] = 100 - *val;
381 return 0;
382}
383
Jens Axboe214e1ec2007-03-15 10:48:13 +0100384static int str_exitall_cb(void)
385{
386 exitall_on_terminate = 1;
387 return 0;
388}
389
Jens Axboe214e1ec2007-03-15 10:48:13 +0100390#ifdef FIO_HAVE_CPU_AFFINITY
Cigy Cyriac85bc8332010-08-10 19:21:09 -0400391static int str_cpumask_cb(void *data, unsigned long long *val)
Jens Axboe214e1ec2007-03-15 10:48:13 +0100392{
393 struct thread_data *td = data;
Jens Axboed2e268b2007-06-15 10:33:49 +0200394 unsigned int i;
Jens Axboeb03daaf2008-12-08 20:31:43 +0100395 long max_cpu;
Jens Axboed2ce18b2008-12-12 20:51:40 +0100396 int ret;
Jens Axboe214e1ec2007-03-15 10:48:13 +0100397
Jens Axboed2ce18b2008-12-12 20:51:40 +0100398 ret = fio_cpuset_init(&td->o.cpumask);
399 if (ret < 0) {
400 log_err("fio: cpuset_init failed\n");
401 td_verror(td, ret, "fio_cpuset_init");
402 return 1;
403 }
404
Jens Axboec00a2282011-07-08 20:56:06 +0200405 max_cpu = cpus_online();
Jens Axboed2e268b2007-06-15 10:33:49 +0200406
Jens Axboe62a72732008-12-08 11:37:01 +0100407 for (i = 0; i < sizeof(int) * 8; i++) {
408 if ((1 << i) & *val) {
Jens Axboeb03daaf2008-12-08 20:31:43 +0100409 if (i > max_cpu) {
410 log_err("fio: CPU %d too large (max=%ld)\n", i,
411 max_cpu);
412 return 1;
413 }
Jens Axboe62a72732008-12-08 11:37:01 +0100414 dprint(FD_PARSE, "set cpu allowed %d\n", i);
Jens Axboe6d459ee2008-12-12 20:02:58 +0100415 fio_cpu_set(&td->o.cpumask, i);
Jens Axboe62a72732008-12-08 11:37:01 +0100416 }
417 }
Jens Axboed2e268b2007-06-15 10:33:49 +0200418
Jens Axboe375b2692007-05-22 09:13:02 +0200419 td->o.cpumask_set = 1;
Jens Axboe214e1ec2007-03-15 10:48:13 +0100420 return 0;
421}
422
Jens Axboee8462bd2009-07-06 12:59:04 +0200423static int set_cpus_allowed(struct thread_data *td, os_cpu_mask_t *mask,
424 const char *input)
Jens Axboed2e268b2007-06-15 10:33:49 +0200425{
Jens Axboed2e268b2007-06-15 10:33:49 +0200426 char *cpu, *str, *p;
Jens Axboeb03daaf2008-12-08 20:31:43 +0100427 long max_cpu;
Jens Axboe19608d62008-12-08 15:03:12 +0100428 int ret = 0;
Jens Axboed2e268b2007-06-15 10:33:49 +0200429
Jens Axboee8462bd2009-07-06 12:59:04 +0200430 ret = fio_cpuset_init(mask);
Jens Axboed2ce18b2008-12-12 20:51:40 +0100431 if (ret < 0) {
432 log_err("fio: cpuset_init failed\n");
433 td_verror(td, ret, "fio_cpuset_init");
434 return 1;
435 }
Jens Axboed2e268b2007-06-15 10:33:49 +0200436
437 p = str = strdup(input);
438
439 strip_blank_front(&str);
440 strip_blank_end(str);
441
Jens Axboec00a2282011-07-08 20:56:06 +0200442 max_cpu = cpus_online();
Jens Axboeb03daaf2008-12-08 20:31:43 +0100443
Jens Axboed2e268b2007-06-15 10:33:49 +0200444 while ((cpu = strsep(&str, ",")) != NULL) {
Jens Axboe62a72732008-12-08 11:37:01 +0100445 char *str2, *cpu2;
446 int icpu, icpu2;
447
Jens Axboed2e268b2007-06-15 10:33:49 +0200448 if (!strlen(cpu))
449 break;
Jens Axboe62a72732008-12-08 11:37:01 +0100450
451 str2 = cpu;
452 icpu2 = -1;
453 while ((cpu2 = strsep(&str2, "-")) != NULL) {
454 if (!strlen(cpu2))
455 break;
456
457 icpu2 = atoi(cpu2);
458 }
459
460 icpu = atoi(cpu);
461 if (icpu2 == -1)
462 icpu2 = icpu;
463 while (icpu <= icpu2) {
Jens Axboe6d459ee2008-12-12 20:02:58 +0100464 if (icpu >= FIO_MAX_CPUS) {
Jens Axboe19608d62008-12-08 15:03:12 +0100465 log_err("fio: your OS only supports up to"
Jens Axboe6d459ee2008-12-12 20:02:58 +0100466 " %d CPUs\n", (int) FIO_MAX_CPUS);
Jens Axboe19608d62008-12-08 15:03:12 +0100467 ret = 1;
468 break;
469 }
Jens Axboeb03daaf2008-12-08 20:31:43 +0100470 if (icpu > max_cpu) {
471 log_err("fio: CPU %d too large (max=%ld)\n",
472 icpu, max_cpu);
473 ret = 1;
474 break;
475 }
Jens Axboe0b9d69e2009-09-11 22:29:54 +0200476
Jens Axboe62a72732008-12-08 11:37:01 +0100477 dprint(FD_PARSE, "set cpu allowed %d\n", icpu);
Jens Axboee8462bd2009-07-06 12:59:04 +0200478 fio_cpu_set(mask, icpu);
Jens Axboe62a72732008-12-08 11:37:01 +0100479 icpu++;
480 }
Jens Axboe19608d62008-12-08 15:03:12 +0100481 if (ret)
482 break;
Jens Axboed2e268b2007-06-15 10:33:49 +0200483 }
484
485 free(p);
Jens Axboe19608d62008-12-08 15:03:12 +0100486 if (!ret)
487 td->o.cpumask_set = 1;
488 return ret;
Jens Axboed2e268b2007-06-15 10:33:49 +0200489}
Jens Axboee8462bd2009-07-06 12:59:04 +0200490
491static int str_cpus_allowed_cb(void *data, const char *input)
492{
493 struct thread_data *td = data;
494 int ret;
495
496 ret = set_cpus_allowed(td, &td->o.cpumask, input);
497 if (!ret)
498 td->o.cpumask_set = 1;
499
500 return ret;
501}
502
503static int str_verify_cpus_allowed_cb(void *data, const char *input)
504{
505 struct thread_data *td = data;
506 int ret;
507
508 ret = set_cpus_allowed(td, &td->o.verify_cpumask, input);
509 if (!ret)
510 td->o.verify_cpumask_set = 1;
511
512 return ret;
513}
Jens Axboed2e268b2007-06-15 10:33:49 +0200514#endif
515
Jens Axboe214e1ec2007-03-15 10:48:13 +0100516static int str_fst_cb(void *data, const char *str)
517{
518 struct thread_data *td = data;
519 char *nr = get_opt_postfix(str);
520
521 td->file_service_nr = 1;
Jens Axboe182ec6e2008-11-14 13:06:06 +0100522 if (nr) {
Jens Axboe214e1ec2007-03-15 10:48:13 +0100523 td->file_service_nr = atoi(nr);
Jens Axboe182ec6e2008-11-14 13:06:06 +0100524 free(nr);
525 }
Jens Axboe214e1ec2007-03-15 10:48:13 +0100526
527 return 0;
528}
529
Jens Axboe3ae06372010-03-19 19:17:15 +0100530#ifdef FIO_HAVE_SYNC_FILE_RANGE
Jens Axboe44f29692010-03-09 20:09:44 +0100531static int str_sfr_cb(void *data, const char *str)
532{
533 struct thread_data *td = data;
534 char *nr = get_opt_postfix(str);
535
536 td->sync_file_range_nr = 1;
537 if (nr) {
538 td->sync_file_range_nr = atoi(nr);
539 free(nr);
540 }
541
542 return 0;
543}
Jens Axboe3ae06372010-03-19 19:17:15 +0100544#endif
Jens Axboe44f29692010-03-09 20:09:44 +0100545
Jens Axboe8e827d32009-08-04 09:51:48 +0200546/*
547 * Return next file in the string. Files are separated with ':'. If the ':'
548 * is escaped with a '\', then that ':' is part of the filename and does not
549 * indicate a new file.
550 */
551static char *get_next_file_name(char **ptr)
552{
553 char *str = *ptr;
554 char *p, *start;
555
556 if (!str || !strlen(str))
557 return NULL;
558
559 start = str;
560 do {
561 /*
562 * No colon, we are done
563 */
564 p = strchr(str, ':');
565 if (!p) {
566 *ptr = NULL;
567 break;
568 }
569
570 /*
571 * We got a colon, but it's the first character. Skip and
572 * continue
573 */
574 if (p == start) {
575 str = ++start;
576 continue;
577 }
578
579 if (*(p - 1) != '\\') {
580 *p = '\0';
581 *ptr = p + 1;
582 break;
583 }
584
585 memmove(p - 1, p, strlen(p) + 1);
586 str = p;
587 } while (1);
588
589 return start;
590}
591
Jens Axboe214e1ec2007-03-15 10:48:13 +0100592static int str_filename_cb(void *data, const char *input)
593{
594 struct thread_data *td = data;
595 char *fname, *str, *p;
596
597 p = str = strdup(input);
598
599 strip_blank_front(&str);
600 strip_blank_end(str);
601
602 if (!td->files_index)
Jens Axboe2dc1bbe2007-03-15 15:01:33 +0100603 td->o.nr_files = 0;
Jens Axboe214e1ec2007-03-15 10:48:13 +0100604
Jens Axboe8e827d32009-08-04 09:51:48 +0200605 while ((fname = get_next_file_name(&str)) != NULL) {
Jens Axboe214e1ec2007-03-15 10:48:13 +0100606 if (!strlen(fname))
607 break;
608 add_file(td, fname);
Jens Axboe2dc1bbe2007-03-15 15:01:33 +0100609 td->o.nr_files++;
Jens Axboe214e1ec2007-03-15 10:48:13 +0100610 }
611
612 free(p);
613 return 0;
614}
615
616static int str_directory_cb(void *data, const char fio_unused *str)
617{
618 struct thread_data *td = data;
619 struct stat sb;
620
Jens Axboe2dc1bbe2007-03-15 15:01:33 +0100621 if (lstat(td->o.directory, &sb) < 0) {
Jens Axboe921c7662008-03-26 09:17:55 +0100622 int ret = errno;
623
Jens Axboe2dc1bbe2007-03-15 15:01:33 +0100624 log_err("fio: %s is not a directory\n", td->o.directory);
Jens Axboe921c7662008-03-26 09:17:55 +0100625 td_verror(td, ret, "lstat");
Jens Axboe214e1ec2007-03-15 10:48:13 +0100626 return 1;
627 }
628 if (!S_ISDIR(sb.st_mode)) {
Jens Axboe2dc1bbe2007-03-15 15:01:33 +0100629 log_err("fio: %s is not a directory\n", td->o.directory);
Jens Axboe214e1ec2007-03-15 10:48:13 +0100630 return 1;
631 }
632
633 return 0;
634}
635
636static int str_opendir_cb(void *data, const char fio_unused *str)
637{
638 struct thread_data *td = data;
639
640 if (!td->files_index)
Jens Axboe2dc1bbe2007-03-15 15:01:33 +0100641 td->o.nr_files = 0;
Jens Axboe214e1ec2007-03-15 10:48:13 +0100642
Jens Axboe2dc1bbe2007-03-15 15:01:33 +0100643 return add_dir_files(td, td->o.opendir);
Jens Axboe214e1ec2007-03-15 10:48:13 +0100644}
645
Radha Ramachandran0e92f872009-10-27 20:14:27 +0100646static int str_verify_pattern_cb(void *data, const char *input)
Jens Axboe90059d62007-07-30 09:33:12 +0200647{
648 struct thread_data *td = data;
Radha Ramachandran0e92f872009-10-27 20:14:27 +0100649 long off;
650 int i = 0, j = 0, len, k, base = 10;
Jens Axboe3c3ed072012-03-27 09:12:39 +0200651 char *loc1, *loc2;
Jens Axboe90059d62007-07-30 09:33:12 +0200652
Radha Ramachandran0e92f872009-10-27 20:14:27 +0100653 loc1 = strstr(input, "0x");
654 loc2 = strstr(input, "0X");
655 if (loc1 || loc2)
656 base = 16;
657 off = strtol(input, NULL, base);
658 if (off != LONG_MAX || errno != ERANGE) {
659 while (off) {
660 td->o.verify_pattern[i] = off & 0xff;
661 off >>= 8;
662 i++;
663 }
664 } else {
665 len = strlen(input);
666 k = len - 1;
667 if (base == 16) {
668 if (loc1)
669 j = loc1 - input + 2;
670 else
671 j = loc2 - input + 2;
672 } else
673 return 1;
674 if (len - j < MAX_PATTERN_SIZE * 2) {
675 while (k >= j) {
676 off = converthexchartoint(input[k--]);
677 if (k >= j)
678 off += (converthexchartoint(input[k--])
679 * 16);
680 td->o.verify_pattern[i++] = (char) off;
681 }
682 }
683 }
Steven Langefcd9dc2012-02-02 20:22:04 +0100684
685 /*
686 * Fill the pattern all the way to the end. This greatly reduces
687 * the number of memcpy's we have to do when verifying the IO.
688 */
689 while (i > 1 && i * 2 <= MAX_PATTERN_SIZE) {
690 memcpy(&td->o.verify_pattern[i], &td->o.verify_pattern[0], i);
691 i *= 2;
692 }
Steven Lang9a2a86d2012-02-07 09:42:59 +0100693 if (i == 1) {
694 /*
695 * The code in verify_io_u_pattern assumes a single byte pattern
696 * fills the whole verify pattern buffer.
697 */
698 memset(td->o.verify_pattern, td->o.verify_pattern[0],
699 MAX_PATTERN_SIZE);
700 }
Steven Langefcd9dc2012-02-02 20:22:04 +0100701
Radha Ramachandran0e92f872009-10-27 20:14:27 +0100702 td->o.verify_pattern_bytes = i;
Steven Langefcd9dc2012-02-02 20:22:04 +0100703
Jens Axboe92bf48d2011-01-14 21:20:42 +0100704 /*
705 * VERIFY_META could already be set
706 */
707 if (td->o.verify == VERIFY_NONE)
708 td->o.verify = VERIFY_PATTERN;
Steven Langefcd9dc2012-02-02 20:22:04 +0100709
Jens Axboe90059d62007-07-30 09:33:12 +0200710 return 0;
711}
Jens Axboe214e1ec2007-03-15 10:48:13 +0100712
Jens Axboe4d4e80f2008-03-04 10:18:56 +0100713static int str_lockfile_cb(void *data, const char *str)
714{
715 struct thread_data *td = data;
716 char *nr = get_opt_postfix(str);
717
718 td->o.lockfile_batch = 1;
Jens Axboe182ec6e2008-11-14 13:06:06 +0100719 if (nr) {
Jens Axboe4d4e80f2008-03-04 10:18:56 +0100720 td->o.lockfile_batch = atoi(nr);
Jens Axboe182ec6e2008-11-14 13:06:06 +0100721 free(nr);
722 }
Jens Axboe4d4e80f2008-03-04 10:18:56 +0100723
724 return 0;
725}
726
Jens Axboe993bf482008-11-14 13:04:53 +0100727static int str_gtod_reduce_cb(void *data, int *il)
728{
729 struct thread_data *td = data;
730 int val = *il;
731
Jens Axboe02af0982010-06-24 09:59:34 +0200732 td->o.disable_lat = !!val;
Jens Axboe993bf482008-11-14 13:04:53 +0100733 td->o.disable_clat = !!val;
734 td->o.disable_slat = !!val;
735 td->o.disable_bw = !!val;
Jens Axboe0dc1bc02011-10-13 08:55:29 +0200736 td->o.clat_percentiles = !val;
Jens Axboe993bf482008-11-14 13:04:53 +0100737 if (val)
738 td->tv_cache_mask = 63;
739
740 return 0;
741}
742
Cigy Cyriac85bc8332010-08-10 19:21:09 -0400743static int str_gtod_cpu_cb(void *data, long long *il)
Jens Axboebe4ecfd2008-12-08 14:10:52 +0100744{
745 struct thread_data *td = data;
746 int val = *il;
747
748 td->o.gtod_cpu = val;
749 td->o.gtod_offload = 1;
750 return 0;
751}
752
Jens Axboe7bb59102011-07-12 19:47:03 +0200753static int str_size_cb(void *data, unsigned long long *__val)
754{
755 struct thread_data *td = data;
756 unsigned long long v = *__val;
757
758 if (parse_is_percent(v)) {
759 td->o.size = 0;
760 td->o.size_percent = -1ULL - v;
761 } else
762 td->o.size = v;
763
764 return 0;
765}
766
Jens Axboe896cac22009-07-01 10:38:35 +0200767static int rw_verify(struct fio_option *o, void *data)
768{
769 struct thread_data *td = data;
770
771 if (read_only && td_write(td)) {
772 log_err("fio: job <%s> has write bit set, but fio is in"
773 " read-only mode\n", td->o.name);
774 return 1;
775 }
776
777 return 0;
778}
779
Jens Axboe276ca4f2009-07-01 10:43:05 +0200780static int gtod_cpu_verify(struct fio_option *o, void *data)
Jens Axboe29d43ff2009-07-01 10:42:18 +0200781{
Jens Axboe276ca4f2009-07-01 10:43:05 +0200782#ifndef FIO_HAVE_CPU_AFFINITY
Jens Axboe29d43ff2009-07-01 10:42:18 +0200783 struct thread_data *td = data;
784
Jens Axboe29d43ff2009-07-01 10:42:18 +0200785 if (td->o.gtod_cpu) {
786 log_err("fio: platform must support CPU affinity for"
787 "gettimeofday() offloading\n");
788 return 1;
789 }
790#endif
791
792 return 0;
793}
794
Jens Axboe90fef2d2009-07-17 22:33:32 +0200795static int kb_base_verify(struct fio_option *o, void *data)
796{
797 struct thread_data *td = data;
798
799 if (td->o.kb_base != 1024 && td->o.kb_base != 1000) {
800 log_err("fio: kb_base set to nonsensical value: %u\n",
801 td->o.kb_base);
802 return 1;
803 }
804
805 return 0;
806}
807
Jens Axboe214e1ec2007-03-15 10:48:13 +0100808/*
Jens Axboe9af4a242012-03-16 10:13:49 +0100809 * Option grouping
810 */
811static struct opt_group fio_opt_groups[] = {
812 {
Jens Axboee8b0e952012-03-19 14:37:08 +0100813 .name = "General",
814 .mask = FIO_OPT_C_GENERAL,
815 },
816 {
817 .name = "I/O",
818 .mask = FIO_OPT_C_IO,
Jens Axboe9af4a242012-03-16 10:13:49 +0100819 },
820 {
821 .name = "File",
Jens Axboee8b0e952012-03-19 14:37:08 +0100822 .mask = FIO_OPT_C_FILE,
Jens Axboe9af4a242012-03-16 10:13:49 +0100823 },
824 {
Jens Axboee8b0e952012-03-19 14:37:08 +0100825 .name = "Statistics",
826 .mask = FIO_OPT_C_STAT,
Jens Axboe9af4a242012-03-16 10:13:49 +0100827 },
828 {
Jens Axboee8b0e952012-03-19 14:37:08 +0100829 .name = "Logging",
830 .mask = FIO_OPT_C_LOG,
Jens Axboe9af4a242012-03-16 10:13:49 +0100831 },
832 {
Jens Axboe13fca822012-03-31 13:55:54 +0200833 .name = "Profiles",
834 .mask = FIO_OPT_C_PROFILE,
835 },
836 {
Jens Axboe9af4a242012-03-16 10:13:49 +0100837 .name = NULL,
838 },
839};
840
Jens Axboee8b0e952012-03-19 14:37:08 +0100841static struct opt_group *__opt_group_from_mask(struct opt_group *ogs, unsigned int *mask,
842 unsigned int inv_mask)
Jens Axboe9af4a242012-03-16 10:13:49 +0100843{
844 struct opt_group *og;
845 int i;
846
Jens Axboee8b0e952012-03-19 14:37:08 +0100847 if (*mask == inv_mask || !*mask)
Jens Axboe9af4a242012-03-16 10:13:49 +0100848 return NULL;
849
Jens Axboee8b0e952012-03-19 14:37:08 +0100850 for (i = 0; ogs[i].name; i++) {
851 og = &ogs[i];
Jens Axboe9af4a242012-03-16 10:13:49 +0100852
853 if (*mask & og->mask) {
854 *mask &= ~(og->mask);
855 return og;
856 }
857 }
858
859 return NULL;
860}
861
Jens Axboee8b0e952012-03-19 14:37:08 +0100862struct opt_group *opt_group_from_mask(unsigned int *mask)
863{
864 return __opt_group_from_mask(fio_opt_groups, mask, FIO_OPT_C_INVALID);
865}
866
867static struct opt_group fio_opt_cat_groups[] = {
868 {
869 .name = "Rate",
870 .mask = FIO_OPT_G_RATE,
871 },
872 {
873 .name = "Zone",
874 .mask = FIO_OPT_G_ZONE,
875 },
876 {
877 .name = "Read/write mix",
878 .mask = FIO_OPT_G_RWMIX,
879 },
880 {
881 .name = "Verify",
882 .mask = FIO_OPT_G_VERIFY,
883 },
884 {
885 .name = "Trim",
886 .mask = FIO_OPT_G_TRIM,
887 },
888 {
889 .name = "I/O Logging",
890 .mask = FIO_OPT_G_IOLOG,
891 },
892 {
893 .name = "I/O Depth",
894 .mask = FIO_OPT_G_IO_DEPTH,
895 },
896 {
897 .name = "I/O Flow",
898 .mask = FIO_OPT_G_IO_FLOW,
899 },
900 {
Jens Axboe06260372012-03-19 15:16:08 +0100901 .name = "Description",
902 .mask = FIO_OPT_G_DESC,
903 },
904 {
905 .name = "Filename",
906 .mask = FIO_OPT_G_FILENAME,
907 },
908 {
909 .name = "General I/O",
910 .mask = FIO_OPT_G_IO_BASIC,
911 },
912 {
Jens Axboea1f6afe2012-03-19 20:44:33 +0100913 .name = "Cgroups",
914 .mask = FIO_OPT_G_CGROUP,
915 },
916 {
917 .name = "Runtime",
918 .mask = FIO_OPT_G_RUNTIME,
919 },
920 {
Jens Axboe10860052012-03-19 20:56:53 +0100921 .name = "Process",
922 .mask = FIO_OPT_G_PROCESS,
923 },
924 {
925 .name = "Job credentials / priority",
926 .mask = FIO_OPT_G_CRED,
927 },
928 {
929 .name = "Clock settings",
930 .mask = FIO_OPT_G_CLOCK,
931 },
932 {
Jens Axboe3ceb4582012-03-19 21:27:02 +0100933 .name = "I/O Type",
934 .mask = FIO_OPT_G_IO_TYPE,
935 },
936 {
937 .name = "I/O Thinktime",
938 .mask = FIO_OPT_G_THINKTIME,
939 },
940 {
941 .name = "Randomizations",
942 .mask = FIO_OPT_G_RANDOM,
943 },
944 {
945 .name = "I/O buffers",
946 .mask = FIO_OPT_G_IO_BUF,
947 },
948 {
Jens Axboe13fca822012-03-31 13:55:54 +0200949 .name = "Tiobench profile",
950 .mask = FIO_OPT_G_TIOBENCH,
951 },
952
953 {
Jens Axboee8b0e952012-03-19 14:37:08 +0100954 .name = NULL,
955 }
956};
957
958struct opt_group *opt_group_cat_from_mask(unsigned int *mask)
959{
960 return __opt_group_from_mask(fio_opt_cat_groups, mask, FIO_OPT_G_INVALID);
961}
962
Jens Axboe9af4a242012-03-16 10:13:49 +0100963/*
Jens Axboe214e1ec2007-03-15 10:48:13 +0100964 * Map of job/command line options
965 */
Jens Axboe9af4a242012-03-16 10:13:49 +0100966struct fio_option fio_options[FIO_MAX_OPTS] = {
Jens Axboe214e1ec2007-03-15 10:48:13 +0100967 {
968 .name = "description",
Jens Axboee8b0e952012-03-19 14:37:08 +0100969 .lname = "Description of job",
Jens Axboe214e1ec2007-03-15 10:48:13 +0100970 .type = FIO_OPT_STR_STORE,
971 .off1 = td_var_offset(description),
972 .help = "Text job description",
Jens Axboee8b0e952012-03-19 14:37:08 +0100973 .category = FIO_OPT_C_GENERAL,
Jens Axboe06260372012-03-19 15:16:08 +0100974 .group = FIO_OPT_G_DESC,
Jens Axboe214e1ec2007-03-15 10:48:13 +0100975 },
976 {
977 .name = "name",
Jens Axboee8b0e952012-03-19 14:37:08 +0100978 .lname = "Job name",
Jens Axboe214e1ec2007-03-15 10:48:13 +0100979 .type = FIO_OPT_STR_STORE,
980 .off1 = td_var_offset(name),
981 .help = "Name of this job",
Jens Axboee8b0e952012-03-19 14:37:08 +0100982 .category = FIO_OPT_C_GENERAL,
Jens Axboe06260372012-03-19 15:16:08 +0100983 .group = FIO_OPT_G_DESC,
Jens Axboe214e1ec2007-03-15 10:48:13 +0100984 },
985 {
Jens Axboee8b0e952012-03-19 14:37:08 +0100986 .name = "filename",
987 .lname = "Filename(s)",
988 .type = FIO_OPT_STR_STORE,
989 .off1 = td_var_offset(filename),
990 .cb = str_filename_cb,
991 .prio = -1, /* must come after "directory" */
992 .help = "File(s) to use for the workload",
993 .category = FIO_OPT_C_FILE,
Jens Axboe06260372012-03-19 15:16:08 +0100994 .group = FIO_OPT_G_FILENAME,
Jens Axboee8b0e952012-03-19 14:37:08 +0100995 },
996 {
997 .name = "directory",
998 .lname = "Directory",
999 .type = FIO_OPT_STR_STORE,
1000 .off1 = td_var_offset(directory),
1001 .cb = str_directory_cb,
1002 .help = "Directory to store files in",
1003 .category = FIO_OPT_C_FILE,
Jens Axboe06260372012-03-19 15:16:08 +01001004 .group = FIO_OPT_G_FILENAME,
Jens Axboe90fef2d2009-07-17 22:33:32 +02001005 },
1006 {
Jens Axboe29c13492008-03-01 19:25:20 +01001007 .name = "lockfile",
Jens Axboee8b0e952012-03-19 14:37:08 +01001008 .lname = "Lockfile",
Jens Axboe4d4e80f2008-03-04 10:18:56 +01001009 .type = FIO_OPT_STR,
1010 .cb = str_lockfile_cb,
1011 .off1 = td_var_offset(file_lock_mode),
Jens Axboe29c13492008-03-01 19:25:20 +01001012 .help = "Lock file when doing IO to it",
1013 .parent = "filename",
Jens Axboed71c1542012-03-16 20:16:59 +01001014 .hide = 0,
Jens Axboe4d4e80f2008-03-04 10:18:56 +01001015 .def = "none",
Jens Axboee8b0e952012-03-19 14:37:08 +01001016 .category = FIO_OPT_C_FILE,
Jens Axboe06260372012-03-19 15:16:08 +01001017 .group = FIO_OPT_G_FILENAME,
Jens Axboe4d4e80f2008-03-04 10:18:56 +01001018 .posval = {
1019 { .ival = "none",
1020 .oval = FILE_LOCK_NONE,
1021 .help = "No file locking",
1022 },
1023 { .ival = "exclusive",
1024 .oval = FILE_LOCK_EXCLUSIVE,
1025 .help = "Exclusive file lock",
1026 },
1027 {
1028 .ival = "readwrite",
1029 .oval = FILE_LOCK_READWRITE,
1030 .help = "Read vs write lock",
1031 },
1032 },
Jens Axboe29c13492008-03-01 19:25:20 +01001033 },
1034 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01001035 .name = "opendir",
Jens Axboee8b0e952012-03-19 14:37:08 +01001036 .lname = "Open directory",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001037 .type = FIO_OPT_STR_STORE,
1038 .off1 = td_var_offset(opendir),
1039 .cb = str_opendir_cb,
1040 .help = "Recursively add files from this directory and down",
Jens Axboee8b0e952012-03-19 14:37:08 +01001041 .category = FIO_OPT_C_FILE,
Jens Axboe06260372012-03-19 15:16:08 +01001042 .group = FIO_OPT_G_FILENAME,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001043 },
1044 {
1045 .name = "rw",
Jens Axboee8b0e952012-03-19 14:37:08 +01001046 .lname = "Read/write",
Jens Axboed3aad8f2007-03-15 14:12:05 +01001047 .alias = "readwrite",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001048 .type = FIO_OPT_STR,
Jens Axboe211097b2007-03-22 18:56:45 +01001049 .cb = str_rw_cb,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001050 .off1 = td_var_offset(td_ddir),
1051 .help = "IO direction",
1052 .def = "read",
Jens Axboe896cac22009-07-01 10:38:35 +02001053 .verify = rw_verify,
Jens Axboee8b0e952012-03-19 14:37:08 +01001054 .category = FIO_OPT_C_IO,
Jens Axboe06260372012-03-19 15:16:08 +01001055 .group = FIO_OPT_G_IO_BASIC,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001056 .posval = {
1057 { .ival = "read",
1058 .oval = TD_DDIR_READ,
1059 .help = "Sequential read",
1060 },
1061 { .ival = "write",
1062 .oval = TD_DDIR_WRITE,
1063 .help = "Sequential write",
1064 },
Shaohua Li6eaf09d2012-09-14 08:49:43 +02001065 { .ival = "trim",
1066 .oval = TD_DDIR_TRIM,
1067 .help = "Sequential trim",
1068 },
Jens Axboe214e1ec2007-03-15 10:48:13 +01001069 { .ival = "randread",
1070 .oval = TD_DDIR_RANDREAD,
1071 .help = "Random read",
1072 },
1073 { .ival = "randwrite",
1074 .oval = TD_DDIR_RANDWRITE,
1075 .help = "Random write",
1076 },
Shaohua Li6eaf09d2012-09-14 08:49:43 +02001077 { .ival = "randtrim",
1078 .oval = TD_DDIR_RANDTRIM,
1079 .help = "Random trim",
1080 },
Jens Axboe214e1ec2007-03-15 10:48:13 +01001081 { .ival = "rw",
1082 .oval = TD_DDIR_RW,
1083 .help = "Sequential read and write mix",
1084 },
Jens Axboe10b023d2012-03-23 13:40:06 +01001085 { .ival = "readwrite",
1086 .oval = TD_DDIR_RW,
1087 .help = "Sequential read and write mix",
1088 },
Jens Axboe214e1ec2007-03-15 10:48:13 +01001089 { .ival = "randrw",
1090 .oval = TD_DDIR_RANDRW,
1091 .help = "Random read and write mix"
1092 },
1093 },
1094 },
1095 {
Jens Axboe38dad622010-07-20 14:46:00 -06001096 .name = "rw_sequencer",
Jens Axboee8b0e952012-03-19 14:37:08 +01001097 .lname = "RW Sequencer",
Jens Axboe38dad622010-07-20 14:46:00 -06001098 .type = FIO_OPT_STR,
1099 .off1 = td_var_offset(rw_seq),
1100 .help = "IO offset generator modifier",
1101 .def = "sequential",
Jens Axboee8b0e952012-03-19 14:37:08 +01001102 .category = FIO_OPT_C_IO,
Jens Axboe06260372012-03-19 15:16:08 +01001103 .group = FIO_OPT_G_IO_BASIC,
Jens Axboe38dad622010-07-20 14:46:00 -06001104 .posval = {
1105 { .ival = "sequential",
1106 .oval = RW_SEQ_SEQ,
1107 .help = "Generate sequential offsets",
1108 },
1109 { .ival = "identical",
1110 .oval = RW_SEQ_IDENT,
1111 .help = "Generate identical offsets",
1112 },
1113 },
1114 },
1115
1116 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01001117 .name = "ioengine",
Jens Axboee8b0e952012-03-19 14:37:08 +01001118 .lname = "IO Engine",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001119 .type = FIO_OPT_STR_STORE,
1120 .off1 = td_var_offset(ioengine),
1121 .help = "IO engine to use",
Jens Axboe58483fa2011-01-19 11:09:58 -07001122 .def = FIO_PREFERRED_ENGINE,
Jens Axboee8b0e952012-03-19 14:37:08 +01001123 .category = FIO_OPT_C_IO,
Jens Axboe06260372012-03-19 15:16:08 +01001124 .group = FIO_OPT_G_IO_BASIC,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001125 .posval = {
1126 { .ival = "sync",
1127 .help = "Use read/write",
1128 },
gurudas paia31041e2007-10-23 15:12:30 +02001129 { .ival = "psync",
1130 .help = "Use pread/pwrite",
1131 },
Jens Axboe1d2af022008-02-04 10:59:07 +01001132 { .ival = "vsync",
Bruce Cran03e20d62011-01-02 20:14:54 +01001133 .help = "Use readv/writev",
Jens Axboe1d2af022008-02-04 10:59:07 +01001134 },
Jens Axboe214e1ec2007-03-15 10:48:13 +01001135#ifdef FIO_HAVE_LIBAIO
1136 { .ival = "libaio",
1137 .help = "Linux native asynchronous IO",
1138 },
1139#endif
1140#ifdef FIO_HAVE_POSIXAIO
1141 { .ival = "posixaio",
1142 .help = "POSIX asynchronous IO",
1143 },
1144#endif
Jens Axboe417f0062008-06-02 11:59:30 +02001145#ifdef FIO_HAVE_SOLARISAIO
1146 { .ival = "solarisaio",
1147 .help = "Solaris native asynchronous IO",
1148 },
1149#endif
Bruce Cran03e20d62011-01-02 20:14:54 +01001150#ifdef FIO_HAVE_WINDOWSAIO
1151 { .ival = "windowsaio",
Jens Axboe3be80072011-01-19 11:07:28 -07001152 .help = "Windows native asynchronous IO"
Steven Langde890a12011-11-09 14:03:34 +01001153 },
Jens Axboe3be80072011-01-19 11:07:28 -07001154#endif
Jens Axboe214e1ec2007-03-15 10:48:13 +01001155 { .ival = "mmap",
Bruce Cran03e20d62011-01-02 20:14:54 +01001156 .help = "Memory mapped IO"
Jens Axboe214e1ec2007-03-15 10:48:13 +01001157 },
1158#ifdef FIO_HAVE_SPLICE
1159 { .ival = "splice",
1160 .help = "splice/vmsplice based IO",
1161 },
Jens Axboe9cce02e2007-06-22 15:42:21 +02001162 { .ival = "netsplice",
1163 .help = "splice/vmsplice to/from the network",
1164 },
Jens Axboe214e1ec2007-03-15 10:48:13 +01001165#endif
1166#ifdef FIO_HAVE_SGIO
1167 { .ival = "sg",
1168 .help = "SCSI generic v3 IO",
1169 },
1170#endif
1171 { .ival = "null",
1172 .help = "Testing engine (no data transfer)",
1173 },
1174 { .ival = "net",
1175 .help = "Network IO",
1176 },
1177#ifdef FIO_HAVE_SYSLET
1178 { .ival = "syslet-rw",
1179 .help = "syslet enabled async pread/pwrite IO",
1180 },
1181#endif
1182 { .ival = "cpuio",
Bruce Cran03e20d62011-01-02 20:14:54 +01001183 .help = "CPU cycle burner engine",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001184 },
Jens Axboeb8c82a42007-03-21 08:48:26 +01001185#ifdef FIO_HAVE_GUASI
1186 { .ival = "guasi",
1187 .help = "GUASI IO engine",
1188 },
1189#endif
Jens Axboe79a43182010-09-07 13:28:58 +02001190#ifdef FIO_HAVE_BINJECT
1191 { .ival = "binject",
1192 .help = "binject direct inject block engine",
1193 },
1194#endif
ren yufei21b8aee2011-08-01 10:01:57 +02001195#ifdef FIO_HAVE_RDMA
1196 { .ival = "rdma",
1197 .help = "RDMA IO engine",
1198 },
1199#endif
Jens Axboe8200b8c2012-09-18 23:55:43 +02001200#ifdef FIO_HAVE_FUSION_AW
1201 { .ival = "fusion-aw-sync",
1202 .help = "Fusion-io atomic write engine",
1203 },
1204#endif
Jens Axboe1ecc95c2012-09-20 13:46:34 +02001205#ifdef FIO_HAVE_E4_ENG
1206 { .ival = "e4defrag",
1207 .help = "ext4 defrag engine",
1208 },
1209#endif
1210#ifdef FIO_HAVE_FALLOC_ENG
1211 { .ival = "falloc",
1212 .help = "fallocate() file based engine",
1213 },
1214#endif
Jens Axboe214e1ec2007-03-15 10:48:13 +01001215 { .ival = "external",
1216 .help = "Load external engine (append name)",
1217 },
1218 },
1219 },
1220 {
1221 .name = "iodepth",
Jens Axboee8b0e952012-03-19 14:37:08 +01001222 .lname = "IO Depth",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001223 .type = FIO_OPT_INT,
1224 .off1 = td_var_offset(iodepth),
Bruce Cran03e20d62011-01-02 20:14:54 +01001225 .help = "Number of IO buffers to keep in flight",
Jens Axboe757aff42007-12-12 19:42:13 +01001226 .minval = 1,
Jens Axboe20eb06b2012-03-16 19:57:23 +01001227 .interval = 1,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001228 .def = "1",
Jens Axboee8b0e952012-03-19 14:37:08 +01001229 .category = FIO_OPT_C_IO,
Jens Axboe06260372012-03-19 15:16:08 +01001230 .group = FIO_OPT_G_IO_BASIC,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001231 },
1232 {
1233 .name = "iodepth_batch",
Jens Axboee8b0e952012-03-19 14:37:08 +01001234 .lname = "IO Depth batch",
Jens Axboe49504212008-06-05 09:03:30 +02001235 .alias = "iodepth_batch_submit",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001236 .type = FIO_OPT_INT,
1237 .off1 = td_var_offset(iodepth_batch),
Jens Axboed65db442009-01-16 19:15:33 +01001238 .help = "Number of IO buffers to submit in one go",
Jens Axboeafdf9352007-07-31 16:14:34 +02001239 .parent = "iodepth",
Jens Axboed71c1542012-03-16 20:16:59 +01001240 .hide = 1,
Jens Axboea2e6f8a2008-01-18 10:28:11 +01001241 .minval = 1,
Jens Axboe20eb06b2012-03-16 19:57:23 +01001242 .interval = 1,
Jens Axboea2e6f8a2008-01-18 10:28:11 +01001243 .def = "1",
Jens Axboee8b0e952012-03-19 14:37:08 +01001244 .category = FIO_OPT_C_IO,
Jens Axboe06260372012-03-19 15:16:08 +01001245 .group = FIO_OPT_G_IO_BASIC,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001246 },
1247 {
Jens Axboe49504212008-06-05 09:03:30 +02001248 .name = "iodepth_batch_complete",
Jens Axboee8b0e952012-03-19 14:37:08 +01001249 .lname = "IO Depth batch complete",
Jens Axboe49504212008-06-05 09:03:30 +02001250 .type = FIO_OPT_INT,
1251 .off1 = td_var_offset(iodepth_batch_complete),
Jens Axboed65db442009-01-16 19:15:33 +01001252 .help = "Number of IO buffers to retrieve in one go",
Jens Axboe49504212008-06-05 09:03:30 +02001253 .parent = "iodepth",
Jens Axboed71c1542012-03-16 20:16:59 +01001254 .hide = 1,
Jens Axboe49504212008-06-05 09:03:30 +02001255 .minval = 0,
Jens Axboe20eb06b2012-03-16 19:57:23 +01001256 .interval = 1,
Jens Axboe49504212008-06-05 09:03:30 +02001257 .def = "1",
Jens Axboee8b0e952012-03-19 14:37:08 +01001258 .category = FIO_OPT_C_IO,
Jens Axboe06260372012-03-19 15:16:08 +01001259 .group = FIO_OPT_G_IO_BASIC,
Jens Axboe49504212008-06-05 09:03:30 +02001260 },
1261 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01001262 .name = "iodepth_low",
Jens Axboee8b0e952012-03-19 14:37:08 +01001263 .lname = "IO Depth batch low",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001264 .type = FIO_OPT_INT,
1265 .off1 = td_var_offset(iodepth_low),
1266 .help = "Low water mark for queuing depth",
Jens Axboeafdf9352007-07-31 16:14:34 +02001267 .parent = "iodepth",
Jens Axboed71c1542012-03-16 20:16:59 +01001268 .hide = 1,
Jens Axboe20eb06b2012-03-16 19:57:23 +01001269 .interval = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001270 .category = FIO_OPT_C_IO,
Jens Axboe06260372012-03-19 15:16:08 +01001271 .group = FIO_OPT_G_IO_BASIC,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001272 },
1273 {
1274 .name = "size",
Jens Axboee8b0e952012-03-19 14:37:08 +01001275 .lname = "Size",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001276 .type = FIO_OPT_STR_VAL,
Jens Axboe7bb59102011-07-12 19:47:03 +02001277 .cb = str_size_cb,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001278 .help = "Total size of device or files",
Jens Axboe20eb06b2012-03-16 19:57:23 +01001279 .interval = 1024 * 1024,
Jens Axboee8b0e952012-03-19 14:37:08 +01001280 .category = FIO_OPT_C_IO,
1281 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001282 },
1283 {
Shawn Lewisaa31f1f2008-01-11 09:45:11 +01001284 .name = "fill_device",
Jens Axboee8b0e952012-03-19 14:37:08 +01001285 .lname = "Fill device",
Jens Axboe74586c12011-01-20 10:16:03 -07001286 .alias = "fill_fs",
Shawn Lewisaa31f1f2008-01-11 09:45:11 +01001287 .type = FIO_OPT_BOOL,
1288 .off1 = td_var_offset(fill_device),
1289 .help = "Write until an ENOSPC error occurs",
1290 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01001291 .category = FIO_OPT_C_FILE,
1292 .group = FIO_OPT_G_INVALID,
Shawn Lewisaa31f1f2008-01-11 09:45:11 +01001293 },
1294 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01001295 .name = "filesize",
Jens Axboee8b0e952012-03-19 14:37:08 +01001296 .lname = "File size",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001297 .type = FIO_OPT_STR_VAL,
1298 .off1 = td_var_offset(file_size_low),
1299 .off2 = td_var_offset(file_size_high),
Jens Axboec3edbdb2007-07-20 14:25:31 +02001300 .minval = 1,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001301 .help = "Size of individual files",
Jens Axboe20eb06b2012-03-16 19:57:23 +01001302 .interval = 1024 * 1024,
Jens Axboee8b0e952012-03-19 14:37:08 +01001303 .category = FIO_OPT_C_FILE,
1304 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001305 },
1306 {
Jens Axboe67a10002007-07-31 23:12:16 +02001307 .name = "offset",
Jens Axboee8b0e952012-03-19 14:37:08 +01001308 .lname = "IO offset",
Jens Axboe67a10002007-07-31 23:12:16 +02001309 .alias = "fileoffset",
1310 .type = FIO_OPT_STR_VAL,
1311 .off1 = td_var_offset(start_offset),
1312 .help = "Start IO from this offset",
1313 .def = "0",
Jens Axboe20eb06b2012-03-16 19:57:23 +01001314 .interval = 1024 * 1024,
Jens Axboee8b0e952012-03-19 14:37:08 +01001315 .category = FIO_OPT_C_IO,
1316 .group = FIO_OPT_G_INVALID,
Jens Axboe67a10002007-07-31 23:12:16 +02001317 },
1318 {
Jens Axboe2d7cd862012-03-15 14:53:38 +01001319 .name = "offset_increment",
Jens Axboee8b0e952012-03-19 14:37:08 +01001320 .lname = "IO offset increment",
Jens Axboe2d7cd862012-03-15 14:53:38 +01001321 .type = FIO_OPT_STR_VAL,
1322 .off1 = td_var_offset(offset_increment),
1323 .help = "What is the increment from one offset to the next",
1324 .parent = "offset",
Jens Axboed71c1542012-03-16 20:16:59 +01001325 .hide = 1,
Jens Axboe2d7cd862012-03-15 14:53:38 +01001326 .def = "0",
Jens Axboe20eb06b2012-03-16 19:57:23 +01001327 .interval = 1024 * 1024,
Jens Axboee8b0e952012-03-19 14:37:08 +01001328 .category = FIO_OPT_C_IO,
1329 .group = FIO_OPT_G_INVALID,
Jens Axboe2d7cd862012-03-15 14:53:38 +01001330 },
1331 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01001332 .name = "bs",
Jens Axboee8b0e952012-03-19 14:37:08 +01001333 .lname = "Block size",
Jens Axboed3aad8f2007-03-15 14:12:05 +01001334 .alias = "blocksize",
Jens Axboee01b22b2009-06-09 15:43:25 +02001335 .type = FIO_OPT_INT,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001336 .off1 = td_var_offset(bs[DDIR_READ]),
1337 .off2 = td_var_offset(bs[DDIR_WRITE]),
Shaohua Li6eaf09d2012-09-14 08:49:43 +02001338 .off3 = td_var_offset(bs[DDIR_TRIM]),
Jens Axboec3edbdb2007-07-20 14:25:31 +02001339 .minval = 1,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001340 .help = "Block size unit",
1341 .def = "4k",
Jens Axboe67a10002007-07-31 23:12:16 +02001342 .parent = "rw",
Jens Axboed71c1542012-03-16 20:16:59 +01001343 .hide = 1,
Jens Axboe20eb06b2012-03-16 19:57:23 +01001344 .interval = 512,
Jens Axboee8b0e952012-03-19 14:37:08 +01001345 .category = FIO_OPT_C_IO,
1346 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001347 },
1348 {
Jens Axboe2b7a01d2009-03-11 11:00:13 +01001349 .name = "ba",
Jens Axboee8b0e952012-03-19 14:37:08 +01001350 .lname = "Block size align",
Jens Axboe2b7a01d2009-03-11 11:00:13 +01001351 .alias = "blockalign",
Jens Axboee01b22b2009-06-09 15:43:25 +02001352 .type = FIO_OPT_INT,
Jens Axboe2b7a01d2009-03-11 11:00:13 +01001353 .off1 = td_var_offset(ba[DDIR_READ]),
1354 .off2 = td_var_offset(ba[DDIR_WRITE]),
Shaohua Li6eaf09d2012-09-14 08:49:43 +02001355 .off3 = td_var_offset(ba[DDIR_TRIM]),
Jens Axboe2b7a01d2009-03-11 11:00:13 +01001356 .minval = 1,
1357 .help = "IO block offset alignment",
1358 .parent = "rw",
Jens Axboed71c1542012-03-16 20:16:59 +01001359 .hide = 1,
Jens Axboe20eb06b2012-03-16 19:57:23 +01001360 .interval = 512,
Jens Axboee8b0e952012-03-19 14:37:08 +01001361 .category = FIO_OPT_C_IO,
1362 .group = FIO_OPT_G_INVALID,
Jens Axboe2b7a01d2009-03-11 11:00:13 +01001363 },
1364 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01001365 .name = "bsrange",
Jens Axboee8b0e952012-03-19 14:37:08 +01001366 .lname = "Block size range",
Jens Axboed3aad8f2007-03-15 14:12:05 +01001367 .alias = "blocksize_range",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001368 .type = FIO_OPT_RANGE,
1369 .off1 = td_var_offset(min_bs[DDIR_READ]),
1370 .off2 = td_var_offset(max_bs[DDIR_READ]),
1371 .off3 = td_var_offset(min_bs[DDIR_WRITE]),
1372 .off4 = td_var_offset(max_bs[DDIR_WRITE]),
Shaohua Li6eaf09d2012-09-14 08:49:43 +02001373 .off5 = td_var_offset(min_bs[DDIR_TRIM]),
1374 .off6 = td_var_offset(max_bs[DDIR_TRIM]),
Jens Axboec3edbdb2007-07-20 14:25:31 +02001375 .minval = 1,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001376 .help = "Set block size range (in more detail than bs)",
Jens Axboe67a10002007-07-31 23:12:16 +02001377 .parent = "rw",
Jens Axboed71c1542012-03-16 20:16:59 +01001378 .hide = 1,
Jens Axboe20eb06b2012-03-16 19:57:23 +01001379 .interval = 4096,
Jens Axboee8b0e952012-03-19 14:37:08 +01001380 .category = FIO_OPT_C_IO,
1381 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001382 },
1383 {
Jens Axboe564ca972007-12-14 12:21:19 +01001384 .name = "bssplit",
Jens Axboee8b0e952012-03-19 14:37:08 +01001385 .lname = "Block size split",
Jens Axboe564ca972007-12-14 12:21:19 +01001386 .type = FIO_OPT_STR,
1387 .cb = str_bssplit_cb,
1388 .help = "Set a specific mix of block sizes",
1389 .parent = "rw",
Jens Axboed71c1542012-03-16 20:16:59 +01001390 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001391 .category = FIO_OPT_C_IO,
1392 .group = FIO_OPT_G_INVALID,
Jens Axboe564ca972007-12-14 12:21:19 +01001393 },
1394 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01001395 .name = "bs_unaligned",
Jens Axboee8b0e952012-03-19 14:37:08 +01001396 .lname = "Block size unaligned",
Jens Axboed3aad8f2007-03-15 14:12:05 +01001397 .alias = "blocksize_unaligned",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001398 .type = FIO_OPT_STR_SET,
1399 .off1 = td_var_offset(bs_unaligned),
1400 .help = "Don't sector align IO buffer sizes",
Jens Axboe67a10002007-07-31 23:12:16 +02001401 .parent = "rw",
Jens Axboed71c1542012-03-16 20:16:59 +01001402 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001403 .category = FIO_OPT_C_IO,
1404 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001405 },
1406 {
1407 .name = "randrepeat",
Jens Axboee8b0e952012-03-19 14:37:08 +01001408 .lname = "Random repeatable",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001409 .type = FIO_OPT_BOOL,
1410 .off1 = td_var_offset(rand_repeatable),
1411 .help = "Use repeatable random IO pattern",
1412 .def = "1",
Jens Axboe67a10002007-07-31 23:12:16 +02001413 .parent = "rw",
Jens Axboed71c1542012-03-16 20:16:59 +01001414 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001415 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01001416 .group = FIO_OPT_G_RANDOM,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001417 },
1418 {
Jens Axboe2615cc42011-03-28 09:35:09 +02001419 .name = "use_os_rand",
Jens Axboee8b0e952012-03-19 14:37:08 +01001420 .lname = "Use OS random",
Jens Axboe2615cc42011-03-28 09:35:09 +02001421 .type = FIO_OPT_BOOL,
1422 .off1 = td_var_offset(use_os_rand),
1423 .help = "Set to use OS random generator",
1424 .def = "0",
1425 .parent = "rw",
Jens Axboed71c1542012-03-16 20:16:59 +01001426 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001427 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01001428 .group = FIO_OPT_G_RANDOM,
Jens Axboe2615cc42011-03-28 09:35:09 +02001429 },
1430 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01001431 .name = "norandommap",
Jens Axboee8b0e952012-03-19 14:37:08 +01001432 .lname = "No randommap",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001433 .type = FIO_OPT_STR_SET,
1434 .off1 = td_var_offset(norandommap),
1435 .help = "Accept potential duplicate random blocks",
Jens Axboe67a10002007-07-31 23:12:16 +02001436 .parent = "rw",
Jens Axboed71c1542012-03-16 20:16:59 +01001437 .hide = 1,
Jens Axboeb2452a42012-03-20 10:29:45 +01001438 .hide_on_set = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001439 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01001440 .group = FIO_OPT_G_RANDOM,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001441 },
1442 {
Jens Axboe2b386d22008-03-26 10:32:57 +01001443 .name = "softrandommap",
Jens Axboee8b0e952012-03-19 14:37:08 +01001444 .lname = "Soft randommap",
Jens Axboe2b386d22008-03-26 10:32:57 +01001445 .type = FIO_OPT_BOOL,
1446 .off1 = td_var_offset(softrandommap),
Jens Axboef66ab3c2008-06-05 11:48:22 +02001447 .help = "Set norandommap if randommap allocation fails",
Jens Axboe2b386d22008-03-26 10:32:57 +01001448 .parent = "norandommap",
Jens Axboed71c1542012-03-16 20:16:59 +01001449 .hide = 1,
Jens Axboe2b386d22008-03-26 10:32:57 +01001450 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01001451 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01001452 .group = FIO_OPT_G_RANDOM,
Jens Axboe2b386d22008-03-26 10:32:57 +01001453 },
1454 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01001455 .name = "nrfiles",
Jens Axboee8b0e952012-03-19 14:37:08 +01001456 .lname = "Number of files",
Jens Axboed7c8be02010-11-25 08:21:39 +01001457 .alias = "nr_files",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001458 .type = FIO_OPT_INT,
1459 .off1 = td_var_offset(nr_files),
1460 .help = "Split job workload between this number of files",
1461 .def = "1",
Jens Axboe20eb06b2012-03-16 19:57:23 +01001462 .interval = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001463 .category = FIO_OPT_C_FILE,
1464 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001465 },
1466 {
1467 .name = "openfiles",
Jens Axboee8b0e952012-03-19 14:37:08 +01001468 .lname = "Number of open files",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001469 .type = FIO_OPT_INT,
1470 .off1 = td_var_offset(open_files),
1471 .help = "Number of files to keep open at the same time",
Jens Axboee8b0e952012-03-19 14:37:08 +01001472 .category = FIO_OPT_C_FILE,
1473 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001474 },
1475 {
1476 .name = "file_service_type",
Jens Axboee8b0e952012-03-19 14:37:08 +01001477 .lname = "File service type",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001478 .type = FIO_OPT_STR,
1479 .cb = str_fst_cb,
1480 .off1 = td_var_offset(file_service_type),
1481 .help = "How to select which file to service next",
1482 .def = "roundrobin",
Jens Axboee8b0e952012-03-19 14:37:08 +01001483 .category = FIO_OPT_C_FILE,
1484 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001485 .posval = {
1486 { .ival = "random",
1487 .oval = FIO_FSERVICE_RANDOM,
1488 .help = "Choose a file at random",
1489 },
1490 { .ival = "roundrobin",
1491 .oval = FIO_FSERVICE_RR,
1492 .help = "Round robin select files",
1493 },
Jens Axboea086c252009-03-04 08:27:37 +01001494 { .ival = "sequential",
1495 .oval = FIO_FSERVICE_SEQ,
1496 .help = "Finish one file before moving to the next",
1497 },
Jens Axboe214e1ec2007-03-15 10:48:13 +01001498 },
Jens Axboe67a10002007-07-31 23:12:16 +02001499 .parent = "nrfiles",
Jens Axboed71c1542012-03-16 20:16:59 +01001500 .hide = 1,
Jens Axboe67a10002007-07-31 23:12:16 +02001501 },
Jens Axboe7bc8c2c2010-01-28 11:31:31 +01001502#ifdef FIO_HAVE_FALLOCATE
1503 {
1504 .name = "fallocate",
Jens Axboee8b0e952012-03-19 14:37:08 +01001505 .lname = "Fallocate",
Eric Gourioua596f042011-06-17 09:11:45 +02001506 .type = FIO_OPT_STR,
1507 .off1 = td_var_offset(fallocate_mode),
1508 .help = "Whether pre-allocation is performed when laying out files",
1509 .def = "posix",
Jens Axboee8b0e952012-03-19 14:37:08 +01001510 .category = FIO_OPT_C_FILE,
1511 .group = FIO_OPT_G_INVALID,
Eric Gourioua596f042011-06-17 09:11:45 +02001512 .posval = {
1513 { .ival = "none",
1514 .oval = FIO_FALLOCATE_NONE,
1515 .help = "Do not pre-allocate space",
1516 },
1517 { .ival = "posix",
1518 .oval = FIO_FALLOCATE_POSIX,
1519 .help = "Use posix_fallocate()",
1520 },
1521#ifdef FIO_HAVE_LINUX_FALLOCATE
1522 { .ival = "keep",
1523 .oval = FIO_FALLOCATE_KEEP_SIZE,
1524 .help = "Use fallocate(..., FALLOC_FL_KEEP_SIZE, ...)",
1525 },
Jens Axboe7bc8c2c2010-01-28 11:31:31 +01001526#endif
Eric Gourioua596f042011-06-17 09:11:45 +02001527 /* Compatibility with former boolean values */
1528 { .ival = "0",
1529 .oval = FIO_FALLOCATE_NONE,
1530 .help = "Alias for 'none'",
1531 },
1532 { .ival = "1",
1533 .oval = FIO_FALLOCATE_POSIX,
1534 .help = "Alias for 'posix'",
1535 },
1536 },
1537 },
1538#endif /* FIO_HAVE_FALLOCATE */
Jens Axboe67a10002007-07-31 23:12:16 +02001539 {
1540 .name = "fadvise_hint",
Jens Axboee8b0e952012-03-19 14:37:08 +01001541 .lname = "Fadvise hint",
Jens Axboe67a10002007-07-31 23:12:16 +02001542 .type = FIO_OPT_BOOL,
1543 .off1 = td_var_offset(fadvise_hint),
1544 .help = "Use fadvise() to advise the kernel on IO pattern",
1545 .def = "1",
Jens Axboee8b0e952012-03-19 14:37:08 +01001546 .category = FIO_OPT_C_FILE,
1547 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001548 },
1549 {
1550 .name = "fsync",
Jens Axboee8b0e952012-03-19 14:37:08 +01001551 .lname = "Fsync",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001552 .type = FIO_OPT_INT,
1553 .off1 = td_var_offset(fsync_blocks),
1554 .help = "Issue fsync for writes every given number of blocks",
1555 .def = "0",
Jens Axboe20eb06b2012-03-16 19:57:23 +01001556 .interval = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001557 .category = FIO_OPT_C_FILE,
1558 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001559 },
1560 {
Jens Axboe5f9099e2009-06-16 22:40:26 +02001561 .name = "fdatasync",
Jens Axboee8b0e952012-03-19 14:37:08 +01001562 .lname = "Fdatasync",
Jens Axboe5f9099e2009-06-16 22:40:26 +02001563 .type = FIO_OPT_INT,
1564 .off1 = td_var_offset(fdatasync_blocks),
1565 .help = "Issue fdatasync for writes every given number of blocks",
1566 .def = "0",
Jens Axboe20eb06b2012-03-16 19:57:23 +01001567 .interval = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001568 .category = FIO_OPT_C_FILE,
1569 .group = FIO_OPT_G_INVALID,
Jens Axboe5f9099e2009-06-16 22:40:26 +02001570 },
Jens Axboe1ef2b6b2010-10-08 15:07:01 +02001571 {
1572 .name = "write_barrier",
Jens Axboee8b0e952012-03-19 14:37:08 +01001573 .lname = "Write barrier",
Jens Axboe1ef2b6b2010-10-08 15:07:01 +02001574 .type = FIO_OPT_INT,
1575 .off1 = td_var_offset(barrier_blocks),
1576 .help = "Make every Nth write a barrier write",
1577 .def = "0",
Jens Axboe20eb06b2012-03-16 19:57:23 +01001578 .interval = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001579 .category = FIO_OPT_C_IO,
1580 .group = FIO_OPT_G_INVALID,
Jens Axboe1ef2b6b2010-10-08 15:07:01 +02001581 },
Jens Axboe44f29692010-03-09 20:09:44 +01001582#ifdef FIO_HAVE_SYNC_FILE_RANGE
1583 {
1584 .name = "sync_file_range",
Jens Axboee8b0e952012-03-19 14:37:08 +01001585 .lname = "Sync file range",
Jens Axboe44f29692010-03-09 20:09:44 +01001586 .posval = {
1587 { .ival = "wait_before",
1588 .oval = SYNC_FILE_RANGE_WAIT_BEFORE,
1589 .help = "SYNC_FILE_RANGE_WAIT_BEFORE",
Jens Axboe3843deb2010-03-09 20:41:15 +01001590 .or = 1,
Jens Axboe44f29692010-03-09 20:09:44 +01001591 },
1592 { .ival = "write",
1593 .oval = SYNC_FILE_RANGE_WRITE,
1594 .help = "SYNC_FILE_RANGE_WRITE",
Jens Axboe3843deb2010-03-09 20:41:15 +01001595 .or = 1,
Jens Axboe44f29692010-03-09 20:09:44 +01001596 },
1597 {
1598 .ival = "wait_after",
1599 .oval = SYNC_FILE_RANGE_WAIT_AFTER,
1600 .help = "SYNC_FILE_RANGE_WAIT_AFTER",
Jens Axboe3843deb2010-03-09 20:41:15 +01001601 .or = 1,
Jens Axboe44f29692010-03-09 20:09:44 +01001602 },
1603 },
Jens Axboe3843deb2010-03-09 20:41:15 +01001604 .type = FIO_OPT_STR_MULTI,
Jens Axboe44f29692010-03-09 20:09:44 +01001605 .cb = str_sfr_cb,
1606 .off1 = td_var_offset(sync_file_range),
1607 .help = "Use sync_file_range()",
Jens Axboee8b0e952012-03-19 14:37:08 +01001608 .category = FIO_OPT_C_FILE,
1609 .group = FIO_OPT_G_INVALID,
Jens Axboe44f29692010-03-09 20:09:44 +01001610 },
1611#endif
Jens Axboe5f9099e2009-06-16 22:40:26 +02001612 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01001613 .name = "direct",
Jens Axboee8b0e952012-03-19 14:37:08 +01001614 .lname = "Direct I/O",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001615 .type = FIO_OPT_BOOL,
1616 .off1 = td_var_offset(odirect),
1617 .help = "Use O_DIRECT IO (negates buffered)",
1618 .def = "0",
Jens Axboea01a1bc2012-03-19 21:13:01 +01001619 .inverse = "buffered",
Jens Axboee8b0e952012-03-19 14:37:08 +01001620 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01001621 .group = FIO_OPT_G_IO_TYPE,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001622 },
1623 {
1624 .name = "buffered",
Jens Axboee8b0e952012-03-19 14:37:08 +01001625 .lname = "Buffered I/O",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001626 .type = FIO_OPT_BOOL,
1627 .off1 = td_var_offset(odirect),
1628 .neg = 1,
1629 .help = "Use buffered IO (negates direct)",
1630 .def = "1",
Jens Axboea01a1bc2012-03-19 21:13:01 +01001631 .inverse = "direct",
Jens Axboee8b0e952012-03-19 14:37:08 +01001632 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01001633 .group = FIO_OPT_G_IO_TYPE,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001634 },
1635 {
1636 .name = "overwrite",
Jens Axboee8b0e952012-03-19 14:37:08 +01001637 .lname = "Overwrite",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001638 .type = FIO_OPT_BOOL,
1639 .off1 = td_var_offset(overwrite),
1640 .help = "When writing, set whether to overwrite current data",
1641 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01001642 .category = FIO_OPT_C_FILE,
1643 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001644 },
1645 {
1646 .name = "loops",
Jens Axboee8b0e952012-03-19 14:37:08 +01001647 .lname = "Loops",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001648 .type = FIO_OPT_INT,
1649 .off1 = td_var_offset(loops),
1650 .help = "Number of times to run the job",
1651 .def = "1",
Jens Axboe20eb06b2012-03-16 19:57:23 +01001652 .interval = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001653 .category = FIO_OPT_C_GENERAL,
Jens Axboea1f6afe2012-03-19 20:44:33 +01001654 .group = FIO_OPT_G_RUNTIME,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001655 },
1656 {
1657 .name = "numjobs",
Jens Axboee8b0e952012-03-19 14:37:08 +01001658 .lname = "Number of jobs",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001659 .type = FIO_OPT_INT,
1660 .off1 = td_var_offset(numjobs),
1661 .help = "Duplicate this job this many times",
1662 .def = "1",
Jens Axboe20eb06b2012-03-16 19:57:23 +01001663 .interval = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001664 .category = FIO_OPT_C_GENERAL,
Jens Axboea1f6afe2012-03-19 20:44:33 +01001665 .group = FIO_OPT_G_RUNTIME,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001666 },
1667 {
1668 .name = "startdelay",
Jens Axboee8b0e952012-03-19 14:37:08 +01001669 .lname = "Start delay",
Jens Axboea5737c92010-06-29 10:40:30 +02001670 .type = FIO_OPT_STR_VAL_TIME,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001671 .off1 = td_var_offset(start_delay),
1672 .help = "Only start job when this period has passed",
1673 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01001674 .category = FIO_OPT_C_GENERAL,
Jens Axboea1f6afe2012-03-19 20:44:33 +01001675 .group = FIO_OPT_G_RUNTIME,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001676 },
1677 {
1678 .name = "runtime",
Jens Axboee8b0e952012-03-19 14:37:08 +01001679 .lname = "Runtime",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001680 .alias = "timeout",
1681 .type = FIO_OPT_STR_VAL_TIME,
1682 .off1 = td_var_offset(timeout),
1683 .help = "Stop workload when this amount of time has passed",
1684 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01001685 .category = FIO_OPT_C_GENERAL,
Jens Axboea1f6afe2012-03-19 20:44:33 +01001686 .group = FIO_OPT_G_RUNTIME,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001687 },
1688 {
Jens Axboecf4464c2007-04-17 20:14:42 +02001689 .name = "time_based",
Jens Axboee8b0e952012-03-19 14:37:08 +01001690 .lname = "Time based",
Jens Axboecf4464c2007-04-17 20:14:42 +02001691 .type = FIO_OPT_STR_SET,
1692 .off1 = td_var_offset(time_based),
1693 .help = "Keep running until runtime/timeout is met",
Jens Axboee8b0e952012-03-19 14:37:08 +01001694 .category = FIO_OPT_C_GENERAL,
Jens Axboea1f6afe2012-03-19 20:44:33 +01001695 .group = FIO_OPT_G_RUNTIME,
Jens Axboecf4464c2007-04-17 20:14:42 +02001696 },
1697 {
Jens Axboe721938a2008-09-10 09:46:16 +02001698 .name = "ramp_time",
Jens Axboee8b0e952012-03-19 14:37:08 +01001699 .lname = "Ramp time",
Jens Axboe721938a2008-09-10 09:46:16 +02001700 .type = FIO_OPT_STR_VAL_TIME,
1701 .off1 = td_var_offset(ramp_time),
1702 .help = "Ramp up time before measuring performance",
Jens Axboee8b0e952012-03-19 14:37:08 +01001703 .category = FIO_OPT_C_GENERAL,
Jens Axboea1f6afe2012-03-19 20:44:33 +01001704 .group = FIO_OPT_G_RUNTIME,
Jens Axboe721938a2008-09-10 09:46:16 +02001705 },
1706 {
Jens Axboec223da82010-03-24 13:23:53 +01001707 .name = "clocksource",
Jens Axboee8b0e952012-03-19 14:37:08 +01001708 .lname = "Clock source",
Jens Axboec223da82010-03-24 13:23:53 +01001709 .type = FIO_OPT_STR,
1710 .cb = fio_clock_source_cb,
1711 .off1 = td_var_offset(clocksource),
1712 .help = "What type of timing source to use",
Jens Axboee8b0e952012-03-19 14:37:08 +01001713 .category = FIO_OPT_C_GENERAL,
Jens Axboe10860052012-03-19 20:56:53 +01001714 .group = FIO_OPT_G_CLOCK,
Jens Axboec223da82010-03-24 13:23:53 +01001715 .posval = {
1716 { .ival = "gettimeofday",
1717 .oval = CS_GTOD,
1718 .help = "Use gettimeofday(2) for timing",
1719 },
1720 { .ival = "clock_gettime",
1721 .oval = CS_CGETTIME,
1722 .help = "Use clock_gettime(2) for timing",
1723 },
1724#ifdef ARCH_HAVE_CPU_CLOCK
1725 { .ival = "cpu",
1726 .oval = CS_CPUCLOCK,
1727 .help = "Use CPU private clock",
1728 },
1729#endif
1730 },
1731 },
1732 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01001733 .name = "mem",
Jens Axboed3aad8f2007-03-15 14:12:05 +01001734 .alias = "iomem",
Jens Axboee8b0e952012-03-19 14:37:08 +01001735 .lname = "I/O Memory",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001736 .type = FIO_OPT_STR,
1737 .cb = str_mem_cb,
1738 .off1 = td_var_offset(mem_type),
1739 .help = "Backing type for IO buffers",
1740 .def = "malloc",
Jens Axboee8b0e952012-03-19 14:37:08 +01001741 .category = FIO_OPT_C_IO,
1742 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001743 .posval = {
1744 { .ival = "malloc",
1745 .oval = MEM_MALLOC,
1746 .help = "Use malloc(3) for IO buffers",
1747 },
Jens Axboeb370e462007-03-19 10:51:49 +01001748 { .ival = "shm",
1749 .oval = MEM_SHM,
1750 .help = "Use shared memory segments for IO buffers",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001751 },
1752#ifdef FIO_HAVE_HUGETLB
Jens Axboe37c8cdf2007-03-19 13:14:03 +01001753 { .ival = "shmhuge",
1754 .oval = MEM_SHMHUGE,
1755 .help = "Like shm, but use huge pages",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001756 },
1757#endif
Jens Axboeb370e462007-03-19 10:51:49 +01001758 { .ival = "mmap",
1759 .oval = MEM_MMAP,
1760 .help = "Use mmap(2) (file or anon) for IO buffers",
1761 },
Jens Axboe37c8cdf2007-03-19 13:14:03 +01001762#ifdef FIO_HAVE_HUGETLB
1763 { .ival = "mmaphuge",
1764 .oval = MEM_MMAPHUGE,
1765 .help = "Like mmap, but use huge pages",
1766 },
1767#endif
Jens Axboe214e1ec2007-03-15 10:48:13 +01001768 },
1769 },
1770 {
Jens Axboed529ee12009-07-01 10:33:03 +02001771 .name = "iomem_align",
1772 .alias = "mem_align",
Jens Axboee8b0e952012-03-19 14:37:08 +01001773 .lname = "I/O memory alignment",
Jens Axboed529ee12009-07-01 10:33:03 +02001774 .type = FIO_OPT_INT,
1775 .off1 = td_var_offset(mem_align),
1776 .minval = 0,
1777 .help = "IO memory buffer offset alignment",
1778 .def = "0",
1779 .parent = "iomem",
Jens Axboed71c1542012-03-16 20:16:59 +01001780 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001781 .category = FIO_OPT_C_IO,
1782 .group = FIO_OPT_G_INVALID,
Jens Axboed529ee12009-07-01 10:33:03 +02001783 },
1784 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01001785 .name = "verify",
Jens Axboee8b0e952012-03-19 14:37:08 +01001786 .lname = "Verify",
Jens Axboe214e1ec2007-03-15 10:48:13 +01001787 .type = FIO_OPT_STR,
1788 .off1 = td_var_offset(verify),
1789 .help = "Verify data written",
1790 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01001791 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01001792 .group = FIO_OPT_G_VERIFY,
Jens Axboe214e1ec2007-03-15 10:48:13 +01001793 .posval = {
1794 { .ival = "0",
1795 .oval = VERIFY_NONE,
1796 .help = "Don't do IO verification",
1797 },
Jens Axboefcca4b52007-07-27 15:42:00 +02001798 { .ival = "md5",
1799 .oval = VERIFY_MD5,
1800 .help = "Use md5 checksums for verification",
1801 },
Jens Axboed77a7af2007-07-27 15:35:06 +02001802 { .ival = "crc64",
1803 .oval = VERIFY_CRC64,
1804 .help = "Use crc64 checksums for verification",
1805 },
Jens Axboe214e1ec2007-03-15 10:48:13 +01001806 { .ival = "crc32",
1807 .oval = VERIFY_CRC32,
1808 .help = "Use crc32 checksums for verification",
1809 },
Jens Axboeaf497e62008-08-04 15:40:35 +02001810 { .ival = "crc32c-intel",
Jens Axboee3aaafc2012-02-22 20:28:17 +01001811 .oval = VERIFY_CRC32C,
1812 .help = "Use crc32c checksums for verification (hw assisted, if available)",
Jens Axboeaf497e62008-08-04 15:40:35 +02001813 },
Jens Axboebac39e02008-06-11 20:46:19 +02001814 { .ival = "crc32c",
1815 .oval = VERIFY_CRC32C,
Jens Axboee3aaafc2012-02-22 20:28:17 +01001816 .help = "Use crc32c checksums for verification (hw assisted, if available)",
Jens Axboebac39e02008-06-11 20:46:19 +02001817 },
Jens Axboe969f7ed2007-07-27 09:07:17 +02001818 { .ival = "crc16",
1819 .oval = VERIFY_CRC16,
1820 .help = "Use crc16 checksums for verification",
1821 },
Jens Axboe1e154bd2007-07-27 09:52:40 +02001822 { .ival = "crc7",
1823 .oval = VERIFY_CRC7,
1824 .help = "Use crc7 checksums for verification",
1825 },
Jens Axboe7c353ce2009-08-09 22:40:33 +02001826 { .ival = "sha1",
1827 .oval = VERIFY_SHA1,
1828 .help = "Use sha1 checksums for verification",
1829 },
Jens Axboecd14cc12007-07-30 10:59:33 +02001830 { .ival = "sha256",
1831 .oval = VERIFY_SHA256,
1832 .help = "Use sha256 checksums for verification",
1833 },
1834 { .ival = "sha512",
1835 .oval = VERIFY_SHA512,
1836 .help = "Use sha512 checksums for verification",
1837 },
Shawn Lewis7437ee82007-08-02 21:05:58 +02001838 { .ival = "meta",
1839 .oval = VERIFY_META,
1840 .help = "Use io information",
1841 },
Jens Axboe36690c92007-03-26 10:23:34 +02001842 {
1843 .ival = "null",
1844 .oval = VERIFY_NULL,
1845 .help = "Pretend to verify",
1846 },
Jens Axboe214e1ec2007-03-15 10:48:13 +01001847 },
1848 },
1849 {
Jens Axboe005c5652007-08-02 22:21:36 +02001850 .name = "do_verify",
Jens Axboee8b0e952012-03-19 14:37:08 +01001851 .lname = "Perform verify step",
Jens Axboe68e1f292007-08-10 10:32:14 +02001852 .type = FIO_OPT_BOOL,
Jens Axboe005c5652007-08-02 22:21:36 +02001853 .off1 = td_var_offset(do_verify),
1854 .help = "Run verification stage after write",
1855 .def = "1",
1856 .parent = "verify",
Jens Axboed71c1542012-03-16 20:16:59 +01001857 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001858 .category = FIO_OPT_C_IO,
1859 .group = FIO_OPT_G_VERIFY,
Jens Axboe005c5652007-08-02 22:21:36 +02001860 },
1861 {
Jens Axboe160b9662007-03-27 10:59:49 +02001862 .name = "verifysort",
Jens Axboee8b0e952012-03-19 14:37:08 +01001863 .lname = "Verify sort",
Jens Axboe160b9662007-03-27 10:59:49 +02001864 .type = FIO_OPT_BOOL,
1865 .off1 = td_var_offset(verifysort),
1866 .help = "Sort written verify blocks for read back",
1867 .def = "1",
Jens Axboec83f2df2007-07-31 22:51:47 +02001868 .parent = "verify",
Jens Axboed71c1542012-03-16 20:16:59 +01001869 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001870 .category = FIO_OPT_C_IO,
1871 .group = FIO_OPT_G_VERIFY,
Jens Axboe160b9662007-03-27 10:59:49 +02001872 },
1873 {
Jens Axboea59e1702007-07-30 08:53:27 +02001874 .name = "verify_interval",
Jens Axboee8b0e952012-03-19 14:37:08 +01001875 .lname = "Verify interval",
Jens Axboee01b22b2009-06-09 15:43:25 +02001876 .type = FIO_OPT_INT,
Jens Axboea59e1702007-07-30 08:53:27 +02001877 .off1 = td_var_offset(verify_interval),
Jens Axboe819a9682007-07-28 21:30:31 +02001878 .minval = 2 * sizeof(struct verify_header),
Jens Axboea59e1702007-07-30 08:53:27 +02001879 .help = "Store verify buffer header every N bytes",
Jens Axboeafdf9352007-07-31 16:14:34 +02001880 .parent = "verify",
Jens Axboed71c1542012-03-16 20:16:59 +01001881 .hide = 1,
Jens Axboe20eb06b2012-03-16 19:57:23 +01001882 .interval = 2 * sizeof(struct verify_header),
Jens Axboee8b0e952012-03-19 14:37:08 +01001883 .category = FIO_OPT_C_IO,
1884 .group = FIO_OPT_G_VERIFY,
Shawn Lewis3f9f4e22007-07-28 21:10:37 +02001885 },
1886 {
Jens Axboea59e1702007-07-30 08:53:27 +02001887 .name = "verify_offset",
Jens Axboee8b0e952012-03-19 14:37:08 +01001888 .lname = "Verify offset",
Jens Axboee01b22b2009-06-09 15:43:25 +02001889 .type = FIO_OPT_INT,
Jens Axboea59e1702007-07-30 08:53:27 +02001890 .help = "Offset verify header location by N bytes",
Jens Axboe203160d2012-03-29 21:17:12 +02001891 .off1 = td_var_offset(verify_offset),
1892 .minval = sizeof(struct verify_header),
Jens Axboeafdf9352007-07-31 16:14:34 +02001893 .parent = "verify",
Jens Axboed71c1542012-03-16 20:16:59 +01001894 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001895 .category = FIO_OPT_C_IO,
1896 .group = FIO_OPT_G_VERIFY,
Shawn Lewis546a9142007-07-28 21:11:37 +02001897 },
1898 {
Shawn Lewise28218f2008-01-16 11:01:33 +01001899 .name = "verify_pattern",
Jens Axboee8b0e952012-03-19 14:37:08 +01001900 .lname = "Verify pattern",
Radha Ramachandran0e92f872009-10-27 20:14:27 +01001901 .type = FIO_OPT_STR,
Shawn Lewise28218f2008-01-16 11:01:33 +01001902 .cb = str_verify_pattern_cb,
1903 .help = "Fill pattern for IO buffers",
1904 .parent = "verify",
Jens Axboed71c1542012-03-16 20:16:59 +01001905 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001906 .category = FIO_OPT_C_IO,
1907 .group = FIO_OPT_G_VERIFY,
Shawn Lewise28218f2008-01-16 11:01:33 +01001908 },
1909 {
Jens Axboea12a3b42007-08-09 10:20:54 +02001910 .name = "verify_fatal",
Jens Axboee8b0e952012-03-19 14:37:08 +01001911 .lname = "Verify fatal",
Jens Axboe68e1f292007-08-10 10:32:14 +02001912 .type = FIO_OPT_BOOL,
Jens Axboea12a3b42007-08-09 10:20:54 +02001913 .off1 = td_var_offset(verify_fatal),
1914 .def = "0",
1915 .help = "Exit on a single verify failure, don't continue",
1916 .parent = "verify",
Jens Axboed71c1542012-03-16 20:16:59 +01001917 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001918 .category = FIO_OPT_C_IO,
1919 .group = FIO_OPT_G_VERIFY,
Jens Axboea12a3b42007-08-09 10:20:54 +02001920 },
1921 {
Jens Axboeb463e932011-01-12 09:03:23 +01001922 .name = "verify_dump",
Jens Axboee8b0e952012-03-19 14:37:08 +01001923 .lname = "Verify dump",
Jens Axboeb463e932011-01-12 09:03:23 +01001924 .type = FIO_OPT_BOOL,
1925 .off1 = td_var_offset(verify_dump),
Jens Axboeef71e312011-10-25 22:43:36 +02001926 .def = "0",
Jens Axboeb463e932011-01-12 09:03:23 +01001927 .help = "Dump contents of good and bad blocks on failure",
1928 .parent = "verify",
Jens Axboed71c1542012-03-16 20:16:59 +01001929 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001930 .category = FIO_OPT_C_IO,
1931 .group = FIO_OPT_G_VERIFY,
Jens Axboeb463e932011-01-12 09:03:23 +01001932 },
1933 {
Jens Axboee8462bd2009-07-06 12:59:04 +02001934 .name = "verify_async",
Jens Axboee8b0e952012-03-19 14:37:08 +01001935 .lname = "Verify asynchronously",
Jens Axboee8462bd2009-07-06 12:59:04 +02001936 .type = FIO_OPT_INT,
1937 .off1 = td_var_offset(verify_async),
1938 .def = "0",
1939 .help = "Number of async verifier threads to use",
1940 .parent = "verify",
Jens Axboed71c1542012-03-16 20:16:59 +01001941 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001942 .category = FIO_OPT_C_IO,
1943 .group = FIO_OPT_G_VERIFY,
Jens Axboee8462bd2009-07-06 12:59:04 +02001944 },
Jens Axboe9e144182010-06-15 14:25:36 +02001945 {
1946 .name = "verify_backlog",
Jens Axboee8b0e952012-03-19 14:37:08 +01001947 .lname = "Verify backlog",
Jens Axboe9e144182010-06-15 14:25:36 +02001948 .type = FIO_OPT_STR_VAL,
1949 .off1 = td_var_offset(verify_backlog),
1950 .help = "Verify after this number of blocks are written",
1951 .parent = "verify",
Jens Axboed71c1542012-03-16 20:16:59 +01001952 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001953 .category = FIO_OPT_C_IO,
1954 .group = FIO_OPT_G_VERIFY,
Jens Axboe9e144182010-06-15 14:25:36 +02001955 },
1956 {
1957 .name = "verify_backlog_batch",
Jens Axboee8b0e952012-03-19 14:37:08 +01001958 .lname = "Verify backlog batch",
Jens Axboe9e144182010-06-15 14:25:36 +02001959 .type = FIO_OPT_INT,
1960 .off1 = td_var_offset(verify_batch),
1961 .help = "Verify this number of IO blocks",
Jens Axboe0d29de82010-09-01 13:54:15 +02001962 .parent = "verify",
Jens Axboed71c1542012-03-16 20:16:59 +01001963 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001964 .category = FIO_OPT_C_IO,
1965 .group = FIO_OPT_G_VERIFY,
Jens Axboe9e144182010-06-15 14:25:36 +02001966 },
Jens Axboee8462bd2009-07-06 12:59:04 +02001967#ifdef FIO_HAVE_CPU_AFFINITY
1968 {
1969 .name = "verify_async_cpus",
Jens Axboee8b0e952012-03-19 14:37:08 +01001970 .lname = "Async verify CPUs",
Jens Axboee8462bd2009-07-06 12:59:04 +02001971 .type = FIO_OPT_STR,
1972 .cb = str_verify_cpus_allowed_cb,
1973 .help = "Set CPUs allowed for async verify threads",
1974 .parent = "verify_async",
Jens Axboed71c1542012-03-16 20:16:59 +01001975 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001976 .category = FIO_OPT_C_IO,
1977 .group = FIO_OPT_G_VERIFY,
Jens Axboee8462bd2009-07-06 12:59:04 +02001978 },
1979#endif
Jens Axboe0d29de82010-09-01 13:54:15 +02001980#ifdef FIO_HAVE_TRIM
1981 {
1982 .name = "trim_percentage",
Jens Axboee8b0e952012-03-19 14:37:08 +01001983 .lname = "Trim percentage",
Jens Axboe0d29de82010-09-01 13:54:15 +02001984 .type = FIO_OPT_INT,
Jens Axboe203160d2012-03-29 21:17:12 +02001985 .off1 = td_var_offset(trim_percentage),
Jens Axboe20eb06b2012-03-16 19:57:23 +01001986 .minval = 0,
Jens Axboe0d29de82010-09-01 13:54:15 +02001987 .maxval = 100,
1988 .help = "Number of verify blocks to discard/trim",
1989 .parent = "verify",
1990 .def = "0",
Jens Axboe20eb06b2012-03-16 19:57:23 +01001991 .interval = 1,
Jens Axboed71c1542012-03-16 20:16:59 +01001992 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01001993 .category = FIO_OPT_C_IO,
1994 .group = FIO_OPT_G_TRIM,
Jens Axboe0d29de82010-09-01 13:54:15 +02001995 },
1996 {
1997 .name = "trim_verify_zero",
Jens Axboee8b0e952012-03-19 14:37:08 +01001998 .lname = "Verify trim zero",
Jens Axboe20eb06b2012-03-16 19:57:23 +01001999 .type = FIO_OPT_BOOL,
Jens Axboe0d29de82010-09-01 13:54:15 +02002000 .help = "Verify that trim/discarded blocks are returned as zeroes",
2001 .off1 = td_var_offset(trim_zero),
2002 .parent = "trim_percentage",
Jens Axboed71c1542012-03-16 20:16:59 +01002003 .hide = 1,
Jens Axboe0d29de82010-09-01 13:54:15 +02002004 .def = "1",
Jens Axboee8b0e952012-03-19 14:37:08 +01002005 .category = FIO_OPT_C_IO,
2006 .group = FIO_OPT_G_TRIM,
Jens Axboe0d29de82010-09-01 13:54:15 +02002007 },
2008 {
2009 .name = "trim_backlog",
Jens Axboee8b0e952012-03-19 14:37:08 +01002010 .lname = "Trim backlog",
Jens Axboe0d29de82010-09-01 13:54:15 +02002011 .type = FIO_OPT_STR_VAL,
2012 .off1 = td_var_offset(trim_backlog),
2013 .help = "Trim after this number of blocks are written",
2014 .parent = "trim_percentage",
Jens Axboed71c1542012-03-16 20:16:59 +01002015 .hide = 1,
Jens Axboe20eb06b2012-03-16 19:57:23 +01002016 .interval = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002017 .category = FIO_OPT_C_IO,
2018 .group = FIO_OPT_G_TRIM,
Jens Axboe0d29de82010-09-01 13:54:15 +02002019 },
2020 {
2021 .name = "trim_backlog_batch",
Jens Axboee8b0e952012-03-19 14:37:08 +01002022 .lname = "Trim backlog batch",
Jens Axboe0d29de82010-09-01 13:54:15 +02002023 .type = FIO_OPT_INT,
2024 .off1 = td_var_offset(trim_batch),
2025 .help = "Trim this number of IO blocks",
2026 .parent = "trim_percentage",
Jens Axboed71c1542012-03-16 20:16:59 +01002027 .hide = 1,
Jens Axboe20eb06b2012-03-16 19:57:23 +01002028 .interval = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002029 .category = FIO_OPT_C_IO,
2030 .group = FIO_OPT_G_TRIM,
Jens Axboe0d29de82010-09-01 13:54:15 +02002031 },
2032#endif
Jens Axboee8462bd2009-07-06 12:59:04 +02002033 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01002034 .name = "write_iolog",
Jens Axboee8b0e952012-03-19 14:37:08 +01002035 .lname = "Write I/O log",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002036 .type = FIO_OPT_STR_STORE,
2037 .off1 = td_var_offset(write_iolog_file),
2038 .help = "Store IO pattern to file",
Jens Axboee8b0e952012-03-19 14:37:08 +01002039 .category = FIO_OPT_C_IO,
2040 .group = FIO_OPT_G_IOLOG,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002041 },
2042 {
2043 .name = "read_iolog",
Jens Axboee8b0e952012-03-19 14:37:08 +01002044 .lname = "Read I/O log",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002045 .type = FIO_OPT_STR_STORE,
2046 .off1 = td_var_offset(read_iolog_file),
2047 .help = "Playback IO pattern from file",
Jens Axboee8b0e952012-03-19 14:37:08 +01002048 .category = FIO_OPT_C_IO,
2049 .group = FIO_OPT_G_IOLOG,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002050 },
2051 {
David Nellans64bbb862010-08-24 22:13:30 +02002052 .name = "replay_no_stall",
Jens Axboee8b0e952012-03-19 14:37:08 +01002053 .lname = "Don't stall on replay",
Jens Axboe20eb06b2012-03-16 19:57:23 +01002054 .type = FIO_OPT_BOOL,
David Nellans64bbb862010-08-24 22:13:30 +02002055 .off1 = td_var_offset(no_stall),
2056 .def = "0",
Jens Axboe87e7a972010-08-25 09:01:25 +02002057 .parent = "read_iolog",
Jens Axboed71c1542012-03-16 20:16:59 +01002058 .hide = 1,
David Nellans64bbb862010-08-24 22:13:30 +02002059 .help = "Playback IO pattern file as fast as possible without stalls",
Jens Axboee8b0e952012-03-19 14:37:08 +01002060 .category = FIO_OPT_C_IO,
2061 .group = FIO_OPT_G_IOLOG,
David Nellans64bbb862010-08-24 22:13:30 +02002062 },
2063 {
David Nellansd1c46c02010-08-31 21:20:47 +02002064 .name = "replay_redirect",
Jens Axboee8b0e952012-03-19 14:37:08 +01002065 .lname = "Redirect device for replay",
David Nellansd1c46c02010-08-31 21:20:47 +02002066 .type = FIO_OPT_STR_STORE,
2067 .off1 = td_var_offset(replay_redirect),
2068 .parent = "read_iolog",
Jens Axboed71c1542012-03-16 20:16:59 +01002069 .hide = 1,
David Nellansd1c46c02010-08-31 21:20:47 +02002070 .help = "Replay all I/O onto this device, regardless of trace device",
Jens Axboee8b0e952012-03-19 14:37:08 +01002071 .category = FIO_OPT_C_IO,
2072 .group = FIO_OPT_G_IOLOG,
David Nellansd1c46c02010-08-31 21:20:47 +02002073 },
2074 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01002075 .name = "exec_prerun",
Jens Axboee8b0e952012-03-19 14:37:08 +01002076 .lname = "Pre-execute runnable",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002077 .type = FIO_OPT_STR_STORE,
2078 .off1 = td_var_offset(exec_prerun),
2079 .help = "Execute this file prior to running job",
Jens Axboee8b0e952012-03-19 14:37:08 +01002080 .category = FIO_OPT_C_GENERAL,
2081 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002082 },
2083 {
2084 .name = "exec_postrun",
Jens Axboee8b0e952012-03-19 14:37:08 +01002085 .lname = "Post-execute runnable",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002086 .type = FIO_OPT_STR_STORE,
2087 .off1 = td_var_offset(exec_postrun),
2088 .help = "Execute this file after running job",
Jens Axboee8b0e952012-03-19 14:37:08 +01002089 .category = FIO_OPT_C_GENERAL,
2090 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002091 },
2092#ifdef FIO_HAVE_IOSCHED_SWITCH
2093 {
2094 .name = "ioscheduler",
Jens Axboee8b0e952012-03-19 14:37:08 +01002095 .lname = "I/O scheduler",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002096 .type = FIO_OPT_STR_STORE,
2097 .off1 = td_var_offset(ioscheduler),
2098 .help = "Use this IO scheduler on the backing device",
Jens Axboee8b0e952012-03-19 14:37:08 +01002099 .category = FIO_OPT_C_FILE,
2100 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002101 },
2102#endif
2103 {
2104 .name = "zonesize",
Jens Axboee8b0e952012-03-19 14:37:08 +01002105 .lname = "Zone size",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002106 .type = FIO_OPT_STR_VAL,
2107 .off1 = td_var_offset(zone_size),
Steven Noonaned335852012-01-31 13:58:00 +01002108 .help = "Amount of data to read per zone",
2109 .def = "0",
Jens Axboe20eb06b2012-03-16 19:57:23 +01002110 .interval = 1024 * 1024,
Jens Axboee8b0e952012-03-19 14:37:08 +01002111 .category = FIO_OPT_C_IO,
2112 .group = FIO_OPT_G_ZONE,
Steven Noonaned335852012-01-31 13:58:00 +01002113 },
2114 {
2115 .name = "zonerange",
Jens Axboee8b0e952012-03-19 14:37:08 +01002116 .lname = "Zone range",
Steven Noonaned335852012-01-31 13:58:00 +01002117 .type = FIO_OPT_STR_VAL,
2118 .off1 = td_var_offset(zone_range),
Jens Axboe214e1ec2007-03-15 10:48:13 +01002119 .help = "Give size of an IO zone",
2120 .def = "0",
Jens Axboe20eb06b2012-03-16 19:57:23 +01002121 .interval = 1024 * 1024,
Jens Axboee8b0e952012-03-19 14:37:08 +01002122 .category = FIO_OPT_C_IO,
2123 .group = FIO_OPT_G_ZONE,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002124 },
2125 {
2126 .name = "zoneskip",
Jens Axboee8b0e952012-03-19 14:37:08 +01002127 .lname = "Zone skip",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002128 .type = FIO_OPT_STR_VAL,
2129 .off1 = td_var_offset(zone_skip),
2130 .help = "Space between IO zones",
2131 .def = "0",
Jens Axboe20eb06b2012-03-16 19:57:23 +01002132 .interval = 1024 * 1024,
Jens Axboee8b0e952012-03-19 14:37:08 +01002133 .category = FIO_OPT_C_IO,
2134 .group = FIO_OPT_G_ZONE,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002135 },
2136 {
2137 .name = "lockmem",
Jens Axboee8b0e952012-03-19 14:37:08 +01002138 .lname = "Lock memory",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002139 .type = FIO_OPT_STR_VAL,
Jens Axboe1b79a072012-03-28 20:50:15 +02002140 .off1 = td_var_offset(lockmem),
Jens Axboe214e1ec2007-03-15 10:48:13 +01002141 .help = "Lock down this amount of memory",
2142 .def = "0",
Jens Axboe20eb06b2012-03-16 19:57:23 +01002143 .interval = 1024 * 1024,
Jens Axboee8b0e952012-03-19 14:37:08 +01002144 .category = FIO_OPT_C_GENERAL,
2145 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002146 },
2147 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01002148 .name = "rwmixread",
Jens Axboee8b0e952012-03-19 14:37:08 +01002149 .lname = "Read/write mix read",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002150 .type = FIO_OPT_INT,
Jens Axboecb499fc2008-05-28 10:33:32 +02002151 .cb = str_rwmix_read_cb,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002152 .maxval = 100,
2153 .help = "Percentage of mixed workload that is reads",
2154 .def = "50",
Jens Axboe20eb06b2012-03-16 19:57:23 +01002155 .interval = 5,
Jens Axboe90265352012-03-19 20:29:44 +01002156 .inverse = "rwmixwrite",
Jens Axboee8b0e952012-03-19 14:37:08 +01002157 .category = FIO_OPT_C_IO,
2158 .group = FIO_OPT_G_RWMIX,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002159 },
2160 {
2161 .name = "rwmixwrite",
Jens Axboee8b0e952012-03-19 14:37:08 +01002162 .lname = "Read/write mix write",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002163 .type = FIO_OPT_INT,
Jens Axboecb499fc2008-05-28 10:33:32 +02002164 .cb = str_rwmix_write_cb,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002165 .maxval = 100,
2166 .help = "Percentage of mixed workload that is writes",
2167 .def = "50",
Jens Axboe20eb06b2012-03-16 19:57:23 +01002168 .interval = 5,
Jens Axboe90265352012-03-19 20:29:44 +01002169 .inverse = "rwmixread",
Jens Axboee8b0e952012-03-19 14:37:08 +01002170 .category = FIO_OPT_C_IO,
2171 .group = FIO_OPT_G_RWMIX,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002172 },
2173 {
Jens Axboeafdf9352007-07-31 16:14:34 +02002174 .name = "rwmixcycle",
Jens Axboee8b0e952012-03-19 14:37:08 +01002175 .lname = "Read/write mix cycle",
Jens Axboe15ca1502008-04-07 09:26:02 +02002176 .type = FIO_OPT_DEPRECATED,
Jens Axboee8b0e952012-03-19 14:37:08 +01002177 .category = FIO_OPT_C_IO,
2178 .group = FIO_OPT_G_RWMIX,
Jens Axboeafdf9352007-07-31 16:14:34 +02002179 },
2180 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01002181 .name = "nice",
Jens Axboee8b0e952012-03-19 14:37:08 +01002182 .lname = "Nice",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002183 .type = FIO_OPT_INT,
2184 .off1 = td_var_offset(nice),
2185 .help = "Set job CPU nice value",
2186 .minval = -19,
2187 .maxval = 20,
2188 .def = "0",
Jens Axboe20eb06b2012-03-16 19:57:23 +01002189 .interval = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002190 .category = FIO_OPT_C_GENERAL,
Jens Axboe10860052012-03-19 20:56:53 +01002191 .group = FIO_OPT_G_CRED,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002192 },
2193#ifdef FIO_HAVE_IOPRIO
2194 {
2195 .name = "prio",
Jens Axboee8b0e952012-03-19 14:37:08 +01002196 .lname = "I/O nice priority",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002197 .type = FIO_OPT_INT,
Jens Axboe28727df2012-03-29 08:33:15 +02002198 .off1 = td_var_offset(ioprio),
Jens Axboe214e1ec2007-03-15 10:48:13 +01002199 .help = "Set job IO priority value",
2200 .minval = 0,
2201 .maxval = 7,
Jens Axboe20eb06b2012-03-16 19:57:23 +01002202 .interval = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002203 .category = FIO_OPT_C_GENERAL,
Jens Axboe10860052012-03-19 20:56:53 +01002204 .group = FIO_OPT_G_CRED,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002205 },
2206 {
2207 .name = "prioclass",
Jens Axboee8b0e952012-03-19 14:37:08 +01002208 .lname = "I/O nice priority class",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002209 .type = FIO_OPT_INT,
Jens Axboe28727df2012-03-29 08:33:15 +02002210 .off1 = td_var_offset(ioprio_class),
Jens Axboe214e1ec2007-03-15 10:48:13 +01002211 .help = "Set job IO priority class",
2212 .minval = 0,
2213 .maxval = 3,
Jens Axboe20eb06b2012-03-16 19:57:23 +01002214 .interval = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002215 .category = FIO_OPT_C_GENERAL,
Jens Axboe10860052012-03-19 20:56:53 +01002216 .group = FIO_OPT_G_CRED,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002217 },
2218#endif
2219 {
2220 .name = "thinktime",
Jens Axboee8b0e952012-03-19 14:37:08 +01002221 .lname = "Thinktime",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002222 .type = FIO_OPT_INT,
2223 .off1 = td_var_offset(thinktime),
2224 .help = "Idle time between IO buffers (usec)",
2225 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002226 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01002227 .group = FIO_OPT_G_THINKTIME,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002228 },
2229 {
2230 .name = "thinktime_spin",
Jens Axboee8b0e952012-03-19 14:37:08 +01002231 .lname = "Thinktime spin",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002232 .type = FIO_OPT_INT,
2233 .off1 = td_var_offset(thinktime_spin),
2234 .help = "Start think time by spinning this amount (usec)",
2235 .def = "0",
Jens Axboeafdf9352007-07-31 16:14:34 +02002236 .parent = "thinktime",
Jens Axboed71c1542012-03-16 20:16:59 +01002237 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002238 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01002239 .group = FIO_OPT_G_THINKTIME,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002240 },
2241 {
2242 .name = "thinktime_blocks",
Jens Axboee8b0e952012-03-19 14:37:08 +01002243 .lname = "Thinktime blocks",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002244 .type = FIO_OPT_INT,
2245 .off1 = td_var_offset(thinktime_blocks),
2246 .help = "IO buffer period between 'thinktime'",
2247 .def = "1",
Jens Axboeafdf9352007-07-31 16:14:34 +02002248 .parent = "thinktime",
Jens Axboed71c1542012-03-16 20:16:59 +01002249 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002250 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01002251 .group = FIO_OPT_G_THINKTIME,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002252 },
2253 {
2254 .name = "rate",
Jens Axboee8b0e952012-03-19 14:37:08 +01002255 .lname = "I/O rate",
Jens Axboee01b22b2009-06-09 15:43:25 +02002256 .type = FIO_OPT_INT,
Shaohua Li6eaf09d2012-09-14 08:49:43 +02002257 .off1 = td_var_offset(rate[DDIR_READ]),
2258 .off2 = td_var_offset(rate[DDIR_WRITE]),
2259 .off3 = td_var_offset(rate[DDIR_TRIM]),
Jens Axboe214e1ec2007-03-15 10:48:13 +01002260 .help = "Set bandwidth rate",
Jens Axboee8b0e952012-03-19 14:37:08 +01002261 .category = FIO_OPT_C_IO,
2262 .group = FIO_OPT_G_RATE,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002263 },
2264 {
2265 .name = "ratemin",
Jens Axboee8b0e952012-03-19 14:37:08 +01002266 .lname = "I/O min rate",
Jens Axboee01b22b2009-06-09 15:43:25 +02002267 .type = FIO_OPT_INT,
Shaohua Li6eaf09d2012-09-14 08:49:43 +02002268 .off1 = td_var_offset(ratemin[DDIR_READ]),
2269 .off2 = td_var_offset(ratemin[DDIR_WRITE]),
2270 .off3 = td_var_offset(ratemin[DDIR_TRIM]),
Jens Axboe4e991c22007-03-15 11:41:11 +01002271 .help = "Job must meet this rate or it will be shutdown",
Jens Axboeafdf9352007-07-31 16:14:34 +02002272 .parent = "rate",
Jens Axboed71c1542012-03-16 20:16:59 +01002273 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002274 .category = FIO_OPT_C_IO,
2275 .group = FIO_OPT_G_RATE,
Jens Axboe4e991c22007-03-15 11:41:11 +01002276 },
2277 {
2278 .name = "rate_iops",
Jens Axboee8b0e952012-03-19 14:37:08 +01002279 .lname = "I/O rate IOPS",
Jens Axboee01b22b2009-06-09 15:43:25 +02002280 .type = FIO_OPT_INT,
Shaohua Li6eaf09d2012-09-14 08:49:43 +02002281 .off1 = td_var_offset(rate_iops[DDIR_READ]),
2282 .off2 = td_var_offset(rate_iops[DDIR_WRITE]),
2283 .off3 = td_var_offset(rate_iops[DDIR_TRIM]),
Jens Axboe4e991c22007-03-15 11:41:11 +01002284 .help = "Limit IO used to this number of IO operations/sec",
Jens Axboed71c1542012-03-16 20:16:59 +01002285 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002286 .category = FIO_OPT_C_IO,
2287 .group = FIO_OPT_G_RATE,
Jens Axboe4e991c22007-03-15 11:41:11 +01002288 },
2289 {
2290 .name = "rate_iops_min",
Jens Axboee8b0e952012-03-19 14:37:08 +01002291 .lname = "I/O min rate IOPS",
Jens Axboee01b22b2009-06-09 15:43:25 +02002292 .type = FIO_OPT_INT,
Shaohua Li6eaf09d2012-09-14 08:49:43 +02002293 .off1 = td_var_offset(rate_iops_min[DDIR_READ]),
2294 .off2 = td_var_offset(rate_iops_min[DDIR_WRITE]),
2295 .off3 = td_var_offset(rate_iops_min[DDIR_TRIM]),
Bruce Cran03e20d62011-01-02 20:14:54 +01002296 .help = "Job must meet this rate or it will be shut down",
Jens Axboeafdf9352007-07-31 16:14:34 +02002297 .parent = "rate_iops",
Jens Axboed71c1542012-03-16 20:16:59 +01002298 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002299 .category = FIO_OPT_C_IO,
2300 .group = FIO_OPT_G_RATE,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002301 },
2302 {
2303 .name = "ratecycle",
Jens Axboee8b0e952012-03-19 14:37:08 +01002304 .lname = "I/O rate cycle",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002305 .type = FIO_OPT_INT,
2306 .off1 = td_var_offset(ratecycle),
2307 .help = "Window average for rate limits (msec)",
2308 .def = "1000",
Jens Axboeafdf9352007-07-31 16:14:34 +02002309 .parent = "rate",
Jens Axboed71c1542012-03-16 20:16:59 +01002310 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002311 .category = FIO_OPT_C_IO,
2312 .group = FIO_OPT_G_RATE,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002313 },
2314 {
2315 .name = "invalidate",
Jens Axboee8b0e952012-03-19 14:37:08 +01002316 .lname = "Cache invalidate",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002317 .type = FIO_OPT_BOOL,
2318 .off1 = td_var_offset(invalidate_cache),
2319 .help = "Invalidate buffer/page cache prior to running job",
2320 .def = "1",
Jens Axboee8b0e952012-03-19 14:37:08 +01002321 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01002322 .group = FIO_OPT_G_IO_TYPE,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002323 },
2324 {
2325 .name = "sync",
Jens Axboee8b0e952012-03-19 14:37:08 +01002326 .lname = "Synchronous I/O",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002327 .type = FIO_OPT_BOOL,
2328 .off1 = td_var_offset(sync_io),
2329 .help = "Use O_SYNC for buffered writes",
2330 .def = "0",
Jens Axboe67a10002007-07-31 23:12:16 +02002331 .parent = "buffered",
Jens Axboed71c1542012-03-16 20:16:59 +01002332 .hide = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002333 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01002334 .group = FIO_OPT_G_IO_TYPE,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002335 },
2336 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01002337 .name = "create_serialize",
Jens Axboee8b0e952012-03-19 14:37:08 +01002338 .lname = "Create serialize",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002339 .type = FIO_OPT_BOOL,
2340 .off1 = td_var_offset(create_serialize),
2341 .help = "Serialize creating of job files",
2342 .def = "1",
Jens Axboee8b0e952012-03-19 14:37:08 +01002343 .category = FIO_OPT_C_FILE,
2344 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002345 },
2346 {
2347 .name = "create_fsync",
Jens Axboee8b0e952012-03-19 14:37:08 +01002348 .lname = "Create fsync",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002349 .type = FIO_OPT_BOOL,
2350 .off1 = td_var_offset(create_fsync),
Bruce Cran03e20d62011-01-02 20:14:54 +01002351 .help = "fsync file after creation",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002352 .def = "1",
Jens Axboee8b0e952012-03-19 14:37:08 +01002353 .category = FIO_OPT_C_FILE,
2354 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002355 },
2356 {
Jens Axboe814452b2009-03-04 12:53:13 +01002357 .name = "create_on_open",
Jens Axboee8b0e952012-03-19 14:37:08 +01002358 .lname = "Create on open",
Jens Axboe814452b2009-03-04 12:53:13 +01002359 .type = FIO_OPT_BOOL,
2360 .off1 = td_var_offset(create_on_open),
2361 .help = "Create files when they are opened for IO",
2362 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002363 .category = FIO_OPT_C_FILE,
2364 .group = FIO_OPT_G_INVALID,
Jens Axboe814452b2009-03-04 12:53:13 +01002365 },
Jens Axboe0b9d69e2009-09-11 22:29:54 +02002366 {
Jens Axboe25460cf2012-05-02 13:58:02 +02002367 .name = "create_only",
2368 .type = FIO_OPT_BOOL,
2369 .off1 = td_var_offset(create_only),
2370 .help = "Only perform file creation phase",
Jens Axboed17fda72012-05-07 09:56:00 +02002371 .category = FIO_OPT_C_FILE,
Jens Axboe25460cf2012-05-02 13:58:02 +02002372 .def = "0",
2373 },
2374 {
Zhang, Yanminafad68f2009-05-20 11:30:55 +02002375 .name = "pre_read",
Jens Axboee8b0e952012-03-19 14:37:08 +01002376 .lname = "Pre-read files",
Zhang, Yanminafad68f2009-05-20 11:30:55 +02002377 .type = FIO_OPT_BOOL,
2378 .off1 = td_var_offset(pre_read),
Bruce Cran03e20d62011-01-02 20:14:54 +01002379 .help = "Pre-read files before starting official testing",
Zhang, Yanminafad68f2009-05-20 11:30:55 +02002380 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002381 .category = FIO_OPT_C_FILE,
2382 .group = FIO_OPT_G_INVALID,
Zhang, Yanminafad68f2009-05-20 11:30:55 +02002383 },
Jens Axboe214e1ec2007-03-15 10:48:13 +01002384#ifdef FIO_HAVE_CPU_AFFINITY
2385 {
2386 .name = "cpumask",
Jens Axboee8b0e952012-03-19 14:37:08 +01002387 .lname = "CPU mask",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002388 .type = FIO_OPT_INT,
2389 .cb = str_cpumask_cb,
2390 .help = "CPU affinity mask",
Jens Axboee8b0e952012-03-19 14:37:08 +01002391 .category = FIO_OPT_C_GENERAL,
Jens Axboe10860052012-03-19 20:56:53 +01002392 .group = FIO_OPT_G_CRED,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002393 },
Jens Axboed2e268b2007-06-15 10:33:49 +02002394 {
2395 .name = "cpus_allowed",
Jens Axboee8b0e952012-03-19 14:37:08 +01002396 .lname = "CPUs allowed",
Jens Axboed2e268b2007-06-15 10:33:49 +02002397 .type = FIO_OPT_STR,
2398 .cb = str_cpus_allowed_cb,
2399 .help = "Set CPUs allowed",
Jens Axboee8b0e952012-03-19 14:37:08 +01002400 .category = FIO_OPT_C_GENERAL,
Jens Axboe10860052012-03-19 20:56:53 +01002401 .group = FIO_OPT_G_CRED,
Jens Axboed2e268b2007-06-15 10:33:49 +02002402 },
Jens Axboe214e1ec2007-03-15 10:48:13 +01002403#endif
2404 {
2405 .name = "end_fsync",
Jens Axboee8b0e952012-03-19 14:37:08 +01002406 .lname = "End fsync",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002407 .type = FIO_OPT_BOOL,
2408 .off1 = td_var_offset(end_fsync),
2409 .help = "Include fsync at the end of job",
2410 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002411 .category = FIO_OPT_C_FILE,
2412 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002413 },
2414 {
2415 .name = "fsync_on_close",
Jens Axboee8b0e952012-03-19 14:37:08 +01002416 .lname = "Fsync on close",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002417 .type = FIO_OPT_BOOL,
2418 .off1 = td_var_offset(fsync_on_close),
2419 .help = "fsync files on close",
2420 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002421 .category = FIO_OPT_C_FILE,
2422 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002423 },
2424 {
2425 .name = "unlink",
Jens Axboee8b0e952012-03-19 14:37:08 +01002426 .lname = "Unlink file",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002427 .type = FIO_OPT_BOOL,
2428 .off1 = td_var_offset(unlink),
2429 .help = "Unlink created files after job has completed",
2430 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002431 .category = FIO_OPT_C_FILE,
2432 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002433 },
2434 {
2435 .name = "exitall",
Jens Axboee8b0e952012-03-19 14:37:08 +01002436 .lname = "Exit-all on terminate",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002437 .type = FIO_OPT_STR_SET,
2438 .cb = str_exitall_cb,
2439 .help = "Terminate all jobs when one exits",
Jens Axboee8b0e952012-03-19 14:37:08 +01002440 .category = FIO_OPT_C_GENERAL,
Jens Axboea1f6afe2012-03-19 20:44:33 +01002441 .group = FIO_OPT_G_PROCESS,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002442 },
2443 {
2444 .name = "stonewall",
Jens Axboee8b0e952012-03-19 14:37:08 +01002445 .lname = "Wait for previous",
Jens Axboed3923652011-08-03 12:38:39 +02002446 .alias = "wait_for_previous",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002447 .type = FIO_OPT_STR_SET,
2448 .off1 = td_var_offset(stonewall),
2449 .help = "Insert a hard barrier between this job and previous",
Jens Axboee8b0e952012-03-19 14:37:08 +01002450 .category = FIO_OPT_C_GENERAL,
Jens Axboea1f6afe2012-03-19 20:44:33 +01002451 .group = FIO_OPT_G_PROCESS,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002452 },
2453 {
Jens Axboeb3d62a72007-03-20 14:23:26 +01002454 .name = "new_group",
Jens Axboee8b0e952012-03-19 14:37:08 +01002455 .lname = "New group",
Jens Axboeb3d62a72007-03-20 14:23:26 +01002456 .type = FIO_OPT_STR_SET,
2457 .off1 = td_var_offset(new_group),
2458 .help = "Mark the start of a new group (for reporting)",
Jens Axboee8b0e952012-03-19 14:37:08 +01002459 .category = FIO_OPT_C_GENERAL,
Jens Axboea1f6afe2012-03-19 20:44:33 +01002460 .group = FIO_OPT_G_PROCESS,
Jens Axboeb3d62a72007-03-20 14:23:26 +01002461 },
2462 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01002463 .name = "thread",
Jens Axboee8b0e952012-03-19 14:37:08 +01002464 .lname = "Thread",
Jens Axboe214e1ec2007-03-15 10:48:13 +01002465 .type = FIO_OPT_STR_SET,
2466 .off1 = td_var_offset(use_thread),
Jens Axboe20eb06b2012-03-16 19:57:23 +01002467 .help = "Use threads instead of processes",
Jens Axboee8b0e952012-03-19 14:37:08 +01002468 .category = FIO_OPT_C_GENERAL,
Jens Axboea1f6afe2012-03-19 20:44:33 +01002469 .group = FIO_OPT_G_PROCESS,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002470 },
2471 {
2472 .name = "write_bw_log",
Jens Axboee8b0e952012-03-19 14:37:08 +01002473 .lname = "Write bandwidth log",
Jens Axboe203160d2012-03-29 21:17:12 +02002474 .type = FIO_OPT_STR_STORE,
2475 .off1 = td_var_offset(bw_log_file),
Jens Axboe214e1ec2007-03-15 10:48:13 +01002476 .help = "Write log of bandwidth during run",
Jens Axboee8b0e952012-03-19 14:37:08 +01002477 .category = FIO_OPT_C_LOG,
2478 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002479 },
2480 {
2481 .name = "write_lat_log",
Jens Axboee8b0e952012-03-19 14:37:08 +01002482 .lname = "Write latency log",
Jens Axboe203160d2012-03-29 21:17:12 +02002483 .type = FIO_OPT_STR_STORE,
2484 .off1 = td_var_offset(lat_log_file),
Jens Axboe214e1ec2007-03-15 10:48:13 +01002485 .help = "Write log of latency during run",
Jens Axboee8b0e952012-03-19 14:37:08 +01002486 .category = FIO_OPT_C_LOG,
2487 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002488 },
2489 {
Jens Axboec8eeb9d2011-10-05 14:02:22 +02002490 .name = "write_iops_log",
Jens Axboee8b0e952012-03-19 14:37:08 +01002491 .lname = "Write IOPS log",
Jens Axboec8eeb9d2011-10-05 14:02:22 +02002492 .type = FIO_OPT_STR,
Jens Axboe203160d2012-03-29 21:17:12 +02002493 .off1 = td_var_offset(iops_log_file),
Jens Axboec8eeb9d2011-10-05 14:02:22 +02002494 .help = "Write log of IOPS during run",
Jens Axboee8b0e952012-03-19 14:37:08 +01002495 .category = FIO_OPT_C_LOG,
2496 .group = FIO_OPT_G_INVALID,
Jens Axboec8eeb9d2011-10-05 14:02:22 +02002497 },
2498 {
Jens Axboeb8bc8cb2011-12-01 09:04:31 +01002499 .name = "log_avg_msec",
Jens Axboee8b0e952012-03-19 14:37:08 +01002500 .lname = "Log averaging (msec)",
Jens Axboeb8bc8cb2011-12-01 09:04:31 +01002501 .type = FIO_OPT_INT,
2502 .off1 = td_var_offset(log_avg_msec),
2503 .help = "Average bw/iops/lat logs over this period of time",
2504 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002505 .category = FIO_OPT_C_LOG,
2506 .group = FIO_OPT_G_INVALID,
Jens Axboeb8bc8cb2011-12-01 09:04:31 +01002507 },
2508 {
Jens Axboec504ee52012-03-20 11:29:09 +01002509 .name = "bwavgtime",
2510 .lname = "Bandwidth average time",
2511 .type = FIO_OPT_INT,
2512 .off1 = td_var_offset(bw_avg_time),
2513 .help = "Time window over which to calculate bandwidth"
2514 " (msec)",
2515 .def = "500",
2516 .parent = "write_bw_log",
2517 .hide = 1,
2518 .interval = 100,
2519 .category = FIO_OPT_C_LOG,
2520 .group = FIO_OPT_G_INVALID,
2521 },
2522 {
2523 .name = "iopsavgtime",
2524 .lname = "IOPS average time",
2525 .type = FIO_OPT_INT,
2526 .off1 = td_var_offset(iops_avg_time),
2527 .help = "Time window over which to calculate IOPS (msec)",
2528 .def = "500",
2529 .parent = "write_iops_log",
2530 .hide = 1,
2531 .interval = 100,
2532 .category = FIO_OPT_C_LOG,
2533 .group = FIO_OPT_G_INVALID,
2534 },
2535 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01002536 .name = "group_reporting",
Jens Axboee8b0e952012-03-19 14:37:08 +01002537 .lname = "Group reporting",
2538 .type = FIO_OPT_BOOL,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002539 .off1 = td_var_offset(group_reporting),
2540 .help = "Do reporting on a per-group basis",
Jens Axboee8b0e952012-03-19 14:37:08 +01002541 .def = "1",
Jens Axboe10860052012-03-19 20:56:53 +01002542 .category = FIO_OPT_C_STAT,
Jens Axboee8b0e952012-03-19 14:37:08 +01002543 .group = FIO_OPT_G_INVALID,
Jens Axboe214e1ec2007-03-15 10:48:13 +01002544 },
2545 {
Jens Axboee9459e52007-04-17 15:46:32 +02002546 .name = "zero_buffers",
Jens Axboee8b0e952012-03-19 14:37:08 +01002547 .lname = "Zero I/O buffers",
Jens Axboee9459e52007-04-17 15:46:32 +02002548 .type = FIO_OPT_STR_SET,
2549 .off1 = td_var_offset(zero_buffers),
2550 .help = "Init IO buffers to all zeroes",
Jens Axboee8b0e952012-03-19 14:37:08 +01002551 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01002552 .group = FIO_OPT_G_IO_BUF,
Jens Axboee9459e52007-04-17 15:46:32 +02002553 },
Jens Axboe5973caf2008-05-21 19:52:35 +02002554 {
2555 .name = "refill_buffers",
Jens Axboee8b0e952012-03-19 14:37:08 +01002556 .lname = "Refill I/O buffers",
Jens Axboe5973caf2008-05-21 19:52:35 +02002557 .type = FIO_OPT_STR_SET,
2558 .off1 = td_var_offset(refill_buffers),
2559 .help = "Refill IO buffers on every IO submit",
Jens Axboee8b0e952012-03-19 14:37:08 +01002560 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01002561 .group = FIO_OPT_G_IO_BUF,
Jens Axboe5973caf2008-05-21 19:52:35 +02002562 },
Yu-ju Hong83349192011-08-13 00:53:44 +02002563 {
Jens Axboefd684182011-09-19 09:24:44 +02002564 .name = "scramble_buffers",
Jens Axboee8b0e952012-03-19 14:37:08 +01002565 .lname = "Scramble I/O buffers",
Jens Axboefd684182011-09-19 09:24:44 +02002566 .type = FIO_OPT_BOOL,
2567 .off1 = td_var_offset(scramble_buffers),
2568 .help = "Slightly scramble buffers on every IO submit",
2569 .def = "1",
Jens Axboee8b0e952012-03-19 14:37:08 +01002570 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01002571 .group = FIO_OPT_G_IO_BUF,
Jens Axboefd684182011-09-19 09:24:44 +02002572 },
2573 {
Jens Axboe9c426842012-03-02 21:02:12 +01002574 .name = "buffer_compress_percentage",
Jens Axboee8b0e952012-03-19 14:37:08 +01002575 .lname = "Buffer compression percentage",
Jens Axboe9c426842012-03-02 21:02:12 +01002576 .type = FIO_OPT_INT,
2577 .off1 = td_var_offset(compress_percentage),
2578 .maxval = 100,
2579 .minval = 1,
2580 .help = "How compressible the buffer is (approximately)",
Jens Axboe20eb06b2012-03-16 19:57:23 +01002581 .interval = 5,
Jens Axboee8b0e952012-03-19 14:37:08 +01002582 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01002583 .group = FIO_OPT_G_IO_BUF,
Jens Axboe9c426842012-03-02 21:02:12 +01002584 },
2585 {
Jens Axboef97a43a2012-03-09 19:06:24 +01002586 .name = "buffer_compress_chunk",
Jens Axboee8b0e952012-03-19 14:37:08 +01002587 .lname = "Buffer compression chunk size",
Jens Axboef97a43a2012-03-09 19:06:24 +01002588 .type = FIO_OPT_INT,
2589 .off1 = td_var_offset(compress_chunk),
Jens Axboe207b18e2012-03-09 19:11:25 +01002590 .parent = "buffer_compress_percentage",
Jens Axboed71c1542012-03-16 20:16:59 +01002591 .hide = 1,
Jens Axboef97a43a2012-03-09 19:06:24 +01002592 .help = "Size of compressible region in buffer",
Jens Axboe20eb06b2012-03-16 19:57:23 +01002593 .interval = 256,
Jens Axboee8b0e952012-03-19 14:37:08 +01002594 .category = FIO_OPT_C_IO,
Jens Axboe3ceb4582012-03-19 21:27:02 +01002595 .group = FIO_OPT_G_IO_BUF,
Jens Axboef97a43a2012-03-09 19:06:24 +01002596 },
2597 {
Yu-ju Hong83349192011-08-13 00:53:44 +02002598 .name = "clat_percentiles",
Jens Axboee8b0e952012-03-19 14:37:08 +01002599 .lname = "Completion latency percentiles",
Yu-ju Hong83349192011-08-13 00:53:44 +02002600 .type = FIO_OPT_BOOL,
2601 .off1 = td_var_offset(clat_percentiles),
2602 .help = "Enable the reporting of completion latency percentiles",
Jens Axboe467b35e2011-10-13 08:53:24 +02002603 .def = "1",
Jens Axboee8b0e952012-03-19 14:37:08 +01002604 .category = FIO_OPT_C_STAT,
2605 .group = FIO_OPT_G_INVALID,
Yu-ju Hong83349192011-08-13 00:53:44 +02002606 },
2607 {
2608 .name = "percentile_list",
Jens Axboee8b0e952012-03-19 14:37:08 +01002609 .lname = "Completion latency percentile list",
Yu-ju Hong83349192011-08-13 00:53:44 +02002610 .type = FIO_OPT_FLOAT_LIST,
2611 .off1 = td_var_offset(percentile_list),
2612 .off2 = td_var_offset(overwrite_plist),
2613 .help = "Specify a custom list of percentiles to report",
2614 .maxlen = FIO_IO_U_LIST_MAX_LEN,
2615 .minfp = 0.0,
2616 .maxfp = 100.0,
Jens Axboee8b0e952012-03-19 14:37:08 +01002617 .category = FIO_OPT_C_STAT,
2618 .group = FIO_OPT_G_INVALID,
Yu-ju Hong83349192011-08-13 00:53:44 +02002619 },
2620
Jens Axboe0a839f32007-04-26 09:02:34 +02002621#ifdef FIO_HAVE_DISK_UTIL
2622 {
2623 .name = "disk_util",
Jens Axboee8b0e952012-03-19 14:37:08 +01002624 .lname = "Disk utilization",
Jens Axboe0a839f32007-04-26 09:02:34 +02002625 .type = FIO_OPT_BOOL,
2626 .off1 = td_var_offset(do_disk_util),
Jens Axboef66ab3c2008-06-05 11:48:22 +02002627 .help = "Log disk utilization statistics",
Jens Axboe0a839f32007-04-26 09:02:34 +02002628 .def = "1",
Jens Axboee8b0e952012-03-19 14:37:08 +01002629 .category = FIO_OPT_C_STAT,
2630 .group = FIO_OPT_G_INVALID,
Jens Axboe0a839f32007-04-26 09:02:34 +02002631 },
2632#endif
Jens Axboee9459e52007-04-17 15:46:32 +02002633 {
Jens Axboe993bf482008-11-14 13:04:53 +01002634 .name = "gtod_reduce",
Jens Axboee8b0e952012-03-19 14:37:08 +01002635 .lname = "Reduce gettimeofday() calls",
Jens Axboe993bf482008-11-14 13:04:53 +01002636 .type = FIO_OPT_BOOL,
2637 .help = "Greatly reduce number of gettimeofday() calls",
2638 .cb = str_gtod_reduce_cb,
2639 .def = "0",
Jens Axboea4ed77f2012-03-20 10:19:44 +01002640 .hide_on_set = 1,
Jens Axboee8b0e952012-03-19 14:37:08 +01002641 .category = FIO_OPT_C_STAT,
2642 .group = FIO_OPT_G_INVALID,
Jens Axboe993bf482008-11-14 13:04:53 +01002643 },
2644 {
Jens Axboe02af0982010-06-24 09:59:34 +02002645 .name = "disable_lat",
Jens Axboee8b0e952012-03-19 14:37:08 +01002646 .lname = "Disable all latency stats",
Jens Axboe02af0982010-06-24 09:59:34 +02002647 .type = FIO_OPT_BOOL,
2648 .off1 = td_var_offset(disable_lat),
2649 .help = "Disable latency numbers",
2650 .parent = "gtod_reduce",
Jens Axboed71c1542012-03-16 20:16:59 +01002651 .hide = 1,
Jens Axboe02af0982010-06-24 09:59:34 +02002652 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002653 .category = FIO_OPT_C_STAT,
2654 .group = FIO_OPT_G_INVALID,
Jens Axboe02af0982010-06-24 09:59:34 +02002655 },
2656 {
Jens Axboe9520ebb2008-10-16 21:03:27 +02002657 .name = "disable_clat",
Jens Axboee8b0e952012-03-19 14:37:08 +01002658 .lname = "Disable completion latency stats",
Jens Axboe9520ebb2008-10-16 21:03:27 +02002659 .type = FIO_OPT_BOOL,
2660 .off1 = td_var_offset(disable_clat),
2661 .help = "Disable completion latency numbers",
Jens Axboe993bf482008-11-14 13:04:53 +01002662 .parent = "gtod_reduce",
Jens Axboed71c1542012-03-16 20:16:59 +01002663 .hide = 1,
Jens Axboe9520ebb2008-10-16 21:03:27 +02002664 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002665 .category = FIO_OPT_C_STAT,
2666 .group = FIO_OPT_G_INVALID,
Jens Axboe9520ebb2008-10-16 21:03:27 +02002667 },
2668 {
2669 .name = "disable_slat",
Jens Axboee8b0e952012-03-19 14:37:08 +01002670 .lname = "Disable submission latency stats",
Jens Axboe9520ebb2008-10-16 21:03:27 +02002671 .type = FIO_OPT_BOOL,
2672 .off1 = td_var_offset(disable_slat),
Bruce Cran03e20d62011-01-02 20:14:54 +01002673 .help = "Disable submission latency numbers",
Jens Axboe993bf482008-11-14 13:04:53 +01002674 .parent = "gtod_reduce",
Jens Axboed71c1542012-03-16 20:16:59 +01002675 .hide = 1,
Jens Axboe9520ebb2008-10-16 21:03:27 +02002676 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002677 .category = FIO_OPT_C_STAT,
2678 .group = FIO_OPT_G_INVALID,
Jens Axboe9520ebb2008-10-16 21:03:27 +02002679 },
2680 {
2681 .name = "disable_bw_measurement",
Jens Axboee8b0e952012-03-19 14:37:08 +01002682 .lname = "Disable bandwidth stats",
Jens Axboe9520ebb2008-10-16 21:03:27 +02002683 .type = FIO_OPT_BOOL,
2684 .off1 = td_var_offset(disable_bw),
2685 .help = "Disable bandwidth logging",
Jens Axboe993bf482008-11-14 13:04:53 +01002686 .parent = "gtod_reduce",
Jens Axboed71c1542012-03-16 20:16:59 +01002687 .hide = 1,
Jens Axboe9520ebb2008-10-16 21:03:27 +02002688 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002689 .category = FIO_OPT_C_STAT,
2690 .group = FIO_OPT_G_INVALID,
Jens Axboe9520ebb2008-10-16 21:03:27 +02002691 },
2692 {
Jens Axboebe4ecfd2008-12-08 14:10:52 +01002693 .name = "gtod_cpu",
Jens Axboee8b0e952012-03-19 14:37:08 +01002694 .lname = "Dedicated gettimeofday() CPU",
Jens Axboebe4ecfd2008-12-08 14:10:52 +01002695 .type = FIO_OPT_INT,
2696 .cb = str_gtod_cpu_cb,
Bruce Cran03e20d62011-01-02 20:14:54 +01002697 .help = "Set up dedicated gettimeofday() thread on this CPU",
Jens Axboe29d43ff2009-07-01 10:42:18 +02002698 .verify = gtod_cpu_verify,
Jens Axboee8b0e952012-03-19 14:37:08 +01002699 .category = FIO_OPT_C_GENERAL,
Jens Axboe10860052012-03-19 20:56:53 +01002700 .group = FIO_OPT_G_CLOCK,
Jens Axboebe4ecfd2008-12-08 14:10:52 +01002701 },
2702 {
Radha Ramachandranf2bba182009-06-15 08:40:16 +02002703 .name = "continue_on_error",
Jens Axboee8b0e952012-03-19 14:37:08 +01002704 .lname = "Continue on error",
Steven Lang06842022011-11-17 09:45:17 +01002705 .type = FIO_OPT_STR,
Radha Ramachandranf2bba182009-06-15 08:40:16 +02002706 .off1 = td_var_offset(continue_on_error),
Bruce Cran03e20d62011-01-02 20:14:54 +01002707 .help = "Continue on non-fatal errors during IO",
Steven Lang06842022011-11-17 09:45:17 +01002708 .def = "none",
Jens Axboee8b0e952012-03-19 14:37:08 +01002709 .category = FIO_OPT_C_GENERAL,
2710 .group = FIO_OPT_G_INVALID,
Steven Lang06842022011-11-17 09:45:17 +01002711 .posval = {
2712 { .ival = "none",
2713 .oval = ERROR_TYPE_NONE,
2714 .help = "Exit when an error is encountered",
2715 },
2716 { .ival = "read",
2717 .oval = ERROR_TYPE_READ,
2718 .help = "Continue on read errors only",
2719 },
2720 { .ival = "write",
2721 .oval = ERROR_TYPE_WRITE,
2722 .help = "Continue on write errors only",
2723 },
2724 { .ival = "io",
2725 .oval = ERROR_TYPE_READ | ERROR_TYPE_WRITE,
2726 .help = "Continue on any IO errors",
2727 },
2728 { .ival = "verify",
2729 .oval = ERROR_TYPE_VERIFY,
2730 .help = "Continue on verify errors only",
2731 },
2732 { .ival = "all",
2733 .oval = ERROR_TYPE_ANY,
2734 .help = "Continue on all io and verify errors",
2735 },
2736 { .ival = "0",
2737 .oval = ERROR_TYPE_NONE,
2738 .help = "Alias for 'none'",
2739 },
2740 { .ival = "1",
2741 .oval = ERROR_TYPE_ANY,
2742 .help = "Alias for 'all'",
2743 },
2744 },
Radha Ramachandranf2bba182009-06-15 08:40:16 +02002745 },
2746 {
Dmitry Monakhov8b28bd42012-09-23 15:46:09 +04002747 .name = "ignore_error",
2748 .type = FIO_OPT_STR,
2749 .cb = str_ignore_error_cb,
2750 .help = "Set a specific list of errors to ignore",
2751 .parent = "rw",
Jens Axboea94eb992012-09-24 18:46:34 +02002752 .category = FIO_OPT_C_GENERAL,
2753 .group = FIO_OPT_G_INVALID,
Dmitry Monakhov8b28bd42012-09-23 15:46:09 +04002754 },
2755 {
2756 .name = "error_dump",
2757 .type = FIO_OPT_BOOL,
2758 .off1 = td_var_offset(error_dump),
2759 .def = "0",
2760 .help = "Dump info on each error",
Jens Axboea94eb992012-09-24 18:46:34 +02002761 .category = FIO_OPT_C_GENERAL,
2762 .group = FIO_OPT_G_INVALID,
Dmitry Monakhov8b28bd42012-09-23 15:46:09 +04002763 },
Dmitry Monakhov8b28bd42012-09-23 15:46:09 +04002764 {
Jens Axboe9ac8a792009-11-13 21:23:07 +01002765 .name = "profile",
Jens Axboee8b0e952012-03-19 14:37:08 +01002766 .lname = "Profile",
Jens Axboe79d16312010-03-04 12:43:20 +01002767 .type = FIO_OPT_STR_STORE,
Jens Axboe9ac8a792009-11-13 21:23:07 +01002768 .off1 = td_var_offset(profile),
Jens Axboe9ac8a792009-11-13 21:23:07 +01002769 .help = "Select a specific builtin performance test",
Jens Axboe13fca822012-03-31 13:55:54 +02002770 .category = FIO_OPT_C_PROFILE,
Jens Axboee8b0e952012-03-19 14:37:08 +01002771 .group = FIO_OPT_G_INVALID,
Jens Axboe9ac8a792009-11-13 21:23:07 +01002772 },
2773 {
Jens Axboea696fa22009-12-04 10:05:02 +01002774 .name = "cgroup",
Jens Axboee8b0e952012-03-19 14:37:08 +01002775 .lname = "Cgroup",
Jens Axboea696fa22009-12-04 10:05:02 +01002776 .type = FIO_OPT_STR_STORE,
2777 .off1 = td_var_offset(cgroup),
2778 .help = "Add job to cgroup of this name",
Jens Axboee8b0e952012-03-19 14:37:08 +01002779 .category = FIO_OPT_C_GENERAL,
Jens Axboea1f6afe2012-03-19 20:44:33 +01002780 .group = FIO_OPT_G_CGROUP,
2781 },
2782 {
2783 .name = "cgroup_nodelete",
2784 .lname = "Cgroup no-delete",
2785 .type = FIO_OPT_BOOL,
2786 .off1 = td_var_offset(cgroup_nodelete),
2787 .help = "Do not delete cgroups after job completion",
2788 .def = "0",
2789 .parent = "cgroup",
2790 .category = FIO_OPT_C_GENERAL,
2791 .group = FIO_OPT_G_CGROUP,
Jens Axboea696fa22009-12-04 10:05:02 +01002792 },
2793 {
2794 .name = "cgroup_weight",
Jens Axboee8b0e952012-03-19 14:37:08 +01002795 .lname = "Cgroup weight",
Jens Axboea696fa22009-12-04 10:05:02 +01002796 .type = FIO_OPT_INT,
2797 .off1 = td_var_offset(cgroup_weight),
2798 .help = "Use given weight for cgroup",
2799 .minval = 100,
2800 .maxval = 1000,
Jens Axboea1f6afe2012-03-19 20:44:33 +01002801 .parent = "cgroup",
Jens Axboee8b0e952012-03-19 14:37:08 +01002802 .category = FIO_OPT_C_GENERAL,
Jens Axboea1f6afe2012-03-19 20:44:33 +01002803 .group = FIO_OPT_G_CGROUP,
Vivek Goyal7de87092010-03-31 22:55:15 +02002804 },
2805 {
Jens Axboee0b0d892009-12-08 10:10:14 +01002806 .name = "uid",
Jens Axboee8b0e952012-03-19 14:37:08 +01002807 .lname = "User ID",
Jens Axboee0b0d892009-12-08 10:10:14 +01002808 .type = FIO_OPT_INT,
2809 .off1 = td_var_offset(uid),
2810 .help = "Run job with this user ID",
Jens Axboee8b0e952012-03-19 14:37:08 +01002811 .category = FIO_OPT_C_GENERAL,
Jens Axboe10860052012-03-19 20:56:53 +01002812 .group = FIO_OPT_G_CRED,
Jens Axboee0b0d892009-12-08 10:10:14 +01002813 },
2814 {
2815 .name = "gid",
Jens Axboee8b0e952012-03-19 14:37:08 +01002816 .lname = "Group ID",
Jens Axboee0b0d892009-12-08 10:10:14 +01002817 .type = FIO_OPT_INT,
2818 .off1 = td_var_offset(gid),
2819 .help = "Run job with this group ID",
Jens Axboee8b0e952012-03-19 14:37:08 +01002820 .category = FIO_OPT_C_GENERAL,
Jens Axboe10860052012-03-19 20:56:53 +01002821 .group = FIO_OPT_G_CRED,
Jens Axboee0b0d892009-12-08 10:10:14 +01002822 },
2823 {
Jens Axboea1f6afe2012-03-19 20:44:33 +01002824 .name = "kb_base",
2825 .lname = "KB Base",
2826 .type = FIO_OPT_INT,
2827 .off1 = td_var_offset(kb_base),
2828 .verify = kb_base_verify,
2829 .prio = 1,
2830 .def = "1024",
2831 .help = "How many bytes per KB for reporting (1000 or 1024)",
2832 .category = FIO_OPT_C_GENERAL,
2833 .group = FIO_OPT_G_INVALID,
2834 },
2835 {
Jens Axboe3ceb4582012-03-19 21:27:02 +01002836 .name = "hugepage-size",
2837 .lname = "Hugepage size",
2838 .type = FIO_OPT_INT,
2839 .off1 = td_var_offset(hugepage_size),
2840 .help = "When using hugepages, specify size of each page",
2841 .def = __fio_stringify(FIO_HUGE_PAGE),
2842 .interval = 1024 * 1024,
2843 .category = FIO_OPT_C_GENERAL,
2844 .group = FIO_OPT_G_INVALID,
2845 },
2846 {
Dan Ehrenberg9e684a42012-02-20 11:05:14 +01002847 .name = "flow_id",
Jens Axboee8b0e952012-03-19 14:37:08 +01002848 .lname = "I/O flow ID",
Dan Ehrenberg9e684a42012-02-20 11:05:14 +01002849 .type = FIO_OPT_INT,
2850 .off1 = td_var_offset(flow_id),
2851 .help = "The flow index ID to use",
2852 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002853 .category = FIO_OPT_C_IO,
2854 .group = FIO_OPT_G_IO_FLOW,
Dan Ehrenberg9e684a42012-02-20 11:05:14 +01002855 },
2856 {
2857 .name = "flow",
Jens Axboee8b0e952012-03-19 14:37:08 +01002858 .lname = "I/O flow weight",
Dan Ehrenberg9e684a42012-02-20 11:05:14 +01002859 .type = FIO_OPT_INT,
2860 .off1 = td_var_offset(flow),
2861 .help = "Weight for flow control of this job",
2862 .parent = "flow_id",
Jens Axboed71c1542012-03-16 20:16:59 +01002863 .hide = 1,
Dan Ehrenberg9e684a42012-02-20 11:05:14 +01002864 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002865 .category = FIO_OPT_C_IO,
2866 .group = FIO_OPT_G_IO_FLOW,
Dan Ehrenberg9e684a42012-02-20 11:05:14 +01002867 },
2868 {
2869 .name = "flow_watermark",
Jens Axboee8b0e952012-03-19 14:37:08 +01002870 .lname = "I/O flow watermark",
Dan Ehrenberg9e684a42012-02-20 11:05:14 +01002871 .type = FIO_OPT_INT,
2872 .off1 = td_var_offset(flow_watermark),
2873 .help = "High watermark for flow control. This option"
2874 " should be set to the same value for all threads"
2875 " with non-zero flow.",
2876 .parent = "flow_id",
Jens Axboed71c1542012-03-16 20:16:59 +01002877 .hide = 1,
Dan Ehrenberg9e684a42012-02-20 11:05:14 +01002878 .def = "1024",
Jens Axboee8b0e952012-03-19 14:37:08 +01002879 .category = FIO_OPT_C_IO,
2880 .group = FIO_OPT_G_IO_FLOW,
Dan Ehrenberg9e684a42012-02-20 11:05:14 +01002881 },
2882 {
2883 .name = "flow_sleep",
Jens Axboee8b0e952012-03-19 14:37:08 +01002884 .lname = "I/O flow sleep",
Dan Ehrenberg9e684a42012-02-20 11:05:14 +01002885 .type = FIO_OPT_INT,
2886 .off1 = td_var_offset(flow_sleep),
2887 .help = "How many microseconds to sleep after being held"
2888 " back by the flow control mechanism",
2889 .parent = "flow_id",
Jens Axboed71c1542012-03-16 20:16:59 +01002890 .hide = 1,
Dan Ehrenberg9e684a42012-02-20 11:05:14 +01002891 .def = "0",
Jens Axboee8b0e952012-03-19 14:37:08 +01002892 .category = FIO_OPT_C_IO,
2893 .group = FIO_OPT_G_IO_FLOW,
Dan Ehrenberg9e684a42012-02-20 11:05:14 +01002894 },
2895 {
Jens Axboe214e1ec2007-03-15 10:48:13 +01002896 .name = NULL,
2897 },
2898};
2899
Jens Axboe17af15d2010-04-13 10:38:16 +02002900static void add_to_lopt(struct option *lopt, struct fio_option *o,
Steven Langde890a12011-11-09 14:03:34 +01002901 const char *name, int val)
Jens Axboe9f817362010-03-04 14:38:10 +01002902{
Jens Axboe17af15d2010-04-13 10:38:16 +02002903 lopt->name = (char *) name;
Steven Langde890a12011-11-09 14:03:34 +01002904 lopt->val = val;
Jens Axboe9f817362010-03-04 14:38:10 +01002905 if (o->type == FIO_OPT_STR_SET)
2906 lopt->has_arg = no_argument;
2907 else
2908 lopt->has_arg = required_argument;
2909}
2910
Steven Langde890a12011-11-09 14:03:34 +01002911static void options_to_lopts(struct fio_option *opts,
2912 struct option *long_options,
2913 int i, int option_type)
2914{
2915 struct fio_option *o = &opts[0];
2916 while (o->name) {
2917 add_to_lopt(&long_options[i], o, o->name, option_type);
2918 if (o->alias) {
2919 i++;
2920 add_to_lopt(&long_options[i], o, o->alias, option_type);
2921 }
2922
2923 i++;
2924 o++;
2925 assert(i < FIO_NR_OPTIONS);
2926 }
2927}
2928
2929void fio_options_set_ioengine_opts(struct option *long_options,
2930 struct thread_data *td)
2931{
2932 unsigned int i;
2933
2934 i = 0;
2935 while (long_options[i].name) {
2936 if (long_options[i].val == FIO_GETOPT_IOENGINE) {
2937 memset(&long_options[i], 0, sizeof(*long_options));
2938 break;
2939 }
2940 i++;
2941 }
2942
2943 /*
2944 * Just clear out the prior ioengine options.
2945 */
2946 if (!td || !td->eo)
2947 return;
2948
2949 options_to_lopts(td->io_ops->options, long_options, i,
2950 FIO_GETOPT_IOENGINE);
2951}
2952
Jens Axboe214e1ec2007-03-15 10:48:13 +01002953void fio_options_dup_and_init(struct option *long_options)
2954{
Jens Axboe214e1ec2007-03-15 10:48:13 +01002955 unsigned int i;
2956
Jens Axboe9af4a242012-03-16 10:13:49 +01002957 options_init(fio_options);
Jens Axboe214e1ec2007-03-15 10:48:13 +01002958
2959 i = 0;
2960 while (long_options[i].name)
2961 i++;
2962
Jens Axboe9af4a242012-03-16 10:13:49 +01002963 options_to_lopts(fio_options, long_options, i, FIO_GETOPT_JOB);
Jens Axboe214e1ec2007-03-15 10:48:13 +01002964}
2965
Jens Axboe74929ac2009-08-05 11:42:37 +02002966struct fio_keyword {
2967 const char *word;
2968 const char *desc;
2969 char *replace;
2970};
2971
2972static struct fio_keyword fio_keywords[] = {
2973 {
2974 .word = "$pagesize",
2975 .desc = "Page size in the system",
2976 },
2977 {
2978 .word = "$mb_memory",
2979 .desc = "Megabytes of memory online",
2980 },
2981 {
2982 .word = "$ncpus",
2983 .desc = "Number of CPUs online in the system",
2984 },
2985 {
2986 .word = NULL,
2987 },
2988};
2989
2990void fio_keywords_init(void)
2991{
Jens Axboe3b2e1462009-12-15 08:58:10 +01002992 unsigned long long mb_memory;
Jens Axboe74929ac2009-08-05 11:42:37 +02002993 char buf[128];
2994 long l;
2995
2996 sprintf(buf, "%lu", page_size);
2997 fio_keywords[0].replace = strdup(buf);
2998
Jens Axboe8eb016d2011-07-11 10:24:20 +02002999 mb_memory = os_phys_mem() / (1024 * 1024);
Jens Axboe3b2e1462009-12-15 08:58:10 +01003000 sprintf(buf, "%llu", mb_memory);
Jens Axboe74929ac2009-08-05 11:42:37 +02003001 fio_keywords[1].replace = strdup(buf);
3002
Jens Axboec00a2282011-07-08 20:56:06 +02003003 l = cpus_online();
Jens Axboe74929ac2009-08-05 11:42:37 +02003004 sprintf(buf, "%lu", l);
3005 fio_keywords[2].replace = strdup(buf);
3006}
3007
Jens Axboe892a6ff2009-11-13 12:19:49 +01003008#define BC_APP "bc"
3009
3010static char *bc_calc(char *str)
3011{
Steven Langd0c814e2011-10-28 08:37:13 +02003012 char buf[128], *tmp;
Jens Axboe892a6ff2009-11-13 12:19:49 +01003013 FILE *f;
3014 int ret;
3015
3016 /*
3017 * No math, just return string
3018 */
Steven Langd0c814e2011-10-28 08:37:13 +02003019 if ((!strchr(str, '+') && !strchr(str, '-') && !strchr(str, '*') &&
3020 !strchr(str, '/')) || strchr(str, '\''))
Jens Axboe892a6ff2009-11-13 12:19:49 +01003021 return str;
3022
3023 /*
3024 * Split option from value, we only need to calculate the value
3025 */
3026 tmp = strchr(str, '=');
3027 if (!tmp)
3028 return str;
3029
3030 tmp++;
Jens Axboe892a6ff2009-11-13 12:19:49 +01003031
Steven Langd0c814e2011-10-28 08:37:13 +02003032 /*
3033 * Prevent buffer overflows; such a case isn't reasonable anyway
3034 */
3035 if (strlen(str) >= 128 || strlen(tmp) > 100)
3036 return str;
Jens Axboe892a6ff2009-11-13 12:19:49 +01003037
3038 sprintf(buf, "which %s > /dev/null", BC_APP);
3039 if (system(buf)) {
3040 log_err("fio: bc is needed for performing math\n");
Jens Axboe892a6ff2009-11-13 12:19:49 +01003041 return NULL;
3042 }
3043
Steven Langd0c814e2011-10-28 08:37:13 +02003044 sprintf(buf, "echo '%s' | %s", tmp, BC_APP);
Jens Axboe892a6ff2009-11-13 12:19:49 +01003045 f = popen(buf, "r");
Jens Axboe3c3ed072012-03-27 09:12:39 +02003046 if (!f)
Jens Axboe892a6ff2009-11-13 12:19:49 +01003047 return NULL;
Jens Axboe892a6ff2009-11-13 12:19:49 +01003048
Steven Langd0c814e2011-10-28 08:37:13 +02003049 ret = fread(&buf[tmp - str], 1, 128 - (tmp - str), f);
Jens Axboe3c3ed072012-03-27 09:12:39 +02003050 if (ret <= 0)
Jens Axboe892a6ff2009-11-13 12:19:49 +01003051 return NULL;
Jens Axboe892a6ff2009-11-13 12:19:49 +01003052
Jens Axboe892a6ff2009-11-13 12:19:49 +01003053 pclose(f);
Steven Langd0c814e2011-10-28 08:37:13 +02003054 buf[(tmp - str) + ret - 1] = '\0';
3055 memcpy(buf, str, tmp - str);
Jens Axboe892a6ff2009-11-13 12:19:49 +01003056 free(str);
Steven Langd0c814e2011-10-28 08:37:13 +02003057 return strdup(buf);
3058}
3059
3060/*
3061 * Return a copy of the input string with substrings of the form ${VARNAME}
3062 * substituted with the value of the environment variable VARNAME. The
3063 * substitution always occurs, even if VARNAME is empty or the corresponding
3064 * environment variable undefined.
3065 */
3066static char *option_dup_subs(const char *opt)
3067{
3068 char out[OPT_LEN_MAX+1];
3069 char in[OPT_LEN_MAX+1];
3070 char *outptr = out;
3071 char *inptr = in;
3072 char *ch1, *ch2, *env;
3073 ssize_t nchr = OPT_LEN_MAX;
3074 size_t envlen;
3075
3076 if (strlen(opt) + 1 > OPT_LEN_MAX) {
3077 log_err("OPT_LEN_MAX (%d) is too small\n", OPT_LEN_MAX);
3078 return NULL;
3079 }
3080
3081 in[OPT_LEN_MAX] = '\0';
3082 strncpy(in, opt, OPT_LEN_MAX);
3083
3084 while (*inptr && nchr > 0) {
3085 if (inptr[0] == '$' && inptr[1] == '{') {
3086 ch2 = strchr(inptr, '}');
3087 if (ch2 && inptr+1 < ch2) {
3088 ch1 = inptr+2;
3089 inptr = ch2+1;
3090 *ch2 = '\0';
3091
3092 env = getenv(ch1);
3093 if (env) {
3094 envlen = strlen(env);
3095 if (envlen <= nchr) {
3096 memcpy(outptr, env, envlen);
3097 outptr += envlen;
3098 nchr -= envlen;
3099 }
3100 }
3101
3102 continue;
3103 }
3104 }
3105
3106 *outptr++ = *inptr++;
3107 --nchr;
3108 }
3109
3110 *outptr = '\0';
3111 return strdup(out);
Jens Axboe892a6ff2009-11-13 12:19:49 +01003112}
3113
Jens Axboe74929ac2009-08-05 11:42:37 +02003114/*
3115 * Look for reserved variable names and replace them with real values
3116 */
3117static char *fio_keyword_replace(char *opt)
3118{
3119 char *s;
3120 int i;
Steven Langd0c814e2011-10-28 08:37:13 +02003121 int docalc = 0;
Jens Axboe74929ac2009-08-05 11:42:37 +02003122
3123 for (i = 0; fio_keywords[i].word != NULL; i++) {
3124 struct fio_keyword *kw = &fio_keywords[i];
3125
3126 while ((s = strstr(opt, kw->word)) != NULL) {
3127 char *new = malloc(strlen(opt) + 1);
3128 char *o_org = opt;
3129 int olen = s - opt;
3130 int len;
3131
3132 /*
3133 * Copy part of the string before the keyword and
3134 * sprintf() the replacement after it.
3135 */
3136 memcpy(new, opt, olen);
3137 len = sprintf(new + olen, "%s", kw->replace);
3138
3139 /*
3140 * If there's more in the original string, copy that
3141 * in too
3142 */
3143 opt += strlen(kw->word) + olen;
3144 if (strlen(opt))
3145 memcpy(new + olen + len, opt, opt - o_org - 1);
3146
3147 /*
3148 * replace opt and free the old opt
3149 */
3150 opt = new;
Steven Langd0c814e2011-10-28 08:37:13 +02003151 free(o_org);
Jens Axboe7a958bd2009-11-13 12:33:54 +01003152
Steven Langd0c814e2011-10-28 08:37:13 +02003153 docalc = 1;
Jens Axboe74929ac2009-08-05 11:42:37 +02003154 }
3155 }
3156
Steven Langd0c814e2011-10-28 08:37:13 +02003157 /*
3158 * Check for potential math and invoke bc, if possible
3159 */
3160 if (docalc)
3161 opt = bc_calc(opt);
3162
Jens Axboe7a958bd2009-11-13 12:33:54 +01003163 return opt;
Jens Axboe74929ac2009-08-05 11:42:37 +02003164}
3165
Steven Langd0c814e2011-10-28 08:37:13 +02003166static char **dup_and_sub_options(char **opts, int num_opts)
3167{
3168 int i;
3169 char **opts_copy = malloc(num_opts * sizeof(*opts));
3170 for (i = 0; i < num_opts; i++) {
3171 opts_copy[i] = option_dup_subs(opts[i]);
3172 if (!opts_copy[i])
3173 continue;
3174 opts_copy[i] = fio_keyword_replace(opts_copy[i]);
3175 }
3176 return opts_copy;
3177}
3178
Jens Axboe3b8b7132008-06-10 19:46:23 +02003179int fio_options_parse(struct thread_data *td, char **opts, int num_opts)
Jens Axboe214e1ec2007-03-15 10:48:13 +01003180{
Steven Langde890a12011-11-09 14:03:34 +01003181 int i, ret, unknown;
Steven Langd0c814e2011-10-28 08:37:13 +02003182 char **opts_copy;
Jens Axboe3b8b7132008-06-10 19:46:23 +02003183
Jens Axboe9af4a242012-03-16 10:13:49 +01003184 sort_options(opts, fio_options, num_opts);
Steven Langd0c814e2011-10-28 08:37:13 +02003185 opts_copy = dup_and_sub_options(opts, num_opts);
Jens Axboe3b8b7132008-06-10 19:46:23 +02003186
Steven Langde890a12011-11-09 14:03:34 +01003187 for (ret = 0, i = 0, unknown = 0; i < num_opts; i++) {
3188 struct fio_option *o;
Jens Axboe9af4a242012-03-16 10:13:49 +01003189 int newret = parse_option(opts_copy[i], opts[i], fio_options,
3190 &o, td);
Steven Langd0c814e2011-10-28 08:37:13 +02003191
Steven Langde890a12011-11-09 14:03:34 +01003192 if (opts_copy[i]) {
3193 if (newret && !o) {
3194 unknown++;
3195 continue;
3196 }
Steven Langd0c814e2011-10-28 08:37:13 +02003197 free(opts_copy[i]);
Steven Langde890a12011-11-09 14:03:34 +01003198 opts_copy[i] = NULL;
3199 }
3200
3201 ret |= newret;
3202 }
3203
3204 if (unknown) {
3205 ret |= ioengine_load(td);
3206 if (td->eo) {
3207 sort_options(opts_copy, td->io_ops->options, num_opts);
3208 opts = opts_copy;
3209 }
3210 for (i = 0; i < num_opts; i++) {
3211 struct fio_option *o = NULL;
3212 int newret = 1;
3213 if (!opts_copy[i])
3214 continue;
3215
3216 if (td->eo)
3217 newret = parse_option(opts_copy[i], opts[i],
3218 td->io_ops->options, &o,
3219 td->eo);
3220
3221 ret |= newret;
3222 if (!o)
3223 log_err("Bad option <%s>\n", opts[i]);
3224
3225 free(opts_copy[i]);
3226 opts_copy[i] = NULL;
3227 }
Jens Axboe74929ac2009-08-05 11:42:37 +02003228 }
Jens Axboe3b8b7132008-06-10 19:46:23 +02003229
Steven Langd0c814e2011-10-28 08:37:13 +02003230 free(opts_copy);
Jens Axboe3b8b7132008-06-10 19:46:23 +02003231 return ret;
Jens Axboe214e1ec2007-03-15 10:48:13 +01003232}
3233
3234int fio_cmd_option_parse(struct thread_data *td, const char *opt, char *val)
3235{
Jens Axboe9af4a242012-03-16 10:13:49 +01003236 return parse_cmd_option(opt, val, fio_options, td);
Jens Axboe214e1ec2007-03-15 10:48:13 +01003237}
3238
Steven Langde890a12011-11-09 14:03:34 +01003239int fio_cmd_ioengine_option_parse(struct thread_data *td, const char *opt,
3240 char *val)
3241{
3242 return parse_cmd_option(opt, val, td->io_ops->options, td);
3243}
3244
Jens Axboe214e1ec2007-03-15 10:48:13 +01003245void fio_fill_default_options(struct thread_data *td)
3246{
Jens Axboe9af4a242012-03-16 10:13:49 +01003247 fill_default_options(td, fio_options);
Jens Axboe214e1ec2007-03-15 10:48:13 +01003248}
3249
3250int fio_show_option_help(const char *opt)
3251{
Jens Axboe9af4a242012-03-16 10:13:49 +01003252 return show_cmd_help(fio_options, opt);
Jens Axboe214e1ec2007-03-15 10:48:13 +01003253}
Jens Axboed23bb322007-03-23 15:57:56 +01003254
Steven Langde890a12011-11-09 14:03:34 +01003255void options_mem_dupe(void *data, struct fio_option *options)
3256{
3257 struct fio_option *o;
3258 char **ptr;
3259
3260 for (o = &options[0]; o->name; o++) {
3261 if (o->type != FIO_OPT_STR_STORE)
3262 continue;
3263
3264 ptr = td_var(data, o->off1);
3265 if (*ptr)
3266 *ptr = strdup(*ptr);
3267 }
3268}
3269
Jens Axboe7e356b22011-10-14 10:55:16 +02003270/*
3271 * dupe FIO_OPT_STR_STORE options
3272 */
Steven Langde890a12011-11-09 14:03:34 +01003273void fio_options_mem_dupe(struct thread_data *td)
Jens Axboed23bb322007-03-23 15:57:56 +01003274{
Jens Axboe9af4a242012-03-16 10:13:49 +01003275 options_mem_dupe(&td->o, fio_options);
Jens Axboe1647f592011-11-09 20:25:21 +01003276
3277 if (td->eo && td->io_ops) {
Steven Langde890a12011-11-09 14:03:34 +01003278 void *oldeo = td->eo;
Jens Axboe1647f592011-11-09 20:25:21 +01003279
Steven Langde890a12011-11-09 14:03:34 +01003280 td->eo = malloc(td->io_ops->option_struct_size);
3281 memcpy(td->eo, oldeo, td->io_ops->option_struct_size);
3282 options_mem_dupe(td->eo, td->io_ops->options);
Jens Axboed23bb322007-03-23 15:57:56 +01003283 }
3284}
3285
Jens Axboed6978a32009-07-18 21:04:09 +02003286unsigned int fio_get_kb_base(void *data)
3287{
Jens Axboe83ea4222012-03-28 14:01:46 +02003288 struct thread_options *o = data;
Jens Axboed6978a32009-07-18 21:04:09 +02003289 unsigned int kb_base = 0;
3290
Jens Axboe83ea4222012-03-28 14:01:46 +02003291 if (o)
3292 kb_base = o->kb_base;
Jens Axboed6978a32009-07-18 21:04:09 +02003293 if (!kb_base)
3294 kb_base = 1024;
3295
3296 return kb_base;
3297}
Jens Axboe9f988e22010-03-04 10:42:38 +01003298
Jens Axboe07b32322010-03-05 09:48:44 +01003299int add_option(struct fio_option *o)
Jens Axboe9f988e22010-03-04 10:42:38 +01003300{
Jens Axboe07b32322010-03-05 09:48:44 +01003301 struct fio_option *__o;
3302 int opt_index = 0;
3303
Jens Axboe9af4a242012-03-16 10:13:49 +01003304 __o = fio_options;
Jens Axboe07b32322010-03-05 09:48:44 +01003305 while (__o->name) {
3306 opt_index++;
3307 __o++;
3308 }
3309
Jens Axboe9af4a242012-03-16 10:13:49 +01003310 memcpy(&fio_options[opt_index], o, sizeof(*o));
Jens Axboe07b32322010-03-05 09:48:44 +01003311 return 0;
Jens Axboe9f988e22010-03-04 10:42:38 +01003312}
Jens Axboee2de69d2010-03-04 14:05:48 +01003313
Jens Axboe07b32322010-03-05 09:48:44 +01003314void invalidate_profile_options(const char *prof_name)
Jens Axboee2de69d2010-03-04 14:05:48 +01003315{
Jens Axboe07b32322010-03-05 09:48:44 +01003316 struct fio_option *o;
Jens Axboee2de69d2010-03-04 14:05:48 +01003317
Jens Axboe9af4a242012-03-16 10:13:49 +01003318 o = fio_options;
Jens Axboe07b32322010-03-05 09:48:44 +01003319 while (o->name) {
3320 if (o->prof_name && !strcmp(o->prof_name, prof_name)) {
3321 o->type = FIO_OPT_INVALID;
3322 o->prof_name = NULL;
3323 }
3324 o++;
Jens Axboee2de69d2010-03-04 14:05:48 +01003325 }
3326}
Jens Axboef5b6bb82010-03-05 10:09:59 +01003327
3328void add_opt_posval(const char *optname, const char *ival, const char *help)
3329{
3330 struct fio_option *o;
3331 unsigned int i;
3332
Jens Axboe9af4a242012-03-16 10:13:49 +01003333 o = find_option(fio_options, optname);
Jens Axboef5b6bb82010-03-05 10:09:59 +01003334 if (!o)
3335 return;
3336
3337 for (i = 0; i < PARSE_MAX_VP; i++) {
3338 if (o->posval[i].ival)
3339 continue;
3340
3341 o->posval[i].ival = ival;
3342 o->posval[i].help = help;
3343 break;
3344 }
3345}
3346
3347void del_opt_posval(const char *optname, const char *ival)
3348{
3349 struct fio_option *o;
3350 unsigned int i;
3351
Jens Axboe9af4a242012-03-16 10:13:49 +01003352 o = find_option(fio_options, optname);
Jens Axboef5b6bb82010-03-05 10:09:59 +01003353 if (!o)
3354 return;
3355
3356 for (i = 0; i < PARSE_MAX_VP; i++) {
3357 if (!o->posval[i].ival)
3358 continue;
3359 if (strcmp(o->posval[i].ival, ival))
3360 continue;
3361
3362 o->posval[i].ival = NULL;
3363 o->posval[i].help = NULL;
3364 }
3365}
Jens Axboe7e356b22011-10-14 10:55:16 +02003366
3367void fio_options_free(struct thread_data *td)
3368{
Jens Axboe9af4a242012-03-16 10:13:49 +01003369 options_free(fio_options, td);
Steven Langde890a12011-11-09 14:03:34 +01003370 if (td->eo && td->io_ops && td->io_ops->options) {
3371 options_free(td->io_ops->options, td->eo);
3372 free(td->eo);
3373 td->eo = NULL;
3374 }
Jens Axboe7e356b22011-10-14 10:55:16 +02003375}
Jens Axboec504ee52012-03-20 11:29:09 +01003376
3377struct fio_option *fio_option_find(const char *name)
3378{
3379 return find_option(fio_options, name);
3380}
3381