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)