Module config 

Configuration keys and I/O for hyperactor.

This module declares hyperactor-specific config keys.

Structs

PemBundle

A bundle of PEM files for TLS configuration: CA certificate, server/client certificate, and private key.

Enums

Pem

Stores a PEM-encoded value, either specified directly or read from a file.

Statics

CHANNEL_NET_RX_BUFFER_FULL_CHECK_INTERVAL

How often to check for full MPSC channel on NetRx.

CHANNEL_RECONNECT_TIMEOUT

Maximum time Link::next() spends retrying a failed connect before giving up. Pairs with TCP keepalive: keepalive surfaces peer death as an I/O error, then the connect-retry loop quits after this bound and the outer NetTx loop terminates the link with TxStatus::Closed.

CHANNEL_TCP_KEEPALIVE_IDLE

Kernel TCP keepalive idle period: the gap from last activity until the kernel sends its first probe on connections created by hyperactor’s channel layer. On a healthy idle connection this is also the probe cadence (each ACK resets the timer). Total peer-death detection time is idle + probe_budget where probe_budget = TCP_KEEPALIVE_INTERVAL * TCP_KEEPALIVE_RETRIES (private constants in channel::net, currently 15s). Larger values reduce keepalive ACK traffic at the cost of slower peer-death detection.

CLEANUP_TIMEOUT

Timeout used by proc for running the cleanup callback on an actor. Should be less than the timeout for STOP_ACTOR_TIMEOUT.

CODEC_MAX_FRAME_LENGTH

Maximum frame length for codec

ENABLE_DEST_ACTOR_REORDERING_BUFFER

Whether to enable dest actor reordering buffer.

FORWARDER_FLUSH_TIMEOUT

Timeout for best-effort forwarder flush during proc/actor teardown. If the remote side has already torn down its networking, acks may never arrive; this timeout prevents the flush from hanging indefinitely.

HOST_SPAWN_READY_TIMEOUT

Timeout for [Host::spawn] to await proc readiness.

MESSAGE_ACK_EVERY_N_MESSAGES

Number of messages after which to send an acknowledgment

MESSAGE_ACK_TIME_INTERVAL

Message acknowledgment interval

MESSAGE_DELIVERY_TIMEOUT

Message delivery timeout

MESSAGE_LATENCY_SAMPLING_RATE

Sampling rate for logging message latency Set to 0.01 for 1% sampling, 0.1 for 10% sampling, 0.90 for 90% sampling, etc.

MESSAGE_TTL_DEFAULT

Default hop Time-To-Live for message envelopes.

PROCESS_EXIT_TIMEOUT

Timeout to stop a proc.

SERVER_HEARTBEAT_INTERVAL

Heartbeat interval for server health metrics. The server emits a heartbeat metric at this interval to indicate it is alive.

SPLIT_MAX_BUFFER_AGE

The maximum time an update can be buffered before being reduced.

SPLIT_MAX_BUFFER_SIZE

Maximum buffer size for split port messages

STOP_ACTOR_TIMEOUT

Timeout used by proc mesh for stopping an actor.

TERMINATED_SNAPSHOT_RETENTION

Maximum number of terminated actor snapshots retained per proc for post-mortem introspection. When the limit is exceeded, the oldest entries are evicted.

TLS_CA

Path to TLS CA certificate file for the ‘tls’ transport.

TLS_CERT

Path to TLS certificate file for the ‘tls’ transport.

TLS_KEY

Path to TLS private key file for the ‘tls’ transport.