Expand description
FFI module for the raw rice-proto C API.
Structs§
- Credentials
- Rice
Address - Rice
Agent - Rice
Agent Component State Change - A
Componenthas changed state. - Rice
Agent Gathered Candidate - A
Componenthas gathered a candidate. - Rice
Agent Gathering Complete - A
Componenthas completed gathering. - Rice
Agent Poll - Rice
Agent Poll__ bindgen_ ty_ 1__ bindgen_ ty_ 1 - Rice
Agent Poll__ bindgen_ ty_ 1__ bindgen_ ty_ 2 - Rice
Agent Poll__ bindgen_ ty_ 1__ bindgen_ ty_ 3 - Rice
Agent Poll__ bindgen_ ty_ 1__ bindgen_ ty_ 4 - Rice
Agent Poll__ bindgen_ ty_ 1__ bindgen_ ty_ 5 - Rice
Agent Poll__ bindgen_ ty_ 1__ bindgen_ ty_ 6 - Rice
Agent Poll__ bindgen_ ty_ 1__ bindgen_ ty_ 7 - Rice
Agent Selected Pair - A new pair has been selected for a component.
- Rice
Agent Socket - A socket with the specified network 5-tuple.
- Rice
Candidate - An ICE candidate.
- Rice
Component - Rice
Data - Rice
Data Impl - A pointer to a sequence of bytes and the associated size.
- Rice
Data__ bindgen_ ty_ 1__ bindgen_ ty_ 1 - Rice
Data__ bindgen_ ty_ 1__ bindgen_ ty_ 2 - Rice
Gathered Candidate - A local candidate that has been gathered.
- Rice
Stream - Rice
Stream Incoming Data - Return value for
rice_stream_handle_incoming_data(). - Rice
TlsConfig - Rice
Transmit - Transmit the data using the specified 5-tuple.
- Rice
Turn Config
Constants§
- RICE_
ADDRESS_ FAMILY_ IPV4 - IP version 4.
- RICE_
ADDRESS_ FAMILY_ IPV6 - IP version 6.
- RICE_
AGENT_ POLL_ ALLOCATE_ SOCKET - Connect from the specified interface to the specified address. Reply (success or failure)
should be notified using
rice_agent_allocated_socket()with the same parameters. - RICE_
AGENT_ POLL_ CLOSED - The Agent is closed. No further progress will be made.
- RICE_
AGENT_ POLL_ COMPONENT_ STATE_ CHANGE - A
Componenthas changed state. - RICE_
AGENT_ POLL_ GATHERED_ CANDIDATE - A
Componenthas gathered a candidate. - RICE_
AGENT_ POLL_ GATHERING_ COMPLETE - A
Componenthas completed gathering. - RICE_
AGENT_ POLL_ REMOVE_ SOCKET - It is posible to remove the specified 5-tuple. The socket will not be referenced any further.
- RICE_
AGENT_ POLL_ SELECTED_ PAIR - A new pair has been selected for a component.
- RICE_
AGENT_ POLL_ WAIT_ UNTIL_ NANOS - Wait until the specified
Instanthas been reached (or an external event) - RICE_
CANDIDATE_ TYPE_ HOST - The candidate is a local network interface
- RICE_
CANDIDATE_ TYPE_ PEER_ REFLEXIVE - The candidate was discovered from incoming data
- RICE_
CANDIDATE_ TYPE_ RELAYED - The candidate will relay all data through an external server (TURN).
- RICE_
CANDIDATE_ TYPE_ SERVER_ REFLEXIVE - The candidate was discovered by asking an external server (STUN/TURN)
- RICE_
COMPONENT_ CONNECTION_ STATE_ CONNECTED - A
CandidatePairhas been selected for this component - RICE_
COMPONENT_ CONNECTION_ STATE_ CONNECTING - Connectivity checks are in progress for this candidate
- RICE_
COMPONENT_ CONNECTION_ STATE_ FAILED - No connection could be found for this Component
- RICE_
COMPONENT_ CONNECTION_ STATE_ NEW - Component is in initial state and no connectivity checks are in progress.
- RICE_
DATA_ BORROWED - The data is borrowed and will not be freed on destruction.
- RICE_
DATA_ OWNED - The data is owned and will be freed on destruction.
- RICE_
ERROR_ ALREADY_ IN_ PROGRESS - The operation is already in progress.
- RICE_
ERROR_ FAILED - The operation failed for an unspecified reason.
- RICE_
ERROR_ RESOURCE_ NOT_ FOUND - A required resource was not found.
- RICE_
ERROR_ SUCCESS - Not an error. The operation was completed successfully.
- RICE_
PARSE_ CANDIDATE_ ERROR_ BAD_ ADDRESS - Invalid network address.
- RICE_
PARSE_ CANDIDATE_ ERROR_ BAD_ CANDIDATE_ TYPE - Invalid candidate type.
- RICE_
PARSE_ CANDIDATE_ ERROR_ BAD_ COMPONENT_ ID - Invalid component id.
- RICE_
PARSE_ CANDIDATE_ ERROR_ BAD_ EXTENSION - Invalid extension format.
- RICE_
PARSE_ CANDIDATE_ ERROR_ BAD_ FOUNDATION - Invalid foundation value.
- RICE_
PARSE_ CANDIDATE_ ERROR_ BAD_ PRIORITY - Invalid priority value.
- RICE_
PARSE_ CANDIDATE_ ERROR_ BAD_ TRANSPORT_ TYPE - Invalid transport type.
- RICE_
PARSE_ CANDIDATE_ ERROR_ MALFORMED - Data is not well formed.
- RICE_
PARSE_ CANDIDATE_ ERROR_ NOT_ CANDIDATE - Not a candidate message.
- RICE_
PARSE_ CANDIDATE_ ERROR_ SUCCESS - No error.
- RICE_
PROTO_ MAJOR - RICE_
PROTO_ MINOR - RICE_
PROTO_ PATCH - RICE_
TCP_ TYPE_ ACTIVE - The candidate address will connect to a remote address.
- RICE_
TCP_ TYPE_ NONE - Not a TCP candidate.
- RICE_
TCP_ TYPE_ PASSIVE - The candidate will listen for incominng TCP connections.
- RICE_
TCP_ TYPE_ SO - Simultaneous open. The candidate will both listen for incoming connections, and connect to remote addresses.
- RICE_
TLS_ VARIANT_ OPENSSL - Openssl.
- RICE_
TLS_ VARIANT_ RUSTLS - Rustls.
- RICE_
TRANSPORT_ TYPE_ TCP - The TCP transport
- RICE_
TRANSPORT_ TYPE_ UDP - The UDP transport
Functions§
- rice_
address_ ⚠cmp - Compare whether two
RiceAddresses are equal. - rice_
address_ ⚠copy - Copy a
RiceAddress. - rice_
address_ ⚠free - Free a
RiceAddress. - rice_
address_ ⚠get_ address_ bytes - Retrieve the bytes of a
RiceAddress. - rice_
address_ ⚠get_ family - The address family of the
RiceAddress. - rice_
address_ ⚠get_ port - Retrieve the port of a
RiceAddress. - rice_
address_ ⚠new_ from_ bytes - Construct a
RiceAddressfrom a sequence of bytes. - rice_
address_ ⚠new_ from_ string - Create a
RiceAddressfrom a string representation of the socket address. - rice_
agent_ ⚠add_ stream - Add an ICE stream to the
RiceAgent. - rice_
agent_ ⚠add_ stun_ server - Add a STUN server to this
RiceAgent. - rice_
agent_ ⚠close - Close the
RiceAgent. - rice_
agent_ ⚠get_ controlling - Get the controlling state of the
RiceAgent. - rice_
agent_ ⚠get_ stream - Retrieve a previously added stream from the
RiceAgent. - rice_
agent_ ⚠id - Return the process-local unique id for this agent.
- rice_
agent_ ⚠new - Create a new ICE Agent.
- rice_
agent_ ⚠poll - Poll the
RiceAgentfor further progress. - rice_
agent_ ⚠poll_ clear - Clear a
RiceAgentPollof any allocated values. - rice_
agent_ ⚠poll_ init - Initialize a
RiceAgentPollwith a default value. - rice_
agent_ ⚠poll_ transmit - Poll the
RiceAgentfor a transmission to send. - rice_
agent_ ⚠ref - Increase the reference count of the
RiceAgent. - rice_
agent_ ⚠unref - Decrease the reference count of the
RiceAgent. - rice_
candidate_ ⚠clear - Clear any resources allocated within a
RiceCandidate. - rice_
candidate_ ⚠copy - Perform a deep copy of a
RiceCandidate. - rice_
candidate_ ⚠copy_ into - Perform a deep copy of a
RiceCandidate. - rice_
candidate_ ⚠eq - Free a
RiceCandidate. - rice_
candidate_ ⚠free - Free a
RiceCandidate. - rice_
candidate_ ⚠init - Construct a new
RiceCandidatewith the provided values. - rice_
candidate_ ⚠init_ from_ sdp_ string - Construct a
RiceCandidatefrom a string as formatted in an SDP and specified in RFC5245 Section 15.1. - rice_
candidate_ ⚠new - Construct a new
RiceCandidatewith the provided values. - rice_
candidate_ ⚠new_ from_ sdp_ string - Construct a
RiceCandidatefrom a string as formatted in an SDP and specified in RFC5245 Section 15.1. - rice_
candidate_ ⚠set_ base_ address - Set the base address of a
RiceCandidate. - rice_
candidate_ ⚠set_ priority - Set the base address of a
RiceCandidate. - rice_
candidate_ ⚠set_ related_ address - Set the related address of a
RiceCandidate. - rice_
candidate_ ⚠set_ tcp_ type - Set the tcp type of a
RiceCandidate. - rice_
candidate_ ⚠to_ sdp_ string - Return a SDP candidate string as specified in RFC5245 Section 15.1.
- rice_
component_ ⚠gather_ candidates - Start gathering candidates for a component with the provided local socket addresses.
- rice_
component_ ⚠get_ id - Retrieve the component id of the
RiceComponent. - rice_
component_ ⚠get_ state - Retrieve the component connection state of the
RiceComponent. - rice_
component_ ⚠get_ stream - Retrieve the component id of the
RiceComponent. - rice_
component_ ⚠ref - Increase the reference count of the
RiceComponent. - rice_
component_ ⚠selected_ pair - Retrieve the ICE candidates selected pair of the
RiceComponent. - rice_
component_ ⚠send - Send data to the connected peer.
- rice_
component_ ⚠set_ selected_ pair - Start gathering candidates for a component with the provided local socket addresses.
- rice_
component_ ⚠unref - Decrease the reference count of the
RiceComponent. - rice_
credentials_ ⚠copy - Construct a new set of ICE/TURN credentials.
- rice_
credentials_ ⚠eq - Compare two sets of Credentials.
- rice_
credentials_ ⚠free - Free a set of ICE/TURN credentials.
- rice_
credentials_ ⚠get_ ufrag_ bytes - Retrieve the
RiceCandidateufrag attribute bytes. The pre-allocated array should be 256 bytes at most. - rice_
credentials_ ⚠new - Construct a new set of ICE/TURN credentials.
- rice_
data_ ⚠len - The number of bytes in a
RiceData. - rice_
data_ ⚠ptr - The data pointer for a
RiceData. - rice_
free_ ⚠data - Free allocated data.
- rice_
random_ ⚠string - Generate a random sequence of characters suitable for username fragments and passwords.
- rice_
stream_ ⚠add_ component - Add an ICE component to a
RiceStream. - rice_
stream_ ⚠add_ local_ gathered_ candidate - Add a local
RiceGatheredCandidateto aRiceStream. - rice_
stream_ ⚠add_ remote_ candidate - Add a remote candidate to the
RiceStream. - rice_
stream_ ⚠component_ ids - Return the component ids currently in use by a
RiceStream. - rice_
stream_ ⚠end_ of_ local_ candidates - Signal the end of a set of local candidates.
- rice_
stream_ ⚠end_ of_ remote_ candidates - Signal the end of a set of remote candidates.
- rice_
stream_ ⚠get_ agent - Retrieve the
RiceAgentof theRiceStream. - rice_
stream_ ⚠get_ component - Retrieve a previously added
RiceComponent. - rice_
stream_ ⚠get_ id - Retrieve the stream id of the
RiceStream. - rice_
stream_ ⚠get_ local_ credentials - Retrieve the local ICE credentials currently set on the
RiceStream. - rice_
stream_ ⚠get_ remote_ credentials - Retrieve the remote ICE credentials currently set on the
RiceStream. - rice_
stream_ ⚠handle_ allocated_ socket - Notify success or failure to create a socket to the
RiceStream. - rice_
stream_ ⚠handle_ incoming_ data - Provide data to the
RiceStreamfor processing. - rice_
stream_ ⚠poll_ recv - Poll for further application data that has been received.
- rice_
stream_ ⚠ref - Increase the reference count of the
RiceStream. - rice_
stream_ ⚠set_ local_ credentials - Set the local credentials to use for this
RiceStream. - rice_
stream_ ⚠set_ remote_ credentials - Set the remote credentials to use for this
RiceStream. - rice_
stream_ ⚠unref - Decrease the reference count of the
RiceStream. - rice_
string_ ⚠free - Free an allocated string.
- rice_
tls_ ⚠config_ new_ openssl - Construct a new TLS configuration using Openssl.
- rice_
tls_ ⚠config_ new_ rustls_ with_ dns - Construct a new TLS configuration using Rustls.
- rice_
tls_ ⚠config_ new_ rustls_ with_ ip - Construct a new TLS configuration using Rustls.
- rice_
tls_ ⚠config_ ref - Increase the reference count of the
RiceTlsConfig. - rice_
tls_ ⚠config_ unref - Decrease the reference count of the
RiceTlsConfig. - rice_
tls_ ⚠config_ variant - The TLS variant for a
RiceTlsConfig - rice_
transmit_ ⚠clear - Free any resources allocated within a
RiceTransmit. - rice_
transmit_ ⚠init - Initialize a
RiceTransmitwith default values. - rice_
turn_ ⚠config_ get_ addr - The address of the TURN server.
- rice_
turn_ ⚠config_ get_ client_ transport - The transport to connect to the TURN server.
- rice_
turn_ ⚠config_ get_ credentials - The credentials to use for accessing the TURN server.
- rice_
turn_ ⚠config_ get_ families - The transport to connect to the TURN server.
- rice_
turn_ ⚠config_ get_ tls_ config - The TLS config associated with this TURN configuration.
- rice_
turn_ ⚠config_ new - Create a new TURN configuration.
- rice_
turn_ ⚠config_ ref - Increase the reference count of the
RiceTurnConfig. - rice_
turn_ ⚠config_ unref - Decrease the reference count of a
RiceTurnConfig. - rice_
version ⚠ - Query the built version of
rice-proto.
Type Aliases§
- Rice
Address Family - Rice
Agent Poll_ Tag - Return value of
rice_agent_poll(). - Rice
Candidate Type - Rice
Component Connection State - The state of a component
- Rice
Credentials - ICE/TURN credentials.
- Rice
Data_ Tag - A pointer to a sequence of bytes and size.
- Rice
Error - Rice
Parse Candidate Error - Rice
TcpType - Rice
TlsVariant - Rice
Transport Type