config.h 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146
  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. /**
  7. * \file config.h
  8. * \brief Header file for config.c.
  9. **/
  10. #ifndef TOR_CONFIG_H
  11. #define TOR_CONFIG_H
  12. #include "testsupport.h"
  13. const char *get_dirportfrontpage(void);
  14. MOCK_DECL(const or_options_t *,get_options,(void));
  15. or_options_t *get_options_mutable(void);
  16. int set_options(or_options_t *new_val, char **msg);
  17. void config_free_all(void);
  18. const char *safe_str_client(const char *address);
  19. const char *safe_str(const char *address);
  20. const char *escaped_safe_str_client(const char *address);
  21. const char *escaped_safe_str(const char *address);
  22. const char *get_version(void);
  23. const char *get_short_version(void);
  24. setopt_err_t options_trial_assign(config_line_t *list, int use_defaults,
  25. int clear_first, char **msg);
  26. uint32_t get_last_resolved_addr(void);
  27. int resolve_my_address(int warn_severity, const or_options_t *options,
  28. uint32_t *addr_out,
  29. const char **method_out, char **hostname_out);
  30. int is_local_addr(const tor_addr_t *addr);
  31. void options_init(or_options_t *options);
  32. #define OPTIONS_DUMP_MINIMAL 1
  33. #define OPTIONS_DUMP_DEFAULTS 2
  34. #define OPTIONS_DUMP_ALL 3
  35. char *options_dump(const or_options_t *options, int how_to_dump);
  36. int options_init_from_torrc(int argc, char **argv);
  37. setopt_err_t options_init_from_string(const char *cf_defaults, const char *cf,
  38. int command, const char *command_arg, char **msg);
  39. int option_is_recognized(const char *key);
  40. const char *option_get_canonical_name(const char *key);
  41. config_line_t *option_get_assignment(const or_options_t *options,
  42. const char *key);
  43. int options_save_current(void);
  44. const char *get_torrc_fname(int defaults_fname);
  45. char *options_get_datadir_fname2_suffix(const or_options_t *options,
  46. const char *sub1, const char *sub2,
  47. const char *suffix);
  48. #define get_datadir_fname2_suffix(sub1, sub2, suffix) \
  49. options_get_datadir_fname2_suffix(get_options(), (sub1), (sub2), (suffix))
  50. /** Return a newly allocated string containing datadir/sub1. See
  51. * get_datadir_fname2_suffix. */
  52. #define get_datadir_fname(sub1) get_datadir_fname2_suffix((sub1), NULL, NULL)
  53. /** Return a newly allocated string containing datadir/sub1/sub2. See
  54. * get_datadir_fname2_suffix. */
  55. #define get_datadir_fname2(sub1,sub2) \
  56. get_datadir_fname2_suffix((sub1), (sub2), NULL)
  57. /** Return a newly allocated string containing datadir/sub1suffix. See
  58. * get_datadir_fname2_suffix. */
  59. #define get_datadir_fname_suffix(sub1, suffix) \
  60. get_datadir_fname2_suffix((sub1), NULL, (suffix))
  61. int check_or_create_data_subdir(const char *subdir);
  62. int write_to_data_subdir(const char* subdir, const char* fname,
  63. const char* str, const char* descr);
  64. int get_num_cpus(const or_options_t *options);
  65. const smartlist_t *get_configured_ports(void);
  66. int get_first_advertised_port_by_type_af(int listener_type,
  67. int address_family);
  68. #define get_primary_or_port() \
  69. (get_first_advertised_port_by_type_af(CONN_TYPE_OR_LISTENER, AF_INET))
  70. #define get_primary_dir_port() \
  71. (get_first_advertised_port_by_type_af(CONN_TYPE_DIR_LISTENER, AF_INET))
  72. char *get_first_listener_addrport_string(int listener_type);
  73. int options_need_geoip_info(const or_options_t *options,
  74. const char **reason_out);
  75. smartlist_t *get_list_of_ports_to_forward(void);
  76. int getinfo_helper_config(control_connection_t *conn,
  77. const char *question, char **answer,
  78. const char **errmsg);
  79. const char *tor_get_digests(void);
  80. uint32_t get_effective_bwrate(const or_options_t *options);
  81. uint32_t get_effective_bwburst(const or_options_t *options);
  82. char *get_transport_bindaddr_from_config(const char *transport);
  83. int init_cookie_authentication(const char *fname, const char *header,
  84. int cookie_len,
  85. uint8_t **cookie_out, int *cookie_is_set_out);
  86. or_options_t *options_new(void);
  87. int config_parse_commandline(int argc, char **argv, int ignore_errors,
  88. config_line_t **result,
  89. config_line_t **cmdline_result);
  90. void config_register_addressmaps(const or_options_t *options);
  91. /* XXXX024 move to connection_edge.h */
  92. int addressmap_register_auto(const char *from, const char *to,
  93. time_t expires,
  94. addressmap_entry_source_t addrmap_source,
  95. const char **msg);
  96. /** Represents the information stored in a torrc Bridge line. */
  97. typedef struct bridge_line_t {
  98. tor_addr_t addr; /* The IP address of the bridge. */
  99. uint16_t port; /* The TCP port of the bridge. */
  100. char *transport_name; /* The name of the pluggable transport that
  101. should be used to connect to the bridge. */
  102. char digest[DIGEST_LEN]; /* The bridge's identity key digest. */
  103. smartlist_t *socks_args; /* SOCKS arguments for the pluggable
  104. transport proxy. */
  105. } bridge_line_t;
  106. void bridge_line_free(bridge_line_t *bridge_line);
  107. bridge_line_t *parse_bridge_line(const char *line);
  108. smartlist_t *get_options_from_transport_options_line(const char *line,
  109. const char *transport);
  110. smartlist_t *get_options_for_server_transport(const char *transport);
  111. #ifdef CONFIG_PRIVATE
  112. #ifdef TOR_UNIT_TESTS
  113. extern struct config_format_t options_format;
  114. #endif
  115. STATIC void or_options_free(or_options_t *options);
  116. STATIC int options_validate(or_options_t *old_options,
  117. or_options_t *options,
  118. or_options_t *default_options,
  119. int from_setconf, char **msg);
  120. #endif
  121. #endif