Squashed 'third_party/rawrtc/rawrtc-data-channel/' content from commit 7b1b8d57c
Change-Id: I84850720e2b51961981d55f67238f4d282314fff
git-subtree-dir: third_party/rawrtc/rawrtc-data-channel
git-subtree-split: 7b1b8d57c6d07da18cc0de8bbca8cc5e8bd06eae
diff --git a/src/data_channel_parameters/attributes.c b/src/data_channel_parameters/attributes.c
new file mode 100644
index 0000000..f09deb6
--- /dev/null
+++ b/src/data_channel_parameters/attributes.c
@@ -0,0 +1,138 @@
+#include "parameters.h"
+#include <rawrtcdc/data_channel.h>
+#include <rawrtcdc/data_channel_parameters.h>
+#include <rawrtcc/code.h>
+#include <re.h>
+
+/*
+ * Get the label from the data channel parameters.
+ * `*labelp` will be set to a copy of the parameter's label and must be
+ * unreferenced.
+ *
+ * Return `RAWRTC_CODE_NO_VALUE` in case no label has been set.
+ * Otherwise, `RAWRTC_CODE_SUCCESS` will be returned and `*parameters*
+ * must be unreferenced.
+ */
+enum rawrtc_code rawrtc_data_channel_parameters_get_label(
+ char** const labelp, // de-referenced
+ struct rawrtc_data_channel_parameters* const parameters) {
+ // Check arguments
+ if (!labelp || !parameters) {
+ return RAWRTC_CODE_INVALID_ARGUMENT;
+ }
+
+ // Set value
+ if (parameters->label) {
+ *labelp = mem_ref(parameters->label);
+ return RAWRTC_CODE_SUCCESS;
+ } else {
+ return RAWRTC_CODE_NO_VALUE;
+ }
+}
+
+/*
+ * Get the channel type from the data channel parameters.
+ */
+enum rawrtc_code rawrtc_data_channel_parameters_get_channel_type(
+ enum rawrtc_data_channel_type* const channel_typep, // de-referenced
+ struct rawrtc_data_channel_parameters* const parameters) {
+ // Check arguments
+ if (!channel_typep || !parameters) {
+ return RAWRTC_CODE_INVALID_ARGUMENT;
+ }
+
+ // Set value
+ *channel_typep = parameters->channel_type;
+ return RAWRTC_CODE_SUCCESS;
+}
+
+/*
+ * Get the reliability parameter from the data channel parameters.
+ *
+ * Return `RAWRTC_CODE_NO_VALUE` in case the channel type is
+ * `RAWRTC_DATA_CHANNEL_TYPE_RELIABLE_*`. Otherwise,
+ * `RAWRTC_CODE_SUCCESS` will be returned.
+ */
+enum rawrtc_code rawrtc_data_channel_parameters_get_reliability_parameter(
+ uint32_t* const reliability_parameterp, // de-referenced
+ struct rawrtc_data_channel_parameters* const parameters) {
+ // Check arguments
+ if (!reliability_parameterp || !parameters) {
+ return RAWRTC_CODE_INVALID_ARGUMENT;
+ }
+
+ // Set value
+ switch (parameters->channel_type) {
+ case RAWRTC_DATA_CHANNEL_TYPE_RELIABLE_ORDERED:
+ case RAWRTC_DATA_CHANNEL_TYPE_RELIABLE_UNORDERED:
+ return RAWRTC_CODE_NO_VALUE;
+ default:
+ *reliability_parameterp = parameters->reliability_parameter;
+ return RAWRTC_CODE_SUCCESS;
+ }
+}
+
+/*
+ * Get the protocol from the data channel parameters.
+ * `*protocolp` will be set to a copy of the parameter's protocol and
+ * must be unreferenced.
+ *
+ * Return `RAWRTC_CODE_NO_VALUE` in case no protocol has been set.
+ * Otherwise, `RAWRTC_CODE_SUCCESS` will be returned and `*protocolp*
+ * must be unreferenced.
+ */
+enum rawrtc_code rawrtc_data_channel_parameters_get_protocol(
+ char** const protocolp, // de-referenced
+ struct rawrtc_data_channel_parameters* const parameters) {
+ // Check arguments
+ if (!protocolp || !parameters) {
+ return RAWRTC_CODE_INVALID_ARGUMENT;
+ }
+
+ // Set value
+ if (parameters->protocol) {
+ *protocolp = mem_ref(parameters->protocol);
+ return RAWRTC_CODE_SUCCESS;
+ } else {
+ return RAWRTC_CODE_NO_VALUE;
+ }
+}
+
+/*
+ * Get the 'negotiated' flag from the data channel parameters.
+ */
+enum rawrtc_code rawrtc_data_channel_parameters_get_negotiated(
+ bool* const negotiatedp, // de-referenced
+ struct rawrtc_data_channel_parameters* const parameters) {
+ // Check arguments
+ if (!negotiatedp || !parameters) {
+ return RAWRTC_CODE_INVALID_ARGUMENT;
+ }
+
+ // Set value
+ *negotiatedp = parameters->negotiated;
+ return RAWRTC_CODE_SUCCESS;
+}
+
+/*
+ * Get the negotiated id from the data channel parameters.
+ *
+ * Return `RAWRTC_CODE_NO_VALUE` in case the 'negotiated' flag is set
+ * `false`. Otherwise, `RAWRTC_CODE_SUCCESS` will be returned.
+ */
+enum rawrtc_code rawrtc_data_channel_parameters_get_id(
+ uint16_t* const idp, // de-referenced
+ struct rawrtc_data_channel_parameters* const parameters) {
+ // Check arguments
+ if (!idp || !parameters) {
+ return RAWRTC_CODE_INVALID_ARGUMENT;
+ }
+
+ // Set value
+ if (parameters->negotiated) {
+ *idp = parameters->id;
+ return RAWRTC_CODE_SUCCESS;
+ } else {
+ return RAWRTC_CODE_NO_VALUE;
+ }
+}
diff --git a/src/data_channel_parameters/meson.build b/src/data_channel_parameters/meson.build
new file mode 100644
index 0000000..c68f3a1
--- /dev/null
+++ b/src/data_channel_parameters/meson.build
@@ -0,0 +1,4 @@
+sources += files([
+ 'attributes.c',
+ 'parameters.c',
+])
diff --git a/src/data_channel_parameters/parameters.c b/src/data_channel_parameters/parameters.c
new file mode 100644
index 0000000..189850a
--- /dev/null
+++ b/src/data_channel_parameters/parameters.c
@@ -0,0 +1,152 @@
+#include "parameters.h"
+#include <rawrtcdc/data_channel.h>
+#include <rawrtcdc/data_channel_parameters.h>
+#include <rawrtcc/code.h>
+#include <rawrtcc/utils.h>
+#include <re.h>
+
+/*
+ * Destructor for existing data channel parameters.
+ */
+static void rawrtc_data_channel_parameters_destroy(void* arg) {
+ struct rawrtc_data_channel_parameters* const parameters = arg;
+
+ // Un-reference
+ mem_deref(parameters->label);
+ mem_deref(parameters->protocol);
+}
+
+/*
+ * Common code to create or copy parameters.
+ */
+static enum rawrtc_code data_parameters_create(
+ struct rawrtc_data_channel_parameters** const parametersp, // de-referenced
+ char* const label, // referenced, nullable
+ enum rawrtc_data_channel_type const channel_type,
+ uint32_t const reliability_parameter,
+ char* const protocol, // referenced, nullable
+ bool const negotiated,
+ uint16_t const id) {
+ struct rawrtc_data_channel_parameters* parameters;
+
+ // Check arguments
+ if (!parametersp) {
+ return RAWRTC_CODE_INVALID_ARGUMENT;
+ }
+
+ // Allocate
+ parameters = mem_zalloc(sizeof(*parameters), rawrtc_data_channel_parameters_destroy);
+ if (!parameters) {
+ return RAWRTC_CODE_NO_MEMORY;
+ }
+
+ // Set fields
+ parameters->label = label;
+ parameters->protocol = protocol;
+ parameters->channel_type = channel_type;
+ parameters->negotiated = negotiated;
+ if (negotiated) {
+ parameters->id = id;
+ }
+
+ // Set reliability parameter
+ switch (channel_type) {
+ case RAWRTC_DATA_CHANNEL_TYPE_RELIABLE_ORDERED:
+ case RAWRTC_DATA_CHANNEL_TYPE_RELIABLE_UNORDERED:
+ parameters->reliability_parameter = 0;
+ break;
+ default:
+ parameters->reliability_parameter = reliability_parameter;
+ break;
+ }
+
+ // Set pointer & done
+ *parametersp = parameters;
+ return RAWRTC_CODE_SUCCESS;
+}
+
+/*
+ * Create data channel parameters (internal).
+ */
+enum rawrtc_code rawrtc_data_channel_parameters_create_internal(
+ struct rawrtc_data_channel_parameters** const parametersp, // de-referenced
+ char* const label, // referenced, nullable
+ enum rawrtc_data_channel_type const channel_type,
+ uint32_t const reliability_parameter,
+ char* const protocol, // referenced, nullable
+ bool const negotiated,
+ uint16_t const id) {
+ enum rawrtc_code error;
+
+ // Create parameters
+ error = data_parameters_create(
+ parametersp, label, channel_type, reliability_parameter, protocol, negotiated, id);
+
+ if (!error) {
+ // Reference label & protocol
+ mem_ref(label);
+ mem_ref(protocol);
+ }
+
+ // Done
+ return error;
+}
+
+/*
+ * Create data channel parameters.
+ *
+ * For `RAWRTC_DATA_CHANNEL_TYPE_RELIABLE_*`, the reliability parameter
+ * is being ignored.
+ *
+ * When using `RAWRTC_DATA_CHANNEL_TYPE_*_RETRANSMIT`, the reliability
+ * parameter specifies the number of times a retransmission occurs if
+ * not acknowledged before the message is being discarded.
+ *
+ * When using `RAWRTC_DATA_CHANNEL_TYPE_*_TIMED`, the reliability
+ * parameter specifies the time window in milliseconds during which
+ * (re-)transmissions may occur before the message is being discarded.
+ *
+ * `*parametersp` must be unreferenced.
+ *
+ * In case `negotiated` is set to `false`, the `id` is being ignored.
+ */
+enum rawrtc_code rawrtc_data_channel_parameters_create(
+ struct rawrtc_data_channel_parameters** const parametersp, // de-referenced
+ char const* const label, // copied, nullable
+ enum rawrtc_data_channel_type const channel_type,
+ uint32_t const reliability_parameter,
+ char const* const protocol, // copied, nullable
+ bool const negotiated,
+ uint16_t const id) {
+ char* copied_label;
+ char* copied_protocol;
+ enum rawrtc_code error;
+
+ // Copy label
+ if (label) {
+ rawrtc_strdup(&copied_label, label);
+ } else {
+ copied_label = NULL;
+ }
+
+ // Copy protocol
+ if (protocol) {
+ rawrtc_strdup(&copied_protocol, protocol);
+ } else {
+ copied_protocol = NULL;
+ }
+
+ // Create parameters
+ error = data_parameters_create(
+ parametersp, copied_label, channel_type, reliability_parameter, copied_protocol, negotiated,
+ id);
+
+ if (error) {
+ // Un-reference
+ mem_deref(copied_label);
+ mem_deref(copied_protocol);
+ }
+
+ // Done
+ return error;
+}
diff --git a/src/data_channel_parameters/parameters.h b/src/data_channel_parameters/parameters.h
new file mode 100644
index 0000000..500e0a9
--- /dev/null
+++ b/src/data_channel_parameters/parameters.h
@@ -0,0 +1,25 @@
+#pragma once
+#include <rawrtcdc/data_channel.h>
+#include <rawrtcc/code.h>
+#include <re.h>
+
+/**
+ * Data channel parameters.
+ */
+struct rawrtc_data_channel_parameters {
+ char* label; // copied
+ enum rawrtc_data_channel_type channel_type;
+ uint32_t reliability_parameter; // contains either max_packet_lifetime or max_retransmit
+ char* protocol; // copied
+ bool negotiated;
+ uint16_t id;
+};
+
+enum rawrtc_code rawrtc_data_channel_parameters_create_internal(
+ struct rawrtc_data_channel_parameters** const parametersp, // de-referenced
+ char* const label, // referenced, nullable
+ enum rawrtc_data_channel_type const channel_type,
+ uint32_t const reliability_parameter,
+ char* const protocol, // referenced, nullable
+ bool const negotiated,
+ uint16_t const id);