From c1ca91873c9d4649fef14efc254b31c4a07b14f5 Mon Sep 17 00:00:00 2001 From: Gregory Nutt Date: Thu, 9 Apr 2015 10:16:35 -0600 Subject: [PATCH] Add sigset() --- Documentation/NuttxUserGuide.html | 171 ++++++++++++++++++++++++++---- 1 file changed, 152 insertions(+), 19 deletions(-) diff --git a/Documentation/NuttxUserGuide.html b/Documentation/NuttxUserGuide.html index 917b52559f..c2d65d00d1 100644 --- a/Documentation/NuttxUserGuide.html +++ b/Documentation/NuttxUserGuide.html @@ -13,7 +13,7 @@

NuttX Operating System

User's Manual

by

Gregory Nutt

-

Last Updated: November 29, 2014

+

Last Updated: April 9, 2015

@@ -4487,14 +4487,19 @@ interface of the same name.
  • 2.7.4 sigdelset
  • 2.7.5 sigismember
  • 2.7.6 sigaction
    • -
  • 2.7.7 sigprocmask
    • -
  • 2.7.8 sigpending
    • -
  • 2.7.9 sigsuspend
    • -
  • 2.7.10 sigwaitinfo
    • -
  • 2.7.11 sigtimedwait
    • -
  • 2.7.12 sigqueue
    • -
  • 2.7.13 kill
    • -
  • 2.7.14 pause
    • +
  • 2.7.7 sigignore
    • +
  • 2.7.8 sigset
    • +
  • 2.7.9 sigprocmask
    • +
  • 2.7.10 sighold
    • +
  • 2.7.11 sigrelse
    • +
  • 2.7.12 sigpending
    • +
  • 2.7.13 sigsuspend
    • +
  • 2.7.14 sigpause
    • +
  • 2.7.15 sigwaitinfo
    • +
  • 2.7.16 sigtimedwait
    • +
  • 2.7.17 sigqueue
    • +
  • 2.7.18 kill
    • +
  • 2.7.19 pause

    • 2.7.1 sigemptyset

    @@ -4729,7 +4734,65 @@ Differences from the POSIX implementation include: -

    2.7.7 sigprocmask

    +

    2.7.7 sigignore

    + +

    +Function Prototype: +

    +    #include <signal.h>
+    int sigignore(int signo);
+
    + +

    +Description: The sigignore() function will set the disposition of signo to SIG_IGN. +

    +Input Parameters: +

    + +

    +Returned Value: +

    + +

    2.7.8 sigset

    + +

    +Function Prototype: +

    +    #include <signal.h>
+    void (*sigset(int signo, void (*disp)(int)))(int);
+
    + +

    +Description: + The sigset() function will modify signal dispositions. + The signo argument specifies the signal. + The disp argument specifies the signal's disposition, which may be SIG_DFL, SIG_IGN, or the address of a signal handler. + If disp is the address of a signal handler, the system will add signo to the calling process' signal mask before executing the signal handler; when the signal handler returns, the system will restore the calling process' signal mask to its state prior to the delivery of the signal. + signo will be removed from the calling process' signal mask. +

    +

    + NOTE: The value SIG_HOLD for disp is not currently supported. +

    +

    +Input Parameters: +

    + +

    +Returned Value: +

    + +

    2.7.9 sigprocmask

    Function Prototype: @@ -4779,7 +4842,55 @@ pointed to by the set input parameter. POSIX Compatibility: Comparable to the POSIX interface of the same name. -

    2.7.8 sigpending

    +

    2.7.10 sighold

    + +

    +Function Prototype: +

    +    #include <signal.h>
+    int sighold(int signo);
+
    + +

    +Description: The sighold() function will add signo to the calling process' signal mask +

    +

    +Input Parameters: +

    + +

    +Returned Value: +

    + +

    2.7.11 sigrelse

    + +

    +Function Prototype: +

    +    #include <signal.h>
+    int sigrelse(int signo);
+
    + +

    +Description: The sighold() function will remove signo from the calling process' signal mask +

    +

    +Input Parameters: +

    + +

    +Returned Value: +

    + +

    2.7.12 sigpending

    Function Prototype: @@ -4817,7 +4928,7 @@ is delivered more than once." POSIX Compatibility: Comparable to the POSIX interface of the same name. -

    2.7.9 sigsuspend

    +

    2.7.13 sigsuspend

    Function Prototype: @@ -4865,7 +4976,30 @@ function or to terminate the task." Only delivery of the signal is required in the present implementation (even if the signal is ignored). -

    2.7.10 sigwaitinfo

    +

    2.7.14 sigpause

    +

    +Function Prototype: +

    +    #include <signal.h>
+    int sigpause(int signo);
+
    + +

    +Description: The sigpause()) function will remove signo) from the calling process' signal mask and suspend the calling process until a signal is received. +The sigpause()) function will restore the process' signal mask to its original state before returning. +

    +Input Parameters: +

    + +

    +Returned Value: +

    + +

    2.7.15 sigwaitinfo

    Function Prototype: @@ -4894,10 +5028,9 @@ with a NULL timeout parameter. (see below).

    Assumptions/Limitations:

    - POSIX Compatibility: Comparable to the POSIX -interface of the same name. + POSIX Compatibility: Comparable to the POSIX interface of the same name. -

    2.7.11 sigtimedwait

    +

    2.7.16 sigtimedwait

    Function Prototype: @@ -4963,7 +5096,7 @@ that the unblocked signal be caught; the task will be resumed even if the unblocked signal is ignored. -

    2.7.12 sigqueue

    +

    2.7.17 sigqueue

    Function Prototype: @@ -5020,7 +5153,7 @@ There is no null signal in the present implementation; a zero signal will be sent. -

    2.7.13 kill

    +

    2.7.18 kill

    Function Prototype: @@ -5076,7 +5209,7 @@ be sent.

  • Sending of signals to 'process groups' is not supported in NuttX.
    • -

    2.7.14 pause

    +

    2.7.19 pause

    Function Prototype: