ttdt_file_quit(3)

ttdt_file_quit(3)      C LIBRARY 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 created.  The	 ttdt_file_quit()  function  des-
     troys 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  Tool-
		Talk database needed for this operation.

	TT_ERR_DBEXIST
		The ToolTalk service could not access the  speci-
		fied 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.

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

Unix System LaboratorLast change: 11 May 1994			1