• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 #ifndef FIO_PARSE_H
2 #define FIO_PARSE_H
3 
4 #include <inttypes.h>
5 #include "flist.h"
6 
7 /*
8  * Option types
9  */
10 enum fio_opt_type {
11 	FIO_OPT_INVALID = 0,
12 	FIO_OPT_STR,
13 	FIO_OPT_STR_MULTI,
14 	FIO_OPT_STR_VAL,
15 	FIO_OPT_STR_VAL_TIME,
16 	FIO_OPT_STR_STORE,
17 	FIO_OPT_RANGE,
18 	FIO_OPT_INT,
19 	FIO_OPT_BOOL,
20 	FIO_OPT_FLOAT_LIST,
21 	FIO_OPT_STR_SET,
22 	FIO_OPT_DEPRECATED,
23 	FIO_OPT_UNSUPPORTED,
24 };
25 
26 /*
27  * Match a possible value string with the integer option.
28  */
29 struct value_pair {
30 	const char *ival;		/* string option */
31 	unsigned int oval;		/* output value */
32 	const char *help;		/* help text for sub option */
33 	int orval;			/* OR value */
34 	void *cb;			/* sub-option callback */
35 };
36 
37 #define OPT_LEN_MAX 	4096
38 #define PARSE_MAX_VP	24
39 
40 /*
41  * Option define
42  */
43 struct fio_option {
44 	const char *name;		/* option name */
45 	const char *lname;		/* long option name */
46 	const char *alias;		/* possible old allowed name */
47 	enum fio_opt_type type;		/* option type */
48 	unsigned int off1;		/* potential parameters */
49 	unsigned int off2;
50 	unsigned int off3;
51 	unsigned int off4;
52 	unsigned int off5;
53 	unsigned int off6;
54 	unsigned int maxval;		/* max and min value */
55 	int minval;
56 	double maxfp;			/* max and min floating value */
57 	double minfp;
58 	unsigned int interval;		/* client hint for suitable interval */
59 	unsigned int maxlen;		/* max length */
60 	int neg;			/* negate value stored */
61 	int prio;
62 	void *cb;			/* callback */
63 	const char *help;		/* help text for option */
64 	const char *def;		/* default setting */
65 	struct value_pair posval[PARSE_MAX_VP];/* possible values */
66 	const char *parent;		/* parent option */
67 	int hide;			/* hide if parent isn't set */
68 	int hide_on_set;		/* hide on set, not on unset */
69 	const char *inverse;		/* if set, apply opposite action to this option */
70 	struct fio_option *inv_opt;	/* cached lookup */
71 	int (*verify)(struct fio_option *, void *);
72 	const char *prof_name;		/* only valid for specific profile */
73 	void *prof_opts;
74 	uint64_t category;		/* what type of option */
75 	uint64_t group;			/* who to group with */
76 	void *gui_data;
77 	int is_seconds;			/* time value with seconds base */
78 	int is_time;			/* time based value */
79 	int no_warn_def;
80 	int pow2;			/* must be a power-of-2 */
81 };
82 
83 extern int parse_option(char *, const char *, struct fio_option *, struct fio_option **, void *, struct flist_head *);
84 extern void sort_options(char **, struct fio_option *, int);
85 extern int parse_cmd_option(const char *t, const char *l, struct fio_option *, void *, struct flist_head *);
86 extern int show_cmd_help(struct fio_option *, const char *);
87 extern void fill_default_options(void *, struct fio_option *);
88 extern void options_init(struct fio_option *);
89 extern void options_mem_dupe(struct fio_option *, void *);
90 extern void options_free(struct fio_option *, void *);
91 
92 extern void strip_blank_front(char **);
93 extern void strip_blank_end(char *);
94 extern int str_to_decimal(const char *, long long *, int, void *, int, int);
95 extern int check_str_bytes(const char *p, long long *val, void *data);
96 extern int check_str_time(const char *p, long long *val, int);
97 extern int str_to_float(const char *str, double *val, int is_time);
98 
99 extern int string_distance(const char *s1, const char *s2);
100 extern int string_distance_ok(const char *s1, int dist);
101 
102 /*
103  * Handlers for the options
104  */
105 typedef int (fio_opt_str_fn)(void *, const char *);
106 typedef int (fio_opt_str_val_fn)(void *, long long *);
107 typedef int (fio_opt_int_fn)(void *, int *);
108 
109 struct thread_options;
td_var(void * to,struct fio_option * o,unsigned int offset)110 static inline void *td_var(void *to, struct fio_option *o, unsigned int offset)
111 {
112 	void *ret;
113 
114 	if (o->prof_opts)
115 		ret = o->prof_opts;
116 	else
117 		ret = to;
118 
119 	return (char *) ret + offset;
120 }
121 
parse_is_percent(unsigned long long val)122 static inline int parse_is_percent(unsigned long long val)
123 {
124 	return val <= -1ULL && val >= (-1ULL - 100ULL);
125 }
126 
127 struct print_option {
128 	struct flist_head list;
129 	char *name;
130 	char *value;
131 };
132 
133 #endif
134