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

    The operation completed successfully.
    The ToolTalk service could not access the ToolTalk database needed for this operation.
    The ToolTalk service could not access the specified ToolTalk database in the expected place.
    The ttsession(1) process is not running and the ToolTalk service cannot restart it.
    The patterns argument was NULL or otherwise invalid.
    The specified process identifier is out of date or invalid.

SEE ALSO
Tttttk(5), ttdt_file_join(3), tt_default_file(3), tt_file_quit(3).