Re: git: bf8f6ffcb66a - main - Mention kern.timecounter.alloweddeviation in nanosleep.1

From: Konstantin Belousov <kostikbel_at_gmail.com>
Date: Sat, 09 Oct 2021 05:53:08 UTC
On Fri, Oct 08, 2021 at 03:09:04PM +0000, Piotr Pawel Stefaniak wrote:
> The branch main has been updated by pstef:
> 
> URL: https://cgit.FreeBSD.org/src/commit/?id=bf8f6ffcb66a27f498a18e520758ea0d18a6d2de
> 
> commit bf8f6ffcb66a27f498a18e520758ea0d18a6d2de
> Author:     Piotr Pawel Stefaniak <pstef@FreeBSD.org>
> AuthorDate: 2021-10-07 19:14:27 +0000
> Commit:     Piotr Pawel Stefaniak <pstef@FreeBSD.org>
> CommitDate: 2021-10-08 15:07:50 +0000
> 
>     Mention kern.timecounter.alloweddeviation in nanosleep.1
>     
>     PR:             224837
>     Reported by:    Aleksander Derevianko
> ---
>  lib/libc/sys/nanosleep.2 | 4 +++-
>  1 file changed, 3 insertions(+), 1 deletion(-)
> 
> diff --git a/lib/libc/sys/nanosleep.2 b/lib/libc/sys/nanosleep.2
> index 19ffcf1b7026..12758a974f7f 100644
> --- a/lib/libc/sys/nanosleep.2
> +++ b/lib/libc/sys/nanosleep.2
> @@ -30,7 +30,7 @@
>  .\"     @(#)sleep.3	8.1 (Berkeley) 6/4/93
>  .\" $FreeBSD$
>  .\"
> -.Dd March 17, 2017
> +.Dd October 7, 2021
>  .Dt NANOSLEEP 2
>  .Os
>  .Sh NAME
> @@ -93,6 +93,8 @@ returns immediately and the calling thread is not suspended.
>  .Pp
>  The suspension time may be longer than requested due to the
>  scheduling of other activity by the system.
> +It is also subject to the allowed time interval deviation
> +specified by the sysctl kern.timecounter.alloweddeviation.
This should be like
.Xr sysctl 3
.Dv kern.timecounter.alloweddeviation

And then, it is missing a description what exactly is allowed by deviation,
for instance, what units this sysctl is?

>  An unmasked signal will terminate the sleep early, regardless of the
>  .Dv SA_RESTART
>  value on the interrupting signal.