src/or/bridges.h

   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-2017, The Tor Project, Inc. */
   5 /* See LICENSE for licensing information */
   6
   7 /**
   8  * \file bridges.h
   9  * \brief Header file for circuitbuild.c.
  10  **/
  11
  12 #ifndef TOR_BRIDGES_H
  13 #define TOR_BRIDGES_H
  14
  15 struct bridge_line_t;
  16
  17 /* Opaque handle to a configured bridge */
  18 typedef struct bridge_info_t bridge_info_t;
  19
  20 void mark_bridge_list(void);
  21 void sweep_bridge_list(void);
  22 const smartlist_t *bridge_list_get(void);
  23 bridge_info_t *find_bridge_by_digest(const char *digest);
  24 const uint8_t *bridge_get_rsa_id_digest(const bridge_info_t *bridge);
  25 const tor_addr_port_t * bridge_get_addr_port(const bridge_info_t *bridge);
  26 bridge_info_t *get_configured_bridge_by_addr_port_digest(
  27                                           const tor_addr_t *addr,
  28                                           uint16_t port,
  29                                           const char *digest);
  30 bridge_info_t *get_configured_bridge_by_exact_addr_port_digest(
  31                                           const tor_addr_t *addr,
  32                                           uint16_t port,
  33                                           const char *digest);
  34
  35 int addr_is_a_configured_bridge(const tor_addr_t *addr, uint16_t port,
  36                                 const char *digest);
  37 int extend_info_is_a_configured_bridge(const extend_info_t *ei);
  38 int routerinfo_is_a_configured_bridge(const routerinfo_t *ri);
  39 int node_is_a_configured_bridge(const node_t *node);
  40 void learned_router_identity(const tor_addr_t *addr, uint16_t port,
  41                              const char *digest,
  42                              const ed25519_public_key_t *ed_id);
  43
  44 void bridge_add_from_config(struct bridge_line_t *bridge_line);
  45 void retry_bridge_descriptor_fetch_directly(const char *digest);
  46 void fetch_bridge_descriptors(const or_options_t *options, time_t now);
  47 void learned_bridge_descriptor(routerinfo_t *ri, int from_cache);
  48 const smartlist_t *get_socks_args_by_bridge_addrport(const tor_addr_t *addr,
  49                                                      uint16_t port);
  50
  51 int any_bridges_dont_support_microdescriptors(void);
  52
  53 const char *find_transport_name_by_bridge_addrport(const tor_addr_t *addr,
  54                                                    uint16_t port);
  55 struct transport_t;
  56 int get_transport_by_bridge_addrport(const tor_addr_t *addr, uint16_t port,
  57                                       const struct transport_t **transport);
  58
  59 MOCK_DECL(int, transport_is_needed, (const char *transport_name));
  60 int validate_pluggable_transports_config(void);
  61
  62 MOCK_DECL(smartlist_t *, list_bridge_identities, (void));
  63 MOCK_DECL(download_status_t *, get_bridge_dl_status_by_id,
  64           (const char *digest));
  65
  66 void bridges_free_all(void);
  67
  68 #endif /* !defined(TOR_BRIDGES_H) */
  69