CDE

NAME

Revert − discard any modifications to an entity

SYNOPSIS

[file] Revert(in type ID);

DESCRIPTION

The Revert notice asks that any pending, unsaved modifications to a persistent entity (such as a file) be discarded. 

The ID argument is the identity of the entity to revert.  When its type is File, then the ID argument is unset (in other words, has a value of (char∗)0 and it refers to the file or directory named in the message’s file attribute. 

ERRORS

The ToolTalk service may return one of the following errors in processing the Revert notice:

TT_DESKTOP_UNMODIFIED
The entity had no pending, unsaved modifications.

TT_DESKTOP_ENOENT
The file to save/revert does not exist.

APPLICATION USAGE

The ttdt_file_join(3), function can be used to register for, and help process, the Revert request. 

The Revert request can be sent with ttdt_file_request(3).  Also, ttdt_Revert(3), can send the relevant message and block on the reply. 

SEE ALSO

ttdt_Revert(3), ttdt_file_join(3), ttdt_file_request(3); Save notice.