+static struct fio_option options[] = {
+ {
+ .name = "description",
+ .type = FIO_OPT_STR_STORE,
+ .off1 = td_var_offset(description),
+ .help = "Text job description",
+ },
+ {
+ .name = "name",
+ .type = FIO_OPT_STR_STORE,
+ .off1 = td_var_offset(name),
+ .help = "Name of this job",
+ },
+ {
+ .name = "directory",
+ .type = FIO_OPT_STR_STORE,
+ .off1 = td_var_offset(directory),
+ .help = "Directory to store files in",
+ },
+ {
+ .name = "filename",
+ .type = FIO_OPT_STR_STORE,
+ .off1 = td_var_offset(filename),
+ .help = "Force the use of a specific file",
+ },
+ {
+ .name = "rw",
+ .type = FIO_OPT_STR,
+ .cb = str_rw_cb,
+ .help = "IO direction",
+ .def = "read",
+ .posval = { "read", "write", "randwrite", "randread", "rw",
+ "randrw", },
+ },
+ {
+ .name = "ioengine",
+ .type = FIO_OPT_STR,
+ .cb = str_ioengine_cb,
+ .help = "IO engine to use",
+ .def = "sync",
+ .posval = { "sync", "libaio", "posixaio", "mmap", "splice",
+ "sg", "null", "net", },
+ },
+ {
+ .name = "iodepth",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(iodepth),
+ .help = "Amount of IO buffers to keep in flight",
+ .def = "1",
+ },
+ {
+ .name = "size",
+ .type = FIO_OPT_STR_VAL,
+ .off1 = td_var_offset(total_file_size),
+ .help = "Size of device or file",
+ },
+ {
+ .name = "bs",
+ .type = FIO_OPT_STR_VAL_INT,
+ .off1 = td_var_offset(bs[DDIR_READ]),
+ .off2 = td_var_offset(bs[DDIR_WRITE]),
+ .help = "Block size unit",
+ .def = "4k",
+ },
+ {
+ .name = "bsrange",
+ .type = FIO_OPT_RANGE,
+ .off1 = td_var_offset(min_bs[DDIR_READ]),
+ .off2 = td_var_offset(max_bs[DDIR_READ]),
+ .off3 = td_var_offset(min_bs[DDIR_WRITE]),
+ .off4 = td_var_offset(max_bs[DDIR_WRITE]),
+ .help = "Set block size range (in more detail than bs)",
+ },
+ {
+ .name = "bs_unaligned",
+ .type = FIO_OPT_STR_SET,
+ .off1 = td_var_offset(bs_unaligned),
+ .help = "Don't sector align IO buffer sizes",
+ },
+ {
+ .name = "offset",
+ .type = FIO_OPT_STR_VAL,
+ .off1 = td_var_offset(start_offset),
+ .help = "Start IO from this offset",
+ .def = "0",
+ },
+ {
+ .name = "randrepeat",
+ .type = FIO_OPT_BOOL,
+ .off1 = td_var_offset(rand_repeatable),
+ .help = "Use repeatable random IO pattern",
+ .def = "1",
+ },
+ {
+ .name = "norandommap",
+ .type = FIO_OPT_STR_SET,
+ .off1 = td_var_offset(norandommap),
+ .help = "Accept potential duplicate random blocks",
+ },
+ {
+ .name = "nrfiles",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(nr_files),
+ .help = "Split job workload between this number of files",
+ .def = "1",
+ },
+ {
+ .name = "fsync",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(fsync_blocks),
+ .help = "Issue fsync for writes every given number of blocks",
+ .def = "0",
+ },
+ {
+ .name = "direct",
+ .type = FIO_OPT_BOOL,
+ .off1 = td_var_offset(odirect),
+ .help = "Use O_DIRECT IO (negates buffered)",
+ .def = "0",
+ },
+ {
+ .name = "buffered",
+ .type = FIO_OPT_BOOL,
+ .off1 = td_var_offset(odirect),
+ .neg = 1,
+ .help = "Use buffered IO (negates direct)",
+ .def = "1",
+ },
+ {
+ .name = "overwrite",
+ .type = FIO_OPT_BOOL,
+ .off1 = td_var_offset(overwrite),
+ .help = "When writing, set whether to overwrite current data",
+ .def = "0",
+ },
+ {
+ .name = "loops",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(loops),
+ .help = "Number of times to run the job",
+ .def = "1",
+ },
+ {
+ .name = "numjobs",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(numjobs),
+ .help = "Duplicate this job this many times",
+ .def = "1",
+ },
+ {
+ .name = "startdelay",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(start_delay),
+ .help = "Only start job when this period has passed",
+ .def = "0",
+ },
+ {
+ .name = "runtime",
+ .alias = "timeout",
+ .type = FIO_OPT_STR_VAL_TIME,
+ .off1 = td_var_offset(timeout),
+ .help = "Stop workload when this amount of time has passed",
+ .def = "0",
+ },
+ {
+ .name = "mem",
+ .type = FIO_OPT_STR,
+ .cb = str_mem_cb,
+ .help = "Backing type for IO buffers",
+ .def = "malloc",
+ .posval = { "malloc", "shm", "shmhuge", "mmap", "mmaphuge", },
+ },
+ {
+ .name = "verify",
+ .type = FIO_OPT_STR,
+ .cb = str_verify_cb,
+ .help = "Verify sum function",
+ .def = "0",
+ .posval = { "crc32", "md5", },
+ },
+ {
+ .name = "write_iolog",
+ .type = FIO_OPT_STR_STORE,
+ .off1 = td_var_offset(write_iolog_file),
+ .help = "Store IO pattern to file",
+ },
+ {
+ .name = "read_iolog",
+ .type = FIO_OPT_STR_STORE,
+ .off1 = td_var_offset(read_iolog_file),
+ .help = "Playback IO pattern from file",
+ },
+ {
+ .name = "exec_prerun",
+ .type = FIO_OPT_STR_STORE,
+ .off1 = td_var_offset(exec_prerun),
+ .help = "Execute this file prior to running job",
+ },
+ {
+ .name = "exec_postrun",
+ .type = FIO_OPT_STR_STORE,
+ .off1 = td_var_offset(exec_postrun),
+ .help = "Execute this file after running job",
+ },
+#ifdef FIO_HAVE_IOSCHED_SWITCH
+ {
+ .name = "ioscheduler",
+ .type = FIO_OPT_STR_STORE,
+ .off1 = td_var_offset(ioscheduler),
+ .help = "Use this IO scheduler on the backing device",
+ },
+#endif
+ {
+ .name = "zonesize",
+ .type = FIO_OPT_STR_VAL,
+ .off1 = td_var_offset(zone_size),
+ .help = "Give size of an IO zone",
+ .def = "0",
+ },
+ {
+ .name = "zoneskip",
+ .type = FIO_OPT_STR_VAL,
+ .off1 = td_var_offset(zone_skip),
+ .help = "Space between IO zones",
+ .def = "0",
+ },
+ {
+ .name = "lockmem",
+ .type = FIO_OPT_STR_VAL,
+ .cb = str_lockmem_cb,
+ .help = "Lock down this amount of memory",
+ .def = "0",
+ },
+ {
+ .name = "rwmixcycle",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(rwmixcycle),
+ .help = "Cycle period for mixed read/write workloads (msec)",
+ .def = "500",
+ },
+ {
+ .name = "rwmixread",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(rwmixread),
+ .maxval = 100,
+ .help = "Percentage of mixed workload that is reads",
+ .def = "50",
+ },
+ {
+ .name = "rwmixwrite",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(rwmixwrite),
+ .maxval = 100,
+ .help = "Percentage of mixed workload that is writes",
+ .def = "50",
+ },
+ {
+ .name = "nice",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(nice),
+ .help = "Set job CPU nice value",
+ .minval = -19,
+ .maxval = 20,
+ .def = "0",
+ },
+#ifdef FIO_HAVE_IOPRIO
+ {
+ .name = "prio",
+ .type = FIO_OPT_INT,
+ .cb = str_prio_cb,
+ .help = "Set job IO priority value",
+ .minval = 0,
+ .maxval = 7,
+ },
+ {
+ .name = "prioclass",
+ .type = FIO_OPT_INT,
+ .cb = str_prioclass_cb,
+ .help = "Set job IO priority class",
+ .minval = 0,
+ .maxval = 3,
+ },
+#endif
+ {
+ .name = "thinktime",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(thinktime),
+ .help = "Idle time between IO buffers (usec)",
+ .def = "0",
+ },
+ {
+ .name = "thinktime_blocks",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(thinktime_blocks),
+ .help = "IO buffer period between 'thinktime'",
+ .def = "1",
+ },
+ {
+ .name = "rate",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(rate),
+ .help = "Set bandwidth rate",
+ },
+ {
+ .name = "ratemin",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(ratemin),
+ .help = "The bottom limit accepted",
+ },
+ {
+ .name = "ratecycle",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(ratecycle),
+ .help = "Window average for rate limits (msec)",
+ .def = "1000",
+ },
+ {
+ .name = "invalidate",
+ .type = FIO_OPT_BOOL,
+ .off1 = td_var_offset(invalidate_cache),
+ .help = "Invalidate buffer/page cache prior to running job",
+ .def = "1",
+ },
+ {
+ .name = "sync",
+ .type = FIO_OPT_BOOL,
+ .off1 = td_var_offset(sync_io),
+ .help = "Use O_SYNC for buffered writes",
+ .def = "0",
+ },
+ {
+ .name = "bwavgtime",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(bw_avg_time),
+ .help = "Time window over which to calculate bandwidth (msec)",
+ .def = "500",
+ },
+ {
+ .name = "create_serialize",
+ .type = FIO_OPT_BOOL,
+ .off1 = td_var_offset(create_serialize),
+ .help = "Serialize creating of job files",
+ .def = "1",
+ },
+ {
+ .name = "create_fsync",
+ .type = FIO_OPT_BOOL,
+ .off1 = td_var_offset(create_fsync),
+ .help = "Fsync file after creation",
+ .def = "1",
+ },
+ {
+ .name = "cpuload",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(cpuload),
+ .help = "Use this percentage of CPU",
+ },
+ {
+ .name = "cpuchunks",
+ .type = FIO_OPT_INT,
+ .off1 = td_var_offset(cpucycle),
+ .help = "Length of the CPU burn cycles",
+ },
+#ifdef FIO_HAVE_CPU_AFFINITY
+ {
+ .name = "cpumask",
+ .type = FIO_OPT_INT,
+ .cb = str_cpumask_cb,
+ .help = "CPU affinity mask",
+ },
+#endif
+ {
+ .name = "end_fsync",
+ .type = FIO_OPT_BOOL,
+ .off1 = td_var_offset(end_fsync),
+ .help = "Include fsync at the end of job",
+ .def = "0",
+ },
+ {
+ .name = "unlink",
+ .type = FIO_OPT_BOOL,
+ .off1 = td_var_offset(unlink),
+ .help = "Unlink created files after job has completed",
+ .def = "0",
+ },
+ {
+ .name = "exitall",
+ .type = FIO_OPT_STR_SET,
+ .cb = str_exitall_cb,
+ .help = "Terminate all jobs when one exits",
+ },
+ {
+ .name = "stonewall",
+ .type = FIO_OPT_STR_SET,
+ .off1 = td_var_offset(stonewall),
+ .help = "Insert a hard barrier between this job and previous",
+ },
+ {
+ .name = "thread",
+ .type = FIO_OPT_STR_SET,
+ .off1 = td_var_offset(use_thread),
+ .help = "Use threads instead of forks",
+ },
+ {
+ .name = "write_bw_log",
+ .type = FIO_OPT_STR_SET,
+ .off1 = td_var_offset(write_bw_log),
+ .help = "Write log of bandwidth during run",
+ },
+ {
+ .name = "write_lat_log",
+ .type = FIO_OPT_STR_SET,
+ .off1 = td_var_offset(write_lat_log),
+ .help = "Write log of latency during run",
+ },
+ {
+ .name = "hugepage-size",
+ .type = FIO_OPT_STR_VAL,
+ .off1 = td_var_offset(hugepage_size),
+ .help = "When using hugepages, specify size of each page",
+ .def = __stringify(FIO_HUGE_PAGE),
+ },
+ {
+ .name = NULL,
+ },
+};
+
+#define FIO_JOB_OPTS (sizeof(options) / sizeof(struct fio_option))
+#define FIO_CMD_OPTS (16)
+#define FIO_GETOPT_JOB (0x89988998)
+
+/*
+ * Command line options. These will contain the above, plus a few
+ * extra that only pertain to fio itself and not jobs.
+ */
+static struct option long_options[FIO_JOB_OPTS + FIO_CMD_OPTS] = {
+ {
+ .name = "output",
+ .has_arg = required_argument,
+ .val = 'o',
+ },
+ {
+ .name = "timeout",
+ .has_arg = required_argument,
+ .val = 't',
+ },
+ {
+ .name = "latency-log",
+ .has_arg = required_argument,
+ .val = 'l',
+ },
+ {
+ .name = "bandwidth-log",
+ .has_arg = required_argument,
+ .val = 'b',
+ },
+ {
+ .name = "minimal",
+ .has_arg = optional_argument,
+ .val = 'm',
+ },
+ {
+ .name = "version",
+ .has_arg = no_argument,
+ .val = 'v',
+ },
+ {
+ .name = "help",
+ .has_arg = no_argument,
+ .val = 'h',
+ },
+ {
+ .name = "cmdhelp",
+ .has_arg = required_argument,
+ .val = 'c',
+ },
+ {
+ .name = NULL,
+ },
+};
+
+static int def_timeout = 0;
+
+static char fio_version_string[] = "fio 1.11";