The dpcatchmsg man page







NAME
     dpcatchmsg - set asynchronous DP message handler

SYNOPSIS
     #include 

     FUNCPTR dpcatchmsg(catchfunc)
     FUNCPTR catchfunc;

DESCRIPTION
     dpcatchmsg() is called to set a function, catchfunc,  to  be
     invoked  when  asynchronous  DP messages arrive.  FUNCPTR is
     defined as a pointer to a  type  void  function  in  the  DP
     header  file.  If catchfunc is NULLFUNC (also defined in the
     header file), the arrival of asynchronous DP  messages  will
     not  cause the catching function to be invoked, but the mes-
     sage data will still remain in the incoming message queue.

     The catching function typically calls dpgetmsg() to retrieve
     asynchronous  messages and takes appropriate actions accord-
     ing to the message types.

RETURN VALUES
     If a previous asynchronous  message  catching  function  has
     been  set,  dpcatchmsg() returns a pointer to that function.
     Otherwise it returns NULLFUNC.

REMARK
     This is a DP function call.

AUTHOR
     David Arnow

FILES
     /usr/include/dp/dp.h - DP header file
     /usr/lib/libdp.a     - DP library file

SEE ALSO
     dpgetmsg(3DP)





Essential DP MAN Pages:

General/Essential:


Non-Interrupting Messages:


Interrupting Messages:
  • dpblock
  • dpcatchmsg
  • dpgetmsg
  • dppause
  • dpunblock

    Other:
    Return to DP For Students Return to The DP Project Return to David Arnow's Home Page