Re: [PATCH V2] fgetgrent.3: ATTRIBUTES: Note function that is thread-safe

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

 



Hi Ma Shmiao,

On 11 February 2015 at 09:20, Ma Shimiao <mashimiao.fnst@xxxxxxxxxxxxxx> wrote:
> Hi Michael,
> On 02/11/2015 03:55 PM, Michael Kerrisk (man-pages) wrote:
>> On 02/11/2015 08:35 AM, Ma Shimiao wrote:
>>> The marking matches glibc marking.
>>>
>>> Signed-off-by: Ma Shimiao <mashimiao.fnst@xxxxxxxxxxxxxx>
>>> ---
>>>  man3/fgetgrent.3 | 12 ++++++++++++
>>>  1 file changed, 12 insertions(+)
>>>
>>> diff --git a/man3/fgetgrent.3 b/man3/fgetgrent.3
>>> index 57665dd..e599483 100644
>>> --- a/man3/fgetgrent.3
>>> +++ b/man3/fgetgrent.3
>>> @@ -90,6 +90,18 @@ is set to indicate the cause.
>>>  Insufficient memory to allocate
>>>  .I group
>>>  structure.
>>> +.SH ATTRIBUTES
>>> +For an explanation of the terms used in this section, see
>>> +.BR attributes (7).
>>> +.TS
>>> +allbox;
>>> +lb lb lb
>>> +l l l.
>>> +Interface   Attribute       Value
>>> +T{
>>> +.BR fgetgrent ()
>>> +T}  Thread safety   MT-Unsafe race:fgrent
>>
>> Why the change here in the V2? What does "fgrent" refer to?
>
> race:fgrent is right mark, I made a mistake.
> race:fgrent is similar to race:grent.
> race:grent is used to indicate data race exists in getgrent(), setgrent() and endgrent().
> race:fgrent is used to indicate data race exists when using fgetgrent() in multi-thread.

My question then is: how does the reader know that "grent" refers to
"getgrent(), setgrent() and endgrent()"?

Thanks,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[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