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

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


 tt_pattern_create(library call)             tt_pattern_create(library call)

 NAME    [Toc]    [Back]
      tt_pattern_create - request a new pattern object

 SYNOPSIS    [Toc]    [Back]
      #include <Tt/tt_c.h>
      Tt_pattern tt_pattern_create(void)

 DESCRIPTION    [Toc]    [Back]
      The tt_pattern_create function requests a new pattern object.

      After receiving the pattern object, the application fills in the
      message pattern fields to indicate what type of messages the process
      wants to receive and then registers the pattern with the ToolTalk

      The application can supply multiple values for each attribute added to
      a pattern (although some attributes are set and can only have one
      value).  The pattern attribute matches a message attribute if any of
      the values in the pattern match the value in the message.  If no value
      is specified for an attribute, the ToolTalk service assumes that any
      value will match.

 RETURN VALUE    [Toc]    [Back]
      Upon successful completion, the tt_pattern_create function returns the
      opaque handle for a message pattern.  The application can use this
      handle in future calls to identify the pattern object.  The
      application can use tt_ptr_error(3) to extract one of the following
      Tt_status values from the returned handle:

      TT_OK     The operation completed successfully.

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

 APPLICATION USAGE    [Toc]    [Back]
      The application should use tt_free(3) to free any data stored in the
      address returned by the ToolTalk API.

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

                                    - 1 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
tt_pattern_object_add HP-UX add a value to the object field of a pattern
tt_pattern_destroy HP-UX destroy a pattern object
tt_pattern_xarg_add HP-UX add a new argument with an interpreted XDR value to a pattern object
tt_pattern_otype_add HP-UX add a value to the object type field for a pattern
tt_pattern_user HP-UX return the value in a user data cell for a pattern object
tt_pattern_user_set HP-UX store information in the user data cells of a pattern object
t_listen HP-UX listen for a connect request
tt_orequest_create HP-UX create a request message
t_accept HP-UX accept a connect request
t_listen Tru64 Listen for a connect request
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service