dbus-message-parser 2.3.0

Libary to encode and decode DBus message
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

use crate::{
    DecodeError, DecodeResult, Decoder, Header, MessageFlags, MessageHeader, MessageType, Value,
};
use num_traits::FromPrimitive;
use std::collections::BTreeSet;
use std::convert::TryFrom;
use std::ops::Deref;

impl<'a, T> Decoder<'a, T>
where
    T: Deref<Target = [u8]>,
{
    pub fn message_header(&mut self) -> DecodeResult<(MessageHeader, Option<(u32, String)>)> {
        let signature = "yyyuua(yv)";

        let is_le = match self.b()? {
            0x6c => true,
            0x42 => false,
            _ => return Err(DecodeError::Endianness),
        };

        // Decode the whole header, with the header fields and without the
        // endianness flag.
        let mut header = self.value(is_le, signature)?;
        if header.len() != 6 {
            return Err(DecodeError::Header);
        }

        // Get the message type.
        let message_type = if let Value::Byte(b) = header.remove(0) {
            if let Some(message_type) = MessageType::from_u8(b) {
                message_type
            } else {
                return Err(DecodeError::Header);
            }
        } else {
            return Err(DecodeError::Header);
        };

        // Get the message flags.
        let message_flags = if let Value::Byte(b) = header.remove(0) {
            if let Some(message_flags) = MessageFlags::from_bits(b) {
                message_flags
            } else {
                return Err(DecodeError::Header);
            }
        } else {
            return Err(DecodeError::Header);
        };

        // Get the major protocol version.
        let version = if let Value::Byte(b) = header.remove(0) {
            b
        } else {
            return Err(DecodeError::Header);
        };

        // Get the length in bytes of the message body.
        let body_length = if let Value::Uint32(u) = header.remove(0) {
            u
        } else {
            return Err(DecodeError::Header);
        };

        // Get the serial number of this message.
        let serial = if let Value::Uint32(u) = header.remove(0) {
            u
        } else {
            return Err(DecodeError::Header);
        };

        let mut body_signature = None;

        // Parse the header fields.
        let mut headers = BTreeSet::new();
        if let Value::Array(a, sig) = header.remove(0) {
            if sig != "(yv)" {
                return Err(DecodeError::Header);
            }
            for h in a {
                let header = Header::try_from(h)?;
                if let Header::Signature(signature) = header {
                    body_signature = Some(signature);
                } else {
                    headers.insert(header);
                }
            }
        } else {
            return Err(DecodeError::Header);
        }

        let message_header = MessageHeader {
            is_le,
            message_type,
            message_flags,
            version,
            serial,
            headers,
        };

        if body_length == 0 {
            if body_signature.is_none() {
                Ok((message_header, None))
            } else {
                Err(DecodeError::BodySignatureMissing)
            }
        } else if let Some(signature) = body_signature {
            let body = Some((body_length, signature));
            Ok((message_header, body))
        } else {
            Err(DecodeError::BodySignatureMissing)
        }
    }
}