circuituse.h 3.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485
  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. * \file circuituse.h
  8. * \brief Header file for circuituse.c.
  9. **/
  10. #ifndef TOR_CIRCUITUSE_H
  11. #define TOR_CIRCUITUSE_H
  12. void circuit_expire_building(void);
  13. void circuit_expire_waiting_for_better_guard(void);
  14. void circuit_remove_handled_ports(smartlist_t *needed_ports);
  15. int circuit_stream_is_being_handled(entry_connection_t *conn, uint16_t port,
  16. int min);
  17. void circuit_log_ancient_one_hop_circuits(int age);
  18. #if 0
  19. int circuit_conforms_to_options(const origin_circuit_t *circ,
  20. const or_options_t *options);
  21. #endif
  22. void circuit_build_needed_circs(time_t now);
  23. void circuit_expire_old_circs_as_needed(time_t now);
  24. void circuit_detach_stream(circuit_t *circ, edge_connection_t *conn);
  25. void circuit_expire_old_circuits_serverside(time_t now);
  26. void reset_bandwidth_test(void);
  27. int circuit_enough_testing_circs(void);
  28. void circuit_has_opened(origin_circuit_t *circ);
  29. void circuit_try_attaching_streams(origin_circuit_t *circ);
  30. void circuit_build_failed(origin_circuit_t *circ);
  31. /** Flag to set when a circuit should have only a single hop. */
  32. #define CIRCLAUNCH_ONEHOP_TUNNEL (1<<0)
  33. /** Flag to set when a circuit needs to be built of high-uptime nodes */
  34. #define CIRCLAUNCH_NEED_UPTIME (1<<1)
  35. /** Flag to set when a circuit needs to be built of high-capacity nodes */
  36. #define CIRCLAUNCH_NEED_CAPACITY (1<<2)
  37. /** Flag to set when the last hop of a circuit doesn't need to be an
  38. * exit node. */
  39. #define CIRCLAUNCH_IS_INTERNAL (1<<3)
  40. origin_circuit_t *circuit_launch_by_extend_info(uint8_t purpose,
  41. extend_info_t *info,
  42. int flags);
  43. origin_circuit_t *circuit_launch(uint8_t purpose, int flags);
  44. void circuit_reset_failure_count(int timeout);
  45. int connection_ap_handshake_attach_chosen_circuit(entry_connection_t *conn,
  46. origin_circuit_t *circ,
  47. crypt_path_t *cpath);
  48. int connection_ap_handshake_attach_circuit(entry_connection_t *conn);
  49. void circuit_change_purpose(circuit_t *circ, uint8_t new_purpose);
  50. int hostname_in_track_host_exits(const or_options_t *options,
  51. const char *address);
  52. void mark_circuit_unusable_for_new_conns(origin_circuit_t *circ);
  53. #ifdef TOR_UNIT_TESTS
  54. /* Used only by circuituse.c and test_circuituse.c */
  55. STATIC int circuit_is_available_for_use(const circuit_t *circ);
  56. STATIC int needs_exit_circuits(time_t now,
  57. int *port_needs_uptime,
  58. int *port_needs_capacity);
  59. STATIC int needs_hs_server_circuits(time_t now,
  60. int num_uptime_internal);
  61. STATIC int needs_hs_client_circuits(time_t now,
  62. int *needs_uptime,
  63. int *needs_capacity,
  64. int num_internal,
  65. int num_uptime_internal);
  66. STATIC int needs_circuits_for_build(int num);
  67. #endif
  68. #endif