Get_Modified - ask whether an entity has been modified
[file] Get_Modified(in type ID, out boolean modified);
Desktop Services Message Sets Get_Modified(4)
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 process-
ing 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 trans-
parently 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.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | library/tooltalk |
+---------------+------------------+
|Stability | Committed |
+---------------+------------------+
SEE ALSO
ttdt_file_join(3), ttdt_file_request(3), ttdt_file_request(3),
ttdt_Get_Modified(3); Set_Modified request.
ToolTalk 1.3 1 March 1996 Get_Modified(4)