ttdt_file_quit - unregister interest in ToolTalk events about a file
#include <Tt/tttk.h> Tt_status ttdt_file_quit(Tt_pattern *patterns, int quit);
ttdt_file_quit(3) ToolTalk Functions ttdt_file_quit(3)
NAME
ttdt_file_quit - unregister interest in ToolTalk events about a file
SYNOPSIS
#include <Tt/tttk.h>
Tt_status ttdt_file_quit(Tt_pattern *patterns,
int quit);
DESCRIPTION
The ttdt_file_quit() function is used to unregister interest in the
pathname that was passed to ttdt_file_join(3) when patterns was cre-
ated. The ttdt_file_quit() function destroys patterns and sets the
default file to NULL.
If quit is True, ttdt_file_quit() calls tt_file_quit(3) with a pathname
argument; otherwise, it returns without quitting.
RETURN VALUE
Upon successful completion, the ttdt_file_quit() function returns the
status of the operation as one of the following Tt_status values:
TT_OK The operation completed successfully.
TT_ERR_DBAVAIL
The ToolTalk service could not access the ToolTalk database
needed for this operation.
TT_ERR_DBEXIST
The ToolTalk service could not access the specified ToolTalk
database in the expected place.
TT_ERR_NOMP
The ttsession(1) process is not running and the ToolTalk
service cannot restart it.
TT_ERR_POINTER
The patterns argument was NULL or otherwise invalid.
TT_ERR_PROCID
The specified process identifier is out of date or invalid.
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), tt_default_file(3), tt_file_quit(3).
ToolTalk 1.3 1 March 1996 ttdt_file_quit(3)