Manual Pages for UNIX Operating System command usage for man XtRemoveSignal

XT FUNCTIONS                                  XtAppAddSignal(3xt)



NAME
     XtAppAddSignal, XtRemoveSignal, XtNoticeSignal - register
     and remove a signal source

SYNTAX
     cc [ flag... ] file... -lXt [ library... ]

     XtSignalId XtAppAddSignal(XtAppContext app_context, XtSig-
          nalCallbackProc proc, XtPointer client_data);

     void XtRemoveSignal(XtSignalId id);

     void XtNoticeSignal(XtSignalId id);

ARGUMENTS
     app_context
               Specifies the application context.

     client_data
               Specifies the argument that is to be passed to the
               specified procedure when a signal has been raised.

     id        Specifies the ID returned from the corresponding
               XtAppAddSignal call.

     proc      Specifies the procedure that is to be called when
               the signal has been raised.

DESCRIPTION
     The XtAppAddSignal function initiates a mechanism for han-
     dling signals within the context of the Intrinsics. Prior to
     establishing an operating system dependent signal handler
     the application may call XtAppAddSignal and store the
     returned id in a place accessible to the signal handler.

     Upon receipt of a signal from the operating system, the
     application may call XtNoticeSignal passing the id returned
     by the call to XtAppAddSignal.

     XtNoticeSignal is the only Intrinsics function that can
     safely be called from a signal handler. If XtNoticeSignal is
     called multiple times before the Intrinsics are able to
     invoke the registered callback, the callback is only called
     once. Logically the Intrinsics maintain ``pending'' for each
     registered callback. This flag is initially False and is set
     to True by XtNoticeSignal; the Intrinsics invoke the call-
     back whenever the flag is True, and the flag is set to False
     just before the callback is invoked.

     The XtRemoveSignal function is called to remove the speci-
     fied Intrinsics signal handler. The client should disable
     the source of the signal before calling XtRemoveSignal.



X Version 11        Last change: libXt 1.0.8                    1






XT FUNCTIONS                                  XtAppAddSignal(3xt)



SEE ALSO
     XtAppAddTimeOut(3Xt),XtAppAddInput(3Xt),XtAppAddWorkProc(3Xt)
     X Toolkit Intrinsics - C Language Interface
     Xlib - C Language X Interface


ATTRIBUTES
     See attributes(5) for descriptions of the following attri-
     butes:

     __________________________________________________________________
    |       ATTRIBUTE TYPE        |          ATTRIBUTE VALUE          |
    |_____________________________|___________________________________|
    | Availability                | x11/library/toolkit/libxt         |
    |_____________________________|___________________________________|
    | Interface Stability         | Committed                         |
    |_____________________________|___________________________________|
    | MT-Level                    | See XtToolkitThreadInitialize(3XT)|
    |_____________________________|___________________________________|




































X Version 11        Last change: libXt 1.0.8                    2