From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Michael Kerrisk (man-pages)" Subject: Re: [PATCH 5/5] add_key.2: add information regarding EPERM Date: Wed, 16 Nov 2016 18:57:04 +0100 Message-ID: References: <9a5cc2a7-a505-9d0d-5b78-4bc5ab100ff1@gmail.com> <20161115084440.GA21255@obsidian> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Return-path: In-Reply-To: Sender: linux-man-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org To: Eugene Syromyatnikov Cc: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org, linux-man List-Id: linux-man@vger.kernel.org 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) > 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-u79uwXL29TY76Z2rM5mHXA@public.gmane.org More majordomo info at http://vger.kernel.org/majordomo-info.html