confparse.h 6.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132
  1. /* Copyright (c) 2001 Matej Pfajfar.
  2. * Copyright (c) 2001-2004, Roger Dingledine.
  3. * Copyright (c) 2004-2006, Roger Dingledine, Nick Mathewson.
  4. * Copyright (c) 2007-2013, The Tor Project, Inc. */
  5. /* See LICENSE for licensing information */
  6. #ifndef TOR_CONFPARSE_H
  7. #define TOR_CONFPARSE_H
  8. /** Enumeration of types which option values can take */
  9. typedef enum config_type_t {
  10. CONFIG_TYPE_STRING = 0, /**< An arbitrary string. */
  11. CONFIG_TYPE_FILENAME, /**< A filename: some prefixes get expanded. */
  12. CONFIG_TYPE_UINT, /**< A non-negative integer less than MAX_INT */
  13. CONFIG_TYPE_INT, /**< Any integer. */
  14. CONFIG_TYPE_PORT, /**< A port from 1...65535, 0 for "not set", or
  15. * "auto". */
  16. CONFIG_TYPE_INTERVAL, /**< A number of seconds, with optional units*/
  17. CONFIG_TYPE_MSEC_INTERVAL,/**< A number of milliseconds, with optional
  18. * units */
  19. CONFIG_TYPE_MEMUNIT, /**< A number of bytes, with optional units*/
  20. CONFIG_TYPE_DOUBLE, /**< A floating-point value */
  21. CONFIG_TYPE_BOOL, /**< A boolean value, expressed as 0 or 1. */
  22. CONFIG_TYPE_AUTOBOOL, /**< A boolean+auto value, expressed 0 for false,
  23. * 1 for true, and -1 for auto */
  24. CONFIG_TYPE_ISOTIME, /**< An ISO-formatted time relative to UTC. */
  25. CONFIG_TYPE_CSV, /**< A list of strings, separated by commas and
  26. * optional whitespace. */
  27. CONFIG_TYPE_LINELIST, /**< Uninterpreted config lines */
  28. CONFIG_TYPE_LINELIST_S, /**< Uninterpreted, context-sensitive config lines,
  29. * mixed with other keywords. */
  30. CONFIG_TYPE_LINELIST_V, /**< Catch-all "virtual" option to summarize
  31. * context-sensitive config lines when fetching.
  32. */
  33. CONFIG_TYPE_ROUTERSET, /**< A list of router names, addrs, and fps,
  34. * parsed into a routerset_t. */
  35. CONFIG_TYPE_OBSOLETE, /**< Obsolete (ignored) option. */
  36. } config_type_t;
  37. /** An abbreviation for a configuration option allowed on the command line. */
  38. typedef struct config_abbrev_t {
  39. const char *abbreviated;
  40. const char *full;
  41. int commandline_only;
  42. int warn;
  43. } config_abbrev_t;
  44. /* Handy macro for declaring "In the config file or on the command line,
  45. * you can abbreviate <b>tok</b>s as <b>tok</b>". */
  46. #define PLURAL(tok) { #tok, #tok "s", 0, 0 }
  47. /** A variable allowed in the configuration file or on the command line. */
  48. typedef struct config_var_t {
  49. const char *name; /**< The full keyword (case insensitive). */
  50. config_type_t type; /**< How to interpret the type and turn it into a
  51. * value. */
  52. off_t var_offset; /**< Offset of the corresponding member of or_options_t. */
  53. const char *initvalue; /**< String (or null) describing initial value. */
  54. } config_var_t;
  55. /** Represents an English description of a configuration variable; used when
  56. * generating configuration file comments. */
  57. typedef struct config_var_description_t {
  58. const char *name;
  59. const char *description;
  60. } config_var_description_t;
  61. /** Type of a callback to validate whether a given configuration is
  62. * well-formed and consistent. See options_trial_assign() for documentation
  63. * of arguments. */
  64. typedef int (*validate_fn_t)(void*,void*,int,char**);
  65. /** Information on the keys, value types, key-to-struct-member mappings,
  66. * variable descriptions, validation functions, and abbreviations for a
  67. * configuration or storage format. */
  68. typedef struct {
  69. size_t size; /**< Size of the struct that everything gets parsed into. */
  70. uint32_t magic; /**< Required 'magic value' to make sure we have a struct
  71. * of the right type. */
  72. off_t magic_offset; /**< Offset of the magic value within the struct. */
  73. config_abbrev_t *abbrevs; /**< List of abbreviations that we expand when
  74. * parsing this format. */
  75. config_var_t *vars; /**< List of variables we recognize, their default
  76. * values, and where we stick them in the structure. */
  77. validate_fn_t validate_fn; /**< Function to validate config. */
  78. /** If present, extra is a LINELIST variable for unrecognized
  79. * lines. Otherwise, unrecognized lines are an error. */
  80. config_var_t *extra;
  81. } config_format_t;
  82. /** Macro: assert that <b>cfg</b> has the right magic field for format
  83. * <b>fmt</b>. */
  84. #define CONFIG_CHECK(fmt, cfg) STMT_BEGIN \
  85. tor_assert(fmt && cfg); \
  86. tor_assert((fmt)->magic == \
  87. *(uint32_t*)STRUCT_VAR_P(cfg,fmt->magic_offset)); \
  88. STMT_END
  89. void *config_new(const config_format_t *fmt);
  90. void config_line_append(config_line_t **lst,
  91. const char *key, const char *val);
  92. config_line_t *config_lines_dup(const config_line_t *inp);
  93. void config_free(const config_format_t *fmt, void *options);
  94. int config_lines_eq(config_line_t *a, config_line_t *b);
  95. int config_count_key(const config_line_t *a, const char *key);
  96. config_line_t *config_get_assigned_option(const config_format_t *fmt,
  97. const void *options, const char *key,
  98. int escape_val);
  99. int config_is_same(const config_format_t *fmt,
  100. const void *o1, const void *o2,
  101. const char *name);
  102. void config_init(const config_format_t *fmt, void *options);
  103. void *config_dup(const config_format_t *fmt, const void *old);
  104. char *config_dump(const config_format_t *fmt, const void *default_options,
  105. const void *options, int minimal,
  106. int comment_defaults);
  107. int config_assign(const config_format_t *fmt, void *options,
  108. config_line_t *list,
  109. int use_defaults, int clear_first, char **msg);
  110. config_var_t *config_find_option_mutable(config_format_t *fmt,
  111. const char *key);
  112. const config_var_t *config_find_option(const config_format_t *fmt,
  113. const char *key);
  114. int config_get_lines(const char *string, config_line_t **result, int extended);
  115. void config_free_lines(config_line_t *front);
  116. const char *config_expand_abbrev(const config_format_t *fmt,
  117. const char *option,
  118. int command_line, int warn_obsolete);
  119. #endif