Re: [PATCH v2] procfd_signal.2: document procfd_signal syscall

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

 



On Tue, Nov 20, 2018 at 11:51:24AM +0100, Christian Brauner wrote:
> Signed-off-by: Christian Brauner <christian@xxxxxxxxxx>
> ---
>  man2/procfd_signal.2 | 208 +++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 208 insertions(+)
>  create mode 100644 man2/procfd_signal.2

First of all, thanks for contributing a man page for the proposed new syscall.

> diff --git a/man2/procfd_signal.2 b/man2/procfd_signal.2
> new file mode 100644
> index 000000000..889bb426f
> --- /dev/null
> +++ b/man2/procfd_signal.2
> @@ -0,0 +1,208 @@
> +.\" Copyright (C) 2018 Christian Brauner <christian@xxxxxxxxxx>
> +.\"
> +.\" %%%LICENSE_START(VERBATIM)
> +.\" Permission is granted to make and distribute verbatim copies of this
> +.\" manual provided the copyright notice and this permission notice are
> +.\" preserved on all copies.
> +.\"
> +.\" Permission is granted to copy and distribute modified versions of this
> +.\" manual under the conditions for verbatim copying, provided that the
> +.\" entire resulting derived work is distributed under the terms of a
> +.\" permission notice identical to this one.
> +.\"
> +.\" Since the Linux kernel and libraries are constantly changing, this
> +.\" manual page may be incorrect or out-of-date.  The author(s) assume no
> +.\" responsibility for errors or omissions, or for damages resulting from
> +.\" the use of the information contained herein.  The author(s) may not
> +.\" have taken the same level of care in the production of this manual,
> +.\" which is licensed free of charge, as they might when working
> +.\" professionally.
> +.\"
> +.\" Formatted or processed versions of this manual, if unaccompanied by
> +.\" the source, must acknowledge the copyright and authors of this work.
> +.\" %%%LICENSE_END
> +.\"
> +.TH PROCFD_SIGNAL 2 2017-09-15 "Linux" "Linux Programmer's Manual"

Sorry, a few lines earlier you said it's 2018, and now it's 2017.

$ diff -U 999 man2/rt_sigqueueinfo.2 man2/procfd_signal.2 |diffstat -D man2
 procfd_signal.2 |  208 +++!!!!!!!!!!!!!!!!!!!!!!!!============================
 1 file changed, 13 insertions(+), 89 modifications(!), 106 unchanged lines(=)

If procfd_signal.2 is indeed a derived work, please follow the license requirements.

[...]
> +(i.e., cannot be
> +.BR SI_USER ,
> +which is used by the kernel to indicate a signal sent by
> +.BR kill (2))
> +and cannot (since Linux 2.6.39) be

This reference to a kernel version released before the new syscall
doesn't look relevant.


-- 
ldv



[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