blob: 34d99d46d3e47d9b6c356d10aa6afeccf0eaadbf [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 Axboe3ae4f4a2012-09-20 13:46:15 +020036#define PARSE_MAX_VP 24
Jens Axboeb1ec1da2007-02-23 10:29:16 +010037
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;
Shaohua Li6eaf09d2012-09-14 08:49:43 +020050 unsigned int off5;
51 unsigned int off6;
52 void *roff1, *roff2, *roff3, *roff4, *roff5, *roff6;
Jens Axboeee738492007-01-10 11:23:16 +010053 unsigned int maxval; /* max and min value */
Jens Axboe63f29372007-01-10 13:20:09 +010054 int minval;
Yu-ju Hong83349192011-08-13 00:53:44 +020055 double maxfp; /* max and min floating value */
56 double minfp;
Jens Axboe20eb06b2012-03-16 19:57:23 +010057 unsigned int interval; /* client hint for suitable interval */
Yu-ju Hong83349192011-08-13 00:53:44 +020058 unsigned int maxlen; /* max length */
Jens Axboe76a43db2007-01-11 13:24:44 +010059 int neg; /* negate value stored */
Jens Axboe3b8b7132008-06-10 19:46:23 +020060 int prio;
Jens Axboeee738492007-01-10 11:23:16 +010061 void *cb; /* callback */
62 const char *help; /* help text for option */
63 const char *def; /* default setting */
Jens Axboef5b6bb82010-03-05 10:09:59 +010064 struct value_pair posval[PARSE_MAX_VP];/* possible values */
Jens Axboeafdf9352007-07-31 16:14:34 +020065 const char *parent; /* parent option */
Jens Axboed71c1542012-03-16 20:16:59 +010066 int hide; /* hide if parent isn't set */
Jens Axboea4ed77f2012-03-20 10:19:44 +010067 int hide_on_set; /* hide on set, not on unset */
Jens Axboe90265352012-03-19 20:29:44 +010068 const char *inverse; /* if set, apply opposite action to this option */
69 struct fio_option *inv_opt; /* cached lookup */
Jens Axboe70a4c0c2009-07-01 09:24:05 +020070 int (*verify)(struct fio_option *, void *);
Jens Axboe07b32322010-03-05 09:48:44 +010071 const char *prof_name; /* only valid for specific profile */
Jens Axboee8b0e952012-03-19 14:37:08 +010072 unsigned int category; /* what type of option */
73 unsigned int group; /* who to group with */
Jens Axboe90265352012-03-19 20:29:44 +010074 void *gui_data;
Jens Axboee1f36502006-10-27 10:54:08 +020075};
76
77typedef int (str_cb_fn)(void *, char *);
78
Jens Axboe292cc472013-11-26 20:39:35 -070079extern int parse_option(char *, const char *, struct fio_option *, struct fio_option **, void *, int);
Jens Axboe3b8b7132008-06-10 19:46:23 +020080extern void sort_options(char **, struct fio_option *, int);
Jens Axboe07b32322010-03-05 09:48:44 +010081extern int parse_cmd_option(const char *t, const char *l, struct fio_option *, void *);
82extern int show_cmd_help(struct fio_option *, const char *);
Jens Axboeee738492007-01-10 11:23:16 +010083extern void fill_default_options(void *, struct fio_option *);
Jens Axboe9f988e22010-03-04 10:42:38 +010084extern void option_init(struct fio_option *);
Jens Axboe13335dd2007-01-10 13:14:02 +010085extern void options_init(struct fio_option *);
Jens Axboe7e356b22011-10-14 10:55:16 +020086extern void options_free(struct fio_option *, void *);
Jens Axboee1f36502006-10-27 10:54:08 +020087
88extern void strip_blank_front(char **);
89extern void strip_blank_end(char *);
Jens Axboe6925dd32011-09-07 22:10:11 +020090extern int str_to_decimal(const char *, long long *, int, void *);
Jens Axboe9af4a242012-03-16 10:13:49 +010091extern int check_str_bytes(const char *p, long long *val, void *data);
Jens Axboe06464902013-04-24 20:38:54 -060092extern int check_str_time(const char *p, long long *val);
Jens Axboee25839d2012-11-06 10:49:42 +010093extern int str_to_float(const char *str, double *val);
Jens Axboee1f36502006-10-27 10:54:08 +020094
95/*
96 * Handlers for the options
97 */
Jens Axboeb4692822006-10-27 13:43:22 +020098typedef int (fio_opt_str_fn)(void *, const char *);
Jens Axboe63f29372007-01-10 13:20:09 +010099typedef int (fio_opt_str_val_fn)(void *, long long *);
100typedef int (fio_opt_int_fn)(void *, int *);
Jens Axboee1f36502006-10-27 10:54:08 +0200101typedef int (fio_opt_str_set_fn)(void *);
102
103#define td_var(start, offset) ((void *) start + (offset))
104
Jens Axboe7bb59102011-07-12 19:47:03 +0200105static inline int parse_is_percent(unsigned long long val)
106{
107 return val <= -1ULL && val >= (-1ULL - 100ULL);
108}
109
Jens Axboee1f36502006-10-27 10:54:08 +0200110#endif