release/src/router/tor/src/or/rendservice.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-2013, The Tor Project, Inc. */
   5 /* See LICENSE for licensing information */
   6
   7 /**
   8  * \file rendservice.h
   9  * \brief Header file for rendservice.c.
  10  **/
  11
  12 #ifndef TOR_RENDSERVICE_H
  13 #define TOR_RENDSERVICE_H
  14
  15 #include "or.h"
  16
  17 typedef struct rend_intro_cell_s rend_intro_cell_t;
  18
  19 #ifdef RENDSERVICE_PRIVATE
  20
  21 /* This can be used for both INTRODUCE1 and INTRODUCE2 */
  22
  23 struct rend_intro_cell_s {
  24   /* Is this an INTRODUCE1 or INTRODUCE2? (set to 1 or 2) */
  25   uint8_t type;
  26   /* Public key digest */
  27   uint8_t pk[DIGEST_LEN];
  28   /* Optionally, store ciphertext here */
  29   uint8_t *ciphertext;
  30   ssize_t ciphertext_len;
  31   /* Optionally, store plaintext */
  32   uint8_t *plaintext;
  33   ssize_t plaintext_len;
  34   /* Have we parsed the plaintext? */
  35   uint8_t parsed;
  36   /* intro protocol version (0, 1, 2 or 3) */
  37   uint8_t version;
  38   /* Version-specific parts */
  39   union {
  40     struct {
  41       /* Rendezvous point nickname */
  42       uint8_t rp[20];
  43     } v0;
  44     struct {
  45       /* Rendezvous point nickname or hex-encoded key digest */
  46       uint8_t rp[42];
  47     } v1;
  48     struct {
  49       /* The extend_info_t struct has everything v2 uses */
  50       extend_info_t *extend_info;
  51     } v2;
  52     struct {
  53       /* Auth type used */
  54       uint8_t auth_type;
  55       /* Length of auth data */
  56       uint16_t auth_len;
  57       /* Auth data */
  58       uint8_t *auth_data;
  59       /* Rendezvous point's IP address/port, identity digest and onion key */
  60       extend_info_t *extend_info;
  61     } v3;
  62   } u;
  63   /* Rendezvous cookie */
  64   uint8_t rc[REND_COOKIE_LEN];
  65   /* Diffie-Hellman data */
  66   uint8_t dh[DH_KEY_LEN];
  67 };
  68
  69 #endif
  70
  71 int num_rend_services(void);
  72 int rend_config_services(const or_options_t *options, int validate_only);
  73 int rend_service_load_all_keys(void);
  74 void rend_services_add_filenames_to_lists(smartlist_t *open_lst,
  75                                           smartlist_t *stat_lst);
  76 void rend_services_introduce(void);
  77 void rend_consider_services_upload(time_t now);
  78 void rend_hsdir_routers_changed(void);
  79 void rend_consider_descriptor_republication(void);
  80
  81 void rend_service_intro_has_opened(origin_circuit_t *circuit);
  82 int rend_service_intro_established(origin_circuit_t *circuit,
  83                                    const uint8_t *request,
  84                                    size_t request_len);
  85 void rend_service_rendezvous_has_opened(origin_circuit_t *circuit);
  86 int rend_service_introduce(origin_circuit_t *circuit, const uint8_t *request,
  87                            size_t request_len);
  88 int rend_service_decrypt_intro(rend_intro_cell_t *request,
  89                                crypto_pk_t *key,
  90                                char **err_msg_out);
  91 void rend_service_free_intro(rend_intro_cell_t *request);
  92 rend_intro_cell_t * rend_service_begin_parse_intro(const uint8_t *request,
  93                                                    size_t request_len,
  94                                                    uint8_t type,
  95                                                    char **err_msg_out);
  96 int rend_service_parse_intro_plaintext(rend_intro_cell_t *intro,
  97                                        char **err_msg_out);
  98 int rend_service_validate_intro_early(const rend_intro_cell_t *intro,
  99                                       char **err_msg_out);
 100 int rend_service_validate_intro_late(const rend_intro_cell_t *intro,
 101                                      char **err_msg_out);
 102 void rend_service_relaunch_rendezvous(origin_circuit_t *oldcirc);
 103 int rend_service_set_connection_addr_port(edge_connection_t *conn,
 104                                           origin_circuit_t *circ);
 105 void rend_service_dump_stats(int severity);
 106 void rend_service_free_all(void);
 107
 108 #endif
 109