Re: [PATCH 5/5] add_key.2: add information regarding EPERM

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

 



Hi Eugene,

On 11/15/2016 10:17 PM, Eugene Syromyatnikov wrote:
> On Tue, Nov 15, 2016 at 9:00 PM, Michael Kerrisk (man-pages)
> <mtk.manpages@xxxxxxxxx> wrote:
>> Hello Eugene
>>
>> On 11/15/2016 09:44 AM, Eugene Syromyatnikov wrote:
>>> ---
>>>  man2/add_key.2 | 13 +++++++++++++
>>>  1 file changed, 13 insertions(+)
>>>
>>> diff --git a/man2/add_key.2 b/man2/add_key.2
>>> index 082a2b8..241eb92 100644
>>> --- a/man2/add_key.2
>>> +++ b/man2/add_key.2
>>> @@ -183,6 +183,19 @@ The keyring doesn't exist.
>>>  .TP
>>>  .B ENOMEM
>>>  Insufficient memory to create a key.
>>> +.TP
>>> +.B EPERM
>>> +The
>>> +.I type
>>> +started from dot.
>>
>> Oh -- I was unaware of this! What are key types that start with "." about,
>> do you know?
> I can't recall any clear indication that this is for internal purposes
> (and can't find any mention of this now), but there is explicit check
> in keyctl.c:key_get_type_from_user and it is used for
> ".request_key_auth" key type. Judging by commit messages for 54e2c2c1,
> 1260f801 and 3e30148c, it is indeed reserved for internal purposes and
> has been reserved as part of the introduction of the aforementioned
> ".request_key_auth" key type.

Ahh yes. That makes sense. Patch applied. And I'll add a few more words
about the types starting with "." being reserved.

Cheers,

Michael

>>> +.TP
>>> +.B EPERM
>>> +.I type
>>> +was
>>> +.I """keyring"""
>>> +and the
>>> +.I description
>>> +started from dot.
>>>  .SH VERSIONS
>>>  This system call first appeared in Linux 2.6.10.
>>>  .SH CONFORMING TO
>>>
>>
>>
>> --
>> Michael Kerrisk
>> Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
>> Linux/UNIX System Programming Training: http://man7.org/training/
> 
> 
> 


-- 
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