establish.h File Reference

Go to the source code of this file.

Data Structures
struct	network_establish_config_t
struct	network_establish_result_t
	This is the handoff point for network establish config. Callers fill name, address, default_port, connect before passing it on; consumers read the values during the operation and return ownership only where the member contract explicitly says they do. More...

Typedefs
typedef asciichat_error_t(*	network_connection_prepare_fn) (network_connection_t *, const connection_endpoint_t *, const char *, void *)

Functions
asciichat_error_t	network_connection_establish (const network_establish_config_t *config, network_connection_t **owner, network_establish_result_t *attempt)

Typedef Documentation

network_connection_prepare_fn

typedef asciichat_error_t(* network_connection_prepare_fn) (network_connection_t *, const connection_endpoint_t *, const char *, void *)

Definition at line 5 of file establish.h.

Function Documentation

network_connection_establish()

asciichat_error_t network_connection_establish	(	const network_establish_config_t *	config,
		network_connection_t **	owner,
		network_establish_result_t *	attempt )

Definition at line 3 of file lib/network/establish.c.

                                                                                    {
  if (!config || !owner || *owner || !attempt || !config->prepare || config->protocol > NETWORK_PROTOCOL_DISCOVERY)
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid connection establishment parameters");
  *attempt = (network_establish_result_t){0};
  asciichat_error_t result = network_connection_open(config->name, config->address, config->default_port,
                                                     config->connect, owner, &attempt->endpoint);
  if (result != ASCIICHAT_OK)
    return result;
  result = config->prepare(*owner, &attempt->endpoint, config->password, config->context);
  if (result != ASCIICHAT_OK)
    return result;
  crypto_handshake_context_t *handshake = network_connection_handshake(*owner);
  handshake->defer_password_prompt = true;
  uint8_t mode = network_connection_crypto_mode(*owner);
  if (config->authenticate)
    mode |= ACIP_CRYPTO_AUTH;
  result = network_client_negotiate(network_connection_transport(*owner), handshake, mode, config->protocol);
  attempt->password_failure = handshake->password_failure;
  if (result == ASCIICHAT_OK)
    network_connection_ready(*owner);
  return result;
}

References ACIP_CRYPTO_AUTH, network_establish_config_t::address, ASCIICHAT_OK, network_establish_config_t::authenticate, network_establish_config_t::connect, network_establish_config_t::context, network_establish_config_t::default_port, crypto_handshake_context_t::defer_password_prompt, network_establish_result_t::endpoint, ERROR_INVALID_PARAM, network_establish_config_t::name, network_client_negotiate(), network_connection_crypto_mode(), network_connection_handshake(), network_connection_open(), network_connection_ready(), network_connection_transport(), NETWORK_PROTOCOL_DISCOVERY, network_establish_config_t::password, crypto_handshake_context_t::password_failure, network_establish_result_t::password_failure, network_establish_config_t::prepare, network_establish_config_t::protocol, and SET_ERRNO.

Referenced by session_connection_establish().