Get_Modified(4)
Get_Modified(4) DEVICES AND NETWORK INTERFACES Get_Modified(4)
NAME
Get_Modified request - ask whether an entity has been modi-
fied
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) representa-
tion 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 per-
sistent.
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.
Unix System LaboratorLast change: 13 May 1994 1
Man(1) output converted with
man2html