thread_options.h

   1 #ifndef FIO_THREAD_OPTIONS_H
   2 #define FIO_THREAD_OPTIONS_H
   3
   4 #include "arch/arch.h"
   5 #include "os/os.h"
   6 #include "options.h"
   7 #include "stat.h"
   8 #include "gettime.h"
   9 #include "lib/ieee754.h"
  10 #include "lib/pattern.h"
  11 #include "td_error.h"
  12
  13 enum fio_zone_mode {
  14         ZONE_MODE_NOT_SPECIFIED = 0,
  15         ZONE_MODE_NONE          = 1,
  16         ZONE_MODE_STRIDED       = 2, /* perform I/O in one zone at a time */
  17         /* perform I/O across multiple zones simultaneously */
  18         ZONE_MODE_ZBD           = 3,
  19 };
  20
  21 /*
  22  * What type of allocation to use for io buffers
  23  */
  24 enum fio_memtype {
  25         MEM_MALLOC = 0, /* ordinary malloc */
  26         MEM_SHM,        /* use shared memory segments */
  27         MEM_SHMHUGE,    /* use shared memory segments with huge pages */
  28         MEM_MMAP,       /* use anonynomous mmap */
  29         MEM_MMAPHUGE,   /* memory mapped huge file */
  30         MEM_MMAPSHARED, /* use mmap with shared flag */
  31         MEM_CUDA_MALLOC,/* use GPU memory */
  32 };
  33
  34 #define ERROR_STR_MAX   128
  35
  36 #define BSSPLIT_MAX     64
  37 #define ZONESPLIT_MAX   256
  38
  39 struct bssplit {
  40         uint64_t bs;
  41         uint32_t perc;
  42 };
  43
  44 struct zone_split {
  45         uint8_t access_perc;
  46         uint8_t size_perc;
  47         uint8_t pad[6];
  48         uint64_t size;
  49 };
  50
  51 #define NR_OPTS_SZ      (FIO_MAX_OPTS / (8 * sizeof(uint64_t)))
  52
  53 #define OPT_MAGIC       0x4f50544e
  54
  55 struct thread_options {
  56         int magic;
  57         uint64_t set_options[NR_OPTS_SZ];
  58         char *description;
  59         char *name;
  60         char *wait_for;
  61         char *directory;
  62         char *filename;
  63         char *filename_format;
  64         char *opendir;
  65         char *ioengine;
  66         char *ioengine_so_path;
  67         char *mmapfile;
  68         enum td_ddir td_ddir;
  69         unsigned int rw_seq;
  70         unsigned int kb_base;
  71         unsigned int unit_base;
  72         unsigned int ddir_seq_nr;
  73         long long ddir_seq_add;
  74         unsigned int iodepth;
  75         unsigned int iodepth_low;
  76         unsigned int iodepth_batch;
  77         unsigned int iodepth_batch_complete_min;
  78         unsigned int iodepth_batch_complete_max;
  79         unsigned int serialize_overlap;
  80
  81         unsigned int unique_filename;
  82
  83         unsigned long long size;
  84         unsigned long long io_size;
  85         unsigned int size_percent;
  86         unsigned int io_size_percent;
  87         unsigned int fill_device;
  88         unsigned int file_append;
  89         unsigned long long file_size_low;
  90         unsigned long long file_size_high;
  91         unsigned long long start_offset;
  92         unsigned long long start_offset_align;
  93
  94         unsigned long long bs[DDIR_RWDIR_CNT];
  95         unsigned long long ba[DDIR_RWDIR_CNT];
  96         unsigned long long min_bs[DDIR_RWDIR_CNT];
  97         unsigned long long max_bs[DDIR_RWDIR_CNT];
  98         struct bssplit *bssplit[DDIR_RWDIR_CNT];
  99         unsigned int bssplit_nr[DDIR_RWDIR_CNT];
 100
 101         int *ignore_error[ERROR_TYPE_CNT];
 102         unsigned int ignore_error_nr[ERROR_TYPE_CNT];
 103         unsigned int error_dump;
 104
 105         unsigned int nr_files;
 106         unsigned int open_files;
 107         enum file_lock_mode file_lock_mode;
 108
 109         unsigned int odirect;
 110         unsigned int oatomic;
 111         unsigned int invalidate_cache;
 112         unsigned int create_serialize;
 113         unsigned int create_fsync;
 114         unsigned int create_on_open;
 115         unsigned int create_only;
 116         unsigned int end_fsync;
 117         unsigned int pre_read;
 118         unsigned int sync_io;
 119         unsigned int write_hint;
 120         unsigned int verify;
 121         unsigned int do_verify;
 122         unsigned int verify_interval;
 123         unsigned int verify_offset;
 124         char verify_pattern[MAX_PATTERN_SIZE];
 125         unsigned int verify_pattern_bytes;
 126         struct pattern_fmt verify_fmt[8];
 127         unsigned int verify_fmt_sz;
 128         unsigned int verify_fatal;
 129         unsigned int verify_dump;
 130         unsigned int verify_async;
 131         unsigned long long verify_backlog;
 132         unsigned int verify_batch;
 133         unsigned int experimental_verify;
 134         unsigned int verify_state;
 135         unsigned int verify_state_save;
 136         unsigned int use_thread;
 137         unsigned int unlink;
 138         unsigned int unlink_each_loop;
 139         unsigned int do_disk_util;
 140         unsigned int override_sync;
 141         unsigned int rand_repeatable;
 142         unsigned int allrand_repeatable;
 143         unsigned long long rand_seed;
 144         unsigned int log_avg_msec;
 145         unsigned int log_hist_msec;
 146         unsigned int log_hist_coarseness;
 147         unsigned int log_max;
 148         unsigned int log_offset;
 149         unsigned int log_gz;
 150         unsigned int log_gz_store;
 151         unsigned int log_unix_epoch;
 152         unsigned int norandommap;
 153         unsigned int softrandommap;
 154         unsigned int bs_unaligned;
 155         unsigned int fsync_on_close;
 156         unsigned int bs_is_seq_rand;
 157
 158         unsigned int verify_only;
 159
 160         unsigned int random_distribution;
 161         unsigned int exitall_error;
 162
 163         struct zone_split *zone_split[DDIR_RWDIR_CNT];
 164         unsigned int zone_split_nr[DDIR_RWDIR_CNT];
 165
 166         fio_fp64_t zipf_theta;
 167         fio_fp64_t pareto_h;
 168         fio_fp64_t gauss_dev;
 169         fio_fp64_t random_center;
 170
 171         unsigned int random_generator;
 172
 173         unsigned int perc_rand[DDIR_RWDIR_CNT];
 174
 175         unsigned int hugepage_size;
 176         unsigned long long rw_min_bs;
 177         unsigned int thinktime;
 178         unsigned int thinktime_spin;
 179         unsigned int thinktime_blocks;
 180         unsigned int thinktime_blocks_type;
 181         unsigned int fsync_blocks;
 182         unsigned int fdatasync_blocks;
 183         unsigned int barrier_blocks;
 184         unsigned long long start_delay;
 185         unsigned long long start_delay_orig;
 186         unsigned long long start_delay_high;
 187         unsigned long long timeout;
 188         unsigned long long ramp_time;
 189         unsigned int ss_state;
 190         fio_fp64_t ss_limit;
 191         unsigned long long ss_dur;
 192         unsigned long long ss_ramp_time;
 193         unsigned int overwrite;
 194         unsigned int bw_avg_time;
 195         unsigned int iops_avg_time;
 196         unsigned int loops;
 197         unsigned long long zone_range;
 198         unsigned long long zone_size;
 199         unsigned long long zone_capacity;
 200         unsigned long long zone_skip;
 201         enum fio_zone_mode zone_mode;
 202         unsigned long long lockmem;
 203         enum fio_memtype mem_type;
 204         unsigned int mem_align;
 205
 206         unsigned long long max_latency;
 207
 208         unsigned int exit_what;
 209         unsigned int stonewall;
 210         unsigned int new_group;
 211         unsigned int numjobs;
 212         os_cpu_mask_t cpumask;
 213         os_cpu_mask_t verify_cpumask;
 214         os_cpu_mask_t log_gz_cpumask;
 215         unsigned int cpus_allowed_policy;
 216         char *numa_cpunodes;
 217         unsigned short numa_mem_mode;
 218         unsigned int numa_mem_prefer_node;
 219         char *numa_memnodes;
 220         unsigned int gpu_dev_id;
 221         unsigned int start_offset_percent;
 222
 223         unsigned int iolog;
 224         unsigned int rwmixcycle;
 225         unsigned int rwmix[DDIR_RWDIR_CNT];
 226         unsigned int nice;
 227         unsigned int ioprio;
 228         unsigned int ioprio_class;
 229         unsigned int file_service_type;
 230         unsigned int group_reporting;
 231         unsigned int stats;
 232         unsigned int fadvise_hint;
 233         enum fio_fallocate_mode fallocate_mode;
 234         unsigned int zero_buffers;
 235         unsigned int refill_buffers;
 236         unsigned int scramble_buffers;
 237         char buffer_pattern[MAX_PATTERN_SIZE];
 238         unsigned int buffer_pattern_bytes;
 239         unsigned int compress_percentage;
 240         unsigned int compress_chunk;
 241         unsigned int dedupe_percentage;
 242         unsigned int time_based;
 243         unsigned int disable_lat;
 244         unsigned int disable_clat;
 245         unsigned int disable_slat;
 246         unsigned int disable_bw;
 247         unsigned int unified_rw_rep;
 248         unsigned int gtod_reduce;
 249         unsigned int gtod_cpu;
 250         enum fio_cs clocksource;
 251         unsigned int no_stall;
 252         unsigned int trim_percentage;
 253         unsigned int trim_batch;
 254         unsigned int trim_zero;
 255         unsigned long long trim_backlog;
 256         unsigned int clat_percentiles;
 257         unsigned int slat_percentiles;
 258         unsigned int lat_percentiles;
 259         unsigned int percentile_precision;      /* digits after decimal for percentiles */
 260         fio_fp64_t percentile_list[FIO_IO_U_LIST_MAX_LEN];
 261
 262         char *read_iolog_file;
 263         bool read_iolog_chunked;
 264         char *write_iolog_file;
 265         char *merge_blktrace_file;
 266         fio_fp64_t merge_blktrace_scalars[FIO_IO_U_LIST_MAX_LEN];
 267         fio_fp64_t merge_blktrace_iters[FIO_IO_U_LIST_MAX_LEN];
 268
 269         unsigned int write_bw_log;
 270         unsigned int write_lat_log;
 271         unsigned int write_iops_log;
 272         unsigned int write_hist_log;
 273
 274         char *bw_log_file;
 275         char *lat_log_file;
 276         char *iops_log_file;
 277         char *hist_log_file;
 278         char *replay_redirect;
 279
 280         /*
 281          * Pre-run and post-run shell
 282          */
 283         char *exec_prerun;
 284         char *exec_postrun;
 285
 286         uint64_t rate[DDIR_RWDIR_CNT];
 287         uint64_t ratemin[DDIR_RWDIR_CNT];
 288         unsigned int ratecycle;
 289         unsigned int io_submit_mode;
 290         unsigned int rate_iops[DDIR_RWDIR_CNT];
 291         unsigned int rate_iops_min[DDIR_RWDIR_CNT];
 292         unsigned int rate_process;
 293         unsigned int rate_ign_think;
 294
 295         char *ioscheduler;
 296
 297         /*
 298          * I/O Error handling
 299          */
 300         enum error_type continue_on_error;
 301
 302         /*
 303          * Benchmark profile type
 304          */
 305         char *profile;
 306
 307         /*
 308          * blkio cgroup support
 309          */
 310         char *cgroup;
 311         unsigned int cgroup_weight;
 312         unsigned int cgroup_nodelete;
 313
 314         unsigned int uid;
 315         unsigned int gid;
 316
 317         unsigned int offset_increment_percent;
 318         unsigned long long offset_increment;
 319         unsigned long long number_ios;
 320
 321         unsigned int sync_file_range;
 322
 323         unsigned long long latency_target;
 324         unsigned long long latency_window;
 325         fio_fp64_t latency_percentile;
 326         uint32_t latency_run;
 327
 328         /*
 329          * flow support
 330          */
 331         int flow_id;
 332         unsigned int flow;
 333         unsigned int flow_sleep;
 334
 335         unsigned int sig_figs;
 336
 337         unsigned block_error_hist;
 338
 339         unsigned int replay_align;
 340         unsigned int replay_scale;
 341         unsigned int replay_time_scale;
 342         unsigned int replay_skip;
 343
 344         unsigned int per_job_logs;
 345
 346         unsigned int allow_create;
 347         unsigned int allow_mounted_write;
 348
 349         /* Parameters that affect zonemode=zbd */
 350         unsigned int read_beyond_wp;
 351         int max_open_zones;
 352         unsigned int job_max_open_zones;
 353         fio_fp64_t zrt;
 354         fio_fp64_t zrf;
 355 };
 356
 357 #define FIO_TOP_STR_MAX         256
 358
 359 struct thread_options_pack {
 360         uint64_t set_options[NR_OPTS_SZ];
 361         uint8_t description[FIO_TOP_STR_MAX];
 362         uint8_t name[FIO_TOP_STR_MAX];
 363         uint8_t wait_for[FIO_TOP_STR_MAX];
 364         uint8_t directory[FIO_TOP_STR_MAX];
 365         uint8_t filename[FIO_TOP_STR_MAX];
 366         uint8_t filename_format[FIO_TOP_STR_MAX];
 367         uint8_t opendir[FIO_TOP_STR_MAX];
 368         uint8_t ioengine[FIO_TOP_STR_MAX];
 369         uint8_t mmapfile[FIO_TOP_STR_MAX];
 370         uint32_t td_ddir;
 371         uint32_t rw_seq;
 372         uint32_t kb_base;
 373         uint32_t unit_base;
 374         uint32_t ddir_seq_nr;
 375         uint64_t ddir_seq_add;
 376         uint32_t iodepth;
 377         uint32_t iodepth_low;
 378         uint32_t iodepth_batch;
 379         uint32_t iodepth_batch_complete_min;
 380         uint32_t iodepth_batch_complete_max;
 381         uint32_t serialize_overlap;
 382         uint32_t pad;
 383
 384         uint64_t size;
 385         uint64_t io_size;
 386         uint32_t size_percent;
 387         uint32_t io_size_percent;
 388         uint32_t fill_device;
 389         uint32_t file_append;
 390         uint32_t unique_filename;
 391         uint64_t file_size_low;
 392         uint64_t file_size_high;
 393         uint64_t start_offset;
 394         uint64_t start_offset_align;
 395
 396         uint64_t bs[DDIR_RWDIR_CNT];
 397         uint64_t ba[DDIR_RWDIR_CNT];
 398         uint64_t min_bs[DDIR_RWDIR_CNT];
 399         uint64_t max_bs[DDIR_RWDIR_CNT];
 400         struct bssplit bssplit[DDIR_RWDIR_CNT][BSSPLIT_MAX];
 401         uint32_t bssplit_nr[DDIR_RWDIR_CNT];
 402
 403         uint32_t ignore_error[ERROR_TYPE_CNT][ERROR_STR_MAX];
 404         uint32_t ignore_error_nr[ERROR_TYPE_CNT];
 405         uint32_t error_dump;
 406
 407         uint32_t nr_files;
 408         uint32_t open_files;
 409         uint32_t file_lock_mode;
 410
 411         uint32_t odirect;
 412         uint32_t oatomic;
 413         uint32_t invalidate_cache;
 414         uint32_t create_serialize;
 415         uint32_t create_fsync;
 416         uint32_t create_on_open;
 417         uint32_t create_only;
 418         uint32_t end_fsync;
 419         uint32_t pre_read;
 420         uint32_t sync_io;
 421         uint32_t write_hint;
 422         uint32_t verify;
 423         uint32_t do_verify;
 424         uint32_t verify_interval;
 425         uint32_t verify_offset;
 426         uint8_t verify_pattern[MAX_PATTERN_SIZE];
 427         uint32_t verify_pattern_bytes;
 428         uint32_t verify_fatal;
 429         uint32_t verify_dump;
 430         uint32_t verify_async;
 431         uint64_t verify_backlog;
 432         uint32_t verify_batch;
 433         uint32_t experimental_verify;
 434         uint32_t verify_state;
 435         uint32_t verify_state_save;
 436         uint32_t use_thread;
 437         uint32_t unlink;
 438         uint32_t unlink_each_loop;
 439         uint32_t do_disk_util;
 440         uint32_t override_sync;
 441         uint32_t rand_repeatable;
 442         uint32_t allrand_repeatable;
 443         uint32_t pad2;
 444         uint64_t rand_seed;
 445         uint32_t log_avg_msec;
 446         uint32_t log_hist_msec;
 447         uint32_t log_hist_coarseness;
 448         uint32_t log_max;
 449         uint32_t log_offset;
 450         uint32_t log_gz;
 451         uint32_t log_gz_store;
 452         uint32_t log_unix_epoch;
 453         uint32_t norandommap;
 454         uint32_t softrandommap;
 455         uint32_t bs_unaligned;
 456         uint32_t fsync_on_close;
 457         uint32_t bs_is_seq_rand;
 458
 459         uint32_t random_distribution;
 460         uint32_t exitall_error;
 461
 462         uint32_t sync_file_range;
 463
 464         struct zone_split zone_split[DDIR_RWDIR_CNT][ZONESPLIT_MAX];
 465         uint32_t zone_split_nr[DDIR_RWDIR_CNT];
 466
 467         uint8_t pad1[4];
 468
 469         fio_fp64_t zipf_theta;
 470         fio_fp64_t pareto_h;
 471         fio_fp64_t gauss_dev;
 472         fio_fp64_t random_center;
 473
 474         uint32_t random_generator;
 475
 476         uint32_t perc_rand[DDIR_RWDIR_CNT];
 477
 478         uint32_t hugepage_size;
 479         uint64_t rw_min_bs;
 480         uint32_t thinktime;
 481         uint32_t thinktime_spin;
 482         uint32_t thinktime_blocks;
 483         uint32_t thinktime_blocks_type;
 484         uint32_t fsync_blocks;
 485         uint32_t fdatasync_blocks;
 486         uint32_t barrier_blocks;
 487         uint64_t start_delay;
 488         uint64_t start_delay_high;
 489         uint64_t timeout;
 490         uint64_t ramp_time;
 491         uint64_t ss_dur;
 492         uint64_t ss_ramp_time;
 493         uint32_t ss_state;
 494         fio_fp64_t ss_limit;
 495         uint32_t overwrite;
 496         uint32_t bw_avg_time;
 497         uint32_t iops_avg_time;
 498         uint32_t loops;
 499         uint64_t zone_range;
 500         uint64_t zone_size;
 501         uint64_t zone_capacity;
 502         uint64_t zone_skip;
 503         uint64_t lockmem;
 504         uint32_t mem_type;
 505         uint32_t mem_align;
 506
 507         uint32_t exit_what;
 508         uint32_t stonewall;
 509         uint32_t new_group;
 510         uint32_t numjobs;
 511
 512         uint8_t pad3[4];
 513
 514         /*
 515          * We currently can't convert these, so don't enable them
 516          */
 517 #if 0
 518         uint8_t cpumask[FIO_TOP_STR_MAX];
 519         uint8_t verify_cpumask[FIO_TOP_STR_MAX];
 520         uint8_t log_gz_cpumask[FIO_TOP_STR_MAX];
 521 #endif
 522         uint32_t gpu_dev_id;
 523         uint32_t start_offset_percent;
 524         uint32_t cpus_allowed_policy;
 525         uint32_t iolog;
 526         uint32_t rwmixcycle;
 527         uint32_t rwmix[DDIR_RWDIR_CNT];
 528         uint32_t nice;
 529         uint32_t ioprio;
 530         uint32_t ioprio_class;
 531         uint32_t file_service_type;
 532         uint32_t group_reporting;
 533         uint32_t stats;
 534         uint32_t fadvise_hint;
 535         uint32_t fallocate_mode;
 536         uint32_t zero_buffers;
 537         uint32_t refill_buffers;
 538         uint32_t scramble_buffers;
 539         uint8_t buffer_pattern[MAX_PATTERN_SIZE];
 540         uint32_t buffer_pattern_bytes;
 541         uint32_t compress_percentage;
 542         uint32_t compress_chunk;
 543         uint32_t dedupe_percentage;
 544         uint32_t time_based;
 545         uint32_t disable_lat;
 546         uint32_t disable_clat;
 547         uint32_t disable_slat;
 548         uint32_t disable_bw;
 549         uint32_t unified_rw_rep;
 550         uint32_t gtod_reduce;
 551         uint32_t gtod_cpu;
 552         uint32_t clocksource;
 553         uint32_t no_stall;
 554         uint32_t trim_percentage;
 555         uint32_t trim_batch;
 556         uint32_t trim_zero;
 557         uint64_t trim_backlog;
 558         uint32_t clat_percentiles;
 559         uint32_t lat_percentiles;
 560         uint32_t slat_percentiles;
 561         uint32_t percentile_precision;
 562         fio_fp64_t percentile_list[FIO_IO_U_LIST_MAX_LEN];
 563
 564         uint8_t read_iolog_file[FIO_TOP_STR_MAX];
 565         uint8_t write_iolog_file[FIO_TOP_STR_MAX];
 566         uint8_t merge_blktrace_file[FIO_TOP_STR_MAX];
 567         fio_fp64_t merge_blktrace_scalars[FIO_IO_U_LIST_MAX_LEN];
 568         fio_fp64_t merge_blktrace_iters[FIO_IO_U_LIST_MAX_LEN];
 569
 570         uint32_t write_bw_log;
 571         uint32_t write_lat_log;
 572         uint32_t write_iops_log;
 573         uint32_t write_hist_log;
 574
 575         uint8_t bw_log_file[FIO_TOP_STR_MAX];
 576         uint8_t lat_log_file[FIO_TOP_STR_MAX];
 577         uint8_t iops_log_file[FIO_TOP_STR_MAX];
 578         uint8_t hist_log_file[FIO_TOP_STR_MAX];
 579         uint8_t replay_redirect[FIO_TOP_STR_MAX];
 580
 581         /*
 582          * Pre-run and post-run shell
 583          */
 584         uint8_t exec_prerun[FIO_TOP_STR_MAX];
 585         uint8_t exec_postrun[FIO_TOP_STR_MAX];
 586
 587         uint64_t rate[DDIR_RWDIR_CNT];
 588         uint64_t ratemin[DDIR_RWDIR_CNT];
 589         uint32_t ratecycle;
 590         uint32_t io_submit_mode;
 591         uint32_t rate_iops[DDIR_RWDIR_CNT];
 592         uint32_t rate_iops_min[DDIR_RWDIR_CNT];
 593         uint32_t rate_process;
 594         uint32_t rate_ign_think;
 595
 596         uint8_t ioscheduler[FIO_TOP_STR_MAX];
 597
 598         /*
 599          * I/O Error handling
 600          */
 601         uint32_t continue_on_error;
 602
 603         /*
 604          * Benchmark profile type
 605          */
 606         uint8_t profile[FIO_TOP_STR_MAX];
 607
 608         /*
 609          * blkio cgroup support
 610          */
 611         uint8_t cgroup[FIO_TOP_STR_MAX];
 612         uint32_t cgroup_weight;
 613         uint32_t cgroup_nodelete;
 614
 615         uint32_t uid;
 616         uint32_t gid;
 617
 618         uint32_t offset_increment_percent;
 619         uint64_t offset_increment;
 620         uint64_t number_ios;
 621
 622         uint64_t latency_target;
 623         uint64_t latency_window;
 624         uint64_t max_latency;
 625         fio_fp64_t latency_percentile;
 626         uint32_t latency_run;
 627
 628         /*
 629          * flow support
 630          */
 631         int32_t flow_id;
 632         uint32_t flow;
 633         uint32_t flow_sleep;
 634
 635         uint32_t sig_figs;
 636
 637         uint32_t block_error_hist;
 638
 639         uint32_t replay_align;
 640         uint32_t replay_scale;
 641         uint32_t replay_time_scale;
 642         uint32_t replay_skip;
 643
 644         uint32_t per_job_logs;
 645
 646         uint32_t allow_create;
 647         uint32_t allow_mounted_write;
 648
 649         uint32_t zone_mode;
 650 } __attribute__((packed));
 651
 652 extern void convert_thread_options_to_cpu(struct thread_options *o, struct thread_options_pack *top);
 653 extern void convert_thread_options_to_net(struct thread_options_pack *top, struct thread_options *);
 654 extern int fio_test_cconv(struct thread_options *);
 655 extern void options_default_fill(struct thread_options *o);
 656
 657 #endif