Click this button to go to the index for this section.

Get_Modified(4)
CDE


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.