[PATCH] signal.7: add missing async-signal-safe functions

[PATCH] signal.7: add missing async-signal-safe functions

[mhocko-DgEjT+Ai2ygdnm+yROfE0A]

From: Michal Hocko <mhocko-IBi9RG/b67k@public.gmane.org>

It seems that few async-signal-safe functions listed by POSIX.1-2008
http://pubs.opengroup.org/onlinepubs/9699919799/functions/V2_chap02.html#tag_15_04_03
are not mentioned in the man page. I am not exactly sure in which
version of the standard they have declared as signal safe. So they
were added to the section according to which standard they conform to:

POSIX.1-2001
- fchdir
- pthread_self
- pthread_sigmask

POSIX.1-2008
- pthread_kill

Signed-off-by: Michal Hocko <mhocko-IBi9RG/b67k@public.gmane.org>
---
 man7/signal.7 | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/man7/signal.7 b/man7/signal.7
index 4710945a2ab8..18871420cb16 100644
--- a/man7/signal.7
+++ b/man7/signal.7
@@ -510,6 +510,7 @@ execve()
 fchmod()
 fchown()
 fcntl()
+fchdir()
 fdatasync()
 fork()
 fpathconf()
@@ -541,6 +542,8 @@ pipe()
 poll()
 posix_trace_event()
 pselect()
+pthread_self()
+pthread_sigmask()
 raise()
 read()
 readlink()
@@ -622,6 +625,7 @@ mkfifoat()
 mknod()
 mknodat()
 openat()
+pthread_kill()
 readlinkat()
 renameat()
 symlinkat()
-- 
2.5.0

--
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: [PATCH] signal.7: add missing async-signal-safe functions

[Michael Kerrisk (man-pages)]

Hi Michael,

On 09/07/2015 05:07 PM, mhocko-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org wrote:
> From: Michal Hocko <mhocko-IBi9RG/b67k@public.gmane.org>
> 
> It seems that few async-signal-safe functions listed by POSIX.1-2008
> http://pubs.opengroup.org/onlinepubs/9699919799/functions/V2_chap02.html#tag_15_04_03
> are not mentioned in the man page. I am not exactly sure in which
> version of the standard they have declared as signal safe. So they
> were added to the section according to which standard they conform to:
> 
> POSIX.1-2001
> - fchdir
> - pthread_self
> - pthread_sigmask
> 
> POSIX.1-2008
> - pthread_kill

Thanks for spotting this. I had missed it myself.
I see now that those 4 functions were added in POSIX.1-2008
Technical Corrigendum 1 (2013). So, I've applied a different
patch (below). Thanks for catching this, and the effort on the
patch.

Cheers,

Michael


--- a/man7/signal.7
+++ b/man7/signal.7
@@ -630,6 +630,18 @@ utimensat()
 utimes()
 .fi
 .in
+.PP
+POSIX.1-2008 Technical Corrigendum 1 (2013)
+adds the following functions:
+.PP
+.in +4n
+.nf
+fchdir()
+pthread_kill()
+pthread_self()
+pthread_sigmask()
+.fi
+.in
 .SS Interruption of system calls and library functions by signal handlers
 If a signal handler is invoked while a system call or library
 function call is blocked, then either:



> Signed-off-by: Michal Hocko <mhocko-IBi9RG/b67k@public.gmane.org>
> ---
>  man7/signal.7 | 4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/man7/signal.7 b/man7/signal.7
> index 4710945a2ab8..18871420cb16 100644
> --- a/man7/signal.7
> +++ b/man7/signal.7
> @@ -510,6 +510,7 @@ execve()
>  fchmod()
>  fchown()
>  fcntl()
> +fchdir()
>  fdatasync()
>  fork()
>  fpathconf()
> @@ -541,6 +542,8 @@ pipe()
>  poll()
>  posix_trace_event()
>  pselect()
> +pthread_self()
> +pthread_sigmask()
>  raise()
>  read()
>  readlink()
> @@ -622,6 +625,7 @@ mkfifoat()
>  mknod()
>  mknodat()
>  openat()
> +pthread_kill()
>  readlinkat()
>  renameat()
>  symlinkat()
> 


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

Re: [PATCH] signal.7: add missing async-signal-safe functions

[Michal Hocko]

On Fri 11-09-15 12:59:31, Michael Kerrisk wrote:
> Hi Michael,
> 
> On 09/07/2015 05:07 PM, mhocko-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org wrote:
> > From: Michal Hocko <mhocko-IBi9RG/b67k@public.gmane.org>
> > 
> > It seems that few async-signal-safe functions listed by POSIX.1-2008
> > http://pubs.opengroup.org/onlinepubs/9699919799/functions/V2_chap02.html#tag_15_04_03
> > are not mentioned in the man page. I am not exactly sure in which
> > version of the standard they have declared as signal safe. So they
> > were added to the section according to which standard they conform to:
> > 
> > POSIX.1-2001
> > - fchdir
> > - pthread_self
> > - pthread_sigmask
> > 
> > POSIX.1-2008
> > - pthread_kill
> 
> Thanks for spotting this. I had missed it myself.
> I see now that those 4 functions were added in POSIX.1-2008
> Technical Corrigendum 1 (2013). So, I've applied a different
> patch (below). Thanks for catching this, and the effort on the
> patch.

OK, thanks for fixing that up!
-- 
Michal Hocko
SUSE Labs
--
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