NAME

Get_Modified — ask whether an entity has been modified

SYNOPSIS

[file] Get_Modified(in type ID,


        out boolean modified);

DESCRIPTION

The Get_Modified request asks whether any tool has modified a volatile, non-shared (for example, in-memory) representation of the persistent state of an entity (such as a file) with the intention of eventually making that representation persistent.

Thus, a tool should register a dynamic pattern for this request when it has modified an entity of possible shared interest.

The ID argument is the identity of the persistent entity being asked about. When its type is File, then ID 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.

The modified argument argument is a Boolean value indicating whether a volatile, non-shared (for example, in-memory) representation of the entity has been modified with the intention of eventually making that representation persistent.

ERRORS

The ToolTalk service may return one of the following errors in processing the Get_Modified request:

TT_ERR_NO_MATCH

Since no handler could be found, the entity in question can be assumed not to be modified.

APPLICATION USAGE

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

The Get_Modified request can be sent with ttdt_file_request(3); ttdt_Get_Modified(3), can send the Get_Modified request and block on the reply.

SEE ALSO

ttdt_file_join(3), ttdt_file_request(3), ttdt_file_request(3), ttdt_Get_Modified(3); Set_Modified request.