|
|
tt_error(3) -- capture ToolTalk function errors
|
|
The tt_error function is a publicly-known null function. It is called by the ToolTalk library just before it returns from any ToolTalk API call that has a status other than TT_OK. The caller passes the name of the function that is about to return and the function's status code. You can use this function to set a dbx breakpoint to quickly catch and trace back any ToolTalk errors. You can also inte... |
|
tt_error_int(3) -- return an integer error object that encodes the code
|
|
The tt_error_int function returns an integer error object that encodes a Tt_status return value. The ttrc argument is the Tt_status code that is to be encoded. |
|
tt_error_pointer(3) -- return a pointer to an error object that encodes the code
|
|
The tt_error_pointer function returns a pointer to an error object that encodes a Tt_status return value. The ttrc argument is the Tt_status code that is to be encoded. |
|
tt_fd(3) -- return a file descriptor
|
|
The tt_fd function returns a file descriptor. The returned file descriptor alerts the process that a message has arrived for the default procid in the default session. File descriptors are either active or inactive. When the file descriptor becomes active, the process must call tt_message_receive(3) to receive the message. |
|
tt_feature_enabled(3) -- determine if a particular feature has been enabled in this process
|
|
The tt_feature_enabled function queries the ToolTalk service to see if the specified feature has previously been enabled. This allows a library that "wraps around" ToolTalk for sending and receiving messages to determine if multithreaded execution has been enabled by the main program, and to modify its behavior accordingly. |
|
tt_feature_required(3) -- declare a feature to be required by the calling program.
|
|
The tt_feature_required function declares a feature to be required by the calling code. If the feature is available, tt_feature_required enables it. If the feature requires the ToolTalk service to perform some initialization (for example, TT_FEATURE_MULTITHREADED), the initialization is performed in this call. Some features (such as TT_FEATURE_MULTITHREADED) require this call to be made before cal... |
|
tt_file_copy(3) -- copy objects from one file to a new file
|
|
The tt_file_copy function copies all objects that exist on the specified file to a new file. If any objects already exist on newfilepath, they are not overwritten by the copy (that is, they are not removed.) The oldfilepath argument is a pointer to the name of the file whose objects are to be copied. The newfilepath argument is a pointer to the name of the file on which to create the copied object... |
|
tt_file_destroy(3) -- remove objected rooted on a file
|
|
The tt_file_destroy function removes all objects that exist on the files and directories rooted at filepath. The application must call this function when the application unlinks a file or removes a directory. The filepath argument is a pointer to the pathname of the file or directory to be removed. |
|
tt_file_join(3) -- register interest in messages involving a file
|
|
The tt_file_join function informs the ToolTalk service that the process is interested in messages that involve the specified file. The ToolTalk service adds this file value to any currently registered patterns. The named file becomes the default file. When the process joins a file, the ToolTalk service updates the file field of its registered patterns. The tt_file_join call causes the pattern's T... |
|
tt_file_move(3) -- move objects from one file to another
|
|
The tt_file_move function destroys all objects that exist on the files and directories rooted at newfilepath, then moves all objects that exist on oldfilepath to newfilepath. If oldfilepath and newfilepath reside in the same file system, tt_file_move replaces oldfilepath with newfilepath in the path associated with every object in that file system; that is, all the objects in the directory tree ro... |
|
tt_file_netfile(3) -- map between local and canonical pathnames on the local host
|
|
The tt_file_netfile function converts a local pathname to a netfilename, a form that can be passed to other hosts on the network and converted back to a local pathname for the same file with tt_netfile_file(3). The filename argument is a pathname (absolute or relative) that is valid on the local host. Every component of filename must exist, except that the last component need not exist. |
|
tt_file_objects_query(3) -- find all objects in the named file
|
|
The tt_file_objects_query function instructs the ToolTalk service to find all objects in the named file and pass the objids to the filter function. The context pointer and accumulator pointer initially specified are also passed to the filter function. As the ToolTalk service finds each object, it calls the filter function, passing the objid of the object and the two applicationsupplied pointers. T... |
|
tt_file_quit(3) -- register lack of interest in messages that involve a file
|
|
The tt_file_quit function informs the ToolTalk service that the process is no longer interested in messages that involve the specified file. The ToolTalk service removes this file value from any currently registered patterns and sets the default file to NULL. The filepath argument is the name of the file in which the process is no longer interested. |
