Struct Check 

pub struct Check { /* private fields */ }

Result of a single network connectivity check.

Contains all information about a check attempt including:

• When it was performed
• What type of check it was
• Whether it succeeded
• Measured latency (if successful)
• Target address

Implementations

impl Check

pub fn get_hash(&self) -> Hash

Generates a cryptographic hash of the Check data.

Uses blake3 for consistent hashing across Rust versions and platforms. The hash remains stable as long as the check’s contents don’t change, making it suitable for persistent identification of checks.

Implementation Details

• Uses bincode for serialization of check data
• Uses blake3 for cryptographic hashing
• Produces a 32-byte (256-bit) hash

Panics

May panic if serialization fails, which can happen in extreme cases:

• System is out of memory
• System is in a severely degraded state

Normal Check data will always serialize successfully.

pub fn new( time: impl Into<DateTime<Utc>>, flags: impl Into<FlagSet<CheckFlag>>, latency: Option<u16>, target: IpAddr, ) -> Self

Creates a new check result with the specified properties.

This does not execute a check and then store the information about that check in this datastructure, it simply allows the creation of arbitrary check results

Arguments

• time - When the check was performed
• flags - Initial status flags
• latency - Measured latency (if successful)
• target - Target IP address

Panics

Panics if timestamp is before UNIX_EPOCH.

pub fn is_success(&self) -> bool

Returns whether this check was successful.

A check is considered successful if it has the Success flag and no unexpected flag combinations.

pub fn latency(&self) -> Option<u16>

Returns the measured latency if check was successful.

Returns None if:

• Check failed
• Check succeeded but no latency was recorded

pub fn flags(&self) -> FlagSet<CheckFlag>

Returns the flags of this Check.

pub fn timestamp(&self) -> i64

Returns the timestamp of this Check.

pub fn timestamp_parsed(&self) -> DateTime<Local>

Returns the timestamp of this Check as SystemTime.

The Check structure stores just seconds since UNIX_EPOCH, which is agnostic of timezones. The seconds since the UNIX_EPOCH (1970-01-01 00:00) are converted to a timestamp in UTC, and just for the formatting the timestamp is converted to the timezone of the user.

pub fn flags_mut(&mut self) -> &mut FlagSet<CheckFlag>

Returns a mutable reference to the flags of this Check.

pub fn add_flag(&mut self, flag: CheckFlag)

Add the given flag to the flags of this Check

pub fn calc_type(&self) -> Result<CheckType, StoreError>

Determines CheckType from this checks flags.

Examines the type and protocol flags to determine the specific kind of check that was performed.

Returns CheckType::Unknown if flags indicate an invalid combination.

pub fn set_target(&mut self, target: IpAddr)

Updates the target IP address of this check.

pub fn ip_type(&self) -> IpType

Determines whether the check used IPv4 or IPv6.

Examines the check’s target to determine which IP version was used.

Returns

The IpType that was used

pub fn migrate(&mut self, current: Version) -> Result<(), StoreError>

Migrate a Check to the next Version that follows current

pub fn target(&self) -> IpAddr

Returns the target of this Check.

Trait Implementations

impl Clone for Check

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Check

impl Debug for Check

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

Formats the value using the given formatter.

impl DeepSizeOf for Check

fn deep_size_of_children(&self, context: &mut Context) -> usize

Returns an estimation of the heap-managed storage of this object. This does not include the size of the object itself.

fn deep_size_of(&self) -> usize

Returns an estimation of a total size of memory owned by the object, including heap-managed storage.

impl<'de> Deserialize<'de> for Check

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Check

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

Formats the value using the given formatter.

impl Eq for Check

impl Hash for Check

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Check

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

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

Restrict a value to a certain range.

impl PartialEq for Check

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Check

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Check

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Check