blob: fe3b6bc5f236510dc3cdbb66b5c3a6069b79df34 [file] [log] [blame]
Jens Axboee1f36502006-10-27 10:54:08 +02001#ifndef FIO_PARSE_H
2#define FIO_PARSE_H
3
Jens Axboe9f988e22010-03-04 10:42:38 +01004#include "flist.h"
5
Jens Axboee1f36502006-10-27 10:54:08 +02006/*
7 * Option types
8 */
9enum fio_opt_type {
Jens Axboe07b32322010-03-05 09:48:44 +010010 FIO_OPT_INVALID = 0,
11 FIO_OPT_STR,
Jens Axboe5f6ddf12010-03-09 20:40:44 +010012 FIO_OPT_STR_MULTI,
Jens Axboee1f36502006-10-27 10:54:08 +020013 FIO_OPT_STR_VAL,
14 FIO_OPT_STR_VAL_TIME,
15 FIO_OPT_STR_STORE,
16 FIO_OPT_RANGE,
17 FIO_OPT_INT,
Jens Axboe13335dd2007-01-10 13:14:02 +010018 FIO_OPT_BOOL,
Yu-ju Hong83349192011-08-13 00:53:44 +020019 FIO_OPT_FLOAT_LIST,
Jens Axboee1f36502006-10-27 10:54:08 +020020 FIO_OPT_STR_SET,
Jens Axboe15ca1502008-04-07 09:26:02 +020021 FIO_OPT_DEPRECATED,
Jens Axboee1f36502006-10-27 10:54:08 +020022};
23
24/*
Jens Axboeb1ec1da2007-02-23 10:29:16 +010025 * 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 */
Jens Axboe78372132007-03-14 13:24:07 +010030 const char *help; /* help text for sub option */
Jens Axboe5f6ddf12010-03-09 20:40:44 +010031 int or; /* OR value */
Jens Axboec44b1ff2011-08-30 20:43:53 -060032 void *cb; /* sub-option callback */
Jens Axboeb1ec1da2007-02-23 10:29:16 +010033};
34
Zhang, Yanminc06c78c2010-03-03 08:26:30 +010035#define OPT_LEN_MAX 4096
Jens Axboeb1ec1da2007-02-23 10:29:16 +010036#define PARSE_MAX_VP 16
37
38/*
Jens Axboee1f36502006-10-27 10:54:08 +020039 * Option define
40 */
41struct fio_option {
Jens Axboeee738492007-01-10 11:23:16 +010042 const char *name; /* option name */
Jens Axboee8b0e952012-03-19 14:37:08 +010043 const char *lname; /* long option name */
Jens Axboe03b74b32007-01-11 11:04:31 +010044 const char *alias; /* possible old allowed name */
Jens Axboeee738492007-01-10 11:23:16 +010045 enum fio_opt_type type; /* option type */
46 unsigned int off1; /* potential parameters */
Jens Axboee1f36502006-10-27 10:54:08 +020047 unsigned int off2;
Jens Axboef90eff52006-11-06 11:08:21 +010048 unsigned int off3;
49 unsigned int off4;
Jens Axboe02c6aad2010-03-04 13:49:11 +010050 void *roff1, *roff2, *roff3, *roff4;
Jens Axboeee738492007-01-10 11:23:16 +010051 unsigned int maxval; /* max and min value */
Jens Axboe63f29372007-01-10 13:20:09 +010052 int minval;
Yu-ju Hong83349192011-08-13 00:53:44 +020053 double maxfp; /* max and min floating value */
54 double minfp;
Jens Axboe20eb06b2012-03-16 19:57:23 +010055 unsigned int interval; /* client hint for suitable interval */
Yu-ju Hong83349192011-08-13 00:53:44 +020056 unsigned int maxlen; /* max length */
Jens Axboe76a43db2007-01-11 13:24:44 +010057 int neg; /* negate value stored */
Jens Axboe3b8b7132008-06-10 19:46:23 +020058 int prio;
Jens Axboeee738492007-01-10 11:23:16 +010059 void *cb; /* callback */
60 const char *help; /* help text for option */
61 const char *def; /* default setting */
Jens Axboef5b6bb82010-03-05 10:09:59 +010062 struct value_pair posval[PARSE_MAX_VP];/* possible values */
Jens Axboeafdf9352007-07-31 16:14:34 +020063 const char *parent; /* parent option */
Jens Axboed71c1542012-03-16 20:16:59 +010064 int hide; /* hide if parent isn't set */
Jens Axboe90265352012-03-19 20:29:44 +010065 const char *inverse; /* if set, apply opposite action to this option */
66 struct fio_option *inv_opt; /* cached lookup */
Jens Axboe70a4c0c2009-07-01 09:24:05 +020067 int (*verify)(struct fio_option *, void *);
Jens Axboe07b32322010-03-05 09:48:44 +010068 const char *prof_name; /* only valid for specific profile */
Jens Axboee8b0e952012-03-19 14:37:08 +010069 unsigned int category; /* what type of option */
70 unsigned int group; /* who to group with */
Jens Axboe90265352012-03-19 20:29:44 +010071 void *gui_data;
Jens Axboee1f36502006-10-27 10:54:08 +020072};
73
74typedef int (str_cb_fn)(void *, char *);
75
Steven Langde890a12011-11-09 14:03:34 +010076extern int parse_option(char *, const char *, struct fio_option *, struct fio_option **, void *);
Jens Axboe3b8b7132008-06-10 19:46:23 +020077extern void sort_options(char **, struct fio_option *, int);
Jens Axboe07b32322010-03-05 09:48:44 +010078extern int parse_cmd_option(const char *t, const char *l, struct fio_option *, void *);
79extern int show_cmd_help(struct fio_option *, const char *);
Jens Axboeee738492007-01-10 11:23:16 +010080extern void fill_default_options(void *, struct fio_option *);
Jens Axboe9f988e22010-03-04 10:42:38 +010081extern void option_init(struct fio_option *);
Jens Axboe13335dd2007-01-10 13:14:02 +010082extern void options_init(struct fio_option *);
Jens Axboe7e356b22011-10-14 10:55:16 +020083extern void options_free(struct fio_option *, void *);
Jens Axboee1f36502006-10-27 10:54:08 +020084
85extern void strip_blank_front(char **);
86extern void strip_blank_end(char *);
Jens Axboe6925dd32011-09-07 22:10:11 +020087extern int str_to_decimal(const char *, long long *, int, void *);
Jens Axboe9af4a242012-03-16 10:13:49 +010088extern int check_str_bytes(const char *p, long long *val, void *data);
Jens Axboee1f36502006-10-27 10:54:08 +020089
90/*
91 * Handlers for the options
92 */
Jens Axboeb4692822006-10-27 13:43:22 +020093typedef int (fio_opt_str_fn)(void *, const char *);
Jens Axboe63f29372007-01-10 13:20:09 +010094typedef int (fio_opt_str_val_fn)(void *, long long *);
95typedef int (fio_opt_int_fn)(void *, int *);
Jens Axboee1f36502006-10-27 10:54:08 +020096typedef int (fio_opt_str_set_fn)(void *);
97
98#define td_var(start, offset) ((void *) start + (offset))
99
Jens Axboe0e9f7fa2007-03-01 14:05:30 +0100100#ifndef min
101#define min(a, b) ((a) < (b) ? (a) : (b))
102#endif
103#ifndef max
104#define max(a, b) ((a) > (b) ? (a) : (b))
105#endif
106
Jens Axboe7bb59102011-07-12 19:47:03 +0200107static inline int parse_is_percent(unsigned long long val)
108{
109 return val <= -1ULL && val >= (-1ULL - 100ULL);
110}
111
Jens Axboee1f36502006-10-27 10:54:08 +0200112#endif