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