[fio.git] / parse.h

#ifndef FIO_PARSE_H
#define FIO_PARSE_H

#include "flist.h"

/*
 * Option types
 */
enum fio_opt_type {
	FIO_OPT_INVALID = 0,
	FIO_OPT_STR,
	FIO_OPT_STR_MULTI,
	FIO_OPT_STR_VAL,
	FIO_OPT_STR_VAL_TIME,
	FIO_OPT_STR_STORE,
	FIO_OPT_RANGE,
	FIO_OPT_INT,
	FIO_OPT_BOOL,
	FIO_OPT_FLOAT_LIST,
	FIO_OPT_STR_SET,
	FIO_OPT_DEPRECATED,
};

/*
 * Match a possible value string with the integer option.
 */
struct value_pair {
	const char *ival;		/* string option */
	unsigned int oval;		/* output value */
	const char *help;		/* help text for sub option */
	int orval;			/* OR value */
	void *cb;			/* sub-option callback */
};

#define OPT_LEN_MAX 	4096
#define PARSE_MAX_VP	24

/*
 * Option define
 */
struct fio_option {
	const char *name;		/* option name */
	const char *lname;		/* long option name */
	const char *alias;		/* possible old allowed name */
	enum fio_opt_type type;		/* option type */
	unsigned int off1;		/* potential parameters */
	unsigned int off2;
	unsigned int off3;
	unsigned int off4;
	unsigned int off5;
	unsigned int off6;
	unsigned int maxval;		/* max and min value */
	int minval;
	double maxfp;			/* max and min floating value */
	double minfp;
	unsigned int interval;		/* client hint for suitable interval */
	unsigned int maxlen;		/* max length */
	int neg;			/* negate value stored */
	int prio;
	void *cb;			/* callback */
	const char *help;		/* help text for option */
	const char *def;		/* default setting */
	struct value_pair posval[PARSE_MAX_VP];/* possible values */
	const char *parent;		/* parent option */
	int hide;			/* hide if parent isn't set */
	int hide_on_set;		/* hide on set, not on unset */
	const char *inverse;		/* if set, apply opposite action to this option */
	struct fio_option *inv_opt;	/* cached lookup */
	int (*verify)(struct fio_option *, void *);
	const char *prof_name;		/* only valid for specific profile */
	void *prof_opts;
	unsigned int category;		/* what type of option */
	unsigned int group;		/* who to group with */
	void *gui_data;
	int is_seconds;			/* time value with seconds base */
	int is_time;			/* time based value */
	int no_warn_def;
};

typedef int (str_cb_fn)(void *, char *);

extern int parse_option(char *, const char *, struct fio_option *, struct fio_option **, void *, int);
extern void sort_options(char **, struct fio_option *, int);
extern int parse_cmd_option(const char *t, const char *l, struct fio_option *, void *);
extern int show_cmd_help(struct fio_option *, const char *);
extern void fill_default_options(void *, struct fio_option *);
extern void option_init(struct fio_option *);
extern void options_init(struct fio_option *);
extern void options_free(struct fio_option *, void *);

extern void strip_blank_front(char **);
extern void strip_blank_end(char *);
extern int str_to_decimal(const char *, long long *, int, void *, int, int);
extern int check_str_bytes(const char *p, long long *val, void *data);
extern int check_str_time(const char *p, long long *val, int);
extern int str_to_float(const char *str, double *val, int is_time);

extern int string_distance(const char *s1, const char *s2);

/*
 * Handlers for the options
 */
typedef int (fio_opt_str_fn)(void *, const char *);
typedef int (fio_opt_str_val_fn)(void *, long long *);
typedef int (fio_opt_int_fn)(void *, int *);
typedef int (fio_opt_str_set_fn)(void *);

#define __td_var(start, offset)	((char *) start + (offset))

struct thread_options;
static inline void *td_var(struct thread_options *to, struct fio_option *o,
			   unsigned int offset)
{
	if (o->prof_opts)
		return __td_var(o->prof_opts, offset);

	return __td_var(to, offset);
}

