Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
From:   Kurt Kanzenbach <kurt@linutronix.de>
To:     Bagas Sanjaya <bagasdotme@gmail.com>,
        John Stultz <john.stultz@linaro.org>,
        Thomas Gleixner <tglx@linutronix.de>,
        Stephen Boyd <sboyd@kernel.org>,
        Steven Rostedt <rostedt@goodmis.org>,
        Ingo Molnar <mingo@redhat.com>,
        Jonathan Corbet <corbet@lwn.net>
Cc:     Richard Cochran <richardcochran@gmail.com>,
        linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: Re: [PATCH v2 3/3] tracing: Add documentation for trace clock tai
In-Reply-To: <0dd9ba0e-712a-37f6-a50d-f5510cd23033@gmail.com>
References: <20220414091805.89667-1-kurt@linutronix.de>
 <20220414091805.89667-4-kurt@linutronix.de>
 <0dd9ba0e-712a-37f6-a50d-f5510cd23033@gmail.com>
Date:   Thu, 14 Apr 2022 13:38:57 +0200
Message-ID: <871qxzq4ha.fsf@kurt>
MIME-Version: 1.0
Content-Type: multipart/signed; boundary="=-=-=";
        micalg=pgp-sha512; protocol="application/pgp-signature"
Precedence: bulk

--=-=-=
Content-Type: text/plain

On Thu Apr 14 2022, Bagas Sanjaya wrote:
> On 4/14/22 16:18, Kurt Kanzenbach wrote:
>> +	tai:
>> +		This is the tai clock (CLOCK_TAI) and is derived from the wall-
>> +		clock time. However, this clock does not experience
>> +		discontinuities and backwards jumps caused by NTP inserting leap
>> +		seconds. Since the clock access is designed for use in tracing,
>> +		side effects are possible. The clock access may yield wrong
>> +		readouts in case the internal TAI offset is updated e.g., caused
>> +		by setting the system time or using adjtimex() with an offset.
>> +		These effects are rare and post processing should be able to
>> +		handle them. See comments in the ktime_get_tai_fast_ns()
>> +		function for more information.
>> +
>
> In what file are the ktime_get_tai_fast_ns() comments?

In kernel/time/timekeeping.c. That function is introduced in patch #1
and has kernel doc comments. Similar to ktime_get_boot_fast_ns().

Thanks,
Kurt

--=-=-=
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQJHBAEBCgAxFiEEvLm/ssjDfdPf21mSwZPR8qpGc4IFAmJYB9ETHGt1cnRAbGlu
dXRyb25peC5kZQAKCRDBk9HyqkZzgicJD/9A7CLbPVNGF89I2TFog7qSZXhTkEDx
G1J3fJZkFtdv7+zSrNWqHPiYZcbMAOUX6Txe0aRqEV5dfNta+8i9w1zpLKVSw84V
lOHlYb5pF03sZ1iqIgFvPKx9wym+1w9dFDNqL/hp+T1FaSjVhzj3MFZh/nFKcgO0
m105ui2jQI/VRLRfoGn6C5l+EmEYlb7D4ohTBfjolPirwAm1UUluIZlV6DOuVCxq
ic6U6NlFRSN/gTaJMr1i3g/QGw0CSHfqGcUT52YWQXAS5kjuL8yLxsIWt9nAL7N/
bmc65bJVmLmxItIgKYQipZxB/2cKqnQsJWR5sxCNSCy1xZ2c4fLKpfckWqZzL4Rg
kz3xKx70eiV1Lvojh4TyaqHqTftMk2HNaOouchFWcwQAYEeYhkK32f5PnEJ0FRMt
Lp2PHJrpIxQMbAMLXIwKbV/AQCgtxYP8niMYkzDdEGV2Fku3mVracJ4cMFVBmC/5
f9sWlOzhilkM2cC1ajvQt4g2QkzjBVj6a1ivN3wULsc2AuBRj89EWJbYfGqxE212
MxxPKy8JhE0igm6OAS9QV7el4D+oKG1ExHeFNb0iSBjU9SmhWlUML+H+WrwWjGGb
irQ6zqrCrgjIiyQDxu9pA9qoLcUOFP4r1ZVxMgdZLvvwKzuQuCfc44eKWLmD0KA8
lHVcM/IpaRwzBA==
=u8Ks
-----END PGP SIGNATURE-----
--=-=-=--