RistPeer
One RIST peer. Declaring more than one peer, all with weight 0, is how RIST does seamless redundancy: every peer carries a copy of the stream and they are merged before anything reaches the workflow, so the duplicate traffic is never paid for downstream. (RIST’s own answer to ST 2022-7; the udpTs input spells the same idea SeamlessProtection.)
Field |
Type |
Repeated |
Description |
name |
A label for logs, events and notifications. librist identifies peers only by a numeric id, which says nothing in an operator-facing message. |
||
host |
The address to bind (listener) or to dial (caller). |
||
port |
|||
listener |
true: bind and wait for a sender. false: dial |
||
local_interface |
The local interface to bind, or to join a multicast group on. |
||
virt_dst_port |
Main profile only: which virtual destination port of the GRE tunnel this peer carries. 0 = librist’s default (1968). |
||
buffer_ms |
The retransmission buffer in ms — the latency budget, and the cap on how far back a lost packet can still be recovered. 0 = librist’s default. |
||
reorder_buffer_ms |
|||
rtt_min_ms |
|||
rtt_max_ms |
|||
min_retries |
|||
max_retries |
|||
max_bitrate_kbps |
Cap on the retransmission bitrate, in kbps. 0 = librist’s default. |
||
session_timeout_ms |
|||
keepalive_interval_ms |
|||
weight |
Load-balancing weight across peers. 0 (the default) means this peer carries a copy of everything — see the message comment. |
||
secret |
Main-profile encryption. Empty secret = unencrypted. |
||
key_size |
128 or 256. 0 = librist’s default when a secret is set. |
||
key_rotation |
|||
srp_username |
Main-profile SRP, for a peer that DIALS OUT (listener = false): the credentials it proves. A listening peer checks senders against RistInputConfiguration.srp_users instead. |
||
srp_password |
|||
cname |
The cname this receiver reports in its RTCP. |
||
congestion_control |
|||
timing_mode |