[PATCH net-next v2 2/6] rust: time: Introduce Delta type

From: FUJITA Tomonori
Date: Sat Oct 05 2024 - 08:27:15 EST


Introduce a type representing a span of time. Define our own type
because `core::time::Duration` is large and could panic during
creation.

We could use time::Ktime for time duration but timestamp and timedelta
are different so better to use a new type.

Signed-off-by: FUJITA Tomonori <fujita.tomonori@xxxxxxxxx>
---
rust/kernel/time.rs | 64 +++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 64 insertions(+)

diff --git a/rust/kernel/time.rs b/rust/kernel/time.rs
index c40105941a2c..6c5a1c50c5f1 100644
--- a/rust/kernel/time.rs
+++ b/rust/kernel/time.rs
@@ -8,9 +8,15 @@
//! C header: [`include/linux/jiffies.h`](srctree/include/linux/jiffies.h).
//! C header: [`include/linux/ktime.h`](srctree/include/linux/ktime.h).

+/// The number of nanoseconds per microsecond.
+pub const NSEC_PER_USEC: i64 = bindings::NSEC_PER_USEC as i64;
+
/// The number of nanoseconds per millisecond.
pub const NSEC_PER_MSEC: i64 = bindings::NSEC_PER_MSEC as i64;

+/// The number of nanoseconds per second.
+pub const NSEC_PER_SEC: i64 = bindings::NSEC_PER_SEC as i64;
+
/// The time unit of Linux kernel. One jiffy equals (1/HZ) second.
pub type Jiffies = core::ffi::c_ulong;

@@ -103,3 +109,61 @@ fn partial_cmp(&self, other: &Self) -> Option<core::cmp::Ordering> {
}
}
}
+
+/// A span of time.
+#[derive(Copy, Clone)]
+pub struct Delta {
+ nanos: i64,
+}
+
+impl Delta {
+ /// Create a new `Delta` from a number of nanoseconds.
+ #[inline]
+ pub fn from_nanos(nanos: u16) -> Self {
+ Self {
+ nanos: nanos.into(),
+ }
+ }
+
+ /// Create a new `Delta` from a number of microseconds.
+ #[inline]
+ pub fn from_micros(micros: u16) -> Self {
+ Self {
+ nanos: micros as i64 * NSEC_PER_USEC,
+ }
+ }
+
+ /// Create a new `Delta` from a number of milliseconds.
+ #[inline]
+ pub fn from_millis(millis: u16) -> Self {
+ Self {
+ nanos: millis as i64 * NSEC_PER_MSEC,
+ }
+ }
+
+ /// Create a new `Delta` from a number of seconds.
+ #[inline]
+ pub fn from_secs(secs: u16) -> Self {
+ Self {
+ nanos: secs as i64 * NSEC_PER_SEC,
+ }
+ }
+
+ /// Return `true` if the `Detla` spans no time.
+ #[inline]
+ pub fn is_zero(self) -> bool {
+ self.nanos == 0
+ }
+
+ /// Return the number of nanoseconds in the `Delta`.
+ #[inline]
+ pub fn as_nanos(self) -> i64 {
+ self.nanos
+ }
+
+ /// Return the number of microseconds in the `Delta`.
+ #[inline]
+ pub fn as_micros(self) -> i64 {
+ self.nanos / NSEC_PER_USEC
+ }
+}
--
2.34.1