rice-c 0.4.2

ICE (RFC8445) implementation protocol
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

// Copyright (C) 2025 Matthew Waters <matthew@centricular.com>
//
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
// option. This file may not be copied, modified, or distributed
// except according to those terms.
//
// SPDX-License-Identifier: MIT OR Apache-2.0

//! FFI module for the raw `rice-proto` C API.

#![allow(non_camel_case_types)]
#![allow(non_upper_case_globals)]
#![allow(unused)]
#![allow(missing_debug_implementations)]
#![allow(missing_docs)]

use crate::mut_override;

#[cfg(docsrs)]
include!("bindings.rs");
#[cfg(not(docsrs))]
include!(concat!(env!("OUT_DIR"), "/bindings.rs"));

impl Default for RiceStreamIncomingData {
    fn default() -> Self {
        Self {
            handled: false,
            have_more_data: false,
            data: RiceDataImpl {
                ptr: core::ptr::null_mut(),
                size: 0,
            },
        }
    }
}

impl RiceDataImpl {
    pub(crate) fn to_c(slice: &[u8]) -> Self {
        Self {
            ptr: mut_override(slice.as_ptr()),
            size: slice.len(),
        }
    }
}

impl RiceData {
    pub(crate) fn to_c_owned(slice: &[u8]) -> Self {
        RiceData {
            tag: RICE_DATA_OWNED,
            field1: RiceData__bindgen_ty_1 {
                field2: core::mem::ManuallyDrop::new(RiceData__bindgen_ty_1__bindgen_ty_2 {
                    owned: RiceDataImpl::to_c(slice),
                }),
            },
        }
    }
}

impl RiceGatheredCandidate {
    pub(crate) unsafe fn zeroed() -> Self {
        unsafe {
            RiceGatheredCandidate {
                candidate: RiceCandidate::zeroed(),
                turn_agent: core::ptr::null_mut(),
            }
        }
    }
}

impl RiceCandidate {
    pub(crate) unsafe fn zeroed() -> Self {
        RiceCandidate {
            component_id: 1,
            candidate_type: RICE_CANDIDATE_TYPE_HOST,
            transport_type: RICE_TRANSPORT_TYPE_UDP,
            foundation: core::ptr::null_mut(),
            priority: 0,
            address: core::ptr::null(),
            base_address: core::ptr::null(),
            related_address: core::ptr::null(),
            tcp_type: RICE_TCP_TYPE_NONE,
            extensions: core::ptr::null_mut(),
            extensions_len: 0,
        }
    }
}

impl Clone for RiceCandidate {
    fn clone(&self) -> Self {
        unsafe {
            let mut ret = RiceCandidate::zeroed();
            crate::ffi::rice_candidate_copy_into(self, &mut ret);
            ret
        }
    }
}

impl core::fmt::Debug for RiceAddress {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let addr = crate::Address::from_c_none(self);
        write!(f, "{addr:?}")
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn rice_candidate_clone_zeroed() {
        let _log = crate::tests::test_init_log();

        unsafe {
            let zeroed = RiceCandidate::zeroed();
            let _cloned = zeroed.clone();
        }
    }
}