typo in capabilities(7) man page

typo in capabilities(7) man page

[Christian Seiler]

Dear Maintainers,

I have found a small typo in capabilities(7). As per instructions[1],
I'm reporting it directly via email.

Under the capability CAP_SYS_ADMIN it says that you need it if you
want to

  'forge UID when passing socket credentials;'

This should read instead:

  'forge PID when passing socket credentials;'

Rationale:

UID/GID are governed by CAP_SET[UG]ID instead (which is already
correctly mentioned in the man page), only PID requires CAP_SYS_ADMIN.

The check in the kernel source can be found in:
<https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/net/core/scm.c#n47>

Thanks!

Christian

[1] <https://www.kernel.org/doc/man-pages/reporting_bugs.html>

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

Re: typo in capabilities(7) man page

[Michael Kerrisk (man-pages)]

Hello Christian,

On 01/13/2015 07:12 PM, Christian Seiler wrote:
> Dear Maintainers,
> 
> I have found a small typo in capabilities(7). As per instructions[1],
> I'm reporting it directly via email.
> 
> Under the capability CAP_SYS_ADMIN it says that you need it if you
> want to
> 
>   'forge UID when passing socket credentials;'
> 
> This should read instead:
> 
>   'forge PID when passing socket credentials;'
> 
> Rationale:
> 
> UID/GID are governed by CAP_SET[UG]ID instead (which is already
> correctly mentioned in the man page), only PID requires CAP_SYS_ADMIN.
> 
> The check in the kernel source can be found in:
> <https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/net/core/scm.c#n47>
> 
> Thanks!
> 
> Christian
> 
> [1] <https://www.kernel.org/doc/man-pages/reporting_bugs.html>

Thanks for the very complete report! Yes, the page needs fixing,
and I've done that.

Cheers,

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-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html