2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
#ifndef EL__CONFIG_OPTIONS_H
|
|
|
|
#define EL__CONFIG_OPTIONS_H
|
|
|
|
|
|
|
|
#include "main/object.h"
|
|
|
|
#include "util/color.h"
|
|
|
|
#include "util/lists.h"
|
|
|
|
#include "util/memory.h"
|
|
|
|
#include "util/string.h"
|
|
|
|
|
|
|
|
/* TODO: We should provide some generic mechanism for options caching. */
|
|
|
|
|
|
|
|
/* Fix namespace clash on Cygwin. */
|
|
|
|
#define option option_elinks
|
|
|
|
|
|
|
|
|
|
|
|
enum option_flags {
|
|
|
|
/* bitmask */
|
|
|
|
/* The option is hidden - it serves for internal purposes, never is
|
|
|
|
* read, never is written, never is displayed, never is crawled through
|
|
|
|
* etc. */
|
|
|
|
OPT_HIDDEN = 1,
|
|
|
|
/* For OPT_TREE, automatically create missing hiearchy piece just under
|
|
|
|
* this category when adding an option. The 'template' for the added
|
|
|
|
* hiearchy piece (category) is stored as "_template_" category. */
|
|
|
|
OPT_AUTOCREATE = 2,
|
|
|
|
/* This is used just for marking various options for some very dark,
|
|
|
|
* nasty and dirty purposes. This watermarking should be kept inside
|
|
|
|
* some very closed and clearly bounded piece of ELinks module, not
|
|
|
|
* spreaded along whole ELinks code, and you should clear it everytime
|
|
|
|
* when sneaking outside of the module (except some trivial common
|
|
|
|
* utility functions). Basically, you don't want to use this flag
|
|
|
|
* normally ;). It doesn't affect how the option is handled by common
|
|
|
|
* option handling functions in any way. */
|
|
|
|
OPT_WATERMARK = 4,
|
|
|
|
/* This is used to mark options modified after the last save. That's
|
|
|
|
* being useful if you want to save only the options whose value
|
|
|
|
* changed. */
|
|
|
|
OPT_TOUCHED = 8,
|
|
|
|
/* If set on the tree argument to add_opt (not necessarily the direct
|
|
|
|
* parent) or on the option itself, it will create the listbox (options
|
|
|
|
* manager) item for the option. */
|
|
|
|
OPT_LISTBOX = 16,
|
|
|
|
/* This is used to mark that the option _and_ the option name is
|
|
|
|
* allocated and should be freed when the option is released. */
|
|
|
|
OPT_ALLOC = 32,
|
|
|
|
/* For OPT_TREE, automatically sort the content of the tree
|
|
|
|
* alphabetically (but all subtrees in front of ordinary options) when
|
|
|
|
* adding new options. Note that this applies only to the one level
|
|
|
|
* below - it will not apply to the sub-trees in this tree. Also, this
|
|
|
|
* can be quite expensive for busy-adding big trees, so think twice
|
|
|
|
* before doing it - in fact, it is supposed to be used only where you
|
|
|
|
* add stuff from more modules, not all at once; typically the
|
|
|
|
* config_options root tree. Especially NOT RECOMMENDED to be used on
|
|
|
|
* the template trees. */
|
|
|
|
OPT_SORT = 64,
|
|
|
|
/* This is used to mark option as deleted */
|
|
|
|
OPT_DELETED = 128,
|
|
|
|
/* Specifies that values of boolean aliases should be inverted. */
|
|
|
|
OPT_ALIAS_NEGATE = 256
|
|
|
|
};
|
|
|
|
|
|
|
|
enum option_type {
|
|
|
|
OPT_BOOL = 0,
|
|
|
|
OPT_INT,
|
|
|
|
OPT_LONG,
|
|
|
|
OPT_STRING,
|
|
|
|
|
|
|
|
OPT_CODEPAGE,
|
|
|
|
OPT_LANGUAGE,
|
|
|
|
OPT_COLOR,
|
|
|
|
|
|
|
|
OPT_COMMAND,
|
|
|
|
|
|
|
|
OPT_ALIAS,
|
|
|
|
|
|
|
|
OPT_TREE,
|
|
|
|
};
|
|
|
|
|
2006-01-01 01:24:12 -05:00
|
|
|
struct listbox_item; /* bfu/listbox.h */
|
|
|
|
struct option; /* defined later in this file */
|
|
|
|
struct session; /* session/session.h */
|
2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
union option_value {
|
|
|
|
/* XXX: Keep first to make @options_root initialization possible. */
|
|
|
|
/* The OPT_TREE list_head is allocated. */
|
|
|
|
struct list_head *tree;
|
|
|
|
|
|
|
|
/* Used by OPT_BOOL, OPT_INT, OPT_CODEPAGE and OPT_LANGUAGE */
|
|
|
|
int number;
|
|
|
|
|
|
|
|
/* Used by OPT_LONG */
|
|
|
|
long big_number;
|
|
|
|
|
|
|
|
/* The OPT_COLOR value */
|
|
|
|
color_T color;
|
|
|
|
|
|
|
|
/* The OPT_COMMAND value */
|
|
|
|
unsigned char *(*command)(struct option *, unsigned char ***, int *);
|
|
|
|
|
|
|
|
/* The OPT_STRING string is allocated and has length MAX_STR_LEN.
|
|
|
|
* The OPT_ALIAS string is NOT allocated, has variable length
|
|
|
|
* (opt->max) and should remain untouched! It contains the full path to
|
|
|
|
* the "real" / aliased option. */
|
|
|
|
unsigned char *string;
|
|
|
|
};
|
|
|
|
|
|
|
|
typedef int (*change_hook_T)(struct session *, struct option *current,
|
|
|
|
struct option *changed);
|
|
|
|
|
|
|
|
struct option {
|
|
|
|
OBJECT_HEAD(struct option);
|
|
|
|
|
|
|
|
unsigned char *name;
|
|
|
|
enum option_flags flags;
|
|
|
|
enum option_type type;
|
|
|
|
long min, max;
|
|
|
|
union option_value value;
|
|
|
|
unsigned char *desc;
|
|
|
|
unsigned char *capt;
|
|
|
|
|
|
|
|
struct option *root;
|
|
|
|
|
|
|
|
/* To be called when the option (or sub-option if it's a tree) is
|
|
|
|
* changed. If it returns zero, we will continue descending the options
|
|
|
|
* tree checking for change handlers. */
|
|
|
|
change_hook_T change_hook;
|
|
|
|
|
|
|
|
struct listbox_item *box_item;
|
|
|
|
};
|
|
|
|
|
|
|
|
#define INIT_OPTION(name, flags, type, min, max, value, desc, capt) \
|
|
|
|
{ NULL_LIST_HEAD, INIT_OBJECT("option"), name, flags, type, min, max, { (struct list_head *) (value) }, desc, capt }
|
|
|
|
|
|
|
|
extern struct option *config_options;
|
|
|
|
extern struct option *cmdline_options;
|
|
|
|
|
|
|
|
|
|
|
|
extern void init_options(void);
|
|
|
|
extern void done_options(void);
|
|
|
|
|
|
|
|
|
|
|
|
struct change_hook_info {
|
|
|
|
unsigned char *name;
|
|
|
|
change_hook_T change_hook;
|
|
|
|
};
|
|
|
|
|
2007-01-27 12:00:47 -05:00
|
|
|
extern void register_change_hooks(const struct change_hook_info *change_hooks);
|
2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
|
|
|
|
extern struct list_head *init_options_tree(void);
|
|
|
|
extern void unmark_options_tree(struct list_head *);
|
|
|
|
void watermark_deleted_options(struct list_head *);
|
|
|
|
|
|
|
|
extern void smart_config_string(struct string *, int, int, struct list_head *, unsigned char *, int,
|
|
|
|
void (*)(struct string *, struct option *, unsigned char *, int, int, int, int));
|
|
|
|
|
|
|
|
extern struct option *copy_option(struct option *);
|
|
|
|
extern void delete_option(struct option *);
|
|
|
|
void mark_option_as_deleted(struct option *);
|
|
|
|
|
|
|
|
/* Some minimal option cache */
|
|
|
|
|
|
|
|
struct option_resolver {
|
|
|
|
int id;
|
|
|
|
unsigned char *name;
|
|
|
|
};
|
|
|
|
|
|
|
|
/* Update the visibility of the box item of each option
|
|
|
|
* in config_options to honour the value of config.show_template. */
|
|
|
|
void update_options_visibility(void);
|
|
|
|
|
|
|
|
/* Toggle the value of the given option numeric, respecting option->min
|
|
|
|
* and option->max. */
|
|
|
|
void toggle_option(struct session *ses, struct option *option);
|
|
|
|
|
|
|
|
/* Call the change-hooks for the given option and recur on its parent. */
|
|
|
|
void call_change_hooks(struct session *ses, struct option *current,
|
|
|
|
struct option *option);
|
|
|
|
|
2005-10-17 17:20:53 -04:00
|
|
|
/* Do proper bookkeeping after an option has changed - call this every time
|
|
|
|
* you change an option value. */
|
2007-01-27 12:52:49 -05:00
|
|
|
void option_changed(struct session *ses, struct option *option);
|
2005-10-17 17:20:53 -04:00
|
|
|
|
2005-09-15 09:58:31 -04:00
|
|
|
extern int commit_option_values(struct option_resolver *resolvers,
|
|
|
|
struct option *root,
|
|
|
|
union option_value *values, int size);
|
|
|
|
extern void checkout_option_values(struct option_resolver *resolvers,
|
|
|
|
struct option *root,
|
|
|
|
union option_value *values, int size);
|
|
|
|
|
|
|
|
/* Shitload of various incredible macro combinations and other unusable garbage
|
|
|
|
* follows. Have fun. */
|
|
|
|
|
|
|
|
/* Basically, for main hiearchy addressed from root (almost always) you want to
|
|
|
|
* use get_opt_type() and add_opt_type(). For command line options, you want to
|
|
|
|
* use get_opt_type_tree(cmdline_options, "option"). */
|
|
|
|
|
|
|
|
extern struct option *get_opt_rec(struct option *, unsigned char *);
|
|
|
|
extern struct option *get_opt_rec_real(struct option *, unsigned char *);
|
|
|
|
#ifdef CONFIG_DEBUG
|
|
|
|
extern union option_value *get_opt_(unsigned char *, int, enum option_type, struct option *, unsigned char *);
|
|
|
|
#define get_opt(tree, name, type) get_opt_(__FILE__, __LINE__, type, tree, name)
|
|
|
|
#else
|
|
|
|
extern union option_value *get_opt_(struct option *, unsigned char *);
|
|
|
|
#define get_opt(tree, name, type) get_opt_(tree, name)
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#define get_opt_bool_tree(tree, name) get_opt(tree, name, OPT_BOOL)->number
|
|
|
|
#define get_opt_int_tree(tree, name) get_opt(tree, name, OPT_INT)->number
|
|
|
|
#define get_opt_long_tree(tree, name) get_opt(tree, name, OPT_LONG)->big_number
|
|
|
|
#define get_opt_str_tree(tree, name) get_opt(tree, name, OPT_STRING)->string
|
|
|
|
#define get_opt_codepage_tree(tree, name) get_opt(tree, name, OPT_CODEPAGE)->number
|
|
|
|
#define get_opt_color_tree(tree, name) get_opt(tree, name, OPT_COLOR)->color
|
|
|
|
#define get_opt_tree_tree(tree_, name) get_opt(tree_, name, OPT_TREE)->tree
|
|
|
|
|
|
|
|
#define get_opt_bool(name) get_opt_bool_tree(config_options, name)
|
|
|
|
#define get_opt_int(name) get_opt_int_tree(config_options, name)
|
|
|
|
#define get_opt_long(name) get_opt_long_tree(config_options, name)
|
|
|
|
#define get_opt_str(name) get_opt_str_tree(config_options, name)
|
|
|
|
#define get_opt_codepage(name) get_opt_codepage_tree(config_options, name)
|
|
|
|
#define get_opt_color(name) get_opt_color_tree(config_options, name)
|
|
|
|
#define get_opt_tree(name) get_opt_tree_tree(config_options, name)
|
|
|
|
|
|
|
|
#define get_cmd_opt_bool(name) get_opt_bool_tree(cmdline_options, name)
|
|
|
|
#define get_cmd_opt_int(name) get_opt_int_tree(cmdline_options, name)
|
|
|
|
#define get_cmd_opt_long(name) get_opt_long_tree(cmdline_options, name)
|
|
|
|
#define get_cmd_opt_str(name) get_opt_str_tree(cmdline_options, name)
|
|
|
|
#define get_cmd_opt_codepage(name) get_opt_codepage_tree(cmdline_options, name)
|
|
|
|
#define get_cmd_opt_color(name) get_opt_color_tree(cmdline_options, name)
|
|
|
|
#define get_cmd_opt_tree(name) get_opt_tree_tree(cmdline_options, name)
|
|
|
|
|
|
|
|
extern struct option *add_opt(struct option *, unsigned char *, unsigned char *,
|
|
|
|
unsigned char *, enum option_flags, enum option_type,
|
2006-07-05 09:11:53 -04:00
|
|
|
long, long, longptr_T, unsigned char *);
|
2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
/* Hack which permit to disable option descriptions, to reduce elinks binary size.
|
|
|
|
* It may of some use for people wanting a very small static non-i18n elinks binary,
|
|
|
|
* at time of writing gain is over 25Kbytes. --Zas */
|
|
|
|
#ifndef CONFIG_SMALL
|
|
|
|
#define DESC(x) (x)
|
|
|
|
#else
|
|
|
|
#define DESC(x) ((unsigned char *) "")
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
#define add_opt_bool_tree(tree, path, capt, name, flags, def, desc) \
|
2006-07-05 09:11:53 -04:00
|
|
|
add_opt(tree, path, capt, name, flags, OPT_BOOL, 0, 1, (longptr_T) def, DESC(desc))
|
2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
#define add_opt_int_tree(tree, path, capt, name, flags, min, max, def, desc) \
|
2006-07-05 09:11:53 -04:00
|
|
|
add_opt(tree, path, capt, name, flags, OPT_INT, min, max, (longptr_T) def, DESC(desc))
|
2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
#define add_opt_long_tree(tree, path, capt, name, flags, min, max, def, desc) \
|
2006-07-05 09:11:53 -04:00
|
|
|
add_opt(tree, path, capt, name, flags, OPT_LONG, min, max, (longptr_T) def, DESC(desc))
|
2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
#define add_opt_str_tree(tree, path, capt, name, flags, def, desc) \
|
|
|
|
do { \
|
|
|
|
unsigned char *ptr = mem_alloc(MAX_STR_LEN); \
|
|
|
|
safe_strncpy(ptr, def, MAX_STR_LEN); \
|
2006-07-05 09:11:53 -04:00
|
|
|
add_opt(tree, path, capt, name, flags, OPT_STRING, 0, MAX_STR_LEN, (longptr_T) ptr, DESC(desc)); \
|
2005-09-15 09:58:31 -04:00
|
|
|
} while (0)
|
|
|
|
|
|
|
|
#define add_opt_codepage_tree(tree, path, capt, name, flags, def, desc) \
|
2006-07-05 09:11:53 -04:00
|
|
|
add_opt(tree, path, capt, name, flags, OPT_CODEPAGE, 0, 0, (longptr_T) get_cp_index(def), DESC(desc))
|
2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
#define add_opt_lang_tree(tree, path, capt, name, flags, desc) \
|
2006-07-05 09:11:53 -04:00
|
|
|
add_opt(tree, path, capt, name, flags, OPT_LANGUAGE, 0, 0, (longptr_T) 0, DESC(desc))
|
2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
#define add_opt_color_tree(tree, path, capt, name, flags, def, desc) \
|
2006-07-05 09:11:53 -04:00
|
|
|
add_opt(tree, path, capt, name, flags, OPT_COLOR, 0, 0, (longptr_T) def, DESC(desc))
|
2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
#define add_opt_command_tree(tree, path, capt, name, flags, cmd, desc) \
|
2006-07-05 09:11:53 -04:00
|
|
|
add_opt(tree, path, capt, name, flags, OPT_COMMAND, 0, 0, (longptr_T) cmd, DESC(desc));
|
2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
#define add_opt_alias_tree(tree, path, capt, name, flags, def, desc) \
|
2006-07-05 09:11:53 -04:00
|
|
|
add_opt(tree, path, capt, name, flags, OPT_ALIAS, 0, strlen(def), (longptr_T) def, DESC(desc))
|
2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
#define add_opt_tree_tree(tree, path, capt, name, flags, desc) \
|
2006-07-05 09:11:53 -04:00
|
|
|
add_opt(tree, path, capt, name, flags, OPT_TREE, 0, 0, (longptr_T) init_options_tree(), DESC(desc));
|
2005-09-15 09:58:31 -04:00
|
|
|
|
|
|
|
|
|
|
|
/* Builtin options */
|
|
|
|
|
|
|
|
struct option_info {
|
|
|
|
struct option option;
|
|
|
|
unsigned char *path;
|
|
|
|
};
|
|
|
|
|
|
|
|
extern void register_options(struct option_info info[], struct option *tree);
|
|
|
|
extern void unregister_options(struct option_info info[], struct option *tree);
|
|
|
|
|
|
|
|
#define NULL_OPTION_INFO \
|
|
|
|
{ INIT_OPTION(NULL, 0, 0, 0, 0, NULL, NULL, NULL), NULL }
|
|
|
|
|
|
|
|
#define INIT_OPT_BOOL(path, capt, name, flags, def, desc) \
|
|
|
|
{ INIT_OPTION(name, flags, OPT_BOOL, 0, 1, def, DESC(desc), capt), path }
|
|
|
|
|
|
|
|
#define INIT_OPT_INT(path, capt, name, flags, min, max, def, desc) \
|
|
|
|
{ INIT_OPTION(name, flags, OPT_INT, min, max, def, DESC(desc), capt), path }
|
|
|
|
|
|
|
|
#define INIT_OPT_LONG(path, capt, name, flags, min, max, def, desc) \
|
|
|
|
{ INIT_OPTION(name, flags, OPT_LONG, min, max, def, DESC(desc), capt), path }
|
|
|
|
|
|
|
|
#define INIT_OPT_STRING(path, capt, name, flags, def, desc) \
|
|
|
|
{ INIT_OPTION(name, flags, OPT_STRING, 0, MAX_STR_LEN, def, DESC(desc), capt), path }
|
|
|
|
|
|
|
|
#define INIT_OPT_CODEPAGE(path, capt, name, flags, def, desc) \
|
|
|
|
{ INIT_OPTION(name, flags, OPT_CODEPAGE, 0, 0, def, DESC(desc), capt), path }
|
|
|
|
|
|
|
|
#define INIT_OPT_COLOR(path, capt, name, flags, def, desc) \
|
|
|
|
{ INIT_OPTION(name, flags, OPT_COLOR, 0, 0, def, DESC(desc), capt), path }
|
|
|
|
|
|
|
|
#define INIT_OPT_LANGUAGE(path, capt, name, flags, desc) \
|
|
|
|
{ INIT_OPTION(name, flags, OPT_LANGUAGE, 0, 0, 0, DESC(desc), capt), path }
|
|
|
|
|
|
|
|
#define INIT_OPT_COMMAND(path, capt, name, flags, cmd, desc) \
|
|
|
|
{ INIT_OPTION(name, flags, OPT_COMMAND, 0, 0, cmd, DESC(desc), capt), path }
|
|
|
|
|
|
|
|
#define INIT_OPT_CMDALIAS(path, capt, name, flags, def, desc) \
|
|
|
|
{ INIT_OPTION(name, flags, OPT_ALIAS, 0, sizeof(def) - 1, def, DESC(desc), capt), path }
|
|
|
|
|
|
|
|
#define INIT_OPT_ALIAS(path, name, flags, def) \
|
|
|
|
{ INIT_OPTION(name, flags, OPT_ALIAS, 0, sizeof(def) - 1, def, NULL, NULL), path }
|
|
|
|
|
|
|
|
#define INIT_OPT_TREE(path, capt, name, flags, desc) \
|
|
|
|
{ INIT_OPTION(name, flags, OPT_TREE, 0, 0, NULL, DESC(desc), capt), path }
|
|
|
|
|
|
|
|
|
|
|
|
/* TODO: We need to do *something* with this ;). */
|
|
|
|
|
|
|
|
enum referer {
|
|
|
|
REFERER_NONE,
|
|
|
|
REFERER_SAME_URL,
|
|
|
|
REFERER_FAKE,
|
|
|
|
REFERER_TRUE,
|
|
|
|
};
|
|
|
|
|
|
|
|
enum verbose_level {
|
|
|
|
VERBOSE_QUIET,
|
|
|
|
VERBOSE_WARNINGS,
|
|
|
|
VERBOSE_ALL,
|
|
|
|
|
|
|
|
VERBOSE_LEVELS,
|
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|