XtAppAddSignal(3Xt) XT FUNCTIONS XtAppAddSignal(3Xt)
XtAppAddSignal, XtRemoveSignal, XtNoticeSignal - register
and remove a signal source
XtSignalId XtAppAddSignal(XtAppContext app_context, XtSig-
nalCallbackProc proc, XtPointer client_data);
void XtRemoveSignal(XtSignalId id);
void XtNoticeSignal(XtSignalId id);
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.
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.
XFree86 Version 4.5.0 1
XtAppAddSignal(3Xt) XT FUNCTIONS XtAppAddSignal(3Xt)
XtAppAddTimeOut(3Xt),XtAppAddInput(3Xt),XtAppAddWorkProc(3Xt)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface
XFree86 Version 4.5.0 2
Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $
These manual pages and other documentation are copyrighted by their respective writers;
their source is available at our CVSweb,
AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material
provided by Thorsten Glaser.
This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.