summaryrefslogtreecommitdiffstats
path: root/lib/libc/gen/signal.3
diff options
context:
space:
mode:
authorsheldonh <sheldonh@FreeBSD.org>2001-07-24 11:37:33 +0000
committersheldonh <sheldonh@FreeBSD.org>2001-07-24 11:37:33 +0000
commit1e628e76e17a6355b1ae95be0a26bbd8b25dbf7c (patch)
tree16a0f0f806e27af0e45fbb83f9d7ee2d438d87a4 /lib/libc/gen/signal.3
parent09e0e54b1e3a4d986e7e121206fbd1fb2363c118 (diff)
downloadFreeBSD-src-1e628e76e17a6355b1ae95be0a26bbd8b25dbf7c.zip
FreeBSD-src-1e628e76e17a6355b1ae95be0a26bbd8b25dbf7c.tar.gz
The previous delta duplicated a significant amount of information
already found in the sigaction(2) manual. As discussed with the committer of that delta, cross-reference the list in sigaction(2) instead of duplicating the list of functions that are safe for use within signal handlers.
Diffstat (limited to 'lib/libc/gen/signal.3')
-rw-r--r--lib/libc/gen/signal.3126
1 files changed, 4 insertions, 122 deletions
diff --git a/lib/libc/gen/signal.3 b/lib/libc/gen/signal.3
index 32b30ba..5a43ffa 100644
--- a/lib/libc/gen/signal.3
+++ b/lib/libc/gen/signal.3
@@ -201,128 +201,10 @@ to the
function;
ignored signals remain ignored.
.Pp
-The following functions are either reentrant or not interruptible
-by signals and are async-signal safe.
-Therefore applications may
-invoke them, without restriction, from signal-catching functions:
-.Pp
-Base Interfaces:
-.Pp
-.Fn _exit ,
-.Fn access ,
-.Fn alarm ,
-.Fn cfgetispeed ,
-.Fn cfgetospeed ,
-.Fn cfsetispeed ,
-.Fn cfsetospeed ,
-.Fn chdir ,
-.Fn chmod ,
-.Fn chown ,
-.Fn close ,
-.Fn creat ,
-.Fn dup ,
-.Fn dup2 ,
-.Fn execle ,
-.Fn execve ,
-.Fn fcntl ,
-.Fn fork ,
-.Fn fpathconf ,
-.Fn fstat ,
-.Fn fsync ,
-.Fn getegid ,
-.Fn geteuid ,
-.Fn getgid ,
-.Fn getgroups ,
-.Fn getpgrp ,
-.Fn getpid ,
-.Fn getppid ,
-.Fn getuid ,
-.Fn kill ,
-.Fn link ,
-.Fn lseek ,
-.Fn mkdir ,
-.Fn mkfifo ,
-.Fn open ,
-.Fn pathconf ,
-.Fn pause ,
-.Fn pipe ,
-.Fn raise ,
-.Fn read ,
-.Fn rename ,
-.Fn rmdir ,
-.Fn setgid ,
-.Fn setpgid ,
-.Fn setsid ,
-.Fn setuid ,
-.Fn sigaction ,
-.Fn sigaddset ,
-.Fn sigdelset ,
-.Fn sigemptyset ,
-.Fn sigfillset ,
-.Fn sigismember ,
-.Fn signal ,
-.Fn sigpending ,
-.Fn sigprocmask ,
-.Fn sigsuspend ,
-.Fn sleep ,
-.Fn stat ,
-.Fn sysconf ,
-.Fn tcdrain ,
-.Fn tcflow ,
-.Fn tcflush ,
-.Fn tcgetattr ,
-.Fn tcgetpgrp ,
-.Fn tcsendbreak ,
-.Fn tcsetattr ,
-.Fn tcsetpgrp ,
-.Fn time ,
-.Fn times ,
-.Fn umask ,
-.Fn uname ,
-.Fn unlink ,
-.Fn utime ,
-.Fn wait ,
-.Fn waitpid ,
-.Fn write .
-.Pp
-Realtime Interfaces:
-.Pp
-.Fn aio_error ,
-.Fn clock_gettime ,
-.Fn sigpause ,
-.Fn timer_getoverrun ,
-.Fn aio_return ,
-.Fn fdatasync ,
-.Fn sigqueue ,
-.Fn timer_gettime ,
-.Fn aio_suspend ,
-.Fn sem_post ,
-.Fn sigset ,
-.Fn timer_settime .
-.Pp
-ANSI C Interfaces:
-.Pp
-.Fn strcpy ,
-.Fn strcat ,
-.Fn strncpy ,
-.Fn strncat ,
-and perhaps some others.
-.Pp
-Extension Interfaces:
-.Pp
-.Fn strlcpy ,
-.Fn strlcat .
-.Pp
-All functions not in the above lists are considered to be unsafe
-with respect to signals. That is to say, the behaviour of such
-functions when called from a signal handler is undefined.
-In general though, signal handlers should do little more than set a
-flag; most other actions are not safe.
-.Pp
-As well, inside the signal handler it is also considered more safe to
-make a copy the global variable
-.Va errno
-and restore it before returning from the signal handler.
+See
+.Xr sigaction 2
+for a list of functions
+that are considered safe for use in signal handler.
.Sh RETURN VALUES
The previous action is returned on a successful call.
Otherwise, SIG_ERR is returned and the global variable
OpenPOWER on IntegriCloud