Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ttdt_Revert(library call)			     ttdt_Revert(library call)

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 argu-
       ment 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 con-
       texts 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 milliseconds.

       TT_DESKTOP_EPROTO
		 The request was failed,  but  the  handler  set  the  tt_mes-
		 sage_status  of the failure reply to TT_OK, instead of	a spe-
		 cific error status.

       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_NOMEM
		 There is insufficient memory available	to perform  the	 func-
		 tion.

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

       TT_ERR_OVERFLOW
		 The ToolTalk service has more active  messages	 than  it  can
		 handle.   (The	maximum	number of active messages is implemen-
		 tation	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
       Tt/tttk.h     -	   Tttttk(5),	  ttdt_Save(3),	    ttdt_file_join(3),
       ttdt_file_event(3), tttk_block_while(3).

						     ttdt_Revert(library call)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ttdt_Revert&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help