genfio: Use dynamic default values in help
[fio.git] / fio.h
CommitLineData
ebac4655
JA
1#ifndef FIO_H
2#define FIO_H
3
4#include <sched.h>
5#include <limits.h>
6#include <pthread.h>
7#include <sys/time.h>
8#include <sys/resource.h>
3c39a379
JA
9#include <errno.h>
10#include <stdlib.h>
11#include <stdio.h>
6d6f031f 12#include <unistd.h>
34cfcdaf 13#include <string.h>
cd14cc10 14#include <inttypes.h>
7101d9c2 15#include <assert.h>
ebac4655 16
317b95d0 17#include "compiler/compiler.h"
8062f527 18#include "thread_options.h"
01743ee1 19#include "flist.h"
e2887563 20#include "fifo.h"
317b95d0
JA
21#include "arch/arch.h"
22#include "os/os.h"
07739b57 23#include "mutex.h"
a3d741fa
JA
24#include "log.h"
25#include "debug.h"
d6aed795
JA
26#include "file.h"
27#include "io_ddir.h"
dcefb588 28#include "ioengine.h"
5995a6a4 29#include "iolog.h"
c5c8bd5c 30#include "helpers.h"
07b3232d 31#include "options.h"
7eb36574 32#include "profile.h"
c223da83 33#include "time.h"
a7346816 34#include "gettime.h"
bf2e821a 35#include "lib/getopt.h"
2615cc4b 36#include "lib/rand.h"
7fb6d453 37#include "lib/rbtree.h"
dd366728 38#include "client.h"
37db14fe 39#include "server.h"
a64e88da 40#include "stat.h"
9e684a49 41#include "flow.h"
2ae0b204 42#include "io_u_queue.h"
ebac4655 43
4700b234 44#ifdef CONFIG_SOLARISAIO
417f0068
JA
45#include <sys/asynch.h>
46#endif
47
67bf9823 48#ifdef CONFIG_LIBNUMA
d0b937ed
YR
49#include <linux/mempolicy.h>
50#include <numa.h>
51
52/*
53 * "local" is pseudo-policy
54 */
55#define MPOL_LOCAL MPOL_MAX
56#endif
57
38dad62d
JA
58/*
59 * offset generator types
60 */
61enum {
62 RW_SEQ_SEQ = 0,
63 RW_SEQ_IDENT,
64};
65
d72be545
JA
66enum {
67 TD_F_VER_BACKLOG = 1,
68 TD_F_TRIM_BACKLOG = 2,
69 TD_F_READ_IOLOG = 4,
70 TD_F_REFILL_BUFFERS = 8,
71 TD_F_SCRAMBLE_BUFFERS = 16,
72 TD_F_VER_NONE = 32,
73 TD_F_PROFILE_OPS = 64,
74};
75
d24945f0
JA
76enum {
77 FIO_RAND_BS_OFF = 0,
78 FIO_RAND_VER_OFF,
79 FIO_RAND_MIX_OFF,
80 FIO_RAND_FILE_OFF,
81 FIO_RAND_BLOCK_OFF,
82 FIO_RAND_FILE_SIZE_OFF,
83 FIO_RAND_TRIM_OFF,
84 FIO_RAND_BUF_OFF,
211c9b89 85 FIO_RAND_SEQ_RAND_OFF,
d24945f0
JA
86 FIO_RAND_NR_OFFS,
87};
88
2dc1bbeb
JA
89/*
90 * This describes a single thread/process executing a fio job.
91 */
92struct thread_data {
93 struct thread_options o;
d72be545 94 unsigned long flags;
de890a1e 95 void *eo;
e4e33258 96 char verror[FIO_VERROR_SIZE];
2dc1bbeb 97 pthread_t thread;
2f122b13
JA
98 unsigned int thread_number;
99 unsigned int groupid;
2dc1bbeb 100 struct thread_stat ts;
7b9f733a 101
46bcd498
JA
102 int client_type;
103
7b9f733a
JA
104 struct io_log *slat_log;
105 struct io_log *clat_log;
106 struct io_log *lat_log;
107 struct io_log *bw_log;
c8eeb9df 108 struct io_log *iops_log;
7b9f733a 109
6eaf09d6 110 uint64_t stat_io_bytes[DDIR_RWDIR_CNT];
c8eeb9df
JA
111 struct timeval bw_sample_time;
112
6eaf09d6 113 uint64_t stat_io_blocks[DDIR_RWDIR_CNT];
c8eeb9df 114 struct timeval iops_sample_time;
f0505a14 115
c97f1ad6
JA
116 volatile int update_rusage;
117 struct fio_mutex *rusage_sem;
c8aaba19
JA
118 struct rusage ru_start;
119 struct rusage ru_end;
120
126d65c6 121 struct fio_file **files;
d7df1d13 122 unsigned char *file_locks;
dd87b2c9 123 unsigned int files_size;
2dc1bbeb
JA
124 unsigned int files_index;
125 unsigned int nr_open_files;
1020a139 126 unsigned int nr_done_files;
2dc1bbeb
JA
127 unsigned int nr_normal_files;
128 union {
129 unsigned int next_file;
130 os_random_state_t next_file_state;
4c07ad86 131 struct frand_state __next_file_state;
2dc1bbeb
JA
132 };
133 int error;
a5e371a6 134 int sig;
20e354ef 135 int done;
2dc1bbeb
JA
136 pid_t pid;
137 char *orig_buffer;
138 size_t orig_buffer_size;
139 volatile int terminate;
140 volatile int runstate;
2dc1bbeb 141 unsigned int last_was_sync;
9e144189 142 enum fio_ddir last_ddir;
2dc1bbeb 143
2dc1bbeb
JA
144 int mmapfd;
145
843a7413
JA
146 void *iolog_buf;
147 FILE *iolog_f;
ebac4655 148
da86774e 149 char *sysfs_root;
da86774e 150
d24945f0 151 unsigned long rand_seeds[FIO_RAND_NR_OFFS];
5bfc35d7 152
4c07ad86
JA
153 union {
154 os_random_state_t bsrange_state;
155 struct frand_state __bsrange_state;
156 };
157 union {
158 os_random_state_t verify_state;
159 struct frand_state __verify_state;
160 };
161 union {
162 os_random_state_t trim_state;
163 struct frand_state __trim_state;
164 };
ebac4655 165
3545a109
JA
166 struct frand_state buf_state;
167
9e144189 168 unsigned int verify_batch;
0d29de83 169 unsigned int trim_batch;
9e144189 170
ebac4655
JA
171 int shm_id;
172
e9c047a0
JA
173 /*
174 * IO engine hooks, contains everything needed to submit an io_u
175 * to any of the available IO engines.
176 */
2866c82d 177 struct ioengine_ops *io_ops;
ebac4655 178
e9c047a0 179 /*
422f9e4b 180 * Queue depth of io_u's that fio MIGHT do
e9c047a0 181 */
ebac4655 182 unsigned int cur_depth;
422f9e4b
RM
183
184 /*
185 * io_u's about to be committed
186 */
d8005759 187 unsigned int io_u_queued;
422f9e4b
RM
188
189 /*
190 * io_u's submitted but not completed yet
191 */
192 unsigned int io_u_in_flight;
193
194 /*
195 * List of free and busy io_u's
196 */
2ae0b204
JA
197 struct io_u_ring io_u_requeues;
198 struct io_u_queue io_u_freelist;
199 struct io_u_queue io_u_all;
e8462bd8
JA
200 pthread_mutex_t io_u_lock;
201 pthread_cond_t free_cond;
202
203 /*
204 * async verify offload
205 */
206 struct flist_head verify_list;
207 pthread_t *verify_threads;
208 unsigned int nr_verify_threads;
209 pthread_cond_t verify_cond;
210 int verify_thread_exit;
ebac4655 211
e9c047a0
JA
212 /*
213 * Rate state
214 */
bdb6d20a 215 uint64_t rate_bps[DDIR_RWDIR_CNT];
6eaf09d6
SL
216 long rate_pending_usleep[DDIR_RWDIR_CNT];
217 unsigned long rate_bytes[DDIR_RWDIR_CNT];
218 unsigned long rate_blocks[DDIR_RWDIR_CNT];
219 struct timeval lastrate[DDIR_RWDIR_CNT];
ebac4655 220
bdb6d20a
JA
221 uint64_t total_io_size;
222 uint64_t fill_device_size;
ebac4655 223
6eaf09d6 224 unsigned long io_issues[DDIR_RWDIR_CNT];
bdb6d20a
JA
225 uint64_t io_blocks[DDIR_RWDIR_CNT];
226 uint64_t this_io_blocks[DDIR_RWDIR_CNT];
227 uint64_t io_bytes[DDIR_RWDIR_CNT];
228 uint64_t io_skip_bytes;
229 uint64_t this_io_bytes[DDIR_RWDIR_CNT];
230 uint64_t zone_bytes;
cdd18ad8 231 struct fio_mutex *mutex;
ebac4655 232
e9c047a0
JA
233 /*
234 * State for random io, a bitmap of blocks done vs not done
235 */
4c07ad86
JA
236 union {
237 os_random_state_t random_state;
238 struct frand_state __random_state;
239 };
ebac4655 240
ebac4655
JA
241 struct timeval start; /* start of this loop */
242 struct timeval epoch; /* time job was started */
a61eddec 243 struct timeval last_issue;
993bf48b
JA
244 struct timeval tv_cache;
245 unsigned int tv_cache_nr;
246 unsigned int tv_cache_mask;
721938ae 247 unsigned int ramp_time_over;
ebac4655 248
e9c047a0
JA
249 /*
250 * read/write mixed workload state
251 */
4c07ad86
JA
252 union {
253 os_random_state_t rwmix_state;
254 struct frand_state __rwmix_state;
255 };
e4928662 256 unsigned long rwmix_issues;
e9c047a0 257 enum fio_ddir rwmix_ddir;
5736c10d 258 unsigned int ddir_seq_nr;
a6ccc7be 259
211c9b89
JA
260 /*
261 * rand/seq mixed workload state
262 */
263 union {
264 os_random_state_t seq_rand_state;
265 struct frand_state __seq_rand_state;
266 };
267
e9c047a0 268 /*
8de8f047
JA
269 * IO history logs for verification. We use a tree for sorting,
270 * if we are overwriting. Otherwise just use a fifo.
e9c047a0 271 */
4b87898e 272 struct rb_root io_hist_tree;
01743ee1 273 struct flist_head io_hist_list;
9e144189 274 unsigned long io_hist_len;
8de8f047
JA
275
276 /*
277 * For IO replaying
278 */
01743ee1 279 struct flist_head io_log_list;
433afcb4 280
0d29de83
JA
281 /*
282 * For tracking/handling discards
283 */
284 struct flist_head trim_list;
285 unsigned long trim_entries;
286
1ae83d45
JA
287 struct flist_head next_rand_list;
288
1907dbc6
JA
289 /*
290 * for fileservice, how often to switch to a new file
291 */
292 unsigned int file_service_nr;
293 unsigned int file_service_left;
294 struct fio_file *file_service_file;
9c60ce64 295
44f29692
JA
296 unsigned int sync_file_range_nr;
297
9c60ce64
JA
298 /*
299 * For generating file sizes
300 */
4c07ad86
JA
301 union {
302 os_random_state_t file_size_state;
303 struct frand_state __file_size_state;
304 };
f2bba182
RR
305
306 /*
307 * Error counts
308 */
309 unsigned int total_err_count;
310 int first_error;
15dc1934 311
9e684a49
DE
312 struct fio_flow *flow;
313
15dc1934
JA
314 /*
315 * Can be overloaded by profiles
316 */
7eb36574 317 struct prof_io_ops prof_io_ops;
58c55ba0 318 void *prof_data;
9a3f1100
JA
319
320 void *pinned_mem;
ebac4655
JA
321};
322
e592a06b
AC
323/*
324 * when should interactive ETA output be generated
325 */
326enum {
327 FIO_ETA_AUTO,
328 FIO_ETA_ALWAYS,
329 FIO_ETA_NEVER,
330};
331
e1161c32 332#define __td_verror(td, err, msg, func) \
ebac4655 333 do { \
59358c8e 334 int e = (err); \
19abcd3d
JA
335 if ((td)->error) \
336 break; \
ebac4655 337 (td)->error = e; \
f2bba182 338 if (!(td)->first_error) \
98ffb8f3 339 snprintf(td->verror, sizeof(td->verror), "file:%s:%d, func=%s, error=%s", __FILE__, __LINE__, (func), (msg)); \
ebac4655
JA
340 } while (0)
341
b990b5c0 342
f2bba182
RR
343#define td_clear_error(td) \
344 (td)->error = 0;
e1161c32
JA
345#define td_verror(td, err, func) \
346 __td_verror((td), (err), strerror((err)), (func))
347#define td_vmsg(td, err, msg, func) \
348 __td_verror((td), (err), (msg), (func))
b990b5c0 349
81179eec
JA
350#define __fio_stringify_1(x) #x
351#define __fio_stringify(x) __fio_stringify_1(x)
352
ebac4655 353extern int exitall_on_terminate;
11e950bd 354extern unsigned int thread_number;
108fea77 355extern unsigned int stat_number;
ebac4655
JA
356extern int shm_id;
357extern int groupid;
f3afa57e 358extern int output_format;
53cdc686 359extern int temp_stall_ts;
7078106d 360extern uintptr_t page_mask, page_size;
4241ea8f 361extern int read_only;
e592a06b 362extern int eta_print;
e382e661 363extern int eta_new_line;
d3eeeabc 364extern unsigned long done_secs;
01f06b63 365extern char *job_section;
be4ecfdf
JA
366extern int fio_gtod_offload;
367extern int fio_gtod_cpu;
c223da83 368extern enum fio_cs fio_clock_source;
fa80feae 369extern int fio_clock_source_set;
a9523c6f 370extern int warnings_fatal;
f57a9c59 371extern int terse_version;
5c341e9a 372extern int is_backend;
a37f69b7 373extern int nr_clients;
e46d8091 374extern int log_syslog;
06464907 375extern int status_interval;
5e726d0a 376extern const char fio_version_string[];
ebac4655
JA
377
378extern struct thread_data *threads;
379
7101d9c2
JA
380static inline void fio_ro_check(struct thread_data *td, struct io_u *io_u)
381{
382 assert(!(io_u->ddir == DDIR_WRITE && !td_write(td)));
383}
384
fca70358 385#define REAL_MAX_JOBS 2048
ebac4655 386
87dc1ab1
JA
387static inline int should_fsync(struct thread_data *td)
388{
389 if (td->last_was_sync)
390 return 0;
2dc1bbeb 391 if (td_write(td) || td_rw(td) || td->o.override_sync)
87dc1ab1
JA
392 return 1;
393
394 return 0;
395}
396
8914a9d8 397/*
214e1eca 398 * Init/option functions
8914a9d8 399 */
0420ba6a 400extern int __must_check fio_init_options(void);
72cb971b 401extern int __must_check parse_options(int, char **);
46bcd498
JA
402extern int parse_jobs_ini(char *, int, int, int);
403extern int parse_cmd_line(int, char **, int);
2e1df07d 404extern int fio_backend(void);
50d16976 405extern void reset_fio_state(void);
2e1df07d 406extern void clear_io_state(struct thread_data *);
3b8b7135 407extern int fio_options_parse(struct thread_data *, char **, int);
74929ac2 408extern void fio_keywords_init(void);
214e1eca 409extern int fio_cmd_option_parse(struct thread_data *, const char *, char *);
de890a1e 410extern int fio_cmd_ioengine_option_parse(struct thread_data *, const char *, char *);
214e1eca
JA
411extern void fio_fill_default_options(struct thread_data *);
412extern int fio_show_option_help(const char *);
de890a1e 413extern void fio_options_set_ioengine_opts(struct option *long_options, struct thread_data *td);
214e1eca 414extern void fio_options_dup_and_init(struct option *);
de890a1e
SL
415extern void fio_options_mem_dupe(struct thread_data *);
416extern void options_mem_dupe(void *data, struct fio_option *options);
5bfc35d7 417extern void td_fill_rand_seeds(struct thread_data *);
46bcd498 418extern void add_job_opts(const char **, int);
73798eb2 419extern char *num2str(unsigned long, int, int, int, int);
de890a1e 420extern int ioengine_load(struct thread_data *);
1ec3d69b 421
a569b45f
JA
422extern uintptr_t page_mask;
423extern uintptr_t page_size;
424extern int initialize_fio(char *envp[]);
425
de890a1e
SL
426#define FIO_GETOPT_JOB 0x89000000
427#define FIO_GETOPT_IOENGINE 0x98000000
07b3232d 428#define FIO_NR_OPTIONS (FIO_MAX_OPTS + 128)
8914a9d8 429
263e529f
JA
430/*
431 * ETA/status stuff
432 */
433extern void print_thread_status(void);
434extern void print_status_init(int);
0a428b23 435extern char *fio_uint_to_kmg(unsigned int val);
263e529f
JA
436
437/*
438 * Thread life cycle. Once a thread has a runstate beyond TD_INITIALIZED, it
439 * will never back again. It may cycle between running/verififying/fsyncing.
440 * Once the thread reaches TD_EXITED, it is just waiting for the core to
441 * reap it.
442 */
443enum {
444 TD_NOT_CREATED = 0,
445 TD_CREATED,
446 TD_INITIALIZED,
b29ee5b3 447 TD_RAMP,
36d80bc7 448 TD_SETTING_UP,
263e529f 449 TD_RUNNING,
b0f65863 450 TD_PRE_READING,
263e529f
JA
451 TD_VERIFYING,
452 TD_FSYNCING,
453 TD_EXITED,
454 TD_REAPED,
455};
456
b29ee5b3 457extern void td_set_runstate(struct thread_data *, int);
cc0df00a
JA
458#define TERMINATE_ALL (-1)
459extern void fio_terminate_threads(int);
b29ee5b3 460
2f9ade3c
JA
461/*
462 * Memory helpers
463 */
9a3f1100
JA
464extern int __must_check fio_pin_memory(struct thread_data *);
465extern void fio_unpin_memory(struct thread_data *);
b2fdda43 466extern int __must_check allocate_io_mem(struct thread_data *);
2f9ade3c 467extern void free_io_mem(struct thread_data *);
2bb3f0a7 468extern void free_threads_shm(void);
2f9ade3c 469
b29ee5b3
JA
470/*
471 * Reset stats after ramp time completes
472 */
473extern void reset_all_stats(struct thread_data *);
474
fb7b71a3
JA
475/*
476 * blktrace support
477 */
5e62c22a 478#ifdef FIO_HAVE_BLKTRACE
fb7b71a3
JA
479extern int is_blktrace(const char *);
480extern int load_blktrace(struct thread_data *, const char *);
5e62c22a 481#endif
fb7b71a3 482
34572e28
JA
483#define for_each_td(td, i) \
484 for ((i) = 0, (td) = &threads[0]; (i) < (int) thread_number; (i)++, (td)++)
53cdc686 485#define for_each_file(td, f, i) \
691c8fb0
JA
486 if ((td)->files_index) \
487 for ((i) = 0, (f) = (td)->files[0]; \
488 (i) < (td)->o.nr_files && ((f) = (td)->files[i]) != NULL; \
489 (i)++)
53cdc686 490
0032bf9f
JA
491#define fio_assert(td, cond) do { \
492 if (!(cond)) { \
340fd243 493 int *__foo = NULL; \
0032bf9f 494 fprintf(stderr, "file:%s:%d, assert %s failed\n", __FILE__, __LINE__, #cond); \
ac18ea38 495 td_set_runstate((td), TD_EXITED); \
437c9b71 496 (td)->error = EFAULT; \
340fd243 497 *__foo = 0; \
0032bf9f
JA
498 } \
499} while (0)
500
12d9d841
JA
501static inline int fio_fill_issue_time(struct thread_data *td)
502{
503 if (td->o.read_iolog_file ||
504 !td->o.disable_clat || !td->o.disable_slat || !td->o.disable_bw)
505 return 1;
506
507 return 0;
508}
509
581e7141
JA
510static inline int __should_check_rate(struct thread_data *td,
511 enum fio_ddir ddir)
512{
513 struct thread_options *o = &td->o;
514
515 /*
516 * If some rate setting was given, we need to check it
517 */
518 if (o->rate[ddir] || o->ratemin[ddir] || o->rate_iops[ddir] ||
519 o->rate_iops_min[ddir])
520 return 1;
521
522 return 0;
523}
524
525static inline int should_check_rate(struct thread_data *td,
aa83321f 526 uint64_t *bytes_done)
581e7141
JA
527{
528 int ret = 0;
529
6eaf09d6
SL
530 if (bytes_done[DDIR_READ])
531 ret |= __should_check_rate(td, DDIR_READ);
532 if (bytes_done[DDIR_WRITE])
533 ret |= __should_check_rate(td, DDIR_WRITE);
534 if (bytes_done[DDIR_TRIM])
535 ret |= __should_check_rate(td, DDIR_TRIM);
581e7141
JA
536
537 return ret;
538}
539
74f4b020
JA
540static inline unsigned int td_max_bs(struct thread_data *td)
541{
542 unsigned int max_bs;
543
544 max_bs = max(td->o.max_bs[DDIR_READ], td->o.max_bs[DDIR_WRITE]);
545 return max(td->o.max_bs[DDIR_TRIM], max_bs);
546}
547
8d916c94
JA
548static inline unsigned int td_min_bs(struct thread_data *td)
549{
550 unsigned int min_bs;
551
552 min_bs = min(td->o.min_bs[DDIR_READ], td->o.min_bs[DDIR_WRITE]);
553 return min(td->o.min_bs[DDIR_TRIM], min_bs);
554}
555
d529ee19
JA
556static inline int is_power_of_2(unsigned int val)
557{
558 return (val != 0 && ((val & (val - 1)) == 0));
559}
560
e8462bd8
JA
561/*
562 * We currently only need to do locking if we have verifier threads
563 * accessing our internal structures too
564 */
565static inline void td_io_u_lock(struct thread_data *td)
566{
567 if (td->o.verify_async)
568 pthread_mutex_lock(&td->io_u_lock);
569}
570
571static inline void td_io_u_unlock(struct thread_data *td)
572{
573 if (td->o.verify_async)
574 pthread_mutex_unlock(&td->io_u_lock);
575}
576
577static inline void td_io_u_free_notify(struct thread_data *td)
578{
579 if (td->o.verify_async)
580 pthread_cond_signal(&td->free_cond);
581}
582
cca84643
JA
583extern const char *fio_get_arch_string(int);
584extern const char *fio_get_os_string(int);
585
05775438
JA
586#define ARRAY_SIZE(x) (sizeof((x)) / (sizeof((x)[0])))
587
f3afa57e
JA
588enum {
589 FIO_OUTPUT_TERSE = 0,
590 FIO_OUTPUT_JSON,
591 FIO_OUTPUT_NORMAL,
592};
593
e25839d4
JA
594enum {
595 FIO_RAND_DIST_RANDOM = 0,
596 FIO_RAND_DIST_ZIPF,
925fee33 597 FIO_RAND_DIST_PARETO,
e25839d4
JA
598};
599
8055e41d
JA
600enum {
601 FIO_RAND_GEN_TAUSWORTHE = 0,
602 FIO_RAND_GEN_LFSR,
603};
604
ebac4655 605#endif