compiler/posixc/sigsuspend.c

   1 /*
   2     Copyright © 1995-2017, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     POSIX.1-2008 function sigsuspend().
   6 */
   7
   8 #include <aros/debug.h>
   9 #include <errno.h>
  10
  11 /*****************************************************************************
  12
  13     NAME */
  14
  15 #include <signal.h>
  16
  17         int sigsuspend (
  18
  19 /*  SYNOPSIS */
  20         const sigset_t *mask)
  21
  22 /*  FUNCTION
  23         replace the callers signal mask, and suspend it
  24         until it signaled to terminate, or to invoke a
  25         signal handler.
  26
  27         If the signal terminates the process, sigsuspend()
  28         doesn't return.
  29
  30         If the signal is caught, sigsuspend() returns following the
  31         signal handler, and the signal mask is restored to
  32         the state prior to calling sigsuspend().
  33
  34         SIGKILL or SIGSTOP cannot be blocked; specifying
  35         them in the mask has no effect on the process's signal mask.
  36
  37     INPUTS
  38
  39     RESULT
  40         always returns -1, normally with the error EINTR.
  41
  42     NOTES
  43         Not implemented.
  44
  45         Normally used in conjunction with sigprocmask(), to prevent
  46         signal delivery during critical code sections. Callers must
  47         block the signals with sigprocmask(). On completion, the caller
  48         waits for signals by calling sigsuspend() with the return value
  49         of sigprocmask()
  50
  51     EXAMPLE
  52
  53     BUGS
  54
  55     SEE ALSO
  56         kill(), pause(), sigaction(), signal(), sigprocmask(),
  57         sigwaitinfo(), sigsetops(), sigwait()
  58
  59     INTERNALS
  60         POSIX.1-2001
  61
  62 ******************************************************************************/
  63 {
  64     /* TODO: Implement sigsuspend() */
  65     AROS_FUNCTION_NOT_IMPLEMENTED("posixc");
  66
  67     errno = ENOSYS;
  68
  69     return -1;
  70
  71 } /* sigsuspend */