c-ares 13.0.0

A Rust wrapper for the c-ares library, for asynchronous DNS requests.
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

// Most of our lookups follow the same pattern - macro out the repetition.
macro_rules! ares_call {
    (
        $ares_call:ident,
        $channel:expr,
        $name:expr,
        $dns_class:expr,
        $query_type:expr,
        $callback:expr,
        $handler:expr
    ) => {{
        let Ok(c_name) = CString::new($name) else {
            $handler(Err(Error::EBADNAME));
            return;
        };
        let c_arg = Box::into_raw(Box::new($handler));
        unsafe {
            c_ares_sys::$ares_call(
                $channel,
                c_name.as_ptr(),
                $dns_class as c_int,
                $query_type as c_int,
                Some($callback),
                c_arg.cast(),
            );
        }
    }};
}

macro_rules! ares_query {
    ($($arg:tt)*) => { ares_call!(ares_query, $($arg)*) }
}

macro_rules! ares_search {
    ($($arg:tt)*) => { ares_call!(ares_search, $($arg)*) }
}

// Most of our `ares_callback` implementations are much the same - macro out the repetition.
macro_rules! ares_callback {
    ($arg:expr, $status:expr, $abuf:expr, $alen:expr, $parser:expr) => {{
        let result = if $status == c_ares_sys::ares_status_t::ARES_SUCCESS as i32 {
            debug_assert!(
                $alen >= 0,
                "ares_callback received negative alen on success"
            );
            let data = unsafe { slice::from_raw_parts($abuf, $alen as usize) };
            $parser(data)
        } else {
            Err(Error::from($status))
        };
        let handler = unsafe { Box::from_raw($arg) };
        panic::abort_on_panic(|| handler(result));
    }};
}