Get_Modified(4)

NAME
Get_Modified request - 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:

    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.