ttdt_Revert(3)

ttdt_Revert(3)	       C LIBRARY FUNCTIONS	   ttdt_Revert(3)

NAME
     ttdt_Revert - request a ToolTalk client to	revert a file

SYNOPSIS
     #include <Tt/tttk.h>

     Tt_status ttdt_Revert(Tt_message context,
			   const char *pathname,
			   Tt_scope the_scope,
			   XtAppContext	app2run,
			   int ms_timeout);

DESCRIPTION
     The ttdt_Revert() function	sends a	 Revert	 request  in  the
     the_scope	argument  and  waits  for  the	reply.	 A Revert
     request asks the handling ToolTalk	 client	 to  discard  any
     changes pending on	pathname.

     The context argument describes the	environment to	use.   If
     context  is  not  zero,  messages	created	 by ttdt_Revert()
     inherit from context all contexts whose slotname begins with
     the characters ENV_.

     The the_scope argument identifies the scope of the	 request.
     If	 the_scope is TT_SCOPE_NONE, ttdt_Revert() tries TT_BOTH,
     and falls back to TT_FILE_IN_SESSION if,  for  example,  the
     ToolTalk database server is not installed on the file server
     that owns pathname.

     The ttdt_Revert() function	passes app2run and ms_timeout  to
     tttk_block_while(3),  blocking  on	 the  reply  to	 the Save
     request it	sends.

RETURN VALUE
     Upon  successful  completion,  the	 ttdt_Revert()	 function
     returns  the status of the	operation as one of the	following
     Tt_status values:

	TT_OK	The sent request received  an  affirmative  reply
		within ms_timeout milliseconds.

	TT_DESKTOP_ETIMEDOUT
		No reply  was  received	 within	 ms_timeout  mil-
		liseconds.

	TT_DESKTOP_EPROTO
		The request was	failed,	but the	handler	 set  the
		tt_message_status()   of  the  failure	reply  to
		TT_OK, instead of a specific error status.

	TT_ERR_DBAVAIL
		The ToolTalk service could not access  the  Tool-
		Talk database needed for this operation.

Unix System LaboratorLast change: 11 May 1994			1

ttdt_Revert(3)	       C LIBRARY FUNCTIONS	   ttdt_Revert(3)

	TT_ERR_DBEXIST
		The ToolTalk service could not access the  speci-
		fied ToolTalk database in the expected place.

	TT_ERR_NOMEM
		There is insufficient memory available to perform
		the function.

	TT_ERR_NOMP
		The ttsession(1) process is not	running	 and  the
		ToolTalk service cannot	restart	it.

	TT_ERR_OVERFLOW
		The ToolTalk service  has  more	 active	 messages
		than  it  can  handle.	 (The  maximum	number of
		active messages	is implementation  specific,  but
		is at least 2000.)

	TT_ERR_POINTER
		The pathname argument was NULL or was a	 ToolTalk
		error pointer.

	TT_ERR_PROCID
		The specified process identifier is out	 of  date
		or invalid.

SEE ALSO
     Tttttk(5),	ttdt_Save(3), ttdt_file_join(3),
     ttdt_file_event(3), tttk_block_while(3).

Unix System LaboratorLast change: 11 May 1994			2