Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ttdt_file_event (3)

Name

ttdt_file_event - use ToolTalk to announce an event about a file

Synopsis

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

Description

ttdt_file_event(3)            ToolTalk Functions            ttdt_file_event(3)



NAME
       ttdt_file_event - use ToolTalk to announce an event about a file

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

DESCRIPTION
       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 pat-
       terns 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_scope.

       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
       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.

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

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

          TT_ERR_POINTER
                  The patterns argument was NULL.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/tooltalk |
       +---------------+------------------+
       |Stability      | Committed        |
       +---------------+------------------+

SEE ALSO
       tttk(5), ttdt_file_join(3), ttdt_Get_Modified(3), ttdt_file_quit(3).




ToolTalk 1.3                     1 March 1996               ttdt_file_event(3)