Common Desktop Environment: ToolTalk Messaging Overview

ttdt_file_join

Tt_message  (	*Ttdt_file_cb)	(  Tt_message     msg,
          Tttk_op        op,
          char *          pathname,
          void *         clientdata,
          int            same_euid_egid,
          int            same_procid );  
Tt_pattern * ttdt_file_join(    const char *   pathname,
          Tt_scope          the_scope,
          int               join,
          Ttdt_file_cb       cb,
          void *             clientdata );

The ttdt_file_join() function registers to observe ToolTalk events on the specified file. It registers in the scope to observe Deleted, Modified, Reverted, Moved, and Saved notices.

This function returns a null-terminated array of Tt_pattern. Use the ttdt_file_quit() function to destroy the array. If an error is returned, the returned array is an error pointer that can be decoded with tt_ptr_error. Table A-6 is a list of the possible errors returned by the ttdt_file_join() function.

Table A-6 Possible Errors Returned by ttdt_file_join

Error Returned 

Description 

TT_ERR_NOMP

The ttsession process is not available. The ToolTalk service tries to restart ttsession if it is not running. This error indicates that the ToolTalk service is either not installed or not installed correctly. 

TT_ERR_DBAVAIL

The ToolTalk service could not access the ToolTalk database needed for this operation. 

TT_ERR_DBEXIST

The ToolTalk service did not find the specified ToolTalk database in the expected place. 

TT_ERR_PATH

The ToolTalk service was not able to read a directory in the specified file path name. 

TT_ERR_NOMEM

There is not enough memory available to perform the operation.