Provided by: rtlinux_3.1pre3-2_i386 bug

NAME

       sigaction — RTLinux POSIX signal handling functions

SYNOPSIS

       #include <posix/signal.h>

       int sigaction(int signum, const struct sigaction *act, struct sigaction *oldact);

       int  sigprocmask(int  how,  const  sigset_t *set, sigset_t *oldset);

DESCRIPTION

       Signals  interactions with pthreads is one of the less well defined and
       most  contentious  parts  of  POSIX.  Many  problems  come   from   the
       interaction  between  process  signals and thread signals. RTLinux V3.0
       uses the concept of process signals to provide  an  interface  to  hard
       interrupt  handlers.  The  signals  RTL_SIGIRQMIN   to  RTL_SIGIRQMIN +
       NR_IRQS refer to global  hardware  interrupts,  and  installing  signal
       handlers is the same as installing interrupt handlers.

       RTLinux  provides  the POSIX sigaction function to install handlers for
       hardware interrupts and  also  to  provide  POSIX  signaling  (this  is
       incomplete in V3.0).

       signum  specifies the signal and can be any valid signal except SIGKILL
       and SIGSTOP.

       If act is non-null, the new action for signal signum is installed  from
       act.  If oldact is non-null, the previous action is saved in oldact.

       The sigaction structure is defined as

              struct sigaction{
       void (*sa_handler)(int);
       sigset_t sa_mask;
       int sa_flags;
       void (*sa_restorer)(void);
       unsigned int sa_focus;
       }

       The  sa_focus  field is an RTLinux-specific extension that is a bit map
       defining which processors on an SMP system can accept these interrupts.
       This  is  machine-specific and may only be used for hardware interrupts
       using the RTL_SIGIRQMIN+n, to catch hardware interrupt n.

       sa_handler specifies the action to be associated with signum and may be
       SIG_DFL  for  the  default  action, SIG_IGN to ignore this signal, or a
       pointer to a signal handling function.

       sa_mask  gives  a  mask of  signals  which  should  be  blocked  during
       execution  of  the  signal  handler.   In  addition,   the signal which
       triggered the  handler  will  be  blocked,  unless  the  SA_NODEFER  or
       SA_NOMASK  flags  are used. In V3 and prior RTLinux these flags have no
       effect. Furthermore, when a signal handler  for  a  hard  interrupt  is
       entered all interrupts are blocked by default.

       sa_flags  specifies  a  set  of flags which modify the behaviour of the
       signal handling process.  In RTLinux V3.0 and earlier these  flags  are
       ignored.

       The  sa_focus  element  is  used  to  direct  a hardware interrupt to a
       particular set of processors in an SMP system.   This  element  has  no
       effiect  on  soft-interrupts,  on  processor-specific  interrupts (e.g.
       local  timers  and  IPIs),  on  uni-processor  systems,  or  where  the
       interrupt control logic does not support interrupt focus.

       The  sigprocmask  call  is used to change the list of currently blocked
       signals  in  a  single  threaded  process.   POSIX  states   that   the
       sigprocmask  call  has undefined operation in a multi-threaded process.
       In RTLinux, if the  pthreads-based  scheduling  module  (rtl_sched)  is
       loaded  or  otherwise  activated,  the  RT process is multithreaded and
       sigprocmask behavior undefined, unless the ‘‘how’’ variable is  set  to
       SIG_DISABLE  or  SIG_ENABLE.   These  two flags are RTLinux extensions.
       The behaviour of the call is dependent on the value of how, as follows.

       SIG_BLOCK The  set  of  blocked signals is the union of the current set
                 and the set argument.

       SIG_UNBLOCK
                 The signals in set  are  removed  from  the  current  set  of
                 blocked signals.  It is legal to attempt to unblock a  signal
                 which  is  not blocked.

       SIG_SETMASK
                 The  set  of  blocked  signals is set to the argument set.

       SIG_DISABLE
                 Turns on local processor interrupts.

       SIG_ENABLE
                 Turns on local processor interrupts.

       Note that in RTLinux, as in POSIX,  not all signals can  be  masked  or
       blocked.

       If  oldset  is  non-null,  the  previous value  of  the  signal mask is
       stored in oldset.

RETURN VALUES

       sigaction, sigprocmask, sigpending and sigsuspend return 0  on  success
       and -1 on error.

ERRORS

       EINVAL    An invalid signal was specified.  This will also be generated
                 if  an  attempt  is  made  to change the action  for  SIGKILL
                 or  SIGSTOP,  which  cannot  be caught.

       EFAULT    act,oldact,  set  or  oldset  point  to memory which is not a
                 valid part of the process address space.

       EINTR     System call was interrupted. This cannot  happen  in  RTLinux
                 V3.0 or prior.

NOTES

       It  is not possible to block SIGKILL or  SIGSTOP  with  the sigprocmask
       call.   Attempts  to  do  so will be  silently  ignored.  RTLinux  also
       adds an additional set of unmaskable and uncatchable signals.

       According to POSIX, the behaviour of a  process  is  undefined after it
       ignores a SIGFPE, SIGILL, or SIGSEGV signal that was not  generated  by
       the  kill()  or  the  raise()  functions.  Integer division by zero has
       undefined result.  On some architectures  it  will  generate  a  SIGFPE
       signal.   (Also,  dividing the most negative integer by -1 may generate
       SIGFPE.)  Ignoring this signal might lead to  an  endless loop.

       SIGCHLD cannot happen in V3.0 RTLinux or prior, since there is  no  way
       to create child processes.

       The  POSIX spec only defines SA_NOCLDSTOP.   Use  of  other sa_flags is
       non-portable.

       sigaction can be called with a  null  second  argument  to  query   the
       current  signal  handler.  It can also be used to check whether a given
       signal  is  valid  for  the  current machine, by  calling it  with null
       second and third arguments.

SEE ALSO

       UNIX  spec  sigaction  (link to URL ../susv2/xsh/sigaction.html) , UNIX
       spec kill(2) (link to URL ../susv2/xsh/kill.html)

       ©2001 FSMLabs Inc.

       All rights reserved.

                                                                  sigaction(2)