transports.h 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139
  1. /* Copyright (c) 2003-2004, Roger Dingledine
  2. * Copyright (c) 2004-2006, Roger Dingledine, Nick Mathewson.
  3. * Copyright (c) 2007-2017, The Tor Project, Inc. */
  4. /* See LICENSE for licensing information */
  5. /**
  6. * \file transports.h
  7. * \brief Headers for transports.c
  8. **/
  9. #ifndef TOR_TRANSPORTS_H
  10. #define TOR_TRANSPORTS_H
  11. /** Represents a pluggable transport used by a bridge. */
  12. typedef struct transport_t {
  13. /** SOCKS version: One of PROXY_SOCKS4, PROXY_SOCKS5. */
  14. int socks_version;
  15. /** Name of pluggable transport protocol */
  16. char *name;
  17. /** The IP address where the transport bound and is waiting for
  18. * connections. */
  19. tor_addr_t addr;
  20. /** Port of proxy */
  21. uint16_t port;
  22. /** Boolean: We are re-parsing our transport list, and we are going to remove
  23. * this one if we don't find it in the list of configured transports. */
  24. unsigned marked_for_removal : 1;
  25. /** Arguments for this transport that must be written to the
  26. extra-info descriptor. */
  27. char *extra_info_args;
  28. } transport_t;
  29. void mark_transport_list(void);
  30. void sweep_transport_list(void);
  31. MOCK_DECL(int, transport_add_from_config,
  32. (const tor_addr_t *addr, uint16_t port,
  33. const char *name, int socks_ver));
  34. void transport_free(transport_t *transport);
  35. transport_t *transport_get_by_name(const char *name);
  36. MOCK_DECL(void, pt_kickstart_proxy,
  37. (const smartlist_t *transport_list, char **proxy_argv,
  38. int is_server));
  39. #define pt_kickstart_client_proxy(tl, pa) \
  40. pt_kickstart_proxy(tl, pa, 0)
  41. #define pt_kickstart_server_proxy(tl, pa) \
  42. pt_kickstart_proxy(tl, pa, 1)
  43. void pt_configure_remaining_proxies(void);
  44. int pt_proxies_configuration_pending(void);
  45. char *pt_get_extra_info_descriptor_string(void);
  46. void pt_free_all(void);
  47. void pt_prepare_proxy_list_for_config_read(void);
  48. void sweep_proxy_list(void);
  49. smartlist_t *get_transport_proxy_ports(void);
  50. char *pt_stringify_socks_args(const smartlist_t *socks_args);
  51. char *pt_get_socks_args_for_proxy_addrport(const tor_addr_t *addr,
  52. uint16_t port);
  53. #ifdef PT_PRIVATE
  54. /** State of the managed proxy configuration protocol. */
  55. enum pt_proto_state {
  56. PT_PROTO_INFANT, /* was just born */
  57. PT_PROTO_LAUNCHED, /* was just launched */
  58. PT_PROTO_ACCEPTING_METHODS, /* accepting methods */
  59. PT_PROTO_CONFIGURED, /* configured successfully */
  60. PT_PROTO_COMPLETED, /* configure and registered its transports */
  61. PT_PROTO_BROKEN, /* broke during the protocol */
  62. PT_PROTO_FAILED_LAUNCH /* failed while launching */
  63. };
  64. /** Structure containing information of a managed proxy. */
  65. typedef struct {
  66. enum pt_proto_state conf_state; /* the current configuration state */
  67. char **argv; /* the cli arguments of this proxy */
  68. int conf_protocol; /* the configuration protocol version used */
  69. char *proxy_uri; /* the outgoing proxy in TOR_PT_PROXY URI format */
  70. unsigned int proxy_supported : 1; /* the proxy honors TOR_PT_PROXY */
  71. int is_server; /* is it a server proxy? */
  72. /* A pointer to the process handle of this managed proxy. */
  73. process_handle_t *process_handle;
  74. int pid; /* The Process ID this managed proxy is using. */
  75. /** Boolean: We are re-parsing our config, and we are going to
  76. * remove this managed proxy if we don't find it any transport
  77. * plugins that use it. */
  78. unsigned int marked_for_removal : 1;
  79. /** Boolean: We got a SIGHUP while this proxy was running. We use
  80. * this flag to signify that this proxy might need to be restarted
  81. * so that it can listen for other transports according to the new
  82. * torrc. */
  83. unsigned int was_around_before_config_read : 1;
  84. /* transports to-be-launched by this proxy */
  85. smartlist_t *transports_to_launch;
  86. /* The 'transports' list contains all the transports this proxy has
  87. launched. */
  88. smartlist_t *transports;
  89. } managed_proxy_t;
  90. STATIC int parse_cmethod_line(const char *line, managed_proxy_t *mp);
  91. STATIC int parse_smethod_line(const char *line, managed_proxy_t *mp);
  92. STATIC int parse_version(const char *line, managed_proxy_t *mp);
  93. STATIC void parse_env_error(const char *line);
  94. STATIC void parse_proxy_error(const char *line);
  95. STATIC void handle_proxy_line(const char *line, managed_proxy_t *mp);
  96. STATIC char *get_transport_options_for_server_proxy(const managed_proxy_t *mp);
  97. STATIC void managed_proxy_destroy(managed_proxy_t *mp,
  98. int also_terminate_process);
  99. STATIC managed_proxy_t *managed_proxy_create(const smartlist_t *transport_list,
  100. char **proxy_argv, int is_server);
  101. STATIC int configure_proxy(managed_proxy_t *mp);
  102. STATIC char* get_pt_proxy_uri(void);
  103. STATIC void free_execve_args(char **arg);
  104. #endif
  105. #endif