


XtAppAddSignal(3Xt)	   XT FUNCTIONS	      XtAppAddSignal(3Xt)


NNAAMMEE
       XtAppAddSignal, XtRemoveSignal, XtNoticeSignal - register
       and remove a signal source

SSYYNNTTAAXX
       XtSignalId XtAppAddSignal(_a_p_p___c_o_n_t_e_x_t, _p_r_o_c, _c_l_i_e_n_t___d_a_t_a)
	     XtAppContext _a_p_p___c_o_n_t_e_x_t;
	     XtInputCallbackProc _p_r_o_c;
	     XtPointer _c_l_i_e_n_t___d_a_t_a;

       void XtRemoveSignal(_i_d)
	     XtSignalId _i_d;

       void XtNoticeSignal(_i_d)
	     XtSignalId _i_d)

AARRGGUUMMEENNTTSS
       _a_p_p___c_o_n_t_e_x_t
		 Specifies the application context.

       _c_l_i_e_n_t___d_a_t_a
		 Specifies the argument that is to be passed to
		 the specified procedure when a signal has been
		 raised.

       _i_d	 Specifies the ID returned from the corresponding
		 _X_t_A_p_p_A_d_d_S_i_g_n_a_l call.

       _p_r_o_c	 Specifies the procedure that is to be called
		 when the signal has been raised.

DDEESSCCRRIIPPTTIIOONN
       The _X_t_A_p_p_A_d_d_S_i_g_n_a_l_H_a_n_d_l_e_r function initiates a mechanism
       for handling signals within the context of the Intrinsics.
       Prior to establishing an operating system dependent signal
       handler the application may call _X_t_A_p_p_A_d_d_S_i_g_n_a_l_H_a_n_d_l_e_r and
       store the returned _i_d in a place accessible to the signal
       handler.

       Upon receipt of a signal from the operating system, the
       application may call _X_t_N_o_t_i_c_e_S_i_g_n_a_l passing the _i_d
       returned by the call to _X_t_A_p_p_A_d_d_S_i_g_n_a_l.

       _X_t_N_o_t_i_c_e_S_i_g_n_a_l is the only Intrinsics function that can
       safely be called from a signal handler. If _X_t_N_o_t_i_c_e_S_i_g_n_a_l
       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 _F_a_l_s_e
       and is set to _T_r_u_e by _X_t_N_o_t_i_c_e_S_i_g_n_a_l; the Intrinsics
       invoke the callback whenever the flag is _T_r_u_e, and the
       flag is set to _F_a_l_s_e just before the callback is invoked.

       The _X_t_R_e_m_o_v_e_S_i_g_n_a_l function is called to remove the



X Version 11		    Release 6				1





XtAppAddSignal(3Xt)	   XT FUNCTIONS	      XtAppAddSignal(3Xt)


       specified Intrinsics signal handler. The client should
       disable the source of the signal before calling
       _X_t_R_e_m_o_v_e_S_i_g_n_a_l.

SSEEEE AALLSSOO
       XtAppAddTime-
       Out(3Xt),XtAppAddInput(3Xt),XtAppAddWorkProc(3Xt)
       _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s _- _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
       _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
















































X Version 11		    Release 6				2


