Struct KissOfDeathError 

pub struct KissOfDeathError {
    pub code: KissOfDeath,
}

Error returned when the server responds with a Kiss-o’-Death (KoD) packet.

Per RFC 5905 Section 7.4, recipients of kiss codes MUST inspect them and take the described actions. This error is returned as the inner error of an io::Error with kind io::ErrorKind::ConnectionRefused, and can be extracted via io::Error::get_ref and downcast_ref.

Caller Responsibilities

• DENY / RSTR: The caller MUST stop sending packets to this server.
• RATE: The caller MUST reduce its polling interval before retrying.

Examples

match ntp::request("time.nist.gov:123") {
    Ok(result) => println!("Offset: {:.6}s", result.offset_seconds),
    Err(e) => {
        if let Some(kod) = e.get_ref().and_then(|inner| inner.downcast_ref::<ntp::KissOfDeathError>()) {
            eprintln!("Kiss-o'-Death: {:?}", kod.code);
        }
    }
}

Fields

code: KissOfDeath

The specific kiss code received from the server.

Trait Implementations

impl Clone for KissOfDeathError

fn clone(&self) -> KissOfDeathError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KissOfDeathError

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

Formats the value using the given formatter.

impl Display for KissOfDeathError

Available on crate feature std only.

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

Formats the value using the given formatter.

impl Error for KissOfDeathError

Available on crate feature std only.

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl Copy for KissOfDeathError