Implements the details of exteding circuits (by relaying extend cells as create cells, and answering create cells). More...

#include "orconfig.h"
#include "feature/relay/circuitbuild_relay.h"
#include "lib/crypt_ops/crypto_rand.h"
#include "core/or/or.h"
#include "app/config/config.h"
#include "core/crypto/relay_crypto.h"
#include "core/or/cell_st.h"
#include "core/or/circuit_st.h"
#include "core/or/extend_info_st.h"
#include "core/or/or_circuit_st.h"
#include "core/or/channel.h"
#include "core/or/circuitbuild.h"
#include "core/or/circuitlist.h"
#include "core/or/extendinfo.h"
#include "core/or/onion.h"
#include "core/or/relay.h"
#include "feature/nodelist/nodelist.h"
#include "feature/relay/router.h"
#include "feature/relay/routermode.h"
#include "feature/relay/selftest.h"

Macros
#define	IPV6_CONNECTION_ONE_IN_N 2

Functions
STATIC int	circuit_extend_state_valid_helper (const struct circuit_t *circ)

STATIC int	circuit_extend_add_ed25519_helper (struct extend_cell_t *ec)

STATIC int	circuit_extend_add_ipv4_helper (struct extend_cell_t *ec)

STATIC int	circuit_extend_add_ipv6_helper (struct extend_cell_t *ec)

static bool	circuit_extend_addr_port_is_valid (const struct tor_addr_port_t *ap, bool log_zero_addrs, bool log_internal_addrs, int log_level)

STATIC int	circuit_extend_lspec_valid_helper (const struct extend_cell_t ec, const struct circuit_t circ)

STATIC const tor_addr_port_t *	circuit_choose_ip_ap_for_extend (const tor_addr_port_t ipv4_ap, const tor_addr_port_t ipv6_ap)

STATIC void	circuit_open_connection_for_extend (const struct extend_cell_t ec, struct circuit_t circ, int should_launch)

int	circuit_extend (struct cell_t cell, struct circuit_t circ)

int	onionskin_answer (struct or_circuit_t circ, const created_cell_t created_cell, const char keys, size_t keys_len, const uint8_t rend_circ_nonce)

Detailed Description

Implements the details of exteding circuits (by relaying extend cells as create cells, and answering create cells).

On the server side, this module handles the logic of responding to RELAY_EXTEND requests, using circuit_extend() and onionskin_answer().

The shared client and server code is in core/or/circuitbuild.c.

Definition in file circuitbuild_relay.c.

Function Documentation

◆ circuit_choose_ip_ap_for_extend()

STATIC const tor_addr_port_t * circuit_choose_ip_ap_for_extend	(	const tor_addr_port_t *	ipv4_ap,
		const tor_addr_port_t *	ipv6_ap
	)

Definition at line 298 of file circuitbuild_relay.c.

◆ circuit_extend()

int circuit_extend	(	struct cell_t *	cell,
		struct circuit_t *	circ
	)

Take the 'extend' cell, pull out addr/port plus the onion skin and identity digest for the next hop. If we're already connected, pass the onion skin to the next hop using a create cell; otherwise launch a new OR connection, and circ will notice when the connection succeeds or fails.

Return -1 if we want to warn and tear down the circuit, else return 0.

Definition at line 425 of file circuitbuild_relay.c.

◆ circuit_extend_add_ed25519_helper()

STATIC int circuit_extend_add_ed25519_helper ( struct extend_cell_t * ec )

Definition at line 93 of file circuitbuild_relay.c.

◆ circuit_extend_add_ipv4_helper()

STATIC int circuit_extend_add_ipv4_helper ( struct extend_cell_t * ec )

Definition at line 129 of file circuitbuild_relay.c.

◆ circuit_extend_add_ipv6_helper()

STATIC int circuit_extend_add_ipv6_helper ( struct extend_cell_t * ec )

Definition at line 152 of file circuitbuild_relay.c.

◆ circuit_extend_addr_port_is_valid()

static bool circuit_extend_addr_port_is_valid	(	const struct tor_addr_port_t *	ap,
		bool	log_zero_addrs,
		bool	log_internal_addrs,
		int	log_level
	)

static

Definition at line 183 of file circuitbuild_relay.c.

◆ circuit_extend_lspec_valid_helper()

STATIC int circuit_extend_lspec_valid_helper	(	const struct extend_cell_t *	ec,
		const struct circuit_t *	circ
	)

Definition at line 224 of file circuitbuild_relay.c.

◆ circuit_extend_state_valid_helper()

STATIC int circuit_extend_state_valid_helper ( const struct circuit_t * circ )

Definition at line 55 of file circuitbuild_relay.c.

◆ circuit_open_connection_for_extend()

STATIC void circuit_open_connection_for_extend	(	const struct extend_cell_t *	ec,
		struct circuit_t *	circ,
		int	should_launch
	)

Definition at line 350 of file circuitbuild_relay.c.

◆ onionskin_answer()

int onionskin_answer	(	struct or_circuit_t *	circ,
		const created_cell_t *	created_cell,
		const char *	keys,
		size_t	keys_len,
		const uint8_t *	rend_circ_nonce
	)

On a relay, accept a create cell, initialise a circuit, and send a created cell back.

Given:

a response payload consisting of:
- the created_cell and
- an optional rend_circ_nonce, and
keys of length keys_len, which must be CPATH_KEY_MATERIAL_LEN; then:
initialize the circuit circ's cryptographic material,
set the circuit's state to open, and
send a created cell back on that circuit.

If we haven't found our ORPorts reachable yet, and the channel meets the necessary conditions, mark the relevant ORPorts as reachable.

Returns -1 if cell or circuit initialisation fails.

Definition at line 536 of file circuitbuild_relay.c.

Macros

Functions