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

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


 ttdt_file_event(library call)                 ttdt_file_event(library call)

 NAME    [Toc]    [Back]
      ttdt_file_event - use ToolTalk to announce an event about a file

 SYNOPSIS    [Toc]    [Back]
      #include <Tt/tttk.h>
      Tt_status ttdt_file_event(
      Tt_message context,
      Tttk_op event,
      Tt_pattern *patterns,
      int send);

 DESCRIPTION    [Toc]    [Back]
      The ttdt_file_event function is used to create and send a ToolTalk
      notice announcing an event pertaining to a file.  The file is
      indicated by the pathname argument that was passed to
      ttdt_file_join(3) when patterns was created.

      The event argument identifies the event.  If event is TTDT_MODIFIED,
      ttdt_file_event registers in the the_scope argument passed to
      ttdt_file_join(3) to handle Get_Modified, Save, and Revert requests.
      Get_Modified is handled transparently by associating the modified
      state of the file with patterns. Save and Revert requests are passed
      to the Ttdt_file_cb that was given to ttdt_file_join(3). If send is
      True, ttdt_file_event sends Modified in the_scope. If event is
      TTDT_SAVED or TTDT_REVERTED, ttdt_file_event unregisters handler
      patterns for Get_Modified, Save, and Revert requests.  If send is
      True, ttdt_file_event sends Saved or Reverted, respectively, in

      The context argument describes the environment to use.  If context is
      not zero, messages created by ttdt_file_event inherit from context all
      contexts whose slotname begins with the characters ENV_.

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

      TT_OK     The operation completed successfully.

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

                The ToolTalk service has more active messages than it can
                handle.  (The maximum number of active messages is
                implementation specific, but is at least 2000.)

                The patterns argument was NULL.

                                    - 1 -       Formatted:  January 24, 2005

 ttdt_file_event(library call)                 ttdt_file_event(library call)

 SEE ALSO    [Toc]    [Back]
      Tt/tttk.h - Tttttk(5), ttdt_file_join(3), ttdt_Get_Modified(3),

                                    - 2 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
ttdt_Get_Modified HP-UX ask if any ToolTalk client has changes pending on a file
ttdt_file_join HP-UX register to observe ToolTalk events on a file
ttdt_file_quit HP-UX unregister interest in ToolTalk events about a file
ttdt_Save HP-UX request a ToolTalk client to save a file
ttdt_Revert HP-UX request a ToolTalk client to revert a file
tt_spec_move HP-UX notify the ToolTalk service that an object has moved to a different file
ttdt_file_notice HP-UX create and send a standard ToolTalk notice about a file
ttdt_file_request HP-UX create and send a standard ToolTalk request about a file
tt_session_types_load HP-UX merge a compiled ToolTalk types file into the running ttsession
poll Linux wait for some event on a file descriptor
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service