ttdt_file_event - use ToolTalk to announce an event about a file
#include <Tt/tttk.h> Tt_status ttdt_file_event(Tt_message context, Tttk_op event, Tt_pattern *patterns, int send);
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)