*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> tt_pattern_callback_add (3)              


 tt_pattern_callback_add(library call) tt_pattern_callback_add(library call)

 NAME    [Toc]    [Back]
      tt_pattern_callback_add - register a message-matching callback

 SYNOPSIS    [Toc]    [Back]
      #include <Tt/tt_c.h>
      Tt_status tt_pattern_callback_add(
      Tt_pattern m,
      Tt_message_callback f);

 DESCRIPTION    [Toc]    [Back]
      The tt_pattern_callback_add function registers a callback function
      that will be automatically invoked by tt_message_receive(3) whenever a
      message matches the pattern.

      The callback is defined in Tt/tt_c.h - Tttt_c(5). If the callback
      returns TT_CALLBACK_CONTINUE, other callbacks will be run; if no
      callback returns TT_CALLBACK_PROCESSED, tt_message_receive(3) returns
      the message.  If the callback returns TT_CALLBACK_PROCESSED, no
      further callbacks will be invoked for this event;
      tt_message_receive(3) does not return the message.

      The m argument is the opaque handle for the pattern involved in this

      The f argument is the message callback to be run.

 RETURN VALUE    [Toc]    [Back]
      Upon successful completion, the tt_pattern_callback_add function
      returns the status of the operation as one of the following Tt_status

      TT_OK     The operation completed successfully.

                The ttsession(1) process is not running and the ToolTalk
                service cannot restart it.

                The pointer passed does not point to an object of the
                correct type for this operation.

 SEE ALSO    [Toc]    [Back]
      Tt/tt_c.h - Tttt_c(5), tt_pattern_register(3), tt_message_receive(3).

                                    - 1 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
tt_message_callback_add HP-UX register a callback function
csa_register_callback HP-UX register the callback functions to be invoked when the specified type of update occurs in the calendar
mq_notify IRIX register message notification request
mq_notify HP-UX register/cancel a notification request with a message queue
atexit OpenBSD register a function to be called on exit
atexit FreeBSD register a function to be called on exit
atexit NetBSD register a function to be called on exit
atexit HP-UX register a function to be called at program termination
atexit Linux register a function to be called at normal program termination.
on_exit Linux register a function to be called at normal program termination.
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service