Enum KissOfDeathCode 

#[non_exhaustive]
pub enum KissOfDeathCode {
    Acst,
    Auth,
    Auto,
    Bcst,
    Cryp,
    Deny,
    Drop,
    Rstr,
    Init,
    Mcst,
    Nkey,
    Rate,
    Rmot,
    Step,
    Experimental([u8; 4]),
}

Kiss-o’-Death code received from an NTP server (RFC 5905 §7.4).

When a server sends a packet with stratum 0, the Reference Identifier field carries a 4-character ASCII kiss code. Different codes require different client actions:

• Deny and Rstr: callers MUST stop using that server.
• Rate: callers SHOULD back off / reduce their polling interval.
• Experimental: codes beginning with ‘X’ are for unregistered experimentation and should be ignored if unrecognized by the caller.
• KoD packets carry server-supplied timestamps, but callers MUST NOT rely on them as normal time results.
• All other codes: No protocol significance; discard after inspection.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Acst

ACST: The association belongs to a unicast server

Auth

AUTH: Server authentication failed

Auto

AUTO: Autokey sequence failed

Bcst

BCST: The association belongs to a broadcast server

Cryp

CRYP: Cryptographic authentication or identification failed

Deny

DENY: Access denied by remote server

Drop

DROP: Lost peer in symmetric mode

Rstr

RSTR: Access denied due to local policy

Init

INIT: The association has not yet synchronized for the first time

Mcst

MCST: The association belongs to a dynamically discovered server

Nkey

NKEY: No key found

Rate

RATE: Rate exceeded — client MUST reduce a polling interval

Rmot

RMOT: Alteration of association from a remote host

Step

STEP: A step change in system time has occurred

Experimental([u8; 4])

Experimental/unregistered code (the first byte is ‘X’ per RFC 5905 §7.4)

Implementations

impl KissOfDeathCode

pub fn as_str(&self) -> &str

Returns the 4-character ASCII string representation of the kiss code.

For known variants, the standard code string (e.g., "DENY", "RATE") is returned. For Experimental codes, the raw bytes are interpreted as UTF-8; if not valid UTF-8, an empty string ("") is returned.

Trait Implementations

impl Clone for KissOfDeathCode

fn clone(&self) -> KissOfDeathCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for KissOfDeathCode

impl Debug for KissOfDeathCode

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

Formats the value using the given formatter.

impl Eq for KissOfDeathCode

impl PartialEq for KissOfDeathCode

fn eq(&self, other: &KissOfDeathCode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for KissOfDeathCode