Re: [PATCH] man/man3/timespec_get.3: Correct return value and clarify description

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



At 2025-02-08T12:41:42-0800, Mark Harris wrote:
> - 0, not -1, is returned for an unsupported time base or error
>   (C23 7.29.2.6, 7.29.2.7; POSIX.1-2024 line 74358).
> - Clarify that any supported value of base is always nonzero (i.e.,
>   there is no overlap between the two return value cases that may
>   require errno or some other source to disambiguate)
>   (C23 7.29.2.6, 7.29.2.7; POSIX.1-2024 line 74357).
> - Clarify that timespec_getres(NULL, base) is a valid call to check
>   whether the specified time base is supported (C23 7.29.2.7).
> - Clarify that the resolution for a particular time base is constant
>   for the lifetime of the process (i.e., there is no need to retrieve
>   it repeatedly) (C23 7.29.2.7).
> - Calls to these functions are not technically equivalent to any
>   clock_* function call; at least the return value will be different.
> - The ERRORS section is removed, because it states only what is true
>   for every function that does not state otherwise (i.e., errno might
>   be affected by underlying system calls).

Just wanted to say: this is an excellently annotated patch.

Regards,
Branden

Attachment: signature.asc
Description: PGP signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux