EntropyEngine::Networking::ConnectionConfig

EntropyEngine::Networking::ConnectionConfig

Unified connection configuration. More…

#include <ConnectionTypes.h>

Public Attributes

	Name
std::optional< std::string >	xpcServiceName macOS XPC service identifier
int	xpcReplyTimeoutMs Default reply timeout for XPC sendWithReply.
size_t	xpcMaxMessageSize Max allowed XPC payload size.
WebRTCConfig	webrtcConfig WebRTC configuration.
ConnectionType	type
int	socketSendBuf SO_SNDBUF size in bytes (0 to skip).
int	socketRecvBuf SO_RCVBUF size in bytes (0 to skip).
SignalingCallbacks	signalingCallbacks Signaling callbacks for SDP/ICE.
int	sharedMemoryWaitTimeoutMs Timeout for wake/wait operations.
size_t	sharedMemoryRegionSize Size of shared memory region (default 4 MiB).
int	sharedMemoryConnectTimeoutMs Timeout for shared memory connection handshake.
int	sendPollTimeoutMs Per-poll timeout during send retries (ms).
int	sendMaxPolls Max poll iterations before timing out a send.
int	recvIdlePollMs If >= 0, use poll(POLLIN, recvIdlePollMs) instead of fixed sleep when idle.
size_t	maxMessageSize Max message size for local transports.
std::string	endpoint Path, pipe name, or signaling server URL.
std::string	dataChannelLabel Data channel label.
int	connectTimeoutMs Connect timeout for blocking waits (Unix sockets).
ConnectionBackend	backend

Detailed Description

struct EntropyEngine::Networking::ConnectionConfig;

Unified connection configuration.

Supports both simple (Local/Remote) and advanced (explicit backend) use cases. Use the high-level helpers (openLocalConnection, openRemoteConnection) for typical scenarios, or populate this struct for advanced control.

Public Attributes Documentation

variable xpcServiceName

std::optional< std::string > xpcServiceName;

macOS XPC service identifier

variable xpcReplyTimeoutMs

int xpcReplyTimeoutMs = 5000;

Default reply timeout for XPC sendWithReply.

variable xpcMaxMessageSize

size_t xpcMaxMessageSize = DEFAULT_XPC_MAX_MESSAGE_SIZE;

Max allowed XPC payload size.

variable webrtcConfig

WebRTCConfig webrtcConfig;

WebRTC configuration.

variable type

ConnectionType type = ConnectionType::Local;

variable socketSendBuf

int socketSendBuf = 0;

SO_SNDBUF size in bytes (0 to skip).

variable socketRecvBuf

int socketRecvBuf = 0;

SO_RCVBUF size in bytes (0 to skip).

variable signalingCallbacks

SignalingCallbacks signalingCallbacks;

Signaling callbacks for SDP/ICE.

variable sharedMemoryWaitTimeoutMs

int sharedMemoryWaitTimeoutMs = 100;

Timeout for wake/wait operations.

variable sharedMemoryRegionSize

size_t sharedMemoryRegionSize                           =
DEFAULT_SHARED_MEMORY_REGION_SIZE;

Size of shared memory region (default 4 MiB).

variable sharedMemoryConnectTimeoutMs

int sharedMemoryConnectTimeoutMs = 5000;

Timeout for shared memory connection handshake.

variable sendPollTimeoutMs

int sendPollTimeoutMs = 1000;

Per-poll timeout during send retries (ms).

variable sendMaxPolls

int sendMaxPolls = 100;

Max poll iterations before timing out a send.

variable recvIdlePollMs

int recvIdlePollMs = -1;

If >= 0, use poll(POLLIN, recvIdlePollMs) instead of fixed sleep when idle.

variable maxMessageSize

size_t maxMessageSize = DEFAULT_MAX_MESSAGE_SIZE;

Max message size for local transports.

variable endpoint

std::string endpoint;

Path, pipe name, or signaling server URL.

variable dataChannelLabel

std::string dataChannelLabel = "entropy-data";

Data channel label.

variable connectTimeoutMs

int connectTimeoutMs = 5000;

Connect timeout for blocking waits (Unix sockets).

variable backend

ConnectionBackend backend = ConnectionBackend::Auto;

---

Updated on 2026-01-26 at 17:14:35 -0500