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.