xtaddinput(3) [hpux man page]

XtAddInput()															      XtAddInput()

Name
  XtAddInput - register a procedure to be called when there is activity on a file descriptor.

Synopsis
  XtInputId XtAddInput(source, condition, proc, client_data)
	 int source;
	 XtPointer condition;
	 XtInputCallbackProc proc;
	 XtPointer client_data;

Inputs
  source    Specifies the file descriptor (on a POSIX-based system) to monitor.

  condition Specifies a mask that indicates a read, write, or exception condition or some operating-system-dependent condition.

  proc	    Specifies the procedure that is to be called when condition occurs on source.

  client_data
	    Specifies data to be passed to proc when it is invoked.

Returns
  A handle of type XtInputId that can be passed to XtRemoveInput() to unregister this input procedure.

Availability
  Superseded by XtAppAddInput().

Description
  XtAddInput() registers a file descriptor source to be monitored by XtAppNextEvent() and a procedure proc to be called with data client_data
  when the condition (such as "input ready" or "error") condition arises.

  On a POSIX-based system, the supported values for condition are XtInputReadMask, XtInputWriteMask, or XtInputExceptMask.  These values can-
  not be ORed together.

Usage
  XtAddInput() has been superseded by XtAppAddInput(), which performs the same function on a per-application context basis.  XtAddInput() now
  calls XtAppAddInput() passing the default application context created by XtInitialize().  Very few programs need multiple application  con-
  texts,  and  you  can continue to use XtAddInput() if you initialize your application with XtInitialize().  We recommend, however, that you
  use XtAppInitialize(), XtAppAddInput(), and the other XtApp*() application context specific functions.

  See XtAppAddInput() for more information.

See Also
  XtAppAddInput(1), XtRemoveInput(1),
  XtInputCallbackProc(2).

Xt - Event Handling														      XtAddInput()