Struct openthread_sys::otDnsTxtEntry

#[repr(C)]
pub struct otDnsTxtEntry {
    pub mKey: *const c_char,
    pub mValue: *const u8,
    pub mValueLength: u16,
}

Represents a TXT record entry representing a key/value pair (RFC 6763 - section 6.3).

The string buffers pointed to by mKey and mValue MUST persist and remain unchanged after an instance of such structure is passed to OpenThread (as part of otSrpClientService instance).

An array of otDnsTxtEntry entries are used in otSrpClientService to specify the full TXT record (a list of entries).

Fields

mKey: *const c_char

The TXT record key string.

If mKey is not NULL, then it MUST be a null-terminated C string. The entry is treated as key/value pair with mValue buffer providing the value.

• The entry is encoded as follows:
  • A single string length byte followed by “key=value” format (without the quotation marks).
• In this case, the overall encoded length must be 255 bytes or less.
  • If mValue is NULL, then key is treated as a boolean attribute and encoded as “key” (with no =).
  • If mValue is not NULL but mValueLength is zero, then it is treated as empty value and encoded as “key=”.

If mKey is NULL, then mValue buffer is treated as an already encoded TXT-DATA and is appended as is in the DNS message.

mValue: *const u8

< The TXT record value or already encoded TXT-DATA (depending on mKey).

mValueLength: u16

< Number of bytes in mValue buffer.

Trait Implementations

impl Clone for otDnsTxtEntry

fn clone(&self) -> otDnsTxtEntry

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for otDnsTxtEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for otDnsTxtEntry

fn default() -> Self

Returns the “default value” for a type.

impl Copy for otDnsTxtEntry