Received-SPF: pass (google.com: domain of linux-kernel+bounces-112886-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1;
Feedback-ID: iad51458e:Fastmail
From: Boqun Feng <boqun.feng@gmail.com>
To: rust-for-linux@vger.kernel.org,
	linux-kernel@vger.kernel.org,
	Thomas Gleixner <tglx@linutronix.de>
Cc: Alice Ryhl <aliceryhl@google.com>,
	Miguel Ojeda <ojeda@kernel.org>,
	Alex Gaynor <alex.gaynor@gmail.com>,
	Wedson Almeida Filho <wedsonaf@gmail.com>,
	Boqun Feng <boqun.feng@gmail.com>,
	Gary Guo <gary@garyguo.net>,
	=?UTF-8?q?Bj=C3=B6rn=20Roy=20Baron?= <bjorn3_gh@protonmail.com>,
	benno.lossin@proton.me,
	Andreas Hindborg <a.hindborg@samsung.com>,
	John Stultz <jstultz@google.com>,
	Stephen Boyd <sboyd@kernel.org>,
	Valentin Obst <kernel@valentinobst.de>,
	Heghedus Razvan <heghedus.razvan@protonmail.com>,
	Asahi Lina <lina@asahilina.net>
Subject: [PATCH 5/5] rust: time: Add Instant::elapsed() for monotonic clocks
Date: Sun, 24 Mar 2024 15:33:39 -0700
Message-ID: <20240324223339.971934-6-boqun.feng@gmail.com>
In-Reply-To: <20240324223339.971934-1-boqun.feng@gmail.com>
References: <20240324223339.971934-1-boqun.feng@gmail.com>
Precedence: bulk
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit

This is a convenient way to do:

	t1 = Clock::now();
	...
	delta =  Clock::now() - t1;

Hence add it.

Co-developed-by: Heghedus Razvan <heghedus.razvan@protonmail.com>
Signed-off-by: Heghedus Razvan <heghedus.razvan@protonmail.com>
Co-developed-by: Asahi Lina <lina@asahilina.net>
Signed-off-by: Asahi Lina <lina@asahilina.net>
Signed-off-by: Boqun Feng <boqun.feng@gmail.com>
---
 rust/kernel/time.rs | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/rust/kernel/time.rs b/rust/kernel/time.rs
index 5cd669cbea01..cd1e45169517 100644
--- a/rust/kernel/time.rs
+++ b/rust/kernel/time.rs
@@ -114,6 +114,31 @@ fn sub(self, other: Self) -> Self::Output {
     }
 }
 
+impl<T: Clock + Monotonic> Instant<T> {
+    /// Returns the time elapsed since this [`Instant`].
+    ///
+    /// This provides a convenient way to calculate time elapsed since a previous [`Clock::now`].
+    /// Note even though the function only exists for monotonic clocks, it could still return
+    /// negative [`Duration`] if the current time is earlier than the time of `&self`, and this
+    /// could happen if `&self` is a timestamp generated by a [`Instant`] + [`Duration`].
+    ///
+    /// But for typical usages, it should always return non-negative [`Duration`]:
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// use kernel::time::{Clock, clock::KernelTime};
+    ///
+    /// let ts = KernelTime::now();
+    ///
+    /// // `KernelTime` is monotonic.
+    /// assert!(ts.elapsed().to_ns() >= 0);
+    /// ```
+    pub fn elapsed(&self) -> Duration {
+        T::now() - *self
+    }
+}
+
 /// Contains the various clock source types available to the kernel.
 pub mod clock {
     use super::*;
-- 
2.44.0