gsignal

GSIGNAL(3)                 Linux Programmer's Manual                GSIGNAL(3)



NAME
       gsignal, ssignal - software signal facility

SYNOPSIS
       #include <signal.h>

       typedef void (*sighandler_t)(int);

       int gsignal(signum);

       sighandler_t ssignal(int signum, sighandler_t action);

DESCRIPTION
       Don't  use  these  functions under Linux.  Due to a historical mistake,
       under Linux these functions  are  aliases  for  raise()  and  signal(),
       respectively.

       Elsewhere,  on  SYSV-like  systems,  these functions implement software
       signalling, entirely independent of the classical signal and kill func-
       tions. The function ssignal() defines the action to take when the soft-
       ware signal with number signum is raised using the function  gsignal(),
       and  returns  the  previous such action or SIG_DFL.  The function gsig-
       nal() does the following: if no action  (or  the  action  SIG_DFL)  was
       specified  for  signum,  then  it  does  nothing and returns 0.  If the
       action SIG_IGN was specified for  signum,  then  it  does  nothing  and
       returns  1.   Otherwise,  it resets the action to SIG_DFL and calls the
       action function with parameter signum, and returns the  value  returned
       by  that  function.   The range of possible values signum varies (often
       1-15 or 1-17).

CONFORMING TO
       SVID2, XPG2.  These functions are available  under  AIX,  DG-UX,  HPUX,
       SCO, Solaris, Tru64.  They are called obsolete under most of these sys-
       tems, and are broken under Linux libc and  glibc.   Some  systems  also
       have gsignal_r() and ssignal_r().

SEE ALSO
       kill(2), signal(2), raise(3)



notGNU                            2002-08-25                        GSIGNAL(3)