static inline int parse_is_percent(unsigned long long val)
{
	return val <= -1ULL && val >= (-1ULL - 100ULL);
}

#endif
Commit	Line	Data
	1	#ifndef FIO_PARSE_H
	2	#define FIO_PARSE_H
	3
	4	#include "flist.h"
	5
	6	/*
	7	* Option types
	8	*/
	9	enum 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	*/
	27	struct 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 orval; /* OR value */
	32	void cb; / sub-option callback */
	33	};
	34
	35	#define OPT_LEN_MAX 4096
	36	#define PARSE_MAX_VP 24
	37
	38	/*
	39	* Option define
	40	*/
	41	struct fio_option {
	42	const char name; / option name */
	43	const char lname; / long option name */
	44	const char alias; / possible old allowed name */
	45	enum fio_opt_type type; /* option type */
	46	unsigned int off1; /* potential parameters */
	47	unsigned int off2;
	48	unsigned int off3;
	49	unsigned int off4;
	50	unsigned int off5;
	51	unsigned int off6;
	52	unsigned int maxval; /* max and min value */
	53	int minval;
	54	double maxfp; /* max and min floating value */
	55	double minfp;
	56	unsigned int interval; /* client hint for suitable interval */
	57	unsigned int maxlen; /* max length */
	58	int neg; /* negate value stored */
	59	int prio;
	60	void cb; / callback */
	61	const char help; / help text for option */
	62	const char def; / default setting */
	63	struct value_pair posval[PARSE_MAX_VP];/* possible values */
	64	const char parent; / parent option */
	65	int hide; /* hide if parent isn't set */
	66	int hide_on_set; /* hide on set, not on unset */
	67	const char inverse; / if set, apply opposite action to this option */
	68	struct fio_option inv_opt; / cached lookup */
	69	int (verify)(struct fio_option , void *);
	70	const char prof_name; / only valid for specific profile */
	71	void *prof_opts;
	72	unsigned int category; /* what type of option */
	73	unsigned int group; /* who to group with */
	74	void *gui_data;
	75	int is_seconds; /* time value with seconds base */
	76	int is_time; /* time based value */
	77	int no_warn_def;
	78	};
	79
	80	typedef int (str_cb_fn)(void , char );
	81
	82	extern int parse_option(char , const char , struct fio_option , struct fio_option , void , int);
	83	extern void sort_options(char *, struct fio_option , int);
	84	extern int parse_cmd_option(const char t, const char l, struct fio_option , void );
	85	extern int show_cmd_help(struct fio_option , const char );
	86	extern void fill_default_options(void , struct fio_option );
	87	extern void option_init(struct fio_option *);
	88	extern void options_init(struct fio_option *);
	89	extern void options_free(struct fio_option , void );
	90
	91	extern void strip_blank_front(char **);
	92	extern void strip_blank_end(char *);
	93	extern int str_to_decimal(const char , long long , int, void *, int, int);
	94	extern int check_str_bytes(const char p, long long val, void *data);
	95	extern int check_str_time(const char p, long long val, int);
	96	extern int str_to_float(const char str, double val, int is_time);
	97
	98	extern int string_distance(const char s1, const char s2);
	99
	100	/*
	101	* Handlers for the options
	102	*/
	103	typedef int (fio_opt_str_fn)(void , const char );
	104	typedef int (fio_opt_str_val_fn)(void , long long );
	105	typedef int (fio_opt_int_fn)(void , int );
	106	typedef int (fio_opt_str_set_fn)(void *);
	107
	108	#define __td_var(start, offset) ((char *) start + (offset))
	109
	110	struct thread_options;
	111	static inline void td_var(struct thread_options to, struct fio_option *o,
	112	unsigned int offset)
	113	{
	114	if (o->prof_opts)
	115	return __td_var(o->prof_opts, offset);
	116
	117	return __td_var(to, offset);
	118	}
	119
	120	static inline int parse_is_percent(unsigned long long val)
	121	{
	122	return val <= -1ULL && val >= (-1ULL - 100ULL);
	123	}
	124
	125	#endif