Group options into categories
[fio.git] / parse.h
... / ...
CommitLineData
1#ifndef FIO_PARSE_H
2#define FIO_PARSE_H
3
4#include "flist.h"
5
6/*
7 * Option types
8 */
9enum fio_opt_type {
10 FIO_OPT_INVALID = 0,
11 FIO_OPT_STR,
12 FIO_OPT_STR_MULTI,
13 FIO_OPT_STR_VAL,
14 FIO_OPT_STR_VAL_TIME,
15 FIO_OPT_STR_STORE,
16 FIO_OPT_RANGE,
17 FIO_OPT_INT,
18 FIO_OPT_BOOL,
19 FIO_OPT_FLOAT_LIST,
20 FIO_OPT_STR_SET,
21 FIO_OPT_DEPRECATED,
22};
23
24/*
25 * Match a possible value string with the integer option.
26 */
27struct value_pair {
28 const char *ival; /* string option */
29 unsigned int oval; /* output value */
30 const char *help; /* help text for sub option */
31 int or; /* OR value */
32 void *cb; /* sub-option callback */
33};
34
35#define OPT_LEN_MAX 4096
36#define PARSE_MAX_VP 16
37
38enum opt_category {
39 FIO_OPT_G_DESC = 1UL << 0,
40 FIO_OPT_G_FILE = 1UL << 1,
41 FIO_OPT_G_MISC = 1UL << 2,
42 FIO_OPT_G_IO = 1UL << 3,
43 FIO_OPT_G_IO_DDIR = 1UL << 4,
44 FIO_OPT_G_IO_BUF = 1UL << 5,
45 FIO_OPT_G_RAND = 1UL << 6,
46 FIO_OPT_G_OS = 1UL << 7,
47 FIO_OPT_G_MEM = 1UL << 8,
48 FIO_OPT_G_VERIFY = 1UL << 9,
49 FIO_OPT_G_CPU = 1UL << 10,
50 FIO_OPT_G_LOG = 1UL << 11,
51 FIO_OPT_G_ZONE = 1UL << 12,
52 FIO_OPT_G_CACHE = 1UL << 13,
53 FIO_OPT_G_STAT = 1UL << 14,
54 FIO_OPT_G_ERR = 1UL << 15,
55 FIO_OPT_G_JOB = 1UL << 16,
56};
57
58/*
59 * Option define
60 */
61struct fio_option {
62 const char *name; /* option name */
63 const char *alias; /* possible old allowed name */
64 enum fio_opt_type type; /* option type */
65 unsigned int off1; /* potential parameters */
66 unsigned int off2;
67 unsigned int off3;
68 unsigned int off4;
69 void *roff1, *roff2, *roff3, *roff4;
70 unsigned int maxval; /* max and min value */
71 int minval;
72 double maxfp; /* max and min floating value */
73 double minfp;
74 unsigned int maxlen; /* max length */
75 int neg; /* negate value stored */
76 int prio;
77 void *cb; /* callback */
78 const char *help; /* help text for option */
79 const char *def; /* default setting */
80 struct value_pair posval[PARSE_MAX_VP];/* possible values */
81 const char *parent; /* parent option */
82 int (*verify)(struct fio_option *, void *);
83 const char *prof_name; /* only valid for specific profile */
84 unsigned int category; /* for type grouping */
85};
86
87typedef int (str_cb_fn)(void *, char *);
88
89extern int parse_option(char *, const char *, struct fio_option *, struct fio_option **, void *);
90extern void sort_options(char **, struct fio_option *, int);
91extern int parse_cmd_option(const char *t, const char *l, struct fio_option *, void *);
92extern int show_cmd_help(struct fio_option *, const char *);
93extern void fill_default_options(void *, struct fio_option *);
94extern void option_init(struct fio_option *);
95extern void options_init(struct fio_option *);
96extern void options_free(struct fio_option *, void *);
97
98extern void strip_blank_front(char **);
99extern void strip_blank_end(char *);
100extern int str_to_decimal(const char *, long long *, int, void *);
101
102/*
103 * Handlers for the options
104 */
105typedef int (fio_opt_str_fn)(void *, const char *);
106typedef int (fio_opt_str_val_fn)(void *, long long *);
107typedef int (fio_opt_int_fn)(void *, int *);
108typedef int (fio_opt_str_set_fn)(void *);
109
110#define td_var(start, offset) ((void *) start + (offset))
111
112#ifndef min
113#define min(a, b) ((a) < (b) ? (a) : (b))
114#endif
115#ifndef max
116#define max(a, b) ((a) > (b) ? (a) : (b))
117#endif
118
119static inline int parse_is_percent(unsigned long long val)
120{
121 return val <= -1ULL && val >= (-1ULL - 100ULL);
122}
123
124#endif