hs_circuitmap.h

Go to the documentation of this file.

/* Copyright (c) 2016-2017, The Tor Project, Inc. */
/* See LICENSE for licensing information */

#ifndef TOR_HS_CIRCUITMAP_H
#define TOR_HS_CIRCUITMAP_H

typedef HT_HEAD(hs_circuitmap_ht, circuit_t) hs_circuitmap_ht;

typedef struct hs_token_s hs_token_t;
struct or_circuit_t;
struct origin_circuit_t;

struct or_circuit_t *
hs_circuitmap_get_intro_circ_v3_relay_side(const
                                           ed25519_public_key_t *auth_key);
struct or_circuit_t *
hs_circuitmap_get_intro_circ_v2_relay_side(const uint8_t *digest);
struct or_circuit_t *
hs_circuitmap_get_rend_circ_relay_side(const uint8_t *cookie);

void hs_circuitmap_register_rend_circ_relay_side(struct or_circuit_t *circ,
                                                 const uint8_t *cookie);
void hs_circuitmap_register_intro_circ_v2_relay_side(struct or_circuit_t *circ,
                                                     const uint8_t *digest);
void hs_circuitmap_register_intro_circ_v3_relay_side(struct or_circuit_t *circ,
                                         const ed25519_public_key_t *auth_key);

struct origin_circuit_t *
hs_circuitmap_get_intro_circ_v3_service_side(const
                                             ed25519_public_key_t *auth_key);
struct origin_circuit_t *
hs_circuitmap_get_intro_circ_v2_service_side(const uint8_t *digest);
struct origin_circuit_t *
hs_circuitmap_get_rend_circ_service_side(const uint8_t *cookie);
struct origin_circuit_t *
hs_circuitmap_get_rend_circ_client_side(const uint8_t *cookie);
struct origin_circuit_t *
hs_circuitmap_get_established_rend_circ_client_side(const uint8_t *cookie);

void hs_circuitmap_register_intro_circ_v2_service_side(
                                        struct origin_circuit_t *circ,
                                        const uint8_t *digest);
void hs_circuitmap_register_intro_circ_v3_service_side(
                                        struct origin_circuit_t *circ,
                                        const ed25519_public_key_t *auth_key);
void hs_circuitmap_register_rend_circ_service_side(
                                        struct origin_circuit_t *circ,
                                        const uint8_t *cookie);
void hs_circuitmap_register_rend_circ_client_side(
                                      struct origin_circuit_t *circ,
                                      const uint8_t *cookie);

void hs_circuitmap_remove_circuit(struct circuit_t *circ);

void hs_circuitmap_init(void);
void hs_circuitmap_free_all(void);

#ifdef HS_CIRCUITMAP_PRIVATE

typedef enum {
  HS_TOKEN_REND_RELAY_SIDE,
  HS_TOKEN_INTRO_V2_RELAY_SIDE,
  HS_TOKEN_INTRO_V3_RELAY_SIDE,

  HS_TOKEN_REND_SERVICE_SIDE,
  HS_TOKEN_INTRO_V2_SERVICE_SIDE,
  HS_TOKEN_INTRO_V3_SERVICE_SIDE,

  HS_TOKEN_REND_CLIENT_SIDE,
} hs_token_type_t;

struct hs_token_s {
  /* Type of HS token. */
  hs_token_type_t type;

  /* The size of the token (depends on the type). */
  size_t token_len;

  /* The token itself. Memory allocated at runtime. */
  uint8_t *token;
};

#endif /* defined(HS_CIRCUITMAP_PRIVATE) */

#ifdef TOR_UNIT_TESTS

hs_circuitmap_ht *get_hs_circuitmap(void);

#endif /* TOR_UNIT_TESTS */

#endif /* !defined(TOR_HS_CIRCUITMAP_H) */