Skip to main content

Module gather

Module gather 

Source
Expand description

Gathering local candidates, and the description they make (RFC 8445 §5.1.1, RFC 8839 §5.1, §13.2; spec §5, §15).

Two kinds of candidate, and both come from sockets that are already bound. A host candidate is what MediaPort got from the OS. A server-reflexive one is what a STUN server says it sees, obtained over sipx_transport::stun — the Binding client that already exists, because spec §15 says a second one would be a second thing to get wrong.

The candidates are priced by the agent and not here. §5.1.1.3’s foundation and §5.1.2.1’s local preference are properties of the whole gathered set — “MUST be unique for each” candidate of a type — and are not facts any single candidate knows about itself, so what this module produces is a stream of Gathered and what it reads back is Agent::local_candidates.

Structs§

Gathering
Everything gathering needs that the sockets do not already supply.
LocalDescription
What sipx will put in its own description, and the agent that will drive it.