Skip to contentSkip to conversation

signal.7: add missing async-signal-safe functions

PATCH In review [email protected] 2 participants 3 messages Sep 7, 2015 – Sep 11, 2015 2 messages not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 signal.7: add missing async-signal-safe functions

From: Michal Hocko <mhocko-IBi9RG/[email protected]>

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

---
 man7/signal.7 | 4 ++++
 1 file changed, 4 insertions(+)
man7/signal.7 +4 -0
index 4710945a2ab8..18871420cb16 100644
@@ -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()
Signature · 6 lines
2.5.0

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): 1441638469-22062-1-git-send-email-mhocko-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org

#2 lore raw

Hi Michael,

Quoted 8 lines · On 09/07/2015 05:07 PM, [email protected] wrote:

From: Michal Hocko <mhocko-IBi9RG/[email protected]>

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:

Quoted 7 lines

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

man7/signal.7 +12 -0
@@ -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:
Quoted 35 lines
---
 man7/signal.7 | 4 ++++
 1 file changed, 4 insertions(+)
man7/signal.7 +4 -0
index 4710945a2ab8..18871420cb16 100644
@@ -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()
Signature · 7 lines
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 [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

#4 lore raw
Quoted 16 lines · Michael Kerrisk

Hi Michael,

Quoted 13 lines · On 09/07/2015 05:07 PM, [email protected] wrote:

From: Michal Hocko <mhocko-IBi9RG/[email protected]>

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

Quoted 8 lines
Quoted 2 lines

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!

Signature · 6 lines
Michal Hocko
SUSE Labs
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html