Installing a signal callback

A signal callback is installed only at the context level. Signal callbacks are identified by adding the signal number on to the defined constant CS_SIGNAL_CB.

The following routine demonstrates how to install a signal callback:

          /*

           ** INSTALLSIGNALCB

           **

           ** This routine installs a signal callback for the

           ** specified signal

           **

           ** Parameters:

           **      cp   Context handle

           **      signo   Signal number

           **      signalhandler   Signal handler to install

           **

           ** Returns:

           **      CS_SUCCEED   Signal handler was installed

           **                   successfully

           **      CS_FAIL      An error was detected while

           **                   installing the signal handler

           */

           CS_RETCODE  installsignalcb(cp, signo, signalhandler)

           CS_CONTEXT  *cp;

           CS_INT  signo;

           CS_VOID *signalhandler;

           {

                CS_INT       adjustedsigno;

                CS_RETCODE   ret;

               /*

                ** Add the signal number to the CS_SIGNAL_CB 

                ** define to indicate the signal number that this

                ** handler is being installed for.

                */

                adjustedsigno = CS_SIGNAL_CB + signo;

               ret = ct_callback(cp, (CS_CONNECTION *)NULL,

                     CS_SET, adjustedsigno, signalhandler);

               return(ret);

           }